# MemoryPanel

What the assistant remembers, with where each memory came from, how far it reaches and whether it was used just now.

- **Use it for**: Browsing, pinning and forgetting memories with their provenance.
- **Not for**: Correcting the text of one memory. Try [MemoryControls](https://unseenui.com/components/memory-controls/).

## Installation

```bash
npm install @stackunseen/ui
```

## Usage

```tsx
import { MemoryPanel } from '@stackunseen/ui';
import '@stackunseen/ui/styles.css';

<MemoryPanel variant="list" entries={entries} query={query} onQueryChange={setQuery} onRequest={request} />
```

## All props

| Prop | Type | Description |
| --- | --- | --- |
| `entries` (required) | `readonly MemoryEntry[]` |  |
| `label` | `string` |  |
| `locale` | `string` |  |
| `onQueryChange` (required) | `(query: string) => void` |  |
| `onRequest` (required) | `(request: MemoryRequest) => void` | Asks the host to pin, unpin or forget. |
| `query` (required) | `string` | Controlled filter text; the host or the panel's own state owns it. |
| `receipts` | `Readonly<Record<string, CommandReceipt>>` | Receipts for requests in flight or settled, keyed by entry id. |
| `timeZone` | `string` |  |
| `variant` | `"list" \| "compact"` |  |

## Keyboard

Tab reaches controls; Enter or Space activates buttons. Accordions use arrow keys, Home and End. Select menus support arrows and typeahead; Escape closes menus and dialogs and restores focus.

## Works with

[RunBoard](https://unseenui.com/components/run-board/), [AgentLanes](https://unseenui.com/components/agent-lanes/), [SubagentTree](https://unseenui.com/components/subagent-tree/), [ExecutionTimeline](https://unseenui.com/components/execution-timeline/), [WorkflowGraph](https://unseenui.com/components/workflow-graph/), [AttentionQueue](https://unseenui.com/components/attention-queue/), [RunCompare](https://unseenui.com/components/run-compare/), [ContextBar](https://unseenui.com/components/context-bar/), [Plan](https://unseenui.com/components/plan/), [AgentSteering](https://unseenui.com/components/agent-steering/), [CostLedger](https://unseenui.com/components/cost-ledger/), [ContextWindowMeter](https://unseenui.com/components/context-window-meter/)

Page: https://unseenui.com/components/memory-panel/