# ARI Call Manager

## Purpose

The ARI Call Manager connects the Go service to Asterisk ARI events for application `ai-operator`. It is responsible for reading ARI WebSocket events, creating in-memory call sessions, and performing limited test-call control.

## Modes

### Observe-only

```sh
./bin/ai-operator run --env /etc/ai-operator/ai-operator.env --ari-events --observe-only
```

Observe-only registers the ARI app and reads events. It does not answer, hang up, create bridges, create media channels, or call OpenAI.

### Call-control

```sh
./bin/ai-operator run --env /etc/ai-operator/ai-operator.env --ari-events --call-control --test-call-hangup-after 5s
```

Call-control is restricted to Stasis args containing `test`. It may answer a test channel and hang it up after the configured delay. Production routes are disabled by default.

## Implemented in TZ-03

- ARI events WebSocket listener.
- Basic Auth and query `api_key` URL support.
- Safe sanitized WebSocket URL builder.
- Reconnect with bounded backoff.
- `ApplicationReplaced` handling.
- Lock file protection for one active listener.
- `StasisStart`, `StasisEnd`, `ChannelHangupRequest`, `ChannelDestroyed`, and generic event parsing.
- In-memory thread-safe session store.
- ARI HTTP actions for answer, hangup, and get channel.

## Not Implemented Yet

- Media gateway.
- Bridges.
- `chan_websocket` media channel handling.
- OpenAI provider.
- Knowledge base / RAG.
- Production route switching.

## Safety Notes

- Only one ARI listener should run at a time.
- The default lock file is `/tmp/ai-operator-ari-events.lock`.
- Production route handling is disabled.
- Test route is `7199@from-softphones` and enters `Stasis(ai-operator,test)`.
- Kazakhtelecom production routes are not switched.

## TZ-04 media integration

Call-control mode can optionally enable media with `--media`. Media is restricted to the `test` route and uses the Asterisk WebSocket Media Gateway. Production routes remain disabled.

## TZ-05 Voice Provider Integration

Call-control test mode can start a VoiceProvider session. This is restricted to the `test` route and production remains disabled.