# SMS Messenger (Pty) Ltd SMS

This file teaches Gemini how to send SMS messages via the SMS Messenger (Pty) Ltd REST API at `http://sms1.smsmessenger.co.za/app/api/rest/v1`.

## When to use this

Use this skill whenever the user wants to:

- Send an SMS or text message
- Send bulk SMS to multiple recipients
- Check their SMS Messenger (Pty) Ltd SMS credit balance
- List recently sent messages
- List their contacts

## On first use

Look for credentials at:

- macOS / Linux: `~/.config/sms-messenger-pty-ltd/credentials`
- Windows: `%APPDATA%\sms-messenger-pty-ltd\credentials`

If the file does not exist, ask the user for their SMS Messenger (Pty) Ltd login email and API key, then save them in the format:

```
email=<email>
api_key=<key>
```

On macOS / Linux, set permissions to `0600`. The user can find their API key by signing in to http://sms1.smsmessenger.co.za/app, clicking their company name, then "Developer settings."

## Authentication

On every API request, set the HTTP headers:

```
email: <email>
token: <api-key>
```

## API contract

Fetch `http://sms1.smsmessenger.co.za/app/llms-full.txt` once per session for the full machine-readable API contract. Cache it for the session ? only re-fetch if a request fails with a schema mismatch.

## Error handling

If a request returns 401 Unauthorized, delete the credentials file and prompt the user for new credentials.