Create Agent instance management API endpoints #30

New Issue

cardosofelipe · 2025-12-29T23:48:23Z

cardosofelipe commented

2025-12-29 23:48:23 +00:00

Description

Implement REST API endpoints for AgentInstance lifecycle management.

Requirements

Endpoints

POST   /api/v1/projects/{pid}/agents              - Spawn agent
GET    /api/v1/projects/{pid}/agents              - List project agents
GET    /api/v1/projects/{pid}/agents/{id}         - Get agent details
PATCH  /api/v1/projects/{pid}/agents/{id}         - Update agent
POST   /api/v1/projects/{pid}/agents/{id}/pause   - Pause agent
POST   /api/v1/projects/{pid}/agents/{id}/resume  - Resume agent
DELETE /api/v1/projects/{pid}/agents/{id}         - Terminate agent
GET    /api/v1/projects/{pid}/agents/{id}/metrics - Get agent metrics

Authorization

Project owner or superuser only
Agents scoped to projects

Response Schema

Include status, current task, metrics, and memory summary.

Tests

All endpoints
Project ownership check
Status transitions
Metrics calculation

Acceptance Criteria

All endpoints implemented
Project scoping enforced
Status transitions validated
Metrics endpoint accurate
Integration tests
OpenAPI schema updated

Dependencies

Depends on: #23 (Project), #25 (AgentInstance)

Assignable To

backend-engineer agent

## Description Implement REST API endpoints for AgentInstance lifecycle management. ## Requirements ### Endpoints ``` POST /api/v1/projects/{pid}/agents - Spawn agent GET /api/v1/projects/{pid}/agents - List project agents GET /api/v1/projects/{pid}/agents/{id} - Get agent details PATCH /api/v1/projects/{pid}/agents/{id} - Update agent POST /api/v1/projects/{pid}/agents/{id}/pause - Pause agent POST /api/v1/projects/{pid}/agents/{id}/resume - Resume agent DELETE /api/v1/projects/{pid}/agents/{id} - Terminate agent GET /api/v1/projects/{pid}/agents/{id}/metrics - Get agent metrics ``` ### Authorization - Project owner or superuser only - Agents scoped to projects ### Response Schema Include status, current task, metrics, and memory summary. ### Tests - All endpoints - Project ownership check - Status transitions - Metrics calculation ## Acceptance Criteria - [ ] All endpoints implemented - [ ] Project scoping enforced - [ ] Status transitions validated - [ ] Metrics endpoint accurate - [ ] Integration tests - [ ] OpenAPI schema updated ## Dependencies - Depends on: #23 (Project), #25 (AgentInstance) ## Assignable To backend-engineer agent

cardosofelipe referenced this issue

2025-12-29 23:49:19 +00:00

Implement project dashboard page #40

cardosofelipe added the backend phase-1 labels 2025-12-29 23:49:59 +00:00

cardosofelipe closed this issue

2025-12-31 10:20:40 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: cardosofelipe/syndarix#30