---
kind: task
slug: agent-marketplace-library-ui
title: Build the agent marketplace library UI
plan_slug: workspace-communications
epic_slug: agent-participation
status: ready
priority: P1
tenant_id: global
owner: unassigned
cursor_todo_id: null
updated_at: "2026-10-22"
---

# Task summary

Present curated templates and permitted workspace agents as a searchable, actionable library below the Agents composer.

## Description

Consume the versioned registry API to render Featured/Templates, Installed, Created by your workspace, and My Drafts. Cards and detail views distinguish provenance, lifecycle, visibility, disabled state, and available updates. UI actions obey the registry permission matrix and never imply that a template is active before installation/review.

## Subtasks

- [ ] Build responsive library sections with search, filters, sorting, loading, empty, and error states.
- [ ] Build cards and detail/version views for preview, duplicate, install, edit, disable, remove, and update actions as permitted.
- [ ] Surface tool requests, model role, harness route, budget, provenance, visibility, and version changes before confirmation.
- [ ] Add accessible keyboard navigation, focus management, and component tests.

## Owner or assignee

`unassigned`

## Status

`ready`

## Estimation

`M`

## Acceptance criteria

- [ ] Members see curated templates, active workspace agents, and only their own private drafts; `admin`/`owner` can manage shared lifecycle actions.
- [ ] Template, draft, installed, active, disabled, and update states are visually and semantically distinct.
- [ ] Sensitive actions show a review/confirmation step and server authorization remains authoritative.
- [ ] The library integrates beneath the shared Agents composer without adding another rail destination.
- [ ] `pnpm lint && pnpm type-check && pnpm test` pass.

## Dependencies

`Task-ai-workspace-tabs.md`, `Task-agent-registry-api.md`, and `Task-agent-install-lifecycle.md`. Library actions call these APIs; installation does not grant chat/context access.

## Links to related Epic / Plan

- Epic: `./Epic-agent-participation.md`
- Plan: `../Plan-workspace-communications.md`