import { API_V1, CREDENTIALS, checkTenant, signal, UNAUTHORIZED_EVENT } from "../apiContract"; import type { Result } from "../query/queryApi"; export type MemoryKind = "person" | "preference" | "fact"; export type MemoryOrder = "newest" | "oldest"; export interface MemoryEntry { id: string; text: string; kind: MemoryKind; scope: "personal" | "company"; sources: Array<{ database: string; fields: string[] }>; door: string; at: string; } export interface MemoryList { entries: MemoryEntry[]; total: number; dropped: number; next: string | null; } function record(raw: unknown): Record | null { return raw && typeof raw === "object" && !Array.isArray(raw) ? raw as Record : null; } function entry(raw: unknown): MemoryEntry | null { const row = record(raw); if (!row || typeof row.id !== "string" || !row.id || typeof row.text !== "string") return null; if (row.scope !== undefined && row.scope !== "personal" && row.scope !== "company") return null; if (row.kind !== undefined && !["person", "preference", "fact"].includes(String(row.kind))) return null; return { id: row.id, text: row.text, kind: (row.kind || "fact") as MemoryKind, scope: row.scope === "company" ? "company" : "personal", sources: (Array.isArray(row.sources) ? row.sources : []).flatMap((rawSource) => { const source = record(rawSource); return source && typeof source.database === "string" ? [{ database: source.database, fields: Array.isArray(source.fields) ? source.fields.filter((field): field is string => typeof field === "string") : [] }] : []; }), door: typeof row.door === "string" ? row.door : "", at: typeof row.at === "string" ? row.at : "", }; } async function request(url: string, method: string, parse: (body: unknown) => T | null): Promise> { try { const response = await fetch(url, { method, credentials: CREDENTIALS, cache: "no-store" }); if (checkTenant(response)) return { ok: false, status: 401, message: "Your session changed. Sign in again." }; if (response.status === 401) signal(UNAUTHORIZED_EVENT); if (!response.ok) return { ok: false, status: response.status, message: "Memory could not be saved. Try again." }; const value = parse(await response.json().catch(() => null)); return value === null ? { ok: false, status: response.status, message: "Memory could not be loaded. Try again." } : { ok: true, value }; } catch { return { ok: false, status: 0, message: "Cannot reach the server." }; } } /** Follow the server cursor in the selected order, defaulting to newest first. */ export function fetchMemory(next?: string | null, order?: MemoryOrder): Promise> { const params = new URLSearchParams(); if (next) params.set("cursor", next); if (order) params.set("order", order); const page = params.size ? `?${params}` : ""; return request(`${API_V1}/assistant/memory${page}`, "GET", (raw) => { const body = record(raw); if (!body || !Array.isArray(body.entries)) return null; const entries = body.entries.map(entry); if (entries.some((row) => row === null)) return null; return { entries: entries as MemoryEntry[], total: typeof body.total === "number" ? body.total : entries.length, dropped: typeof body.dropped === "number" ? body.dropped : 0, next: typeof body.next === "string" && body.next ? body.next : null }; }); } export function eraseMemory(id: string): Promise> { return request(`${API_V1}/assistant/memory/${encodeURIComponent(id)}`, "DELETE", () => true); } export function promoteMemory(id: string): Promise> { return request(`${API_V1}/assistant/memory/${encodeURIComponent(id)}/promote`, "POST", () => true); }