@sendblue/cli 0.6.1 → 0.7.0

package/README.md

@@ -0,0 +1,105 @@
+# Sendblue CLI
+
+iMessage numbers for AI agents. Set up an iMessage-enabled phone number and start sending messages in under a minute.
+
+## Install
+
+```bash
+npm install -g @sendblue/cli
+```
+
+Requires Node.js 18+.
+
+## Quick Start
+
+```bash
+# Create an account and get an iMessage number
+sendblue setup
+
+# Send a message
+sendblue send +15551234567 'Hello from Sendblue!'
+```
+
+## Commands
+
+### `sendblue setup`
+
+Create a new Sendblue account. Walks you through email verification, company name, and adding your first contact.
+
+```bash
+# Interactive (recommended for first time)
+sendblue setup
+
+# Non-interactive (for CI/scripts)
+sendblue setup --email you@example.com                          # sends verification code, exits
+sendblue setup --email you@example.com --code 12345678 --company my-co --contact +15551234567
+```
+
+| Flag | Description |
+|------|-------------|
+| `--email <email>` | Email address |
+| `--code <code>` | 8-digit verification code |
+| `--company <name>` | Company name (lowercase, hyphens/underscores, 3-64 chars) |
+| `--contact <number>` | First contact phone number (E.164 format) |
+
+### `sendblue login`
+
+Log in to an existing account.
+
+```bash
+sendblue login
+```
+
+### `sendblue send <number> <message>`
+
+Send an iMessage.
+
+```bash
+sendblue send +15551234567 'Hey, your order shipped!'
+```
+
+### `sendblue messages`
+
+View recent messages.
+
+```bash
+sendblue messages
+sendblue messages -n +15551234567 --limit 20
+sendblue messages --inbound
+```
+
+| Flag | Description |
+|------|-------------|
+| `-n, --number <number>` | Filter by contact |
+| `-l, --limit <count>` | Number of messages (default: 10) |
+| `--outbound` | Show only sent messages |
+| `--inbound` | Show only received messages |
+
+### `sendblue add-contact <number>`
+
+Add a contact to your account.
+
+```bash
+sendblue add-contact +15551234567
+```
+
+### `sendblue contacts`
+
+List all contacts and their verification status.
+
+### `sendblue status`
+
+Check your account status and plan.
+
+### `sendblue whoami`
+
+Show current credentials and verify they're valid.
+
+## Credentials
+
+Credentials are stored in `~/.sendblue/credentials.json` with `600` permissions (owner read/write only). Run `sendblue whoami` to see the current config path.
+
+## Links
+
+- [Sendblue](https://sendblue.co)
+- [API Docs](https://docs.sendblue.co)

package/dist/commands/add-contact.js

@@ -25,7 +25,7 @@ export async function addContactCommand(number) {
             spinner.succeed(`Contact ${formatPhoneNumber(normalized)} is already verified!`);
             console.log();
             console.log(chalk.bold('  You can now send messages:'));
-            console.log(chalk.cyan(`    sendblue send ${normalized} "Hello!"`));
+            console.log(chalk.cyan(`    sendblue send ${normalized} 'Hello!'`));
             console.log();
             return;
         }

package/dist/commands/lines.d.ts

@@ -0,0 +1 @@
+export declare function linesCommand(): Promise<void>;

package/dist/commands/lines.js

@@ -0,0 +1,35 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { getLines } from '../lib/api.js';
+import { formatPhoneNumber, printError } from '../lib/format.js';
+export async function linesCommand() {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Fetching lines...', indent: 2 }).start();
+    try {
+        const result = await getLines(creds.apiKey, creds.apiSecret);
+        spinner.stop();
+        console.log();
+        console.log(chalk.bold('  Phone Lines'));
+        console.log();
+        if (!result.numbers || result.numbers.length === 0) {
+            console.log(chalk.dim('  No lines assigned yet.'));
+        }
+        else {
+            for (const number of result.numbers) {
+                console.log(`  ${formatPhoneNumber(number)}`);
+            }
+            console.log();
+            console.log(chalk.dim(`  ${result.numbers.length} line${result.numbers.length === 1 ? '' : 's'} total`));
+        }
+        console.log();
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/send-group.d.ts

@@ -0,0 +1,5 @@
+interface SendGroupOptions {
+    media?: string;
+}
+export declare function sendGroupCommand(numbers: string[], opts: SendGroupOptions): Promise<void>;
+export {};

package/dist/commands/send-group.js

@@ -0,0 +1,33 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { sendGroupMessage } from '../lib/api.js';
+import { normalizeNumber, formatPhoneNumber, printError } from '../lib/format.js';
+export async function sendGroupCommand(numbers, opts) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    // Last argument is the message, rest are numbers
+    if (numbers.length < 3) {
+        printError('Usage: sendblue send-group <number1> <number2> [number3...] <message>');
+        printError('At least 2 phone numbers and a message are required.');
+        process.exit(1);
+    }
+    const message = numbers[numbers.length - 1];
+    const phoneNumbers = numbers.slice(0, -1).map(normalizeNumber);
+    const spinner = ora({ text: `Sending group message to ${phoneNumbers.length} recipients...`, indent: 2 }).start();
+    try {
+        const result = await sendGroupMessage(creds.apiKey, creds.apiSecret, phoneNumbers, message, creds.assignedNumber, opts.media);
+        spinner.succeed(`Group message sent to ${phoneNumbers.length} recipients`);
+        console.log(chalk.dim(`  Recipients: ${phoneNumbers.map(formatPhoneNumber).join(', ')}`));
+        if (result.messageId) {
+            console.log(chalk.dim(`  Message ID: ${result.messageId}`));
+        }
+    }
+    catch (err) {
+        spinner.fail(`Send failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/send.d.ts

@@ -1 +1,5 @@
-export declare function sendCommand(number: string, message: string): Promise<void>;
+interface SendOptions {
+    media?: string;
+}
+export declare function sendCommand(number: string, message: string, opts: SendOptions): Promise<void>;
+export {};

package/dist/commands/send.js

@@ -2,9 +2,8 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { getCredentials } from '../lib/config.js';
 import { sendMessage } from '../lib/api.js';
-import { normalizeNumber } from '../lib/format.js';
-import { printError } from '../lib/format.js';
-export async function sendCommand(number, message) {
+import { normalizeNumber, printError } from '../lib/format.js';
+export async function sendCommand(number, message, opts) {
     const creds = getCredentials();
     if (!creds) {
         printError('No credentials found. Run `sendblue login` first.');
@@ -13,7 +12,7 @@ export async function sendCommand(number, message) {
     const normalized = normalizeNumber(number);
     const spinner = ora({ text: `Sending to ${normalized}...`, indent: 2 }).start();
     try {
-        const result = await sendMessage(creds.apiKey, creds.apiSecret, normalized, message, creds.assignedNumber);
+        const result = await sendMessage(creds.apiKey, creds.apiSecret, normalized, message, creds.assignedNumber, opts.media);
         spinner.succeed(`Message sent to ${normalized}`);
         if (result.messageId) {
             console.log(chalk.dim(`  Message ID: ${result.messageId}`));

package/dist/commands/setup.d.ts

@@ -1 +1,8 @@
-export declare function setupCommand(): Promise<void>;
+interface SetupOptions {
+    email?: string;
+    code?: string;
+    company?: string;
+    contact?: string;
+}
+export declare function setupCommand(opts: SetupOptions): Promise<void>;
+export {};

package/dist/commands/setup.js

@@ -17,7 +17,8 @@ const onCancel = () => {
     printError('Setup cancelled.');
     process.exit(0);
 };
-export async function setupCommand() {
+export async function setupCommand(opts) {
+    const nonInteractive = !!(opts.email && opts.code && opts.company);
     console.log();
     printLogo();
     console.log(chalk.bold('  sendblue setup'));
@@ -26,57 +27,113 @@ export async function setupCommand() {
     // Check for existing credentials
     const existing = getCredentials();
     if (existing) {
-        const { overwrite } = await prompts({
-            type: 'confirm',
-            name: 'overwrite',
-            message: `You already have an account configured (${existing.email}). Overwrite?`,
-            initial: false
-        }, { onCancel });
-        if (!overwrite) {
-            console.log(chalk.dim('  Setup cancelled.'));
-            return;
+        if (nonInteractive) {
+            console.log(chalk.dim(`  Overwriting existing account (${existing.email})`));
+        }
+        else {
+            const { overwrite } = await prompts({
+                type: 'confirm',
+                name: 'overwrite',
+                message: `You already have an account configured (${existing.email}). Overwrite?`,
+                initial: false
+            }, { onCancel });
+            if (!overwrite) {
+                console.log(chalk.dim('  Setup cancelled.'));
+                return;
+            }
         }
     }
-    // Step 1: Collect email
-    const { email } = await prompts({
-        type: 'text',
-        name: 'email',
-        message: 'Email',
-        validate: (v) => /^[^\s@]+@[^\s@]+\.[a-zA-Z]{2,}$/.test(v) || 'Enter a valid email'
-    }, { onCancel });
-    // Step 2: Send verification code
-    const sendSpinner = ora({ text: 'Sending verification code...', indent: 2 }).start();
-    try {
-        await sendCode(email);
-        sendSpinner.succeed(`Code sent to ${email}`);
+    // Validate flags upfront
+    if (opts.email && !/^[^\s@]+@[^\s@]+\.[a-zA-Z]{2,}$/.test(opts.email)) {
+        printError('Invalid email address.');
+        process.exit(1);
     }
-    catch (err) {
-        sendSpinner.fail(`Failed to send code: ${err instanceof Error ? err.message : String(err)}`);
+    if (opts.code && !/^\d{8}$/.test(opts.code)) {
+        printError('Verification code must be 8 digits.');
         process.exit(1);
     }
-    console.log();
-    // Step 3: Enter code
-    const { code } = await prompts({
-        type: 'text',
-        name: 'code',
-        message: 'Verification code',
-        validate: (v) => /^\d{8}$/.test(v) || 'Enter the 8-digit code from your email'
-    }, { onCancel });
-    // Step 4: Company name (required for setup)
-    const { companyName } = await prompts({
-        type: 'text',
-        name: 'companyName',
-        message: 'Company name (lowercase, hyphens/underscores only)',
-        validate: (v) => {
-            if (!v)
-                return 'Company name is required';
-            if (!/^[a-z0-9_-]+$/.test(v))
-                return 'Only lowercase letters, numbers, hyphens, and underscores';
-            if (v.length < 3 || v.length > 64)
-                return 'Must be 3-64 characters';
-            return true;
+    if (opts.company) {
+        if (!/^[a-z0-9_-]+$/.test(opts.company)) {
+            printError('Company name: only lowercase letters, numbers, hyphens, and underscores.');
+            process.exit(1);
+        }
+        if (opts.company.length < 3 || opts.company.length > 64) {
+            printError('Company name must be 3-64 characters.');
+            process.exit(1);
+        }
+    }
+    // Step 1: Collect email
+    let email;
+    if (opts.email) {
+        email = opts.email;
+    }
+    else {
+        const response = await prompts({
+            type: 'text',
+            name: 'email',
+            message: 'Email',
+            validate: (v) => /^[^\s@]+@[^\s@]+\.[a-zA-Z]{2,}$/.test(v) || 'Enter a valid email'
+        }, { onCancel });
+        email = response.email;
+    }
+    // Step 2: Send verification code (skip if code already provided)
+    if (!opts.code) {
+        const sendSpinner = ora({ text: 'Sending verification code...', indent: 2 }).start();
+        try {
+            await sendCode(email);
+            sendSpinner.succeed(`Code sent to ${email}`);
+        }
+        catch (err) {
+            sendSpinner.fail(`Failed to send code: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+        // Non-interactive: just send the code and exit so the user can
+        // re-run with --code once they have it
+        if (opts.email) {
+            console.log();
+            console.log(chalk.dim('  Once you have the code, run:'));
+            console.log(chalk.cyan(`    sendblue setup --email ${email} --code <CODE> --company <NAME>`));
+            console.log();
+            return;
         }
-    }, { onCancel });
+        console.log();
+    }
+    // Step 3: Enter code
+    let code;
+    if (opts.code) {
+        code = opts.code;
+    }
+    else {
+        const response = await prompts({
+            type: 'text',
+            name: 'code',
+            message: 'Verification code',
+            validate: (v) => /^\d{8}$/.test(v) || 'Enter the 8-digit code from your email'
+        }, { onCancel });
+        code = response.code;
+    }
+    // Step 4: Company name
+    let companyName;
+    if (opts.company) {
+        companyName = opts.company;
+    }
+    else {
+        const response = await prompts({
+            type: 'text',
+            name: 'companyName',
+            message: 'Company name (lowercase, hyphens/underscores only)',
+            validate: (v) => {
+                if (!v)
+                    return 'Company name is required';
+                if (!/^[a-z0-9_-]+$/.test(v))
+                    return 'Only lowercase letters, numbers, hyphens, and underscores';
+                if (v.length < 3 || v.length > 64)
+                    return 'Must be 3-64 characters';
+                return true;
+            }
+        }, { onCancel });
+        companyName = response.companyName;
+    }
     // Step 5: Verify code + create account
     const setupSpinner = ora({ text: 'Setting up your account...', indent: 2 }).start();
     let result;
@@ -100,18 +157,29 @@ export async function setupCommand() {
         process.exit(1);
     }
     // Step 6: Add first contact
-    console.log(chalk.bold('  Add your first contact'));
-    console.log(chalk.dim('  Enter the phone number you want to message via iMessage.'));
-    console.log();
-    const { contactNumber } = await prompts({
-        type: 'text',
-        name: 'contactNumber',
-        message: 'Contact phone number',
-        validate: (v) => {
-            const n = normalizeNumber(v);
-            return /^\+\d{10,15}$/.test(n) || 'Enter a valid phone number (e.g. +15551234567)';
-        }
-    }, { onCancel });
+    let contactNumber;
+    if (opts.contact) {
+        contactNumber = opts.contact;
+    }
+    else if (!nonInteractive) {
+        console.log(chalk.bold('  Add your first contact'));
+        console.log(chalk.dim('  Enter the phone number you want to message via iMessage.'));
+        console.log();
+        const response = await prompts({
+            type: 'text',
+            name: 'contactNumber',
+            message: 'Contact phone number',
+            validate: (v) => {
+                const n = normalizeNumber(v);
+                return /^\+\d{10,15}$/.test(n) || 'Enter a valid phone number (e.g. +15551234567)';
+            }
+        }, { onCancel });
+        contactNumber = response.contactNumber;
+    }
+    if (!contactNumber) {
+        console.log();
+        return;
+    }
     const normalized = normalizeNumber(contactNumber);
     const contactSpinner = ora({ text: `Adding contact ${formatPhoneNumber(normalized)}...`, indent: 2 }).start();
     try {
@@ -120,7 +188,7 @@ export async function setupCommand() {
             contactSpinner.succeed(`Contact ${formatPhoneNumber(normalized)} is already verified!`);
             console.log();
             console.log(chalk.bold('  You\'re all set! Send a message:'));
-            console.log(chalk.cyan(`    sendblue send ${normalized} "Hello from Sendblue!"`));
+            console.log(chalk.cyan(`    sendblue send ${normalized} 'Hello from Sendblue!'`));
             console.log();
             return;
         }
@@ -136,17 +204,19 @@ export async function setupCommand() {
             console.log();
             console.log(chalk.cyan.bold(`    ${formatPhoneNumber(sharedNumber)}`));
             console.log();
-            // Show QR code for easy texting
-            const qr = await generateSmsQr(sharedNumber);
-            console.log(chalk.dim('  Or scan this QR code to open a text:'));
-            console.log();
-            // Indent each line of the QR code
-            for (const line of qr.split('\n')) {
-                console.log(`    ${line}`);
+            if (!nonInteractive) {
+                // Show QR code for easy texting
+                const qr = await generateSmsQr(sharedNumber);
+                console.log(chalk.dim('  Or scan this QR code to open a text:'));
+                console.log();
+                // Indent each line of the QR code
+                for (const line of qr.split('\n')) {
+                    console.log(`    ${line}`);
+                }
+                console.log();
             }
-            console.log();
             console.log(chalk.dim('  Once they text in, run:'));
-            console.log(chalk.cyan(`    sendblue send ${normalized} "Hello from Sendblue!"`));
+            console.log(chalk.cyan(`    sendblue send ${normalized} 'Hello from Sendblue!'`));
         }
         console.log();
     }

package/dist/commands/show-keys.d.ts

@@ -0,0 +1 @@
+export declare function showKeysCommand(): Promise<void>;

package/dist/commands/show-keys.js

@@ -0,0 +1,16 @@
+import chalk from 'chalk';
+import { getCredentials } from '../lib/config.js';
+import { printError } from '../lib/format.js';
+export async function showKeysCommand() {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    console.log();
+    console.log(chalk.bold('  API Keys'));
+    console.log();
+    console.log(`  ${chalk.bold('API Key')}:    ${creds.apiKey}`);
+    console.log(`  ${chalk.bold('API Secret')}: ${creds.apiSecret}`);
+    console.log();
+}

package/dist/commands/typing.d.ts

@@ -0,0 +1 @@
+export declare function typingCommand(number: string): Promise<void>;

package/dist/commands/typing.js

@@ -0,0 +1,21 @@
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { sendTypingIndicator } from '../lib/api.js';
+import { normalizeNumber, printError } from '../lib/format.js';
+export async function typingCommand(number) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    const normalized = normalizeNumber(number);
+    const spinner = ora({ text: `Sending typing indicator to ${normalized}...`, indent: 2 }).start();
+    try {
+        await sendTypingIndicator(creds.apiKey, creds.apiSecret, normalized, creds.assignedNumber);
+        spinner.succeed(`Typing indicator sent to ${normalized}`);
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/webhooks.d.ts

@@ -0,0 +1,7 @@
+export declare function webhooksListCommand(): Promise<void>;
+export declare function webhooksAddCommand(url: string, opts: {
+    type: string;
+}): Promise<void>;
+export declare function webhooksRemoveCommand(url: string, opts: {
+    type: string;
+}): Promise<void>;

package/dist/commands/webhooks.js

@@ -0,0 +1,78 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { getWebhooks, addWebhook, deleteWebhook } from '../lib/api.js';
+import { printError } from '../lib/format.js';
+const VALID_TYPES = ['receive', 'outbound', 'call_log', 'line_blocked', 'line_assigned', 'contact_created'];
+export async function webhooksListCommand() {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Fetching webhooks...', indent: 2 }).start();
+    try {
+        const result = await getWebhooks(creds.apiKey, creds.apiSecret);
+        spinner.stop();
+        console.log();
+        console.log(chalk.bold('  Webhooks'));
+        console.log();
+        if (!result.webhooks || result.webhooks.length === 0) {
+            console.log(chalk.dim('  No webhooks configured.'));
+            console.log();
+            console.log(chalk.dim('  Add one with:'));
+            console.log(chalk.cyan('    sendblue webhooks add <url> --type receive'));
+        }
+        else {
+            for (const wh of result.webhooks) {
+                const type = wh.type ? chalk.dim(` (${wh.type})`) : '';
+                console.log(`  ${chalk.cyan(wh.url)}${type}`);
+            }
+        }
+        console.log();
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+export async function webhooksAddCommand(url, opts) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    if (!VALID_TYPES.includes(opts.type)) {
+        printError(`Invalid type. Must be one of: ${VALID_TYPES.join(', ')}`);
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Adding webhook...', indent: 2 }).start();
+    try {
+        await addWebhook(creds.apiKey, creds.apiSecret, url, opts.type);
+        spinner.succeed(`Webhook added: ${url} (${opts.type})`);
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+export async function webhooksRemoveCommand(url, opts) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    if (!VALID_TYPES.includes(opts.type)) {
+        printError(`Invalid type. Must be one of: ${VALID_TYPES.join(', ')}`);
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Removing webhook...', indent: 2 }).start();
+    try {
+        await deleteWebhook(creds.apiKey, creds.apiSecret, url, opts.type);
+        spinner.succeed(`Webhook removed: ${url} (${opts.type})`);
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/index.js

@@ -4,10 +4,15 @@ import { Command } from 'commander';
 import { setupCommand } from './commands/setup.js';
 import { loginCommand } from './commands/login.js';
 import { sendCommand } from './commands/send.js';
+import { sendGroupCommand } from './commands/send-group.js';
 import { messagesCommand } from './commands/messages.js';
 import { statusCommand } from './commands/status.js';
 import { whoamiCommand } from './commands/whoami.js';
 import { addContactCommand, contactsCommand } from './commands/add-contact.js';
+import { typingCommand } from './commands/typing.js';
+import { linesCommand } from './commands/lines.js';
+import { webhooksListCommand, webhooksAddCommand, webhooksRemoveCommand } from './commands/webhooks.js';
+import { showKeysCommand } from './commands/show-keys.js';
 import { getLogo } from './lib/format.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
@@ -19,26 +24,33 @@ program
 program
     .command('setup')
     .description('Create a new Sendblue account and get an iMessage number')
+    .option('--email <email>', 'Email address (skip prompt)')
+    .option('--code <code>', 'Verification code (skip prompt, requires --email)')
+    .option('--company <name>', 'Company name (skip prompt)')
+    .option('--contact <number>', 'First contact phone number (skip prompt)')
     .action(setupCommand);
 program
     .command('login')
     .description('Log in to an existing Sendblue account')
     .action(loginCommand);
-program
-    .command('add-contact')
-    .description('Add a contact to your account')
-    .argument('<number>', 'Contact phone number (E.164 format)')
-    .action(addContactCommand);
-program
-    .command('contacts')
-    .description('List contacts and verification status')
-    .action(contactsCommand);
 program
     .command('send')
     .description('Send a message')
     .argument('<number>', 'Recipient phone number (E.164 format)')
     .argument('<message>', 'Message content')
+    .option('--media <url>', 'Attach a media URL (image, video, etc.)')
     .action(sendCommand);
+program
+    .command('send-group')
+    .description('Send a group message')
+    .argument('<args...>', 'Phone numbers followed by message: <num1> <num2> [...] <message>')
+    .option('--media <url>', 'Attach a media URL')
+    .action(sendGroupCommand);
+program
+    .command('typing')
+    .description('Send a typing indicator')
+    .argument('<number>', 'Recipient phone number (E.164 format)')
+    .action(typingCommand);
 program
     .command('messages')
     .description('View recent messages')
@@ -47,6 +59,38 @@ program
     .option('--outbound', 'Show only outbound messages')
     .option('--inbound', 'Show only inbound messages')
     .action(messagesCommand);
+program
+    .command('add-contact')
+    .description('Add a contact to your account')
+    .argument('<number>', 'Contact phone number (E.164 format)')
+    .action(addContactCommand);
+program
+    .command('contacts')
+    .description('List contacts and verification status')
+    .action(contactsCommand);
+program
+    .command('lines')
+    .description('List phone numbers on your account')
+    .action(linesCommand);
+const webhooks = program
+    .command('webhooks')
+    .description('Manage webhooks');
+webhooks
+    .command('list')
+    .description('List configured webhooks')
+    .action(webhooksListCommand);
+webhooks
+    .command('add')
+    .description('Add a webhook')
+    .argument('<url>', 'Webhook URL')
+    .requiredOption('--type <type>', 'Event type (receive, outbound, call_log, line_blocked, line_assigned, contact_created)')
+    .action(webhooksAddCommand);
+webhooks
+    .command('remove')
+    .description('Remove a webhook')
+    .argument('<url>', 'Webhook URL')
+    .requiredOption('--type <type>', 'Event type')
+    .action(webhooksRemoveCommand);
 program
     .command('status')
     .description('Check your account status')
@@ -55,4 +99,8 @@ program
     .command('whoami')
     .description('Show current credentials')
     .action(whoamiCommand);
+program
+    .command('show-keys')
+    .description('Show your API key and secret')
+    .action(showKeysCommand);
 program.parse();

package/dist/lib/api.d.ts

@@ -22,7 +22,7 @@ interface AccountResponse {
 export declare function sendCode(email: string): Promise<void>;
 export declare function verifySetup(email: string, code: string, companyName: string): Promise<SetupResponse>;
 export declare function verifyLogin(email: string, code: string): Promise<SetupResponse>;
-export declare function sendMessage(apiKey: string, apiSecret: string, number: string, content: string, fromNumber?: string): Promise<SendMessageResponse>;
+export declare function sendMessage(apiKey: string, apiSecret: string, number: string, content: string, fromNumber?: string, mediaUrl?: string): Promise<SendMessageResponse>;
 export declare function getAccount(apiKey: string, apiSecret: string): Promise<AccountResponse>;
 interface ContactRoute {
     id: number;
@@ -67,5 +67,21 @@ export declare function getMessages(apiKey: string, apiSecret: string, opts: {
     limit?: number;
     isOutbound?: boolean;
 }): Promise<MessagesResponse>;
+export declare function sendTypingIndicator(apiKey: string, apiSecret: string, number: string, fromNumber?: string): Promise<void>;
+export declare function sendGroupMessage(apiKey: string, apiSecret: string, numbers: string[], content: string, fromNumber?: string, mediaUrl?: string): Promise<SendMessageResponse>;
+export declare function getLines(apiKey: string, apiSecret: string): Promise<{
+    numbers: string[];
+}>;
+interface Webhook {
+    url: string;
+    type?: string;
+}
+interface WebhooksResponse {
+    webhooks: Webhook[];
+    [key: string]: unknown;
+}
+export declare function getWebhooks(apiKey: string, apiSecret: string): Promise<WebhooksResponse>;
+export declare function addWebhook(apiKey: string, apiSecret: string, url: string, type: string): Promise<void>;
+export declare function deleteWebhook(apiKey: string, apiSecret: string, url: string, type: string): Promise<void>;
 export declare function testKeys(apiKey: string, apiSecret: string): Promise<boolean>;
 export {};

package/dist/lib/api.js

@@ -1,5 +1,5 @@
 const API_BASE = 'https://api.sendblue.com';
-const SETUP_BASE = process.env.SENDBLUE_SETUP_URL || 'https://dashboard.sendblue.com';
+const SETUP_BASE = 'https://dashboard.sendblue.com';
 export async function sendCode(email) {
     const res = await fetch(`${SETUP_BASE}/api/v3/cli/setup`, {
         method: 'POST',
@@ -35,10 +35,12 @@ export async function verifyLogin(email, code) {
     }
     return res.json();
 }
-export async function sendMessage(apiKey, apiSecret, number, content, fromNumber) {
+export async function sendMessage(apiKey, apiSecret, number, content, fromNumber, mediaUrl) {
     const body = { number, content };
     if (fromNumber)
         body.from_number = fromNumber;
+    if (mediaUrl)
+        body.media_url = mediaUrl;
     const res = await fetch(`${API_BASE}/api/send-message`, {
         method: 'POST',
         headers: {
@@ -121,6 +123,106 @@ export async function getMessages(apiKey, apiSecret, opts) {
     }
     return res.json();
 }
+// --- Typing indicator ---
+export async function sendTypingIndicator(apiKey, apiSecret, number, fromNumber) {
+    const body = { number };
+    if (fromNumber)
+        body.from_number = fromNumber;
+    const res = await fetch(`${API_BASE}/api/send-typing-indicator`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to send typing indicator (${res.status})`);
+    }
+}
+// --- Group messaging ---
+export async function sendGroupMessage(apiKey, apiSecret, numbers, content, fromNumber, mediaUrl) {
+    const body = { numbers, content };
+    if (fromNumber)
+        body.from_number = fromNumber;
+    if (mediaUrl)
+        body.media_url = mediaUrl;
+    const res = await fetch(`${API_BASE}/api/send-group-message`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to send group message (${res.status})`);
+    }
+    return res.json();
+}
+// --- Lines ---
+export async function getLines(apiKey, apiSecret) {
+    const res = await fetch(`${API_BASE}/api/lines`, {
+        method: 'GET',
+        headers: {
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        }
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to get lines (${res.status})`);
+    }
+    return res.json();
+}
+export async function getWebhooks(apiKey, apiSecret) {
+    const res = await fetch(`${API_BASE}/api/account/webhooks`, {
+        method: 'GET',
+        headers: {
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        }
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to get webhooks (${res.status})`);
+    }
+    return res.json();
+}
+export async function addWebhook(apiKey, apiSecret, url, type) {
+    const res = await fetch(`${API_BASE}/api/account/webhooks`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify({ webhooks: [url], type })
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to add webhook (${res.status})`);
+    }
+}
+export async function deleteWebhook(apiKey, apiSecret, url, type) {
+    const res = await fetch(`${API_BASE}/api/account/webhooks`, {
+        method: 'DELETE',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify({ webhooks: [url], type })
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to delete webhook (${res.status})`);
+    }
+}
 export async function testKeys(apiKey, apiSecret) {
     try {
         const res = await fetch(`${API_BASE}/account`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendblue/cli",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Sendblue CLI — iMessage numbers for agents",
   "type": "module",
   "bin": {