kaicalls 0.1.0__tar.gz

kaicalls-0.1.0/.gitignore

@@ -0,0 +1,116 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+.env.sentry-build-plugin
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+src/mcp-tools/node_modules
+scripts/node_modules
+workspace/**/node_modules
+# Google service account credentials
+client_secret*.json
+client_secret_1036960304490-6hju14mbs0bahbdteek1pl22ba47lc08.apps.googleusercontent.com.json
+
+# Voice/audio service credentials
+vocalscribe-*.json
+
+# misc
+/Voice Calls BBB/
+
+# API keys
+scripts/.bbb-api-key
+
+# Temp files
+logs/
+*.zip
+call-logs-*.json
+settings.json
+
+# Remotion projects
+remotion-projects/
+/remotion-projects/*
+
+# Cleanup staging
+_delete/
+nul
+.claude/worktrees/
+
+# Video files in workspace (store locally, don't push to git)
+workspace/**/*.mp4
+workspace/**/*.mov
+workspace/**/*.avi
+workspace/**/*.mkv
+workspace/**/*.webm
+workspace/**/*.wmv
+
+# Rincón client work — local-only, do not commit
+scripts/one-off/*rincon*
+scripts/one-off/rincon*
+.planning/rincon-*/
+
+# Local scratch data dumps
+tmp_*.json
+/tmp/
+/lighthouse-result.json
+/abp_calls.json
+/agent_patch.json
+/steph_calls_raw.json
+/_audit_out/
+/.codex-tmp/
+/.tmp-audit/
+/.tmp-lead-audit/
+/scripts/one-off/_audit_out/
+
+# Claude Code runtime state
+.claude/scheduled_tasks.lock
+.claude/tmp/
+.claude/settings.local.json
+
+# Per-client scratch data (workspace/daily-errors is tracked, see exclusion below)
+workspace/clients/
+
+# Python cache
+__pycache__/
+
+# SDK build artifacts
+sdk/typescript/node_modules/
+sdk/typescript/dist/
+sdk/python/dist/
+sdk/python/*.egg-info/
+sdk/python/**/__pycache__/

kaicalls-0.1.0/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.4
+Name: kaicalls
+Version: 0.1.0
+Summary: Official KaiCalls SDK — give your AI agent a phone. Outbound calls, agents, leads, SMS, transcripts, and webhooks.
+Project-URL: Homepage, https://www.kaicalls.com
+Project-URL: Documentation, https://www.kaicalls.com/docs/api
+Project-URL: Repository, https://github.com/cgallic/kai_calls
+Author-email: KaiCalls <support@kaicalls.com>
+License: MIT
+Keywords: ai,calls,kaicalls,phone,receptionist,sms,voice
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Telephony
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.25
+Description-Content-Type: text/markdown
+
+# kaicalls
+
+Official Python SDK for the [KaiCalls](https://www.kaicalls.com) API — give your AI agent a phone. Outbound calls, agents, leads, SMS, transcripts, webhooks, and platform APIs.
+
+- Python 3.9+, one dependency (`requests`)
+- Docs: <https://www.kaicalls.com/docs/api> · Live OpenAPI: `GET /api/v1/openapi.json`
+
+## Install
+
+```bash
+pip install kaicalls
+```
+
+## Quick start
+
+```python
+from kaicalls import KaiCalls
+
+kai = KaiCalls(api_key="kc_live_...")
+
+# Make an outbound call — the agent auto-enriches with CRM context
+call = kai.calls.create(
+    agent_id="uuid-abc123",
+    to="+15125551234",
+    name="John Smith",
+    context="Following up on his kitchen remodel inquiry",
+)
+
+# Block until the call finishes, then read the AI summary
+result = kai.calls.wait(call.id)
+print(result.summary)
+```
+
+Responses support attribute access (`call.id`, `result.summary`, `call.quality_dimensions.empathy`) and behave like dicts.
+
+## No account yet? Sign up via the API
+
+```python
+from kaicalls import KaiCalls, signup
+
+account = signup(
+    business_name="Smith Law Firm",
+    email="contact@smithlaw.com",
+    plan_id="starter",
+)
+# account.api_key works immediately; send the owner to account.checkout_url
+kai = KaiCalls(api_key=account.api_key)
+```
+
+## What's wrapped
+
+| Resource | Methods |
+|----------|---------|
+| `kai.calls` | `create`, `get`, `list`, `wait` |
+| `kai.recordings` | `get` |
+| `kai.agents` | `list`, `get`, `create`, `update`, `versions` |
+| `kai.leads` | `list`, `get`, `create`, `update`, `audit` |
+| `kai.sms` | `send`, `update_prompt`, `conversations`, `messages` |
+| `kai.transcripts` | `list` |
+| `kai.phone_numbers` | `list`, `available`, `assign`, `release` |
+| `kai.workspaces` | `list`, `get`, `create`, `update` (lifecycle actions) |
+| `kai.webhooks` | `list`, `create`, `delete`, `test`, `rotate_secret` |
+| `kai.analytics` | `dashboard`, `calls`, `funnel`, `agents`, `weekly`, `businesses` |
+| `kai.evals` | `create`, `list`, `get`, `update`, `delete`, `run`, `get_run` |
+| `kai.events` | `list`, `deliveries`, `replay`, `backfill` |
+| `kai.communication_runs` | `validate`, `preview`, `create`, `list`, `pause`, `cancel`, `jobs`, `attempts` |
+| `kai.discovery` | `capabilities`, `openapi`, `schemas`, `health` |
+| `kai.account` | `balance`, `usage` |
+
+Anything not wrapped yet is reachable through the escape hatch:
+
+```python
+kai.request("GET", "/api/sdr/pipeline", query={"businessId": "uuid-biz"})
+```
+
+## Errors
+
+All non-2xx responses raise `KaiCallsError` with `.status`, `.code` (e.g. `unauthorized`, `forbidden`, `rate_limited`), and `.body`.
+
+```python
+from kaicalls import KaiCallsError
+
+try:
+    kai.calls.create(agent_id=agent_id, to=to)
+except KaiCallsError as err:
+    if err.code == "rate_limited":
+        ...  # back off and retry
+```
+
+## Notes
+
+- Get an API key at <https://www.kaicalls.com/dashboard/settings/api>. New keys default to read-only scopes — request write scopes (`calls:write`, `sms:write`, …) when creating the key.
+- Phone numbers are E.164 (`+15125551234`).
+- API reference: <https://www.kaicalls.com/docs/api> · Errors: <https://www.kaicalls.com/docs/api/errors>

kaicalls-0.1.0/README.md

@@ -0,0 +1,94 @@
+# kaicalls
+
+Official Python SDK for the [KaiCalls](https://www.kaicalls.com) API — give your AI agent a phone. Outbound calls, agents, leads, SMS, transcripts, webhooks, and platform APIs.
+
+- Python 3.9+, one dependency (`requests`)
+- Docs: <https://www.kaicalls.com/docs/api> · Live OpenAPI: `GET /api/v1/openapi.json`
+
+## Install
+
+```bash
+pip install kaicalls
+```
+
+## Quick start
+
+```python
+from kaicalls import KaiCalls
+
+kai = KaiCalls(api_key="kc_live_...")
+
+# Make an outbound call — the agent auto-enriches with CRM context
+call = kai.calls.create(
+    agent_id="uuid-abc123",
+    to="+15125551234",
+    name="John Smith",
+    context="Following up on his kitchen remodel inquiry",
+)
+
+# Block until the call finishes, then read the AI summary
+result = kai.calls.wait(call.id)
+print(result.summary)
+```
+
+Responses support attribute access (`call.id`, `result.summary`, `call.quality_dimensions.empathy`) and behave like dicts.
+
+## No account yet? Sign up via the API
+
+```python
+from kaicalls import KaiCalls, signup
+
+account = signup(
+    business_name="Smith Law Firm",
+    email="contact@smithlaw.com",
+    plan_id="starter",
+)
+# account.api_key works immediately; send the owner to account.checkout_url
+kai = KaiCalls(api_key=account.api_key)
+```
+
+## What's wrapped
+
+| Resource | Methods |
+|----------|---------|
+| `kai.calls` | `create`, `get`, `list`, `wait` |
+| `kai.recordings` | `get` |
+| `kai.agents` | `list`, `get`, `create`, `update`, `versions` |
+| `kai.leads` | `list`, `get`, `create`, `update`, `audit` |
+| `kai.sms` | `send`, `update_prompt`, `conversations`, `messages` |
+| `kai.transcripts` | `list` |
+| `kai.phone_numbers` | `list`, `available`, `assign`, `release` |
+| `kai.workspaces` | `list`, `get`, `create`, `update` (lifecycle actions) |
+| `kai.webhooks` | `list`, `create`, `delete`, `test`, `rotate_secret` |
+| `kai.analytics` | `dashboard`, `calls`, `funnel`, `agents`, `weekly`, `businesses` |
+| `kai.evals` | `create`, `list`, `get`, `update`, `delete`, `run`, `get_run` |
+| `kai.events` | `list`, `deliveries`, `replay`, `backfill` |
+| `kai.communication_runs` | `validate`, `preview`, `create`, `list`, `pause`, `cancel`, `jobs`, `attempts` |
+| `kai.discovery` | `capabilities`, `openapi`, `schemas`, `health` |
+| `kai.account` | `balance`, `usage` |
+
+Anything not wrapped yet is reachable through the escape hatch:
+
+```python
+kai.request("GET", "/api/sdr/pipeline", query={"businessId": "uuid-biz"})
+```
+
+## Errors
+
+All non-2xx responses raise `KaiCallsError` with `.status`, `.code` (e.g. `unauthorized`, `forbidden`, `rate_limited`), and `.body`.
+
+```python
+from kaicalls import KaiCallsError
+
+try:
+    kai.calls.create(agent_id=agent_id, to=to)
+except KaiCallsError as err:
+    if err.code == "rate_limited":
+        ...  # back off and retry
+```
+
+## Notes
+
+- Get an API key at <https://www.kaicalls.com/dashboard/settings/api>. New keys default to read-only scopes — request write scopes (`calls:write`, `sms:write`, …) when creating the key.
+- Phone numbers are E.164 (`+15125551234`).
+- API reference: <https://www.kaicalls.com/docs/api> · Errors: <https://www.kaicalls.com/docs/api/errors>

kaicalls-0.1.0/kaicalls/__init__.py

@@ -0,0 +1,18 @@
+"""Official KaiCalls SDK — give your AI agent a phone.
+
+Usage::
+
+    from kaicalls import KaiCalls
+
+    kai = KaiCalls(api_key="kc_live_...")
+    call = kai.calls.create(agent_id="uuid-abc123", to="+15125551234", name="John Smith")
+    result = kai.calls.wait(call.id)
+    print(result.summary)
+
+Docs: https://www.kaicalls.com/docs/api
+"""
+
+from .client import KaiCalls, KaiCallsError, KaiObject, signup
+
+__all__ = ["KaiCalls", "KaiCallsError", "KaiObject", "signup"]
+__version__ = "0.1.0"