https://github.com/stepandel/ycagentphone
Your virtual host of the restaurant
https://github.com/stepandel/ycagentphone
Last synced: 15 days ago
JSON representation
Your virtual host of the restaurant
- Host: GitHub
- URL: https://github.com/stepandel/ycagentphone
- Owner: stepandel
- Created: 2026-05-18T01:07:54.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-05-18T03:17:22.000Z (about 1 month ago)
- Last Synced: 2026-05-18T05:38:54.945Z (about 1 month ago)
- Language: TypeScript
- Size: 252 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CallHost
One of the winners of AgentPhone YC Hackathon.
[Video demo](https://youtu.be/3pKax01f33U)
CallHost is a restaurant phone host for AgentPhone webhooks, backed by a Moss knowledgebase.
## Architecture
```text
Caller
-> AgentPhone phone number
-> AgentPhone webhook
-> Express service
-> Call skill matching
-> Moss search
-> OpenAI Responses API
-> AgentPhone speaks the answer
```
Codex is useful as the builder and maintenance harness. The live call path is this service.
## Setup
```bash
cd ~/Development/ycagentphone
bun install
cp .env.example .env
```
Edit `.env` and set:
```bash
OPENAI_API_KEY=...
LANGFUSE_PUBLIC_KEY=...
LANGFUSE_SECRET_KEY=...
MOSS_PROJECT_ID=...
MOSS_PROJECT_KEY=...
MOSS_INDEX_NAME=ycagentphone-restaurant-kb
AGENTPHONE_API_KEY=...
AGENTPHONE_AGENT_ID=...
AGENTPHONE_BASE_URL=https://api.agentphone.ai
AGENTPHONE_WEBHOOK_BASE_URL=...
STRIPE_SECRET_KEY=sk_test_...
STRIPE_STANDARD_RESERVATION_DEPOSIT_AMOUNT_CENTS=2000
STRIPE_LARGE_PARTY_RESERVATION_DEPOSIT_AMOUNT_CENTS=10000
STRIPE_RESERVATION_DEPOSIT_CURRENCY=usd
STRIPE_STANDARD_RESERVATION_PAYMENT_LINK_URL=...
STRIPE_LARGE_PARTY_RESERVATION_PAYMENT_LINK_URL=...
COMPANY_NAME=...
RESTAURANT_GREETING="Good evening, and thank you for calling. This is the restaurant's virtual host. How may I help you today?"
RESTAURANT_PROCESSING_MESSAGE="Of course. Let me check that for you."
PUBLIC_CONTACT_EMAIL=...
```
Then seed the Moss knowledgebase:
```bash
bun run ingest:kb
```
The default Moss index is `ycagentphone-restaurant-kb`. Override `MOSS_INDEX_NAME` in `.env` if you want to use a different knowledge space. Retrieval uses hybrid search by default with `MOSS_SEARCH_ALPHA=0.8`, where `1.0` is semantic-only and `0.0` is keyword-only.
Langfuse tracing is enabled automatically when `LANGFUSE_PUBLIC_KEY`, `LANGFUSE_SECRET_KEY`, and `LANGFUSE_BASE_URL` are set. Each answered turn is traced as `agentphone.answer`, with Moss retrieval and the OpenAI Responses API call captured underneath it.
## Run Locally
```bash
bun run dev
```
Health check:
```bash
curl http://localhost:3000/health
```
Local turn test through HTTP:
```bash
curl -X POST http://localhost:3000/test/turn \
-H 'content-type: application/json' \
-d '{"transcript":"Do you have a private dining menu for 14 people?"}'
```
Local turn test through the script:
```bash
bun run test:turn -- "Do you have gluten-free pasta?"
```
Signed local webhook test:
```bash
bun run test:webhook -- "Can I book a birthday dinner for 12 people?"
```
## AgentPhone Webhook
Use a stable public URL for AgentPhone. With ngrok, reserve a static domain in the ngrok dashboard, then run:
```bash
ngrok http --url=YOUR-STATIC-DOMAIN.ngrok-free.app 127.0.0.1:3000
```
Set the stable base URL in `.env`:
```bash
AGENTPHONE_WEBHOOK_BASE_URL=https://YOUR-STATIC-DOMAIN.ngrok-free.app
```
Configure AgentPhone from that constant:
```bash
bun run configure:webhook
```
That script configures AgentPhone to call:
```text
${AGENTPHONE_WEBHOOK_BASE_URL}/webhooks/agentphone
```
It also updates `AGENTPHONE_WEBHOOK_SECRET` in `.env` with the returned AgentPhone signing secret.
Restart the webhook server after running this command so signature verification uses the new secret.
Configure a Stripe test-mode reservation deposit link:
```bash
bun run configure:stripe
```
The script requires `STRIPE_SECRET_KEY=sk_test_...`, creates a test-mode reservation deposit Payment Link using `STRIPE_RESERVATION_DEPOSIT_AMOUNT_CENTS` or the `$20` standard deposit by default, and writes `STRIPE_RESERVATION_PAYMENT_LINK_URL` into `.env`. For production-like behavior, configure separate `STRIPE_STANDARD_RESERVATION_PAYMENT_LINK_URL` and `STRIPE_LARGE_PARTY_RESERVATION_PAYMENT_LINK_URL` links for the `$20` and `$100` deposits.
Configure Stripe to send `checkout.session.completed` events to:
```text
${AGENTPHONE_WEBHOOK_BASE_URL}/webhooks/stripe
```
Set the endpoint signing secret as `STRIPE_WEBHOOK_SECRET=whsec_...`. Reservation SMS links include a Stripe Payment Link `client_reference_id`, which the Stripe webhook uses to mark the matching reservation deposit paid in the admin UI and send the guest a payment confirmation text.
The webhook parser accepts several common payload shapes, including:
```json
{
"callId": "call_123",
"from": "+15551234567",
"transcript": "Can I book a birthday dinner for 12 people?"
}
```
and:
```json
{
"call": { "id": "call_123", "from": "+15551234567" },
"messages": [
{ "role": "caller", "content": "Do you accommodate nut allergies?" }
]
}
```
The JSON response includes `response`, `text`, and `message` fields with the same answer so it is easy to adapt to AgentPhone's exact expected response key. When the agent should end the call after speaking, the response also includes `hangup: true` and `action: "hangup"`.
Inbound SMS/text webhooks can use the same endpoint. Send `channel: "sms"` or an AgentPhone message-style payload such as:
```json
{
"event": "message.received",
"data": {
"channel": "sms",
"messageId": "msg_123",
"fromNumber": "+15551234567",
"body": "Can we move the reservation to 7:30 and add a high chair?"
}
}
```
Text turns are answered with normal JSON instead of voice streaming. The agent receives the caller's latest reservation log context, can answer restaurant or reservation questions from the knowledgebase and log, and appends text follow-ups to the reservation history. Common change requests like time, date, party-size, and special-note updates are stored as reservation amendments so later text replies see the updated current reservation.
For NDJSON-style streaming, call:
```text
/webhooks/agentphone?stream=1
```
Post-call webhooks use AgentPhone's `agent.call_ended` event. The service extracts the full transcript from `data.transcript`, summarizes reservation context with OpenAI, writes a Markdown reservation log entry, then sends a brief follow-up message to the caller with party size, day/time, special notes, and the correct Stripe deposit link when configured. Parties of 10 or fewer use the `$20` standard reservation deposit; parties over 10 use the `$100` large-party deposit. Outbound messaging requires `AGENTPHONE_API_KEY` and `AGENTPHONE_AGENT_ID`; `AGENTPHONE_BASE_URL` defaults to `https://api.agentphone.ai`.
Reservation log entries default to `data/reservation-log.md` and can be moved with `RESERVATION_LOG_PATH`. The file is readable Markdown with embedded metadata so later SMS/text webhooks from the same caller can pull the latest reservation context and append follow-up changes to the same reservation history.
## Knowledgebase
Put approved caller-facing information in `kb/`.
Recommended files:
- `kb/restaurant-overview.md`
- `kb/menu.md`
- `kb/food-modifications.md`
- `kb/allergy-practices.md`
- `kb/large-party-policy.md`
- `kb/prix-fixe-large-parties.md`
- `kb/chef-and-owners.md`
- `kb/reservation-inquiry-large-party.md`
- `kb/faq.md`
- `kb/handoff-rules.md`
- `kb/competitors/*.md`
After editing the knowledgebase, run:
```bash
bun run ingest:kb
```
## Notes
- The system prompt lives in `src/prompt.ts`.
- Call skills live in `src/skills/`. The reservation-taking flow is `src/skills/reservation-taking.ts`.
- The webhook adapter lives in `src/agentphone.ts`.
- The OpenAI call lives in `src/agent.ts`.
- Moss retrieval lives in `src/memory.ts`.
- If AgentPhone provides a signing secret, set `AGENTPHONE_WEBHOOK_SECRET` and confirm the exact signature header/hash format in `src/agentphone.ts`.