chatbase 0.2.0 → 0.3.0

package/oclif.manifest.json

@@ -1652,12 +1652,16 @@
         "set.js"
       ]
     },
-    "helpdesk:statuses": {
+    "conversations:export": {
       "aliases": [],
       "args": {},
-      "description": "List ticket statuses for an agent",
+      "description": "Export conversations with full message history, newest first.\n\nThis is the only endpoint that returns conversations from every source — the chat bubble and external integrations (Slack, WhatsApp, Instagram, Messenger, and the like) as well as API-created ones. Prefer it over `conversations list` whenever you need real traffic rather than just programmatically created conversations. Each item embeds its own `messages` array, so no follow-up `conversations get` or `messages list` call is needed (and neither works for bubble/integration conversations).",
       "examples": [
-        "<%= config.bin %> helpdesk statuses -a agt_123"
+        "<%= 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 --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"
       ],
       "flags": {
         "json": {
@@ -1716,85 +1720,70 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "helpdesk:statuses",
-      "pluginAlias": "chatbase",
-      "pluginName": "chatbase",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "helpdesk",
-        "statuses.js"
-      ]
-    },
-    "helpdesk:teams": {
-      "aliases": [],
-      "args": {},
-      "description": "List helpdesk teams for an agent",
-      "examples": [
-        "<%= config.bin %> helpdesk teams -a agt_123"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output raw API JSON",
-          "helpGroup": "OUTPUT",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
         },
-        "plain": {
-          "description": "Tab-separated output for scripts",
-          "helpGroup": "OUTPUT",
-          "name": "plain",
-          "allowNo": false,
-          "type": "boolean"
+        "cursor": {
+          "description": "Opaque cursor from a previous response",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "quiet": {
-          "char": "q",
-          "description": "Suppress non-essential output",
-          "name": "quiet",
-          "allowNo": false,
-          "type": "boolean"
+        "limit": {
+          "description": "Items per page (1-20, default 20)",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "verbose": {
-          "description": "Verbose diagnostics",
-          "name": "verbose",
+        "all": {
+          "description": "Fetch every page",
+          "name": "all",
           "allowNo": false,
           "type": "boolean"
         },
-        "no-input": {
-          "description": "Never prompt; fail instead",
-          "name": "no-input",
-          "allowNo": false,
-          "type": "boolean"
+        "output": {
+          "char": "o",
+          "description": "Write export JSON to a file instead of stdout",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "no-color": {
-          "description": "Disable colored output",
-          "name": "no-color",
-          "allowNo": false,
-          "type": "boolean"
+        "start-date": {
+          "description": "Only conversations created at or after this YYYY-MM-DD date or ISO 8601 date-time",
+          "name": "start-date",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "agent": {
-          "char": "a",
-          "description": "Agent ID (or set CHATBASE_AGENT_ID)",
-          "name": "agent",
+        "end-date": {
+          "description": "Only conversations created at or before this YYYY-MM-DD date (inclusive) or ISO 8601 date-time",
+          "name": "end-date",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "agent-name": {
-          "description": "Agent display name (looked up to an ID)",
-          "exclusive": [
-            "agent"
+        "conversation": {
+          "description": "Export only this conversation ID, from any source (widget, API, WhatsApp, …)",
+          "name": "conversation",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "include": {
+          "description": "Whether to embed message bodies; summary omits them for a cheaper triage pass",
+          "name": "include",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "summary",
+            "messages"
           ],
-          "name": "agent-name",
+          "type": "option"
+        },
+        "source": {
+          "description": "Restrict to these conversation sources (comma-separated, e.g. \"Widget or Iframe,WhatsApp\"). Omit for all sources",
+          "name": "source",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1802,33 +1791,34 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "helpdesk:teams",
+      "id": "conversations:export",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
+      "summary": "Export conversations from every source, with full message history",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "helpdesk",
-        "teams.js"
+        "conversations",
+        "export.js"
       ]
     },
-    "messages:feedback": {
+    "conversations:get": {
       "aliases": [],
       "args": {
-        "messageId": {
-          "description": "Message ID (alternative to --message)",
-          "name": "messageId",
+        "conversationId": {
+          "description": "Conversation ID (alternative to --conversation)",
+          "name": "conversationId",
           "required": false
         }
       },
-      "description": "Set or clear user feedback on an assistant message",
+      "description": "Show one conversation",
       "examples": [
-        "<%= config.bin %> messages feedback msg_1 --conversation conv_123 --rating positive -a agt_123",
-        "<%= config.bin %> messages feedback --conversation conv_123 --message msg_1 --rating clear -a agt_123"
+        "<%= config.bin %> conversations get conv_123 -a agt_123",
+        "<%= config.bin %> conversations get --conversation conv_123 -a agt_123"
       ],
       "flags": {
         "json": {
@@ -1891,35 +1881,14 @@
         "conversation": {
           "description": "Conversation ID",
           "name": "conversation",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "message": {
-          "description": "Message ID",
-          "name": "message",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "rating": {
-          "description": "Feedback value (\"clear\" removes existing feedback)",
-          "name": "rating",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "positive",
-            "negative",
-            "clear"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "messages:feedback",
+      "id": "conversations:get",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -1929,17 +1898,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "messages",
-        "feedback.js"
+        "conversations",
+        "get.js"
       ]
     },
-    "messages:list": {
+    "conversations:list": {
       "aliases": [],
       "args": {},
-      "description": "List messages in a conversation",
+      "description": "List conversations for an agent, newest first.\n\nScope: the API v2 list endpoint returns only conversations created programmatically through the API. Conversations from the chat bubble and external integrations (Slack, WhatsApp, Instagram, Messenger, and the like) are not accessible here and are not counted in `total`. Use `chatbase conversations export` to read conversations from every source — it also embeds full message history, which `conversations get` and `messages list` cannot retrieve for those conversations.",
       "examples": [
-        "<%= config.bin %> messages list --conversation conv_123 -a agt_123",
-        "<%= config.bin %> messages list --conversation conv_123 -a agt_123 --all --json"
+        "<%= 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"
       ],
       "flags": {
         "json": {
@@ -2019,10 +1990,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "conversation": {
-          "description": "Conversation ID",
-          "name": "conversation",
-          "required": true,
+        "user": {
+          "description": "List conversations for a specific user (uses GET /users/{userId}/conversations)",
+          "name": "user",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start-date": {
+          "description": "Only conversations created at or after this YYYY-MM-DD date or ISO 8601 date-time",
+          "name": "start-date",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-date": {
+          "description": "Only conversations created at or before this YYYY-MM-DD date (inclusive) or ISO 8601 date-time",
+          "name": "end-date",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2030,27 +2014,35 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "messages:list",
+      "id": "conversations:list",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
+      "summary": "List an agent’s API-created conversations",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "messages",
+        "conversations",
         "list.js"
       ]
     },
-    "conversations:export": {
+    "conversations:tool-result": {
       "aliases": [],
-      "args": {},
-      "description": "Export conversations with full message history, newest first.\n\nThis is the only endpoint that returns conversations from every source — the chat bubble and external integrations (Slack, WhatsApp, Instagram, Messenger, and the like) as well as API-created ones. Prefer it over `conversations list` whenever you need real traffic rather than just programmatically created conversations. Each item embeds its own `messages` array, so no follow-up `conversations get` or `messages list` call is needed (and neither works for bubble/integration conversations).",
+      "args": {
+        "conversationId": {
+          "description": "Conversation ID (alternative to --conversation)",
+          "name": "conversationId",
+          "required": false
+        }
+      },
+      "description": "Submit the result of a client-side tool call so the paused chat turn can continue. The tool call ID comes from the tool-call part of the chat response that requested the execution.",
       "examples": [
-        "<%= config.bin %> conversations export -a agt_123",
-        "<%= config.bin %> conversations export -a agt_123 --all -o export.json"
+        "<%= config.bin %> conversations tool-result conv_123 --tool-call-id tc_1 --output '{\"temperature\": 72}' -a agt_123",
+        "<%= config.bin %> conversations tool-result conv_123 --tool-call-id tc_1 --output @result.json -a agt_123",
+        "<%= config.bin %> conversations tool-result conv_123 --tool-call-id tc_1 -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2110,29 +2102,23 @@
           "multiple": false,
           "type": "option"
         },
-        "cursor": {
-          "description": "Opaque cursor from a previous response",
-          "name": "cursor",
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "Items per page (1-20, default 20)",
-          "name": "limit",
+        "tool-call-id": {
+          "description": "The toolCallId from the tool-call part in the chat response",
+          "name": "tool-call-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "output": {
-          "char": "o",
-          "description": "Write export JSON to a file instead of stdout",
+          "description": "Result of executing the tool (inline JSON, @file, or @-); a value that is not valid JSON is sent as a plain string",
           "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2141,34 +2127,27 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:export",
+      "id": "conversations:tool-result",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
-      "summary": "Export conversations from every source, with full message history",
+      "summary": "Submit a client-side tool result to a chat turn",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
         "conversations",
-        "export.js"
+        "tool-result.js"
       ]
     },
-    "conversations:get": {
+    "helpdesk:statuses": {
       "aliases": [],
-      "args": {
-        "conversationId": {
-          "description": "Conversation ID (alternative to --conversation)",
-          "name": "conversationId",
-          "required": false
-        }
-      },
-      "description": "Show one conversation",
+      "args": {},
+      "description": "List ticket statuses for an agent",
       "examples": [
-        "<%= config.bin %> conversations get conv_123 -a agt_123",
-        "<%= config.bin %> conversations get --conversation conv_123 -a agt_123"
+        "<%= config.bin %> helpdesk statuses -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2227,18 +2206,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "conversation": {
-          "description": "Conversation ID",
-          "name": "conversation",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:get",
+      "id": "helpdesk:statuses",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2248,18 +2220,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "get.js"
-      ]
+        "helpdesk",
+        "statuses.js"
+      ]
     },
-    "conversations:list": {
+    "helpdesk:teams": {
       "aliases": [],
       "args": {},
-      "description": "List conversations for an agent, newest first.\n\nScope: the API v2 list endpoint returns only conversations created programmatically through the API. Conversations from the chat bubble and external integrations (Slack, WhatsApp, Instagram, Messenger, and the like) are not accessible here and are not counted in `total`. Use `chatbase conversations export` to read conversations from every source — it also embeds full message history, which `conversations get` and `messages list` cannot retrieve for those conversations.",
+      "description": "List helpdesk teams for an agent",
       "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 --all --json"
+        "<%= config.bin %> helpdesk teams -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2318,66 +2288,37 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "limit": {
-          "description": "Maximum items per page",
-          "name": "limit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cursor": {
-          "description": "Pagination cursor from a previous page",
-          "name": "cursor",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "user": {
-          "description": "List conversations for a specific user (uses GET /users/{userId}/conversations)",
-          "name": "user",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:list",
+      "id": "helpdesk:teams",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
-      "summary": "List an agent’s API-created conversations",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "list.js"
+        "helpdesk",
+        "teams.js"
       ]
     },
-    "conversations:tool-result": {
+    "messages:feedback": {
       "aliases": [],
       "args": {
-        "conversationId": {
-          "description": "Conversation ID (alternative to --conversation)",
-          "name": "conversationId",
+        "messageId": {
+          "description": "Message ID (alternative to --message)",
+          "name": "messageId",
           "required": false
         }
       },
-      "description": "Submit the result of a client-side tool call so the paused chat turn can continue. The tool call ID comes from the tool-call part of the chat response that requested the execution.",
+      "description": "Set or clear user feedback on an assistant message",
       "examples": [
-        "<%= config.bin %> conversations tool-result conv_123 --tool-call-id tc_1 --output '{\"temperature\": 72}' -a agt_123",
-        "<%= config.bin %> conversations tool-result conv_123 --tool-call-id tc_1 --output @result.json -a agt_123",
-        "<%= config.bin %> conversations tool-result conv_123 --tool-call-id tc_1 -a agt_123"
+        "<%= config.bin %> messages feedback msg_1 --conversation conv_123 --rating positive -a agt_123",
+        "<%= config.bin %> messages feedback --conversation conv_123 --message msg_1 --rating clear -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2440,56 +2381,55 @@
         "conversation": {
           "description": "Conversation ID",
           "name": "conversation",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tool-call-id": {
-          "description": "The toolCallId from the tool-call part in the chat response",
-          "name": "tool-call-id",
-          "required": true,
+        "message": {
+          "description": "Message ID",
+          "name": "message",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "description": "Result of executing the tool (inline JSON, @file, or @-); a value that is not valid JSON is sent as a plain string",
-          "name": "output",
+        "rating": {
+          "description": "Feedback value (\"clear\" removes existing feedback)",
+          "name": "rating",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "positive",
+            "negative",
+            "clear"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:tool-result",
+      "id": "messages:feedback",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
-      "summary": "Submit a client-side tool result to a chat turn",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "tool-result.js"
+        "messages",
+        "feedback.js"
       ]
     },
-    "whatsapp:send-template": {
+    "messages:list": {
       "aliases": [],
-      "args": {
-        "template": {
-          "description": "Name of the approved template",
-          "name": "template",
-          "required": true
-        }
-      },
-      "description": "Send an approved WhatsApp template to a phone number from one of the agent’s connected numbers. No user ID is needed — a Chatbase user is resolved or created from the recipient number, and replies flow through the agent’s regular WhatsApp pipeline. Use `whatsapp templates` to see available templates and the variables each expects.",
+      "args": {},
+      "description": "List messages in a conversation",
       "examples": [
-        "<%= config.bin %> whatsapp send-template order_update --to 14155552671 -a agt_123",
-        "<%= config.bin %> whatsapp send-template order_update --to 14155552671 --language en_US --variables '{\"header\":{\"1\":\"#1042\"},\"body\":{\"1\":\"Jane\",\"2\":\"Friday\"}}' -a agt_123"
+        "<%= config.bin %> messages list --conversation conv_123 -a agt_123",
+        "<%= config.bin %> messages list --conversation conv_123 -a agt_123 --all --json"
       ],
       "flags": {
         "json": {
@@ -2549,31 +2489,30 @@
           "multiple": false,
           "type": "option"
         },
-        "to": {
-          "description": "Recipient phone number in international format (digits with country code)",
-          "name": "to",
-          "required": true,
+        "limit": {
+          "description": "Maximum items per page",
+          "name": "limit",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "from": {
-          "description": "Which connected WhatsApp number to send from — optional when the agent has exactly one",
-          "name": "from",
+        "cursor": {
+          "description": "Pagination cursor from a previous page",
+          "name": "cursor",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "language": {
-          "description": "Template language code (e.g. en_US) — optional when the template exists in a single language",
-          "name": "language",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "all": {
+          "description": "Fetch every page",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "variables": {
-          "description": "Template variable values as JSON grouped by component (@file, @-, or inline), e.g. '{\"body\":{\"1\":\"Jane\"}}'",
-          "name": "variables",
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2581,28 +2520,29 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "whatsapp:send-template",
+      "id": "messages:list",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
-      "summary": "Send an approved WhatsApp template message",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "whatsapp",
-        "send-template.js"
+        "messages",
+        "list.js"
       ]
     },
-    "whatsapp:templates": {
+    "sources:create": {
       "aliases": [],
       "args": {},
-      "description": "List the approved WhatsApp templates available to the agent, across all of its connected WhatsApp Business Accounts. A template can only be sent from a number on its own Business Account — pick a sender whose WABA matches the template’s WABA column.",
+      "description": "Create a source: text/qna/link (JSON) or a file upload",
       "examples": [
-        "<%= config.bin %> whatsapp templates -a agt_123",
-        "<%= config.bin %> whatsapp templates -a agt_123 --json"
+        "<%= config.bin %> sources create --type text --name Guide --content \"hello\" -a agt_123",
+        "<%= config.bin %> sources create --type link --url https://example.com --link-type crawl -a agt_123",
+        "<%= config.bin %> sources create --type qna --data '{\"questions\":[\"Q1\"],\"answer\":\"A1\"}' -a agt_123",
+        "<%= config.bin %> sources create --file ./guide.pdf -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2661,32 +2601,113 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "type": {
+          "description": "JSON source type (mutually exclusive with --file)",
+          "exclusive": [
+            "file"
+          ],
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "qna",
+            "link"
+          ],
+          "type": "option"
+        },
+        "file": {
+          "description": "Path to a file to upload as a source (mutually exclusive with --type)",
+          "exclusive": [
+            "type",
+            "data",
+            "content",
+            "url",
+            "link-type"
+          ],
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Source name (--type text/qna, or a file upload)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "description": "Text content for --type text (@file, @-, or inline)",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "description": "URL for --type link",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "link-type": {
+          "description": "Link crawl mode for --type link",
+          "name": "link-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "individual",
+            "sitemap",
+            "crawl"
+          ],
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON body (@file, @-, or inline); per-type flags override matching keys",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "whatsapp:templates",
+      "id": "sources:create",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
-      "summary": "List approved WhatsApp templates for an agent",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "whatsapp",
-        "templates.js"
+        "sources",
+        "create.js"
       ]
     },
-    "tickets:create": {
+    "sources:delete": {
       "aliases": [],
-      "args": {},
-      "description": "Create a helpdesk ticket",
+      "args": {
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
+        }
+      },
+      "description": "Delete a source (restorable via restore command)",
       "examples": [
-        "<%= config.bin %> tickets create --subject \"Export failing\" -f description=\"Customer cannot export.\" --customer-email jane@example.com -a agt_123",
-        "<%= config.bin %> tickets create --subject \"Export failing\" --data '{\"description\":\"Customer cannot export.\",\"customer\":{\"email\":\"jane@example.com\"}}' -a agt_123"
+        "<%= config.bin %> sources delete src_1 -a agt_1"
       ],
       "flags": {
         "json": {
@@ -2745,50 +2766,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "field": {
-          "char": "f",
-          "description": "Set a body field: -f key=value (repeatable)",
-          "name": "field",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "subject": {
-          "description": "Ticket subject",
-          "name": "subject",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "customer-email": {
-          "description": "Customer email — builds the required customer object (alternative to customer in --data)",
-          "name": "customer-email",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "customer-name": {
-          "dependsOn": [
-            "customer-email"
-          ],
-          "description": "Customer display name, used only when the email creates a new customer record",
-          "name": "customer-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "data": {
-          "description": "JSON body (@file, @-, or inline). Fields: subject, description, customer, statusId, statusCategory, assigneeId, assigneeEmail, teamId",
-          "name": "data",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:create",
+      "id": "sources:delete",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2798,22 +2780,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "create.js"
+        "sources",
+        "delete.js"
       ]
     },
-    "tickets:get": {
+    "sources:get": {
       "aliases": [],
       "args": {
-        "ticketNumber": {
-          "description": "Ticket number",
-          "name": "ticketNumber",
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
           "required": true
         }
       },
-      "description": "Show one helpdesk ticket",
+      "description": "Show one source",
       "examples": [
-        "<%= config.bin %> tickets get 42 -a agt_123"
+        "<%= config.bin %> sources get src_123 -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2876,7 +2858,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:get",
+      "id": "sources:get",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2886,18 +2868,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
+        "sources",
         "get.js"
       ]
     },
-    "tickets:list": {
+    "sources:list": {
       "aliases": [],
       "args": {},
-      "description": "List helpdesk tickets for an agent",
+      "description": "List sources for an agent",
       "examples": [
-        "<%= config.bin %> tickets list -a agt_123",
-        "<%= config.bin %> tickets list -a agt_123 --status new,on_you",
-        "<%= config.bin %> tickets list -a agt_123 --all --json"
+        "<%= config.bin %> sources list -a agt_123",
+        "<%= config.bin %> sources list -a agt_123 --all --json"
       ],
       "flags": {
         "json": {
@@ -2977,81 +2958,24 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "status": {
-          "description": "Filter by status (comma-separated): new, on_you, on_customer, on_hold, closed, cancelled",
-          "name": "status",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "channel": {
-          "description": "Filter by channel (comma-separated, e.g. email,api)",
-          "name": "channel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "assignee-id": {
-          "description": "Filter by assignee UUID, or \"none\" for unassigned",
-          "name": "assignee-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "team-id": {
-          "description": "Filter by team UUID, or \"none\" for no team",
-          "name": "team-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "created-after": {
-          "description": "Only tickets created after this ISO 8601 date",
-          "name": "created-after",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "created-before": {
-          "description": "Only tickets created before this ISO 8601 date",
-          "name": "created-before",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort-by": {
-          "description": "Sort field",
-          "name": "sort-by",
+        "type": {
+          "description": "Filter by source type",
+          "name": "type",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "createdAt",
-            "updatedAt",
-            "lastMessageAt"
-          ],
           "type": "option"
         },
-        "order": {
-          "description": "Sort direction",
-          "name": "order",
+        "name": {
+          "description": "Filter by source name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "asc",
-            "desc"
-          ],
           "type": "option"
-        },
-        "include-total": {
-          "description": "Include pagination.total in the response",
-          "name": "include-total",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:list",
+      "id": "sources:list",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3061,23 +2985,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
+        "sources",
         "list.js"
       ]
     },
-    "tickets:messages": {
+    "sources:restore": {
       "aliases": [],
       "args": {
-        "ticketNumber": {
-          "description": "Ticket number (alternative to --ticket)",
-          "name": "ticketNumber",
-          "required": false
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
         }
       },
-      "description": "List a ticket's message thread",
+      "description": "Restore a deleted source",
       "examples": [
-        "<%= config.bin %> tickets messages 42 -a agt_123",
-        "<%= config.bin %> tickets messages 42 -a agt_123 --all --json"
+        "<%= config.bin %> sources restore src_1 -a agt_1"
       ],
       "flags": {
         "json": {
@@ -3136,56 +3059,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "limit": {
-          "description": "Maximum items per page",
-          "name": "limit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cursor": {
-          "description": "Pagination cursor from a previous page",
-          "name": "cursor",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "ticket": {
-          "description": "Ticket number",
-          "name": "ticket",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "types": {
-          "description": "Message types to include (comma-separated): reply, note, event (default: reply,note)",
-          "name": "types",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "order": {
-          "description": "Sort direction",
-          "name": "order",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "asc",
-            "desc"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:messages",
+      "id": "sources:restore",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3195,22 +3073,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "messages.js"
+        "sources",
+        "restore.js"
       ]
     },
-    "tickets:reply": {
+    "sources:summary": {
       "aliases": [],
-      "args": {
-        "ticketNumber": {
-          "description": "Ticket number (alternative to --ticket)",
-          "name": "ticketNumber",
-          "required": false
-        }
-      },
-      "description": "Post an agent reply to a ticket's message thread",
+      "args": {},
+      "description": "Show aggregated source counts and sizes for an agent",
       "examples": [
-        "<%= config.bin %> tickets reply 42 -m \"On it\" --author-email sam@example.com -a agt_123"
+        "<%= config.bin %> sources summary -a agt_123"
       ],
       "flags": {
         "json": {
@@ -3269,41 +3141,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "ticket": {
-          "description": "Ticket number",
-          "name": "ticket",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "message": {
-          "char": "m",
-          "description": "Reply body as GitHub-flavored Markdown",
-          "name": "message",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "author-id": {
-          "description": "Platform user id of the team member the reply is attributed to (exactly one of --author-id/--author-email)",
-          "name": "author-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "author-email": {
-          "description": "Email of the team member the reply is attributed to (exactly one of --author-id/--author-email)",
-          "name": "author-email",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:reply",
+      "id": "sources:summary",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3313,23 +3155,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "reply.js"
+        "sources",
+        "summary.js"
       ]
     },
-    "tickets:search": {
+    "sources:update": {
       "aliases": [],
       "args": {
-        "query": {
-          "description": "Free-text search terms (matched against ticket messages)",
-          "name": "query",
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
           "required": true
         }
       },
-      "description": "Search tickets by message content",
+      "description": "Update an existing source (text, qna, link, or file)",
       "examples": [
-        "<%= config.bin %> tickets search \"refund not received\" -a agt_123",
-        "<%= config.bin %> tickets search \"refund\" -a agt_123 --limit 10 --json"
+        "<%= config.bin %> sources update src_1 --data '{\"type\":\"text\",\"content\":\"new\"}' -a agt_1",
+        "<%= config.bin %> sources update src_1 --file ./updated.pdf -a agt_1"
       ],
       "flags": {
         "json": {
@@ -3389,9 +3231,31 @@
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "Number of results (1–50, default 20)",
-          "name": "limit",
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON body for text/qna/link sources (@file, @-, or inline)",
+          "exclusive": [
+            "file"
+          ],
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "file": {
+          "description": "Path to a file to upload as a replacement (mutually exclusive with --data)",
+          "exclusive": [
+            "data",
+            "field"
+          ],
+          "name": "file",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3399,7 +3263,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:search",
+      "id": "sources:update",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3409,22 +3273,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "search.js"
+        "sources",
+        "update.js"
       ]
     },
-    "tickets:update": {
+    "tickets:create": {
       "aliases": [],
-      "args": {
-        "ticketNumber": {
-          "description": "Ticket number",
-          "name": "ticketNumber",
-          "required": true
-        }
-      },
-      "description": "Update a ticket's status, assignee, and/or team",
+      "args": {},
+      "description": "Create a helpdesk ticket",
       "examples": [
-        "<%= config.bin %> tickets update 42 --data '{\"statusCategory\":\"closed\"}' -a agt_123"
+        "<%= config.bin %> tickets create --subject \"Export failing\" -f description=\"Customer cannot export.\" --customer-email jane@example.com -a agt_123",
+        "<%= config.bin %> tickets create --subject \"Export failing\" --data '{\"description\":\"Customer cannot export.\",\"customer\":{\"email\":\"jane@example.com\"}}' -a agt_123"
       ],
       "flags": {
         "json": {
@@ -3492,8 +3351,32 @@
           "multiple": true,
           "type": "option"
         },
+        "subject": {
+          "description": "Ticket subject",
+          "name": "subject",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "customer-email": {
+          "description": "Customer email — builds the required customer object (alternative to customer in --data)",
+          "name": "customer-email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "customer-name": {
+          "dependsOn": [
+            "customer-email"
+          ],
+          "description": "Customer display name, used only when the email creates a new customer record",
+          "name": "customer-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "data": {
-          "description": "JSON body (@file, @-, or inline). Fields: statusId, statusCategory, assigneeId, assigneeEmail, teamId",
+          "description": "JSON body (@file, @-, or inline). Fields: subject, description, customer, statusId, statusCategory, assigneeId, assigneeEmail, teamId",
           "name": "data",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3502,7 +3385,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:update",
+      "id": "tickets:create",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3513,18 +3396,21 @@
         "dist",
         "commands",
         "tickets",
-        "update.js"
+        "create.js"
       ]
     },
-    "sources:create": {
+    "tickets:get": {
       "aliases": [],
-      "args": {},
-      "description": "Create a source: text/qna/link (JSON) or a file upload",
+      "args": {
+        "ticketNumber": {
+          "description": "Ticket number",
+          "name": "ticketNumber",
+          "required": true
+        }
+      },
+      "description": "Show one helpdesk ticket",
       "examples": [
-        "<%= config.bin %> sources create --type text --name Guide --content \"hello\" -a agt_123",
-        "<%= config.bin %> sources create --type link --url https://example.com --link-type crawl -a agt_123",
-        "<%= config.bin %> sources create --type qna --data '{\"questions\":[\"Q1\"],\"answer\":\"A1\"}' -a agt_123",
-        "<%= config.bin %> sources create --file ./guide.pdf -a agt_123"
+        "<%= config.bin %> tickets get 42 -a agt_123"
       ],
       "flags": {
         "json": {
@@ -3583,88 +3469,186 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tickets:get",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tickets",
+        "get.js"
+      ]
+    },
+    "tickets:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List helpdesk tickets for an agent",
+      "examples": [
+        "<%= config.bin %> tickets list -a agt_123",
+        "<%= config.bin %> tickets list -a agt_123 --status new,on_you",
+        "<%= config.bin %> tickets list -a agt_123 --all --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output raw API JSON",
+          "helpGroup": "OUTPUT",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "field": {
-          "char": "f",
-          "description": "Set a body field: -f key=value (repeatable)",
-          "name": "field",
+        "plain": {
+          "description": "Tab-separated output for scripts",
+          "helpGroup": "OUTPUT",
+          "name": "plain",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "quiet": {
+          "char": "q",
+          "description": "Suppress non-essential output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Verbose diagnostics",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-input": {
+          "description": "Never prompt; fail instead",
+          "name": "no-input",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-color": {
+          "description": "Disable colored output",
+          "name": "no-color",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "agent": {
+          "char": "a",
+          "description": "Agent ID (or set CHATBASE_AGENT_ID)",
+          "name": "agent",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "type": {
-          "description": "JSON source type (mutually exclusive with --file)",
+        "agent-name": {
+          "description": "Agent display name (looked up to an ID)",
           "exclusive": [
-            "file"
+            "agent"
           ],
-          "name": "type",
+          "name": "agent-name",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "text",
-            "qna",
-            "link"
-          ],
           "type": "option"
         },
-        "file": {
-          "description": "Path to a file to upload as a source (mutually exclusive with --type)",
-          "exclusive": [
-            "type",
-            "data",
-            "content",
-            "url",
-            "link-type"
-          ],
-          "name": "file",
+        "limit": {
+          "description": "Maximum items per page",
+          "name": "limit",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Source name (--type text/qna, or a file upload)",
-          "name": "name",
+        "cursor": {
+          "description": "Pagination cursor from a previous page",
+          "name": "cursor",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "content": {
-          "description": "Text content for --type text (@file, @-, or inline)",
-          "name": "content",
+        "all": {
+          "description": "Fetch every page",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "status": {
+          "description": "Filter by status (comma-separated): new, on_you, on_customer, on_hold, closed, cancelled",
+          "name": "status",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "url": {
-          "description": "URL for --type link",
-          "name": "url",
+        "channel": {
+          "description": "Filter by channel (comma-separated, e.g. email,api)",
+          "name": "channel",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "link-type": {
-          "description": "Link crawl mode for --type link",
-          "name": "link-type",
+        "assignee-id": {
+          "description": "Filter by assignee UUID, or \"none\" for unassigned",
+          "name": "assignee-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "team-id": {
+          "description": "Filter by team UUID, or \"none\" for no team",
+          "name": "team-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "created-after": {
+          "description": "Only tickets created after this ISO 8601 date",
+          "name": "created-after",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "created-before": {
+          "description": "Only tickets created before this ISO 8601 date",
+          "name": "created-before",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort-by": {
+          "description": "Sort field",
+          "name": "sort-by",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "individual",
-            "sitemap",
-            "crawl"
+            "createdAt",
+            "updatedAt",
+            "lastMessageAt"
           ],
           "type": "option"
         },
-        "data": {
-          "description": "JSON body (@file, @-, or inline); per-type flags override matching keys",
-          "name": "data",
+        "order": {
+          "description": "Sort direction",
+          "name": "order",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "asc",
+            "desc"
+          ],
           "type": "option"
+        },
+        "include-total": {
+          "description": "Include pagination.total in the response",
+          "name": "include-total",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sources:create",
+      "id": "tickets:list",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3674,22 +3658,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "sources",
-        "create.js"
+        "tickets",
+        "list.js"
       ]
     },
-    "sources:delete": {
+    "tickets:messages": {
       "aliases": [],
       "args": {
-        "sourceId": {
-          "description": "Source ID",
-          "name": "sourceId",
-          "required": true
+        "ticketNumber": {
+          "description": "Ticket number (alternative to --ticket)",
+          "name": "ticketNumber",
+          "required": false
         }
       },
-      "description": "Delete a source (restorable via restore command)",
+      "description": "List a ticket's message thread",
       "examples": [
-        "<%= config.bin %> sources delete src_1 -a agt_1"
+        "<%= config.bin %> tickets messages 42 -a agt_123",
+        "<%= config.bin %> tickets messages 42 -a agt_123 --all --json"
       ],
       "flags": {
         "json": {
@@ -3739,20 +3724,65 @@
           "multiple": false,
           "type": "option"
         },
-        "agent-name": {
-          "description": "Agent display name (looked up to an ID)",
-          "exclusive": [
-            "agent"
-          ],
-          "name": "agent-name",
+        "agent-name": {
+          "description": "Agent display name (looked up to an ID)",
+          "exclusive": [
+            "agent"
+          ],
+          "name": "agent-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum items per page",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cursor": {
+          "description": "Pagination cursor from a previous page",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "all": {
+          "description": "Fetch every page",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ticket": {
+          "description": "Ticket number",
+          "name": "ticket",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "types": {
+          "description": "Message types to include (comma-separated): reply, note, event (default: reply,note)",
+          "name": "types",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "order": {
+          "description": "Sort direction",
+          "name": "order",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "asc",
+            "desc"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sources:delete",
+      "id": "tickets:messages",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3762,22 +3792,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "sources",
-        "delete.js"
+        "tickets",
+        "messages.js"
       ]
     },
-    "sources:get": {
+    "tickets:reply": {
       "aliases": [],
       "args": {
-        "sourceId": {
-          "description": "Source ID",
-          "name": "sourceId",
-          "required": true
+        "ticketNumber": {
+          "description": "Ticket number (alternative to --ticket)",
+          "name": "ticketNumber",
+          "required": false
         }
       },
-      "description": "Show one source",
+      "description": "Post an agent reply to a ticket's message thread",
       "examples": [
-        "<%= config.bin %> sources get src_123 -a agt_123"
+        "<%= config.bin %> tickets reply 42 -m \"On it\" --author-email sam@example.com -a agt_123"
       ],
       "flags": {
         "json": {
@@ -3836,11 +3866,41 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "ticket": {
+          "description": "Ticket number",
+          "name": "ticket",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "Reply body as GitHub-flavored Markdown",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "author-id": {
+          "description": "Platform user id of the team member the reply is attributed to (exactly one of --author-id/--author-email)",
+          "name": "author-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "author-email": {
+          "description": "Email of the team member the reply is attributed to (exactly one of --author-id/--author-email)",
+          "name": "author-email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sources:get",
+      "id": "tickets:reply",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3850,17 +3910,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "sources",
-        "get.js"
+        "tickets",
+        "reply.js"
       ]
     },
-    "sources:list": {
+    "tickets:search": {
       "aliases": [],
-      "args": {},
-      "description": "List sources for an agent",
+      "args": {
+        "query": {
+          "description": "Free-text search terms (matched against ticket messages)",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Search tickets by message content",
       "examples": [
-        "<%= config.bin %> sources list -a agt_123",
-        "<%= config.bin %> sources list -a agt_123 --all --json"
+        "<%= config.bin %> tickets search \"refund not received\" -a agt_123",
+        "<%= config.bin %> tickets search \"refund\" -a agt_123 --limit 10 --json"
       ],
       "flags": {
         "json": {
@@ -3921,43 +3987,16 @@
           "type": "option"
         },
         "limit": {
-          "description": "Maximum items per page",
+          "description": "Number of results (1–50, default 20)",
           "name": "limit",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "cursor": {
-          "description": "Pagination cursor from a previous page",
-          "name": "cursor",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "type": {
-          "description": "Filter by source type",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Filter by source name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sources:list",
+      "id": "tickets:search",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3967,22 +4006,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "sources",
-        "list.js"
+        "tickets",
+        "search.js"
       ]
     },
-    "sources:restore": {
+    "tickets:update": {
       "aliases": [],
       "args": {
-        "sourceId": {
-          "description": "Source ID",
-          "name": "sourceId",
+        "ticketNumber": {
+          "description": "Ticket number",
+          "name": "ticketNumber",
           "required": true
         }
       },
-      "description": "Restore a deleted source",
+      "description": "Update a ticket's status, assignee, and/or team",
       "examples": [
-        "<%= config.bin %> sources restore src_1 -a agt_1"
+        "<%= config.bin %> tickets update 42 --data '{\"statusCategory\":\"closed\"}' -a agt_123"
       ],
       "flags": {
         "json": {
@@ -4041,11 +4080,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON body (@file, @-, or inline). Fields: statusId, statusCategory, assigneeId, assigneeEmail, teamId",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sources:restore",
+      "id": "tickets:update",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -4055,16 +4109,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "sources",
-        "restore.js"
+        "tickets",
+        "update.js"
       ]
     },
-    "sources:summary": {
+    "whatsapp:send-template": {
       "aliases": [],
-      "args": {},
-      "description": "Show aggregated source counts and sizes for an agent",
+      "args": {
+        "template": {
+          "description": "Name of the approved template",
+          "name": "template",
+          "required": true
+        }
+      },
+      "description": "Send an approved WhatsApp template to a phone number from one of the agent’s connected numbers. No user ID is needed — a Chatbase user is resolved or created from the recipient number, and replies flow through the agent’s regular WhatsApp pipeline. Use `whatsapp templates` to see available templates and the variables each expects.",
       "examples": [
-        "<%= config.bin %> sources summary -a agt_123"
+        "<%= config.bin %> whatsapp send-template order_update --to 14155552671 -a agt_123",
+        "<%= config.bin %> whatsapp send-template order_update --to 14155552671 --language en_US --variables '{\"header\":{\"1\":\"#1042\"},\"body\":{\"1\":\"Jane\",\"2\":\"Friday\"}}' -a agt_123"
       ],
       "flags": {
         "json": {
@@ -4123,37 +4184,61 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "to": {
+          "description": "Recipient phone number in international format (digits with country code)",
+          "name": "to",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "from": {
+          "description": "Which connected WhatsApp number to send from — optional when the agent has exactly one",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "language": {
+          "description": "Template language code (e.g. en_US) — optional when the template exists in a single language",
+          "name": "language",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "variables": {
+          "description": "Template variable values as JSON grouped by component (@file, @-, or inline), e.g. '{\"body\":{\"1\":\"Jane\"}}'",
+          "name": "variables",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sources:summary",
+      "id": "whatsapp:send-template",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
+      "summary": "Send an approved WhatsApp template message",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "sources",
-        "summary.js"
+        "whatsapp",
+        "send-template.js"
       ]
     },
-    "sources:update": {
+    "whatsapp:templates": {
       "aliases": [],
-      "args": {
-        "sourceId": {
-          "description": "Source ID",
-          "name": "sourceId",
-          "required": true
-        }
-      },
-      "description": "Update an existing source (text, qna, link, or file)",
+      "args": {},
+      "description": "List the approved WhatsApp templates available to the agent, across all of its connected WhatsApp Business Accounts. A template can only be sent from a number on its own Business Account — pick a sender whose WABA matches the template’s WABA column.",
       "examples": [
-        "<%= config.bin %> sources update src_1 --data '{\"type\":\"text\",\"content\":\"new\"}' -a agt_1",
-        "<%= config.bin %> sources update src_1 --file ./updated.pdf -a agt_1"
+        "<%= config.bin %> whatsapp templates -a agt_123",
+        "<%= config.bin %> whatsapp templates -a agt_123 --json"
       ],
       "flags": {
         "json": {
@@ -4212,53 +4297,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "field": {
-          "char": "f",
-          "description": "Set a body field: -f key=value (repeatable)",
-          "name": "field",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "data": {
-          "description": "JSON body for text/qna/link sources (@file, @-, or inline)",
-          "exclusive": [
-            "file"
-          ],
-          "name": "data",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "file": {
-          "description": "Path to a file to upload as a replacement (mutually exclusive with --data)",
-          "exclusive": [
-            "data",
-            "field"
-          ],
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sources:update",
+      "id": "whatsapp:templates",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
+      "summary": "List approved WhatsApp templates for an agent",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "sources",
-        "update.js"
+        "whatsapp",
+        "templates.js"
       ]
     }
   },
-  "version": "0.2.0"
+  "version": "0.3.0"
 }