@openbat/cli 0.2.2 → 0.2.3

package/dist/api-client.js

@@ -32,7 +32,7 @@ __export(api_client_exports, {
 });
 module.exports = __toCommonJS(api_client_exports);
 var import_node_url = require("url");
-var CLI_VERSION = "0.2.2";
+var CLI_VERSION = "0.2.3";
 var KEY_REGEX = /ob_(?:live|read|admin|pat)_[0-9a-f]{32}/g;
 function redact(s) {
   return s.replace(KEY_REGEX, (k) => `${k.slice(0, 16)}\u2026<hidden>`);

package/dist/api-client.mjs

@@ -1,6 +1,6 @@
 import {
   ApiClient
-} from "./chunk-MCDJLQI2.mjs";
+} from "./chunk-HBSCN3HV.mjs";
 export {
   ApiClient
 };

package/dist/{chunk-MCDJLQI2.mjs → chunk-HBSCN3HV.mjs}

@@ -9,7 +9,7 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
 
 // src/api-client.ts
 import { URL } from "url";
-var CLI_VERSION = "0.2.2";
+var CLI_VERSION = "0.2.3";
 var KEY_REGEX = /ob_(?:live|read|admin|pat)_[0-9a-f]{32}/g;
 function redact(s) {
   return s.replace(KEY_REGEX, (k) => `${k.slice(0, 16)}\u2026<hidden>`);

package/dist/index.js

@@ -163,7 +163,7 @@ function configPath() {
 
 // src/api-client.ts
 var import_node_url = require("url");
-var CLI_VERSION = "0.2.2";
+var CLI_VERSION = "0.2.3";
 var KEY_REGEX = /ob_(?:live|read|admin|pat)_[0-9a-f]{32}/g;
 function redact(s) {
   return s.replace(KEY_REGEX, (k) => `${k.slice(0, 16)}\u2026<hidden>`);
@@ -1277,6 +1277,15 @@ async function client3(globals) {
   }
   return new ApiClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl });
 }
+function requireChatbotId(cmd) {
+  const globals = cmd.optsWithGlobals();
+  if (!globals.chatbot) {
+    fatal(
+      "--chatbot <id> is required. Pass it inline or set a default with `openbat use <id>`."
+    );
+  }
+  return globals.chatbot;
+}
 function surfacePlaintext(plaintext, label) {
   process.stderr.write(
     `
@@ -1339,23 +1348,25 @@ function chatbotsCommand() {
 }
 function webhooksCommand() {
   const cmd = new import_commander7.Command("webhooks").description("Manage webhooks for a chatbot");
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  cmd.command("list").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/webhooks`
+        `/api/v1/chatbots/${chatbotId}/webhooks`
       );
       emit(result.webhooks, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("create").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--name <name>").requiredOption("--url <url>").option("--type <type>", "discord | slack | custom", "custom").action(async function(opts) {
+  cmd.command("create").requiredOption("--name <name>").requiredOption("--url <url>").option("--type <type>", "discord | slack | custom", "custom").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      const result = await c.post(`/api/v1/chatbots/${opts.chatbot}/webhooks`, {
+      const result = await c.post(`/api/v1/chatbots/${chatbotId}/webhooks`, {
         name: opts.name,
         url: opts.url,
         type: opts.type
@@ -1366,11 +1377,12 @@ function webhooksCommand() {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("delete").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--webhook <id>", "Webhook id").action(async function(opts) {
+  cmd.command("delete").requiredOption("--webhook <id>", "Webhook id").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      await c.delete(`/api/v1/chatbots/${opts.chatbot}/webhooks/${opts.webhook}`);
+      await c.delete(`/api/v1/chatbots/${chatbotId}/webhooks/${opts.webhook}`);
       emit({ ok: true, deleted: opts.webhook }, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
@@ -1383,12 +1395,13 @@ function settingsCommand() {
     "Manage chatbot settings + per-chatbot keys"
   );
   const keys = cmd.command("keys").description("Manage API keys for a chatbot");
-  keys.command("rotate-ingest").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  keys.command("rotate-ingest").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.post(
-        `/api/v1/chatbots/${opts.chatbot}/keys/ingest/rotate`,
+        `/api/v1/chatbots/${chatbotId}/keys/ingest/rotate`,
         {}
       );
       surfacePlaintext(result.plaintext, "New ingest key (ob_live_*)");
@@ -1397,12 +1410,13 @@ function settingsCommand() {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  keys.command("generate-read").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  keys.command("generate-read").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.post(
-        `/api/v1/chatbots/${opts.chatbot}/keys/read`,
+        `/api/v1/chatbots/${chatbotId}/keys/read`,
         {}
       );
       surfacePlaintext(result.plaintext, "New read key (ob_read_*)");
@@ -1411,11 +1425,12 @@ function settingsCommand() {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  keys.command("generate-admin").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--name <name>", "Human-friendly name (e.g. 'CI key')").option("--expires-in-days <n>", "Auto-expire after N days").action(async function(opts) {
+  keys.command("generate-admin").requiredOption("--name <name>", "Human-friendly name (e.g. 'CI key')").option("--expires-in-days <n>", "Auto-expire after N days").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      const result = await c.post(`/api/v1/chatbots/${opts.chatbot}/admin-keys`, {
+      const result = await c.post(`/api/v1/chatbots/${chatbotId}/admin-keys`, {
         name: opts.name,
         expiresInDays: opts.expiresInDays ? Number(opts.expiresInDays) : void 0
       });
@@ -1425,30 +1440,33 @@ function settingsCommand() {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  keys.command("list-admin").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  keys.command("list-admin").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/admin-keys`
+        `/api/v1/chatbots/${chatbotId}/admin-keys`
       );
       emit(result.keys, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  keys.command("revoke-admin").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--key <keyId>", "Admin key id").action(async function(opts) {
+  keys.command("revoke-admin").requiredOption("--key <keyId>", "Admin key id").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      await c.delete(`/api/v1/chatbots/${opts.chatbot}/admin-keys/${opts.key}`);
+      await c.delete(`/api/v1/chatbots/${chatbotId}/admin-keys/${opts.key}`);
       emit({ ok: true, revoked: opts.key }, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("update").description("Patch a chatbot's settings JSONB").requiredOption("--chatbot <id>", "Chatbot id").option("--description <text>").option("--website-url <url>").option("--language <code>").action(async function(opts) {
+  cmd.command("update").description("Patch a chatbot's settings JSONB").option("--description <text>").option("--website-url <url>").option("--language <code>").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const settings = {};
       if (opts.description) settings.description = opts.description;
       if (opts.websiteUrl) settings.website_url = opts.websiteUrl;
@@ -1458,7 +1476,7 @@ function settingsCommand() {
       }
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      await c.patch(`/api/v1/chatbots/${opts.chatbot}/settings`, { settings });
+      await c.patch(`/api/v1/chatbots/${chatbotId}/settings`, { settings });
       emit({ ok: true }, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
@@ -1468,19 +1486,20 @@ function settingsCommand() {
 }
 function workflowsCommand() {
   const cmd = new import_commander7.Command("workflows").description("Manage workflows");
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  cmd.command("list").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/workflows`
+        `/api/v1/chatbots/${chatbotId}/workflows`
       );
       emit(result.workflows, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("create").description("Create a workflow from a built-in template").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--name <name>").requiredOption(
+  cmd.command("create").description("Create a workflow from a built-in template").requiredOption("--name <name>").requiredOption(
     "--template <name>",
     "flag-to-webhook | outcome-to-webhook | sentiment-drop-to-webhook"
   ).requiredOption(
@@ -1488,9 +1507,10 @@ function workflowsCommand() {
     "Flag value / outcome value / sentiment threshold"
   ).requiredOption("--webhook <id>", "Webhook id to fire").option("--message <tpl>", "Message template (supports {{user.id}}, etc.)").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      const result = await c.post(`/api/v1/chatbots/${opts.chatbot}/workflows`, {
+      const result = await c.post(`/api/v1/chatbots/${chatbotId}/workflows`, {
         name: opts.name,
         template: opts.template,
         triggerValue: opts.triggerValue,
@@ -1506,23 +1526,25 @@ function workflowsCommand() {
 }
 function reportsCommand() {
   const cmd = new import_commander7.Command("reports").description("Manage AI reports");
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  cmd.command("list").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/reports`
+        `/api/v1/chatbots/${chatbotId}/reports`
       );
       emit(result.reports, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("create").description("Create a new AI report; returns the org-private dashboard URL").requiredOption("--chatbot <id>", "Chatbot id").option("--name <name>", "Report name", "Untitled Report").action(async function(opts) {
+  cmd.command("create").description("Create a new AI report; returns the org-private dashboard URL").option("--name <name>", "Report name", "Untitled Report").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      const result = await c.post(`/api/v1/chatbots/${opts.chatbot}/reports`, { name: opts.name });
+      const result = await c.post(`/api/v1/chatbots/${chatbotId}/reports`, { name: opts.name });
       process.stderr.write(
         `
 Created report. View it (org members only):
@@ -1542,30 +1564,32 @@ Created report. View it (org members only):
 }
 function analysisCommand() {
   const cmd = new import_commander7.Command("analysis").description("Manage analysis definitions");
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").option("--type <t>", "intent | flag | assistant_outcome | assistant_issue").option("--pending", "Include pending suggestions").action(async function(opts) {
+  cmd.command("list").option("--type <t>", "intent | flag | assistant_outcome | assistant_issue").option("--pending", "Include pending suggestions").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const qs = new URLSearchParams();
       if (opts.type) qs.set("type", opts.type);
       if (opts.pending) qs.set("pending", "true");
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/analysis-definitions${qs.size ? `?${qs}` : ""}`
+        `/api/v1/chatbots/${chatbotId}/analysis-definitions${qs.size ? `?${qs}` : ""}`
       );
       emit(result.definitions, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("add").requiredOption("--chatbot <id>", "Chatbot id").requiredOption(
+  cmd.command("add").requiredOption(
     "--type <t>",
     "intent | flag | assistant_outcome | assistant_issue"
   ).requiredOption("--name <slug>", "snake_case slug").requiredOption("--display-name <text>").requiredOption("--description <text>").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.post(
-        `/api/v1/chatbots/${opts.chatbot}/analysis-definitions`,
+        `/api/v1/chatbots/${chatbotId}/analysis-definitions`,
         {
           analysisType: opts.type,
           name: opts.name,
@@ -1584,8 +1608,9 @@ function usersCommand() {
   const cmd = new import_commander7.Command("users").description(
     "List external users (chatbot customers) with health metrics"
   );
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").option("--from <iso>").option("--to <iso>").option("--days <n>", "Convenience: last N days").option("--search <q>").option("--limit <n>", "Page size", "20").action(async function(opts) {
+  cmd.command("list").option("--from <iso>").option("--to <iso>").option("--days <n>", "Convenience: last N days").option("--search <q>").option("--limit <n>", "Page size", "20").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const qs = new URLSearchParams();
@@ -1600,7 +1625,7 @@ function usersCommand() {
       if (opts.search) qs.set("search", opts.search);
       qs.set("limit", opts.limit);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/external-users?${qs}`
+        `/api/v1/chatbots/${chatbotId}/external-users?${qs}`
       );
       emit(result.users, { json: !!globals.json });
       process.stderr.write(`
@@ -1675,18 +1700,22 @@ function sdkCommand() {
     const out = opts.framework === "vercel-ai-sdk" ? snippetWrapper : snippetNext;
     process.stdout.write(out);
   });
-  cmd.command("verify").description("Check whether any event has arrived for the chatbot yet").requiredOption("--chatbot <id>", "Chatbot id").option("--timeout <n>", "Seconds to wait (default: 60)", "60").action(async function(opts) {
+  cmd.command("verify").description("Check whether any event has arrived for the chatbot yet").option("--timeout <n>", "Seconds to wait (default: 60)", "60").action(async function(opts) {
     try {
       const globals = this.optsWithGlobals();
+      const chatbotId = globals.chatbot;
+      if (!chatbotId) {
+        fatal("--chatbot <id> is required (also accepts the persisted active chatbot).");
+      }
       const c = await client3(globals);
       const timeoutSec = Number(opts.timeout);
       const deadline = Date.now() + timeoutSec * 1e3;
       const params = new URLSearchParams({
-        chatbotId: opts.chatbot,
+        chatbotId,
         limit: "1"
       });
       process.stderr.write(
-        `Waiting for first event on chatbot ${opts.chatbot} (timeout ${timeoutSec}s)\u2026
+        `Waiting for first event on chatbot ${chatbotId} (timeout ${timeoutSec}s)\u2026
 `
       );
       let lastTick = Date.now();
@@ -1722,7 +1751,7 @@ Timed out after ${timeoutSec}s \u2014 no events yet. Confirm OPENBAT_API_KEY and
 var program = new import_commander8.Command();
 program.name("openbat").description(
   "Query OpenBat chatbot data \u2014 conversations, sentiment, analytics, exports."
-).version("0.2.2").option("--api-key <key>", "Override the stored Read API key (footgun \u2014 leaks into shell history)").option(
+).version("0.2.3").option("--api-key <key>", "Override the stored Read API key (footgun \u2014 leaks into shell history)").option(
   "--base-url <url>",
   "Override the OpenBat API base URL (defaults to ~/.openbatrc or https://openbat.dev)"
 ).option(

package/dist/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ApiClient
-} from "./chunk-MCDJLQI2.mjs";
+} from "./chunk-HBSCN3HV.mjs";
 
 // src/index.ts
 import { Command as Command8 } from "commander";
@@ -1099,6 +1099,15 @@ async function client3(globals) {
   }
   return new ApiClient({ apiKey: cfg.apiKey, baseUrl: cfg.baseUrl });
 }
+function requireChatbotId(cmd) {
+  const globals = cmd.optsWithGlobals();
+  if (!globals.chatbot) {
+    fatal(
+      "--chatbot <id> is required. Pass it inline or set a default with `openbat use <id>`."
+    );
+  }
+  return globals.chatbot;
+}
 function surfacePlaintext(plaintext, label) {
   process.stderr.write(
     `
@@ -1161,23 +1170,25 @@ function chatbotsCommand() {
 }
 function webhooksCommand() {
   const cmd = new Command7("webhooks").description("Manage webhooks for a chatbot");
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  cmd.command("list").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/webhooks`
+        `/api/v1/chatbots/${chatbotId}/webhooks`
       );
       emit(result.webhooks, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("create").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--name <name>").requiredOption("--url <url>").option("--type <type>", "discord | slack | custom", "custom").action(async function(opts) {
+  cmd.command("create").requiredOption("--name <name>").requiredOption("--url <url>").option("--type <type>", "discord | slack | custom", "custom").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      const result = await c.post(`/api/v1/chatbots/${opts.chatbot}/webhooks`, {
+      const result = await c.post(`/api/v1/chatbots/${chatbotId}/webhooks`, {
         name: opts.name,
         url: opts.url,
         type: opts.type
@@ -1188,11 +1199,12 @@ function webhooksCommand() {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("delete").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--webhook <id>", "Webhook id").action(async function(opts) {
+  cmd.command("delete").requiredOption("--webhook <id>", "Webhook id").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      await c.delete(`/api/v1/chatbots/${opts.chatbot}/webhooks/${opts.webhook}`);
+      await c.delete(`/api/v1/chatbots/${chatbotId}/webhooks/${opts.webhook}`);
       emit({ ok: true, deleted: opts.webhook }, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
@@ -1205,12 +1217,13 @@ function settingsCommand() {
     "Manage chatbot settings + per-chatbot keys"
   );
   const keys = cmd.command("keys").description("Manage API keys for a chatbot");
-  keys.command("rotate-ingest").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  keys.command("rotate-ingest").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.post(
-        `/api/v1/chatbots/${opts.chatbot}/keys/ingest/rotate`,
+        `/api/v1/chatbots/${chatbotId}/keys/ingest/rotate`,
         {}
       );
       surfacePlaintext(result.plaintext, "New ingest key (ob_live_*)");
@@ -1219,12 +1232,13 @@ function settingsCommand() {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  keys.command("generate-read").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  keys.command("generate-read").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.post(
-        `/api/v1/chatbots/${opts.chatbot}/keys/read`,
+        `/api/v1/chatbots/${chatbotId}/keys/read`,
         {}
       );
       surfacePlaintext(result.plaintext, "New read key (ob_read_*)");
@@ -1233,11 +1247,12 @@ function settingsCommand() {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  keys.command("generate-admin").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--name <name>", "Human-friendly name (e.g. 'CI key')").option("--expires-in-days <n>", "Auto-expire after N days").action(async function(opts) {
+  keys.command("generate-admin").requiredOption("--name <name>", "Human-friendly name (e.g. 'CI key')").option("--expires-in-days <n>", "Auto-expire after N days").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      const result = await c.post(`/api/v1/chatbots/${opts.chatbot}/admin-keys`, {
+      const result = await c.post(`/api/v1/chatbots/${chatbotId}/admin-keys`, {
         name: opts.name,
         expiresInDays: opts.expiresInDays ? Number(opts.expiresInDays) : void 0
       });
@@ -1247,30 +1262,33 @@ function settingsCommand() {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  keys.command("list-admin").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  keys.command("list-admin").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/admin-keys`
+        `/api/v1/chatbots/${chatbotId}/admin-keys`
       );
       emit(result.keys, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  keys.command("revoke-admin").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--key <keyId>", "Admin key id").action(async function(opts) {
+  keys.command("revoke-admin").requiredOption("--key <keyId>", "Admin key id").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      await c.delete(`/api/v1/chatbots/${opts.chatbot}/admin-keys/${opts.key}`);
+      await c.delete(`/api/v1/chatbots/${chatbotId}/admin-keys/${opts.key}`);
       emit({ ok: true, revoked: opts.key }, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("update").description("Patch a chatbot's settings JSONB").requiredOption("--chatbot <id>", "Chatbot id").option("--description <text>").option("--website-url <url>").option("--language <code>").action(async function(opts) {
+  cmd.command("update").description("Patch a chatbot's settings JSONB").option("--description <text>").option("--website-url <url>").option("--language <code>").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const settings = {};
       if (opts.description) settings.description = opts.description;
       if (opts.websiteUrl) settings.website_url = opts.websiteUrl;
@@ -1280,7 +1298,7 @@ function settingsCommand() {
       }
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      await c.patch(`/api/v1/chatbots/${opts.chatbot}/settings`, { settings });
+      await c.patch(`/api/v1/chatbots/${chatbotId}/settings`, { settings });
       emit({ ok: true }, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
@@ -1290,19 +1308,20 @@ function settingsCommand() {
 }
 function workflowsCommand() {
   const cmd = new Command7("workflows").description("Manage workflows");
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  cmd.command("list").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/workflows`
+        `/api/v1/chatbots/${chatbotId}/workflows`
       );
       emit(result.workflows, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("create").description("Create a workflow from a built-in template").requiredOption("--chatbot <id>", "Chatbot id").requiredOption("--name <name>").requiredOption(
+  cmd.command("create").description("Create a workflow from a built-in template").requiredOption("--name <name>").requiredOption(
     "--template <name>",
     "flag-to-webhook | outcome-to-webhook | sentiment-drop-to-webhook"
   ).requiredOption(
@@ -1310,9 +1329,10 @@ function workflowsCommand() {
     "Flag value / outcome value / sentiment threshold"
   ).requiredOption("--webhook <id>", "Webhook id to fire").option("--message <tpl>", "Message template (supports {{user.id}}, etc.)").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      const result = await c.post(`/api/v1/chatbots/${opts.chatbot}/workflows`, {
+      const result = await c.post(`/api/v1/chatbots/${chatbotId}/workflows`, {
         name: opts.name,
         template: opts.template,
         triggerValue: opts.triggerValue,
@@ -1328,23 +1348,25 @@ function workflowsCommand() {
 }
 function reportsCommand() {
   const cmd = new Command7("reports").description("Manage AI reports");
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").action(async function(opts) {
+  cmd.command("list").action(async function() {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/reports`
+        `/api/v1/chatbots/${chatbotId}/reports`
       );
       emit(result.reports, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("create").description("Create a new AI report; returns the org-private dashboard URL").requiredOption("--chatbot <id>", "Chatbot id").option("--name <name>", "Report name", "Untitled Report").action(async function(opts) {
+  cmd.command("create").description("Create a new AI report; returns the org-private dashboard URL").option("--name <name>", "Report name", "Untitled Report").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
-      const result = await c.post(`/api/v1/chatbots/${opts.chatbot}/reports`, { name: opts.name });
+      const result = await c.post(`/api/v1/chatbots/${chatbotId}/reports`, { name: opts.name });
       process.stderr.write(
         `
 Created report. View it (org members only):
@@ -1364,30 +1386,32 @@ Created report. View it (org members only):
 }
 function analysisCommand() {
   const cmd = new Command7("analysis").description("Manage analysis definitions");
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").option("--type <t>", "intent | flag | assistant_outcome | assistant_issue").option("--pending", "Include pending suggestions").action(async function(opts) {
+  cmd.command("list").option("--type <t>", "intent | flag | assistant_outcome | assistant_issue").option("--pending", "Include pending suggestions").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const qs = new URLSearchParams();
       if (opts.type) qs.set("type", opts.type);
       if (opts.pending) qs.set("pending", "true");
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/analysis-definitions${qs.size ? `?${qs}` : ""}`
+        `/api/v1/chatbots/${chatbotId}/analysis-definitions${qs.size ? `?${qs}` : ""}`
       );
       emit(result.definitions, { json: !!globals.json });
     } catch (err) {
       fatal(err instanceof Error ? err.message : String(err));
     }
   });
-  cmd.command("add").requiredOption("--chatbot <id>", "Chatbot id").requiredOption(
+  cmd.command("add").requiredOption(
     "--type <t>",
     "intent | flag | assistant_outcome | assistant_issue"
   ).requiredOption("--name <slug>", "snake_case slug").requiredOption("--display-name <text>").requiredOption("--description <text>").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const result = await c.post(
-        `/api/v1/chatbots/${opts.chatbot}/analysis-definitions`,
+        `/api/v1/chatbots/${chatbotId}/analysis-definitions`,
         {
           analysisType: opts.type,
           name: opts.name,
@@ -1406,8 +1430,9 @@ function usersCommand() {
   const cmd = new Command7("users").description(
     "List external users (chatbot customers) with health metrics"
   );
-  cmd.command("list").requiredOption("--chatbot <id>", "Chatbot id").option("--from <iso>").option("--to <iso>").option("--days <n>", "Convenience: last N days").option("--search <q>").option("--limit <n>", "Page size", "20").action(async function(opts) {
+  cmd.command("list").option("--from <iso>").option("--to <iso>").option("--days <n>", "Convenience: last N days").option("--search <q>").option("--limit <n>", "Page size", "20").action(async function(opts) {
     try {
+      const chatbotId = requireChatbotId(this);
       const globals = this.optsWithGlobals();
       const c = await client3(globals);
       const qs = new URLSearchParams();
@@ -1422,7 +1447,7 @@ function usersCommand() {
       if (opts.search) qs.set("search", opts.search);
       qs.set("limit", opts.limit);
       const result = await c.get(
-        `/api/v1/chatbots/${opts.chatbot}/external-users?${qs}`
+        `/api/v1/chatbots/${chatbotId}/external-users?${qs}`
       );
       emit(result.users, { json: !!globals.json });
       process.stderr.write(`
@@ -1497,18 +1522,22 @@ function sdkCommand() {
     const out = opts.framework === "vercel-ai-sdk" ? snippetWrapper : snippetNext;
     process.stdout.write(out);
   });
-  cmd.command("verify").description("Check whether any event has arrived for the chatbot yet").requiredOption("--chatbot <id>", "Chatbot id").option("--timeout <n>", "Seconds to wait (default: 60)", "60").action(async function(opts) {
+  cmd.command("verify").description("Check whether any event has arrived for the chatbot yet").option("--timeout <n>", "Seconds to wait (default: 60)", "60").action(async function(opts) {
     try {
       const globals = this.optsWithGlobals();
+      const chatbotId = globals.chatbot;
+      if (!chatbotId) {
+        fatal("--chatbot <id> is required (also accepts the persisted active chatbot).");
+      }
       const c = await client3(globals);
       const timeoutSec = Number(opts.timeout);
       const deadline = Date.now() + timeoutSec * 1e3;
       const params = new URLSearchParams({
-        chatbotId: opts.chatbot,
+        chatbotId,
         limit: "1"
       });
       process.stderr.write(
-        `Waiting for first event on chatbot ${opts.chatbot} (timeout ${timeoutSec}s)\u2026
+        `Waiting for first event on chatbot ${chatbotId} (timeout ${timeoutSec}s)\u2026
 `
       );
       let lastTick = Date.now();
@@ -1544,7 +1573,7 @@ Timed out after ${timeoutSec}s \u2014 no events yet. Confirm OPENBAT_API_KEY and
 var program = new Command8();
 program.name("openbat").description(
   "Query OpenBat chatbot data \u2014 conversations, sentiment, analytics, exports."
-).version("0.2.2").option("--api-key <key>", "Override the stored Read API key (footgun \u2014 leaks into shell history)").option(
+).version("0.2.3").option("--api-key <key>", "Override the stored Read API key (footgun \u2014 leaks into shell history)").option(
   "--base-url <url>",
   "Override the OpenBat API base URL (defaults to ~/.openbatrc or https://openbat.dev)"
 ).option(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openbat/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Command-line tool for querying OpenBat chatbot data — conversations, sentiment, analytics, exports",
   "bin": {
     "openbat": "bin/openbat"
@@ -37,7 +37,10 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "pretest": "npm run build",
+    "test": "node --test --experimental-strip-types --no-warnings 'tests/**/*.test.ts'",
+    "test:integration": "node --test --experimental-strip-types --no-warnings 'tests/integration/**/*.test.ts'"
   },
   "keywords": [
     "openbat",