chatbase 0.1.1 → 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,30 +1720,105 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "cursor": {
+          "description": "Opaque cursor from a previous response",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Items per page (1-20, default 20)",
+          "name": "limit",
+          "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",
+          "name": "output",
+          "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"
+        },
+        "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"
+          ],
+          "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "helpdesk:statuses",
+      "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",
-        "statuses.js"
+        "conversations",
+        "export.js"
       ]
     },
-    "helpdesk:teams": {
+    "conversations:get": {
       "aliases": [],
-      "args": {},
-      "description": "List helpdesk teams for an agent",
+      "args": {
+        "conversationId": {
+          "description": "Conversation ID (alternative to --conversation)",
+          "name": "conversationId",
+          "required": false
+        }
+      },
+      "description": "Show one conversation",
       "examples": [
-        "<%= config.bin %> helpdesk teams -a agt_123"
+        "<%= config.bin %> conversations get conv_123 -a agt_123",
+        "<%= config.bin %> conversations get --conversation conv_123 -a agt_123"
       ],
       "flags": {
         "json": {
@@ -1798,11 +1877,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "helpdesk:teams",
+      "id": "conversations:get",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -1812,17 +1898,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "helpdesk",
-        "teams.js"
+        "conversations",
+        "get.js"
       ]
     },
-    "tickets:create": {
+    "conversations:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a helpdesk ticket",
+      "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 %> 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 %> 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": {
@@ -1882,41 +1970,43 @@
           "multiple": false,
           "type": "option"
         },
-        "field": {
-          "char": "f",
-          "description": "Set a body field: -f key=value (repeatable)",
-          "name": "field",
+        "limit": {
+          "description": "Maximum items per page",
+          "name": "limit",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "subject": {
-          "description": "Ticket subject",
-          "name": "subject",
+        "cursor": {
+          "description": "Pagination cursor from a previous page",
+          "name": "cursor",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "customer-email": {
-          "description": "Customer email — builds the required customer object (alternative to customer in --data)",
-          "name": "customer-email",
+        "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"
         },
-        "customer-name": {
-          "dependsOn": [
-            "customer-email"
-          ],
-          "description": "Customer display name, used only when the email creates a new customer record",
-          "name": "customer-name",
+        "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"
         },
-        "data": {
-          "description": "JSON body (@file, @-, or inline). Fields: subject, description, customer, statusId, statusCategory, assigneeId, assigneeEmail, teamId",
-          "name": "data",
+        "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"
@@ -1924,32 +2014,35 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:create",
+      "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",
-        "tickets",
-        "create.js"
+        "conversations",
+        "list.js"
       ]
     },
-    "tickets:get": {
+    "conversations:tool-result": {
       "aliases": [],
       "args": {
-        "ticketNumber": {
-          "description": "Ticket number",
-          "name": "ticketNumber",
-          "required": true
+        "conversationId": {
+          "description": "Conversation ID (alternative to --conversation)",
+          "name": "conversationId",
+          "required": false
         }
       },
-      "description": "Show one helpdesk ticket",
+      "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 %> tickets get 42 -a agt_123"
+        "<%= 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": {
@@ -2008,32 +2101,53 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
+          "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,
+          "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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:get",
+      "id": "conversations:tool-result",
       "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",
-        "tickets",
-        "get.js"
+        "conversations",
+        "tool-result.js"
       ]
     },
-    "tickets:list": {
+    "helpdesk:statuses": {
       "aliases": [],
       "args": {},
-      "description": "List helpdesk tickets for an agent",
+      "description": "List ticket statuses 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 %> helpdesk statuses -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2092,148 +2206,50 @@
           "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"
         },
-        "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"
+        "plain": {
+          "description": "Tab-separated output for scripts",
+          "helpGroup": "OUTPUT",
+          "name": "plain",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "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"
-        },
-        "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",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "createdAt",
-            "updatedAt",
-            "lastMessageAt"
-          ],
-          "type": "option"
-        },
-        "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": "tickets:list",
-      "pluginAlias": "chatbase",
-      "pluginName": "chatbase",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "tickets",
-        "list.js"
-      ]
-    },
-    "tickets:messages": {
-      "aliases": [],
-      "args": {
-        "ticketNumber": {
-          "description": "Ticket number (alternative to --ticket)",
-          "name": "ticketNumber",
-          "required": false
-        }
-      },
-      "description": "List a ticket's message thread",
-      "examples": [
-        "<%= config.bin %> tickets messages 42 -a agt_123",
-        "<%= config.bin %> tickets messages 42 -a agt_123 --all --json"
-      ],
-      "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"
-        },
-        "quiet": {
-          "char": "q",
-          "description": "Suppress non-essential output",
-          "name": "quiet",
+        "quiet": {
+          "char": "q",
+          "description": "Suppress non-essential output",
+          "name": "quiet",
           "allowNo": false,
           "type": "boolean"
         },
@@ -2272,56 +2288,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": "helpdesk:teams",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2331,22 +2302,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "messages.js"
+        "helpdesk",
+        "teams.js"
       ]
     },
-    "tickets:reply": {
+    "messages:feedback": {
       "aliases": [],
       "args": {
-        "ticketNumber": {
-          "description": "Ticket number (alternative to --ticket)",
-          "name": "ticketNumber",
+        "messageId": {
+          "description": "Message ID (alternative to --message)",
+          "name": "messageId",
           "required": false
         }
       },
-      "description": "Post an agent reply to a ticket's message thread",
+      "description": "Set or clear user feedback on an assistant message",
       "examples": [
-        "<%= config.bin %> tickets reply 42 -m \"On it\" --author-email sam@example.com -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": {
@@ -2406,40 +2378,38 @@
           "multiple": false,
           "type": "option"
         },
-        "ticket": {
-          "description": "Ticket number",
-          "name": "ticket",
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "message": {
-          "char": "m",
-          "description": "Reply body as GitHub-flavored Markdown",
+          "description": "Message ID",
           "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",
+        "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": "tickets:reply",
+      "id": "messages:feedback",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2449,23 +2419,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "reply.js"
+        "messages",
+        "feedback.js"
       ]
     },
-    "tickets:search": {
+    "messages:list": {
       "aliases": [],
-      "args": {
-        "query": {
-          "description": "Free-text search terms (matched against ticket messages)",
-          "name": "query",
-          "required": true
-        }
-      },
-      "description": "Search tickets by message content",
+      "args": {},
+      "description": "List messages in a conversation",
       "examples": [
-        "<%= config.bin %> tickets search \"refund not received\" -a agt_123",
-        "<%= config.bin %> tickets search \"refund\" -a agt_123 --limit 10 --json"
+        "<%= config.bin %> messages list --conversation conv_123 -a agt_123",
+        "<%= config.bin %> messages list --conversation conv_123 -a agt_123 --all --json"
       ],
       "flags": {
         "json": {
@@ -2526,16 +2490,37 @@
           "type": "option"
         },
         "limit": {
-          "description": "Number of results (1–50, default 20)",
+          "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"
+        },
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:search",
+      "id": "messages:list",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2545,22 +2530,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "search.js"
+        "messages",
+        "list.js"
       ]
     },
-    "tickets:update": {
+    "sources: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 source: text/qna/link (JSON) or a file upload",
       "examples": [
-        "<%= config.bin %> tickets update 42 --data '{\"statusCategory\":\"closed\"}' -a agt_123"
+        "<%= 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": {
@@ -2628,8 +2610,70 @@
           "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). Fields: statusId, statusCategory, assigneeId, assigneeEmail, teamId",
+          "description": "JSON body (@file, @-, or inline); per-type flags override matching keys",
           "name": "data",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -2638,7 +2682,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:update",
+      "id": "sources:create",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2648,17 +2692,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "update.js"
+        "sources",
+        "create.js"
       ]
     },
-    "conversations:export": {
+    "sources:delete": {
       "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": {
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
+        }
+      },
+      "description": "Delete a source (restorable via restore command)",
       "examples": [
-        "<%= config.bin %> conversations export -a agt_123",
-        "<%= config.bin %> conversations export -a agt_123 --all -o export.json"
+        "<%= config.bin %> sources delete src_1 -a agt_1"
       ],
       "flags": {
         "json": {
@@ -2717,66 +2766,36 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "cursor": {
-          "description": "Opaque cursor from a previous response",
-          "name": "cursor",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "limit": {
-          "description": "Items per page (1-20, default 20)",
-          "name": "limit",
-          "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",
-          "name": "output",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:export",
+      "id": "sources:delete",
       "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",
-        "conversations",
-        "export.js"
+        "sources",
+        "delete.js"
       ]
     },
-    "conversations:get": {
+    "sources:get": {
       "aliases": [],
       "args": {
-        "conversationId": {
-          "description": "Conversation ID (alternative to --conversation)",
-          "name": "conversationId",
-          "required": false
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
         }
       },
-      "description": "Show one conversation",
+      "description": "Show one source",
       "examples": [
-        "<%= config.bin %> conversations get conv_123 -a agt_123",
-        "<%= config.bin %> conversations get --conversation conv_123 -a agt_123"
+        "<%= config.bin %> sources get src_123 -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2835,18 +2854,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": "sources:get",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2856,18 +2868,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
+        "sources",
         "get.js"
       ]
     },
-    "conversations:list": {
+    "sources:list": {
       "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 sources 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 %> sources list -a agt_123",
+        "<%= config.bin %> sources list -a agt_123 --all --json"
       ],
       "flags": {
         "json": {
@@ -2947,9 +2958,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "user": {
-          "description": "List conversations for a specific user (uses GET /users/{userId}/conversations)",
-          "name": "user",
+        "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"
@@ -2957,35 +2975,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:list",
+      "id": "sources:list",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
       "strict": true,
-      "summary": "List an agent’s API-created conversations",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
+        "sources",
         "list.js"
       ]
     },
-    "conversations:tool-result": {
+    "sources:restore": {
       "aliases": [],
       "args": {
-        "conversationId": {
-          "description": "Conversation ID (alternative to --conversation)",
-          "name": "conversationId",
-          "required": false
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
         }
       },
-      "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": "Restore a deleted source",
       "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 %> sources restore src_1 -a agt_1"
       ],
       "flags": {
         "json": {
@@ -3044,60 +3059,30 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "conversation": {
-          "description": "Conversation ID",
-          "name": "conversation",
-          "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,
-          "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",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:tool-result",
+      "id": "sources:restore",
       "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"
+        "sources",
+        "restore.js"
       ]
     },
-    "messages:feedback": {
+    "sources:summary": {
       "aliases": [],
-      "args": {
-        "messageId": {
-          "description": "Message ID (alternative to --message)",
-          "name": "messageId",
-          "required": false
-        }
-      },
-      "description": "Set or clear user feedback on an assistant message",
+      "args": {},
+      "description": "Show aggregated source counts and sizes for an agent",
       "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 %> sources summary -a agt_123"
       ],
       "flags": {
         "json": {
@@ -3156,39 +3141,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "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": "sources:summary",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3198,17 +3155,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "messages",
-        "feedback.js"
+        "sources",
+        "summary.js"
       ]
     },
-    "messages:list": {
+    "sources:update": {
       "aliases": [],
-      "args": {},
-      "description": "List messages in a conversation",
+      "args": {
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
+        }
+      },
+      "description": "Update an existing source (text, qna, link, or file)",
       "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 %> 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": {
@@ -3268,30 +3231,31 @@
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "Maximum items per page",
-          "name": "limit",
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
-        "cursor": {
-          "description": "Pagination cursor from a previous page",
-          "name": "cursor",
+        "data": {
+          "description": "JSON body for text/qna/link sources (@file, @-, or inline)",
+          "exclusive": [
+            "file"
+          ],
+          "name": "data",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "conversation": {
-          "description": "Conversation ID",
-          "name": "conversation",
-          "required": true,
+        "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"
@@ -3299,7 +3263,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "messages:list",
+      "id": "sources:update",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -3308,24 +3272,18 @@
       "isESM": true,
       "relativePath": [
         "dist",
-        "commands",
-        "messages",
-        "list.js"
-      ]
-    },
-    "whatsapp:send-template": {
-      "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.",
+        "commands",
+        "sources",
+        "update.js"
+      ]
+    },
+    "tickets:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a helpdesk ticket",
       "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 %> 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": {
@@ -3385,31 +3343,41 @@
           "multiple": false,
           "type": "option"
         },
-        "to": {
-          "description": "Recipient phone number in international format (digits with country code)",
-          "name": "to",
-          "required": true,
+        "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"
         },
-        "from": {
-          "description": "Which connected WhatsApp number to send from — optional when the agent has exactly one",
-          "name": "from",
+        "customer-email": {
+          "description": "Customer email — builds the required customer object (alternative to customer in --data)",
+          "name": "customer-email",
           "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",
+        "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"
         },
-        "variables": {
-          "description": "Template variable values as JSON grouped by component (@file, @-, or inline), e.g. '{\"body\":{\"1\":\"Jane\"}}'",
-          "name": "variables",
+        "data": {
+          "description": "JSON body (@file, @-, or inline). Fields: subject, description, customer, statusId, statusCategory, assigneeId, assigneeEmail, teamId",
+          "name": "data",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3417,28 +3385,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "whatsapp:send-template",
+      "id": "tickets:create",
       "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"
+        "tickets",
+        "create.js"
       ]
     },
-    "whatsapp:templates": {
+    "tickets:get": {
       "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.",
+      "args": {
+        "ticketNumber": {
+          "description": "Ticket number",
+          "name": "ticketNumber",
+          "required": true
+        }
+      },
+      "description": "Show one helpdesk ticket",
       "examples": [
-        "<%= config.bin %> whatsapp templates -a agt_123",
-        "<%= config.bin %> whatsapp templates -a agt_123 --json"
+        "<%= config.bin %> tickets get 42 -a agt_123"
       ],
       "flags": {
         "json": {
@@ -3501,30 +3473,28 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "whatsapp:templates",
+      "id": "tickets:get",
       "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"
+        "tickets",
+        "get.js"
       ]
     },
-    "sources:create": {
+    "tickets:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a source: text/qna/link (JSON) or a file upload",
+      "description": "List helpdesk tickets for an agent",
       "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 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": {
@@ -3584,87 +3554,101 @@
           "multiple": false,
           "type": "option"
         },
-        "field": {
-          "char": "f",
-          "description": "Set a body field: -f key=value (repeatable)",
-          "name": "field",
+        "limit": {
+          "description": "Maximum items per page",
+          "name": "limit",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "type": {
-          "description": "JSON source type (mutually exclusive with --file)",
-          "exclusive": [
-            "file"
-          ],
-          "name": "type",
+        "cursor": {
+          "description": "Pagination cursor from a previous page",
+          "name": "cursor",
           "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",
+        "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"
         },
-        "name": {
-          "description": "Source name (--type text/qna, or a file upload)",
-          "name": "name",
+        "channel": {
+          "description": "Filter by channel (comma-separated, e.g. email,api)",
+          "name": "channel",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "content": {
-          "description": "Text content for --type text (@file, @-, or inline)",
-          "name": "content",
+        "assignee-id": {
+          "description": "Filter by assignee UUID, or \"none\" for unassigned",
+          "name": "assignee-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "url": {
-          "description": "URL for --type link",
-          "name": "url",
+        "team-id": {
+          "description": "Filter by team UUID, or \"none\" for no team",
+          "name": "team-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "link-type": {
-          "description": "Link crawl mode for --type link",
-          "name": "link-type",
+        "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.1.1"
+  "version": "0.3.0"
 }