Skip to content
reaatech

Files · Agnostic No-Show Chase Agent for Studio Managers

75 (1 binary, 561.7 kB total)attempt 1

README.md·1901 B·markdown
markdown
# Agnostic No-Show Chase Agent for Studio Managers
 
> Automate late-cancel and no-show follow-ups with personalized reschedule offers and penalty enforcement.
 
## Problem
 
The studio manager spends 30 minutes every morning texting clients who no-showed or late-canceled yesterday. They have to manually check the booking system, compose a message, and decide whether to charge a fee or offer a makeup class. This inconsistent enforcement frustrates regulars and fails to recoup lost revenue.
 
## Architecture
 
The chase agent follows the **agent-mesh** pattern:
 
1. **LLM decides action** — using Vercel AI SDK (`ai` package) for provider-agnostic LLM calls
2. **Twilio delivers SMS** — sends personalized follow-up messages
3. **agent-memory tracks history** — stores customer interaction history for context
4. **budget-engine gates spend** — enforces per-customer cost limits
5. **replay-core records traces** — captures agent interactions for debugging
 
## Quick Start
 
```bash
pnpm install
# Set environment variables (see .env.example)
pnpm dev
```
 
## API Reference
 
- `POST /api/chase` — Trigger a chase for a no-show/late-cancel record
- `GET /api/chase/:id` — View chase history for a customer
 
## Packages Used
 
| Package | Version |
|---|---|
| @reaatech/agent-mesh | 1.0.0 |
| @reaatech/agent-handoff | 0.1.0 |
| @reaatech/agent-memory | 0.1.0 |
| @reaatech/agent-replay-core | 0.1.0 |
| @reaatech/llm-router-core | 1.0.0 |
| @reaatech/agent-budget-engine | 0.1.1 |
| twilio | 6.0.2 |
| zod | 4.4.3 |
| langfuse | 3.38.20 |
| ai (Vercel AI SDK) | 6.0.208 |
 
## Provider Agnosticism
 
Swap LLM providers by changing the model passed to `LlmService`. The recipe uses the Vercel AI SDK which supports OpenAI, Anthropic, Google, and many more through a unified interface.
 
## Testing
 
```bash
pnpm test
pnpm typecheck
pnpm lint
```
 
## License
 
MIT — see [LICENSE](./LICENSE).