@geminilight/mindos 0.5.69 → 0.5.70

package/app/components/ask/AskContent.tsx

@@ -177,6 +177,17 @@ export default function AskContent({ visible, currentFile, initialMessage, onFir
   const upload = useFileUpload();
   const mention = useMention();
 
+  useEffect(() => {
+    const handler = (e: Event) => {
+      const files = (e as CustomEvent).detail?.files;
+      if (Array.isArray(files) && files.length > 0) {
+        upload.injectFiles(files);
+      }
+    };
+    window.addEventListener('mindos:inject-ask-files', handler);
+    return () => window.removeEventListener('mindos:inject-ask-files', handler);
+  }, [upload]);
+
   // Focus and init session when becoming visible (edge-triggered for panel, level-triggered for modal)
   const prevVisibleRef = useRef(false);
   useEffect(() => {

package/app/components/panels/AgentsPanelAgentGroups.tsx

@@ -34,13 +34,14 @@ export function AgentsPanelAgentGroups({
 }) {
   return (
     <div>
-      <div className="px-0 py-1 mb-0.5">
-        <span className="text-2xs font-semibold text-muted-foreground uppercase tracking-wider">{p.rosterLabel}</span>
+      <div className="px-0 py-1.5 mb-1">
+        <span className="text-2xs font-semibold text-muted-foreground/70 uppercase tracking-wider">{p.rosterLabel}</span>
       </div>
       {connected.length > 0 && (
         <section className="mb-3">
-          <h3 className="text-[11px] font-medium text-muted-foreground/90 uppercase tracking-wider mb-2 pl-0.5">
-            {p.sectionConnected} ({connected.length})
+          <h3 className="flex items-center gap-1.5 text-[11px] font-medium text-muted-foreground/80 uppercase tracking-wider mb-2 pl-0.5">
+            <span className="w-1 h-3 rounded-full bg-[var(--success)]/50" aria-hidden="true" />
+            {p.sectionConnected} <span className="text-muted-foreground/50 tabular-nums">({connected.length})</span>
           </h3>
           <div className="space-y-1.5">
             {connected.map(agent => (
@@ -60,8 +61,9 @@ export function AgentsPanelAgentGroups({
 
       {detected.length > 0 && (
         <section className="mb-3">
-          <h3 className="text-[11px] font-medium text-muted-foreground/90 uppercase tracking-wider mb-2 pl-0.5">
-            {p.sectionDetected} ({detected.length})
+          <h3 className="flex items-center gap-1.5 text-[11px] font-medium text-muted-foreground/80 uppercase tracking-wider mb-2 pl-0.5">
+            <span className="w-1 h-3 rounded-full bg-[var(--amber)]/50" aria-hidden="true" />
+            {p.sectionDetected} <span className="text-muted-foreground/50 tabular-nums">({detected.length})</span>
           </h3>
           <div className="space-y-1.5">
             {detected.map(agent => (

package/app/components/panels/AgentsPanelHubNav.tsx

@@ -27,18 +27,18 @@ export function AgentsPanelHubNav({
       <PanelNavRow
         icon={<LayoutDashboard size={14} className="text-[var(--amber)]" />}
         title={copy.navOverview}
-        badge={<span className="text-2xs tabular-nums text-muted-foreground">{connectedCount}</span>}
+        badge={<span className="text-2xs tabular-nums text-muted-foreground/60 px-1.5 py-0.5 rounded bg-muted/40 font-medium">{connectedCount}</span>}
         href="/agents"
         active={inAgentsRoute && (tab === null || tab === 'overview')}
       />
       <PanelNavRow
-        icon={<Server size={14} className="text-muted-foreground" />}
+        icon={<Server size={14} className={inAgentsRoute && tab === 'mcp' ? 'text-[var(--amber)]' : 'text-muted-foreground'} />}
         title={copy.navMcp}
         href="/agents?tab=mcp"
         active={inAgentsRoute && tab === 'mcp'}
       />
       <PanelNavRow
-        icon={<Zap size={14} className="text-muted-foreground" />}
+        icon={<Zap size={14} className={inAgentsRoute && tab === 'skills' ? 'text-[var(--amber)]' : 'text-muted-foreground'} />}
         title={copy.navSkills}
         href="/agents?tab=skills"
         active={inAgentsRoute && tab === 'skills'}

package/app/components/panels/DiscoverPanel.tsx

@@ -1,11 +1,15 @@
 'use client';
 
-import { Lightbulb, Blocks, Zap, LayoutTemplate, User, Download, RefreshCw, Repeat, Rocket, Search, Handshake, ShieldCheck } from 'lucide-react';
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { useRouter } from 'next/navigation';
+import { Lightbulb, Blocks, Zap, LayoutTemplate, User, Download, RefreshCw, Repeat, Rocket, Search, Handshake, ShieldCheck, ChevronDown } from 'lucide-react';
 import PanelHeader from './PanelHeader';
 import { PanelNavRow, ComingSoonBadge } from './PanelNavRow';
 import { useLocale } from '@/lib/LocaleContext';
 import { useCases } from '@/components/explore/use-cases';
 import { openAskModal } from '@/hooks/useAskModal';
+import { getPluginRenderers, isRendererEnabled, setRendererEnabled, loadDisabledState } from '@/lib/renderers/registry';
+import { Toggle } from '../settings/Primitives';
 
 interface DiscoverPanelProps {
   active: boolean;
@@ -56,8 +60,44 @@ export default function DiscoverPanel({ active, maximized, onMaximize }: Discove
   const { t } = useLocale();
   const d = t.panels.discover;
   const e = t.explore;
+  const p = t.panels.plugins;
+  const router = useRouter();
+
+  const [pluginsMounted, setPluginsMounted] = useState(false);
+  const [showPlugins, setShowPlugins] = useState(false);
+  const [, forceUpdate] = useState(0);
+  const [existingFiles, setExistingFiles] = useState<Set<string>>(new Set());
+  const fetchedRef = useRef(false);
+
+  useEffect(() => {
+    loadDisabledState();
+    setPluginsMounted(true);
+  }, []);
+
+  useEffect(() => {
+    if (!pluginsMounted || fetchedRef.current) return;
+    fetchedRef.current = true;
+    const entryPaths = getPluginRenderers().map(r => r.entryPath).filter((ep): ep is string => !!ep);
+    if (entryPaths.length === 0) return;
+    fetch('/api/files')
+      .then(r => r.ok ? r.json() : [])
+      .then((allPaths: string[]) => {
+        const pathSet = new Set(allPaths);
+        setExistingFiles(new Set(entryPaths.filter(ep => pathSet.has(ep))));
+      })
+      .catch(() => {});
+  }, [pluginsMounted]);
+
+  const handleToggle = useCallback((id: string, enabled: boolean) => {
+    setRendererEnabled(id, enabled);
+    forceUpdate(n => n + 1);
+    window.dispatchEvent(new Event('renderer-state-changed'));
+  }, []);
+
+  const handleOpenPlugin = useCallback((entryPath: string) => {
+    router.push(`/view/${entryPath.split('/').map(encodeURIComponent).join('/')}`);
+  }, [router]);
 
-  /** Type-safe lookup for use case i18n */
   const getUseCaseText = (id: string): { title: string; prompt: string } | undefined => {
     const map: Record<string, { title: string; desc: string; prompt: string }> = {
       c1: e.c1, c2: e.c2, c3: e.c3, c4: e.c4, c5: e.c5,
@@ -66,6 +106,9 @@ export default function DiscoverPanel({ active, maximized, onMaximize }: Discove
     return map[id];
   };
 
+  const renderers = pluginsMounted ? getPluginRenderers() : [];
+  const enabledCount = pluginsMounted ? renderers.filter(r => isRendererEnabled(r.id)).length : 0;
+
   return (
     <div className={`flex flex-col h-full ${active ? '' : 'hidden'}`}>
       <PanelHeader title={d.title} maximized={maximized} onMaximize={onMaximize} />
@@ -97,6 +140,49 @@ export default function DiscoverPanel({ active, maximized, onMaximize }: Discove
 
         <div className="mx-4 border-t border-border" />
 
+        {/* Installed extensions (merged from Plugins panel) */}
+        <div className="py-2">
+          <button
+            type="button"
+            onClick={() => setShowPlugins(v => !v)}
+            className="w-full flex items-center gap-1.5 px-4 py-1.5 text-left"
+          >
+            <ChevronDown size={11} className={`text-muted-foreground transition-transform duration-150 ${showPlugins ? '' : '-rotate-90'}`} />
+            <Blocks size={13} className="text-muted-foreground shrink-0" />
+            <span className="text-2xs font-medium text-muted-foreground uppercase tracking-wider flex-1">
+              {p.title}
+            </span>
+            <span className="text-2xs text-muted-foreground tabular-nums">{enabledCount}/{renderers.length}</span>
+          </button>
+          {showPlugins && renderers.map(r => {
+            const enabled = isRendererEnabled(r.id);
+            const fileExists = r.entryPath ? existingFiles.has(r.entryPath) : false;
+            const canOpen = enabled && r.entryPath && fileExists;
+            return (
+              <div
+                key={r.id}
+                className={`flex items-center gap-2 px-4 py-1.5 mx-1 rounded-sm transition-colors ${canOpen ? 'cursor-pointer hover:bg-muted/50' : ''} ${!enabled ? 'opacity-50' : ''}`}
+                onClick={canOpen ? () => handleOpenPlugin(r.entryPath!) : undefined}
+                role={canOpen ? 'link' : undefined}
+                tabIndex={canOpen ? 0 : undefined}
+                onKeyDown={canOpen ? (e) => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); handleOpenPlugin(r.entryPath!); } } : undefined}
+              >
+                <span className="text-sm shrink-0" suppressHydrationWarning>{r.icon}</span>
+                <span className="text-xs text-foreground truncate flex-1">{r.name}</span>
+                {r.core ? (
+                  <span className="text-2xs px-1.5 py-0.5 rounded bg-muted text-muted-foreground shrink-0">{p.core}</span>
+                ) : (
+                  <div onClick={e => e.stopPropagation()}>
+                    <Toggle checked={enabled} onChange={v => handleToggle(r.id, v)} size="sm" />
+                  </div>
+                )}
+              </div>
+            );
+          })}
+        </div>
+
+        <div className="mx-4 border-t border-border" />
+
         {/* Quick try — use case list */}
         <div className="py-2">
           <div className="px-4 py-1.5">

package/app/hooks/useFileImport.ts

@@ -0,0 +1,191 @@
+'use client';
+
+import { useState, useCallback, useRef } from 'react';
+import { ALLOWED_IMPORT_EXTENSIONS } from '@/lib/core/file-convert';
+
+export type ImportIntent = 'archive' | 'digest';
+export type ImportStep = 'select' | 'archive_config' | 'importing' | 'done';
+export type ConflictMode = 'skip' | 'rename' | 'overwrite';
+
+export interface ImportFile {
+  file: File;
+  name: string;
+  size: number;
+  content: string | null;
+  loading: boolean;
+  error: string | null;
+}
+
+const MAX_FILE_SIZE = 5 * 1024 * 1024;
+const MAX_PDF_SIZE = 12 * 1024 * 1024;
+const MAX_FILES = 20;
+
+function getExt(name: string): string {
+  const idx = name.lastIndexOf('.');
+  return idx >= 0 ? name.slice(idx).toLowerCase() : '';
+}
+
+function formatSize(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+export function useFileImport() {
+  const [files, setFiles] = useState<ImportFile[]>([]);
+  const [step, setStep] = useState<ImportStep>('select');
+  const [intent, setIntent] = useState<ImportIntent>('archive');
+  const [targetSpace, setTargetSpace] = useState('');
+  const [conflict, setConflict] = useState<ConflictMode>('rename');
+  const [importing, setImporting] = useState(false);
+  const [result, setResult] = useState<{
+    created: Array<{ original: string; path: string }>;
+    skipped: Array<{ name: string; reason: string }>;
+    errors: Array<{ name: string; error: string }>;
+    updatedFiles: string[];
+  } | null>(null);
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  const addFiles = useCallback(async (fileList: FileList | File[]) => {
+    const incoming = Array.from(fileList).slice(0, MAX_FILES);
+    const newFiles: ImportFile[] = [];
+
+    for (const file of incoming) {
+      const ext = getExt(file.name);
+      const maxSize = ext === '.pdf' ? MAX_PDF_SIZE : MAX_FILE_SIZE;
+
+      let error: string | null = null;
+      if (!ALLOWED_IMPORT_EXTENSIONS.has(ext)) {
+        error = 'unsupported';
+      } else if (file.size > maxSize) {
+        error = 'tooLarge';
+      }
+
+      newFiles.push({
+        file,
+        name: file.name,
+        size: file.size,
+        content: null,
+        loading: !error,
+        error,
+      });
+    }
+
+    setFiles(prev => {
+      const merged = [...prev];
+      for (const f of newFiles) {
+        const isDup = merged.some(m =>
+          m.name === f.name && m.size === f.size
+        );
+        if (!isDup && merged.length < MAX_FILES) merged.push(f);
+      }
+      return merged;
+    });
+
+    for (const f of newFiles) {
+      if (f.error) continue;
+      try {
+        const text = await f.file.text();
+        setFiles(prev => prev.map(p =>
+          p.name === f.name && p.size === f.size
+            ? { ...p, content: text, loading: false }
+            : p
+        ));
+      } catch {
+        setFiles(prev => prev.map(p =>
+          p.name === f.name && p.size === f.size
+            ? { ...p, loading: false, error: 'readFailed' }
+            : p
+        ));
+      }
+    }
+  }, []);
+
+  const removeFile = useCallback((index: number) => {
+    setFiles(prev => prev.filter((_, i) => i !== index));
+  }, []);
+
+  const clearFiles = useCallback(() => {
+    setFiles([]);
+    setStep('select');
+    setResult(null);
+  }, []);
+
+  const validFiles = files.filter(f => !f.error && f.content !== null);
+  const allReady = files.length > 0 && files.every(f => !f.loading);
+  const hasErrors = files.some(f => f.error);
+
+  const doArchive = useCallback(async () => {
+    if (validFiles.length === 0) return;
+    setImporting(true);
+    setStep('importing');
+
+    try {
+      const payload = {
+        files: validFiles.map(f => ({
+          name: f.name,
+          content: f.content!,
+        })),
+        targetSpace: targetSpace || undefined,
+        conflict,
+        organize: true,
+      };
+
+      const res = await fetch('/api/file/import', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+      });
+
+      const data = await res.json();
+      if (!res.ok) throw new Error(data.error || `HTTP ${res.status}`);
+
+      setResult(data);
+      setStep('done');
+    } catch (err) {
+      setResult({
+        created: [],
+        skipped: [],
+        errors: [{ name: '*', error: (err as Error).message }],
+        updatedFiles: [],
+      });
+      setStep('done');
+    } finally {
+      setImporting(false);
+    }
+  }, [validFiles, targetSpace, conflict]);
+
+  const reset = useCallback(() => {
+    setFiles([]);
+    setStep('select');
+    setIntent('archive');
+    setTargetSpace('');
+    setConflict('rename');
+    setImporting(false);
+    setResult(null);
+  }, []);
+
+  return {
+    files,
+    step,
+    intent,
+    targetSpace,
+    conflict,
+    importing,
+    result,
+    inputRef,
+    validFiles,
+    allReady,
+    hasErrors,
+    addFiles,
+    removeFile,
+    clearFiles,
+    setStep,
+    setIntent,
+    setTargetSpace,
+    setConflict,
+    doArchive,
+    reset,
+    formatSize,
+  };
+}

package/app/hooks/useFileUpload.ts

@@ -115,6 +115,16 @@ export function useFileUpload() {
     setUploadError('');
   }, []);
 
+  const injectFiles = useCallback((files: LocalAttachment[]) => {
+    setLocalAttachments(prev => {
+      const merged = [...prev];
+      for (const item of files) {
+        if (!merged.some(m => m.name === item.name)) merged.push(item);
+      }
+      return merged;
+    });
+  }, []);
+
   return {
     localAttachments,
     uploadError,
@@ -122,5 +132,6 @@ export function useFileUpload() {
     pickFiles,
     removeAttachment,
     clearAttachments,
+    injectFiles,
   };
 }

package/app/lib/agent/tools.ts

@@ -94,6 +94,14 @@ const AppendParams = Type.Object({
   content: Type.String({ description: 'Content to append' }),
 });
 
+const FetchUrlParams = Type.Object({
+  url: Type.String({ description: 'The HTTP/HTTPS URL to fetch' }),
+});
+
+const WebSearchParams = Type.Object({
+  query: Type.String({ description: 'The search query or keywords to look up on the internet' }),
+});
+
 const InsertHeadingParams = Type.Object({
   path: Type.String({ description: 'Relative file path' }),
   heading: Type.String({ description: 'Heading text to find (e.g. "## Tasks" or just "Tasks")' }),
@@ -243,6 +251,144 @@ export const knowledgeBaseTools: AgentTool<any>[] = [
     }),
   },
 
+  {
+    name: 'web_search',
+    label: 'Web Search',
+    description: 'Search the internet for up-to-date information. Uses DuckDuckGo HTML search. Returns top search results with titles, snippets, and URLs.',
+    parameters: WebSearchParams,
+    execute: safeExecute(async (_id, params: Static<typeof WebSearchParams>) => {
+      try {
+        const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(params.query)}`;
+        const res = await fetch(url, {
+          headers: {
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+            'Accept-Language': 'en-US,en;q=0.9',
+          },
+          signal: AbortSignal.timeout(10000)
+        });
+        
+        if (!res.ok) {
+          return textResult(`Failed to search: HTTP ${res.status}`);
+        }
+        
+        const html = await res.text();
+        const results: string[] = [];
+        
+        // Simple regex parsing for DuckDuckGo HTML results
+        const resultBlocks = html.split('class="result__body"').slice(1);
+        
+        for (let i = 0; i < Math.min(resultBlocks.length, 5); i++) {
+          const block = resultBlocks[i];
+          
+          const titleMatch = block.match(/class="result__title"[^>]*>[\s\S]*?<a[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/i);
+          const snippetMatch = block.match(/class="result__snippet[^>]*>([\s\S]*?)(?:<\/a>|<\/div>)/i);
+          
+          if (titleMatch) {
+            let link = titleMatch[1];
+            // Decode DuckDuckGo redirect URL if necessary
+            if (link.startsWith('//duckduckgo.com/l/?uddg=')) {
+              const urlParam = new URL('https:' + link).searchParams.get('uddg');
+              if (urlParam) link = decodeURIComponent(urlParam);
+            }
+            
+            // Clean up tags
+            const title = titleMatch[2].replace(/<[^>]+>/g, '').trim();
+            const snippet = snippetMatch ? snippetMatch[1].replace(/<[^>]+>/g, '').trim() : '';
+            
+            results.push(`### ${i+1}. ${title}\n**URL:** ${link}\n**Snippet:** ${snippet}\n`);
+          }
+        }
+        
+        if (results.length === 0) {
+          return textResult(`No web search results found for: ${params.query}`);
+        }
+        
+        return textResult(`## Web Search Results for: "${params.query}"\n\n${results.join('\n')}\n\n*Note: Use web_fetch tool with any of the URLs above to read the full page content.*`);
+      } catch (err) {
+        return textResult(`Web search failed: ${formatToolError(err)}`);
+      }
+    }),
+  },
+
+  {
+    name: 'web_fetch',
+    label: 'Web Fetch',
+    description: 'Fetch the text content of any public URL. Extracts main text from HTML and converts it to Markdown. Use this to read external docs, repos, or articles.',
+    parameters: FetchUrlParams,
+    execute: safeExecute(async (_id, params: Static<typeof FetchUrlParams>) => {
+      let url = params.url;
+      if (!url.startsWith('http://') && !url.startsWith('https://')) {
+        url = 'https://' + url;
+      }
+      
+      try {
+        const res = await fetch(url, {
+          headers: {
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+            'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8',
+          },
+          // Don't wait forever
+          signal: AbortSignal.timeout(10000)
+        });
+        
+        if (!res.ok) {
+          return textResult(`Failed to fetch URL: HTTP ${res.status} ${res.statusText}`);
+        }
+        
+        const contentType = res.headers.get('content-type') || '';
+        
+        // If it's a raw file (like raw.githubusercontent.com or a raw text file)
+        if (contentType.includes('text/plain') || contentType.includes('application/json') || url.includes('raw.githubusercontent.com')) {
+          const text = await res.text();
+          return textResult(truncate(text));
+        }
+        
+        // For HTML, we do a basic extraction (in a real app you might use JSDOM/Readability, but we'll do a robust regex cleanup here to avoid new dependencies)
+        let html = await res.text();
+        
+        // Extract title if possible
+        const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+        const title = titleMatch ? titleMatch[1].trim() : url;
+        
+        // Strip out scripts, styles, svg, and headers/footers roughly
+        html = html.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, ' ')
+                   .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, ' ')
+                   .replace(/<svg\b[^<]*(?:(?!<\/svg>)<[^<]*)*<\/svg>/gi, ' ')
+                   .replace(/<header\b[^<]*(?:(?!<\/header>)<[^<]*)*<\/header>/gi, ' ')
+                   .replace(/<footer\b[^<]*(?:(?!<\/footer>)<[^<]*)*<\/footer>/gi, ' ')
+                   .replace(/<nav\b[^<]*(?:(?!<\/nav>)<[^<]*)*<\/nav>/gi, ' ');
+
+        // Convert some basic tags to markdown equivalents roughly before stripping all HTML
+        html = html.replace(/<h[1-2][^>]*>(.*?)<\/h[1-2]>/gi, '\n\n# $1\n\n')
+                   .replace(/<h[3-6][^>]*>(.*?)<\/h[3-6]>/gi, '\n\n## $1\n\n')
+                   .replace(/<p[^>]*>(.*?)<\/p>/gi, '\n\n$1\n\n')
+                   .replace(/<li[^>]*>(.*?)<\/li>/gi, '\n- $1')
+                   .replace(/<br\s*\/?>/gi, '\n');
+                   
+        // Strip remaining HTML tags
+        let text = html.replace(/<[^>]+>/g, ' ');
+        
+        // Decode common HTML entities
+        text = text.replace(/&nbsp;/g, ' ')
+                   .replace(/&amp;/g, ' ')
+                   .replace(/&lt;/g, '<')
+                   .replace(/&gt;/g, '>')
+                   .replace(/&quot;/g, '"')
+                   .replace(/&#39;/g, "'");
+
+        // Clean up whitespace: remove empty lines and extra spaces
+        text = text.replace(/[ \t]+/g, ' ')
+                   .replace(/\n\s*\n\s*\n/g, '\n\n')
+                   .trim();
+                   
+        const result = `# ${title}\nSource: ${url}\n\n${text}`;
+        return textResult(truncate(result));
+      } catch (err) {
+        return textResult(`Failed to fetch URL: ${formatToolError(err)}`);
+      }
+    }),
+  },
+
   {
     name: 'get_recent',
     label: 'Recent Files',

package/app/lib/core/file-convert.ts

@@ -0,0 +1,97 @@
+import path from 'path';
+
+export const ALLOWED_IMPORT_EXTENSIONS = new Set([
+  '.txt', '.md', '.markdown', '.csv', '.json', '.yaml', '.yml', '.xml', '.html', '.htm', '.pdf',
+]);
+
+export interface ConvertResult {
+  content: string;
+  originalName: string;
+  targetName: string;
+  metadata?: Record<string, string>;
+}
+
+export function sanitizeFileName(name: string): string {
+  let base = name.replace(/\\/g, '/').split('/').pop() ?? '';
+  base = base.replace(/\.\./g, '').replace(/^\/+/, '');
+  base = base.replace(/[\\:*?"<>|]/g, '-');
+  base = base.replace(/-{2,}/g, '-');
+  base = base.replace(/^[-\s]+|[-\s]+$/g, '');
+  return base || 'imported-file';
+}
+
+export function titleFromFileName(name: string): string {
+  const ext = path.extname(name);
+  const stem = (ext ? name.slice(0, -ext.length) : name).replace(/^\.+/, '');
+  const words = stem.replace(/[-_]+/g, ' ').trim().split(/\s+/);
+  if (words.length === 0 || (words.length === 1 && !words[0])) return 'Untitled';
+  return words.map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+}
+
+function stripHtmlTags(html: string): string {
+  return html
+    .replace(/<script[\s\S]*?<\/script>/gi, '')
+    .replace(/<style[\s\S]*?<\/style>/gi, '')
+    .replace(/<[^>]+>/g, '')
+    .replace(/&nbsp;/g, ' ')
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+}
+
+export function convertToMarkdown(fileName: string, rawContent: string): ConvertResult {
+  const originalName = fileName;
+  const ext = path.extname(fileName).toLowerCase();
+  const stem = path.basename(fileName, ext) || 'note';
+  const title = titleFromFileName(fileName);
+
+  if (ext === '.md' || ext === '.markdown') {
+    return { content: rawContent, originalName, targetName: sanitizeFileName(fileName) };
+  }
+
+  if (ext === '.csv' || ext === '.json') {
+    return { content: rawContent, originalName, targetName: sanitizeFileName(fileName) };
+  }
+
+  if (ext === '.txt') {
+    return {
+      content: `# ${title}\n\n${rawContent}`,
+      originalName,
+      targetName: sanitizeFileName(`${stem}.md`),
+    };
+  }
+
+  if (ext === '.yaml' || ext === '.yml') {
+    return {
+      content: `# ${title}\n\n\`\`\`yaml\n${rawContent}\n\`\`\`\n`,
+      originalName,
+      targetName: sanitizeFileName(`${stem}.md`),
+    };
+  }
+
+  if (ext === '.html' || ext === '.htm') {
+    const text = stripHtmlTags(rawContent);
+    return {
+      content: `# ${title}\n\n${text}\n`,
+      originalName,
+      targetName: sanitizeFileName(`${stem}.md`),
+    };
+  }
+
+  if (ext === '.xml') {
+    return {
+      content: `# ${title}\n\n\`\`\`xml\n${rawContent}\n\`\`\`\n`,
+      originalName,
+      targetName: sanitizeFileName(`${stem}.md`),
+    };
+  }
+
+  return {
+    content: `# ${title}\n\n${rawContent}`,
+    originalName,
+    targetName: sanitizeFileName(`${stem}.md`),
+  };
+}