chatbase 0.2.0 → 0.3.0

package/README.md

@@ -115,7 +115,7 @@ EXAMPLES
   $ chatbase agents auto-retrain --enabled
 ```
 
-_See code: [src/commands/agents/auto-retrain.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/auto-retrain.ts)_
+_See code: [src/commands/agents/auto-retrain.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/auto-retrain.ts)_
 
 ## `chatbase agents clone AGENTID`
 
@@ -145,7 +145,7 @@ EXAMPLES
   $ chatbase agents clone agt_123
 ```
 
-_See code: [src/commands/agents/clone.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/clone.ts)_
+_See code: [src/commands/agents/clone.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/clone.ts)_
 
 ## `chatbase agents create`
 
@@ -180,7 +180,7 @@ EXAMPLES
   $ chatbase agents create --data @agent.json
 ```
 
-_See code: [src/commands/agents/create.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/create.ts)_
+_See code: [src/commands/agents/create.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/create.ts)_
 
 ## `chatbase agents delete AGENTID`
 
@@ -211,7 +211,7 @@ EXAMPLES
   $ chatbase agents delete agt_123 --confirm agt_123
 ```
 
-_See code: [src/commands/agents/delete.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/delete.ts)_
+_See code: [src/commands/agents/delete.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/delete.ts)_
 
 ## `chatbase agents get [AGENTID]`
 
@@ -246,7 +246,7 @@ EXAMPLES
   $ chatbase agents get
 ```
 
-_See code: [src/commands/agents/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/get.ts)_
+_See code: [src/commands/agents/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/get.ts)_
 
 ## `chatbase agents list`
 
@@ -279,7 +279,7 @@ EXAMPLES
   $ chatbase agents list --json
 ```
 
-_See code: [src/commands/agents/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/list.ts)_
+_See code: [src/commands/agents/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/list.ts)_
 
 ## `chatbase agents styles [AGENTID]`
 
@@ -316,7 +316,7 @@ EXAMPLES
   $ chatbase agents styles --data @styles.json
 ```
 
-_See code: [src/commands/agents/styles.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/styles.ts)_
+_See code: [src/commands/agents/styles.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/styles.ts)_
 
 ## `chatbase agents train [AGENTID]`
 
@@ -351,7 +351,7 @@ EXAMPLES
   $ chatbase agents train
 ```
 
-_See code: [src/commands/agents/train.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/train.ts)_
+_See code: [src/commands/agents/train.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/train.ts)_
 
 ## `chatbase agents update [AGENTID]`
 
@@ -393,7 +393,7 @@ EXAMPLES
   $ chatbase agents update agt_123 --data @agent.json
 ```
 
-_See code: [src/commands/agents/update.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/agents/update.ts)_
+_See code: [src/commands/agents/update.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/agents/update.ts)_
 
 ## `chatbase api METHOD PATH`
 
@@ -434,7 +434,7 @@ EXAMPLES
   $ chatbase api PATCH /agents/agt_123 --body @patch.json
 ```
 
-_See code: [src/commands/api.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/api.ts)_
+_See code: [src/commands/api.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/api.ts)_
 
 ## `chatbase auth login`
 
@@ -467,7 +467,7 @@ EXAMPLES
   cat key.txt | chatbase auth login --with-token
 ```
 
-_See code: [src/commands/auth/login.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/auth/login.ts)_
+_See code: [src/commands/auth/login.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/auth/login.ts)_
 
 ## `chatbase auth logout`
 
@@ -494,7 +494,7 @@ EXAMPLES
   $ chatbase auth logout
 ```
 
-_See code: [src/commands/auth/logout.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/auth/logout.ts)_
+_See code: [src/commands/auth/logout.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/auth/logout.ts)_
 
 ## `chatbase auth status`
 
@@ -521,7 +521,7 @@ EXAMPLES
   $ chatbase auth status
 ```
 
-_See code: [src/commands/auth/status.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/auth/status.ts)_
+_See code: [src/commands/auth/status.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/auth/status.ts)_
 
 ## `chatbase chat`
 
@@ -563,7 +563,7 @@ EXAMPLES
   $ chatbase chat -a agt_123 -m "hi" --json
 ```
 
-_See code: [src/commands/chat/index.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/chat/index.ts)_
+_See code: [src/commands/chat/index.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/chat/index.ts)_
 
 ## `chatbase chat retry`
 
@@ -598,7 +598,7 @@ EXAMPLES
   $ chatbase chat retry --conversation c_123 -a agt_123 --message-id msg_456 --no-stream
 ```
 
-_See code: [src/commands/chat/retry.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/chat/retry.ts)_
+_See code: [src/commands/chat/retry.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/chat/retry.ts)_
 
 ## `chatbase config get KEY`
 
@@ -630,7 +630,7 @@ EXAMPLES
   $ chatbase config get timeout
 ```
 
-_See code: [src/commands/config/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/config/get.ts)_
+_See code: [src/commands/config/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/config/get.ts)_
 
 ## `chatbase config list`
 
@@ -657,7 +657,7 @@ EXAMPLES
   $ chatbase config list
 ```
 
-_See code: [src/commands/config/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/config/list.ts)_
+_See code: [src/commands/config/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/config/list.ts)_
 
 ## `chatbase config set KEY [VALUE]`
 
@@ -692,7 +692,7 @@ EXAMPLES
   $ chatbase config set timeout 60000
 ```
 
-_See code: [src/commands/config/set.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/config/set.ts)_
+_See code: [src/commands/config/set.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/config/set.ts)_
 
 ## `chatbase conversations export`
 
@@ -701,19 +701,28 @@ Export conversations from every source, with full message history
 ```
 USAGE
   $ chatbase conversations export [--json] [--plain] [-q] [--verbose] [--no-input] [--no-color] [--agent-name <value> | -a
-    <value>] [--cursor <value>] [--limit <value>] [--all] [-o <value>]
+    <value>] [--cursor <value>] [--limit <value>] [--all] [-o <value>] [--start-date <value>] [--end-date <value>]
+    [--conversation <value>] [--include summary|messages] [--source <value>]
 
 FLAGS
-  -a, --agent=<value>       Agent ID (or set CHATBASE_AGENT_ID)
-  -o, --output=<value>      Write export JSON to a file instead of stdout
-  -q, --quiet               Suppress non-essential output
-      --agent-name=<value>  Agent display name (looked up to an ID)
-      --all                 Fetch every page
-      --cursor=<value>      Opaque cursor from a previous response
-      --limit=<value>       Items per page (1-20, default 20)
-      --no-color            Disable colored output
-      --no-input            Never prompt; fail instead
-      --verbose             Verbose diagnostics
+  -a, --agent=<value>         Agent ID (or set CHATBASE_AGENT_ID)
+  -o, --output=<value>        Write export JSON to a file instead of stdout
+  -q, --quiet                 Suppress non-essential output
+      --agent-name=<value>    Agent display name (looked up to an ID)
+      --all                   Fetch every page
+      --conversation=<value>  Export only this conversation ID, from any source (widget, API, WhatsApp, …)
+      --cursor=<value>        Opaque cursor from a previous response
+      --end-date=<value>      Only conversations created at or before this YYYY-MM-DD date (inclusive) or ISO 8601
+                              date-time
+      --include=<option>      Whether to embed message bodies; summary omits them for a cheaper triage pass
+                              <options: summary|messages>
+      --limit=<value>         Items per page (1-20, default 20)
+      --no-color              Disable colored output
+      --no-input              Never prompt; fail instead
+      --source=<value>        Restrict to these conversation sources (comma-separated, e.g. "Widget or
+                              Iframe,WhatsApp"). Omit for all sources
+      --start-date=<value>    Only conversations created at or after this YYYY-MM-DD date or ISO 8601 date-time
+      --verbose               Verbose diagnostics
 
 OUTPUT FLAGS
   --json   Output raw API JSON
@@ -734,9 +743,15 @@ EXAMPLES
   $ chatbase conversations export -a agt_123
 
   $ chatbase conversations export -a agt_123 --all -o export.json
+
+  $ chatbase conversations export -a agt_123 --start-date 2024-01-01 --end-date 2024-01-31
+
+  $ chatbase conversations export -a agt_123 --include summary --source Widget,WhatsApp
+
+  $ chatbase conversations export -a agt_123 --conversation conv_123
 ```
 
-_See code: [src/commands/conversations/export.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/conversations/export.ts)_
+_See code: [src/commands/conversations/export.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/conversations/export.ts)_
 
 ## `chatbase conversations get [CONVERSATIONID]`
 
@@ -772,7 +787,7 @@ EXAMPLES
   $ chatbase conversations get --conversation conv_123 -a agt_123
 ```
 
-_See code: [src/commands/conversations/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/conversations/get.ts)_
+_See code: [src/commands/conversations/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/conversations/get.ts)_
 
 ## `chatbase conversations list`
 
@@ -781,7 +796,7 @@ List an agent’s API-created conversations
 ```
 USAGE
   $ chatbase conversations list [--json] [--plain] [-q] [--verbose] [--no-input] [--no-color] [--agent-name <value> | -a
-    <value>] [--limit <value>] [--cursor <value>] [--all] [--user <value>]
+    <value>] [--limit <value>] [--cursor <value>] [--all] [--user <value>] [--start-date <value>] [--end-date <value>]
 
 FLAGS
   -a, --agent=<value>       Agent ID (or set CHATBASE_AGENT_ID)
@@ -789,9 +804,12 @@ FLAGS
       --agent-name=<value>  Agent display name (looked up to an ID)
       --all                 Fetch every page
       --cursor=<value>      Pagination cursor from a previous page
+      --end-date=<value>    Only conversations created at or before this YYYY-MM-DD date (inclusive) or ISO 8601
+                            date-time
       --limit=<value>       Maximum items per page
       --no-color            Disable colored output
       --no-input            Never prompt; fail instead
+      --start-date=<value>  Only conversations created at or after this YYYY-MM-DD date or ISO 8601 date-time
       --user=<value>        List conversations for a specific user (uses GET /users/{userId}/conversations)
       --verbose             Verbose diagnostics
 
@@ -815,10 +833,12 @@ EXAMPLES
 
   $ chatbase conversations list -a agt_123 --user usr_456
 
+  $ chatbase conversations list -a agt_123 --start-date 2024-01-01 --end-date 2024-01-31
+
   $ chatbase conversations list -a agt_123 --all --json
 ```
 
-_See code: [src/commands/conversations/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/conversations/list.ts)_
+_See code: [src/commands/conversations/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/conversations/list.ts)_
 
 ## `chatbase conversations tool-result [CONVERSATIONID]`
 
@@ -862,7 +882,7 @@ EXAMPLES
   $ chatbase conversations tool-result conv_123 --tool-call-id tc_1 -a agt_123
 ```
 
-_See code: [src/commands/conversations/tool-result.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/conversations/tool-result.ts)_
+_See code: [src/commands/conversations/tool-result.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/conversations/tool-result.ts)_
 
 ## `chatbase health`
 
@@ -891,7 +911,7 @@ EXAMPLES
   $ chatbase health --json
 ```
 
-_See code: [src/commands/health.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/health.ts)_
+_See code: [src/commands/health.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/health.ts)_
 
 ## `chatbase help [COMMAND]`
 
@@ -941,7 +961,7 @@ EXAMPLES
   $ chatbase helpdesk statuses -a agt_123
 ```
 
-_See code: [src/commands/helpdesk/statuses.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/helpdesk/statuses.ts)_
+_See code: [src/commands/helpdesk/statuses.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/helpdesk/statuses.ts)_
 
 ## `chatbase helpdesk teams`
 
@@ -971,7 +991,7 @@ EXAMPLES
   $ chatbase helpdesk teams -a agt_123
 ```
 
-_See code: [src/commands/helpdesk/teams.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/helpdesk/teams.ts)_
+_See code: [src/commands/helpdesk/teams.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/helpdesk/teams.ts)_
 
 ## `chatbase messages feedback [MESSAGEID]`
 
@@ -1010,7 +1030,7 @@ EXAMPLES
   $ chatbase messages feedback --conversation conv_123 --message msg_1 --rating clear -a agt_123
 ```
 
-_See code: [src/commands/messages/feedback.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/messages/feedback.ts)_
+_See code: [src/commands/messages/feedback.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/messages/feedback.ts)_
 
 ## `chatbase messages list`
 
@@ -1046,7 +1066,7 @@ EXAMPLES
   $ chatbase messages list --conversation conv_123 -a agt_123 --all --json
 ```
 
-_See code: [src/commands/messages/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/messages/list.ts)_
+_See code: [src/commands/messages/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/messages/list.ts)_
 
 ## `chatbase sources create`
 
@@ -1093,7 +1113,7 @@ EXAMPLES
   $ chatbase sources create --file ./guide.pdf -a agt_123
 ```
 
-_See code: [src/commands/sources/create.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/sources/create.ts)_
+_See code: [src/commands/sources/create.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/sources/create.ts)_
 
 ## `chatbase sources delete SOURCEID`
 
@@ -1126,7 +1146,7 @@ EXAMPLES
   $ chatbase sources delete src_1 -a agt_1
 ```
 
-_See code: [src/commands/sources/delete.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/sources/delete.ts)_
+_See code: [src/commands/sources/delete.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/sources/delete.ts)_
 
 ## `chatbase sources get SOURCEID`
 
@@ -1159,7 +1179,7 @@ EXAMPLES
   $ chatbase sources get src_123 -a agt_123
 ```
 
-_See code: [src/commands/sources/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/sources/get.ts)_
+_See code: [src/commands/sources/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/sources/get.ts)_
 
 ## `chatbase sources list`
 
@@ -1196,7 +1216,7 @@ EXAMPLES
   $ chatbase sources list -a agt_123 --all --json
 ```
 
-_See code: [src/commands/sources/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/sources/list.ts)_
+_See code: [src/commands/sources/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/sources/list.ts)_
 
 ## `chatbase sources restore SOURCEID`
 
@@ -1229,7 +1249,7 @@ EXAMPLES
   $ chatbase sources restore src_1 -a agt_1
 ```
 
-_See code: [src/commands/sources/restore.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/sources/restore.ts)_
+_See code: [src/commands/sources/restore.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/sources/restore.ts)_
 
 ## `chatbase sources summary`
 
@@ -1259,7 +1279,7 @@ EXAMPLES
   $ chatbase sources summary -a agt_123
 ```
 
-_See code: [src/commands/sources/summary.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/sources/summary.ts)_
+_See code: [src/commands/sources/summary.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/sources/summary.ts)_
 
 ## `chatbase sources update SOURCEID`
 
@@ -1297,7 +1317,7 @@ EXAMPLES
   $ chatbase sources update src_1 --file ./updated.pdf -a agt_1
 ```
 
-_See code: [src/commands/sources/update.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/sources/update.ts)_
+_See code: [src/commands/sources/update.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/sources/update.ts)_
 
 ## `chatbase tickets create`
 
@@ -1335,7 +1355,7 @@ EXAMPLES
   $ chatbase tickets create --subject "Export failing" --data '{"description":"Customer cannot export.","customer":{"email":"jane@example.com"}}' -a agt_123
 ```
 
-_See code: [src/commands/tickets/create.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/tickets/create.ts)_
+_See code: [src/commands/tickets/create.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/tickets/create.ts)_
 
 ## `chatbase tickets get TICKETNUMBER`
 
@@ -1368,7 +1388,7 @@ EXAMPLES
   $ chatbase tickets get 42 -a agt_123
 ```
 
-_See code: [src/commands/tickets/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/tickets/get.ts)_
+_See code: [src/commands/tickets/get.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/tickets/get.ts)_
 
 ## `chatbase tickets list`
 
@@ -1418,7 +1438,7 @@ EXAMPLES
   $ chatbase tickets list -a agt_123 --all --json
 ```
 
-_See code: [src/commands/tickets/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/tickets/list.ts)_
+_See code: [src/commands/tickets/list.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/tickets/list.ts)_
 
 ## `chatbase tickets messages [TICKETNUMBER]`
 
@@ -1461,7 +1481,7 @@ EXAMPLES
   $ chatbase tickets messages 42 -a agt_123 --all --json
 ```
 
-_See code: [src/commands/tickets/messages.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/tickets/messages.ts)_
+_See code: [src/commands/tickets/messages.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/tickets/messages.ts)_
 
 ## `chatbase tickets reply [TICKETNUMBER]`
 
@@ -1500,7 +1520,7 @@ EXAMPLES
   $ chatbase tickets reply 42 -m "On it" --author-email sam@example.com -a agt_123
 ```
 
-_See code: [src/commands/tickets/reply.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/tickets/reply.ts)_
+_See code: [src/commands/tickets/reply.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/tickets/reply.ts)_
 
 ## `chatbase tickets search QUERY`
 
@@ -1536,7 +1556,7 @@ EXAMPLES
   $ chatbase tickets search "refund" -a agt_123 --limit 10 --json
 ```
 
-_See code: [src/commands/tickets/search.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/tickets/search.ts)_
+_See code: [src/commands/tickets/search.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/tickets/search.ts)_
 
 ## `chatbase tickets update TICKETNUMBER`
 
@@ -1572,7 +1592,7 @@ EXAMPLES
   $ chatbase tickets update 42 --data '{"statusCategory":"closed"}' -a agt_123
 ```
 
-_See code: [src/commands/tickets/update.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/tickets/update.ts)_
+_See code: [src/commands/tickets/update.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/tickets/update.ts)_
 
 ## `chatbase whatsapp send-template TEMPLATE`
 
@@ -1616,7 +1636,7 @@ EXAMPLES
   $ chatbase whatsapp send-template order_update --to 14155552671 --language en_US --variables '{"header":{"1":"#1042"},"body":{"1":"Jane","2":"Friday"}}' -a agt_123
 ```
 
-_See code: [src/commands/whatsapp/send-template.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/whatsapp/send-template.ts)_
+_See code: [src/commands/whatsapp/send-template.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/whatsapp/send-template.ts)_
 
 ## `chatbase whatsapp templates`
 
@@ -1652,5 +1672,5 @@ EXAMPLES
   $ chatbase whatsapp templates -a agt_123 --json
 ```
 
-_See code: [src/commands/whatsapp/templates.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.2.0/src/commands/whatsapp/templates.ts)_
+_See code: [src/commands/whatsapp/templates.ts](https://github.com/Chatbase-co/chatbase-cli/blob/v0.3.0/src/commands/whatsapp/templates.ts)_
 <!-- commandsstop -->

package/dist/commands/conversations/export.js

@@ -16,7 +16,10 @@ export default class ConversationsExport extends AgentCommand {
         'bubble/integration conversations).';
     static examples = [
         '<%= config.bin %> conversations export -a agt_123',
-        '<%= config.bin %> conversations export -a agt_123 --all -o export.json'
+        '<%= config.bin %> conversations export -a agt_123 --all -o export.json',
+        '<%= config.bin %> conversations export -a agt_123 --start-date 2024-01-01 --end-date 2024-01-31',
+        '<%= config.bin %> conversations export -a agt_123 --include summary --source Widget,WhatsApp',
+        '<%= config.bin %> conversations export -a agt_123 --conversation conv_123'
     ];
     // Export is a data-export command, not a display one: it always emits
     // the raw API JSON, in both pretty and --json mode (--plain/--json are
@@ -39,14 +42,50 @@ export default class ConversationsExport extends AgentCommand {
         output: Flags.string({
             char: 'o',
             description: 'Write export JSON to a file instead of stdout'
+        }),
+        // The API owns the day-boundary semantics (a bare YYYY-MM-DD start is
+        // the beginning of that day, an end is the *end* of it) and rejects an
+        // inverted window with VALIDATION_INVALID_DATE_RANGE, so these pass
+        // through unparsed rather than half-reimplementing that rule here.
+        'start-date': Flags.string({
+            description: 'Only conversations created at or after this YYYY-MM-DD date or ISO 8601 date-time'
+        }),
+        'end-date': Flags.string({
+            description: 'Only conversations created at or before this YYYY-MM-DD date (inclusive) or ISO 8601 date-time'
+        }),
+        // Named --conversation to match `conversations get`, though the query
+        // param is conversationId.
+        conversation: Flags.string({
+            description: 'Export only this conversation ID, from any source (widget, API, WhatsApp, …)'
+        }),
+        include: Flags.string({
+            description: 'Whether to embed message bodies; summary omits them for a cheaper triage pass',
+            options: ['summary', 'messages']
+        }),
+        source: Flags.string({
+            description: 'Restrict to these conversation sources (comma-separated, e.g. "Widget or Iframe,WhatsApp"). Omit for all sources'
         })
     };
     async run() {
         const { flags } = await this.parse(ConversationsExport);
         const client = this.apiClient(flags);
         const agentId = await this.agentId(flags, client);
+        const extraQuery = {};
+        if (flags['start-date'])
+            extraQuery.startDate = flags['start-date'];
+        if (flags['end-date'])
+            extraQuery.endDate = flags['end-date'];
+        if (flags.conversation)
+            extraQuery.conversationId = flags.conversation;
+        if (flags.include)
+            extraQuery.include = flags.include;
+        if (flags.source)
+            extraQuery.source = flags.source;
         const { pages, items } = await fetchPages((query) => client.GET('/agents/{agentId}/conversations/export', {
-            params: { path: { agentId }, query }
+            params: {
+                path: { agentId },
+                query: { ...query, ...extraQuery }
+            }
         }), { limit: flags.limit, cursor: flags.cursor, all: flags.all });
         const last = pages.at(-1);
         // Single page stays byte-for-byte the API's envelope; --all merges

package/dist/commands/conversations/list.js

@@ -1,6 +1,7 @@
 import { Flags } from '@oclif/core';
 import { ListCommand } from '../../base/list-command.js';
 import { fetchPages } from '../../client/paginate.js';
+import { UsageError } from '../../errors/errors.js';
 import { formatEpochSeconds } from '../../output/render.js';
 const COLUMNS = [
     { key: 'id', header: 'ID' },
@@ -26,12 +27,23 @@ export default class ConversationsList extends ListCommand {
     static examples = [
         '<%= config.bin %> conversations list -a agt_123',
         '<%= config.bin %> conversations list -a agt_123 --user usr_456',
+        '<%= config.bin %> conversations list -a agt_123 --start-date 2024-01-01 --end-date 2024-01-31',
         '<%= config.bin %> conversations list -a agt_123 --all --json'
     ];
     static flags = {
         ...ListCommand.baseFlags,
         user: Flags.string({
             description: 'List conversations for a specific user (uses GET /users/{userId}/conversations)'
+        }),
+        // The API owns the day-boundary semantics (a bare YYYY-MM-DD start is
+        // the beginning of that day, an end is the *end* of it) and rejects an
+        // inverted window with VALIDATION_INVALID_DATE_RANGE, so these pass
+        // through unparsed rather than half-reimplementing that rule here.
+        'start-date': Flags.string({
+            description: 'Only conversations created at or after this YYYY-MM-DD date or ISO 8601 date-time'
+        }),
+        'end-date': Flags.string({
+            description: 'Only conversations created at or before this YYYY-MM-DD date (inclusive) or ISO 8601 date-time'
         })
     };
     async run() {
@@ -41,13 +53,24 @@ export default class ConversationsList extends ListCommand {
         const fetcherPath = flags.user
             ? '/agents/{agentId}/users/{userId}/conversations'
             : '/agents/{agentId}/conversations';
+        // The per-user endpoint takes only cursor/limit. Sending a date window
+        // there would be dropped server-side and quietly return the unfiltered
+        // list, so refuse instead of returning a wrong answer.
+        if (flags.user && (flags['start-date'] || flags['end-date'])) {
+            throw new UsageError('--start-date/--end-date are not supported with --user. Drop --user to filter by date, then filter the results by userId.');
+        }
+        const extraQuery = {};
+        if (flags['start-date'])
+            extraQuery.startDate = flags['start-date'];
+        if (flags['end-date'])
+            extraQuery.endDate = flags['end-date'];
         const { pages, items } = await fetchPages((query) => client.GET(fetcherPath, {
             params: {
                 path: {
                     agentId,
                     ...(flags.user ? { userId: flags.user } : {})
                 },
-                query
+                query: { ...query, ...extraQuery }
             }
         }), { limit: flags.limit, cursor: flags.cursor, all: flags.all });
         // Humans read ISO dates; --plain keeps the raw epoch for scripts.