@geminilight/mindos 0.6.31 → 0.6.33

package/app/app/api/ask/route.ts

@@ -1,5 +1,7 @@
 export const dynamic = 'force-dynamic';
 import type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';
+import { isTransientError } from '@/lib/agent/retry';
+import { detectLoop } from '@/lib/agent/loop-detection';
 import {
   type AgentSessionEvent as AgentEvent,
   AuthStorage,
@@ -45,7 +47,8 @@ type MindOSSSEvent =
   | { type: 'tool_start'; toolCallId: string; toolName: string; args: unknown }
   | { type: 'tool_end'; toolCallId: string; output: string; isError: boolean }
   | { type: 'done'; usage?: { input: number; output: number } }
-  | { type: 'error'; message: string };
+  | { type: 'error'; message: string }
+  | { type: 'status'; message: string };
 
 // ---------------------------------------------------------------------------
 // Type Guards for AgentEvent variants (safe event handling)
@@ -335,16 +338,40 @@ export async function POST(req: NextRequest) {
     const targetDir = dirnameOf(currentFile);
     const bootstrap = {
       instruction: readKnowledgeFile('INSTRUCTION.md'),
-      index: readKnowledgeFile('README.md'),
       config_json: readKnowledgeFile('CONFIG.json'),
-      config_md: readKnowledgeFile('CONFIG.md'),
-      target_readme: targetDir ? readKnowledgeFile(`${targetDir}/README.md`) : null,
-      target_instruction: targetDir ? readKnowledgeFile(`${targetDir}/INSTRUCTION.md`) : null,
-      target_config_json: targetDir ? readKnowledgeFile(`${targetDir}/CONFIG.json`) : null,
-      target_config_md: targetDir ? readKnowledgeFile(`${targetDir}/CONFIG.md`) : null,
+      // Lazy-loaded: only read if the file exists and has content.
+      // README.md and CONFIG.md are often empty/boilerplate and waste tokens.
+      index: null as ReturnType<typeof readKnowledgeFile> | null,
+      config_md: null as ReturnType<typeof readKnowledgeFile> | null,
+      target_readme: null as ReturnType<typeof readKnowledgeFile> | null,
+      target_instruction: null as ReturnType<typeof readKnowledgeFile> | null,
+      target_config_json: null as ReturnType<typeof readKnowledgeFile> | null,
+      target_config_md: null as ReturnType<typeof readKnowledgeFile> | null,
     };
 
-    // Only report failures + truncation warnings
+    // Only load secondary bootstrap files if they have meaningful content.
+    // Files with ≤10 chars are typically empty or just a heading — not worth
+    // injecting into the prompt (saves ~200-500 tokens per empty file).
+    const MIN_USEFUL_CONTENT_LENGTH = 10;
+
+    const indexResult = readKnowledgeFile('README.md');
+    if (indexResult.ok && indexResult.content.trim().length > MIN_USEFUL_CONTENT_LENGTH) bootstrap.index = indexResult;
+
+    const configMdResult = readKnowledgeFile('CONFIG.md');
+    if (configMdResult.ok && configMdResult.content.trim().length > MIN_USEFUL_CONTENT_LENGTH) bootstrap.config_md = configMdResult;
+
+    if (targetDir) {
+      const tr = readKnowledgeFile(`${targetDir}/README.md`);
+      if (tr.ok && tr.content.trim().length > MIN_USEFUL_CONTENT_LENGTH) bootstrap.target_readme = tr;
+      const ti = readKnowledgeFile(`${targetDir}/INSTRUCTION.md`);
+      if (ti.ok && ti.content.trim().length > MIN_USEFUL_CONTENT_LENGTH) bootstrap.target_instruction = ti;
+      const tc = readKnowledgeFile(`${targetDir}/CONFIG.json`);
+      if (tc.ok && tc.content.trim().length > MIN_USEFUL_CONTENT_LENGTH) bootstrap.target_config_json = tc;
+      const tm = readKnowledgeFile(`${targetDir}/CONFIG.md`);
+      if (tm.ok && tm.content.trim().length > MIN_USEFUL_CONTENT_LENGTH) bootstrap.target_config_md = tm;
+    }
+
+    // Only report failures + truncation warnings for loaded files
     const initFailures: string[] = [];
     const truncationWarnings: string[] = [];
     if (!skill.ok) initFailures.push(`skill.mindos: failed (${skill.error})`);
@@ -352,19 +379,13 @@ export async function POST(req: NextRequest) {
     if (userSkillRules.ok && userSkillRules.truncated) truncationWarnings.push('user-skill-rules.md was truncated');
     if (!bootstrap.instruction.ok) initFailures.push(`bootstrap.instruction: failed (${bootstrap.instruction.error})`);
     if (bootstrap.instruction.ok && bootstrap.instruction.truncated) truncationWarnings.push('bootstrap.instruction was truncated');
-    if (!bootstrap.index.ok) initFailures.push(`bootstrap.index: failed (${bootstrap.index.error})`);
-    if (bootstrap.index.ok && bootstrap.index.truncated) truncationWarnings.push('bootstrap.index was truncated');
+    if (bootstrap.index?.ok && bootstrap.index.truncated) truncationWarnings.push('bootstrap.index was truncated');
     if (!bootstrap.config_json.ok) initFailures.push(`bootstrap.config_json: failed (${bootstrap.config_json.error})`);
     if (bootstrap.config_json.ok && bootstrap.config_json.truncated) truncationWarnings.push('bootstrap.config_json was truncated');
-    if (!bootstrap.config_md.ok) initFailures.push(`bootstrap.config_md: failed (${bootstrap.config_md.error})`);
-    if (bootstrap.config_md.ok && bootstrap.config_md.truncated) truncationWarnings.push('bootstrap.config_md was truncated');
-    if (bootstrap.target_readme && !bootstrap.target_readme.ok) initFailures.push(`bootstrap.target_readme: failed (${bootstrap.target_readme.error})`);
+    if (bootstrap.config_md?.ok && bootstrap.config_md.truncated) truncationWarnings.push('bootstrap.config_md was truncated');
     if (bootstrap.target_readme?.ok && bootstrap.target_readme.truncated) truncationWarnings.push('bootstrap.target_readme was truncated');
-    if (bootstrap.target_instruction && !bootstrap.target_instruction.ok) initFailures.push(`bootstrap.target_instruction: failed (${bootstrap.target_instruction.error})`);
     if (bootstrap.target_instruction?.ok && bootstrap.target_instruction.truncated) truncationWarnings.push('bootstrap.target_instruction was truncated');
-    if (bootstrap.target_config_json && !bootstrap.target_config_json.ok) initFailures.push(`bootstrap.target_config_json: failed (${bootstrap.target_config_json.error})`);
     if (bootstrap.target_config_json?.ok && bootstrap.target_config_json.truncated) truncationWarnings.push('bootstrap.target_config_json was truncated');
-    if (bootstrap.target_config_md && !bootstrap.target_config_md.ok) initFailures.push(`bootstrap.target_config_md: failed (${bootstrap.target_config_md.error})`);
     if (bootstrap.target_config_md?.ok && bootstrap.target_config_md.truncated) truncationWarnings.push('bootstrap.target_config_md was truncated');
 
     const initStatus = initFailures.length === 0
@@ -377,9 +398,9 @@ export async function POST(req: NextRequest) {
       initContextBlocks.push(`## user_skill_rules\n\nUser personalization rules (user-skill-rules.md):\n\n${userSkillRules.content}`);
     }
     if (bootstrap.instruction.ok) initContextBlocks.push(`## bootstrap_instruction\n\n${bootstrap.instruction.content}`);
-    if (bootstrap.index.ok) initContextBlocks.push(`## bootstrap_index\n\n${bootstrap.index.content}`);
+    if (bootstrap.index?.ok) initContextBlocks.push(`## bootstrap_index\n\n${bootstrap.index.content}`);
     if (bootstrap.config_json.ok) initContextBlocks.push(`## bootstrap_config_json\n\n${bootstrap.config_json.content}`);
-    if (bootstrap.config_md.ok) initContextBlocks.push(`## bootstrap_config_md\n\n${bootstrap.config_md.content}`);
+    if (bootstrap.config_md?.ok) initContextBlocks.push(`## bootstrap_config_md\n\n${bootstrap.config_md.content}`);
     if (bootstrap.target_readme?.ok) initContextBlocks.push(`## bootstrap_target_readme\n\n${bootstrap.target_readme.content}`);
     if (bootstrap.target_instruction?.ok) initContextBlocks.push(`## bootstrap_target_instruction\n\n${bootstrap.target_instruction.content}`);
     if (bootstrap.target_config_json?.ok) initContextBlocks.push(`## bootstrap_target_config_json\n\n${bootstrap.target_config_json.content}`);
@@ -584,18 +605,12 @@ export async function POST(req: NextRequest) {
               stepHistory.push(...newEntries);
             }
 
-            // Loop detection: same tool + same args 3 times in a row.
-            // Only trigger if we have 3+ history entries (prevent false positives on first turn).
-            const LOOP_DETECTION_THRESHOLD = 3;
+            // Loop detection: (1) same tool+args 3x in a row, (2) repeating pattern cycle
             if (loopCooldown > 0) {
               loopCooldown--;
-            } else if (stepHistory.length >= LOOP_DETECTION_THRESHOLD) {
-              const lastN = stepHistory.slice(-LOOP_DETECTION_THRESHOLD);
-              if (lastN.every(s => s.tool === lastN[0].tool && s.input === lastN[0].input)) {
-                loopCooldown = 3;
-                // TODO (metrics): Track loop detection rate — metrics.increment('agent.loop_detected', { model: modelName })
-                void session.steer('[SYSTEM WARNING] You have called the same tool with identical arguments 3 times in a row. This appears to be a loop. Try a completely different approach or ask the user for clarification.');
-              }
+            } else if (detectLoop(stepHistory)) {
+              loopCooldown = 3;
+              void session.steer('[SYSTEM WARNING] You appear to be in a loop — repeating the same tool calls in a cycle. Try a completely different approach or ask the user for clarification.');
             }
 
             // Step limit enforcement
@@ -708,7 +723,32 @@ export async function POST(req: NextRequest) {
             safeClose();
           } else {
             // Route to MindOS agent (existing logic)
-            await session.prompt(lastUserContent, lastUserImages ? { images: lastUserImages } : undefined);
+            // Retry with exponential backoff for transient failures (timeout, rate limit, 5xx).
+            // Only retry if no content has been streamed yet — once the user sees partial
+            // output, retrying would produce duplicate/garbled content.
+            const MAX_RETRIES = 3;
+            let lastPromptError: Error | null = null;
+
+            for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+              try {
+                await session.prompt(lastUserContent, lastUserImages ? { images: lastUserImages } : undefined);
+                lastPromptError = null;
+                break; // success
+              } catch (err) {
+                lastPromptError = err instanceof Error ? err : new Error(String(err));
+
+                // Only retry if: (1) no content streamed yet, (2) retries remaining, (3) transient error
+                const canRetry = !hasContent && attempt < MAX_RETRIES && isTransientError(lastPromptError);
+                if (!canRetry) break;
+
+                const delayMs = 1000 * Math.pow(2, attempt - 1); // 1s, 2s
+                send({ type: 'status', message: `Request failed, retrying (${attempt}/${MAX_RETRIES})...` });
+                await new Promise(resolve => setTimeout(resolve, delayMs));
+              }
+            }
+
+            if (lastPromptError) throw lastPromptError;
+
             metrics.recordRequest(Date.now() - requestStartTime);
             if (!hasContent && lastModelError) {
               send({ type: 'error', message: lastModelError });

package/app/app/api/graph/route.ts

@@ -1,7 +1,7 @@
 export const dynamic = 'force-dynamic';
 import { NextResponse } from 'next/server';
 import path from 'path';
-import { collectAllFiles, getFileContent } from '@/lib/fs';
+import { collectAllFiles, getLinkIndex } from '@/lib/fs';
 
 export interface GraphNode {
   id: string;    // relative file path
@@ -19,63 +19,9 @@ export interface GraphData {
   edges: GraphEdge[];
 }
 
-function extractLinks(content: string, sourcePath: string, fileSet: Set<string>, basenameMap: Map<string, string[]>): string[] {
-  const targets: string[] = [];
-  const sourceDir = path.dirname(sourcePath);
-
-  // WikiLinks: [[target]] or [[target|alias]] or [[target#section]]
-  const wikiRe = /\[\[([^\]|#]+)(?:[|#][^\]]*)?/g;
-  let m: RegExpExecArray | null;
-  while ((m = wikiRe.exec(content)) !== null) {
-    const raw = m[1].trim();
-    if (!raw) continue;
-
-    // Try exact match
-    if (fileSet.has(raw)) {
-      targets.push(raw);
-      continue;
-    }
-    // Try with .md
-    const withMd = raw.endsWith('.md') ? raw : raw + '.md';
-    if (fileSet.has(withMd)) {
-      targets.push(withMd);
-      continue;
-    }
-    // Try basename lookup (case-insensitive)
-    const lower = path.basename(withMd).toLowerCase();
-    const candidates = basenameMap.get(lower);
-    if (candidates && candidates.length === 1) {
-      targets.push(candidates[0]);
-    }
-    // skip if ambiguous (multiple candidates)
-  }
-
-  // Markdown links: [text](relative/path.md) or [text](relative/path.md#section)
-  const mdLinkRe = /\[[^\]]+\]\(([^)]+\.md)(?:#[^)]*)?\)/g;
-  while ((m = mdLinkRe.exec(content)) !== null) {
-    const raw = m[1].trim();
-    if (!raw || raw.startsWith('http')) continue;
-    const resolved = path.normalize(path.join(sourceDir, raw));
-    if (fileSet.has(resolved)) {
-      targets.push(resolved);
-    }
-  }
-
-  return targets;
-}
-
 export async function GET() {
   try {
     const allFiles = collectAllFiles().filter(f => f.endsWith('.md'));
-    const fileSet = new Set(allFiles);
-
-    // Build basename → relPath[] lookup
-    const basenameMap = new Map<string, string[]>();
-    for (const f of allFiles) {
-      const key = path.basename(f).toLowerCase();
-      if (!basenameMap.has(key)) basenameMap.set(key, []);
-      basenameMap.get(key)!.push(f);
-    }
 
     const nodes: GraphNode[] = allFiles.map(f => ({
       id: f,
@@ -83,27 +29,10 @@ export async function GET() {
       folder: path.dirname(f),
     }));
 
-    const edgeSet = new Set<string>();
-    const edges: GraphEdge[] = [];
-
-    for (const filePath of allFiles) {
-      let content: string;
-      try {
-        content = getFileContent(filePath);
-      } catch {
-        continue;
-      }
-
-      const targets = extractLinks(content, filePath, fileSet, basenameMap);
-      for (const target of targets) {
-        if (target === filePath) continue; // skip self-edges
-        const key = `${filePath}||${target}`;
-        if (!edgeSet.has(key)) {
-          edgeSet.add(key);
-          edges.push({ source: filePath, target });
-        }
-      }
-    }
+    // Use pre-built link index (O(1) per file) instead of extracting links
+    // from every file on each request (O(n * m))
+    const linkIndex = getLinkIndex();
+    const edges = linkIndex.getAllEdges();
 
     return NextResponse.json({ nodes, edges } satisfies GraphData);
   } catch (err) {

package/app/app/trash/page.tsx

@@ -2,6 +2,7 @@ import { listTrashAction } from '@/lib/actions';
 import TrashPageClient from '@/components/TrashPageClient';
 
 export default async function TrashPage() {
+  // listTrashAction auto-purges expired items (>30 days) on each call
   const items = await listTrashAction();
   return <TrashPageClient initialItems={items} />;
 }

package/app/app/view/[...path]/ViewPageClient.tsx

@@ -17,7 +17,8 @@ import { resolveRenderer, isRendererEnabled } from '@/lib/renderers/registry';
 import { encodePath } from '@/lib/utils';
 import { useLocale } from '@/lib/LocaleContext';
 import DirPicker from '@/components/DirPicker';
-import { renameFileAction, deleteFileAction } from '@/lib/actions';
+import { renameFileAction, deleteFileAction, undoDeleteAction } from '@/lib/actions';
+import { toast } from '@/lib/toast';
 import { ConfirmDialog } from '@/components/agents/AgentsPrimitives';
 import { buildLineDiff } from '@/components/changes/line-diff';
 import { usePinnedFiles } from '@/lib/hooks/usePinnedFiles';
@@ -132,15 +133,28 @@ export default function ViewPageClient({
 
   const handleConfirmDelete = useCallback(() => {
     setShowDeleteConfirm(false);
+    const fileName = filePath.split('/').pop() ?? filePath;
     startTransition(async () => {
       const result = await deleteFileAction(filePath);
       if (result.success) {
+        if (result.trashId) {
+          const trashId = result.trashId;
+          toast.undo(`${t.trash?.movedToTrash ?? 'Deleted'} ${fileName}`, async () => {
+            const undo = await undoDeleteAction(trashId);
+            if (undo.success) {
+              router.refresh();
+              window.dispatchEvent(new Event('mindos:files-changed'));
+            } else {
+              toast.error(undo.error ?? 'Undo failed');
+            }
+          }, { label: t.trash?.undo ?? 'Undo' });
+        }
         router.push('/');
         router.refresh();
         window.dispatchEvent(new Event('mindos:files-changed'));
       }
     });
-  }, [filePath, router]);
+  }, [filePath, router, t]);
 
   // Keep first paint deterministic between server and client to avoid hydration mismatch.
   const effectiveUseRaw = hydrated ? useRaw : false;
@@ -588,8 +602,8 @@ export default function ViewPageClient({
               className="w-full bg-muted border border-border rounded-md px-3 py-1.5 text-sm text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
             />
             <div className="flex justify-end gap-2 mt-3">
-              <button onClick={() => setRenaming(false)} className="px-3 py-1.5 rounded-md text-xs bg-muted text-muted-foreground hover:bg-accent transition-colors">Cancel</button>
-              <button onClick={handleCommitRename} className="px-3 py-1.5 rounded-md text-xs bg-[var(--amber)] text-[var(--amber-foreground)] transition-colors">Rename</button>
+              <button onClick={() => setRenaming(false)} className="px-3 py-1.5 rounded-md text-xs bg-muted text-muted-foreground hover:bg-accent transition-colors">{t.view?.cancel ?? 'Cancel'}</button>
+              <button onClick={handleCommitRename} className="px-3 py-1.5 rounded-md text-xs bg-[var(--amber)] text-[var(--amber-foreground)] transition-colors">{t.view?.rename ?? 'Rename'}</button>
             </div>
           </div>
         </div>
@@ -598,10 +612,10 @@ export default function ViewPageClient({
       {/* Delete confirm */}
       <ConfirmDialog
         open={showDeleteConfirm}
-        title="Delete"
-        message={`Delete "${filePath.split('/').pop()}"? This cannot be undone.`}
-        confirmLabel="Delete"
-        cancelLabel="Cancel"
+        title={t.view?.delete ?? 'Delete'}
+        message={t.view?.deleteConfirm?.(filePath.split('/').pop() ?? '') ?? `Delete "${filePath.split('/').pop()}"?`}
+        confirmLabel={t.view?.delete ?? 'Delete'}
+        cancelLabel={t.view?.cancel ?? 'Cancel'}
         variant="destructive"
         onCancel={() => setShowDeleteConfirm(false)}
         onConfirm={handleConfirmDelete}

package/app/components/ExportModal.tsx

@@ -114,7 +114,7 @@ export default function ExportModal({ open, onClose, filePath, isDirectory, file
               {isDirectory ? (t.export?.exportSpace ?? 'Export Space') : (t.export?.exportFile ?? 'Export File')}
             </h3>
           </div>
-          <button onClick={handleClose} className="p-1 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted transition-colors">
+          <button onClick={handleClose} className="p-1 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring" aria-label={t.export?.cancel ?? 'Close'}>
             <X size={14} />
           </button>
         </div>
@@ -179,7 +179,7 @@ export default function ExportModal({ open, onClose, filePath, isDirectory, file
                 {t.export?.downloadAgain ?? 'Download Again'}
               </button>
               <button onClick={handleClose} className="px-3 py-1.5 rounded-md text-xs font-medium bg-[var(--amber-dim)] text-[var(--amber-text)] hover:opacity-80 transition-colors">
-                {t.export?.cancel === 'Cancel' ? 'Done' : (t.export?.done ?? 'Done')}
+                {t.export?.close ?? 'Done'}
               </button>
             </>
           ) : state === 'error' ? (

package/app/components/FileTree.tsx

@@ -8,7 +8,8 @@ import {
   ChevronDown, FileText, Table, Folder, FolderOpen, Plus, Loader2,
   Trash2, Pencil, Layers, ScrollText, FolderInput, Copy, MoreHorizontal, Star,
 } from 'lucide-react';
-import { createFileAction, deleteFileAction, renameFileAction, renameSpaceAction, deleteSpaceAction, convertToSpaceAction, deleteFolderAction } from '@/lib/actions';
+import { createFileAction, deleteFileAction, renameFileAction, renameSpaceAction, deleteSpaceAction, convertToSpaceAction, deleteFolderAction, undoDeleteAction } from '@/lib/actions';
+import { toast } from '@/lib/toast';
 import { useLocale } from '@/lib/LocaleContext';
 import { ConfirmDialog } from '@/components/agents/AgentsPrimitives';
 import { usePinnedFiles } from '@/lib/hooks/usePinnedFiles';
@@ -536,7 +537,7 @@ function DirectoryNode({ node, depth, currentPath, onNavigate, maxOpenDepth, onI
         title={deleteConfirm === 'space' ? t.fileTree.deleteSpace : t.fileTree.deleteFolder}
         message={deleteConfirm === 'space' ? t.fileTree.confirmDeleteSpace(node.name) : t.fileTree.confirmDeleteFolder(node.name)}
         confirmLabel={deleteConfirm === 'space' ? t.fileTree.deleteSpace : t.fileTree.deleteFolder}
-        cancelLabel="Cancel"
+        cancelLabel={t.view?.cancel ?? 'Cancel'}
         variant="destructive"
         onCancel={() => setDeleteConfirm(null)}
         onConfirm={() => {
@@ -546,7 +547,16 @@ function DirectoryNode({ node, depth, currentPath, onNavigate, maxOpenDepth, onI
             const result = kind === 'space'
               ? await deleteSpaceAction(node.path)
               : await deleteFolderAction(node.path);
-            if (result.success) { router.push('/'); router.refresh(); notifyFilesChanged(); }
+            if (result.success && result.trashId) {
+              const trashId = result.trashId;
+              const name = node.path.split('/').pop() ?? node.path;
+              toast.undo(`${t.trash?.movedToTrash ?? 'Deleted'} ${name}`, async () => {
+                const undo = await undoDeleteAction(trashId);
+                if (undo.success) { router.refresh(); notifyFilesChanged(); }
+                else toast.error(undo.error ?? 'Undo failed');
+              }, { label: t.trash?.undo ?? 'Undo' });
+              router.push('/'); router.refresh(); notifyFilesChanged();
+            }
           });
         }}
       />
@@ -718,14 +728,25 @@ function FileNodeItem({ node, depth, currentPath, onNavigate }: {
         title={t.fileTree.delete}
         message={t.fileTree.confirmDelete(node.name)}
         confirmLabel={t.fileTree.delete}
-        cancelLabel="Cancel"
+        cancelLabel={t.view?.cancel ?? 'Cancel'}
         variant="destructive"
         onCancel={() => setShowDeleteConfirm(false)}
         onConfirm={() => {
           setShowDeleteConfirm(false);
           startDeleteTransition(async () => {
             const result = await deleteFileAction(node.path);
-            if (result.success) { router.push('/'); router.refresh(); notifyFilesChanged(); }
+            if (result.success) {
+              if (result.trashId) {
+                const trashId = result.trashId;
+                const name = node.path.split('/').pop() ?? node.path;
+                toast.undo(`${t.trash?.movedToTrash ?? 'Deleted'} ${name}`, async () => {
+                  const undo = await undoDeleteAction(trashId);
+                  if (undo.success) { router.refresh(); notifyFilesChanged(); }
+                  else toast.error(undo.error ?? 'Undo failed');
+                }, { label: t.trash?.undo ?? 'Undo' });
+              }
+              router.refresh(); notifyFilesChanged();
+            }
           });
         }}
       />

package/app/components/HomeContent.tsx

@@ -10,6 +10,7 @@ import { usePinnedFiles } from '@/lib/hooks/usePinnedFiles';
 import { getAllRenderers, getPluginRenderers } from '@/lib/renderers/registry';
 import OnboardingView from './OnboardingView';
 import GuideCard from './GuideCard';
+import SystemPulse from './SystemPulse';
 import { scanExampleFilesAction, cleanupExamplesAction } from '@/lib/actions';
 import type { SpaceInfo } from '@/app/page';
 
@@ -332,6 +333,9 @@ export default function HomeContent({ recent, existingFiles, spaces }: { recent:
         </div>
       </div>
 
+      {/* ── System Pulse: Agent status + stats ── */}
+      <SystemPulse />
+
       {/* ── Section: Pinned Files ── */}
       <PinnedFilesSection formatTime={formatTime} />