107 lines
1.5 KiB
Markdown
107 lines
1.5 KiB
Markdown
# API Contracts
|
|
|
|
## POST /chat
|
|
|
|
Вход:
|
|
|
|
```json
|
|
{
|
|
"project_id": "default",
|
|
"conversation_id": "optional",
|
|
"message": "Найди файл и исправь запрос",
|
|
"attachments": [],
|
|
"mode": "auto",
|
|
"preferences": {
|
|
"local_only": true,
|
|
"show_plan": true
|
|
}
|
|
}
|
|
```
|
|
|
|
Выход:
|
|
|
|
```json
|
|
{
|
|
"conversation_id": "conv_1",
|
|
"task_id": "task_1",
|
|
"response_type": "answer | task_started | confirmation_required | error",
|
|
"message": "string",
|
|
"cards": []
|
|
}
|
|
```
|
|
|
|
## POST /tasks
|
|
|
|
Создать задачу без chat-интерфейса.
|
|
|
|
```json
|
|
{
|
|
"project_id": "default",
|
|
"goal": "Исправить модуль",
|
|
"inputs": {},
|
|
"execution_mode": "agent_graph"
|
|
}
|
|
```
|
|
|
|
## GET /tasks/{task_id}
|
|
|
|
```json
|
|
{
|
|
"task_id": "task_1",
|
|
"status": "running",
|
|
"current_node": "node_3",
|
|
"progress": {
|
|
"completed": 2,
|
|
"total": 5
|
|
}
|
|
}
|
|
```
|
|
|
|
## GET /tasks/{task_id}/events
|
|
|
|
SSE/WebSocket stream событий:
|
|
|
|
```json
|
|
{
|
|
"event": "node_started",
|
|
"task_id": "task_1",
|
|
"node_id": "node_3",
|
|
"timestamp": "..."
|
|
}
|
|
```
|
|
|
|
## POST /confirmations/{id}/approve
|
|
|
|
```json
|
|
{
|
|
"scope": "once | task | project",
|
|
"comment": "approved"
|
|
}
|
|
```
|
|
|
|
## POST /confirmations/{id}/reject
|
|
|
|
```json
|
|
{
|
|
"reason": "not now"
|
|
}
|
|
```
|
|
|
|
## POST /workers/register
|
|
|
|
Local worker регистрируется на сервере.
|
|
|
|
```json
|
|
{
|
|
"worker_id": "worker_home_pc",
|
|
"name": "Home PC",
|
|
"capabilities": [
|
|
"file.read",
|
|
"file.write",
|
|
"file.search",
|
|
"command.run"
|
|
],
|
|
"version": "0.1.0"
|
|
}
|
|
```
|