microdao-daarion/docs/tasks/TASK_PHASE_AGENTS_CORE.md

TASK_PHASE_AGENTS_CORE.md

DAARION — AGENTS CORE IMPLEMENTATION

0. Ціль

Реалізувати ядро агентної системи:

• agent registry
• agent filtering
• agent.invoke → agent.reply
• NATS subjects
• quota & rate-limits
• agent-runs logging
• agent console API
• agent presence

Все на основі Data Model & Event Catalog.

---

1. Структура

services/
  agents/
    agent_filter.py
    agent_router.py
    agent_executor.py
    models.py
    schemas.py
    routes.py
    nats/
      subjects.py
      publisher.py
      subscriber.py

---

2. NATS Subjects

Publish:

• integration.matrix.message (stub)
• agents.invoke
• agents.reply
• agents.error
• agents.telemetry
• agents.runs.created
• agents.runs.finished

Subscribe:

• message.created
• task.created
• event.user.action

---

3. agent_filter.py

Функції:

def filter_message(message):
    # - detect spam
    # - detect commands
    # - route to agent if needed
    # - block restricted content
    pass

Вихід:

• "allow"
• "deny"
• "agent:"

---

4. agent_router.py

Логіка:

def route(agent_id, payload):
    # publish to NATS -> agents.invoke
    pass

---

5. agent_executor.py

Stub реалізація:

• виклик локальної LLM (gRPC/HTTP)
• timeout
• tokens count
• save run in DB

---

6. API endpoints

POST /agents/{id}/invoke

GET /agents/{id}/runs

GET /agents/{id}

---

7. Quotas

limits:

• tokens/minute
• runs/day
• users/day

---

8. Acceptance Criteria

• агент отримує запит
• агент відповідає через WS
• runs логуються
• quotas працюють
• agent_filter перехоплює підозрілі повідомлення
• NATS події працюють

---

9. Команда до Cursor

"Реалізувати Agents Core згідно TASK_PHASE_AGENTS_CORE.md.
Створити всі файли й інтеграцію з NATS."