Kanshō/Memory layer overview

Memory layer overview

The five memory buckets at a glance — conversation, session, user, organization, and agent-private. Each shows fact count and retention so the buyer can reason about where memory lives.

Included in the single kansho full pack. Components are not offered as separate installs.

Selectable layers

Click a layer to focus it

Static (read-only)

  • Conversation4

    This thread only — cleared when it ends.

    retention until thread ends
  • Session11

    The current working session across threads.

    retention 8h idle1 lock held
  • User38

    Durable facts about this user.

    retention permanent3 awaiting promotion
  • Organization126

    Shared across the whole workspace.

    retention permanent
  • Agent-private7

    Scratch the agent keeps to itself.

    retention per runscratch only

Usage

Guidance
Do
  • Show fact count and retention per layer so the reader can reason about lifespan.
  • Pass selectedLayer + onSelect to make layers focusable filters.
Don't
  • List individual facts here — this is the bucket-level overview.
When to use
A memory dashboard's at-a-glance view of the five memory layers.
When not to
Editing or promoting individual facts — use the memory viewer.

Accessibility

Keyboard & screen reader

Keyboard

Tab
Move focus between selectable layers.
EnterSpace
Select the focused layer.

Announces

  • Selectable layers are buttons exposing aria-pressed for the active state.

Props

API reference
PropTypeDescription
layersrequiredMemoryLayerStat[]Per-layer stats: layer, factCount, retention, optional note.
selectedLayerMemoryLayer | nullThe focused layer; enables selection styling.
onSelect(layer) => voidFires when a layer is chosen; makes layers interactive.

Component documentation

Memory Layer Overview

components/memory/memory-layer-overview.tsx

Purpose

Summarises fact counts and retention across the five memory layers.

Appropriate use

Use for choosing or comparing memory scopes before opening a detailed layer view.

Example

components/memory/memory-layer-overview.tsx has a representative live example in the "Selectable layers" section on /components/memory-layer-overview.

States

Layers are conversation, session, user, organization, and agent-private; cards may be selectable or read-only and may include notes.

API and props

MemoryLayerOverview accepts layers, selectedLayer, onSelect, and className; each MemoryLayerStat supplies layer, factCount, retention, and optional note.

Dependencies

Direct imports are React, Lucide icons, shared memory types, and cn.

Accessibility

Layer names, counts, retention, and notes are visible text; selectable cards are native buttons with aria-pressed state.

Limitations

It does not load facts, enforce retention, or change layers; without onSelect it is a read-only summary.

Source

Source: components/memory/memory-layer-overview.tsx.

Full pack

components/memory/memory-layer-overview.tsx is documented at /components/memory-layer-overview and installs only through the single Kansho full pack; no individual component install is offered.