@thisispamela/cli 1.1.0 → 1.1.1

package/README.md

@@ -0,0 +1,152 @@
+# @thisispamela/cli
+
+Command-line interface for the Pamela Enterprise Voice API. Make calls, check status, and manage your API from the terminal.
+
+## Installation
+
+```bash
+npm install -g @thisispamela/cli
+```
+
+Or use with `npx`:
+
+```bash
+npx @thisispamela/cli <command>
+```
+
+## Setup
+
+Set your API key as an environment variable:
+
+```bash
+export PAMELA_API_KEY=pk_live_your_api_key_here
+```
+
+Or pass it with the `--api-key` flag on each command.
+
+## Commands
+
+### Create a Call
+
+```bash
+thisispamela create-call \
+  --to "+15551234567" \
+  --task "Schedule a demo for tomorrow at 2pm" \
+  --voice "auto" \
+  --agent-name "Pamela" \
+  --caller-name "Acme Corp"
+```
+
+**Options:**
+- `--to` (required): Phone number in E.164 format
+- `--task` (required): Task description for the call
+- `--country`: ISO country code (optional)
+- `--locale`: Locale string (optional, e.g., "en-US")
+- `--voice`: Voice preference `"male" | "female" | "auto"` (optional)
+- `--agent-name`: Agent name override (optional)
+- `--caller-name`: Name of who the agent is calling on behalf of (optional)
+- `--max-duration-seconds`: Maximum call duration (optional, default: 299)
+
+### Get Call Status
+
+```bash
+thisispamela get-call --call-id call_abc123def456
+```
+
+### List Calls
+
+```bash
+thisispamela list-calls \
+  --limit 10 \
+  --status completed \
+  --start-date 2024-01-01 \
+  --end-date 2024-01-31
+```
+
+**Options:**
+- `--limit`: Maximum number of calls to return (default: 50)
+- `--offset`: Pagination offset (default: 0)
+- `--status`: Filter by status (`queued`, `ringing`, `in_progress`, `completed`, `failed`, `cancelled`)
+- `--start-date`: Filter calls from this date (YYYY-MM-DD)
+- `--end-date`: Filter calls until this date (YYYY-MM-DD)
+
+### Cancel a Call
+
+```bash
+thisispamela cancel-call --call-id call_abc123def456
+```
+
+### Hangup a Call
+
+```bash
+thisispamela hangup-call --call-id call_abc123def456
+```
+
+## Global Options
+
+All commands support:
+
+- `--api-key <key>`: Pamela API key (falls back to `PAMELA_API_KEY` env var)
+- `--base-url <url>`: Custom API base URL (default: `https://api.thisispamela.com`)
+
+## Examples
+
+### Quick Call
+
+```bash
+export PAMELA_API_KEY=pk_live_xxx
+thisispamela create-call --to "+15551234567" --task "Remind about meeting"
+```
+
+### Check Call Status
+
+```bash
+thisispamela get-call --call-id call_abc123
+```
+
+### List Today's Calls
+
+```bash
+thisispamela list-calls --start-date $(date +%Y-%m-%d) --status completed
+```
+
+### Cancel In-Progress Call
+
+```bash
+thisispamela cancel-call --call-id call_xyz789
+```
+
+## Output Format
+
+All commands output JSON for easy parsing and integration with scripts:
+
+```bash
+# Create call
+thisispamela create-call --to "+15551234567" --task "Test"
+# Output: {"id": "call_abc123", "status": "queued", ...}
+
+# Get call
+thisispamela get-call --call-id call_abc123
+# Output: {"id": "call_abc123", "status": "completed", "transcript": [...], ...}
+```
+
+## Error Handling
+
+Errors are output as JSON to stderr:
+
+```json
+{
+  "error": {
+    "name": "AuthenticationError",
+    "message": "Invalid API key"
+  }
+}
+```
+
+## Getting API Keys
+
+See the [JavaScript SDK README](../javascript/README.md#getting-api-keys) for instructions on obtaining and managing API keys.
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thisispamela/cli",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Pamela Enterprise Voice API CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -31,7 +31,7 @@
   "author": "Pamela",
   "license": "MIT",
   "dependencies": {
-    "@thisispamela/sdk": "^1.1.0",
+    "@thisispamela/sdk": "^1.1.1",
     "commander": "^14.0.3"
   },
   "devDependencies": {