Skip to content
Source
Sign inSign up
TanStack/ai
Open History to see the last commit

MemoryPanel.tsx

296 lines10.7 KB

1import { For, Show, createMemo, createSignal } from 'solid-js'
2import { useAIStore } from '../../store/ai-context'
3import { useStyles } from '../../styles/use-styles'
4import type { Component } from 'solid-js'
5import { memoryScopeLabel } from '../../store/memory-registry'
6import type {
7 MemoryEventRecord,
8 MemoryScopeState,
9} from '../../store/memory-registry'
10​
11/**
12 * DevTools "Memory" tab. Memory is per composite scope (tenant/user/thread),
13 * not per-hook, so this panel reads the whole `state.memory` registry and lets
14 * the user pick a scope (defaulting to the most recently active). It renders
15 * two things:
16 * 1. Live contents — the latest `inspect()` records + `listFacts()` facts,
17 * pushed via `memory:snapshot` (only for adapters that support inspection).
18 * 2. Operations timeline — the `memory:*` recall/save/error events (always
19 * available, even when the adapter has no introspection).
20 */
21​
22/** Shape of a record inside the built-in adapters' `inspect()` payload. */
23interface MemoryRecordRow {
24 id: string
25 text: string
26 kind: string
27 role?: string
28 createdAt?: number
29 importance?: number
31​
32/** Best-effort extraction of `{ records: [...] }` from the opaque snapshot data. */
33function extractRecords(data: unknown): Array<MemoryRecordRow> {
34 if (!data || typeof data !== 'object') return []
35 const records = (data as { records?: unknown }).records
36 if (!Array.isArray(records)) return []
37 return records.filter(
38 (r): r is MemoryRecordRow =>
39 Boolean(r) &&
40 typeof r === 'object' &&
41 typeof (r as MemoryRecordRow).id === 'string' &&
42 typeof (r as MemoryRecordRow).text === 'string',
43 )
45​
46function formatTime(value: number | string | undefined): string {
47 if (value === undefined) return ''
48 const date = new Date(value)
49 if (Number.isNaN(date.getTime())) return ''
50 return date.toLocaleTimeString()
52​
53function eventSummary(event: MemoryEventRecord): string {
54 switch (event.type) {
55 case 'retrieve:started':
56 return `recall "${event.query ?? ''}"`
57 case 'retrieve:completed':
58 return `recalled ${event.fragmentCount ?? 0} fragment(s), ${
59 event.systemPromptChars ?? 0
60 } prompt chars${event.hasTools ? ', +tools' : ''} (${event.durationMs ?? 0}ms)`
61 case 'persist:started':
62 return 'save started'
63 case 'persist:completed':
64 return `saved ${event.okCount ?? 0}/${event.receiptCount ?? 0} receipt(s) (${
65 event.durationMs ?? 0
66 }ms)`
67 case 'error':
68 return `${event.phase ?? ''} error: ${event.error?.message ?? 'unknown'}`
69 default:
70 return event.type
71 }
73​
74export const MemoryPanel: Component = () => {
75 const { state, clearMemory } = useAIStore()
76 const styles = useStyles()
77 const [override, setOverride] = createSignal<string | null>(null)
78​
79 // Scope keys sorted most-recently-active first.
80 const scopeKeys = createMemo(() =>
81 Object.values(state.memory.scopes)
82 .slice()
83 .sort((a, b) => b.lastActivity - a.lastActivity)
84 .map((s) => s.key),
85 )
86​
87 const selectedKey = createMemo(() => {
88 const chosen = override()
89 if (chosen && state.memory.scopes[chosen]) return chosen
90 return scopeKeys()[0] ?? null
91 })
92​
93 const scope = createMemo((): MemoryScopeState | undefined => {
94 const key = selectedKey()
95 return key ? state.memory.scopes[key] : undefined
96 })
97​
98 const records = createMemo(() => extractRecords(scope()?.snapshot?.data))
99 const facts = createMemo(() => scope()?.snapshot?.facts ?? [])
100 // Timeline newest-first.
101 const events = createMemo(() =>
102 (scope()?.events ?? []).slice().sort((a, b) => b.timestamp - a.timestamp),
103 )
104​
105 return (
106 <div
107 class={styles().memoryPanel.container}
108 data-testid="ai-devtools-memory-panel"
109 >
110 <Show
111 when={scope()}
112 fallback={
113 <div class={styles().memoryPanel.empty}>
114 No memory activity yet. Send a message through a chat wired with
115 <code> memoryMiddleware</code> and recall/save events will appear
116 here.
117 </div>
118 }
119 >
120 {(activeScope) => (
121 <>
122 <div class={styles().memoryPanel.toolbar}>
123 <div class={styles().memoryPanel.scopeControls}>
124 <Show
125 when={scopeKeys().length > 1}
126 fallback={
127 <span class={styles().memoryPanel.badge}>
128 {activeScope().adapter ?? 'memory'}
129 </span>
130 }
131 >
132 <select
133 class={styles().memoryPanel.scopeSelect}
134 value={selectedKey() ?? ''}
135 onChange={(e) => setOverride(e.currentTarget.value)}
136 data-testid="ai-devtools-memory-scope-select"
137 >
138 <For each={scopeKeys()}>
139 {(key) => {
140 const entry = state.memory.scopes[key]
141 const label = entry ? memoryScopeLabel(entry) : key
142 return (
143 <option value={key}>
144 {entry?.adapter ? `${entry.adapter} · ` : ''}
145 {label.length > 40
146 ? `${label.slice(0, 40)}…`
147 : label}
148 </option>
149 )
150 }}
151 </For>
152 </select>
153 </Show>
154 </div>
155 <button
156 type="button"
157 class={styles().memoryPanel.clearButton}
158 onClick={() => {
159 setOverride(null)
160 clearMemory()
161 }}
162 >
163 Clear
164 </button>
165 </div>
166​
167 {/* Live contents (inspect + listFacts) */}
168 <section class={styles().memoryPanel.section}>
169 <div class={styles().memoryPanel.sectionTitle}>
170 Stored records ({records().length})
171 <Show when={activeScope().snapshot}>
172 {(snap) => (
173 <span class={styles().memoryPanel.time}>
174 snapshot {formatTime(snap().takenAt)}
175 </span>
176 )}
177 </Show>
178 </div>
179 <Show
180 when={records().length > 0}
181 fallback={
182 <div class={styles().memoryPanel.sectionEmpty}>
183 {activeScope().snapshot
184 ? 'Snapshot is empty.'
185 : 'This adapter does not expose inspect() — see the timeline below for activity.'}
186 </div>
187 }
188 >
189 <div class={styles().memoryPanel.list}>
190 <For each={records()}>
191 {(rec) => (
192 <div
193 class={styles().memoryPanel.row}
194 data-testid="ai-devtools-memory-record"
195 >
196 <div class={styles().memoryPanel.rowHeader}>
197 <span class={styles().memoryPanel.badge}>
198 {rec.kind}
199 </span>
200 <Show when={rec.role}>
201 <span>{rec.role}</span>
202 </Show>
203 <Show when={rec.importance !== undefined}>
204 <span>importance {rec.importance?.toFixed(2)}</span>
205 </Show>
206 <span class={styles().memoryPanel.time}>
207 {formatTime(rec.createdAt)}
208 </span>
209 </div>
210 <div class={styles().memoryPanel.rowText}>
211 {rec.text}
212 </div>
213 </div>
214 )}
215 </For>
216 </div>
217 </Show>
218 </section>
219​
220 {/* Facts */}
221 <section class={styles().memoryPanel.section}>
222 <div class={styles().memoryPanel.sectionTitle}>
223 listFacts() ({facts().length})
224 </div>
225 <Show
226 when={facts().length > 0}
227 fallback={
228 <div class={styles().memoryPanel.sectionEmpty}>No facts.</div>
229 }
230 >
231 <div class={styles().memoryPanel.list}>
232 <For each={facts()}>
233 {(fact) => (
234 <div class={styles().memoryPanel.row}>
235 <div class={styles().memoryPanel.rowText}>
236 <Show when={fact.source}>
237 <span class={styles().memoryPanel.rowHeader}>
238 {fact.source}:{' '}
239 </span>
240 </Show>
241 {fact.text}
242 </div>
243 </div>
244 )}
245 </For>
246 </div>
247 </Show>
248 </section>
249​
250 {/* Operations timeline */}
251 <section class={styles().memoryPanel.section}>
252 <div class={styles().memoryPanel.sectionTitle}>
253 Operations ({events().length})
254 </div>
255 <Show
256 when={events().length > 0}
257 fallback={
258 <div class={styles().memoryPanel.sectionEmpty}>
259 No operations recorded.
260 </div>
261 }
262 >
263 <div class={styles().memoryPanel.list}>
264 <For each={events()}>
265 {(event) => (
266 <div
267 class={`${styles().memoryPanel.row} ${
268 event.type === 'error'
269 ? styles().memoryPanel.rowError
270 : ''
271 }`}
272 data-testid="ai-devtools-memory-event"
273 >
274 <div class={styles().memoryPanel.rowHeader}>
275 <span class={styles().memoryPanel.badge}>
276 {event.type}
277 </span>
278 <span class={styles().memoryPanel.time}>
279 {formatTime(event.timestamp)}
280 </span>
281 </div>
282 <div class={styles().memoryPanel.rowText}>
283 {eventSummary(event)}
284 </div>
285 </div>
286 )}
287 </For>
288 </div>
289 </Show>
290 </section>
291 </>
292 )}
293 </Show>
294 </div>
295 )