l-ai-agent-kaya/README.md
alex adb6c5ab8a
All checks were successful
ci/woodpecker/manual/woodpecker Pipeline was successful
Initial Kaya board-mention agent daemon.
Thin WS client to l-ai-tasks that drafts short core RunAgent replies on @kaya mentions.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-21 23:07:24 +03:00

46 lines
1.1 KiB
Markdown

# l-ai-agent-kaya
Thin Tasks board agent: replies to `@kaya` mentions in task comments.
## Behavior
Long-lived daemon:
1. Connects to `l-ai-tasks` WebSocket (`TASKS_WS_URL`) with reconnect.
2. On `comment.added` where mentions include agent `kaya` and author ≠ `kaya`:
- dedupes by comment id
- GET task + comments via REST
- calls `l-ai-core` `AIService.RunAgent` (tools disabled) with Kaya persona
- POST comment with `Idempotency-Key: mention-reply:<comment_id>`
No Telegram / Live Chat integration.
## Identity
- `agent_id`: `kaya`
- Display: Kaya / Кая
- Profile: `profiles/kaya.yaml`
## Env
| Variable | Required | Default |
|---|---|---|
| `TASKS_WS_URL` | yes | — |
| `TASKS_API_URL` | yes | — |
| `TASKS_AGENT_TOKEN` | yes | — |
| `CORE_ENDPOINT` | no | `core:50051` |
| `CORE_TOKEN` | yes | — |
| `CORE_INSECURE` | no | `false` |
| `MODEL` | no | `deepseek-v4-flash` |
| `AGENT_PROFILE_PATH` | no | `profiles/kaya.yaml` |
| `HEALTH_LISTEN_ADDR` | no | `:8087` |
| `METRICS_LISTEN_ADDR` | no | `:9097` |
## Build
```bash
go build -o kaya ./cmd/kaya
```
Image binary: `/app/kaya`. Health `:8087/healthz`, metrics `:9097/metrics`.