chatbase 0.0.1 → 0.1.0

package/oclif.manifest.json

@@ -0,0 +1,3948 @@
+{
+  "commands": {
+    "api": {
+      "aliases": [],
+      "args": {
+        "method": {
+          "description": "HTTP method",
+          "name": "method",
+          "options": [
+            "GET",
+            "POST",
+            "PUT",
+            "PATCH",
+            "DELETE"
+          ],
+          "required": true
+        },
+        "path": {
+          "description": "API path relative to /api/v2, e.g. /agents",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Call the Chatbase API directly — an escape hatch for endpoints without a dedicated command",
+      "examples": [
+        "<%= config.bin %> api GET /agents",
+        "<%= config.bin %> api GET /agents --field limit=5",
+        "<%= config.bin %> api POST /agents --body '{\"name\":\"Support Bot\"}'",
+        "<%= config.bin %> api PATCH /agents/agt_123 --body @patch.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"
+        },
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "query": {
+          "description": "Query param k=v (repeatable)",
+          "name": "query",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "body": {
+          "description": "JSON request body (@file, @-, or inline JSON)",
+          "name": "body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "api",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "api.js"
+      ]
+    },
+    "health": {
+      "aliases": [],
+      "args": {},
+      "description": "Check that the Chatbase API is reachable",
+      "examples": [
+        "<%= config.bin %> health",
+        "<%= config.bin %> health --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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "health",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "health.js"
+      ]
+    },
+    "agents:auto-retrain": {
+      "aliases": [],
+      "args": {
+        "agentId": {
+          "description": "Agent ID",
+          "name": "agentId",
+          "required": false
+        }
+      },
+      "description": "Enable or disable automatic retraining for an agent",
+      "examples": [
+        "<%= config.bin %> agents auto-retrain agt_123 --enabled",
+        "<%= config.bin %> agents auto-retrain --enabled"
+      ],
+      "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"
+        },
+        "enabled": {
+          "description": "Enable automatic retraining",
+          "name": "enabled",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disabled": {
+          "description": "Disable automatic retraining",
+          "name": "disabled",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agents:auto-retrain",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "auto-retrain.js"
+      ]
+    },
+    "agents:clone": {
+      "aliases": [],
+      "args": {
+        "agentId": {
+          "description": "Agent ID to clone",
+          "name": "agentId",
+          "required": true
+        }
+      },
+      "description": "Clone an agent, including all its sources (excluding Notion)",
+      "examples": [
+        "<%= config.bin %> agents clone 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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agents:clone",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "clone.js"
+      ]
+    },
+    "agents:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a new agent",
+      "examples": [
+        "<%= config.bin %> agents create --name \"Support Bot\" --instructions \"Be helpful\"",
+        "<%= config.bin %> agents create --data @agent.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"
+        },
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "name": {
+          "description": "Agent name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "instructions": {
+          "description": "System instructions",
+          "name": "instructions",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "description": "Model ID",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON body (@file, @-, or inline). Fields: name, instructions, model, visibility, temp",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agents:create",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "create.js"
+      ]
+    },
+    "agents:delete": {
+      "aliases": [],
+      "args": {
+        "agentId": {
+          "description": "Agent ID",
+          "name": "agentId",
+          "required": true
+        }
+      },
+      "description": "Permanently delete an agent (cannot be undone)",
+      "examples": [
+        "<%= config.bin %> agents delete agt_123 --confirm 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"
+        },
+        "confirm": {
+          "description": "Confirm by repeating the agent ID (required in scripts and CI)",
+          "name": "confirm",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agents:delete",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "delete.js"
+      ]
+    },
+    "agents:get": {
+      "aliases": [],
+      "args": {
+        "agentId": {
+          "description": "Agent ID",
+          "name": "agentId",
+          "required": false
+        }
+      },
+      "description": "Show one agent",
+      "examples": [
+        "<%= config.bin %> agents get agt_123",
+        "<%= config.bin %> agents get"
+      ],
+      "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": "agents:get",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "get.js"
+      ]
+    },
+    "agents:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all agents in the workspace",
+      "examples": [
+        "<%= config.bin %> agents list",
+        "<%= config.bin %> agents list --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"
+        },
+        "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agents:list",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "list.js"
+      ]
+    },
+    "agents:styles": {
+      "aliases": [],
+      "args": {
+        "agentId": {
+          "description": "Agent ID",
+          "name": "agentId",
+          "required": false
+        }
+      },
+      "description": "Update visual styles for an agent",
+      "examples": [
+        "<%= config.bin %> agents styles agt_123 --data '{\"chat\":{\"theme\":\"dark\"}}'",
+        "<%= config.bin %> agents styles --data @styles.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"
+        },
+        "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). See API docs for style properties",
+          "name": "data",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agents:styles",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "styles.js"
+      ]
+    },
+    "agents:train": {
+      "aliases": [],
+      "args": {
+        "agentId": {
+          "description": "Agent ID to train (defaults to the configured agent, like other commands)",
+          "name": "agentId",
+          "required": false
+        }
+      },
+      "description": "Queue a training job for an agent",
+      "examples": [
+        "<%= config.bin %> agents train agt_123",
+        "<%= config.bin %> agents train"
+      ],
+      "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": "agents:train",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "train.js"
+      ]
+    },
+    "agents:update": {
+      "aliases": [],
+      "args": {
+        "agentId": {
+          "description": "Agent ID",
+          "name": "agentId",
+          "required": false
+        }
+      },
+      "description": "Update an existing agent",
+      "examples": [
+        "<%= config.bin %> agents update agt_123 --name \"New Name\"",
+        "<%= config.bin %> agents update --name \"New Name\"",
+        "<%= config.bin %> agents update agt_123 --data @agent.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"
+        },
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "name": {
+          "description": "Agent name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "instructions": {
+          "description": "System instructions",
+          "name": "instructions",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "description": "Model ID",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON body (@file, @-, or inline). Fields: name, instructions, model, visibility, temp",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agents:update",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agents",
+        "update.js"
+      ]
+    },
+    "auth:login": {
+      "aliases": [],
+      "args": {},
+      "description": "Authenticate with Chatbase — paste an API key or log in via browser",
+      "examples": [
+        "<%= config.bin %> auth login",
+        "<%= config.bin %> auth login --browser",
+        "cat key.txt | <%= config.bin %> auth login --with-token"
+      ],
+      "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"
+        },
+        "with-token": {
+          "description": "Read the API key from stdin",
+          "name": "with-token",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "browser": {
+          "description": "Log in via browser — approve a code at chatbase.co/activate",
+          "name": "browser",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:login",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "login.js"
+      ]
+    },
+    "auth:logout": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove the stored API key (revokes CLI-paired keys server-side)",
+      "examples": [
+        "<%= config.bin %> auth logout"
+      ],
+      "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:logout",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "logout.js"
+      ]
+    },
+    "auth:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the active credential and where it comes from",
+      "examples": [
+        "<%= config.bin %> auth status"
+      ],
+      "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "auth:status",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "auth",
+        "status.js"
+      ]
+    },
+    "chat": {
+      "aliases": [],
+      "args": {},
+      "description": "Send a message to an agent and print its response",
+      "examples": [
+        "<%= config.bin %> chat -a agt_123 -m \"How do I reset my password?\"",
+        "echo \"summarize our refund policy\" | <%= config.bin %> chat -a agt_123",
+        "<%= config.bin %> chat -a agt_123 -m \"and then?\" --conversation conv_123",
+        "<%= config.bin %> chat -a agt_123 -m \"hi\" --no-stream",
+        "<%= config.bin %> chat -a agt_123 -m \"hi\" --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"
+        },
+        "message": {
+          "char": "m",
+          "description": "Message to send (else read from piped stdin, else an interactive REPL)",
+          "name": "message",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "conversation": {
+          "description": "Continue an existing conversation",
+          "name": "conversation",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "resume": {
+          "dependsOn": [
+            "conversation"
+          ],
+          "description": "Replay the last few messages when continuing a conversation",
+          "name": "resume",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-stream": {
+          "description": "Wait for the complete response instead of streaming tokens",
+          "name": "no-stream",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "chat",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "chat",
+        "index.js"
+      ]
+    },
+    "chat:retry": {
+      "aliases": [],
+      "args": {},
+      "description": "Retry generating an assistant response (discards that message and everything after it in the conversation)",
+      "examples": [
+        "<%= config.bin %> chat retry --conversation c_123 -a agt_123 --message-id msg_456",
+        "<%= config.bin %> chat retry --conversation c_123 -a agt_123 --message-id msg_456 --no-stream"
+      ],
+      "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": "The conversation ID to retry in",
+          "name": "conversation",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "message-id": {
+          "description": "The message ID to retry from",
+          "name": "message-id",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-stream": {
+          "description": "Wait for the complete response instead of streaming tokens",
+          "name": "no-stream",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "chat:retry",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "chat",
+        "retry.js"
+      ]
+    },
+    "config:get": {
+      "aliases": [],
+      "args": {
+        "key": {
+          "description": "agent | timeout",
+          "name": "key",
+          "required": true
+        }
+      },
+      "description": "Print a resolved CLI configuration value and where it comes from",
+      "examples": [
+        "<%= config.bin %> config get agent",
+        "<%= config.bin %> config get timeout"
+      ],
+      "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config:get",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "get.js"
+      ]
+    },
+    "config:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List every resolved CLI configuration value and its source",
+      "examples": [
+        "<%= config.bin %> config list"
+      ],
+      "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config:list",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "list.js"
+      ]
+    },
+    "config:set": {
+      "aliases": [],
+      "args": {
+        "key": {
+          "description": "agent | timeout",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "New value (omit for agent to pick interactively)",
+          "name": "value",
+          "required": false
+        }
+      },
+      "description": "Set a CLI configuration value",
+      "examples": [
+        "<%= config.bin %> config set agent agt_123",
+        "<%= config.bin %> config set agent",
+        "<%= config.bin %> config set timeout 60000"
+      ],
+      "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config:set",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config",
+        "set.js"
+      ]
+    },
+    "conversations:export": {
+      "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).",
+      "examples": [
+        "<%= config.bin %> conversations export -a agt_123",
+        "<%= config.bin %> conversations export -a agt_123 --all -o export.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"
+        },
+        "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",
+      "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"
+        },
+        "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 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 %> 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": {
+          "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"
+        },
+        "limit": {
+          "description": "Maximum items per page",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cursor": {
+          "description": "Pagination cursor from a previous page",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "all": {
+          "description": "Fetch every page",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "user": {
+          "description": "List conversations for a specific user (uses GET /users/{userId}/conversations)",
+          "name": "user",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "conversations:list",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "List an agent’s API-created conversations",
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "conversations",
+        "list.js"
+      ]
+    },
+    "helpdesk:statuses": {
+      "aliases": [],
+      "args": {},
+      "description": "List ticket statuses for an agent",
+      "examples": [
+        "<%= config.bin %> helpdesk statuses -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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "helpdesk:statuses",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "helpdesk",
+        "statuses.js"
+      ]
+    },
+    "helpdesk:teams": {
+      "aliases": [],
+      "args": {},
+      "description": "List helpdesk teams for an agent",
+      "examples": [
+        "<%= config.bin %> helpdesk teams -a agt_123"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output raw API JSON",
+          "helpGroup": "OUTPUT",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "plain": {
+          "description": "Tab-separated output for scripts",
+          "helpGroup": "OUTPUT",
+          "name": "plain",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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": "helpdesk:teams",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "helpdesk",
+        "teams.js"
+      ]
+    },
+    "messages:feedback": {
+      "aliases": [],
+      "args": {
+        "messageId": {
+          "description": "Message ID (alternative to --message)",
+          "name": "messageId",
+          "required": false
+        }
+      },
+      "description": "Set or clear user feedback on an assistant message",
+      "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"
+      ],
+      "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",
+          "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",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "messages",
+        "feedback.js"
+      ]
+    },
+    "messages:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List messages in a conversation",
+      "examples": [
+        "<%= config.bin %> messages list --conversation conv_123 -a agt_123",
+        "<%= config.bin %> messages list --conversation conv_123 -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",
+          "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"
+        },
+        "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"
+        },
+        "conversation": {
+          "description": "Conversation ID",
+          "name": "conversation",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "messages:list",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "messages",
+        "list.js"
+      ]
+    },
+    "tickets:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a helpdesk ticket",
+      "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"
+      ],
+      "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"
+        },
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "subject": {
+          "description": "Ticket subject",
+          "name": "subject",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "customer-email": {
+          "description": "Customer email — builds the required customer object (alternative to customer in --data)",
+          "name": "customer-email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "customer-name": {
+          "dependsOn": [
+            "customer-email"
+          ],
+          "description": "Customer display name, used only when the email creates a new customer record",
+          "name": "customer-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON body (@file, @-, or inline). Fields: subject, description, customer, statusId, statusCategory, assigneeId, assigneeEmail, teamId",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tickets:create",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tickets",
+        "create.js"
+      ]
+    },
+    "tickets:get": {
+      "aliases": [],
+      "args": {
+        "ticketNumber": {
+          "description": "Ticket number",
+          "name": "ticketNumber",
+          "required": true
+        }
+      },
+      "description": "Show one helpdesk ticket",
+      "examples": [
+        "<%= config.bin %> tickets get 42 -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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tickets:get",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tickets",
+        "get.js"
+      ]
+    },
+    "tickets:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List helpdesk tickets for an agent",
+      "examples": [
+        "<%= config.bin %> tickets list -a agt_123",
+        "<%= config.bin %> tickets list -a agt_123 --status new,on_you",
+        "<%= config.bin %> tickets list -a agt_123 --all --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Output raw API JSON",
+          "helpGroup": "OUTPUT",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "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"
+        },
+        "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": "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",
+          "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"
+        },
+        "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",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tickets",
+        "messages.js"
+      ]
+    },
+    "tickets:reply": {
+      "aliases": [],
+      "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 %> tickets reply 42 -m \"On it\" --author-email sam@example.com -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"
+        },
+        "ticket": {
+          "description": "Ticket number",
+          "name": "ticket",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "message": {
+          "char": "m",
+          "description": "Reply body as GitHub-flavored Markdown",
+          "name": "message",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "author-id": {
+          "description": "Platform user id of the team member the reply is attributed to (exactly one of --author-id/--author-email)",
+          "name": "author-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "author-email": {
+          "description": "Email of the team member the reply is attributed to (exactly one of --author-id/--author-email)",
+          "name": "author-email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tickets:reply",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tickets",
+        "reply.js"
+      ]
+    },
+    "tickets:search": {
+      "aliases": [],
+      "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 search \"refund not received\" -a agt_123",
+        "<%= config.bin %> tickets search \"refund\" -a agt_123 --limit 10 --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"
+        },
+        "limit": {
+          "description": "Number of results (1–50, default 20)",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "tickets:search",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tickets",
+        "search.js"
+      ]
+    },
+    "tickets:update": {
+      "aliases": [],
+      "args": {
+        "ticketNumber": {
+          "description": "Ticket number",
+          "name": "ticketNumber",
+          "required": true
+        }
+      },
+      "description": "Update a ticket's status, assignee, and/or team",
+      "examples": [
+        "<%= config.bin %> tickets update 42 --data '{\"statusCategory\":\"closed\"}' -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"
+        },
+        "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:update",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "tickets",
+        "update.js"
+      ]
+    },
+    "sources:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create a source: text/qna/link (JSON) or a file upload",
+      "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"
+      ],
+      "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"
+        },
+        "field": {
+          "char": "f",
+          "description": "Set a body field: -f key=value (repeatable)",
+          "name": "field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "type": {
+          "description": "JSON source type (mutually exclusive with --file)",
+          "exclusive": [
+            "file"
+          ],
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "qna",
+            "link"
+          ],
+          "type": "option"
+        },
+        "file": {
+          "description": "Path to a file to upload as a source (mutually exclusive with --type)",
+          "exclusive": [
+            "type",
+            "data",
+            "content",
+            "url",
+            "link-type"
+          ],
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Source name (--type text/qna, or a file upload)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content": {
+          "description": "Text content for --type text (@file, @-, or inline)",
+          "name": "content",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "description": "URL for --type link",
+          "name": "url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "link-type": {
+          "description": "Link crawl mode for --type link",
+          "name": "link-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "individual",
+            "sitemap",
+            "crawl"
+          ],
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON body (@file, @-, or inline); per-type flags override matching keys",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sources:create",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sources",
+        "create.js"
+      ]
+    },
+    "sources:delete": {
+      "aliases": [],
+      "args": {
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
+        }
+      },
+      "description": "Delete a source (restorable via restore command)",
+      "examples": [
+        "<%= config.bin %> sources delete src_1 -a agt_1"
+      ],
+      "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": "sources:delete",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sources",
+        "delete.js"
+      ]
+    },
+    "sources:get": {
+      "aliases": [],
+      "args": {
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
+        }
+      },
+      "description": "Show one source",
+      "examples": [
+        "<%= config.bin %> sources get src_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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sources:get",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sources",
+        "get.js"
+      ]
+    },
+    "sources:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List sources for an agent",
+      "examples": [
+        "<%= config.bin %> sources list -a agt_123",
+        "<%= config.bin %> sources list -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",
+          "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"
+        },
+        "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"
+        },
+        "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",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sources",
+        "list.js"
+      ]
+    },
+    "sources:restore": {
+      "aliases": [],
+      "args": {
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
+        }
+      },
+      "description": "Restore a deleted source",
+      "examples": [
+        "<%= config.bin %> sources restore src_1 -a agt_1"
+      ],
+      "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": "sources:restore",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sources",
+        "restore.js"
+      ]
+    },
+    "sources:summary": {
+      "aliases": [],
+      "args": {},
+      "description": "Show aggregated source counts and sizes for an agent",
+      "examples": [
+        "<%= config.bin %> sources summary -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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sources:summary",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sources",
+        "summary.js"
+      ]
+    },
+    "sources:update": {
+      "aliases": [],
+      "args": {
+        "sourceId": {
+          "description": "Source ID",
+          "name": "sourceId",
+          "required": true
+        }
+      },
+      "description": "Update an existing source (text, qna, link, or file)",
+      "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"
+      ],
+      "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"
+        },
+        "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",
+      "pluginAlias": "chatbase",
+      "pluginName": "chatbase",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sources",
+        "update.js"
+      ]
+    }
+  },
+  "version": "0.1.0"
+}