chatbase 0.1.0 → 0.2.0

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,31 +1716,85 @@
           "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"
         },
-        "cursor": {
-          "description": "Opaque cursor from a previous response",
-          "name": "cursor",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "plain": {
+          "description": "Tab-separated output for scripts",
+          "helpGroup": "OUTPUT",
+          "name": "plain",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "limit": {
-          "description": "Items per page (1-20, default 20)",
-          "name": "limit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "quiet": {
+          "char": "q",
+          "description": "Suppress non-essential output",
+          "name": "quiet",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
+        "verbose": {
+          "description": "Verbose diagnostics",
+          "name": "verbose",
           "allowNo": false,
           "type": "boolean"
         },
-        "output": {
-          "char": "o",
-          "description": "Write export JSON to a file instead of stdout",
-          "name": "output",
+        "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"
@@ -1749,34 +1802,33 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:export",
+      "id": "helpdesk:teams",
       "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",
+        "teams.js"
       ]
     },
-    "conversations:get": {
+    "messages:feedback": {
       "aliases": [],
       "args": {
-        "conversationId": {
-          "description": "Conversation ID (alternative to --conversation)",
-          "name": "conversationId",
+        "messageId": {
+          "description": "Message ID (alternative to --message)",
+          "name": "messageId",
           "required": false
         }
       },
-      "description": "Show one conversation",
+      "description": "Set or clear user feedback on an assistant message",
       "examples": [
-        "<%= config.bin %> conversations get conv_123 -a agt_123",
-        "<%= config.bin %> conversations get --conversation conv_123 -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": {
@@ -1839,14 +1891,35 @@
         "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": "conversations:get",
+      "id": "messages:feedback",
       "pluginAlias": "chatbase",
       "pluginName": "chatbase",
       "pluginType": "core",
@@ -1856,18 +1929,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "get.js"
+        "messages",
+        "feedback.js"
       ]
     },
-    "conversations:list": {
+    "messages: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 messages in a conversation",
       "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 %> messages list --conversation conv_123 -a agt_123",
+        "<%= config.bin %> messages list --conversation conv_123 -a agt_123 --all --json"
       ],
       "flags": {
         "json": {
@@ -1947,9 +2019,10 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "user": {
-          "description": "List conversations for a specific user (uses GET /users/{userId}/conversations)",
-          "name": "user",
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1957,27 +2030,27 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:list",
+      "id": "messages: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",
+        "messages",
         "list.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"
       ],
       "flags": {
         "json": {
@@ -2036,30 +2109,157 @@
           "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": "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": {
+        "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"
+        },
+        "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "conversations:get",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "conversations",
+        "get.js"
+      ]
+    },
+    "conversations:list": {
       "aliases": [],
       "args": {},
-      "description": "List helpdesk teams for an agent",
+      "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 %> helpdesk teams -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 --all --json"
       ],
       "flags": {
         "json": {
@@ -2118,37 +2318,66 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "limit": {
+          "description": "Maximum items per page",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cursor": {
+          "description": "Pagination cursor from a previous page",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "all": {
+          "description": "Fetch every page",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "user": {
+          "description": "List conversations for a specific user (uses GET /users/{userId}/conversations)",
+          "name": "user",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "helpdesk:teams",
+      "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",
-        "helpdesk",
-        "teams.js"
+        "conversations",
+        "list.js"
       ]
     },
-    "messages:feedback": {
+    "conversations:tool-result": {
       "aliases": [],
       "args": {
-        "messageId": {
-          "description": "Message ID (alternative to --message)",
-          "name": "messageId",
+        "conversationId": {
+          "description": "Conversation ID (alternative to --conversation)",
+          "name": "conversationId",
           "required": false
         }
       },
-      "description": "Set or clear user feedback on an assistant message",
+      "description": "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 %> messages feedback msg_1 --conversation conv_123 --rating positive -a agt_123",
-        "<%= config.bin %> messages feedback --conversation conv_123 --message msg_1 --rating clear -a agt_123"
+        "<%= config.bin %> conversations 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": {
@@ -2211,55 +2440,56 @@
         "conversation": {
           "description": "Conversation ID",
           "name": "conversation",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "message": {
-          "description": "Message ID",
-          "name": "message",
+        "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"
         },
-        "rating": {
-          "description": "Feedback value (\"clear\" removes existing feedback)",
-          "name": "rating",
-          "required": true,
+        "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": [
-            "positive",
-            "negative",
-            "clear"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "messages:feedback",
+      "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",
-        "messages",
-        "feedback.js"
+        "conversations",
+        "tool-result.js"
       ]
     },
-    "messages:list": {
+    "whatsapp:send-template": {
       "aliases": [],
-      "args": {},
-      "description": "List messages in a conversation",
+      "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 %> messages list --conversation conv_123 -a agt_123",
-        "<%= config.bin %> messages list --conversation conv_123 -a agt_123 --all --json"
+        "<%= 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": {
@@ -2319,30 +2549,115 @@
           "multiple": false,
           "type": "option"
         },
-        "limit": {
-          "description": "Maximum items per page",
-          "name": "limit",
+        "to": {
+          "description": "Recipient phone number in international format (digits with country code)",
+          "name": "to",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "cursor": {
-          "description": "Pagination cursor from a previous page",
-          "name": "cursor",
+        "from": {
+          "description": "Which connected WhatsApp number to send from — optional when the agent has exactly one",
+          "name": "from",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Fetch every page",
-          "name": "all",
+        "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": "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",
+        "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"
         },
-        "conversation": {
-          "description": "Conversation ID",
-          "name": "conversation",
-          "required": true,
+        "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"
@@ -2350,18 +2665,19 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "messages:list",
+      "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",
-        "messages",
-        "list.js"
+        "whatsapp",
+        "templates.js"
       ]
     },
     "tickets:create": {
@@ -3944,5 +4260,5 @@
       ]
     }
   },
-  "version": "0.1.0"
+  "version": "0.2.0"
 }