total-recall-brain 3.14.4 → 3.14.7

package/frontend/src/api/api.spec.ts

@@ -0,0 +1,297 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+
+// Mock fetch globally before importing API functions
+const mockFetch = vi.fn()
+vi.stubGlobal('fetch', mockFetch)
+
+// Mock localStorage
+const localStorageMock = (() => {
+  let store: Record<string, string> = {}
+  return {
+    getItem: (key: string) => store[key] ?? null,
+    setItem: (key: string, value: string) => { store[key] = value },
+    removeItem: (key: string) => { delete store[key] },
+    clear: () => { store = {} },
+  }
+})()
+vi.stubGlobal('localStorage', localStorageMock)
+
+// Import from the barrel
+import {
+  // _base
+  getApiBase,
+  setApiBase,
+  registerUnauthedCallback,
+  clearUnauthedCallback,
+  // auth
+  checkSession,
+  login,
+  logout,
+  changePassword,
+  getAuthStatus,
+  setupPassword,
+  // chat
+  sendChat,
+  fetchChatHistory,
+  fetchChatThreads,
+  deleteChatThread,
+  fetchChatSuggestions,
+  fetchTtsStatus,
+  fetchTtsAudio,
+  // memory
+  listMemory,
+  searchMemory,
+  readMemory,
+  saveMemory,
+  createMemory,
+  deleteMemory,
+  fetchMemoryStats,
+  fetchGraph,
+  fetchConflicts,
+  resolveConflict,
+  fetchVaultStatus,
+  fetchOpenWikiNodes,
+  // sandbox
+  runSandbox,
+  // skills
+  listSkills,
+  fetchSkill,
+  fetchSkillFiles,
+  saveSkill,
+  deleteSkill,
+  searchSkillsRegistry,
+  installRegistrySkill,
+  toggleSkillRepo,
+  auditSkill,
+  // keys
+  listApiKeys,
+  issueApiKey,
+  revokeApiKey,
+  scanEnvSecrets,
+  parseEnvPaste,
+  importEnvSecrets,
+  fetchSecretsCatalog,
+  updateSecretMeta,
+  rotateSecretValue,
+  deleteProviderSecret,
+  recordSecretUsage,
+  exportEnvFromSecrets,
+  fetchRotationDue,
+  enqueueRotationDue,
+  revealSecretValue,
+  fetchWebAuthnStatus,
+  webauthnRegisterOptions,
+  webauthnRegisterVerify,
+  webauthnAssertOptions,
+  webauthnAssertVerify,
+  webauthnPasswordStepUp,
+  deletePasskey,
+  // research
+  listResearch,
+  createResearch,
+  patchResearch,
+  deleteResearch,
+  // system
+  fetchHealth,
+  fetchUsageStats,
+  fetchLogs,
+  triggerRecompile,
+  triggerDream,
+  runAgentDiagnostics,
+  fetchBrains,
+  listTasks,
+  createTask,
+  listFiles,
+  listScripts,
+  readScript,
+  saveScript,
+  runScript,
+  shareToApi,
+  runOkfLint,
+  triggerOkfExport,
+  postDecision,
+  // update
+  checkUpdate,
+  runUpdate,
+  // models
+  fetchGeminiModels,
+  fetchClaudeModels,
+  fetchOpenaiModels,
+  fetchOpenRouterModels,
+  // docs
+  fetchDesignDocs,
+  fetchDesignDocContent,
+  fetchDocs,
+  readDoc,
+  createDoc,
+  updateDoc,
+  deleteDoc,
+  fetchViews,
+  createView,
+  deleteView,
+  fetchInstructions,
+  fetchInstructionContent,
+  fetchHelpTopics,
+  fetchHelpContent,
+  // extension
+  fetchExtensionStatus,
+  // sessions
+  fetchSessions,
+  deleteSession,
+  // integrations
+  connectClient,
+  fetchActiveIntegrations,
+  // config
+  fetchConfig,
+  saveConfig,
+  fetchConfigJson,
+  saveConfigJson,
+} from './index'
+
+function makeOkResponse(body: unknown = {}) {
+  return Promise.resolve({
+    ok: true,
+    status: 200,
+    json: () => Promise.resolve(body),
+    blob: () => Promise.resolve(new Blob()),
+  } as Response)
+}
+
+beforeEach(() => {
+  mockFetch.mockReset()
+  mockFetch.mockImplementation(() => makeOkResponse())
+})
+
+describe('API barrel exports — all functions exist', () => {
+  const fns = [
+    // _base
+    getApiBase, setApiBase, registerUnauthedCallback, clearUnauthedCallback,
+    // auth
+    checkSession, login, logout, changePassword, getAuthStatus, setupPassword,
+    // chat
+    sendChat, fetchChatHistory, fetchChatThreads, deleteChatThread, fetchChatSuggestions,
+    fetchTtsStatus, fetchTtsAudio,
+    // memory
+    listMemory, searchMemory, readMemory, saveMemory, createMemory, deleteMemory,
+    fetchMemoryStats, fetchGraph, fetchConflicts, resolveConflict, fetchVaultStatus, fetchOpenWikiNodes,
+    // sandbox
+    runSandbox,
+    // skills
+    listSkills, fetchSkill, fetchSkillFiles, saveSkill, deleteSkill,
+    searchSkillsRegistry, installRegistrySkill, toggleSkillRepo, auditSkill,
+    // keys
+    listApiKeys, issueApiKey, revokeApiKey, scanEnvSecrets, parseEnvPaste, importEnvSecrets,
+    fetchSecretsCatalog, updateSecretMeta, rotateSecretValue, deleteProviderSecret, recordSecretUsage,
+    exportEnvFromSecrets, fetchRotationDue, enqueueRotationDue, revealSecretValue,
+    fetchWebAuthnStatus, webauthnRegisterOptions, webauthnRegisterVerify,
+    webauthnAssertOptions, webauthnAssertVerify, webauthnPasswordStepUp, deletePasskey,
+    // research
+    listResearch, createResearch, patchResearch, deleteResearch,
+    // system
+    fetchHealth, fetchUsageStats, fetchLogs, triggerRecompile, triggerDream, runAgentDiagnostics,
+    fetchBrains, listTasks, createTask, listFiles, listScripts, readScript, saveScript, runScript,
+    shareToApi, runOkfLint, triggerOkfExport, postDecision,
+    // update
+    checkUpdate, runUpdate,
+    // models
+    fetchGeminiModels, fetchClaudeModels, fetchOpenaiModels, fetchOpenRouterModels,
+    // docs
+    fetchDesignDocs, fetchDesignDocContent, fetchDocs, readDoc, createDoc, updateDoc, deleteDoc,
+    fetchViews, createView, deleteView, fetchInstructions, fetchInstructionContent,
+    fetchHelpTopics, fetchHelpContent,
+    // extension
+    fetchExtensionStatus,
+    // sessions
+    fetchSessions, deleteSession,
+    // integrations
+    connectClient, fetchActiveIntegrations,
+    // config
+    fetchConfig, saveConfig, fetchConfigJson, saveConfigJson,
+  ]
+
+  it('exports all functions as typeof function', () => {
+    for (const fn of fns) {
+      expect(typeof fn, `${fn.name} should be a function`).toBe('function')
+    }
+  })
+})
+
+describe('checkSession', () => {
+  it('returns true when fetch succeeds with ok response', async () => {
+    mockFetch.mockResolvedValueOnce({ ok: true } as Response)
+    const result = await checkSession()
+    expect(result).toBe(true)
+  })
+
+  it('returns false on network error', async () => {
+    mockFetch.mockRejectedValueOnce(new Error('Network error'))
+    const result = await checkSession()
+    expect(result).toBe(false)
+  })
+})
+
+describe('login', () => {
+  it('returns ok:true on successful login', async () => {
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      json: () => Promise.resolve({ requiresPasswordReset: false }),
+    } as Response)
+    const result = await login('password123')
+    expect(result.ok).toBe(true)
+  })
+
+  it('returns ok:false with error on failed login', async () => {
+    mockFetch.mockResolvedValueOnce({
+      ok: false,
+      json: () => Promise.resolve({ error: 'Invalid password' }),
+    } as Response)
+    const result = await login('wrongpassword')
+    expect(result.ok).toBe(false)
+    expect(result.error).toBe('Invalid password')
+  })
+})
+
+describe('getApiBase', () => {
+  it('returns the current API base URL', () => {
+    const base = getApiBase()
+    expect(typeof base).toBe('string')
+  })
+})
+
+describe('fetchExtensionStatus', () => {
+  it('returns unavailable on non-ok response', async () => {
+    mockFetch.mockResolvedValueOnce({ ok: false, status: 404 } as Response)
+    const result = await fetchExtensionStatus()
+    expect(result).toEqual({ available: false, connected: false })
+  })
+
+  it('returns extension status on ok response', async () => {
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      json: () => Promise.resolve({ available: true, connected: true }),
+    } as Response)
+    const result = await fetchExtensionStatus()
+    expect(result).toEqual({ available: true, connected: true })
+  })
+})
+
+describe('runSandbox', () => {
+  it('returns success result on ok response', async () => {
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      json: () => Promise.resolve({ success: true, output: 'hello' }),
+    } as Response)
+    const result = await runSandbox('console.log("hello")')
+    expect(result.success).toBe(true)
+    expect(result.output).toBe('hello')
+    expect(result.isError).toBe(false)
+  })
+
+  it('returns error result on fetch exception', async () => {
+    mockFetch.mockRejectedValueOnce(new Error('Connection refused'))
+    const result = await runSandbox('bad code')
+    expect(result.success).toBe(false)
+    expect(result.isError).toBe(true)
+  })
+})

package/frontend/src/api/auth.ts

@@ -0,0 +1,73 @@
+// ─── Auth domain ──────────────────────────────────────────────────────────────
+
+import { API_BASE } from './_base'
+
+export async function checkSession(): Promise<boolean> {
+  try {
+    const res = await fetch(API_BASE + '/auth/me', { credentials: 'include' })
+    return res.ok
+  } catch {
+    return false
+  }
+}
+
+export async function login(password: string): Promise<{ ok: boolean; requiresPasswordReset?: boolean; error?: string }> {
+  try {
+    const res = await fetch(API_BASE + '/auth/login', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      credentials: 'include',
+      body: JSON.stringify({ password }),
+    })
+    const data = await res.json().catch(() => ({}))
+    if (res.ok) return { ok: true, requiresPasswordReset: data.requiresPasswordReset }
+    return { ok: false, error: data.error || 'Invalid password' }
+  } catch {
+    return { ok: false, error: 'Network error — is the server running?' }
+  }
+}
+
+export async function changePassword(newPassword: string): Promise<{ ok: boolean; error?: string }> {
+  try {
+    const res = await fetch(API_BASE + '/auth/change-password', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      credentials: 'include',
+      body: JSON.stringify({ newPassword }),
+    })
+    if (res.ok) return { ok: true }
+    const data = await res.json().catch(() => ({}))
+    return { ok: false, error: data.error || 'Failed to change password' }
+  } catch {
+    return { ok: false, error: 'Network error' }
+  }
+}
+
+export async function getAuthStatus(): Promise<{ configured: boolean }> {
+  try {
+    const res = await fetch(API_BASE + "/auth/status")
+    if (res.ok) return await res.json()
+    return { configured: true }
+  } catch {
+    return { configured: true }
+  }
+}
+
+export async function setupPassword(newPassword: string): Promise<{ ok: boolean; error?: string }> {
+  try {
+    const res = await fetch(API_BASE + "/auth/setup", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ newPassword }),
+    })
+    const data = await res.json().catch(() => ({}))
+    if (res.ok) return { ok: true }
+    return { ok: false, error: data.error || "Failed to setup password" }
+  } catch {
+    return { ok: false, error: "Network error — is the server running?" }
+  }
+}
+
+export async function logout(): Promise<void> {
+  await fetch(API_BASE + '/auth/logout', { method: 'POST', credentials: 'include' }).catch(() => {})
+}

package/frontend/src/api/chat.ts

@@ -0,0 +1,93 @@
+// ─── Chat domain ──────────────────────────────────────────────────────────────
+
+import { apiFetch, API_BASE } from './_base'
+
+export interface ChatThread {
+  id: string
+  title: string
+  turns: number
+  lastUpdated: number
+  brainId: string
+}
+
+export interface ChatSuggestion {
+  type: string
+  title: string
+  text: string
+  nodes: string[]
+}
+
+export async function sendChat(
+  messages: { role: string; content: string }[],
+  signal?: AbortSignal,
+  sessionId?: string,
+  groundingNodes?: string[],
+  model?: string,
+  brainId?: string
+): Promise<string> {
+  const headers: Record<string, string> = { 'Content-Type': 'application/json' }
+  if (sessionId) {
+    headers['x-session-id'] = sessionId
+  }
+  const res = await apiFetch(API_BASE + '/v1/chat/completions', {
+    method: 'POST',
+    signal,
+    headers,
+    body: JSON.stringify({ messages, groundingNodes, model, brainId }),
+  })
+  if (!res.ok) throw new Error(`Chat API error: ${res.status}`)
+  const data = await res.json()
+  return data.choices?.[0]?.message?.content ?? '(empty response)'
+}
+
+export async function fetchChatHistory(sessionId?: string): Promise<{ role: string; content: string }[]> {
+  const headers: Record<string, string> = {}
+  if (sessionId) {
+    headers['x-session-id'] = sessionId
+  }
+  const res = await apiFetch(API_BASE + '/v1/chat/history', { headers })
+  if (!res.ok) throw new Error(`Chat history error: ${res.status}`)
+  const data = await res.json()
+  return data.messages ?? []
+}
+
+export async function fetchChatThreads(): Promise<ChatThread[]> {
+  const res = await apiFetch(API_BASE + '/v1/chat/threads')
+  if (!res.ok) throw new Error(`Chat threads list error: ${res.status}`)
+  return res.json()
+}
+
+export async function deleteChatThread(id: string): Promise<{ deleted: boolean; id: string }> {
+  const res = await apiFetch(API_BASE + `/v1/chat/threads/${id}`, { method: 'DELETE' })
+  if (!res.ok) throw new Error(`Delete chat thread error: ${res.status}`)
+  return res.json()
+}
+
+export async function fetchChatSuggestions(): Promise<ChatSuggestion[]> {
+  const res = await apiFetch(API_BASE + '/v1/chat/suggestions')
+  if (!res.ok) throw new Error(`Chat suggestions list error: ${res.status}`)
+  return res.json()
+}
+
+// ─── TTS (Kokoro-82M) ──────────────────────────────────────────────────────────
+
+export async function fetchTtsStatus(): Promise<{ enabled: boolean }> {
+  try {
+    const res = await apiFetch(API_BASE + '/api/tts/status')
+    if (!res.ok) return { enabled: false }
+    return res.json()
+  } catch {
+    return { enabled: false }
+  }
+}
+
+export async function fetchTtsAudio(text: string): Promise<Blob | null> {
+  const res = await apiFetch(API_BASE + '/api/tts', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ text }),
+  })
+  if (res.status === 503) return null  // Kokoro not configured — caller should fall back.
+  if (!res.ok) throw new Error(`TTS error: ${res.status}`)
+  return res.blob()
+}

package/frontend/src/api/config.ts

@@ -0,0 +1,35 @@
+// ─── Config domain ────────────────────────────────────────────────────────────
+
+import { apiFetch, API_BASE } from './_base'
+import type { ConfigJson } from './_base'
+
+export async function fetchConfig(name: string): Promise<string> {
+  const res = await apiFetch(`${API_BASE}/api/config/${name}`)
+  if (!res.ok) throw new Error(`Config API error: ${res.status}`)
+  const data = await res.json()
+  return data.content
+}
+
+export async function saveConfig(name: string, content: string): Promise<void> {
+  const res = await apiFetch(`${API_BASE}/api/config/${name}`, {
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ content }),
+  })
+  if (!res.ok) throw new Error(`Config API error: ${res.status}`)
+}
+
+export async function fetchConfigJson(): Promise<ConfigJson> {
+  const res = await apiFetch(`${API_BASE}/api/config-json`)
+  if (!res.ok) throw new Error(`Config JSON API error: ${res.status}`)
+  return res.json()
+}
+
+export async function saveConfigJson(config: ConfigJson): Promise<void> {
+  const res = await apiFetch(`${API_BASE}/api/config-json`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(config),
+  })
+  if (!res.ok) throw new Error(`Config JSON API error: ${res.status}`)
+}

package/frontend/src/api/docs.ts

@@ -0,0 +1,146 @@
+// ─── Docs domain ──────────────────────────────────────────────────────────────
+
+import { apiFetch, API_BASE } from './_base'
+
+// ─── Design Docs ──────────────────────────────────────────────────────────────
+
+export async function fetchDesignDocs(): Promise<Array<{ name: string; path: string; size: number; modified: string; category: string }>> {
+  const res = await apiFetch(`${API_BASE}/api/files?path=docs`)
+  if (!res.ok) throw new Error(`Design docs error: ${res.status}`)
+  return res.json()
+}
+
+export async function fetchDesignDocContent(path: string): Promise<{ content: string }> {
+  const res = await apiFetch(`${API_BASE}/api/files?path=${encodeURIComponent(path)}&content=true`)
+  if (!res.ok) throw new Error(`Design doc content error: ${res.status}`)
+  return res.json()
+}
+
+// ─── Vault Documents ──────────────────────────────────────────────────────────
+
+export interface VaultDocument extends Record<string, unknown> {
+  id?: string
+  type?: string
+  name?: string
+  path: string
+  status?: string
+  portability?: string
+  updatedAt?: string | number
+}
+
+export interface DocsResponse {
+  docs: VaultDocument[]
+}
+
+export interface DocumentResponse {
+  raw: string
+}
+
+export interface SavedView {
+  id: string
+  name: string
+  filters: Record<string, string>
+}
+
+export async function fetchDocs(brain?: string, params?: Record<string, string>): Promise<DocsResponse> {
+  const p = new URLSearchParams()
+  if (brain) p.set('brain', brain)
+  if (params) {
+    for (const [k, v] of Object.entries(params)) if (v) p.set(k, v)
+  }
+  const res = await apiFetch(`/api/docs?${p.toString()}`)
+  if (!res.ok) throw new Error('Failed to fetch docs')
+  return res.json()
+}
+
+export async function readDoc(path: string, brain?: string): Promise<DocumentResponse> {
+  const p = new URLSearchParams({ path })
+  if (brain) p.set('brain', brain)
+  const res = await apiFetch(`/api/docs/read?${p.toString()}`)
+  if (!res.ok) throw new Error('Failed to read doc')
+  return res.json()
+}
+
+export async function createDoc(path: string, content: string, brain?: string) {
+  const res = await apiFetch('/api/docs', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ path, content, brainId: brain })
+  })
+  if (!res.ok) throw new Error('Failed to create doc')
+  return res.json()
+}
+
+export async function updateDoc(path: string, content: string, brain?: string) {
+  const res = await apiFetch('/api/docs', {
+    method: 'PUT',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ path, content, brainId: brain })
+  })
+  if (!res.ok) throw new Error('Failed to update doc')
+  return res.json()
+}
+
+export async function deleteDoc(path: string, brain?: string) {
+  const p = new URLSearchParams({ path })
+  if (brain) p.set('brain', brain)
+  const res = await apiFetch(`/api/docs?${p.toString()}`, { method: 'DELETE' })
+  if (!res.ok) throw new Error('Failed to delete doc')
+  return res.json()
+}
+
+export async function fetchViews(): Promise<SavedView[]> {
+  const res = await apiFetch('/api/views')
+  if (!res.ok) throw new Error('Failed to fetch views')
+  return res.json()
+}
+
+export async function createView(name: string, filters: Record<string, string>) {
+  const res = await apiFetch('/api/views', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ name, filters })
+  })
+  if (!res.ok) throw new Error('Failed to create view')
+  return res.json()
+}
+
+export async function deleteView(id: string) {
+  const res = await apiFetch(`/api/views/${id}`, { method: 'DELETE' })
+  if (!res.ok) throw new Error('Failed to delete view')
+  return res.json()
+}
+
+// ─── Instructions ─────────────────────────────────────────────────────────────
+
+export async function fetchInstructions(): Promise<{ surfaces: Array<{ name: string; filename: string; size: number; lastCompiled: string; active: boolean }>; lastCompileTimestamp: string; totalNodes: number }> {
+  const res = await apiFetch(`${API_BASE}/api/dashboard/instructions`)
+  if (!res.ok) throw new Error(`Instructions API error: ${res.status}`)
+  return res.json()
+}
+
+export async function fetchInstructionContent(name: string): Promise<{ name: string; content: string }> {
+  const res = await apiFetch(`${API_BASE}/api/ssss/instructions?surface=${encodeURIComponent(name)}`)
+  if (!res.ok) throw new Error(`Instruction content error: ${res.status}`)
+  return res.json()
+}
+
+// ─── Help ──────────────────────────────────────────────────────────────────────
+
+export interface HelpTopic {
+  id: string
+  title: string
+  description: string
+}
+
+export async function fetchHelpTopics(): Promise<{ topics: HelpTopic[] }> {
+  const res = await apiFetch(`${API_BASE}/api/help`)
+  if (!res.ok) throw new Error('Failed to load help topics')
+  return res.json()
+}
+
+export async function fetchHelpContent(topicId: string): Promise<{ topic: string; content: string }> {
+  const res = await apiFetch(`${API_BASE}/api/help?topic=${encodeURIComponent(topicId)}`)
+  if (!res.ok) throw new Error('Failed to load help content')
+  return res.json()
+}

package/frontend/src/api/extension.ts

@@ -0,0 +1,9 @@
+// ─── Extension domain ─────────────────────────────────────────────────────────
+
+import { apiFetch, API_BASE } from './_base'
+
+export async function fetchExtensionStatus(): Promise<{ available: boolean; connected: boolean }> {
+  const res = await apiFetch(`${API_BASE}/api/extension/status`)
+  if (!res.ok) return { available: false, connected: false }
+  return res.json()
+}

package/frontend/src/api/index.ts

@@ -0,0 +1,20 @@
+// ─── Barrel re-export — all domain modules ────────────────────────────────────
+// Imports from '../api' or '../../api' will resolve here automatically via
+// TypeScript module resolution (directory index).
+
+export * from './_base'
+export * from './auth'
+export * from './chat'
+export * from './memory'
+export * from './sandbox'
+export * from './skills'
+export * from './keys'
+export * from './research'
+export * from './system'
+export * from './update'
+export * from './models'
+export * from './docs'
+export * from './extension'
+export * from './sessions'
+export * from './integrations'
+export * from './config'