jambonz-python-sdk 0.2.0__py3-none-any.whl

jambonz_python_sdk-0.2.0.dist-info/METADATA

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: jambonz-python-sdk
+Version: 0.2.0
+Summary: Python SDK for jambonz CPaaS platform
+Project-URL: Homepage, https://github.com/jambonz/jambonz-python-sdk
+Project-URL: Repository, https://github.com/jambonz/jambonz-python-sdk
+Project-URL: Issues, https://github.com/jambonz/jambonz-python-sdk/issues
+Project-URL: Documentation, https://jambonz.org
+License-Expression: MIT
+Keywords: cpaas,jambonz,sip,telephony,voip,websocket
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Telephony
+Requires-Python: >=3.10
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: jsonschema>=4.20
+Requires-Dist: referencing>=0.31
+Requires-Dist: typing-extensions>=4.0; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: aioresponses>=0.7; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# jambonz Python SDK
+
+Python SDK for the [jambonz](https://jambonz.org) CPaaS platform.
+
+## Installation
+
+```bash
+pip install jambonz-python-sdk
+```
+
+## Quick Start
+
+### Webhook (HTTP)
+
+```python
+from aiohttp import web
+from jambonz_sdk.webhook import WebhookResponse
+
+async def handle_incoming(request: web.Request) -> web.Response:
+    jambonz = WebhookResponse()
+    jambonz.say(text="Hello!").gather(
+        input=["speech"],
+        actionHook="/handle-input",
+        timeout=10,
+        say={"text": "Please say something."},
+    ).hangup()
+    return web.json_response(jambonz.to_json())
+
+app = web.Application()
+app.router.add_post("/incoming", handle_incoming)
+web.run_app(app, port=3000)
+```
+
+### WebSocket
+
+```python
+import asyncio
+from jambonz_sdk.websocket import create_endpoint
+
+async def main():
+    make_service, runner = await create_endpoint(port=3000)
+    svc = make_service(path="/")
+
+    async def handle_session(session):
+        session.say(text="Hello!").hangup()
+        await session.send()
+
+    svc.on("session:new", handle_session)
+    await asyncio.Future()
+
+asyncio.run(main())
+```
+
+### REST Client
+
+```python
+from jambonz_sdk.client import JambonzClient
+
+async with JambonzClient(
+    base_url="https://api.jambonz.us",
+    account_sid="your-account-sid",
+    api_key="your-api-key",
+) as client:
+    call_sid = await client.calls.create({
+        "from": "+15085551212",
+        "to": {"type": "phone", "number": "+15085551213"},
+        "call_hook": "/incoming",
+    })
+```
+
+## How It Works
+
+### Spec-driven verb generation
+
+The SDK does **not** hardcode verb method signatures. Instead, verb methods (`.say()`, `.gather()`, `.dial()`, `.pipeline()`, etc.) are **auto-generated at import time** from [JSON Schema](https://github.com/jambonz/schema) files — the same schemas used by the Node.js SDK and the jambonz server.
+
+**What this means:**
+
+- When the schema adds a new property to a verb, the SDK picks it up automatically — no code change needed
+- Every method has **real typed parameters** (not `**kwargs: Any`) so IDEs show autocomplete and type hints
+- Verb synonyms (`stream` ↔ `listen`, `openai_s2s` → `llm` with `vendor: "openai"`) are handled by the registry
+
+### Updating the schema
+
+```bash
+# Download the pinned version from @jambonz/schema:
+python scripts/sync_schema.py
+
+# Or copy from a local clone:
+python scripts/sync_schema.py --local /path/to/schema
+```
+
+If a **new verb** was added (not just new properties), add one line to `verb_registry.py`:
+
+```python
+VerbDef("new_verb", "new_verb", doc="Description.")
+```
+
+## Features
+
+- **All 31 jambonz verbs**: say, play, gather, dial, conference, enqueue/dequeue, hangup, pause, redirect, config, tag, dtmf, dub, message, alert, answer, leave, listen/stream, transcribe, openai_s2s, google_s2s, deepgram_s2s, elevenlabs_s2s, ultravox_s2s, s2s, llm, dialogflow, pipeline, sip_decline, sip_request, sip_refer
+- **Fluent chainable API**: `.say(...).gather(...).hangup()`
+- **Webhook transport**: `WebhookResponse` for HTTP apps (works with aiohttp, FastAPI, Flask, etc.)
+- **WebSocket transport**: `create_endpoint` with `Session`, event handling, `send()`/`reply()`
+- **REST client**: `JambonzClient` with calls, conferences, queues, mid-call control
+- **Audio streaming**: Bidirectional audio via `AudioStream`
+- **Mid-call control**: inject commands (mute, whisper, record, DTMF, tag)
+- **TTS token streaming**: `send_tts_tokens()` / `flush_tts_tokens()`
+- **Pipeline updates**: `update_pipeline()` for mid-conversation LLM changes
+- **Signature verification**: HMAC-SHA256 webhook signature validation
+- **Env vars**: Portal discovery via OPTIONS + runtime reading
+
+## Examples
+
+See the [`examples/`](examples/) directory:
+
+| Example | Webhook | WebSocket | Description |
+|---------|---------|-----------|-------------|
+| hello-world | [webhook](examples/hello-world/webhook_app.py) | [websocket](examples/hello-world/websocket_app.py) | Minimal greeting |
+| echo | [webhook](examples/echo/webhook_app.py) | [websocket](examples/echo/websocket_app.py) | Speech echo with gather |
+| ivr-menu | [webhook](examples/ivr-menu/webhook_app.py) | — | IVR menu with speech + DTMF |
+| voice-agent | [webhook](examples/voice-agent/webhook_app.py) | [websocket](examples/voice-agent/websocket_app.py) | LLM pipeline with tool calls |
+| dial | [webhook](examples/dial/webhook_app.py) | — | Outbound dial with fallback |
+| listen-record | [webhook](examples/listen-record/webhook_app.py) | [websocket](examples/listen-record/websocket_app.py) | Audio recording |
+
+## Development
+
+```bash
+# Create venv and install
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/unit/          # Fast unit tests (253)
+pytest tests/integration/   # Real server tests (26)
+pytest                      # All 279 tests
+
+# Sync schema from upstream
+python scripts/sync_schema.py
+```
+
+## License
+
+MIT

jambonz_python_sdk-0.2.0.dist-info/RECORD

@@ -0,0 +1,119 @@
+jambonz_sdk/__init__.py,sha256=FhooW-LiVUck04Iz_lEY0_LCxfsZo1TPpafaZuKoVQ8,1391
+jambonz_sdk/_signature.py,sha256=3sy95S310ALrTX2_2w3xH5KLBPKYacy08dpYOxu39i8,2007
+jambonz_sdk/validator.py,sha256=A5nXjeF8BguHwpzmHpkjch4Pw__I4DOVp9qmwfgk7F0,3770
+jambonz_sdk/verb_builder.py,sha256=xI1MWPBB0S0PshCJTeRqmSR7FYKdH5QQVCc1IltuCG8,10899
+jambonz_sdk/verb_builder.pyi,sha256=4fgGI-FbFkrE4yyKkCHn7U0KSBJ0HM5kF86UyobGyps,30730
+jambonz_sdk/verb_registry.py,sha256=QNfFpUW_7mcS3pf_35oSHEAfwF7FVBCcpD3QObxki_s,4953
+jambonz_sdk/client/__init__.py,sha256=0EpEk8feWsFOw54cqpe7aMF7ZrHm4BGnTA9Qtg0Id6w,273
+jambonz_sdk/client/api.py,sha256=aN-nQ6BqEiuLKe_jbIu0JjVMSZe2ZPlFYvsJg8vehZI,7442
+jambonz_sdk/schema/jambonz-app.schema.json,sha256=CaOPh8VIlNzwJmBe33Hrki46Efz5_wrEpSYwoCClDQE,4332
+jambonz_sdk/schema/callbacks/amd.schema.json,sha256=2XvGFxiTuQ2kYY0LernYqmTjVEftfx3sek4Sjq5vSnA,1953
+jambonz_sdk/schema/callbacks/base.schema.json,sha256=G0l-doDap-xZypHXZC3ectVK36Z6SHs_iXj5mKxYWYw,1958
+jambonz_sdk/schema/callbacks/call-status.schema.json,sha256=PtPWkRygCdYsP60096stOXrwEbiqvPV9YGvEzpx2XeM,1127
+jambonz_sdk/schema/callbacks/conference-status.schema.json,sha256=YZ-kpaSZMjk1qYZ-CS13NxBNJuJ88i1xElm9s8Dz6KM,1194
+jambonz_sdk/schema/callbacks/conference-wait.schema.json,sha256=IMEBBxFxQUgHf42i9hp2j0an-j24U4D_EJ1eQ1DNJwk,477
+jambonz_sdk/schema/callbacks/conference.schema.json,sha256=mOdI63zITfGRDT-j_bvwKSTgi8AQ2zdf3Fc7YXEzaiY,416
+jambonz_sdk/schema/callbacks/dequeue.schema.json,sha256=s65QvBPCZZ9KeOVlJWJUjZLGIgVnNA4f6p_UwgYwOx4,695
+jambonz_sdk/schema/callbacks/dial-dtmf.schema.json,sha256=mfglBf1cGLz8hFdM7N-O74lxIab08akLku_d680iysM,570
+jambonz_sdk/schema/callbacks/dial-hold.schema.json,sha256=KNUZpiTNLm_XuZI-p7fy1oym9_BcsZ_DrBB1V-Ikgow,828
+jambonz_sdk/schema/callbacks/dial-refer.schema.json,sha256=m__lzLCBzOWLnzyX1Lxuvz3YuAQ2ARxFKCtAfDprOCg,1538
+jambonz_sdk/schema/callbacks/dial.schema.json,sha256=y_3xmAiAMrpG2cadOGqdWdCyw_aWggpF7HLeWBBpObE,1110
+jambonz_sdk/schema/callbacks/enqueue-wait.schema.json,sha256=Gl_BdbW3VpKKF2iRmzT8dgdZUUmqMxCrf2Mp8d2aOZg,1207
+jambonz_sdk/schema/callbacks/enqueue.schema.json,sha256=uGDOHoLZNnfuFb0Dx27YD7GK5ky4iWvlPSps_u5_Sv4,1129
+jambonz_sdk/schema/callbacks/gather-partial.schema.json,sha256=TNmfDqBmWFLJYPTJBS8wf1eoVQ_6bLB4A6jbdUeJDAY,3377
+jambonz_sdk/schema/callbacks/gather.schema.json,sha256=EKApuYTHV_sBcrpGnpR4y5GvYotrJm5M4BIvIUsMZs4,2601
+jambonz_sdk/schema/callbacks/listen.schema.json,sha256=D8_J7MDBhNwEn3nwRHWXkZIsHb0ap2vY2ehfOAI4Vio,686
+jambonz_sdk/schema/callbacks/llm.schema.json,sha256=anXe9QD0X_8pSo_NAj_TJEfKpPNdAfFJQTUOI-Y3ZL4,976
+jambonz_sdk/schema/callbacks/message.schema.json,sha256=t2nO4Gb1bXi9JtA4NwVeFudOFzbyEbnOrGDCFhRxM44,1245
+jambonz_sdk/schema/callbacks/pipeline-turn.schema.json,sha256=1OBaA255zj3Ug0tqtfoWCVNsNcRSinKPDcSNEiBNQ04,4514
+jambonz_sdk/schema/callbacks/play.schema.json,sha256=XpyFUlE1ywhfNmHu-q_KrvQl4jwJqxHQBCIPT9eCrGs,1253
+jambonz_sdk/schema/callbacks/session-new.schema.json,sha256=ENqyXSu6lKb6uOE_xup3xctjjKjKV-lvWRpw1yfnj50,5429
+jambonz_sdk/schema/callbacks/session-reconnect.schema.json,sha256=dMyK4dkahnXVCPg5hAQtsZxb3E8gXKRJ8dkROYMPC-4,538
+jambonz_sdk/schema/callbacks/session-redirect.schema.json,sha256=Xvz7i7R8YjX_J0Zkv_Ovy9KHJ0kcrETRTMgDJRpvcvs,1398
+jambonz_sdk/schema/callbacks/sip-refer-event.schema.json,sha256=rs4AkEVm_zi1SyyCIv94l3uDLwSlZnD_pp-ejmj56z0,751
+jambonz_sdk/schema/callbacks/sip-refer.schema.json,sha256=oGa7Xg8f8aP0gaRfpM0MrlNIuU203ehP9dlWQ5xLkn0,887
+jambonz_sdk/schema/callbacks/sip-request.schema.json,sha256=e0PWYRUwJR-TWYFU7WeI0E7DgfHDRZJTH-gbb_CLAhw,858
+jambonz_sdk/schema/callbacks/transcribe-translation.schema.json,sha256=eRn6eqDuADy0NrcbKX6YmlSS6dVJpR8J0_mj4Ef4hQE,891
+jambonz_sdk/schema/callbacks/transcribe.schema.json,sha256=8-8t7MIpEtpM0ZkdNIZeh820N8jFVAaCFgv-fs41Mmk,2130
+jambonz_sdk/schema/callbacks/tts-streaming-event.schema.json,sha256=yAY-RIoXWm2NhDxuX8JB3OPEktxlBoRAjVjdFN4WmTM,2570
+jambonz_sdk/schema/callbacks/verb-status.schema.json,sha256=PwetY3q0WK8u6rKc3G3ozbDG4Cb6_P0w3HbitjSTg_w,2039
+jambonz_sdk/schema/components/actionHook.schema.json,sha256=cteHhGPzvNfGNJVKWkwdkxbFT6Ph2xDC84_6TwFN1kM,1796
+jambonz_sdk/schema/components/actionHookDelayAction.schema.json,sha256=w3gSk0aUDWWJ8XDMxDl55BYWOmtUV8nP3XRV2Ud9m2o,1722
+jambonz_sdk/schema/components/amd.schema.json,sha256=-WjQJMPqIKbw-za9_BkcwCfYPoQ2nB7LZ1JlSeNDfvc,2863
+jambonz_sdk/schema/components/auth.schema.json,sha256=oqTJ4oKUINFF2kHRARmITSI5C49dTICSVqdizIrv7ek,578
+jambonz_sdk/schema/components/bidirectionalAudio.schema.json,sha256=o9-p_I6ZwcK5ckUpTE7U68yN1tiW3nJSSMvKxu4bf7o,861
+jambonz_sdk/schema/components/fillerNoise.schema.json,sha256=KuNzxDDKgKnlVBiqrJjSyM83wpCEC3Pu8swDYjrR9jE,1054
+jambonz_sdk/schema/components/llm-base.schema.json,sha256=yC5LSVNTbjM_7FF-Jit65J5zF3pa_5ILkwim-zJXlZY,3436
+jambonz_sdk/schema/components/recognizer-assemblyAiOptions.schema.json,sha256=JfjDNUoUOSzX5WD4cKXAAJVrQ-Pv1g29dMzdAwamO7k,2119
+jambonz_sdk/schema/components/recognizer-awsOptions.schema.json,sha256=Z7adtaaVgHjjz3lx6gXghwxZXHQwu36HDADu9tMhS-I,1660
+jambonz_sdk/schema/components/recognizer-azureOptions.schema.json,sha256=r8WNOEuPyan9kVCaRLJ8ycxOwzgQ3s4Kcsb8fd96kJk,1144
+jambonz_sdk/schema/components/recognizer-cobaltOptions.schema.json,sha256=rLbrKh3Cr_LRy8fAPUOpEg7i2dHxtZStqwoumsdeo8I,1031
+jambonz_sdk/schema/components/recognizer-customOptions.schema.json,sha256=1mLPULdn9zGouockiymNoaZwcBtrtG8BBL08rHHdtJY,864
+jambonz_sdk/schema/components/recognizer-deepgramOptions.schema.json,sha256=JygJcdKOXpBDp6nPCq4H8H8pdlSGtC9gzUhuVuClMy8,4385
+jambonz_sdk/schema/components/recognizer-elevenlabsOptions.schema.json,sha256=JriyGgBWSKaStxAJB4LIcFYnWZE-6Diy3XPncWZgmRY,1333
+jambonz_sdk/schema/components/recognizer-gladiaOptions.schema.json,sha256=6Sk_xWl1tB5qTAptKSYPjZJyGG0jK-A0QlmswSSo9YQ,382
+jambonz_sdk/schema/components/recognizer-googleOptions.schema.json,sha256=qIygKgsRnZjW9oZ5i1vA2nSrfEwGk9Wvrl4bJ3mrprk,1158
+jambonz_sdk/schema/components/recognizer-houndifyOptions.schema.json,sha256=EOTFZZTvRZlgr42mHWtn8_c9st0Vw_azYbXwMQbM8YM,3598
+jambonz_sdk/schema/components/recognizer-ibmOptions.schema.json,sha256=0lLxVUYA9735PMi7ZRgjVO4EvoERh54vd9AyK-GtEt0,1555
+jambonz_sdk/schema/components/recognizer-nuanceOptions.schema.json,sha256=PSbtOPUy-FryOY5O0HA03ZSAUAF1mVoS-8RXF2NDaqY,5077
+jambonz_sdk/schema/components/recognizer-nvidiaOptions.schema.json,sha256=AAvwTy5iSrMEw-qoCFmxQPQ_tX4ewk88R4ncphDbDgE,1182
+jambonz_sdk/schema/components/recognizer-openaiOptions.schema.json,sha256=L9H8_0hm5AElpiO6doigMbMSqp8ZDL_rq1xu51J5Syw,2237
+jambonz_sdk/schema/components/recognizer-sonioxOptions.schema.json,sha256=HkMiX5Ul4b4W0Lz4APle5UgKKwefPZ5rehcCUg96pqU,1686
+jambonz_sdk/schema/components/recognizer-speechmaticsOptions.schema.json,sha256=0q6ycpeTSFjc-cd0bBZyJCB2sw82633TXU7EmITIECA,3642
+jambonz_sdk/schema/components/recognizer-verbioOptions.schema.json,sha256=gq64hfKwf56iF-MmpSaeZZjcfP5A1gGdIgLHauCa0xg,1438
+jambonz_sdk/schema/components/recognizer.schema.json,sha256=M0RZFvNHsedZ7TVjKGen49hwutZv5lzIG5_1HK8up9c,9073
+jambonz_sdk/schema/components/synthesizer.schema.json,sha256=-MiCdHn1N7ZXUokhGJU0dc3cc0zRhlOsAuOIltKmJPk,3302
+jambonz_sdk/schema/components/target.schema.json,sha256=zBEvVYZIzMWexip2W_yvWn44dcc3pnWlLDDCQPN_Mmk,3473
+jambonz_sdk/schema/components/vad.schema.json,sha256=IFgTWDImRoa2EctcvKSYB5iyDlXpUXNhAu8ldGPyn00,1869
+jambonz_sdk/schema/verbs/alert.schema.json,sha256=bwV5K_8aT4RkJyd8kk5zqrAONEKtsDr0ieLqaC3tIGU,911
+jambonz_sdk/schema/verbs/answer.schema.json,sha256=m7M3bsuwr0zwcatjgQeD4YSluWJeliAvT7ZNleB6a2E,690
+jambonz_sdk/schema/verbs/conference.schema.json,sha256=hwtyuHNN5hAspCN7rL4CueNU8VySVSnBhFI6vpnhBV0,3798
+jambonz_sdk/schema/verbs/config.schema.json,sha256=V1nSs2p_9Z_e1bhFHNPuBV6XXP8WeWyXpdml6cYtyt0,7109
+jambonz_sdk/schema/verbs/deepgram_s2s.schema.json,sha256=xqcCwNZGeNrSCauRIiZ22re1IavS2y311p69DwACqkk,2284
+jambonz_sdk/schema/verbs/dequeue.schema.json,sha256=-h1RdRKQsMqa9WeX0mbe7fSJd3GQ7uZ9p0A7AErg6Zs,1407
+jambonz_sdk/schema/verbs/dial.schema.json,sha256=-khc5zsn-oP-p5qEr2fIKYzRITqs48IrO45MIYWzF9Y,7266
+jambonz_sdk/schema/verbs/dialogflow.schema.json,sha256=aLoZ_wru_ZR2-rBN7MvkjbWSMyFKKgEPJZNsT-nDRNU,4416
+jambonz_sdk/schema/verbs/dtmf.schema.json,sha256=2gwOII-xdbfwDnKE09Ds-D1bhQPIiHchCy6714ke91U,1147
+jambonz_sdk/schema/verbs/dub.schema.json,sha256=ECEg6hOq_WigemwwDpl1WXsqf_JgqBrSbnPQZJO-Azc,2521
+jambonz_sdk/schema/verbs/elevenlabs_s2s.schema.json,sha256=8gZT2yiqngY2nEqOKH1I0dqxjHnqwpl90SVc-0ndkuA,2508
+jambonz_sdk/schema/verbs/enqueue.schema.json,sha256=xTLo7LNm8o8w-jNuBQJw83RNHV5AJN6wkDbT5INvS5c,1767
+jambonz_sdk/schema/verbs/gather.schema.json,sha256=ee9KndAfUzGovbgZYc8j9Jhwn_Bj-oFsXq7WlPWNFsg,6181
+jambonz_sdk/schema/verbs/google_s2s.schema.json,sha256=XPuLP0Py0mwCnggfbKQq_sFyvqIjdidPchFG-kY3xUw,1035
+jambonz_sdk/schema/verbs/hangup.schema.json,sha256=QGoorQDijZpF9B9npjXQazfDxCnD50PshI4awEaNKV8,888
+jambonz_sdk/schema/verbs/leave.schema.json,sha256=Iwy8Qe7qZGFNnW9bTmBTR7mySEXd3Kc-JshEB9XI7M0,574
+jambonz_sdk/schema/verbs/listen.schema.json,sha256=azmsc5sQxTdTLTCYPbouXh_E6y1e2QcWLPPfx0WAgqM,4061
+jambonz_sdk/schema/verbs/llm.schema.json,sha256=9jCYQxeLVaWVarKal3Zu2ajy3yOQ6LzqEv0H5jO_X6k,1234
+jambonz_sdk/schema/verbs/message.schema.json,sha256=FNygt6xo_ff0EyOzqrOD0NVG7Df7ZyjvwLfRAyW8Ua0,2233
+jambonz_sdk/schema/verbs/openai_s2s.schema.json,sha256=nWYihUfihZQg6azl-PKb9caLNfKNPPb22MyLK2h2Hns,1035
+jambonz_sdk/schema/verbs/pause.schema.json,sha256=m-lgem141QCFcR9x1HEntDrV_IRwWsdVkP3z84Bjj3M,837
+jambonz_sdk/schema/verbs/pipeline.schema.json,sha256=ilniLadTkJLjW8eW0aXCHd5V8RJwXY8bCNIq4HQLe6A,8867
+jambonz_sdk/schema/verbs/play.schema.json,sha256=uf4k54-iuH1p7ctQsiKd5BKVTiy2aHNa3OCJnr-TpU0,2442
+jambonz_sdk/schema/verbs/redirect.schema.json,sha256=8HxGjFA0mbJKcl8ZsyiD9b0edOzxkp1dVsA962z7lWI,1085
+jambonz_sdk/schema/verbs/rest_dial.schema.json,sha256=K913G1pLVAxx4msjf2We7V3RGVEvyNWbeTRSmpJ3mEM,2841
+jambonz_sdk/schema/verbs/s2s.schema.json,sha256=YPMjwPfq_VfQOtQscBIKFaK0OHiDw1LH8j5GxSJnGpw,912
+jambonz_sdk/schema/verbs/say.schema.json,sha256=0Mhaw3DgvIylFJn8v6weO07wKzsgBHNueEXouEyBTtk,3521
+jambonz_sdk/schema/verbs/sip-decline.schema.json,sha256=10iWST4JIwGrT1yP758YnEaijPyt-A7i-1Rg6yYJUd0,1404
+jambonz_sdk/schema/verbs/sip-refer.schema.json,sha256=ogvdMtq8oP452SzR0lw0x-jmPkRtaUmiHa-4FY-GMlw,1720
+jambonz_sdk/schema/verbs/sip-request.schema.json,sha256=czrONgdLCErVpV5wHw_i4YZyqyIgD1GeiVrgswKsBvw,1430
+jambonz_sdk/schema/verbs/stream.schema.json,sha256=Xs3H3GSfdgul-spNREGKOyEiIofvFW6mIhRKjGsrGTg,2930
+jambonz_sdk/schema/verbs/tag.schema.json,sha256=VKzVKh-YOwJxnLFrj9nFBzV0JFc7MyYzmOnjnzJ3KwA,1153
+jambonz_sdk/schema/verbs/transcribe.schema.json,sha256=5cM1CYcdo-rFCE5wRDIqFtpEOf4v4BZs-yLjZc37tSE,1851
+jambonz_sdk/schema/verbs/ultravox_s2s.schema.json,sha256=5QpPMgfQq3RTzWve3U6fKeZPst5oUGYO1n7OfiKWPl0,1017
+jambonz_sdk/types/__init__.py,sha256=o0dkleGg8jqvORhD_mXumuos-NPisyu_CwTa-XG7kUQ,2428
+jambonz_sdk/types/components.py,sha256=QHykPAfdDrlgmedmJykPUU5QZwi8ZiFbQkdgnumBmQk,5745
+jambonz_sdk/types/rest.py,sha256=CFX0J-deBMoG8oXtoJzFIRBBKbjTULaUOnsV-mx09i8,1206
+jambonz_sdk/types/session.py,sha256=kl2lv9z0aCfq9nD5nFzqRjVjVDeAERA_c9U4HUzqEQA,1305
+jambonz_sdk/types/verbs.py,sha256=cOirvlP8gYnNK_JGjJ2FAdcMweZB3N9_4U3tv2vjqU8,12129
+jambonz_sdk/webhook/__init__.py,sha256=JU-KEgTFn1uj8CPFKhFF_fUuwfElDR3hcv6nyK8tt9E,307
+jambonz_sdk/webhook/middleware.py,sha256=8FuqDRJe6bOFLinU-_hTJCD_tOPxIMp2iHs4tY1SAqo,1931
+jambonz_sdk/webhook/response.py,sha256=yL1JE-VjCfU2RPERA4-dl73iYqS9qQYMw2rAZyG80zE,1325
+jambonz_sdk/websocket/__init__.py,sha256=13Xlg8FUF8BuVEqp7TtfNS9mfJR7ooQWtST-1g7ypNo,425
+jambonz_sdk/websocket/audio_client.py,sha256=fjJH7XK0jCX8WR0mnn00oQPs9uqvp9jYq1azAyva3pQ,369
+jambonz_sdk/websocket/audio_stream.py,sha256=JmkxP2oEpq0sA0jsuCp2I7g2Ai4PouC0H27mucnRXi4,5471
+jambonz_sdk/websocket/client.py,sha256=HMlcZoOVzYH0pQY54pPgv7J063nKT-95ZJ2Y3u3hvsA,6324
+jambonz_sdk/websocket/endpoint.py,sha256=yDwfIdVP-JKovUdHOzA_mFO_hsd3jh-sNtDaOnQqMIA,6394
+jambonz_sdk/websocket/router.py,sha256=n04A-rJ3rQrLm3bcKLBB67Niu6PRPa-zDomyY4Uboj4,2879
+jambonz_sdk/websocket/session.py,sha256=0Ooztm_Pqs2uYTbDZvswrRKi1ZFixaoDAVd7ML5pMg8,9248
+jambonz_python_sdk-0.2.0.dist-info/METADATA,sha256=lUR1pYfQ0cMrYUJSglGRQyDYYRDdNHy7zNqF3YvfNc4,6367
+jambonz_python_sdk-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+jambonz_python_sdk-0.2.0.dist-info/RECORD,,

jambonz_python_sdk-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

jambonz_sdk/__init__.py

@@ -0,0 +1,52 @@
+"""jambonz Python SDK.
+
+A Python SDK for the jambonz CPaaS platform, providing:
+
+- **Webhook**: HTTP transport for building jambonz voice apps
+- **WebSocket**: Persistent connection transport for real-time voice AI
+- **Client**: REST API client for call control and management
+
+Quick start (webhook)::
+
+    from jambonz_sdk.webhook import WebhookResponse
+
+    jambonz = WebhookResponse()
+    jambonz.say(text="Hello!").hangup()
+    response_body = jambonz.to_json()
+
+Quick start (websocket)::
+
+    from jambonz_sdk.websocket import create_endpoint
+
+    make_service, server = await create_endpoint(port=3000)
+    svc = make_service(path="/")
+
+    def handle_session(session):
+        session.say(text="Hello!").hangup()
+        await session.send()
+
+    svc.on("session:new", handle_session)
+
+Quick start (REST client)::
+
+    from jambonz_sdk.client import JambonzClient
+
+    async with JambonzClient(base_url=url, account_sid=sid, api_key=key) as client:
+        call_sid = await client.calls.create({...})
+"""
+
+__version__ = "0.1.0"
+
+# Re-export main classes for convenience
+from jambonz_sdk.client import JambonzClient
+from jambonz_sdk.validator import JambonzValidator
+from jambonz_sdk.verb_builder import VerbBuilder
+from jambonz_sdk.webhook import WebhookResponse
+
+__all__ = [
+    "JambonzClient",
+    "JambonzValidator",
+    "VerbBuilder",
+    "WebhookResponse",
+    "__version__",
+]

jambonz_sdk/_signature.py

@@ -0,0 +1,73 @@
+"""HMAC-SHA256 webhook signature verification.
+
+jambonz signs webhook requests with the header:
+    Jambonz-Signature: t=<timestamp>,v1=<signature>
+
+The signature is computed as:
+    HMAC-SHA256(secret, timestamp + "." + raw_body)
+"""
+
+from __future__ import annotations
+
+import hashlib
+import hmac
+import time
+
+DEFAULT_TOLERANCE = 300  # 5 minutes
+
+
+def verify_signature(
+    payload: bytes,
+    signature_header: str,
+    secret: str,
+    tolerance: int = DEFAULT_TOLERANCE,
+) -> bool:
+    """Verify a jambonz webhook signature.
+
+    Args:
+        payload: Raw request body bytes.
+        signature_header: Value of the ``Jambonz-Signature`` header.
+        secret: The webhook signing secret.
+        tolerance: Maximum age in seconds for the timestamp (default 300).
+
+    Returns:
+        True if the signature is valid.
+
+    Raises:
+        ValueError: If the signature header is malformed, the signature
+            doesn't match, or the timestamp is outside the tolerance window.
+    """
+    parts: dict[str, str] = {}
+    for item in signature_header.split(","):
+        key, _, value = item.strip().partition("=")
+        parts[key] = value
+
+    timestamp_str = parts.get("t")
+    sig = parts.get("v1")
+
+    if not timestamp_str or not sig:
+        raise ValueError("Invalid Jambonz-Signature header format")
+
+    try:
+        timestamp = int(timestamp_str)
+    except (ValueError, TypeError) as exc:
+        raise ValueError("Invalid timestamp in Jambonz-Signature header") from exc
+
+    if tolerance > 0:
+        age = int(time.time()) - timestamp
+        if age > tolerance:
+            raise ValueError(
+                f"Signature timestamp too old: {age}s > {tolerance}s tolerance"
+            )
+
+    signed_payload = f"{timestamp}.".encode() + payload
+    expected = hmac.new(
+        secret.encode(),
+        signed_payload,
+        hashlib.sha256,
+    ).hexdigest()
+
+    if not hmac.compare_digest(expected, sig):
+        raise ValueError("Signature verification failed")
+
+    return True

jambonz_sdk/client/__init__.py

@@ -0,0 +1,15 @@
+"""REST API client for jambonz platform."""
+
+from jambonz_sdk.client.api import (
+    CallsResource,
+    ConferencesResource,
+    JambonzClient,
+    QueuesResource,
+)
+
+__all__ = [
+    "CallsResource",
+    "ConferencesResource",
+    "JambonzClient",
+    "QueuesResource",
+]