total-recall-brain 3.26.0 → 3.28.0

package/frontend/dist/index.html

@@ -17,7 +17,7 @@
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
     <title>Total Recall — Portable Memory</title>
-    <script type="module" crossorigin src="/assets/index-Bl3I11B0.js"></script>
+    <script type="module" crossorigin src="/assets/index-U7o-qU99.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-C7_Xpk27.css">
   </head>
   <body>

package/frontend/src/App.tsx

@@ -1,7 +1,7 @@
 import { useState, useEffect } from 'react'
 import { BrowserRouter, Routes, Route, NavLink, Navigate, useLocation } from 'react-router-dom'
 import './App.css'
-import { getApiBase, setApiBase, checkSession, logout, registerUnauthedCallback, fetchHealth } from './api'
+import { getApiBase, setApiBase, checkSession, logout, registerUnauthedCallback, fetchHealth, fetchPlugins, type PluginInfo } from './api'
 import type { HealthData } from './types'
 import LoginPage from './pages/LoginPage'
 import ChatPage from './pages/ChatPage'
@@ -19,6 +19,7 @@ import RulesPage from './pages/RulesPage'
 import HelpPage from './pages/HelpPage'
 import GraphPage from './pages/GraphPage'
 import OpenWikiPage from './pages/OpenWikiPage'
+import PluginsPage from './pages/PluginsPage'
 import OnboardingPage from './pages/OnboardingPage'
 import { NotificationsPage } from './pages/NotificationsPage'
 import { isOnboardingComplete } from './utils/onboarding'
@@ -86,6 +87,12 @@ interface SidebarProps {
 const getNavLinkClass = ({ isActive }: { isActive: boolean }) => `nav-link ${isActive ? 'active' : ''}`;
 
 function Sidebar({ onLogout, health, activeBrainId, onBrainChange }: SidebarProps) {
+  const [plugins, setPlugins] = useState<PluginInfo[]>([])
+
+  useEffect(() => {
+    fetchPlugins().then(setPlugins).catch(() => {})
+  }, [])
+
   return (
     <aside className="sidebar">
       <div className="sidebar-brand">
@@ -158,6 +165,36 @@ function Sidebar({ onLogout, health, activeBrainId, onBrainChange }: SidebarProp
           </svg>
           OpenWiki
         </NavLink>
+        <NavLink to="/plugins" className={getNavLinkClass} id="nav-plugins">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round">
+            <path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z" />
+            <polyline points="3.27 6.96 12 12.01 20.73 6.96" />
+            <line x1="12" y1="22.08" x2="12" y2="12" />
+          </svg>
+          Plugins
+        </NavLink>
+
+        {plugins.length > 0 && (
+          <>
+            <div className="nav-section-label">Plugins</div>
+            {plugins.map((p) => (
+              <NavLink
+                key={p.id}
+                to={`/plugins?id=${encodeURIComponent(p.id)}`}
+                className={getNavLinkClass}
+                id={`nav-plugin-${p.id}`}
+                title={p.description}
+              >
+                <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round">
+                  <path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z" />
+                  <polyline points="3.27 6.96 12 12.01 20.73 6.96" />
+                  <line x1="12" y1="22.08" x2="12" y2="12" />
+                </svg>
+                {p.name}
+              </NavLink>
+            ))}
+          </>
+        )}
 
         <div className="nav-section-label">Account</div>
         <NavLink to="/network" className={getNavLinkClass} id="nav-network">
@@ -396,6 +433,7 @@ function MainContent({ activeBrainId, onBrainChange }: { activeBrainId: string;
             <Route path="/tasks" element={<TasksPage />} />
             <Route path="/skills" element={<SkillsPage activeBrainId={activeBrainId} />} />
             <Route path="/openwiki" element={<OpenWikiPage activeBrainId={activeBrainId} />} />
+            <Route path="/plugins" element={<PluginsPage activeBrainId={activeBrainId} />} />
             <Route path="/integrations" element={<IntegrationsPage activeBrainId={activeBrainId} />} />
             <Route path="/keys" element={<Navigate to="/secrets" replace />} />
             <Route path="/settings" element={<SettingsPage activeBrainId={activeBrainId} />} />

package/frontend/src/api/index.ts

@@ -19,3 +19,4 @@ export * from './sessions'
 export * from './integrations'
 export * from './config'
 export * from './secrets'
+export * from './plugins'

package/frontend/src/api/plugins.ts

@@ -0,0 +1,167 @@
+// ─── Plugins domain ───────────────────────────────────────────────────────────
+
+import { apiFetch, API_BASE } from "./_base"
+
+export interface PluginInfo {
+  id: string
+  name: string
+  version: string
+  description: string
+  valid: boolean
+  errors: string[]
+  dir: string
+  rating: number
+  reviewCount: number
+  installCount: string
+  userRating?: number | null
+  userReview?: string | null
+  verified?: boolean
+  categories: Array<{ name: string; description?: string }>
+  tasks: Array<{ intent: string; schedule: string }>
+  openwiki_hubs: Array<{ title: string; path: string }>
+  tools: Array<{ name: string; description?: string }>
+  cli?: { command: string; handler: string } | null
+  manifest?: Record<string, unknown>
+}
+
+export interface CatalogPlugin {
+  id: string
+  name: string
+  version: string
+  description: string
+  tags: string[]
+  author: string
+  sourceUrl: string
+  rating: number
+  reviewCount: number
+  installCount: string
+  userRating?: number | null
+  verified?: boolean
+  isInstalled: boolean
+}
+
+export interface PluginsResponse {
+  success: boolean
+  count: number
+  plugins: PluginInfo[]
+}
+
+export interface CatalogResponse {
+  success: boolean
+  catalog: CatalogPlugin[]
+}
+
+export async function fetchPlugins(): Promise<PluginInfo[]> {
+  try {
+    const res = await apiFetch(`${API_BASE}/api/plugins`)
+    if (!res.ok) return []
+    const data: PluginsResponse = await res.json()
+    return Array.isArray(data.plugins) ? data.plugins : []
+  } catch {
+    return []
+  }
+}
+
+export async function fetchPlugin(id: string): Promise<PluginInfo | null> {
+  try {
+    const res = await apiFetch(`${API_BASE}/api/plugins/${encodeURIComponent(id)}`)
+    if (!res.ok) return null
+    const data = await res.json()
+    return data.plugin || null
+  } catch {
+    return null
+  }
+}
+
+export async function fetchPluginCatalog(): Promise<CatalogPlugin[]> {
+  try {
+    const res = await apiFetch(`${API_BASE}/api/plugins/catalog`)
+    if (!res.ok) return []
+    const data: CatalogResponse = await res.json()
+    return Array.isArray(data.catalog) ? data.catalog : []
+  } catch {
+    return []
+  }
+}
+
+export async function installPlugin(options: { source: string; link?: boolean; global?: boolean }): Promise<{ success: boolean; message?: string; error?: string }> {
+  try {
+    const res = await apiFetch(`${API_BASE}/api/plugins/install`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(options)
+    })
+    const data = await res.json()
+    if (!res.ok) {
+      return { success: false, error: data.error || data.message || "Failed to install plugin" }
+    }
+    return { success: true, message: data.message }
+  } catch (err: any) {
+    return { success: false, error: err.message || "Network error" }
+  }
+}
+
+export async function removePlugin(id: string, global = false): Promise<{ success: boolean; message?: string; error?: string }> {
+  try {
+    const res = await apiFetch(`${API_BASE}/api/plugins/${encodeURIComponent(id)}?global=${global ? "true" : "false"}`, {
+      method: "DELETE"
+    })
+    const data = await res.json()
+    if (!res.ok) {
+      return { success: false, error: data.error || data.message || "Failed to remove plugin" }
+    }
+    return { success: true, message: data.message }
+  } catch (err: any) {
+    return { success: false, error: err.message || "Network error" }
+  }
+}
+
+export async function ratePlugin(id: string, rating: number, review?: string): Promise<{ success: boolean; message?: string; error?: string }> {
+  try {
+    const res = await apiFetch(`${API_BASE}/api/plugins/${encodeURIComponent(id)}/rate`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ rating, review })
+    })
+    const data = await res.json()
+    if (!res.ok) {
+      return { success: false, error: data.error || data.message || "Failed to submit rating" }
+    }
+    return { success: true, message: data.message }
+  } catch (err: any) {
+    return { success: false, error: err.message || "Network error" }
+  }
+}
+
+export async function runPluginCommand(
+  id: string,
+  subcommand = "",
+  args: string[] = []
+): Promise<{ success: boolean; output?: string; error?: string }> {
+  try {
+    const res = await apiFetch(`${API_BASE}/api/plugins/${encodeURIComponent(id)}/run`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ subcommand, args })
+    })
+    const data = await res.json()
+    if (!res.ok) {
+      return { success: false, error: data.error || data.message || "Failed to execute plugin command" }
+    }
+    return { success: true, output: data.output || "" }
+  } catch (err: any) {
+    return { success: false, error: err.message || "Network error" }
+  }
+}
+
+export async function fetchPluginReadme(id: string): Promise<string> {
+  try {
+    const res = await apiFetch(`${API_BASE}/api/plugins/${encodeURIComponent(id)}/readme`)
+    if (!res.ok) return ""
+    const data = await res.json()
+    return data.readme || ""
+  } catch {
+    return ""
+  }
+}
+

package/frontend/src/pages/ChatPage.tsx

@@ -62,14 +62,26 @@ export default function ChatPage({ activeBrainId, onBrainChange }: { activeBrain
   const [nodeSearchQuery, setNodeSearchQuery] = useState('')
   const nodeSelectorRef = useRef<HTMLDivElement>(null)
 
+const DEFAULT_GEMINI_MODELS = [
+  { id: 'gemini-3.8-flash-high', displayName: 'Gemini 3.8 Flash (High)' },
+  { id: 'gemini-3.8-flash-medium', displayName: 'Gemini 3.8 Flash (Medium)' },
+  { id: 'gemini-3.8-flash-low', displayName: 'Gemini 3.8 Flash (Low)' },
+  { id: 'gemini-3.7-flash-high', displayName: 'Gemini 3.7 Flash (High)' },
+  { id: 'gemini-3.7-flash-medium', displayName: 'Gemini 3.7 Flash (Medium)' },
+  { id: 'gemini-3.6-flash-high', displayName: 'Gemini 3.6 Flash (High)' },
+  { id: 'gemini-3.1-pro-high', displayName: 'Gemini 3.1 Pro (High)' },
+  { id: 'gemini-3.5-flash', displayName: 'Gemini 3.5 Flash' },
+  { id: 'gemini-3.5-pro', displayName: 'Gemini 3.5 Pro' },
+]
+
   // Model Selector state
   const [availableModels, setAvailableModels] = useState<string[]>([])
   const [selectedModel, setSelectedModel] = useState<string>(() => {
     const saved = localStorage.getItem('selectedModel');
     return (saved && saved !== 'gemini') ? saved : 'antigravity';
   })
-  const [selectedSubModel, setSelectedSubModel] = useState<string>(() => localStorage.getItem('selectedSubModel') || '')
-  const [geminiModels, setGeminiModels] = useState<{ id: string; displayName: string }[]>([])
+  const [selectedSubModel, setSelectedSubModel] = useState<string>(() => localStorage.getItem('selectedSubModel') || 'gemini-3.8-flash-high')
+  const [geminiModels, setGeminiModels] = useState<{ id: string; displayName: string }[]>(DEFAULT_GEMINI_MODELS)
   const [showModelDropdown, setShowModelDropdown] = useState(false)
   const dropdownRef = useRef<HTMLDivElement>(null)
 
@@ -144,19 +156,28 @@ export default function ChatPage({ activeBrainId, onBrainChange }: { activeBrain
 
     fetchGeminiModels()
       .then(models => {
-        setGeminiModels(models)
-        if (models && models.length > 0) {
-          const savedSub = localStorage.getItem('selectedSubModel');
-          const exists = models.some(m => m.id === savedSub);
-          if (savedSub && exists) {
-            setSelectedSubModel(savedSub);
-          } else {
-            setSelectedSubModel(models[0].id);
-            localStorage.setItem('selectedSubModel', models[0].id);
-          }
+        const list = models && models.length > 0 ? models : DEFAULT_GEMINI_MODELS;
+        setGeminiModels(list);
+        const savedSub = localStorage.getItem('selectedSubModel');
+        const exists = list.some(m => m.id === savedSub);
+        if (savedSub && exists) {
+          setSelectedSubModel(savedSub);
+        } else {
+          setSelectedSubModel(list[0].id);
+          localStorage.setItem('selectedSubModel', list[0].id);
+        }
+      })
+      .catch(() => {
+        setGeminiModels(DEFAULT_GEMINI_MODELS);
+        const savedSub = localStorage.getItem('selectedSubModel');
+        const exists = DEFAULT_GEMINI_MODELS.some(m => m.id === savedSub);
+        if (savedSub && exists) {
+          setSelectedSubModel(savedSub);
+        } else {
+          setSelectedSubModel(DEFAULT_GEMINI_MODELS[0].id);
+          localStorage.setItem('selectedSubModel', DEFAULT_GEMINI_MODELS[0].id);
         }
       })
-      .catch(console.error)
   // eslint-disable-next-line react-hooks/exhaustive-deps -- onBrainChange is stable from parent
   }, [])
 
@@ -380,7 +401,7 @@ export default function ChatPage({ activeBrainId, onBrainChange }: { activeBrain
         return;
       }
 
-      const modelWithSubModel = ['gemini', 'antigravity'].includes(selectedModel) && selectedSubModel
+      const modelWithSubModel = ['gemini', 'antigravity', 'agy'].includes(selectedModel) && selectedSubModel
         ? `${selectedModel}:${selectedSubModel}`
         : selectedModel
 
@@ -409,7 +430,7 @@ export default function ChatPage({ activeBrainId, onBrainChange }: { activeBrain
     setLoading(true)
     abortControllerRef.current = new AbortController()
     try {
-      const modelWithSubModel = ['gemini', 'antigravity'].includes(selectedModel) && selectedSubModel
+      const modelWithSubModel = ['gemini', 'antigravity', 'agy'].includes(selectedModel) && selectedSubModel
         ? `${selectedModel}:${selectedSubModel}`
         : selectedModel
 
@@ -599,7 +620,12 @@ export default function ChatPage({ activeBrainId, onBrainChange }: { activeBrain
                 }}
                 title="Select CLI agent / provider"
               >
-                <span style={{ textTransform: 'capitalize' }}>{selectedModel || 'Select Model'}</span>
+                <span style={{ textTransform: 'capitalize' }}>
+                  {selectedModel || 'Select Model'}
+                  {['gemini', 'antigravity', 'agy'].includes(selectedModel) && selectedSubModel
+                    ? ` · ${geminiModels.find(m => m.id === selectedSubModel)?.displayName || selectedSubModel}`
+                    : ''}
+                </span>
                 <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round">
                   <polyline points="6 9 12 15 18 9"></polyline>
                 </svg>
@@ -629,6 +655,7 @@ export default function ChatPage({ activeBrainId, onBrainChange }: { activeBrain
                         <span className="model-selector-item-name" style={{ textTransform: 'capitalize' }}>{modelName}</span>
                         <span className="model-selector-item-desc">
                           {modelName === 'antigravity' && 'Google Antigravity'}
+                          {modelName === 'agy' && 'Google Antigravity'}
                           {modelName === 'grok' && 'xAI Grok Build CLI'}
                           {modelName === 'gemini' && 'Google Gemini CLI'}
                           {modelName === 'claude' && 'Anthropic Claude CLI'}
@@ -641,7 +668,7 @@ export default function ChatPage({ activeBrainId, onBrainChange }: { activeBrain
                 </div>
               )}
             </div>
-            {['gemini', 'antigravity'].includes(selectedModel) && geminiModels.length > 0 && (
+            {['gemini', 'antigravity', 'agy'].includes(selectedModel) && geminiModels.length > 0 && (
               <div className="chat-header-submodel-selector" style={{ display: 'flex', alignItems: 'center', gap: 8, marginLeft: 16 }}>
                 <span className="selector-label" style={{ fontSize: '12px', color: 'var(--text-tertiary)', fontWeight: 500 }}>Base:</span>
                 <select

package/frontend/src/pages/IntegrationsPage.tsx

@@ -66,6 +66,13 @@ const PRESETS: Preset[] = [
     command: 'npx total-recall connect hermes',
     snippet: () => `Pushes truncated memory surface projections to autonomous Hermes.`
   },
+  {
+    id: 'dsh',
+    name: 'DeepSeek Harness (dsh)',
+    surface: 'AGENTS.md / ~/.dsh/memory/MEMORY.md',
+    command: 'npx total-recall connect dsh',
+    snippet: () => `Integrates SSSS memory and skills into DeepSeek Harness agent runtimes.`
+  },
   {
     id: 'openclaw',
     name: 'OpenClaw',

package/frontend/src/pages/PluginsPage.spec.tsx

@@ -0,0 +1,17 @@
+import { describe, it, expect, vi } from 'vitest';
+import { render, screen } from '@testing-library/react';
+import PluginsPage from './PluginsPage';
+
+// Mock fetch globally
+const mockFetch = vi.fn().mockResolvedValue({
+  ok: true,
+  json: async () => ({ installed: [], catalog: [] })
+});
+globalThis.fetch = mockFetch as unknown as typeof fetch;
+
+describe('PluginsPage', () => {
+  it('renders plugins page', () => {
+    render(<PluginsPage />);
+    expect(screen.getByText(/Plugin/i)).toBeInTheDocument();
+  });
+});