Rename package from plivo_agent to plivo_agentstack

Move src/plivo_agent/ to src/plivo_agentstack/, update all imports
across tests, examples, CI, pyproject.toml, README, and CLAUDE.md.

Author: bevenky

.github/workflows/tests.yml

@@ -45,7 +45,7 @@ jobs:
         run: pip install -e ".[dev]" pytest-cov
 
       - name: Run tests with coverage
-        run: pytest tests/ --cov=plivo_agent --cov-report=xml
+        run: pytest tests/ --cov=plivo_agentstack --cov-report=xml
 
       - name: Upload coverage to Codecov
         uses: codecov/codecov-action@v4

CLAUDE.md

@@ -1,13 +1,13 @@
-# CLAUDE.md — plivo-agent-python
+# CLAUDE.md — plivo-agentstack-python
 
 ## Project overview
 
-Async-first Python SDK for Plivo (`plivo_agent`). Covers Voice AI Agents (WebSocket + REST), Messaging (SMS/MMS/WhatsApp), and Numbers. Python 3.10+, built with `hatchling`.
+Async-first Python SDK for Plivo (`plivo_agentstack`). Covers Voice AI Agents (WebSocket + REST), Messaging (SMS/MMS/WhatsApp), and Numbers. Python 3.10+, built with `hatchling`.
 
 ## Repository layout
 
 ```
-src/plivo_agent/
+src/plivo_agentstack/
   __init__.py          # Public exports: AsyncClient, errors
   client.py            # AsyncClient entry point
   _http.py             # HttpTransport — retry, auth, error mapping
@@ -78,5 +78,5 @@ ruff check src/ tests/        # lint
 
 - New REST resources: add to the appropriate sub-client (`agent/client.py`, `messaging/client.py`, `numbers/client.py`), wire into the parent client, add tests with `respx` mocks
 - New WebSocket events: add a `@dataclass` to `agent/events.py`, register in `_EVENT_REGISTRY`, add parse test in `test_events.py`
-- New examples: add to `examples/`, use `from plivo_agent import AsyncClient` and `from plivo_agent.agent import VoiceApp, ...` pattern. Update README Quick start section
+- New examples: add to `examples/`, use `from plivo_agentstack import AsyncClient` and `from plivo_agentstack.agent import VoiceApp, ...` pattern. Update README Quick start section
 - Keep dependencies minimal — core deps are `httpx`, `websockets`, `starlette` only

README.md

@@ -1,9 +1,9 @@
-# Plivo Agent Python SDK
+# Plivo AgentStack Python SDK
 
-[![PyPI version](https://img.shields.io/pypi/v/plivo_agent.svg)](https://pypi.org/project/plivo_agent/)
-[![Python 3.10+](https://img.shields.io/pypi/pyversions/plivo_agent.svg)](https://pypi.org/project/plivo_agent/)
-[![Tests](https://github.com/plivo/plivo-agent-python/actions/workflows/tests.yml/badge.svg)](https://github.com/plivo/plivo-agent-python/actions/workflows/tests.yml)
-[![codecov](https://codecov.io/gh/plivo/plivo-agent-python/branch/main/graph/badge.svg)](https://codecov.io/gh/plivo/plivo-agent-python)
+[![PyPI version](https://img.shields.io/pypi/v/plivo_agentstack.svg)](https://pypi.org/project/plivo_agentstack/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/plivo_agentstack.svg)](https://pypi.org/project/plivo_agentstack/)
+[![Tests](https://github.com/plivo/plivo-agentstack-python/actions/workflows/tests.yml/badge.svg)](https://github.com/plivo/plivo-agentstack-python/actions/workflows/tests.yml)
+[![codecov](https://codecov.io/gh/plivo/plivo-agentstack-python/branch/main/graph/badge.svg)](https://codecov.io/gh/plivo/plivo-agentstack-python)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 Plivo Programmable Agents SDK - Build AI Agents that work over voice calls, SMS/WhatsApp programmatically.
@@ -71,7 +71,7 @@ Inbound/Outbound Call
 ## Installation
 
 ```bash
-pip install plivo_agent
+pip install plivo_agentstack
 ```
 
 Requires Python 3.10+.
@@ -98,8 +98,8 @@ Sign up at [cx.plivo.com/signup](https://cx.plivo.com/signup) to get your `PLIVO
 ## Development
 
 ```bash
-git clone https://github.com/plivo/plivo-agent-python.git
-cd plivo-agent-python
+git clone https://github.com/plivo/plivo-agentstack-python.git
+cd plivo-agentstack-python
 python -m venv .venv && source .venv/bin/activate
 pip install -e ".[dev]"
 pytest tests/ -v          # 70 tests

examples/agent_basic.py

@@ -4,7 +4,7 @@
 handles tool calls during live voice sessions.
 
 Prerequisites:
-    pip install plivo_agent[all]
+    pip install plivo_agentstack[all]
 
 Environment variables:
     PLIVO_AUTH_ID      -- Your Plivo auth ID
@@ -18,8 +18,8 @@
 import logging
 import os
 
-from plivo_agent import AsyncClient
-from plivo_agent.agent import (
+from plivo_agentstack import AsyncClient
+from plivo_agentstack.agent import (
     AgentSessionEnded,
     AgentSessionStarted,
     ToolCall,

examples/agent_fastapi.py

@@ -4,7 +4,7 @@
 allowing you to combine voice agent endpoints with REST routes.
 
 Prerequisites:
-    pip install plivo_agent[all] fastapi uvicorn
+    pip install plivo_agentstack[all] fastapi uvicorn
 
 Run:
     uvicorn agent_fastapi:fastapi_app --port 9000
@@ -14,7 +14,7 @@
 
 from fastapi import FastAPI, WebSocket
 
-from plivo_agent.agent import (
+from plivo_agentstack.agent import (
     AgentSessionEnded,
     AgentSessionStarted,
     ToolCall,

examples/audio_stream.py

@@ -34,7 +34,7 @@
     - clearAudio: Clear all queued audio (for interruption)
 
 Usage:
-  1. pip install plivo_agent[all]
+  1. pip install plivo_agentstack[all]
   2. Set PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN env vars
   3. python audio_stream.py
 """
@@ -43,8 +43,8 @@
 import os
 import time
 
-from plivo_agent import AsyncClient
-from plivo_agent.agent import (
+from plivo_agentstack import AsyncClient
+from plivo_agentstack.agent import (
     AgentSessionEnded,
     AgentSessionStarted,
     ClearedAudio,

examples/background_audio.py

@@ -30,16 +30,16 @@
   1.0      Full volume (use sparingly)
 
 Usage:
-  1. pip install plivo_agent[all]
+  1. pip install plivo_agentstack[all]
   2. Set PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN env vars
   3. python background_audio.py
 """
 
 import asyncio
 import os
 
-from plivo_agent import AsyncClient
-from plivo_agent.agent import (
+from plivo_agentstack import AsyncClient
+from plivo_agentstack.agent import (
     AgentSessionEnded,
     AgentSessionStarted,
     ToolCall,

examples/buy_number.py

@@ -1,7 +1,7 @@
 """Search for available phone numbers and buy one.
 
 Prerequisites:
-    pip install plivo_agent
+    pip install plivo_agentstack
 
 Environment variables:
     PLIVO_AUTH_ID      -- Your Plivo auth ID
@@ -13,7 +13,7 @@
 
 import asyncio
 
-from plivo_agent import AsyncClient
+from plivo_agentstack import AsyncClient
 
 
 async def main():

examples/byollm.py

@@ -20,7 +20,7 @@
   LLM:  OpenAI GPT-4.1-mini  (your API key, your code)
 
 Usage:
-  1. pip install plivo_agent[all] openai
+  1. pip install plivo_agentstack[all] openai
   2. Set PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN, OPENAI_API_KEY env vars
   3. python byollm.py
 """
@@ -30,8 +30,8 @@
 
 from openai import AsyncOpenAI
 
-from plivo_agent import AsyncClient
-from plivo_agent.agent import (
+from plivo_agentstack import AsyncClient
+from plivo_agentstack.agent import (
     AgentSessionEnded,
     AgentSessionStarted,
     Dtmf,

examples/byollm_echo.py

@@ -5,11 +5,11 @@
 This lets you trace the full STT -> customer WS -> TTS flow with fake API keys.
 
 Usage:
-  1. pip install plivo_agent[all]
+  1. pip install plivo_agentstack[all]
   2. python byollm_echo.py
 """
 
-from plivo_agent.agent import (
+from plivo_agentstack.agent import (
     AgentSessionEnded,
     AgentSessionStarted,
     Error,