import { CommuneClient } from 'commune-ai';

const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });

const message = await commune.sms.send({
  to: '+14155559999',
  body: 'Hello from your AI agent!',
  phone_number_id: 'pn_01abc123',
});

console.log(message.message_id);  // sms_SM...
console.log(message.status);      // accepted

from commune import CommuneClient

client = CommuneClient()

message = client.sms.send(
    to="+14155559999",
    body="Hello from your AI agent!",
    phone_number_id="pn_01abc123",
)

print(message.message_id)  # sms_SM...
print(message.status)      # accepted

send_sms(
  to="+14155559999",
  body="Hello from your AI agent!",
  phone_number_id="pn_01abc123"
)

curl -X POST https://api.commune.email/v1/sms/send \
  -H "Authorization: Bearer comm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155559999",
    "body": "Hello from your AI agent!",
    "phone_number_id": "pn_01abc123"
  }'

commune sms send \
  --to "+14155559999" \
  --body "Hello from your AI agent!"

{
  "data": {
    "message_id": "sms_SMabc123def456",
    "thread_id": "a1b2c3d4e5f6789012345678901234ab",
    "message_sid": "SMabc123def456",
    "status": "accepted",
    "credits_charged": 2,
    "segments": 1
  }
}

{
  "error": "Invalid request",
  "details": {
    "fieldErrors": {
      "to": ["to must be a valid E.164 phone number"]
    }
  }
}

{
  "error": "insufficient_phone_credits",
  "message": "Insufficient credits to send this message"
}

{
  "error": "recipient_suppressed",
  "message": "Recipient has opted out"
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many messages"
}