# Knowledge Bases List Page

## Overview

Card grid list of all knowledge bases.

Follows the layout of `specs/designs/10-layout/list.md`, only the details are documented in this spec.

## Page Name

"Knowledge Bases" for title and breadcrumb

## Filters

| Row  | Mode   | Values                          | Default | Extra                         |
| ---- | ------ | ------------------------------- | ------- | ----------------------------- |
| Mode | Single | All, External, Managed          | All     | shows count badge             |
| Tags | Multi  | the tags present across all KBs | None    | row hidden when no tags exist |

## Card Anatomy

Cards are taller than the model and tool cards (256 px) to leave room for a documents preview.

```
┌─────────────────────────────────────────────────────────────┐
│ [icon]  KB Name                                  [status]   │
│                                                             │
│ Description text, clamped to three lines…                   │
│                                                             │
│ [tag] [tag]                                                 │
│                                                             │
│  📄 doc-one.pdf         📄 doc-two.md                       │
│  📄 doc-three.txt       📄 doc-four.pdf                     │
│  📄 doc-five.md         📄 +N more                          │
└─────────────────────────────────────────────────────────────┘
```

The card is clickable as a whole and links to `/workloads/kbs/[id]`. When `onselect` is provided (e.g. inside a KB picker), the card renders as a button instead and calls the handler on click / Enter.

### Header

- Small icon (size 36)
- KB name (line-clamp-2 if long)
- Status badge (right, when set)

### Body

- Description, clamped to three lines

### Tags

- tag chips (only rendered when there are tags)

### Documents Preview

2-column grid in the footer, up to 5 documents listed with a `FileIcon`. Any further documents collapse into a `+N more` item.

## Empty States

**No knowledge bases at all:**

```
DatabaseIcon (muted)
"No knowledge bases yet."
[New Knowledge Base button]
```

**No match:**

```
DatabaseIcon (muted)
"No knowledge bases match your filters."
[Clear filters link]
```