@geminilight/mindos 0.5.70 → 0.6.1

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

@@ -1,22 +1,30 @@
 export const dynamic = 'force-dynamic';
-import { Agent, type AgentEvent, type BeforeToolCallContext, type BeforeToolCallResult, type AfterToolCallContext, type AfterToolCallResult } from '@mariozechner/pi-agent-core';
+import type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';
+import {
+  type AgentSessionEvent as AgentEvent,
+  AuthStorage,
+  convertToLlm,
+  createAgentSession,
+  DefaultResourceLoader,
+  ModelRegistry,
+  type ToolDefinition,
+  SessionManager,
+  SettingsManager,
+} from '@mariozechner/pi-coding-agent';
 import { NextRequest, NextResponse } from 'next/server';
 import fs from 'fs';
 import path from 'path';
 import { getFileContent, getMindRoot } from '@/lib/fs';
 import { getModelConfig } from '@/lib/agent/model';
-import { knowledgeBaseTools, WRITE_TOOLS, truncate } from '@/lib/agent/tools';
+import { getRequestScopedTools, WRITE_TOOLS, truncate } from '@/lib/agent/tools';
 import { AGENT_SYSTEM_PROMPT } from '@/lib/agent/prompt';
 import { toAgentMessages } from '@/lib/agent/to-agent-messages';
-import {
-  estimateTokens, estimateStringTokens, getContextLimit,
-  createTransformContext,
-} from '@/lib/agent/context';
 import { logAgentOp } from '@/lib/agent/log';
 import { readSettings } from '@/lib/settings';
 import { MindOSError, apiError, ErrorCodes } from '@/lib/errors';
 import { metrics } from '@/lib/metrics';
 import { assertNotProtected } from '@/lib/core';
+import { scanExtensionPaths } from '@/lib/pi-integration/extensions';
 import type { Message as FrontendMessage } from '@/lib/types';
 
 // ---------------------------------------------------------------------------
@@ -147,6 +155,64 @@ function dirnameOf(filePath?: string): string | null {
   return normalized.slice(0, idx);
 }
 
+function textToolResult(text: string): AgentToolResult<Record<string, never>> {
+  return { content: [{ type: 'text', text }], details: {} };
+}
+
+function getProtectedPaths(toolName: string, args: Record<string, unknown>): string[] {
+  const pathsToCheck: string[] = [];
+  if (toolName === 'batch_create_files' && Array.isArray((args as any).files)) {
+    (args as any).files.forEach((f: any) => { if (f.path) pathsToCheck.push(f.path); });
+  } else {
+    const singlePath = (args as any).path ?? (args as any).from_path;
+    if (typeof singlePath === 'string') pathsToCheck.push(singlePath);
+  }
+  return pathsToCheck;
+}
+
+function toPiCustomToolDefinitions(tools: AgentTool<any>[]): ToolDefinition[] {
+  return tools.map((tool) => ({
+    name: tool.name,
+    label: tool.label,
+    description: tool.description,
+    parameters: tool.parameters as any,
+    execute: async (toolCallId, params, signal, onUpdate) => {
+      const args = (params ?? {}) as Record<string, unknown>;
+
+      if (WRITE_TOOLS.has(tool.name)) {
+        for (const filePath of getProtectedPaths(tool.name, args)) {
+          try {
+            assertNotProtected(filePath, 'modified by AI agent');
+          } catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            return textToolResult(`Write-protection error: ${errorMsg}. You CANNOT modify ${filePath} because it is system-protected. Please tell the user you don't have permission to do this.`);
+          }
+        }
+      }
+
+      const result = await tool.execute(toolCallId, params, signal, onUpdate as any);
+      const outputText = result?.content
+        ?.filter((p: any) => p.type === 'text')
+        .map((p: any) => p.text)
+        .join('') ?? '';
+
+      try {
+        logAgentOp({
+          ts: new Date().toISOString(),
+          tool: tool.name,
+          params: args,
+          result: outputText.startsWith('Error:') ? 'error' : 'ok',
+          message: outputText.slice(0, 200),
+        });
+      } catch {
+        // logging must never kill the stream
+      }
+
+      return result;
+    },
+  }));
+}
+
 // ---------------------------------------------------------------------------
 // POST /api/ask
 // ---------------------------------------------------------------------------
@@ -328,91 +394,61 @@ export async function POST(req: NextRequest) {
     const historyMessages = agentMessages.slice(0, -1);
 
     // Capture API key for this request — safe since each POST creates a new Agent instance.
-    // Even though JS closures are lexically scoped, being explicit guards against future refactors.
     const requestApiKey = apiKey;
+    const projectRoot = process.env.MINDOS_PROJECT_ROOT || path.resolve(process.cwd(), '..');
+    const requestTools = await getRequestScopedTools();
+    const customTools = toPiCustomToolDefinitions(requestTools);
+
+    const authStorage = AuthStorage.create();
+    authStorage.setRuntimeApiKey(provider, requestApiKey);
+    const modelRegistry = new ModelRegistry(authStorage);
+    const settingsManager = SettingsManager.inMemory({
+      enableSkillCommands: true,
+      ...(enableThinking && provider === 'anthropic' ? { thinkingBudgets: { medium: thinkingBudget } } : {}),
+      ...(contextStrategy === 'off' ? { compaction: { enabled: false } } : {}),
+    });
 
-    // ── Loop detection state ──
-    const stepHistory: Array<{ tool: string; input: string }> = [];
-    let stepCount = 0;
-    let loopCooldown = 0;
-
-    // ── Create Agent (per-request lifecycle) ──
-    const agent = new Agent({
-      initialState: {
-        systemPrompt,
-        model,
-        thinkingLevel: (enableThinking && provider === 'anthropic') ? 'medium' : 'off',
-        tools: knowledgeBaseTools,
-        messages: historyMessages,
-      },
-      getApiKey: async () => requestApiKey,
-      toolExecution: 'parallel',
-
-      // Context management: truncate → compact → prune
-      transformContext: createTransformContext(
-        systemPrompt,
-        modelName,
-        () => model,
-        apiKey,
-        contextStrategy,
-      ),
-
-      // Write-protection: block writes to protected files gracefully
-      beforeToolCall: async (context: BeforeToolCallContext): Promise<BeforeToolCallResult | undefined> => {
-        const { toolCall, args } = context;
-        // toolCall is an object with type "toolCall" and contains the tool name and ID
-        const toolName = (toolCall as any).toolName ?? (toolCall as any).name;
-        if (toolName && WRITE_TOOLS.has(toolName)) {
-          // Special handling for batch creations where we need to check multiple files
-          const pathsToCheck: string[] = [];
-          if (toolName === 'batch_create_files' && Array.isArray((args as any).files)) {
-            (args as any).files.forEach((f: any) => { if (f.path) pathsToCheck.push(f.path); });
-          } else {
-            const singlePath = (args as any).path ?? (args as any).from_path;
-            if (singlePath) pathsToCheck.push(singlePath);
-          }
+    const resourceLoader = new DefaultResourceLoader({
+      cwd: projectRoot,
+      settingsManager,
+      systemPromptOverride: () => systemPrompt,
+      appendSystemPromptOverride: () => [],
+      additionalSkillPaths: [
+        path.join(projectRoot, 'app', 'data', 'skills'),
+        path.join(projectRoot, 'skills'),
+        path.join(getMindRoot(), '.skills'),
+      ],
+      additionalExtensionPaths: scanExtensionPaths(),
+    });
+    await resourceLoader.reload();
+
+    const { session } = await createAgentSession({
+      cwd: projectRoot,
+      model,
+      thinkingLevel: (enableThinking && provider === 'anthropic') ? 'medium' : 'off',
+      authStorage,
+      modelRegistry,
+      resourceLoader,
+      sessionManager: SessionManager.inMemory(),
+      settingsManager,
+      tools: [],
+      customTools,
+    });
 
-          for (const filePath of pathsToCheck) {
-            try {
-              assertNotProtected(filePath, 'modified by AI agent');
-            } catch (e) {
-              const errorMsg = e instanceof Error ? e.message : String(e);
-              return {
-                block: true,
-                reason: `Write-protection error: ${errorMsg}. You CANNOT modify ${filePath} because it is system-protected. Please tell the user you don't have permission to do this.`,
-              };
-            }
-          }
+    const llmHistoryMessages = convertToLlm(historyMessages);
+    await session.newSession({
+      setup: async (sessionManager) => {
+        for (const message of llmHistoryMessages) {
+          sessionManager.appendMessage(message);
         }
-        return undefined;
-      },
-
-      // Logging: record all tool executions
-      afterToolCall: async (context: AfterToolCallContext): Promise<AfterToolCallResult | undefined> => {
-        const ts = new Date().toISOString();
-        const { toolCall, args, result, isError } = context;
-        const toolName = (toolCall as any).toolName ?? (toolCall as any).name;
-        const outputText = result?.content
-          ?.filter((p: any) => p.type === 'text')
-          .map((p: any) => p.text)
-          .join('') ?? '';
-        try {
-          logAgentOp({
-            ts,
-            tool: toolName ?? 'unknown',
-            params: args as Record<string, unknown>,
-            result: isError ? 'error' : 'ok',
-            message: outputText.slice(0, 200),
-          });
-        } catch { /* logging must never kill the stream */ }
-        return undefined;
       },
-
-      ...(enableThinking && provider === 'anthropic' ? {
-        thinkingBudgets: { medium: thinkingBudget },
-      } : {}),
     });
 
+    // ── Loop detection state ──
+    const stepHistory: Array<{ tool: string; input: string }> = [];
+    let stepCount = 0;
+    let loopCooldown = 0;
+
     // ── SSE Stream ──
     const encoder = new TextEncoder();
     const requestStartTime = Date.now();
@@ -424,7 +460,7 @@ export async function POST(req: NextRequest) {
           } catch { /* controller may be closed */ }
         }
 
-        agent.subscribe((event: AgentEvent) => {
+        session.subscribe((event: AgentEvent) => {
           if (isTextDeltaEvent(event)) {
             send({ type: 'text_delta', delta: getTextDelta(event) });
           } else if (isThinkingDeltaEvent(event)) {
@@ -476,24 +512,20 @@ export async function POST(req: NextRequest) {
               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 })
-                agent.steer({
-                  role: 'user',
-                  content: '[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.',
-                  timestamp: Date.now(),
-                } as any);
+                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.');
               }
             }
 
             // Step limit enforcement
             if (stepCount >= stepLimit) {
-              agent.abort();
+              void session.abort();
             }
 
             console.log(`[ask] Step ${stepCount}/${stepLimit}`);
           }
         });
 
-        agent.prompt(lastUserContent).then(() => {
+        session.prompt(lastUserContent).then(() => {
           metrics.recordRequest(Date.now() - requestStartTime);
           send({ type: 'done' });
           controller.close();

package/app/app/api/mcp/agents/route.ts

@@ -1,4 +1,7 @@
 export const dynamic = 'force-dynamic';
+import os from 'os';
+import fs from 'fs';
+import path from 'path';
 import { NextResponse } from 'next/server';
 import {
   MCP_AGENTS,
@@ -9,6 +12,50 @@ import {
   detectAgentInstalledSkills,
   resolveSkillWorkspaceProfile,
 } from '@/lib/mcp-agents';
+import { readSettings } from '@/lib/settings';
+import { scanSkillDirs } from '@/lib/pi-integration/skills';
+import { getMindRoot } from '@/lib/fs';
+
+function enrichMindOsAgent(agent: Record<string, unknown>) {
+  agent.present = true;
+  agent.installed = true;
+  agent.scope = 'builtin';
+
+  try {
+    const settings = readSettings();
+    const port = Number(process.env.MINDOS_MCP_PORT) || settings.mcpPort || 8781;
+    agent.transport = `http :${port}`;
+  } catch {
+    agent.transport = 'http :8781';
+  }
+
+  try {
+    const projectRoot = process.env.MINDOS_PROJECT_ROOT || path.resolve(process.cwd(), '..');
+    const skills = scanSkillDirs({ projectRoot, mindRoot: getMindRoot() });
+    const enabledSkills = skills.filter(s => s.enabled);
+    agent.installedSkillNames = enabledSkills.map(s => s.name);
+    agent.installedSkillCount = enabledSkills.length;
+    agent.installedSkillSourcePath = path.join(projectRoot, 'skills');
+    agent.skillMode = 'universal';
+    agent.skillWorkspacePath = path.join(os.homedir(), '.agents', 'skills');
+  } catch { /* skill scan unavailable */ }
+
+  const mcpConfigPath = path.join(os.homedir(), '.mindos', 'mcp.json');
+  try {
+    if (fs.existsSync(mcpConfigPath)) {
+      const raw = JSON.parse(fs.readFileSync(mcpConfigPath, 'utf-8'));
+      const servers = Object.keys(raw.mcpServers ?? {});
+      agent.configuredMcpServers = servers;
+      agent.configuredMcpServerCount = servers.length;
+      agent.configuredMcpSources = servers.length > 0 ? [`local:${mcpConfigPath}`] : [];
+    }
+  } catch { /* ignore */ }
+
+  agent.runtimeConversationSignal = true;
+  agent.runtimeLastActivityAt = new Date().toISOString();
+  agent.hiddenRootPath = path.join(os.homedir(), '.mindos');
+  agent.hiddenRootPresent = true;
+}
 
 export async function GET() {
   try {
@@ -30,7 +77,6 @@ export async function GET() {
         hasProjectScope: !!agent.project,
         hasGlobalScope: !!agent.global,
         preferredTransport: agent.preferredTransport,
-        // Snippet generation fields
         format: agent.format ?? 'json',
         configKey: agent.key,
         globalNestedKey: agent.globalNestedKey,
@@ -53,8 +99,13 @@ export async function GET() {
       };
     });
 
-    // Sort: installed first, then detected, then not found
+    const mindos = agents.find(a => a.key === 'mindos');
+    if (mindos) enrichMindOsAgent(mindos as unknown as Record<string, unknown>);
+
+    // Sort: mindos first, then installed, then detected, then not found
     agents.sort((a, b) => {
+      if (a.key === 'mindos') return -1;
+      if (b.key === 'mindos') return 1;
       const rank = (x: typeof a) => x.installed ? 0 : x.present ? 1 : 2;
       return rank(a) - rank(b);
     });

package/app/app/api/mcp/status/route.ts

@@ -50,7 +50,7 @@ export async function GET(req: NextRequest) {
       transport: 'http',
       endpoint,
       port,
-      toolCount: running ? 23 : 0,
+      toolCount: running ? 24 : 0,
       authConfigured,
       // Masked for display; full token only used server-side in snippet generation
       maskedToken: authConfigured ? maskToken(token) : undefined,

package/app/app/api/skills/route.ts

@@ -4,6 +4,7 @@ import fs from 'fs';
 import path from 'path';
 import os from 'os';
 import { readSettings, writeSettings } from '@/lib/settings';
+import { parseSkillMd, readSkillContentByName, scanSkillDirs } from '@/lib/pi-integration/skills';
 
 const PROJECT_ROOT = process.env.MINDOS_PROJECT_ROOT || path.resolve(process.cwd(), '..');
 
@@ -12,113 +13,15 @@ function getMindRoot(): string {
   return s.mindRoot || process.env.MIND_ROOT || path.join(os.homedir(), 'MindOS', 'mind');
 }
 
-interface SkillInfo {
-  name: string;
-  description: string;
-  path: string;
-  source: 'builtin' | 'user';
-  enabled: boolean;
-  editable: boolean;
-}
-
-function parseSkillMd(content: string): { name: string; description: string } {
-  const match = content.match(/^---\n([\s\S]*?)\n---/);
-  if (!match) return { name: '', description: '' };
-  const yaml = match[1];
-  const nameMatch = yaml.match(/^name:\s*(.+)/m);
-  const descMatch = yaml.match(/^description:\s*>?\s*\n?([\s\S]*?)(?=\n\w|\n---)/m);
-  const name = nameMatch ? nameMatch[1].trim() : '';
-  let description = '';
-  if (descMatch) {
-    description = descMatch[1].trim().split('\n').map(l => l.trim()).join(' ').slice(0, 200);
-  } else {
-    const simpleDesc = yaml.match(/^description:\s*(.+)/m);
-    if (simpleDesc) description = simpleDesc[1].trim().slice(0, 200);
-  }
-  return { name, description };
-}
-
-function scanSkillDirs(disabledSkills: string[]): SkillInfo[] {
-  const skills: SkillInfo[] = [];
-  const seen = new Set<string>();
-
-  // 1. app/data/skills/ — builtin
-  const builtinDir = path.join(PROJECT_ROOT, 'app', 'data', 'skills');
-  if (fs.existsSync(builtinDir)) {
-    for (const entry of fs.readdirSync(builtinDir, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue;
-      const skillFile = path.join(builtinDir, entry.name, 'SKILL.md');
-      if (!fs.existsSync(skillFile)) continue;
-      const content = fs.readFileSync(skillFile, 'utf-8');
-      const { name, description } = parseSkillMd(content);
-      const skillName = name || entry.name;
-      seen.add(skillName);
-      skills.push({
-        name: skillName,
-        description,
-        path: `app/data/skills/${entry.name}/SKILL.md`,
-        source: 'builtin',
-        enabled: !disabledSkills.includes(skillName),
-        editable: false,
-      });
-    }
-  }
-
-  // 2. skills/ — project root builtin
-  const skillsDir = path.join(PROJECT_ROOT, 'skills');
-  if (fs.existsSync(skillsDir)) {
-    for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue;
-      const skillFile = path.join(skillsDir, entry.name, 'SKILL.md');
-      if (!fs.existsSync(skillFile)) continue;
-      const content = fs.readFileSync(skillFile, 'utf-8');
-      const { name, description } = parseSkillMd(content);
-      const skillName = name || entry.name;
-      if (seen.has(skillName)) continue; // already listed from app/data/skills/
-      seen.add(skillName);
-      skills.push({
-        name: skillName,
-        description,
-        path: `skills/${entry.name}/SKILL.md`,
-        source: 'builtin',
-        enabled: !disabledSkills.includes(skillName),
-        editable: false,
-      });
-    }
-  }
-
-  // 3. {mindRoot}/.skills/ — user custom
-  const mindRoot = getMindRoot();
-  const userSkillsDir = path.join(mindRoot, '.skills');
-  if (fs.existsSync(userSkillsDir)) {
-    for (const entry of fs.readdirSync(userSkillsDir, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue;
-      const skillFile = path.join(userSkillsDir, entry.name, 'SKILL.md');
-      if (!fs.existsSync(skillFile)) continue;
-      const content = fs.readFileSync(skillFile, 'utf-8');
-      const { name, description } = parseSkillMd(content);
-      const skillName = name || entry.name;
-      if (seen.has(skillName)) continue;
-      seen.add(skillName);
-      skills.push({
-        name: skillName,
-        description,
-        path: `{mindRoot}/.skills/${entry.name}/SKILL.md`,
-        source: 'user',
-        enabled: !disabledSkills.includes(skillName),
-        editable: true,
-      });
-    }
-  }
-
-  return skills;
-}
-
 export async function GET() {
   try {
     const settings = readSettings();
     const disabledSkills = settings.disabledSkills ?? [];
-    const skills = scanSkillDirs(disabledSkills);
+    const skills = scanSkillDirs({
+      projectRoot: PROJECT_ROOT,
+      mindRoot: getMindRoot(),
+      disabledSkills,
+    });
     return NextResponse.json({ skills });
   } catch (err) {
     return NextResponse.json({ error: String(err) }, { status: 500 });
@@ -205,18 +108,11 @@ export async function POST(req: NextRequest) {
 
       case 'read': {
         if (!name) return NextResponse.json({ error: 'name required' }, { status: 400 });
-        const dirs = [
-          path.join(PROJECT_ROOT, 'app', 'data', 'skills', name),
-          path.join(PROJECT_ROOT, 'skills', name),
-          path.join(userSkillsDir, name),
-        ];
-        for (const dir of dirs) {
-          const file = path.join(dir, 'SKILL.md');
-          if (fs.existsSync(file)) {
-            return NextResponse.json({ content: fs.readFileSync(file, 'utf-8') });
-          }
+        const content = readSkillContentByName(name, { projectRoot: PROJECT_ROOT, mindRoot });
+        if (!content) {
+          return NextResponse.json({ error: 'Skill not found' }, { status: 404 });
         }
-        return NextResponse.json({ error: 'Skill not found' }, { status: 404 });
+        return NextResponse.json({ content });
       }
 
       case 'read-native': {

package/app/components/ActivityBar.tsx

@@ -162,7 +162,6 @@ export default function ActivityBar({
       role="toolbar"
       aria-label="Navigation"
       aria-orientation="vertical"
-      data-walkthrough="activity-bar"
     >
       {/* Content wrapper — overflow-hidden prevents text flash during width transitions */}
       <div className="flex flex-col h-full w-full overflow-hidden">
@@ -181,14 +180,15 @@ export default function ActivityBar({
         {/* ── Middle: Core panel toggles ── */}
         <div className={`flex flex-col ${expanded ? 'px-1.5' : 'items-center'} gap-1 py-2`}>
           <RailButton icon={<FolderTree size={18} />} label={t.sidebar.files} active={activePanel === 'files'} expanded={expanded} onClick={() => toggle('files')} walkthroughId="files-panel" />
-          <RailButton icon={<Search size={18} />} label={t.sidebar.searchTitle} shortcut="⌘K" active={activePanel === 'search'} expanded={expanded} onClick={() => toggle('search')} walkthroughId="search-button" />
-          <RailButton icon={<Radio size={18} />} label={t.sidebar.echo} active={activePanel === 'echo'} expanded={expanded} onClick={() => toggle('echo')} />
+          <RailButton icon={<Search size={18} />} label={t.sidebar.searchTitle} shortcut="⌘K" active={activePanel === 'search'} expanded={expanded} onClick={() => toggle('search')} />
+          <RailButton icon={<Radio size={18} />} label={t.sidebar.echo} active={activePanel === 'echo'} expanded={expanded} onClick={() => toggle('echo')} walkthroughId="echo-panel" />
           <RailButton
             icon={<Bot size={18} />}
             label={t.sidebar.agents}
             active={activePanel === 'agents'}
             expanded={expanded}
             onClick={() => onAgentsClick ? debounced(onAgentsClick) : toggle('agents')}
+            walkthroughId="agents-panel"
           />
           <RailButton icon={<Compass size={18} />} label={t.sidebar.discover} active={activePanel === 'discover'} expanded={expanded} onClick={() => toggle('discover')} />
         </div>
@@ -211,7 +211,6 @@ export default function ActivityBar({
             shortcut="⌘,"
             expanded={expanded}
             onClick={() => debounced(onSettingsClick)}
-            walkthroughId="settings-button"
             badge={hasUpdate ? (
               <span className={`absolute ${expanded ? 'left-[26px] top-1.5' : 'top-1.5 right-1.5'} w-2 h-2 rounded-full bg-error`} />
             ) : undefined}

package/app/components/CreateSpaceModal.tsx

@@ -93,17 +93,42 @@ export default function CreateSpaceModal({ t, dirPaths }: { t: ReturnType<typeof
       if (useAi && aiAvailable) {
         const isZh = document.documentElement.lang === 'zh';
         const prompt = isZh
-          ? `初始化新建的心智空间「${trimmed}」，路径为「${createdPath}/」。${description ? `描述：「${description}」。` : ''}请根据空间名称生成有意义的内容：\n1. README.md — 空间用途、结构概览、使用指南\n2. INSTRUCTION.md — AI Agent 在此空间的行为规则\n\n使用可用工具直接写入文件，内容简洁实用。`
-          : `Initialize this new Mind Space "${trimmed}" at "${createdPath}/". ${description ? `Description: "${description}". ` : ''}Generate meaningful content for:\n1. README.md — purpose, structure overview, usage guidelines\n2. INSTRUCTION.md — rules for AI agents operating in this space\n\nWrite directly to the files using available tools. Keep content concise and actionable.`;
-        // Fire and forget — don't block navigation
-        apiFetch('/api/ask', {
+          ? `初始化新建的心智空间「${trimmed}」，路径为「${createdPath}/」。${description ? `描述：「${description}」。` : ''}两个文件均已存在模板，用 write_file 覆盖：\n1. 「${createdPath}/README.md」— 写入空间用途、结构概览、使用指南\n2. 「${createdPath}/INSTRUCTION.md」— 写入 AI Agent 在此空间中的行为规则和操作约定\n\n内容简洁实用，直接使用工具写入。`
+          : `Initialize the new Mind Space "${trimmed}" at "${createdPath}/". ${description ? `Description: "${description}". ` : ''}Both files already exist with templates — use write_file to overwrite:\n1. "${createdPath}/README.md" — write purpose, structure overview, usage guidelines\n2. "${createdPath}/INSTRUCTION.md" — write rules for AI agents operating in this space\n\nKeep content concise and actionable. Write files directly using tools.`;
+
+        window.dispatchEvent(new CustomEvent('mindos:ai-init', {
+          detail: { spaceName: trimmed, spacePath: createdPath, description, state: 'working' },
+        }));
+
+        // /api/ask returns SSE — use raw fetch and consume the stream
+        // so the server-side agent runs to completion.
+        fetch('/api/ask', {
           method: 'POST',
           headers: { 'Content-Type': 'application/json' },
           body: JSON.stringify({
             messages: [{ role: 'user', content: prompt }],
-            targetDir: createdPath,
+            currentFile: createdPath + '/INSTRUCTION.md',
           }),
-        }).catch(() => { /* AI init is best-effort */ });
+        }).then(async (res) => {
+          if (!res.ok || !res.body) throw new Error(`HTTP ${res.status}`);
+          const reader = res.body.getReader();
+          try {
+            while (true) {
+              const { done } = await reader.read();
+              if (done) break;
+            }
+          } finally {
+            reader.releaseLock();
+          }
+          window.dispatchEvent(new CustomEvent('mindos:ai-init', {
+            detail: { spacePath: createdPath, state: 'done' },
+          }));
+          window.dispatchEvent(new Event('mindos:files-changed'));
+        }).catch(() => {
+          window.dispatchEvent(new CustomEvent('mindos:ai-init', {
+            detail: { spacePath: createdPath, state: 'error' },
+          }));
+        });
       }
 
       close();

package/app/components/FileTree.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useState, useCallback, useRef, useTransition, useEffect } from 'react';
+import { useState, useCallback, useRef, useTransition, useEffect, useSyncExternalStore } from 'react';
 import { useRouter, usePathname } from 'next/navigation';
 import { FileNode } from '@/lib/types';
 import { encodePath } from '@/lib/utils';
@@ -17,6 +17,33 @@ function notifyFilesChanged() {
 
 const SYSTEM_FILES = new Set(['INSTRUCTION.md', 'README.md']);
 
+const HIDDEN_FILES_KEY = 'show-hidden-files';
+
+function subscribeHiddenFiles(cb: () => void) {
+  const handler = (e: StorageEvent) => { if (e.key === HIDDEN_FILES_KEY) cb(); };
+  const custom = () => cb();
+  window.addEventListener('storage', handler);
+  window.addEventListener('mindos:hidden-files-changed', custom);
+  return () => {
+    window.removeEventListener('storage', handler);
+    window.removeEventListener('mindos:hidden-files-changed', custom);
+  };
+}
+
+function getShowHiddenFiles() {
+  if (typeof window === 'undefined') return false;
+  return localStorage.getItem(HIDDEN_FILES_KEY) === 'true';
+}
+
+export function setShowHiddenFiles(value: boolean) {
+  localStorage.setItem(HIDDEN_FILES_KEY, String(value));
+  window.dispatchEvent(new Event('mindos:hidden-files-changed'));
+}
+
+function useShowHiddenFiles() {
+  return useSyncExternalStore(subscribeHiddenFiles, getShowHiddenFiles, () => false);
+}
+
 interface FileTreeProps {
   nodes: FileNode[];
   depth?: number;
@@ -618,9 +645,13 @@ function FileNodeItem({ node, depth, currentPath, onNavigate }: {
 export default function FileTree({ nodes, depth = 0, onNavigate, maxOpenDepth, parentIsSpace, onImport }: FileTreeProps) {
   const pathname = usePathname();
   const currentPath = getCurrentFilePath(pathname);
+  const showHidden = useShowHiddenFiles();
 
   const isInsideDir = depth > 0;
-  const visibleNodes = isInsideDir ? filterVisibleNodes(nodes, !!parentIsSpace) : nodes;
+  let visibleNodes = isInsideDir ? filterVisibleNodes(nodes, !!parentIsSpace) : nodes;
+  if (!isInsideDir && !showHidden) {
+    visibleNodes = visibleNodes.filter(n => !n.name.startsWith('.'));
+  }
 
   useEffect(() => {
     if (!currentPath || depth !== 0) return;