Enhance README.md with Client SDKs section for Python and Node.js; add SDK Usage Guide link. Update GitHub Actions workflows for Node.js and Python SDKs to support manual triggering via workflow_dispatch.

Author: DMontgomery40

.github/workflows/sdk-node.yml

@@ -25,7 +25,7 @@ jobs:
 
   publish:
     needs: build-test
-    if: github.event_name == 'release' && github.event.action == 'published'
+    if: (github.event_name == 'release' && github.event.action == 'published') || github.event_name == 'workflow_dispatch'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

.github/workflows/sdk-python.yml

@@ -29,7 +29,7 @@ jobs:
 
   publish:
     needs: build-test
-    if: github.event_name == 'release' && github.event.action == 'published'
+    if: (github.event_name == 'release' && github.event.action == 'published') || github.event_name == 'workflow_dispatch'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

README.md

@@ -25,6 +25,12 @@ Simple fax-sending API with AI integration. Choose your backend:
 
 - Quick start: use the scripts in `api/scripts` (`start-mcp.sh`, `start-mcp-http.sh`) or `make mcp-stdio` / `make mcp-http`.
 
+## Client SDKs
+- Python: `pip install faxbot`
+- Node.js: `npm install faxbot`
+
+[→ SDK Usage Guide](docs/SDKS.md)
+
 ## Documentation
 - [API Reference](docs/API_REFERENCE.md) — Endpoints and examples
 - [Troubleshooting](docs/TROUBLESHOOTING.md) — Common issues

docs/SDKS.md

@@ -0,0 +1,59 @@
+# Client SDKs
+
+Thin, official clients for the Faxbot API. They call the unified Faxbot REST API (no direct Phaxio/Asterisk calls).
+
+- Python: `faxbot`
+- Node.js: `faxbot`
+
+## Python
+- Install:
+```
+pip install faxbot
+```
+- Usage:
+```python
+from faxbot import FaxbotClient
+
+client = FaxbotClient(base_url="http://localhost:8080", api_key="YOUR_API_KEY")
+job = client.send_fax("+15551234567", "/path/to/document.pdf")
+print("Queued:", job["id"], job["status"])
+status = client.get_status(job["id"])
+print("Status:", status["status"]) 
+```
+- Notes:
+  - Only `.pdf` and `.txt` files are accepted.
+  - If `API_KEY` is enabled on the server, the client sends it via `X-API-Key`.
+  - Optional: `check_health()` calls `/health`.
+
+## Node.js
+- Install:
+```
+npm install faxbot
+```
+- Usage:
+```js
+const FaxbotClient = require('faxbot');
+const client = new FaxbotClient('http://localhost:8080', 'YOUR_API_KEY');
+
+(async () => {
+  const job = await client.sendFax('+15551234567', '/path/to/document.pdf');
+  console.log('Queued:', job.id, job.status);
+  const status = await client.getStatus(job.id);
+  console.log('Status:', status.status);
+})();
+```
+- Notes:
+  - Only `.pdf` and `.txt` files are accepted.
+  - If `API_KEY` is enabled, `X-API-Key` header is added automatically.
+  - Optional: `checkHealth()` calls `/health`.
+
+## Errors
+- The SDKs raise/throw on non-2xx responses. Common cases:
+  - 400: invalid phone number or parameters
+  - 401: missing/invalid API key
+  - 413: file too large
+  - 415: unsupported media type (non-PDF/TXT)
+  - 404: job not found (for GET /fax/{id})
+
+## Compatibility
+- The SDKs work regardless of backend (Phaxio cloud or SIP/Asterisk) because Faxbot abstracts the difference.