@geminilight/mindos 0.6.67 → 0.6.70

package/_standalone/components/settings/{ServerPortsCard.tsx → WebPortSection.tsx}

@@ -51,8 +51,8 @@ function PortField({
 
   return (
     <div className="space-y-1">
-      <label className="text-xs font-medium text-foreground">{label}</label>
-      <p className="text-2xs text-muted-foreground">{hint}</p>
+      {label && <label className="text-xs font-medium text-foreground">{label}</label>}
+      {hint && <p className="text-2xs text-muted-foreground">{hint}</p>}
       <input
         type="number" min={1024} max={65535} value={value}
         onChange={handleChange}
@@ -107,46 +107,33 @@ function RestartOverlay({ message, sub }: { message: string; sub?: string }) {
   );
 }
 
-/* ── ServerPortsCard ───────────────────────────────────────────── */
-
-export default function ServerPortsCard({ m }: { m: Record<string, any> }) {
-  // Loaded from /api/settings
-  const [origWebPort, setOrigWebPort] = useState<number>(0);
-  const [origMcpPort, setOrigMcpPort] = useState<number>(0);
-
-  const [webPort, setWebPort] = useState<number>(0);
-  const [mcpPort, setMcpPort] = useState<number>(0);
-
-  const [webStatus, setWebStatus] = useState<PortStatus>(EMPTY_STATUS);
-  const [mcpStatus, setMcpStatus] = useState<PortStatus>(EMPTY_STATUS);
+/* ── WebPortSection ────────────────────────────────────────────── */
 
+export default function WebPortSection({ m }: { m: Record<string, any> }) {
+  const [origPort, setOrigPort] = useState<number>(0);
+  const [port, setPort] = useState<number>(0);
+  const [status, setStatus] = useState<PortStatus>(EMPTY_STATUS);
   const [updating, setUpdating] = useState(false);
   const [overlayMsg, setOverlayMsg] = useState<string | null>(null);
   const [overlaySub, setOverlaySub] = useState<string | undefined>(undefined);
   const pollRef = useRef<ReturnType<typeof setInterval>>(undefined);
 
-  // Load current ports from API
   useEffect(() => {
-    apiFetch<{ port?: number; mcpPort?: number }>('/api/settings').then(d => {
-      const wp = d.port || 3456;
-      const mp = d.mcpPort || 8781;
-      setOrigWebPort(wp); setWebPort(wp);
-      setOrigMcpPort(mp); setMcpPort(mp);
+    apiFetch<{ port?: number }>('/api/settings').then(d => {
+      const p = d.port || 3456;
+      setOrigPort(p);
+      setPort(p);
     }).catch(() => {});
   }, []);
 
   useEffect(() => () => clearInterval(pollRef.current), []);
 
-  const hasChanges = webPort !== origWebPort || mcpPort !== origMcpPort;
-  const portConflict = webPort === mcpPort && webPort > 0;
-  const portInvalid = webPort < 1024 || webPort > 65535 || mcpPort < 1024 || mcpPort > 65535;
-  const webChanged = webPort !== origWebPort;
-  const mcpChanged = mcpPort !== origMcpPort;
+  const hasChanges = port !== origPort;
+  const portInvalid = port < 1024 || port > 65535;
+  const portUnavailable = status.checking || (status.available === false && !status.isSelf);
 
-  // Port check via existing API
-  const checkPort = useCallback(async (port: number, which: 'web' | 'mcp') => {
-    const setStatus = which === 'web' ? setWebStatus : setMcpStatus;
-    if (port < 1024 || port > 65535) {
+  const checkPort = useCallback(async (p: number) => {
+    if (p < 1024 || p > 65535) {
       setStatus({ ...EMPTY_STATUS, available: false, invalid: true });
       return;
     }
@@ -155,7 +142,7 @@ export default function ServerPortsCard({ m }: { m: Record<string, any> }) {
       const res = await apiFetch<CheckPortResult>('/api/setup/check-port', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ port }),
+        body: JSON.stringify({ port: p }),
       });
       setStatus({
         checking: false,
@@ -168,131 +155,74 @@ export default function ServerPortsCard({ m }: { m: Record<string, any> }) {
     }
   }, []);
 
-  // Update handler
   const handleUpdate = async () => {
-    if (!hasChanges || portConflict || portInvalid || updating) return;
+    if (!hasChanges || portInvalid || portUnavailable || updating) return;
 
     setUpdating(true);
     try {
-      // 0. Final port availability check before committing
-      //    User may have waited a while since input — port state could have changed.
-      const portsToCheck: Array<{ port: number; which: 'web' | 'mcp' }> = [];
-      if (webChanged) portsToCheck.push({ port: webPort, which: 'web' });
-      if (mcpChanged) portsToCheck.push({ port: mcpPort, which: 'mcp' });
-
-      for (const { port, which } of portsToCheck) {
-        const res = await apiFetch<CheckPortResult>('/api/setup/check-port', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ port }),
+      // Final availability check
+      const res = await apiFetch<CheckPortResult>('/api/setup/check-port', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ port }),
+      });
+      if (!res.available && !res.isSelf) {
+        setStatus({
+          checking: false,
+          available: false,
+          isSelf: false,
+          suggestion: res.suggestion ?? null,
         });
-        if (!res.available && !res.isSelf) {
-          // Port became occupied since last check
-          const setStatus = which === 'web' ? setWebStatus : setMcpStatus;
-          setStatus({
-            checking: false,
-            available: false,
-            isSelf: false,
-            suggestion: res.suggestion ?? null,
-          });
-          setUpdating(false);
-          toast.error(m.portInUse(port));
-          return;
-        }
+        setUpdating(false);
+        toast.error(m.portInUse(port));
+        return;
       }
 
-      // 1. Save both ports to config
+      // Save port
       await apiFetch('/api/settings', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-          port: webPort,
-          mcpPort,
-        }),
+        body: JSON.stringify({ port }),
       });
 
-      // 2. Determine restart strategy
-      if (webChanged) {
-        // Full restart needed — Web port changed
-        setOverlayMsg(m.portWebRestarting);
-        setOverlaySub(m.portRedirecting);
+      // Full restart — Web port changed
+      setOverlayMsg(m.portWebRestarting);
+      setOverlaySub(m.portRedirecting);
 
-        try {
-          await apiFetch('/api/restart', { method: 'POST' });
-        } catch {
-          // Expected: server dies before response completes
-        }
+      try {
+        await apiFetch('/api/restart', { method: 'POST' });
+      } catch {
+        // Expected: server dies before response completes
+      }
 
-        // Poll new port for health
-        const newOrigin = `${window.location.protocol}//${window.location.hostname}:${webPort}`;
-        const deadline = Date.now() + 30_000;
-        pollRef.current = setInterval(async () => {
-          if (Date.now() > deadline) {
-            clearInterval(pollRef.current);
-            setOverlayMsg(null);
-            setUpdating(false);
-            toast.error(m.portRestartTimeout);
-            return;
-          }
-          try {
-            const res = await fetch(`${newOrigin}/api/health`, { signal: AbortSignal.timeout(2000) });
-            if (res.ok) {
-              clearInterval(pollRef.current);
-              // Redirect to new port
-              window.location.href = newOrigin;
-            }
-          } catch {
-            // Server not up yet, keep polling
-          }
-        }, 1500);
-      } else if (mcpChanged) {
-        // MCP-only restart
-        setOverlayMsg(m.portMcpRestarting);
-        try {
-          await apiFetch('/api/mcp/restart', { method: 'POST' });
-        } catch {
+      // Poll new port for health
+      const newOrigin = `${window.location.protocol}//${window.location.hostname}:${port}`;
+      const deadline = Date.now() + 30_000;
+      pollRef.current = setInterval(async () => {
+        if (Date.now() > deadline) {
+          clearInterval(pollRef.current);
           setOverlayMsg(null);
           setUpdating(false);
-          toast.error(m.portUpdateFailed);
+          toast.error(m.portRestartTimeout);
           return;
         }
-
-        // Poll MCP status
-        const deadline = Date.now() + 60_000;
-        pollRef.current = setInterval(async () => {
-          if (Date.now() > deadline) {
+        try {
+          const r = await fetch(`${newOrigin}/api/health`, { signal: AbortSignal.timeout(2000) });
+          if (r.ok) {
             clearInterval(pollRef.current);
-            setOverlayMsg(null);
-            setUpdating(false);
-            toast.error(m.portRestartTimeout);
-            return;
-          }
-          try {
-            const s = await apiFetch<{ running: boolean; port: number }>('/api/mcp/status', { timeout: 3000 });
-            if (s.running) {
-              clearInterval(pollRef.current);
-              setOverlayMsg(null);
-              setUpdating(false);
-              setOrigMcpPort(mcpPort);
-              toast.success(m.portUpdateSuccess);
-            }
-          } catch {
-            // keep polling
+            window.location.href = newOrigin;
           }
-        }, 3000);
-      } else {
-        // No restart needed (shouldn't reach here, but guard)
-        setUpdating(false);
-        toast.success(m.portUpdateSuccess);
-      }
+        } catch {
+          // Server not up yet
+        }
+      }, 1500);
     } catch {
       setUpdating(false);
       toast.error(m.portUpdateFailed);
     }
   };
 
-  // Don't render until data loaded
-  if (origWebPort === 0) return null;
+  if (origPort === 0) return null;
 
   return (
     <>
@@ -302,34 +232,20 @@ export default function ServerPortsCard({ m }: { m: Record<string, any> }) {
             <Monitor size={14} className="text-muted-foreground" />
           </div>
           <div className="flex-1 min-w-0">
-            <h3 className="text-sm font-semibold text-foreground">{m.portsCardTitle}</h3>
-            <p className="text-2xs text-muted-foreground">{m.portsCardDesc}</p>
+            <h3 className="text-sm font-semibold text-foreground">{m.webPortLabel}</h3>
+            <p className="text-2xs text-muted-foreground">{m.webPortHint}</p>
           </div>
         </div>
-        <div className="px-4 pb-4 space-y-4">
+        <div className="px-4 pb-4 space-y-3">
           <PortField
-            label={m.webPortLabel} hint={m.webPortHint}
-            value={webPort} onChange={v => { setWebPort(v); setWebStatus(EMPTY_STATUS); }}
-            status={webStatus} onCheckPort={p => checkPort(p, 'web')} m={m}
+            label="" hint=""
+            value={port} onChange={v => { setPort(v); setStatus(EMPTY_STATUS); }}
+            status={status} onCheckPort={checkPort} m={m}
           />
-          <PortField
-            label={m.mcpPortLabel} hint={m.mcpPortHint}
-            value={mcpPort} onChange={v => { setMcpPort(v); setMcpStatus(EMPTY_STATUS); }}
-            status={mcpStatus} onCheckPort={p => checkPort(p, 'mcp')} m={m}
-          />
-
-          {/* Conflict warning */}
-          {portConflict && (
-            <p className="text-xs flex items-center gap-1.5 text-[var(--amber)]">
-              <AlertTriangle size={12} /> {m.portConflict}
-            </p>
-          )}
-
-          {/* Update button */}
           <button
             type="button"
             onClick={handleUpdate}
-            disabled={!hasChanges || portConflict || portInvalid || updating}
+            disabled={!hasChanges || portInvalid || portUnavailable || updating}
             className="w-full py-2 rounded-lg text-xs font-medium transition-colors
               bg-[var(--amber)] text-[var(--amber-foreground)]
               hover:opacity-90
@@ -341,7 +257,6 @@ export default function ServerPortsCard({ m }: { m: Record<string, any> }) {
         </div>
       </div>
 
-      {/* Full-screen restart overlay */}
       {overlayMsg && <RestartOverlay message={overlayMsg} sub={overlaySub} />}
     </>
   );

package/_standalone/components/settings/types.ts

@@ -18,6 +18,18 @@ export interface AgentSettings {
 export interface SettingsData {
   ai: AiSettings;
   agent?: AgentSettings;
+  embedding?: {
+    enabled: boolean;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+  };
+  embeddingStatus?: {
+    enabled: boolean;
+    ready: boolean;
+    building: boolean;
+    docCount: number;
+  };
   mindRoot: string;
   webPassword?: string;
   authToken?: string;   // masked: first-xxxx-••••-last pattern

package/_standalone/components/settings/useCustomProviderForm.ts

@@ -5,7 +5,7 @@ import { type ProviderId } from '@/lib/agent/providers';
 import { type Provider, generateProviderId } from '@/lib/custom-endpoints';
 
 export type TestState = 'idle' | 'testing' | 'ok' | 'error';
-export type ErrorCode = 'auth_error' | 'model_not_found' | 'rate_limited' | 'network_error' | 'unknown';
+export type ErrorCode = 'auth_error' | 'model_not_found' | 'endpoint_error' | 'rate_limited' | 'network_error' | 'unknown';
 
 export interface TestResult {
   state: TestState;
@@ -78,7 +78,7 @@ export function useCustomProviderForm({
         body: JSON.stringify(
           initial?.id
             ? { provider: initial.id, apiKey, model, baseUrl }
-            : { protocol, apiKey, model, baseUrl },
+            : { provider: protocol, apiKey, model, baseUrl, baseProviderId: protocol },
         ),
       });
       const json = await res.json();

package/_standalone/data/skills/mindos/SKILL.md

@@ -75,16 +75,60 @@ npm install -g @geminilight/mindos
 
 ---
 
+## Retrieval strategy
+
+When retrieving knowledge, use **two paths in parallel**, then filter before deep-reading:
+
+### Path 1: Directory scan (by name/structure)
+
+Browse the KB tree and **look at file names and directory names**. Titles often reveal content without reading. If a user asks about "authentication", and you see `Decisions/auth-jwt-vs-session.md`, that's a strong candidate — read it directly, no search needed.
+
+- After bootstrap, scan the tree for paths whose names relate to the query topic.
+- Pay attention to directory semantics: `Decisions/`, `Projects/`, `Workflows/`, `Resources/` etc. each imply what kind of content lives there.
+- If the KB is small (<50 files), a quick tree scan may be faster and more reliable than search.
+
+### Path 2: Full-text search (by content)
+
+Use `search` for content that can't be guessed from file names alone.
+
+- Craft queries from the user's actual words. If the user says "那个很慢的接口", search for "慢 接口" or "性能 API".
+- One well-targeted search is better than 4 vague ones. Only add a second search if the first returned <3 results or if the topic has obvious alternate terms (e.g., Chinese + English).
+- **Do NOT** mechanically fire 2-4 searches every time. Think first, search precisely.
+
+### Filter: snippet triage before full read
+
+Search results include a **snippet** and a **BM25 score**. Use them to decide what to read:
+
+- **High score + snippet clearly on-topic** → read full file.
+- **Medium score + snippet partially relevant** → read full file only if no better candidates exist.
+- **Low score or snippet off-topic** → skip. Do not read every search result.
+- Aim to read **1-3 files** deeply, not 10 files superficially.
+
+### Combined example
+
+```
+User: "之前关于数据库选型的讨论"
+
+Step 1 (tree scan): See "Decisions/database-postgres-vs-mongo.md" → strong match by name.
+Step 2 (search):    search("数据库选型") → returns 5 results.
+Step 3 (triage):    Result #1 snippet mentions "PostgreSQL vs MongoDB 对比" (score 18.3) → read.
+                    Result #2 snippet mentions "数据库连接池配置" (score 4.1) → skip, off-topic.
+                    Result #3 snippet mentions "选型会议纪要" (score 12.7) → read.
+Step 4 (answer):    Cite from the 2-3 files actually read.
+```
+
+---
+
 ## NEVER do (hard-won pitfalls)
 
 - **NEVER write to the KB root** unless explicitly told. Root is for governance files only. New content goes under the most fitting subdirectory.
 - **NEVER assume directory names.** Infer from the actual bootstrap tree — the KB may use Chinese names or flat layout.
 - **NEVER use full-file overwrite for a small edit.** Use `mindos file edit-section` or `mindos file insert-heading` for targeted changes. Full rewrites destroy git diffs.
-- **NEVER search with a single keyword.** Fire 2-4 parallel searches (synonyms, abbreviations, Chinese/English variants).
 - **NEVER modify `INSTRUCTION.md` or `README.md` without confirmation.** Governance docs — treat as high-sensitivity.
 - **NEVER create a file without checking siblings.** Read 1-2 files in the target directory to learn local style.
 - **NEVER leave orphan references.** After rename/move, check backlinks and update every referring file.
 - **NEVER skip routing confirmation for multi-file writes.** The user's mental model may differ from yours.
+- **NEVER read every search result.** Use snippet + score to triage. Only deep-read files that are clearly relevant.
 
 ---
 

package/_standalone/hooks/useAcpDetection.ts

@@ -119,7 +119,7 @@ export function useAcpDetection(): AcpDetectionState {
         if (!cancelled) setLoading(false);
       });
 
-    return () => { cancelled = true; };
+    return () => { cancelled = true; inflight.current = false; };
   }, [trigger]); // eslint-disable-line react-hooks/exhaustive-deps
 
   return { installedAgents, notInstalledAgents, loading, error, refresh };

package/_standalone/hooks/useAcpRegistry.ts

@@ -79,7 +79,7 @@ export function useAcpRegistry(): AcpRegistryState {
         if (!cancelled) setLoading(false);
       });
 
-    return () => { cancelled = true; };
+    return () => { cancelled = true; inflight.current = false; };
   }, [trigger]); // eslint-disable-line react-hooks/exhaustive-deps
 
   return { agents, loading, error, retry };

package/_standalone/hooks/useFileImport.ts

@@ -57,8 +57,13 @@ async function extractPdfText(file: File): Promise<string> {
     const err = await res.json().catch(() => ({}));
     throw new Error((err as { error?: string }).error || 'PDF extraction failed');
   }
-  const data = await res.json() as { text?: string; extracted?: boolean };
-  if (!data.extracted || !data.text) throw new Error('No text extracted from PDF');
+  const data = await res.json() as { text?: string; extracted?: 'success' | 'empty' | 'error'; extractionError?: string };
+  if (data.extracted === 'error') {
+    throw new Error(data.extractionError || 'Failed to parse PDF');
+  }
+  if (data.extracted !== 'success' || !data.text) {
+    throw new Error('No text extracted from PDF');
+  }
   return data.text;
 }
 

package/_standalone/hooks/useFileUpload.ts

@@ -22,10 +22,6 @@ function uint8ToBase64(bytes: Uint8Array): string {
   return btoa(binary);
 }
 
-/**
- * Extract text from a PDF file via the backend API.
- * Returns a LocalAttachment with `status` reflecting the outcome.
- */
 async function extractPdfToAttachment(file: File): Promise<LocalAttachment> {
   const name = file.name;
 
@@ -41,7 +37,8 @@ async function extractPdfToAttachment(file: File): Promise<LocalAttachment> {
 
     let payload: {
       text?: string;
-      extracted?: boolean;
+      extracted?: 'success' | 'empty' | 'error';
+      extractionError?: string;
       error?: string;
       truncated?: boolean;
       totalChars?: number;
@@ -57,27 +54,37 @@ async function extractPdfToAttachment(file: File): Promise<LocalAttachment> {
       throw new Error(payload.error || `PDF extraction failed (${res.status})`);
     }
 
-    const extracted = payload.extracted ? (payload.text || '') : '';
+    // Handle extraction error state
+    if (payload.extracted === 'error') {
+      return {
+        name,
+        content: `[PDF: ${name}] Failed to extract text from this PDF.`,
+        status: 'error',
+        error: payload.extractionError || 'PDF extraction failed (unable to parse PDF)',
+      };
+    }
 
-    if (!extracted) {
+    // Handle empty PDF (no extraction error, but no text)
+    const text = payload.extracted === 'success' ? (payload.text || '') : '';
+    if (!text) {
       return {
         name,
         content: `[PDF: ${name}] Could not extract readable text (possibly scanned/image PDF).`,
         status: 'error',
-        error: 'Scanned or image-only PDF — no extractable text',
+        error: 'No extractable text found — PDF may be scanned, image-only, or have no text content',
       };
     }
 
     const att: LocalAttachment = {
       name,
-      content: `[PDF TEXT EXTRACTED: ${name}]\n\n${extracted}`,
+      content: `[PDF TEXT EXTRACTED: ${name}]\n\n${text}`,
       status: 'success',
     };
 
     if (payload.truncated && payload.totalChars) {
       att.truncatedInfo = {
         totalChars: payload.totalChars,
-        includedChars: extracted.length,
+        includedChars: text.length,
         totalPages: payload.pagesParsed ?? 0,
       };
     }

package/_standalone/lib/acp/index.ts

@@ -1,8 +1,9 @@
 export { fetchAcpRegistry, getAcpAgents, findAcpAgent, clearRegistryCache } from './registry';
-export { spawnAcpAgent, sendMessage, sendAndWait, onMessage, onNotification, onRequest, sendResponse, installAutoApproval, killAgent, killAllAgents, getProcess, getActiveProcesses } from './subprocess';
+export { spawnAndConnect, spawnAcpAgent, killAgent, killAllAgents, getProcess, getActiveProcesses } from './subprocess';
 export { createSession, createSessionFromEntry, loadSession, listSessions, prompt, promptStream, cancelPrompt, setMode, setConfigOption, closeSession, getSession, getActiveSessions, closeAllSessions } from './session';
 export { bridgeA2aToAcp, bridgeAcpResponseToA2a, bridgeAcpUpdatesToA2a } from './bridge';
 export { acpTools } from './acp-tools';
+export { AGENT_DESCRIPTORS, AGENT_ALIASES, resolveAlias, findUserOverride, getDetectableAgents } from './agent-descriptors';
 export { ACP_ERRORS } from './types';
 export type {
   AcpAgentCapabilities,
@@ -16,10 +17,6 @@ export type {
   AcpSessionState,
   AcpSession,
   AcpSessionInfo,
-  AcpJsonRpcRequest,
-  AcpJsonRpcResponse,
-  AcpJsonRpcError,
-  AcpPromptRequest,
   AcpPromptResponse,
   AcpUpdateType,
   AcpSessionUpdate,
@@ -37,4 +34,5 @@ export type {
   AcpRegistry,
   AcpTransportType,
 } from './types';
-export type { AcpProcess, AcpIncomingRequest, AcpNotification } from './subprocess';
+export type { AcpProcess, AcpClientCallbacks, AcpConnection } from './subprocess';
+export type { AcpAgentDescriptor, AcpAgentOverride, ResolvedAgentCommand, DetectableAgent } from './agent-descriptors';

package/_standalone/lib/acp/types.ts

@@ -100,37 +100,8 @@ export interface AcpSessionInfo {
   updatedAt?: string;
 }
 
-/* ── JSON-RPC (ACP uses JSON-RPC 2.0 over stdio) ─────────────────────── */
-
-export interface AcpJsonRpcRequest {
-  jsonrpc: '2.0';
-  id: string | number;
-  method: string;
-  params?: Record<string, unknown>;
-}
-
-export interface AcpJsonRpcResponse {
-  jsonrpc: '2.0';
-  id: string | number | null;
-  result?: unknown;
-  error?: AcpJsonRpcError;
-}
-
-export interface AcpJsonRpcError {
-  code: number;
-  message: string;
-  data?: unknown;
-}
-
 /* ── Prompt ────────────────────────────────────────────────────────────── */
 
-export interface AcpPromptRequest {
-  sessionId: string;
-  prompt: AcpContentBlock[];
-  context?: { cwd?: string };
-  stream?: boolean;
-}
-
 export interface AcpPromptResponse {
   sessionId: string;
   text: string;

package/_standalone/lib/im/platforms.ts

@@ -13,6 +13,8 @@ export interface PlatformDef {
   icon: string;
   fields: PlatformField[];
   guide?: string;
+  guideUrl?: string;
+  editHint?: string;
 }
 
 export type PlatformStatus = {
@@ -33,9 +35,11 @@ export const PLATFORMS: PlatformDef[] = [
   {
     id: 'feishu', name: 'Feishu', icon: '🐦',
     guide: '1. open.feishu.cn → Create App\n2. Credentials page → copy App ID & Secret\n3. Enable Bot capability + add permissions',
+    guideUrl: 'https://open.feishu.cn/',
+    editHint: 'Need to update credentials? Edit and save below — MindOS will reconnect automatically.',
     fields: [
-      { key: 'app_id', label: 'App ID', placeholder: 'cli_a5xxxxxxxxxxxxx' },
-      { key: 'app_secret', label: 'App Secret', placeholder: 'xxxxxxxxxxxxxxxxxxxxxxxx' },
+      { key: 'app_id', label: 'App ID', placeholder: 'CLI_XXXXXXXXXXXXXXXXX', hint: 'From Credentials page on open.feishu.cn' },
+      { key: 'app_secret', label: 'App Secret', placeholder: 'XXXXXXXXXXXXXXXXXXXXXXXX', hint: 'Keep this secret — do not share' },
     ],
   },
   {

package/_standalone/lib/pdf-extract.ts

@@ -18,7 +18,7 @@ export async function extractPdfText(file: File): Promise<string> {
     body: JSON.stringify({ name: file.name, dataBase64 }),
   });
 
-  let payload: { text?: string; extracted?: boolean; error?: string } = {};
+  let payload: { text?: string; extracted?: 'success' | 'empty' | 'error'; extractionError?: string; error?: string } = {};
   try {
     payload = await res.json();
   } catch {
@@ -29,5 +29,9 @@ export async function extractPdfText(file: File): Promise<string> {
     throw new Error(payload.error || `PDF extraction failed (${res.status})`);
   }
 
-  return payload.extracted ? (payload.text || '') : '';
+  if (payload.extracted === 'error') {
+    throw new Error(payload.extractionError || 'Failed to parse PDF');
+  }
+
+  return payload.extracted === 'success' ? (payload.text || '') : '';
 }

package/_standalone/package-lock.json

@@ -1,14 +1,15 @@
 {
   "name": "wiki-app",
-  "version": "0.1.1",
+  "version": "0.6.70",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "wiki-app",
-      "version": "0.1.1",
+      "version": "0.6.70",
       "hasInstallScript": true,
       "dependencies": {
+        "@agentclientprotocol/sdk": "^0.18.2",
         "@base-ui/react": "^1.2.0",
         "@codemirror/lang-markdown": "^6.5.0",
         "@codemirror/state": "^6.5.4",
@@ -91,6 +92,15 @@
         "wait-on": "^8.0.1"
       }
     },
+    "node_modules/@agentclientprotocol/sdk": {
+      "version": "0.18.2",
+      "resolved": "https://registry.npmmirror.com/@agentclientprotocol/sdk/-/sdk-0.18.2.tgz",
+      "integrity": "sha512-l/o9NKvUc00GPa6RFJ4AccQq2O/PAf83xQ75mThHuL3H571iN4+PEdwnTBez67sS8Nv2aSA373xCZ5CbTXEwzA==",
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "zod": "^3.25.0 || ^4.0.0"
+      }
+    },
     "node_modules/@alloc/quick-lru": {
       "version": "5.2.0",
       "dev": true,