chatbase 0.1.0 → 0.1.1

package/oclif.manifest.json

@@ -1652,13 +1652,12 @@
         "set.js"
       ]
     },
-    "conversations:export": {
+    "helpdesk:statuses": {
       "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).",
+      "description": "List ticket statuses for an agent",
       "examples": [
-        "<%= config.bin %> conversations export -a agt_123",
-        "<%= config.bin %> conversations export -a agt_123 --all -o export.json"
+        "<%= config.bin %> helpdesk statuses -a agt_123"
       ],
       "flags": {
         "json": {
@@ -1717,66 +1716,30 @@
           "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": "helpdesk:statuses",
       "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"
+        "helpdesk",
+        "statuses.js"
       ]
     },
-    "conversations:get": {
+    "helpdesk:teams": {
       "aliases": [],
-      "args": {
-        "conversationId": {
-          "description": "Conversation ID (alternative to --conversation)",
-          "name": "conversationId",
-          "required": false
-        }
-      },
-      "description": "Show one conversation",
+      "args": {},
+      "description": "List helpdesk teams 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 teams -a agt_123"
       ],
       "flags": {
         "json": {
@@ -1835,18 +1798,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:teams",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -1856,18 +1812,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "get.js"
+        "helpdesk",
+        "teams.js"
       ]
     },
-    "conversations:list": {
+    "tickets:create": {
       "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": "Create a helpdesk ticket",
       "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 %> 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": {
@@ -1927,29 +1882,41 @@
           "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": true,
+          "type": "option"
+        },
+        "subject": {
+          "description": "Ticket subject",
+          "name": "subject",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "cursor": {
-          "description": "Pagination cursor from a previous page",
-          "name": "cursor",
+        "customer-email": {
+          "description": "Customer email — builds the required customer object (alternative to customer in --data)",
+          "name": "customer-email",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+        "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"
         },
-        "user": {
-          "description": "List conversations for a specific user (uses GET /users/{userId}/conversations)",
-          "name": "user",
+        "data": {
+          "description": "JSON body (@file, @-, or inline). Fields: subject, description, customer, statusId, statusCategory, assigneeId, assigneeEmail, teamId",
+          "name": "data",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1957,27 +1924,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:list",
+      "id": "tickets:create",
       "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"
+        "tickets",
+        "create.js"
       ]
     },
-    "helpdesk:statuses": {
+    "tickets:get": {
       "aliases": [],
-      "args": {},
-      "description": "List ticket statuses for an agent",
+      "args": {
+        "ticketNumber": {
+          "description": "Ticket number",
+          "name": "ticketNumber",
+          "required": true
+        }
+      },
+      "description": "Show one helpdesk ticket",
       "examples": [
-        "<%= config.bin %> helpdesk statuses -a agt_123"
+        "<%= config.bin %> tickets get 42 -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2040,7 +2012,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "helpdesk:statuses",
+      "id": "tickets:get",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2050,16 +2022,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "helpdesk",
-        "statuses.js"
+        "tickets",
+        "get.js"
       ]
     },
-    "helpdesk:teams": {
+    "tickets:list": {
       "aliases": [],
       "args": {},
-      "description": "List helpdesk teams for an agent",
+      "description": "List helpdesk tickets for an agent",
       "examples": [
-        "<%= config.bin %> helpdesk teams -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": {
@@ -2118,11 +2092,102 @@
           "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"
+        },
+        "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": "helpdesk:teams",
+      "id": "tickets:list",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2132,23 +2197,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "helpdesk",
-        "teams.js"
+        "tickets",
+        "list.js"
       ]
     },
-    "messages:feedback": {
+    "tickets:messages": {
       "aliases": [],
       "args": {
-        "messageId": {
-          "description": "Message ID (alternative to --message)",
-          "name": "messageId",
+        "ticketNumber": {
+          "description": "Ticket number (alternative to --ticket)",
+          "name": "ticketNumber",
           "required": false
         }
       },
-      "description": "Set or clear user feedback on an assistant message",
+      "description": "List a ticket's message thread",
       "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 %> tickets messages 42 -a agt_123",
+        "<%= config.bin %> tickets messages 42 -a agt_123 --all --json"
       ],
       "flags": {
         "json": {
@@ -2208,38 +2273,55 @@
           "multiple": false,
           "type": "option"
         },
-        "conversation": {
-          "description": "Conversation ID",
-          "name": "conversation",
-          "required": true,
+        "limit": {
+          "description": "Maximum items per page",
+          "name": "limit",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "description": "Message ID",
-          "name": "message",
+        "cursor": {
+          "description": "Pagination cursor from a previous page",
+          "name": "cursor",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "rating": {
-          "description": "Feedback value (\"clear\" removes existing feedback)",
-          "name": "rating",
-          "required": true,
+        "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": [
-            "positive",
-            "negative",
-            "clear"
+            "asc",
+            "desc"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "messages:feedback",
+      "id": "tickets:messages",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2249,17 +2331,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "messages",
-        "feedback.js"
+        "tickets",
+        "messages.js"
       ]
     },
-    "messages:list": {
+    "tickets:reply": {
       "aliases": [],
-      "args": {},
-      "description": "List messages in a conversation",
+      "args": {
+        "ticketNumber": {
+          "description": "Ticket number (alternative to --ticket)",
+          "name": "ticketNumber",
+          "required": false
+        }
+      },
+      "description": "Post an agent reply to a ticket's message thread",
       "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 %> tickets reply 42 -m \"On it\" --author-email sam@example.com -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2319,30 +2406,32 @@
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "Maximum items per page",
-          "name": "limit",
+        "ticket": {
+          "description": "Ticket number",
+          "name": "ticket",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "cursor": {
-          "description": "Pagination cursor from a previous page",
-          "name": "cursor",
+        "message": {
+          "char": "m",
+          "description": "Reply body as GitHub-flavored Markdown",
+          "name": "message",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+        "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"
         },
-        "conversation": {
-          "description": "Conversation ID",
-          "name": "conversation",
-          "required": true,
+        "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"
@@ -2350,7 +2439,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "messages:list",
+      "id": "tickets:reply",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2360,17 +2449,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "messages",
-        "list.js"
+        "tickets",
+        "reply.js"
       ]
     },
-    "tickets:create": {
+    "tickets:search": {
       "aliases": [],
-      "args": {},
-      "description": "Create a helpdesk ticket",
+      "args": {
+        "query": {
+          "description": "Free-text search terms (matched against ticket messages)",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Search tickets by message content",
       "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 %> tickets search \"refund not received\" -a agt_123",
+        "<%= config.bin %> tickets search \"refund\" -a agt_123 --limit 10 --json"
       ],
       "flags": {
         "json": {
@@ -2430,41 +2525,9 @@
           "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",
+        "limit": {
+          "description": "Number of results (1–50, default 20)",
+          "name": "limit",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2472,7 +2535,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:create",
+      "id": "tickets:search",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2483,10 +2546,10 @@
         "dist",
         "commands",
         "tickets",
-        "create.js"
+        "search.js"
       ]
     },
-    "tickets:get": {
+    "tickets:update": {
       "aliases": [],
       "args": {
         "ticketNumber": {
@@ -2495,9 +2558,9 @@
           "required": true
         }
       },
-      "description": "Show one helpdesk ticket",
+      "description": "Update a ticket's status, assignee, and/or team",
       "examples": [
-        "<%= config.bin %> tickets get 42 -a agt_123"
+        "<%= config.bin %> tickets update 42 --data '{\"statusCategory\":\"closed\"}' -a agt_123"
       ],
       "flags": {
         "json": {
@@ -2556,11 +2619,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": "tickets:get",
+      "id": "tickets:update",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2571,17 +2649,16 @@
         "dist",
         "commands",
         "tickets",
-        "get.js"
+        "update.js"
       ]
     },
-    "tickets:list": {
+    "conversations:export": {
       "aliases": [],
       "args": {},
-      "description": "List helpdesk tickets 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 %> 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 %> conversations export -a agt_123",
+        "<%= config.bin %> conversations export -a agt_123 --all -o export.json"
       ],
       "flags": {
         "json": {
@@ -2641,16 +2718,16 @@
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "Maximum items per page",
-          "name": "limit",
+        "cursor": {
+          "description": "Opaque cursor from a previous response",
+          "name": "cursor",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "cursor": {
-          "description": "Pagination cursor from a previous page",
-          "name": "cursor",
+        "limit": {
+          "description": "Items per page (1-20, default 20)",
+          "name": "limit",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2661,81 +2738,115 @@
           "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",
+        "output": {
+          "char": "o",
+          "description": "Write export JSON to a file instead of stdout",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "created-before": {
-          "description": "Only tickets created before this ISO 8601 date",
-          "name": "created-before",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "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",
+        "conversations",
+        "export.js"
+      ]
+    },
+    "conversations:get": {
+      "aliases": [],
+      "args": {
+        "conversationId": {
+          "description": "Conversation ID (alternative to --conversation)",
+          "name": "conversationId",
+          "required": false
+        }
+      },
+      "description": "Show one conversation",
+      "examples": [
+        "<%= config.bin %> conversations get conv_123 -a agt_123",
+        "<%= config.bin %> conversations get --conversation conv_123 -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"
+        },
+        "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": false,
           "type": "option"
         },
-        "sort-by": {
-          "description": "Sort field",
-          "name": "sort-by",
+        "agent-name": {
+          "description": "Agent display name (looked up to an ID)",
+          "exclusive": [
+            "agent"
+          ],
+          "name": "agent-name",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "createdAt",
-            "updatedAt",
-            "lastMessageAt"
-          ],
           "type": "option"
         },
-        "order": {
-          "description": "Sort direction",
-          "name": "order",
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
           "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": "conversations:get",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -2745,23 +2856,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "list.js"
+        "conversations",
+        "get.js"
       ]
     },
-    "tickets:messages": {
+    "conversations:list": {
       "aliases": [],
-      "args": {
-        "ticketNumber": {
-          "description": "Ticket number (alternative to --ticket)",
-          "name": "ticketNumber",
-          "required": false
-        }
-      },
-      "description": "List a ticket's message thread",
+      "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.",
       "examples": [
-        "<%= config.bin %> tickets messages 42 -a agt_123",
-        "<%= config.bin %> tickets messages 42 -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 --all --json"
       ],
       "flags": {
         "json": {
@@ -2841,60 +2947,157 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "ticket": {
-          "description": "Ticket number",
-          "name": "ticket",
+        "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",
+      "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"
+      ]
+    },
+    "conversations:tool-result": {
+      "aliases": [],
+      "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 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": {
+          "description": "Output raw API JSON",
+          "helpGroup": "OUTPUT",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "types": {
-          "description": "Message types to include (comma-separated): reply, note, event (default: reply,note)",
-          "name": "types",
+        "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": false,
           "type": "option"
         },
-        "order": {
-          "description": "Sort direction",
-          "name": "order",
+        "agent-name": {
+          "description": "Agent display name (looked up to an ID)",
+          "exclusive": [
+            "agent"
+          ],
+          "name": "agent-name",
+          "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,
-          "options": [
-            "asc",
-            "desc"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:messages",
+      "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",
-        "messages.js"
+        "conversations",
+        "tool-result.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": {
@@ -2954,40 +3157,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",
@@ -2997,23 +3198,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": {
@@ -3074,16 +3269,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",
@@ -3093,22 +3309,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "tickets",
-        "search.js"
+        "messages",
+        "list.js"
       ]
     },
-    "tickets:update": {
+    "whatsapp:send-template": {
       "aliases": [],
       "args": {
-        "ticketNumber": {
-          "description": "Ticket number",
-          "name": "ticketNumber",
+        "template": {
+          "description": "Name of the approved template",
+          "name": "template",
           "required": true
         }
       },
-      "description": "Update a ticket's status, assignee, and/or team",
+      "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 %> tickets update 42 --data '{\"statusCategory\":\"closed\"}' -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": {
@@ -3168,17 +3385,31 @@
           "multiple": false,
           "type": "option"
         },
-        "field": {
-          "char": "f",
-          "description": "Set a body field: -f key=value (repeatable)",
-          "name": "field",
+        "to": {
+          "description": "Recipient phone number in international format (digits with country code)",
+          "name": "to",
+          "required": true,
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "data": {
-          "description": "JSON body (@file, @-, or inline). Fields: statusId, statusCategory, assigneeId, assigneeEmail, teamId",
-          "name": "data",
+        "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"
@@ -3186,18 +3417,103 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "tickets:update",
+      "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",
-        "tickets",
-        "update.js"
+        "whatsapp",
+        "send-template.js"
+      ]
+    },
+    "whatsapp:templates": {
+      "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.",
+      "examples": [
+        "<%= config.bin %> whatsapp templates -a agt_123",
+        "<%= config.bin %> whatsapp templates -a agt_123 --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",
+          "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": false,
+          "type": "option"
+        },
+        "agent-name": {
+          "description": "Agent display name (looked up to an ID)",
+          "exclusive": [
+            "agent"
+          ],
+          "name": "agent-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "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",
+        "whatsapp",
+        "templates.js"
       ]
     },
     "sources:create": {
@@ -3944,5 +4260,5 @@
       ]
     }
   },
-  "version": "0.1.0"
+  "version": "0.1.1"
 }