matimo-twilio 0.1.0__tar.gz

matimo_twilio-0.1.0/.gitignore

@@ -0,0 +1,63 @@
+# Dependencies
+**/node_modules/
+package-lock.json
+yarn.lock
+
+# Build output
+**/dist/
+*.tsbuildinfo
+
+# Python compiled / build
+**/__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+**/build/
+**/.eggs/
+**/.venv/
+**/.mypy_cache/
+**/.ruff_cache/
+**/.pytest_cache/
+
+# Test coverage
+**/coverage/
+**/.nyc_output/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+typescript/examples/mcp/matimo-tools/.matimo-approvals.json
+typescript/examples/mcp/matimo-tools/fetch-weather/definition.yaml
+typescript/examples/mcp/matimo-tools/npm_downloads/definition.yaml
+typescript/examples/mcp/matimo-tools/skills/ecosystem-health/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/matimo-health-check/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/moltbook-identity/SKILL.md
+typescript/packages/cli/.matimo/certs/server.crt
+typescript/packages/cli/.matimo/certs/server.key
+typescript/examples/mcp/.matimo/certs/server.crt
+typescript/examples/mcp/.matimo/certs/server.key

matimo_twilio-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: matimo-twilio
+Version: 0.1.0
+Summary: Matimo provider — Twilio tools (SMS, MMS, message history)
+License: MIT
+Keywords: agents,ai,matimo,tools,twilio
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Requires-Dist: matimo-core<0.2.0,>=0.1.0
+Requires-Dist: twilio>=8.0
+Description-Content-Type: text/markdown
+
+# matimo-twilio
+
+> Twilio tools for [Matimo](https://matimo.dev) — send SMS, send MMS, and retrieve message history.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo-twilio)](https://pypi.org/project/matimo-twilio/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+---
+
+## Installation
+
+```bash
+pip install matimo matimo-twilio
+```
+
+---
+
+## Available Tools (4 Total)
+
+| Tool | Description |
+|------|-------------|
+| `twilio-send-sms` | Send an SMS message to a phone number |
+| `twilio-send-mms` | Send an MMS message with media |
+| `twilio-list-messages` | List sent/received messages with filters |
+| `twilio-get-message` | Get details of a specific message by SID |
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+import os
+from matimo import Matimo
+from matimo_twilio import get_tools_path
+
+async def main():
+    matimo = await Matimo.init(get_tools_path())
+
+    # Send an SMS
+    await matimo.execute('twilio-send-sms', {
+        'to': '+15551234567',
+        'from': '+15559876543',
+        'body': 'Hello from Matimo!',
+    })
+
+    # List recent messages
+    result = await matimo.execute('twilio-list-messages', {
+        'limit': 10,
+    })
+    print(result)
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+```bash
+export TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+export TWILIO_AUTH_TOKEN="your-auth-token"
+```
+
+Find these in your [Twilio Console](https://console.twilio.com/).
+
+---
+
+## Documentation
+
+- [Twilio Messaging API](https://www.twilio.com/docs/messaging)
+- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/twilio)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo-twilio/
+- **GitHub:** https://github.com/tallclub/matimo
+- **Twilio Docs:** https://www.twilio.com/docs
+

matimo_twilio-0.1.0/README.md

@@ -0,0 +1,81 @@
+# matimo-twilio
+
+> Twilio tools for [Matimo](https://matimo.dev) — send SMS, send MMS, and retrieve message history.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo-twilio)](https://pypi.org/project/matimo-twilio/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+---
+
+## Installation
+
+```bash
+pip install matimo matimo-twilio
+```
+
+---
+
+## Available Tools (4 Total)
+
+| Tool | Description |
+|------|-------------|
+| `twilio-send-sms` | Send an SMS message to a phone number |
+| `twilio-send-mms` | Send an MMS message with media |
+| `twilio-list-messages` | List sent/received messages with filters |
+| `twilio-get-message` | Get details of a specific message by SID |
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+import os
+from matimo import Matimo
+from matimo_twilio import get_tools_path
+
+async def main():
+    matimo = await Matimo.init(get_tools_path())
+
+    # Send an SMS
+    await matimo.execute('twilio-send-sms', {
+        'to': '+15551234567',
+        'from': '+15559876543',
+        'body': 'Hello from Matimo!',
+    })
+
+    # List recent messages
+    result = await matimo.execute('twilio-list-messages', {
+        'limit': 10,
+    })
+    print(result)
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+```bash
+export TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+export TWILIO_AUTH_TOKEN="your-auth-token"
+```
+
+Find these in your [Twilio Console](https://console.twilio.com/).
+
+---
+
+## Documentation
+
+- [Twilio Messaging API](https://www.twilio.com/docs/messaging)
+- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/twilio)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo-twilio/
+- **GitHub:** https://github.com/tallclub/matimo
+- **Twilio Docs:** https://www.twilio.com/docs
+

matimo_twilio-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "matimo-twilio"
+version = "0.1.0"
+description = "Matimo provider — Twilio tools (SMS, MMS, message history)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+keywords = ["ai", "tools", "agents", "matimo", "twilio"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+    "matimo-core>=0.1.0,<0.2.0",
+    "twilio>=8.0",
+]
+
+[project.entry-points."matimo.providers"]
+twilio = "matimo_twilio:get_tools_path"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/matimo_twilio"]

matimo_twilio-0.1.0/src/matimo_twilio/__init__.py

@@ -0,0 +1,17 @@
+"""Matimo twilio provider — exposes the path to YAML tool definitions."""
+from __future__ import annotations
+
+import importlib.resources
+from pathlib import Path
+
+
+def get_tools_path() -> str:
+    """Return the absolute path to the bundled twilio tool definitions."""
+    try:
+        ref = importlib.resources.files("matimo_twilio") / "tools"
+        return str(ref)
+    except Exception:
+        return str(Path(__file__).parent / "tools")
+
+
+__all__ = ["get_tools_path"]

matimo_twilio-0.1.0/src/matimo_twilio/tools/twilio-get-message/definition.yaml

@@ -0,0 +1,133 @@
+name: twilio-get-message
+version: '1.0.0'
+description: >
+  Fetch a single Message resource from the Twilio Programmable Messaging API.
+  Returns the full details of a message identified by its Message SID,
+  including its current status, body, sender, recipient, and timestamps.
+
+parameters:
+  account_sid:
+    type: string
+    required: true
+    description: >
+      The SID of the Account associated with the Message resource.
+      Found on the Twilio Console dashboard: https://console.twilio.com
+      Pattern: ^AC[0-9a-fA-F]{32}$
+  message_sid:
+    type: string
+    required: true
+    description: >
+      The SID of the Message resource to fetch.
+      Pattern: ^(SM|MM)[0-9a-fA-F]{32}$
+      SMS messages start with "SM", MMS messages start with "MM".
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.twilio.com/2010-04-01/Accounts/{account_sid}/Messages/{message_sid}.json'
+  timeout: 30000
+
+authentication:
+  type: basic
+  username_env: TWILIO_ACCOUNT_SID
+  password_env: TWILIO_AUTH_TOKEN
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+      description: Whether the HTTP request was successful (2xx status)
+    data:
+      type: object
+      description: The Twilio Message resource
+      properties:
+        sid:
+          type: string
+          description: The unique SID identifying this Message resource
+        account_sid:
+          type: string
+          description: The SID of the Account associated with this Message
+        to:
+          type: string
+          description: The recipient's phone number in E.164 format
+        from:
+          type: string
+          description: The sender's phone number in E.164 format
+        body:
+          type: string
+          description: The text content of the message (empty string if redacted)
+        status:
+          type: string
+          description: >
+            The current status of the Message.
+            Possible values: queued, sending, sent, failed, delivered, undelivered,
+            receiving, received, accepted, scheduled, canceled, read
+        direction:
+          type: string
+          description: >
+            The direction of the message.
+            Possible values: inbound, outbound-api, outbound-call, outbound-reply
+        date_created:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the Message resource was created
+        date_sent:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the message was sent
+        date_updated:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the Message resource was last updated
+        error_code:
+          type: string
+          description: The error code if status is failed or undelivered, otherwise null
+        error_message:
+          type: string
+          description: The description of the error_code, otherwise null
+        price:
+          type: string
+          description: The amount billed for the message in the currency of price_unit
+        price_unit:
+          type: string
+          description: The currency in which price is measured (ISO 4127 format, e.g. usd)
+        num_segments:
+          type: string
+          description: Number of SMS segments that make up the complete message
+        num_media:
+          type: string
+          description: Number of media files associated with the Message resource
+        messaging_service_sid:
+          type: string
+          description: The SID of the Messaging Service associated with this Message
+        api_version:
+          type: string
+          description: The API version used to process the Message
+        uri:
+          type: string
+          description: The URI of this Message resource, relative to https://api.twilio.com
+        subresource_uris:
+          type: object
+          description: URIs of sub-resources (media, feedback) relative to the API root
+    statusCode:
+      type: number
+      description: HTTP status code of the response
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+  retry_on_status:
+    - 429
+    - 500
+    - 503
+
+examples:
+  - name: 'Fetch an SMS message by SID'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      message_sid: SMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
+    expected_result: 'Returns full Message resource including current status, body, and timestamps'
+  - name: 'Fetch an MMS message by SID'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      message_sid: MMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
+    expected_result: 'Returns Message resource with num_media > 0 and subresource_uris.media'

matimo_twilio-0.1.0/src/matimo_twilio/tools/twilio-list-messages/definition.yaml

@@ -0,0 +1,133 @@
+name: twilio-list-messages
+version: '1.0.0'
+description: >
+  Read multiple Message resources from the Twilio Programmable Messaging API.
+  Returns a paginated list of messages in your account, sorted by DateSent
+  with the most recent messages appearing first. Supports filtering by
+  recipient (To), sender (From), and sent date.
+  See: https://www.twilio.com/docs/messaging/api/message-resource#read-multiple-message-resources
+
+parameters:
+  account_sid:
+    type: string
+    required: true
+    description: >
+      The SID of the Account associated with the Message resources.
+      Found on the Twilio Console dashboard: https://console.twilio.com
+      Pattern: ^AC[0-9a-fA-F]{32}$
+  to:
+    type: string
+    required: false
+    description: >
+      Filter by recipient phone number.
+      E.g. "+15558881111" to retrieve messages sent to that number.
+      Must be in E.164 format.
+  from:
+    type: string
+    required: false
+    description: >
+      Filter by sender phone number.
+      E.g. "+15552229999" to retrieve messages sent from that number.
+      Must be in E.164 format.
+  date_sent:
+    type: string
+    required: false
+    description: >
+      Filter by the sent date (GMT). Accepts dates in formats:
+      YYYY-MM-DD — messages with this specific sent date
+      <=YYYY-MM-DD — messages with sent_date on or before this date
+      >=YYYY-MM-DD — messages with sent_date on or after this date
+  page_size:
+    type: number
+    required: false
+    description: >
+      How many Message resources to return per page.
+      Default is 50. Maximum is 1000. Minimum is 1.
+    default: 50
+    min: 1
+    max: 1000
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.twilio.com/2010-04-01/Accounts/{account_sid}/Messages.json'
+  query_params:
+    To: '{to}'
+    From: '{from}'
+    DateSent: '{date_sent}'
+    PageSize: '{page_size}'
+  timeout: 30000
+
+authentication:
+  type: basic
+  username_env: TWILIO_ACCOUNT_SID
+  password_env: TWILIO_AUTH_TOKEN
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+      description: Whether the HTTP request was successful (2xx status)
+    data:
+      type: object
+      description: The paginated list of Message resources
+      properties:
+        messages:
+          type: array
+          description: Array of Message resource objects
+        end:
+          type: number
+          description: Index of the last record in the current page (0-based)
+        first_page_uri:
+          type: string
+          description: URI of the first page of results
+        next_page_uri:
+          type: string
+          description: URI of the next page of results (null if no more pages)
+        previous_page_uri:
+          type: string
+          description: URI of the previous page of results (null on first page)
+        page:
+          type: number
+          description: The current page index (0-based)
+        page_size:
+          type: number
+          description: The number of records per page
+        start:
+          type: number
+          description: Index of the first record in the current page (0-based)
+        uri:
+          type: string
+          description: URI of the current page of results
+    statusCode:
+      type: number
+      description: HTTP status code of the response
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+  retry_on_status:
+    - 429
+    - 500
+    - 503
+
+examples:
+  - name: 'List recent messages (default page size 50)'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+    expected_result: 'Returns up to 50 most recent messages with pagination metadata'
+  - name: 'List messages sent to a specific number'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      to: '+15558675310'
+      page_size: 20
+    expected_result: 'Returns messages filtered by recipient with pagination'
+  - name: 'List messages from a specific sender on a date'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      from: '+15557122661'
+      date_sent: '2024-01-15'
+      page_size: 10
+    expected_result: 'Returns messages sent from that number on the specified date'

matimo_twilio-0.1.0/src/matimo_twilio/tools/twilio-send-mms/definition.yaml

@@ -0,0 +1,162 @@
+name: twilio-send-mms
+version: '1.0.0'
+description: >
+  Send an outbound MMS message with one or more media files via the Twilio
+  Programmable Messaging API. Supported media types include jpeg, jpg, gif,
+  and png (up to 5 MB each), and other accepted media types up to 500 KB.
+  Up to 10 media URLs can be included per message.
+
+parameters:
+  account_sid:
+    type: string
+    required: true
+    description: >
+      Your Twilio Account SID (e.g. "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").
+      Found on the Twilio Console dashboard: https://console.twilio.com
+  to:
+    type: string
+    required: true
+    description: >
+      The recipient's phone number in E.164 format (e.g. "+15558675310").
+      Must be a valid phone number capable of receiving MMS.
+  from:
+    type: string
+    required: true
+    description: >
+      The sender's Twilio phone number in E.164 format (e.g. "+15557122661").
+      Must be a Twilio MMS-capable number that belongs to your account.
+  media_url:
+    type: string
+    required: true
+    description: >
+      The URL of a media file to include in the MMS message.
+      Fully supported types: jpeg, jpg, gif, png (up to 5 MB).
+      Other accepted types: up to 500 KB.
+      Must be a publicly accessible URL.
+  body:
+    type: string
+    required: false
+    description: >
+      Optional text content to accompany the media.
+      Can be up to 1,600 characters. Note: WhatsApp does not support
+      including a text body in the same message as video, audio, document,
+      contact, or location media types.
+  status_callback:
+    type: string
+    required: false
+    description: >
+      The URL of the endpoint to which Twilio sends Message status callback
+      requests when the Message status changes. URL must contain a valid
+      hostname and underscores are not allowed.
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.twilio.com/2010-04-01/Accounts/{account_sid}/Messages.json'
+  headers:
+    Content-Type: application/x-www-form-urlencoded
+  body:
+    To: '{to}'
+    From: '{from}'
+    MediaUrl: '{media_url}'
+    Body: '{body}'
+    StatusCallback: '{status_callback}'
+  timeout: 30000
+
+authentication:
+  type: basic
+  username_env: TWILIO_ACCOUNT_SID
+  password_env: TWILIO_AUTH_TOKEN
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+      description: Whether the HTTP request was successful (2xx status)
+    data:
+      type: object
+      description: The Twilio Message resource returned by the API
+      properties:
+        sid:
+          type: string
+          description: The unique SID identifying this Message resource (e.g. MMxxx for MMS)
+        account_sid:
+          type: string
+          description: The SID of the Account that created this Message resource
+        to:
+          type: string
+          description: The recipient's phone number in E.164 format
+        from:
+          type: string
+          description: The sender's phone number in E.164 format
+        body:
+          type: string
+          description: The text content of the message (if provided)
+        status:
+          type: string
+          description: >
+            The status of the Message. For new outbound MMS this is 'queued'.
+            Possible values: queued, sending, sent, failed, delivered, undelivered
+        direction:
+          type: string
+          description: The direction of the message (outbound-api for REST API messages)
+        date_created:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the Message resource was created
+        date_sent:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the message was sent
+        date_updated:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the Message resource was last updated
+        error_code:
+          type: string
+          description: The error code if status is failed or undelivered, otherwise null
+        error_message:
+          type: string
+          description: The description of the error_code, otherwise null
+        num_media:
+          type: string
+          description: Number of media files associated with the Message resource
+        num_segments:
+          type: string
+          description: Number of SMS segments (typically '1' for MMS)
+        messaging_service_sid:
+          type: string
+          description: The SID of the Messaging Service associated with this Message
+        uri:
+          type: string
+          description: The URI of this Message resource, relative to https://api.twilio.com
+        subresource_uris:
+          type: object
+          description: URIs of sub-resources (media, feedback) relative to the API root
+    statusCode:
+      type: number
+      description: HTTP status code of the response
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+  retry_on_status:
+    - 429
+    - 500
+    - 503
+
+examples:
+  - name: 'Send MMS with image'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      to: '+15558675310'
+      from: '+15557122661'
+      media_url: 'https://example.com/images/photo.jpg'
+      body: 'Check out this photo!'
+    expected_result: 'Returns Message resource with sid (MM...) and num_media: "1"'
+  - name: 'Send MMS with image only (no text body)'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      to: '+15558675310'
+      from: '+15557122661'
+      media_url: 'https://example.com/logo.png'
+    expected_result: 'Returns Message resource with sid and status: queued'

matimo_twilio-0.1.0/src/matimo_twilio/tools/twilio-send-sms/definition.yaml

@@ -0,0 +1,155 @@
+name: twilio-send-sms
+version: '1.0.0'
+description: >
+  Send an outbound SMS message via the Twilio Programmable Messaging API.
+  Sends a text message from a Twilio phone number to any E.164 phone number.
+  Returns a Message resource with its SID and initial status of 'queued'.
+
+parameters:
+  account_sid:
+    type: string
+    required: true
+    description: >
+      Your Twilio Account SID (e.g. "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx").
+      Found on the Twilio Console dashboard: https://console.twilio.com
+  to:
+    type: string
+    required: true
+    description: >
+      The recipient's phone number in E.164 format (e.g. "+15558675310").
+      Must be a valid phone number reachable via SMS.
+  from:
+    type: string
+    required: true
+    description: >
+      The sender's Twilio phone number in E.164 format (e.g. "+15557122661").
+      Must be a Twilio number or short code that belongs to your account.
+  body:
+    type: string
+    required: true
+    description: >
+      The text content of the outgoing SMS message.
+      Can be up to 1,600 characters. Bodies exceeding 160 GSM-7 characters
+      are segmented and each segment is charged separately.
+  status_callback:
+    type: string
+    required: false
+    description: >
+      The URL of the endpoint to which Twilio sends Message status callback
+      requests when the Message status changes. URL must contain a valid
+      hostname and underscores are not allowed.
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.twilio.com/2010-04-01/Accounts/{account_sid}/Messages.json'
+  headers:
+    Content-Type: application/x-www-form-urlencoded
+  body:
+    To: '{to}'
+    From: '{from}'
+    Body: '{body}'
+    StatusCallback: '{status_callback}'
+  timeout: 30000
+
+authentication:
+  type: basic
+  username_env: TWILIO_ACCOUNT_SID
+  password_env: TWILIO_AUTH_TOKEN
+
+output_schema:
+  type: object
+  properties:
+    success:
+      type: boolean
+      description: Whether the HTTP request was successful (2xx status)
+    data:
+      type: object
+      description: The Twilio Message resource returned by the API
+      properties:
+        sid:
+          type: string
+          description: The unique SID identifying this Message resource (e.g. SMxxx)
+        account_sid:
+          type: string
+          description: The SID of the Account that created this Message resource
+        to:
+          type: string
+          description: The recipient's phone number in E.164 format
+        from:
+          type: string
+          description: The sender's phone number in E.164 format
+        body:
+          type: string
+          description: The text content of the message
+        status:
+          type: string
+          description: >
+            The status of the Message. For new outbound messages this is 'queued'.
+            Possible values: queued, sending, sent, failed, delivered, undelivered
+        direction:
+          type: string
+          description: The direction of the message (outbound-api for REST API messages)
+        date_created:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the Message resource was created
+        date_sent:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the message was sent
+        date_updated:
+          type: string
+          description: The RFC 2822 timestamp (GMT) when the Message resource was last updated
+        error_code:
+          type: string
+          description: The error code if status is failed or undelivered, otherwise null
+        error_message:
+          type: string
+          description: The description of the error_code, otherwise null
+        num_segments:
+          type: string
+          description: Number of SMS segments the message body comprises
+        num_media:
+          type: string
+          description: Number of media files associated with the Message resource
+        messaging_service_sid:
+          type: string
+          description: The SID of the Messaging Service associated with this Message
+        uri:
+          type: string
+          description: The URI of this Message resource, relative to https://api.twilio.com
+    statusCode:
+      type: number
+      description: HTTP status code of the response
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 500
+  retry_on_status:
+    - 429
+    - 500
+    - 503
+
+examples:
+  - name: 'Send a simple SMS'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      to: '+15558675310'
+      from: '+15557122661'
+      body: 'Hello from Matimo!'
+    expected_result: 'Returns Message resource with sid and status: queued'
+  - name: 'Send SMS with delivery callback'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      to: '+15558675310'
+      from: '+15557122661'
+      body: 'Your order has shipped!'
+      status_callback: 'https://your-app.com/twilio/status'
+    expected_result: 'Returns Message resource; Twilio POSTs status updates to the callback URL'
+  - name: 'Send long SMS (multi-segment)'
+    params:
+      account_sid: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      to: '+15558675310'
+      from: '+15557122661'
+      body: 'This is a long message that exceeds 160 GSM-7 characters. It will be split into multiple segments and each segment will be charged accordingly. Make sure your Twilio account has sufficient balance.'
+    expected_result: 'Returns Message resource with num_segments > 1'