@geminilight/mindos 0.6.59 → 0.6.61

package/_standalone/.next/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/agents" | "/agents/[agentKey]" | "/changes" | "/echo" | "/echo/[segment]" | "/explore" | "/help" | "/inbox/history" | "/login" | "/setup" | "/trash" | "/view/[...path]" | "/wiki"
-type AppRouteHandlerRoutes = "/.well-known/agent-card.json" | "/api/a2a" | "/api/a2a/agents" | "/api/a2a/delegations" | "/api/a2a/discover" | "/api/acp/config" | "/api/acp/detect" | "/api/acp/install" | "/api/acp/registry" | "/api/acp/session" | "/api/agent-activity" | "/api/agents/custom" | "/api/agents/custom/detect" | "/api/ask" | "/api/ask-sessions" | "/api/auth" | "/api/backlinks" | "/api/bootstrap" | "/api/changes" | "/api/export" | "/api/extract-pdf" | "/api/file" | "/api/file/import" | "/api/file/raw" | "/api/files" | "/api/git" | "/api/graph" | "/api/health" | "/api/inbox" | "/api/init" | "/api/mcp/agents" | "/api/mcp/install" | "/api/mcp/install-skill" | "/api/mcp/restart" | "/api/mcp/status" | "/api/mcp/uninstall" | "/api/monitoring" | "/api/recent-files" | "/api/restart" | "/api/search" | "/api/settings" | "/api/settings/list-models" | "/api/settings/reset-token" | "/api/settings/test-key" | "/api/setup" | "/api/setup/check-path" | "/api/setup/check-port" | "/api/setup/generate-token" | "/api/setup/ls" | "/api/skills" | "/api/sync" | "/api/tree-version" | "/api/uninstall" | "/api/update" | "/api/update-check" | "/api/update-status" | "/api/workflows"
+type AppRouteHandlerRoutes = "/.well-known/agent-card.json" | "/api/a2a" | "/api/a2a/agents" | "/api/a2a/delegations" | "/api/a2a/discover" | "/api/acp/config" | "/api/acp/detect" | "/api/acp/install" | "/api/acp/registry" | "/api/acp/session" | "/api/agent-activity" | "/api/agents/copy-skill" | "/api/agents/custom" | "/api/agents/custom/detect" | "/api/ask" | "/api/ask-sessions" | "/api/auth" | "/api/backlinks" | "/api/bootstrap" | "/api/changes" | "/api/export" | "/api/extract-pdf" | "/api/file" | "/api/file/import" | "/api/file/raw" | "/api/files" | "/api/git" | "/api/graph" | "/api/health" | "/api/inbox" | "/api/init" | "/api/mcp/agents" | "/api/mcp/install" | "/api/mcp/install-skill" | "/api/mcp/restart" | "/api/mcp/status" | "/api/mcp/uninstall" | "/api/monitoring" | "/api/recent-files" | "/api/restart" | "/api/search" | "/api/settings" | "/api/settings/list-models" | "/api/settings/reset-token" | "/api/settings/test-key" | "/api/setup" | "/api/setup/check-path" | "/api/setup/check-port" | "/api/setup/generate-token" | "/api/setup/ls" | "/api/skills" | "/api/sync" | "/api/tree-version" | "/api/uninstall" | "/api/update" | "/api/update-check" | "/api/update-status" | "/api/workflows"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -25,6 +25,7 @@ interface ParamMap {
   "/api/acp/registry": {}
   "/api/acp/session": {}
   "/api/agent-activity": {}
+  "/api/agents/copy-skill": {}
   "/api/agents/custom": {}
   "/api/agents/custom/detect": {}
   "/api/ask": {}

package/_standalone/.next/types/validator.ts

@@ -272,6 +272,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/agents/copy-skill/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agents/copy-skill">> = Specific
+  const handler = {} as typeof import("../../app/api/agents/copy-skill/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/agents/custom/detect/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/agents/custom/detect">> = Specific

package/_standalone/__tests__/api/mcp-install.test.ts

@@ -254,11 +254,11 @@ describe('POST /api/mcp/install', () => {
 });
 
 describe('GET /api/mcp/agents', () => {
-  it('returns all 21 agents (1 builtin + 20 registry)', async () => {
+  it('returns all 24 agents (1 builtin + 21 registry + 2 new)', async () => {
     const { GET } = await importAgentsRoute();
     const res = await GET();
     const body = await res.json();
-    expect(body.agents).toHaveLength(21);
+    expect(body.agents).toHaveLength(24);
     const keys = body.agents.map((a: { key: string }) => a.key);
     expect(keys).toContain('mindos');
     expect(keys).toContain('claude-code');
@@ -276,6 +276,9 @@ describe('GET /api/mcp/agents', () => {
     expect(keys).toContain('github-copilot');
     expect(keys).toContain('codex');
     expect(keys).toContain('antigravity');
+    expect(keys).toContain('qclaw');
+    expect(keys).toContain('workbuddy');
+    expect(keys).toContain('lingma');
   });
 
   it('detects installed agent from config file', async () => {

package/_standalone/components/AskFab.tsx

@@ -2,6 +2,7 @@
 
 import { Sparkles } from 'lucide-react';
 import { useLocale } from '@/lib/stores/locale-store';
+import { usePathname } from 'next/navigation';
 
 interface AskFabProps {
   /** Toggle the right-side Ask AI panel */
@@ -12,8 +13,13 @@ interface AskFabProps {
 
 export default function AskFab({ onToggle, askPanelOpen }: AskFabProps) {
   const { t } = useLocale();
+  const pathname = usePathname();
   const label = `${t.ask?.fabLabel ?? 'Ask AI'} (⌘/)`;
 
+  // Hide on home page — it already has an inline chatbot
+  const isHome = pathname === '/' || pathname === '';
+  const hidden = askPanelOpen || isHome;
+
   return (
     <button
       onClick={onToggle}
@@ -28,7 +34,7 @@ export default function AskFab({ onToggle, askPanelOpen }: AskFabProps) {
         transition-all duration-200 ease-out
         hover:shadow-lg hover:shadow-[var(--amber)]/20
         active:scale-95 cursor-pointer overflow-hidden
-        ${askPanelOpen ? 'opacity-0 pointer-events-none translate-y-2' : 'opacity-100 translate-y-0'}
+        ${hidden ? 'opacity-0 pointer-events-none translate-y-2' : 'opacity-100 translate-y-0'}
       `}
       style={{
         background: 'var(--amber)',

package/_standalone/components/FileTree.tsx

@@ -12,6 +12,7 @@ import {
 import { createFileAction, deleteFileAction, renameFileAction, renameSpaceAction, deleteSpaceAction, convertToSpaceAction, deleteFolderAction, undoDeleteAction } from '@/lib/actions';
 import { toast } from '@/lib/toast';
 import { useLocale } from '@/lib/stores/locale-store';
+import { quickDropToDirectory } from '@/lib/inbox-upload';
 import { ConfirmDialog } from '@/components/agents/AgentsPrimitives';
 import { usePinnedFiles } from '@/lib/hooks/usePinnedFiles';
 import { checkAiAvailable, triggerSpaceAiInit } from '@/lib/space-ai-init';
@@ -318,6 +319,81 @@ function DirectoryNode({ node, depth, currentPath, onNavigate, maxOpenDepth, onI
   const [deleteConfirm, setDeleteConfirm] = useState<null | 'space' | 'folder'>(null);
   const [isPendingDelete, startDeleteTransition] = useTransition();
 
+  // ── External file drop target ──
+  const [isDragTarget, setIsDragTarget] = useState(false);
+  const autoExpandTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const dragLeaveTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  const clearAutoExpand = useCallback(() => {
+    if (autoExpandTimerRef.current) {
+      clearTimeout(autoExpandTimerRef.current);
+      autoExpandTimerRef.current = null;
+    }
+  }, []);
+
+  // Use dragOver (fires continuously while hovering) for highlight.
+  // Clear highlight with a short delay on dragLeave — if dragOver fires again
+  // within the delay, the highlight stays. This avoids flicker from nested elements.
+  const handleRowDragOver = useCallback((e: React.DragEvent) => {
+    if (!e.dataTransfer.types.includes('Files')) return;
+    e.preventDefault();
+    e.stopPropagation();
+    e.dataTransfer.dropEffect = 'copy';
+    if (dragLeaveTimerRef.current) {
+      clearTimeout(dragLeaveTimerRef.current);
+      dragLeaveTimerRef.current = null;
+    }
+    if (!isDragTarget) setIsDragTarget(true);
+  }, [isDragTarget]);
+
+  const handleRowDragEnter = useCallback((e: React.DragEvent) => {
+    if (!e.dataTransfer.types.includes('Files')) return;
+    e.preventDefault();
+    e.stopPropagation();
+    setIsDragTarget(true);
+    // Auto-expand collapsed directory after 500ms hover
+    clearAutoExpand();
+    if (!open) {
+      autoExpandTimerRef.current = setTimeout(() => {
+        setOpen(true);
+        autoExpandTimerRef.current = null;
+      }, 500);
+    }
+  }, [open, clearAutoExpand]);
+
+  const handleRowDragLeave = useCallback((e: React.DragEvent) => {
+    if (!e.dataTransfer.types.includes('Files')) return;
+    e.stopPropagation();
+    // Delay clearing so dragOver on the same row can cancel it
+    dragLeaveTimerRef.current = setTimeout(() => {
+      setIsDragTarget(false);
+      clearAutoExpand();
+      dragLeaveTimerRef.current = null;
+    }, 50);
+  }, [clearAutoExpand]);
+
+  const handleRowDrop = useCallback((e: React.DragEvent) => {
+    e.preventDefault();
+    e.stopPropagation();
+    setIsDragTarget(false);
+    clearAutoExpand();
+    if (dragLeaveTimerRef.current) {
+      clearTimeout(dragLeaveTimerRef.current);
+      dragLeaveTimerRef.current = null;
+    }
+    const files = e.dataTransfer.files;
+    if (files.length > 0) {
+      void quickDropToDirectory(Array.from(files), node.path, t);
+    }
+  }, [node.path, t, clearAutoExpand]);
+
+  useEffect(() => {
+    return () => {
+      clearAutoExpand();
+      if (dragLeaveTimerRef.current) clearTimeout(dragLeaveTimerRef.current);
+    };
+  }, [clearAutoExpand]);
+
   const toggle = useCallback(() => setOpen(v => !v), []);
 
   const prevMaxOpenDepth = useRef<number | null | undefined>(undefined);
@@ -421,8 +497,14 @@ function DirectoryNode({ node, depth, currentPath, onNavigate, maxOpenDepth, onI
   return (
     <div>
       <div
-        className="relative group/dir flex items-center"
+        className={`relative group/dir flex items-center transition-colors duration-100 ${
+          isDragTarget ? 'bg-[var(--amber)]/10 rounded-md' : ''
+        }`}
         onContextMenu={handleContextMenu}
+        onDragEnter={handleRowDragEnter}
+        onDragOver={handleRowDragOver}
+        onDragLeave={handleRowDragLeave}
+        onDrop={handleRowDrop}
       >
         <button
           onClick={toggle}

package/_standalone/components/Panel.tsx

@@ -316,9 +316,28 @@ export default function Panel({
             </div>
           </div>
         </PanelHeader>
-        <div className="flex-1 overflow-y-auto min-h-0 px-2 py-2">
+        <div
+          className="flex-1 overflow-y-auto min-h-0 px-2 py-2"
+          onDragEnter={(e) => { if (e.dataTransfer.types.includes('Files')) e.stopPropagation(); }}
+          onDragOver={(e) => { if (e.dataTransfer.types.includes('Files')) { e.preventDefault(); e.stopPropagation(); } }}
+          onDrop={(e) => { if (e.dataTransfer.types.includes('Files')) { e.preventDefault(); e.stopPropagation(); } }}
+        >
           <FileTree nodes={fileTree} onNavigate={onNavigate} maxOpenDepth={maxOpenDepth} onImport={onImport} />
         </div>
+        {/* Inbox quick entry — always visible above sync bar */}
+        <button
+          type="button"
+          onClick={() => router.push('/view/Inbox/')}
+          className="flex items-center gap-2 mx-2 px-2 py-1.5 text-sm rounded-md transition-colors hover:bg-muted group border-t border-border/40 shrink-0"
+        >
+          <Inbox size={14} className="shrink-0 text-[var(--amber)]" />
+          <span className="flex-1 text-left text-muted-foreground group-hover:text-foreground transition-colors text-xs">
+            {t.sidebar.capture}
+          </span>
+          {inboxCount > 0 && (
+            <span className="text-xs font-medium text-[var(--amber)] tabular-nums">{inboxCount}</span>
+          )}
+        </button>
         <SyncStatusBar collapsed={false} onOpenSyncSettings={onOpenSyncSettings} />
       </div>
 

package/_standalone/components/agents/AgentsOverviewSection.tsx

@@ -223,17 +223,7 @@ export default function AgentsOverviewSection({
             </span>
           </div>
           <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-3">
-            {sortedAgents.map((agent, i) => (
-              <AgentCard
-                key={agent.key}
-                agent={agent}
-                copy={copy}
-                index={i}
-                mcpEnabled={mcpEnabled}
-                onEdit={agent.isCustom ? onEditCustomAgent : undefined}
-                onRemove={agent.isCustom ? onRemoveCustomAgent : undefined}
-              />
-            ))}
+            {/* Add Custom Agent Button — Always First */}
             {onAddCustomAgent && (
               <button
                 type="button"
@@ -254,6 +244,18 @@ export default function AgentsOverviewSection({
                 </span>
               </button>
             )}
+            {/* Agent Cards */}
+            {sortedAgents.map((agent, i) => (
+              <AgentCard
+                key={agent.key}
+                agent={agent}
+                copy={copy}
+                index={i}
+                mcpEnabled={mcpEnabled}
+                onEdit={agent.isCustom ? onEditCustomAgent : undefined}
+                onRemove={agent.isCustom ? onRemoveCustomAgent : undefined}
+              />
+            ))}
           </div>
         </section>
       ) : (

package/_standalone/components/agents/CustomAgentModal.tsx

@@ -1,7 +1,7 @@
 'use client';
 
 import { useState, useEffect, useRef, useCallback, useMemo } from 'react';
-import { X, Loader2, ChevronRight, ChevronDown, CheckCircle2, Info, AlertCircle } from 'lucide-react';
+import { X, Loader2, ChevronRight, ChevronDown, CheckCircle2, Info, AlertCircle, Server, Zap } from 'lucide-react';
 import { useLocale } from '@/lib/stores/locale-store';
 import { useFocusTrap } from '@/lib/hooks/useFocusTrap';
 import { toast } from '@/lib/toast';
@@ -19,6 +19,8 @@ interface DetectResult {
   detectedSkillDir?: string;
   skillCount?: number;
   skillNames?: string[];
+  mcpServers?: string[];
+  mcpParseError?: string;
   suggestedName?: string;
 }
 
@@ -406,7 +408,7 @@ export default function CustomAgentModal({
           {phase === 'result' && (
             <>
               {/* Result Card */}
-              <div className={`rounded-lg p-4 space-y-2 ${
+              <div className={`rounded-lg p-4 space-y-3 ${
                 detectResult?.exists
                   ? 'border border-[var(--success)]/20 bg-[var(--success)]/5'
                   : 'border border-border bg-muted/30'
@@ -414,22 +416,74 @@ export default function CustomAgentModal({
                 <p className="text-xs font-medium text-muted-foreground uppercase tracking-wider">
                   {detectResult?.exists ? p.customAgentDetectedTitle : p.customAgentDefaultTitle}
                 </p>
-                <div className="grid grid-cols-[auto_1fr] gap-x-4 gap-y-1.5 text-sm">
-                  <span className="text-muted-foreground">{p.customAgentConfigLabel}</span>
-                  <span className="text-foreground font-mono text-xs truncate">{form.global}</span>
-
-                  <span className="text-muted-foreground">{p.customAgentFormatLabel}</span>
-                  <span className="text-foreground">{form.format.toUpperCase()} · {form.configKey}</span>
-
-                  <span className="text-muted-foreground">{p.customAgentTransportLabel}</span>
-                  <span className="text-foreground">{form.preferredTransport}</span>
-
-                  <span className="text-muted-foreground">{p.customAgentSkillsLabel}</span>
-                  <span className="text-foreground">
-                    {detectResult?.hasSkillsDir
-                      ? p.customAgentSkillsFound(detectResult.skillCount ?? 0)
-                      : p.customAgentSkillsNone ?? '—'}
-                  </span>
+                <div className="space-y-2.5">
+                  {/* Config Path */}
+                  <div>
+                    <p className="text-xs text-muted-foreground mb-1">{p.customAgentConfigLabel}</p>
+                    <span className="text-sm text-foreground font-mono truncate block">{form.global}</span>
+                    {detectResult?.mcpParseError && (
+                      <p className="text-xs text-[var(--error)] mt-1 flex items-center gap-1">
+                        <AlertCircle size={12} className="shrink-0" />
+                        {detectResult.mcpParseError}
+                      </p>
+                    )}
+                  </div>
+
+                  {/* Format & Key */}
+                  <div className="grid grid-cols-2 gap-2">
+                    <div>
+                      <p className="text-xs text-muted-foreground mb-1">{p.customAgentFormatLabel}</p>
+                      <span className="text-sm text-foreground">{form.format.toUpperCase()}</span>
+                    </div>
+                    <div>
+                      <p className="text-xs text-muted-foreground mb-1">Config Key</p>
+                      <span className="text-sm text-foreground font-mono">{form.configKey}</span>
+                    </div>
+                  </div>
+
+                  {/* Transport */}
+                  <div>
+                    <p className="text-xs text-muted-foreground mb-1">{p.customAgentTransportLabel}</p>
+                    <span className="text-sm text-foreground">{form.preferredTransport}</span>
+                  </div>
+
+                  {/* MCP Servers */}
+                  <div>
+                    <p className="text-xs text-muted-foreground mb-1 flex items-center gap-1">
+                      <Server size={11} className="shrink-0" aria-hidden="true" />
+                      MCP Servers
+                    </p>
+                    {detectResult?.mcpServers && detectResult.mcpServers.length > 0 ? (
+                      <div className="flex flex-wrap gap-1">
+                        {detectResult.mcpServers.map(name => (
+                          <span key={name} className="text-xs bg-muted/60 text-foreground px-2 py-0.5 rounded font-mono">
+                            {name}
+                          </span>
+                        ))}
+                      </div>
+                    ) : (
+                      <span className="text-sm text-muted-foreground">—</span>
+                    )}
+                  </div>
+
+                  {/* Skills */}
+                  <div>
+                    <p className="text-xs text-muted-foreground mb-1 flex items-center gap-1">
+                      <Zap size={11} className="shrink-0" aria-hidden="true" />
+                      {p.customAgentSkillsLabel}
+                    </p>
+                    {detectResult?.skillNames && detectResult.skillNames.length > 0 ? (
+                      <div className="flex flex-wrap gap-1">
+                        {detectResult.skillNames.map(name => (
+                          <span key={name} className="text-xs bg-[var(--amber-dim)] text-[var(--amber-text,var(--foreground))] px-2 py-0.5 rounded font-mono">
+                            {name}
+                          </span>
+                        ))}
+                      </div>
+                    ) : (
+                      <span className="text-sm text-muted-foreground">—</span>
+                    )}
+                  </div>
                 </div>
               </div>
 

package/_standalone/components/ask/AskContent.tsx

@@ -403,6 +403,7 @@ export default function AskContent({ visible, currentFile, initialMessage, initi
     // Accept mindos file paths and image drops
     if (e.dataTransfer.types.includes('text/mindos-path') || e.dataTransfer.types.includes('Files')) {
       e.preventDefault();
+      e.stopPropagation();
       e.dataTransfer.dropEffect = 'copy';
       setIsDragOver(true);
     }
@@ -412,6 +413,7 @@ export default function AskContent({ visible, currentFile, initialMessage, initi
 
   const handleDrop = useCallback(async (e: React.DragEvent) => {
     e.preventDefault();
+    e.stopPropagation();
     setIsDragOver(false);
     const filePath = e.dataTransfer.getData('text/mindos-path');
     if (filePath) {
@@ -422,7 +424,21 @@ export default function AskContent({ visible, currentFile, initialMessage, initi
       }
       return;
     }
-    await imageUploadRef.current.handleDrop(e);
+    // Try image upload first, then fall back to general file upload
+    const files = e.dataTransfer.files;
+    if (files.length > 0) {
+      const hasImages = Array.from(files).some(f => f.type.startsWith('image/'));
+      if (hasImages) {
+        await imageUploadRef.current.handleDrop(e);
+      }
+      // Upload non-image files as attachments
+      const nonImageFiles = Array.from(files).filter(f => !f.type.startsWith('image/'));
+      if (nonImageFiles.length > 0) {
+        const dt = new DataTransfer();
+        nonImageFiles.forEach(f => dt.items.add(f));
+        await uploadRef.current.pickFiles(dt.files);
+      }
+    }
   }, []);
 
   const handlePaste = useCallback((e: React.ClipboardEvent) => {
@@ -571,12 +587,12 @@ export default function AskContent({ visible, currentFile, initialMessage, initi
                   <FileChip key={f} path={f} variant="kb" onRemove={() => setAttachedFiles(prev => prev.filter(x => x !== f))} />
                 ))}
                 {upload.localAttachments.map((f, idx) => (
-                  <FileChip key={`up-${f.name}-${idx}`} path={f.name} variant="upload" onRemove={() => upload.removeAttachment(idx)} />
+                  <FileChip key={`up-${f.name}-${idx}`} path={f.name} variant="upload" status={f.status} error={f.error} truncatedInfo={f.truncatedInfo} onRemove={() => upload.removeAttachment(idx)} />
                 ))}
                 {imageUpload.images.map((img, idx) => (
                   <FileChip
                     key={`img-${idx}`}
-                    path={`Image ${idx + 1}`}
+                    path={img.fileName || `Image ${idx + 1}`}
                     variant="image"
                     imageData={img.data}
                     imageMime={img.mimeType}

package/_standalone/components/ask/FileChip.tsx

@@ -2,7 +2,7 @@
 
 import { useState, useRef, useEffect } from 'react';
 import { createPortal } from 'react-dom';
-import { X, FileText, Table, Paperclip, ImageIcon, Zap, Bot, Folder } from 'lucide-react';
+import { X, FileText, Table, Paperclip, ImageIcon, Zap, Bot, Folder, Loader2, CheckCircle2, AlertCircle, AlertTriangle } from 'lucide-react';
 
 interface FileChipProps {
   path: string;
@@ -12,6 +12,16 @@ interface FileChipProps {
   imageData?: string;
   /** MIME type for image preview */
   imageMime?: string;
+  /** Extraction status for uploaded files (e.g. PDF). */
+  status?: 'loading' | 'success' | 'error';
+  /** Human-readable error message shown on hover when status='error'. */
+  error?: string;
+  /** Present when the PDF text was truncated due to length. */
+  truncatedInfo?: {
+    totalChars: number;
+    includedChars: number;
+    totalPages: number;
+  };
 }
 
 const VARIANT_ICON = {
@@ -30,11 +40,13 @@ const VARIANT_STYLE = {
   agent: 'border-[var(--amber)]/25 bg-[var(--amber)]/10 text-foreground',
 } as const;
 
-export default function FileChip({ path, onRemove, variant = 'kb', imageData, imageMime }: FileChipProps) {
+export default function FileChip({ path, onRemove, variant = 'kb', imageData, imageMime, status, error, truncatedInfo }: FileChipProps) {
   const [showPreview, setShowPreview] = useState(false);
+  const [showTooltip, setShowTooltip] = useState(false);
   const [mounted, setMounted] = useState(false);
   const chipRef = useRef<HTMLSpanElement>(null);
   const [previewPos, setPreviewPos] = useState<{ top: number; left: number } | null>(null);
+  const [tooltipPos, setTooltipPos] = useState<{ top: number; left: number } | null>(null);
 
   useEffect(() => setMounted(true), []);
 
@@ -42,23 +54,63 @@ export default function FileChip({ path, onRemove, variant = 'kb', imageData, im
   const cleanPath = isDir ? path.slice(0, -1) : path;
   const name = cleanPath.split('/').pop() ?? cleanPath;
   const isCsv = variant === 'kb' && !isDir && name.endsWith('.csv');
-  const { icon: Icon, cls: iconClass } = isDir
+
+  // Determine the base icon from variant / file type
+  const { icon: BaseIcon, cls: baseIconCls } = isDir
     ? { icon: Folder, cls: 'text-yellow-400' }
     : isCsv
     ? { icon: Table, cls: 'text-success' }
     : VARIANT_ICON[variant];
-  const style = VARIANT_STYLE[variant];
 
-  // Position preview above the chip using getBoundingClientRect
+  // Determine status trailing indicator
+  const isTruncated = !!truncatedInfo;
+  let StatusIndicator: React.ComponentType<{ size: number; className?: string }> | null = null;
+  let statusIndicatorCls = '';
+  if (status === 'loading') {
+    StatusIndicator = Loader2;
+    statusIndicatorCls = 'text-muted-foreground animate-spin';
+  } else if (status === 'error') {
+    StatusIndicator = AlertCircle;
+    statusIndicatorCls = 'text-destructive';
+  } else if (isTruncated) {
+    StatusIndicator = AlertTriangle;
+    statusIndicatorCls = 'text-amber-500';
+  } else if (status === 'success') {
+    StatusIndicator = CheckCircle2;
+    statusIndicatorCls = 'text-emerald-500';
+  }
+
+  const style = status === 'error'
+    ? 'border-destructive/30 bg-destructive/5 text-foreground'
+    : isTruncated
+    ? 'border-amber-500/30 bg-amber-500/5 text-foreground'
+    : VARIANT_STYLE[variant];
+
+  // Build tooltip text
+  let tooltipText: string | null = null;
+  if (status === 'error' && error) {
+    tooltipText = error;
+  } else if (isTruncated) {
+    const pct = truncatedInfo.totalChars > 0
+      ? Math.round((truncatedInfo.includedChars / truncatedInfo.totalChars) * 100)
+      : 0;
+    tooltipText = `Document truncated — only ${pct}% included (${Math.round(truncatedInfo.includedChars / 1000)}K / ${Math.round(truncatedInfo.totalChars / 1000)}K chars, ${truncatedInfo.totalPages} pages total)`;
+  }
+
+  // Position image preview above the chip
   useEffect(() => {
     if (!showPreview || !chipRef.current) { setPreviewPos(null); return; }
     const rect = chipRef.current.getBoundingClientRect();
-    setPreviewPos({
-      top: rect.top - 8, // 8px gap above chip
-      left: rect.left,
-    });
+    setPreviewPos({ top: rect.top - 8, left: rect.left });
   }, [showPreview]);
 
+  // Position tooltip above the chip
+  useEffect(() => {
+    if (!showTooltip || !chipRef.current) { setTooltipPos(null); return; }
+    const rect = chipRef.current.getBoundingClientRect();
+    setTooltipPos({ top: rect.top - 8, left: rect.left });
+  }, [showTooltip]);
+
   const preview = showPreview && previewPos && imageData && imageMime ? (
     <div
       className="fixed z-50 p-1 rounded-lg border border-border bg-card shadow-lg pointer-events-none"
@@ -75,16 +127,44 @@ export default function FileChip({ path, onRemove, variant = 'kb', imageData, im
     </div>
   ) : null;
 
+  const tooltipBorderCls = status === 'error'
+    ? 'border-destructive/20 text-destructive'
+    : 'border-amber-500/20 text-amber-600 dark:text-amber-400';
+
+  const tooltip = showTooltip && tooltipPos && tooltipText ? (
+    <div
+      className={`fixed z-50 px-2.5 py-1.5 rounded-lg border bg-card text-xs shadow-lg pointer-events-none max-w-[280px] ${tooltipBorderCls}`}
+      style={{
+        left: tooltipPos.left,
+        bottom: window.innerHeight - tooltipPos.top,
+      }}
+    >
+      {tooltipText}
+    </div>
+  ) : null;
+
+  const handleMouseEnter = () => {
+    if (imageData) setShowPreview(true);
+    if (tooltipText) setShowTooltip(true);
+  };
+  const handleMouseLeave = () => {
+    setShowPreview(false);
+    setShowTooltip(false);
+  };
+
   return (
     <>
       <span
         ref={chipRef}
         className={`inline-flex items-center gap-1 px-2 py-0.5 rounded-md text-xs border max-w-[220px] ${style}`}
-        onMouseEnter={() => imageData && setShowPreview(true)}
-        onMouseLeave={() => setShowPreview(false)}
+        onMouseEnter={handleMouseEnter}
+        onMouseLeave={handleMouseLeave}
       >
-        <Icon size={11} className={`${iconClass} shrink-0`} />
+        <BaseIcon size={11} className={`${baseIconCls} shrink-0`} />
         <span className="truncate" title={isDir ? cleanPath : path}>{name}</span>
+        {StatusIndicator && (
+          <StatusIndicator size={10} className={`${statusIndicatorCls} shrink-0`} />
+        )}
         <button
           type="button"
           onClick={onRemove}
@@ -95,6 +175,7 @@ export default function FileChip({ path, onRemove, variant = 'kb', imageData, im
         </button>
       </span>
       {mounted && preview && createPortal(preview, document.body)}
+      {mounted && tooltip && createPortal(tooltip, document.body)}
     </>
   );
 }

package/_standalone/components/changes/ChangesBanner.tsx

@@ -111,7 +111,7 @@ export default function ChangesBanner() {
             <History size={14} />
           </span>
           <div className="min-w-0 flex-1">
-            <p className="text-xs text-foreground font-display whitespace-nowrap">
+            <p className="text-xs text-foreground font-medium whitespace-nowrap">
               {t.changes.unreadBanner(unreadCount)}
             </p>
             <div className="mt-1 flex items-center gap-1.5">