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).