@openbat/cli 0.2.2 → 0.3.0

package/README.md

@@ -1,8 +1,10 @@
 # @openbat/cli
 
 Command-line tool for managing OpenBat chatbots end-to-end — read
-analytics + conversations, manage settings + keys + webhooks + workflows
+analytics + conversations, pull daily eval digests (`review`), manage the
+live system prompt (`prompts`), manage settings + keys + webhooks + workflows
 + reports, run experiments, and help install the SDK in a target app.
+All commands operate on one **pinned chatbot** (`openbat use <id>`).
 
 > **Companion docs**: [`@openbat/mcp`](../mcp/README.md) (same surface
 > over MCP), [`lib/openbat-tools/`](../../lib/openbat-tools/README.md)
@@ -63,6 +65,25 @@ rejects it with a helpful error.
 
 ---
 
+## Pin to one chatbot (active-chatbot scope)
+
+`ob_read_*` / `ob_admin_*` keys are already scoped to one chatbot server-side.
+A `ob_pat_*` reaches many — pin one so every command stays on it:
+
+```bash
+openbat use <id|name>     # persists ~/.openbatrc.activeChatbotId
+openbat use               # no arg → shows the current pin + reachable options
+```
+
+Once pinned, every data command (`conversations`, `analytics`, `review`,
+`prompts`, …) targets that chatbot and prints a `→ chatbot: <name> (<id>)`
+banner to **stderr** so scope is never in doubt (and `--json | jq` stays
+clean). Active-chatbot resolution order: `--chatbot <id|name>` flag →
+`$OPENBAT_CHATBOT_ID` → `~/.openbatrc`. The MCP server reads the same pin and
+**hard-locks** to it (see [`@openbat/mcp`](../mcp/README.md)).
+
+---
+
 ## Command tree
 
 ```
@@ -70,7 +91,13 @@ openbat
 ├── config
 │   ├── set-key            Store / replace the key in ~/.openbatrc
 │   ├── set-url <baseUrl>  Override the API base URL
-│   └── show               Print the resolved config (key prefix only)
+│   ├── show               Print the resolved config (key prefix + active chatbot)
+│   ├── use-chatbot <id|name>  Pin the active chatbot (persists to ~/.openbatrc)
+│   └── clear-chatbot     Forget the pinned chatbot
+│
+├── use [id|name]                                             [any kind]
+│   └── Pin the active chatbot (shortcut for `config use-chatbot`).
+│       Omit the arg to print the current pin + the reachable list.
 │
 ├── auth                                                      [any kind]
 │   ├── whoami             Show kind, chatbots in scope, orgs (PAT only)
@@ -96,7 +123,11 @@ openbat
 │
 ├── conversations                                             [any kind]
 │   ├── list [--days N] [--from ISO] [--to ISO] [--limit N]
-│   └── show <id>
+│   └── show <id>             Messages + ALL analyses (issues/outcomes/flags/intents + reasoning)
+│
+├── review [--since 45m|6h|7d]                                [any kind]
+│   └── Daily eval digest: outcome/sentiment deltas + top issues/flags/intents
+│       with representative conversation pointers. Default window 24h.
 │
 ├── users                                                     [any kind]
 │   └── list --chatbot ID [--days] [--search]                 External users + health
@@ -124,6 +155,12 @@ openbat
 │   ├── list --chatbot ID
 │   └── create --chatbot ID [--name "..."]                    Returns org-private dashboard URL
 │
+├── prompts                                                   manage the LIVE published prompt
+│   ├── list                                                  [any kind] versions + active + kill-switch
+│   ├── publish --file PATH | --text "..."                    [admin/pat] create a version + set it LIVE
+│   ├── activate <versionId>                                  [admin/pat] roll back/forward to a version
+│   └── kill-switch --on | --off                              [admin/pat] emergency fallback toggle
+│
 ├── analysis                                                  [admin or pat]
 │   ├── list --chatbot ID [--type] [--pending]
 │   └── add --chatbot ID --type intent|flag|assistant_outcome|assistant_issue
@@ -272,6 +309,9 @@ Per-tool buckets keyed by credential. The strict ones to know about:
 | Create backtest | 10 per hour per PAT |
 | Invite org member | 20 per hour per PAT |
 | Chat with an AI report | 30 per minute per credential |
+| Daily review digest (`review`) | 30 per minute per credential |
+| Publish prompt | 20 per hour per credential |
+| Activate prompt / toggle kill switch | 30 per hour per credential |
 | Generic write | 60 per minute per credential |
 | Generic read | 600 per minute per credential |
 | Export | 30 per hour per credential |
@@ -290,11 +330,12 @@ install the OpenBat agent skill bundle:
 npx skills add openbat-dev/agent-skills
 ```
 
-Drops 8 `SKILL.md` files into your project's `.claude/skills/` (or the
+Drops the `SKILL.md` bundle into your project's `.claude/skills/` (or the
 equivalent for Cursor / Copilot / Gemini CLI / Codex / OpenCode / Amp).
 The bundle covers chatbot onboarding, key management, webhooks,
-workflows, AI reports, SDK install, and safety patterns — written
-specifically for the four-kind auth ladder this CLI exposes.
+workflows, AI reports, SDK install, the daily eval→fix loop
+(`openbat-optimize`), and safety patterns — written specifically for the
+four-kind auth ladder this CLI exposes.
 
 Source + docs: https://github.com/openbat-dev/agent-skills.
 

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.3.0";
 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-KIY62R3O.mjs";
 export {
   ApiClient
 };

package/dist/{chunk-MCDJLQI2.mjs → chunk-KIY62R3O.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.3.0";
 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>`);