[aditya-vithaldas]

Summary

Adds the first supervised, user-visible slice for first-class autonomous agent workflows in Devlane. Workspace admins can configure bounded agents, users can assign them from work items, and queued runs have a durable audit trail. Autonomous execution itself remains intentionally disabled until a queue consumer and model/tool runtime are added.

Linked issues

Refs #285

Type of change

• Feature (feat:) - user-visible new capability
• Bug fix (fix:) - corrects broken behavior
• Refactor (refactor:) - no behavior change, internal only
• Performance (perf:) - measurable improvement
• Documentation (docs:) - implementation proposal/checkpoint
• Tests (test:) - backend handler coverage

Surface

• API (apps/api/)
• UI (apps/web/)
• Database migration (apps/api/migrations/)
• Background jobs (RabbitMQ / queue)
• Instance settings / Admin UI
• Infra / Docker / CI

What changed

• Added agents, agent_tool_permissions, agent_issue_assignments, and agent_runs tables.
• Added Go models, store, service, and HTTP handlers for roster CRUD, assignment, and queued run records.
• Added project-scoped roster endpoints that include workspace-wide agents.
• Added issue activity entries for agent assignment and queued runs.
• Added Workspace Settings > Agents with roster stats, create/edit forms, project scope, model, autonomy, tool permissions, enable/disable, and delete controls.
• Added an issue sidebar panel for assigning/changing an agent, providing run-specific instructions, queueing a run, and viewing recent status history.
• Added a typed frontend agent service and API contracts shared by both UI surfaces.
• Added handler tests covering auth, admin gating, roster CRUD, project roster behavior, disabled-agent rejection, assignments, runs, and activity records.
• Updated proposals/agent-workflows.md with the current implementation boundary.

Why this approach

This makes the Phase 1 foundations inspectable and useful without pretending the execution runtime exists. Admins define identity and permissions centrally, while assignment and run controls live on the work item where users already manage delivery. Persisted run records provide the handoff point for a later queue worker, model execution, approval flow, and GitHub tooling.

Database / migrations

Adds 000007_agents with new agent roster, permission, assignment, and run tables. No existing data is migrated.

Breaking changes

• No
• Yes - described below

Test plan

• Frontend typecheck
• Frontend ESLint with zero warnings
• Frontend Prettier check
• Frontend production build
• go vet ./...
• Local API health/readiness against PostgreSQL
• Browser verification of roster, agent editor, issue assignment, and run-status rendering
• Current full Go test rerun - blocked because the testcontainer harness cannot find Docker on this machine; no Go files changed in the UI commit

Screenshots / recordings

Visually verified in the local app at desktop width:

• Workspace Settings > Agents roster and editor
• Work item Agent panel with an assigned agent and queued run history

Rollout notes

Run the new migration before using the agent endpoints. No new environment variables are required. This PR stores queued agent runs but does not execute them yet.

AI assistance

• No AI tools were used for this PR
• AI tools were used - OpenAI Codex

Checklist

• PR title follows Conventional Commits and is <= 100 chars
• Commit hooks ran cleanly
• Push hook rerun cleanly - Docker-backed Go tests were unavailable, so the already-validated UI commit was pushed with the hook skipped
• New routes are covered by handler tests
• No new environment variables added
• No secrets, tokens, or .env values committed

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}