@geminilight/mindos 0.6.28 → 0.6.29

package/app/lib/acp/subprocess.ts

@@ -0,0 +1,209 @@
+/**
+ * ACP Subprocess Manager — Spawn and communicate with ACP agent processes.
+ * ACP agents communicate via JSON-RPC 2.0 over stdio (stdin/stdout).
+ */
+
+import { spawn, type ChildProcess } from 'child_process';
+import type {
+  AcpJsonRpcRequest,
+  AcpJsonRpcResponse,
+  AcpRegistryEntry,
+  AcpTransportType,
+} from './types';
+
+/* ── Types ─────────────────────────────────────────────────────────────── */
+
+export interface AcpProcess {
+  id: string;
+  agentId: string;
+  proc: ChildProcess;
+  alive: boolean;
+}
+
+type MessageCallback = (msg: AcpJsonRpcResponse) => void;
+
+/* ── State ─────────────────────────────────────────────────────────────── */
+
+const processes = new Map<string, AcpProcess>();
+const messageListeners = new Map<string, Set<MessageCallback>>();
+let rpcIdCounter = 1;
+
+/* ── Public API ────────────────────────────────────────────────────────── */
+
+/**
+ * Spawn an ACP agent subprocess.
+ */
+export function spawnAcpAgent(
+  entry: AcpRegistryEntry,
+  options?: { env?: Record<string, string> },
+): AcpProcess {
+  const { cmd, args } = buildCommand(entry);
+
+  const mergedEnv = {
+    ...process.env,
+    ...(entry.env ?? {}),
+    ...(options?.env ?? {}),
+  };
+
+  const proc = spawn(cmd, args, {
+    stdio: ['pipe', 'pipe', 'pipe'],
+    env: mergedEnv,
+    shell: false,
+  });
+
+  const id = `acp-${entry.id}-${Date.now()}`;
+  const acpProc: AcpProcess = { id, agentId: entry.id, proc, alive: true };
+
+  processes.set(id, acpProc);
+  messageListeners.set(id, new Set());
+
+  // Parse newline-delimited JSON from stdout
+  let buffer = '';
+  proc.stdout?.on('data', (chunk: Buffer) => {
+    buffer += chunk.toString();
+    const lines = buffer.split('\n');
+    buffer = lines.pop() ?? '';
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        const msg = JSON.parse(trimmed) as AcpJsonRpcResponse;
+        const listeners = messageListeners.get(id);
+        if (listeners) {
+          for (const cb of listeners) cb(msg);
+        }
+      } catch {
+        // Not valid JSON — skip (could be agent debug output)
+      }
+    }
+  });
+
+  proc.on('close', () => {
+    acpProc.alive = false;
+    messageListeners.delete(id);
+  });
+
+  proc.on('error', () => {
+    acpProc.alive = false;
+  });
+
+  return acpProc;
+}
+
+/**
+ * Send a JSON-RPC message to an ACP agent's stdin.
+ */
+export function sendMessage(acpProc: AcpProcess, method: string, params?: Record<string, unknown>): string {
+  if (!acpProc.alive || !acpProc.proc.stdin?.writable) {
+    throw new Error(`ACP process ${acpProc.id} is not alive`);
+  }
+
+  const id = `rpc-${rpcIdCounter++}`;
+  const request: AcpJsonRpcRequest = {
+    jsonrpc: '2.0',
+    id,
+    method,
+    ...(params ? { params } : {}),
+  };
+
+  acpProc.proc.stdin.write(JSON.stringify(request) + '\n');
+  return id;
+}
+
+/**
+ * Register a callback for messages from an ACP agent.
+ * Returns an unsubscribe function.
+ */
+export function onMessage(acpProc: AcpProcess, callback: MessageCallback): () => void {
+  const listeners = messageListeners.get(acpProc.id);
+  if (!listeners) throw new Error(`ACP process ${acpProc.id} not found`);
+
+  listeners.add(callback);
+  return () => { listeners.delete(callback); };
+}
+
+/**
+ * Send a JSON-RPC request and wait for a response with the matching ID.
+ */
+export function sendAndWait(
+  acpProc: AcpProcess,
+  method: string,
+  params?: Record<string, unknown>,
+  timeoutMs = 30_000,
+): Promise<AcpJsonRpcResponse> {
+  return new Promise((resolve, reject) => {
+    const rpcId = sendMessage(acpProc, method, params);
+
+    const timer = setTimeout(() => {
+      unsub();
+      reject(new Error(`ACP RPC timeout after ${timeoutMs}ms for method: ${method}`));
+    }, timeoutMs);
+
+    const unsub = onMessage(acpProc, (msg) => {
+      if (String(msg.id) === rpcId) {
+        clearTimeout(timer);
+        unsub();
+        resolve(msg);
+      }
+    });
+  });
+}
+
+/**
+ * Kill an ACP agent process.
+ */
+export function killAgent(acpProc: AcpProcess): void {
+  if (acpProc.alive && acpProc.proc.pid) {
+    acpProc.proc.kill('SIGTERM');
+    // Force kill after 5s if still alive
+    setTimeout(() => {
+      if (acpProc.alive) {
+        acpProc.proc.kill('SIGKILL');
+      }
+    }, 5000);
+  }
+  acpProc.alive = false;
+  processes.delete(acpProc.id);
+  messageListeners.delete(acpProc.id);
+}
+
+/**
+ * Get a process by its ID.
+ */
+export function getProcess(id: string): AcpProcess | undefined {
+  return processes.get(id);
+}
+
+/**
+ * Get all active processes.
+ */
+export function getActiveProcesses(): AcpProcess[] {
+  return [...processes.values()].filter(p => p.alive);
+}
+
+/**
+ * Kill all active ACP processes. Used for cleanup.
+ */
+export function killAllAgents(): void {
+  for (const proc of processes.values()) {
+    killAgent(proc);
+  }
+}
+
+/* ── Internal ──────────────────────────────────────────────────────────── */
+
+function buildCommand(entry: AcpRegistryEntry): { cmd: string; args: string[] } {
+  const transport: AcpTransportType = entry.transport;
+
+  switch (transport) {
+    case 'npx':
+      return { cmd: 'npx', args: [entry.command, ...(entry.args ?? [])] };
+    case 'uvx':
+      return { cmd: 'uvx', args: [entry.command, ...(entry.args ?? [])] };
+    case 'binary':
+    case 'stdio':
+    default:
+      return { cmd: entry.command, args: entry.args ?? [] };
+  }
+}

package/app/lib/acp/types.ts

@@ -0,0 +1,136 @@
+/**
+ * ACP (Agent Client Protocol) — Core Types for MindOS ACP integration.
+ * ACP uses JSON-RPC 2.0 over stdio (subprocess model), not HTTP.
+ * Sessions are stateful with prompt turns, tool calls, and streaming updates.
+ * Reference: https://agentclientprotocol.com
+ */
+
+/* ── Transport ────────────────────────────────────────────────────────── */
+
+/** How an ACP agent is spawned */
+export type AcpTransportType = 'stdio' | 'npx' | 'uvx' | 'binary';
+
+/* ── Capabilities ─────────────────────────────────────────────────────── */
+
+/** What MindOS exposes as an ACP agent */
+export interface AcpCapabilities {
+  streaming: boolean;
+  toolCalls: boolean;
+  multiTurn: boolean;
+  cancellation: boolean;
+}
+
+/* ── Session ──────────────────────────────────────────────────────────── */
+
+export type AcpSessionState = 'idle' | 'active' | 'error';
+
+export interface AcpSession {
+  id: string;
+  agentId: string;
+  state: AcpSessionState;
+  createdAt: string;
+  lastActivityAt: 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;
+  text: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface AcpPromptResponse {
+  sessionId: string;
+  text: string;
+  done: boolean;
+  toolCalls?: AcpToolCall[];
+  metadata?: Record<string, unknown>;
+}
+
+/* ── Session Updates (streaming) ──────────────────────────────────────── */
+
+export type AcpUpdateType = 'text' | 'tool_call' | 'tool_result' | 'done' | 'error';
+
+export interface AcpSessionUpdate {
+  sessionId: string;
+  type: AcpUpdateType;
+  text?: string;
+  toolCall?: AcpToolCall;
+  toolResult?: AcpToolResult;
+  error?: string;
+}
+
+/* ── Tool Calls ───────────────────────────────────────────────────────── */
+
+export interface AcpToolCall {
+  id: string;
+  name: string;
+  arguments: Record<string, unknown>;
+}
+
+export interface AcpToolResult {
+  callId: string;
+  result: string;
+  isError?: boolean;
+}
+
+/* ── Registry ─────────────────────────────────────────────────────────── */
+
+/** An entry from the ACP registry (registry.json) */
+export interface AcpRegistryEntry {
+  id: string;
+  name: string;
+  description: string;
+  version?: string;
+  transport: AcpTransportType;
+  command: string;
+  args?: string[];
+  env?: Record<string, string>;
+  tags?: string[];
+  homepage?: string;
+}
+
+/** Parsed registry response */
+export interface AcpRegistry {
+  version: string;
+  agents: AcpRegistryEntry[];
+  fetchedAt: string;
+}
+
+/* ── Error Codes ──────────────────────────────────────────────────────── */
+
+export const ACP_ERRORS = {
+  SESSION_NOT_FOUND: { code: -32001, message: 'Session not found' },
+  SESSION_BUSY: { code: -32002, message: 'Session is busy' },
+  AGENT_NOT_FOUND: { code: -32003, message: 'Agent not found in registry' },
+  SPAWN_FAILED: { code: -32004, message: 'Failed to spawn agent process' },
+  TRANSPORT_ERROR: { code: -32005, message: 'Transport error' },
+  PARSE_ERROR: { code: -32700, message: 'Parse error' },
+  INVALID_REQUEST: { code: -32600, message: 'Invalid request' },
+  METHOD_NOT_FOUND: { code: -32601, message: 'Method not found' },
+  INVALID_PARAMS: { code: -32602, message: 'Invalid params' },
+  INTERNAL_ERROR: { code: -32603, message: 'Internal error' },
+} as const;

package/app/lib/agent/tools.ts

@@ -10,6 +10,7 @@ import {
 import { readSkillContentByName, scanSkillDirs } from '@/lib/pi-integration/skills';
 import { callMcporterTool, createMcporterAgentTools, listMcporterServers, listMcporterTools } from '@/lib/pi-integration/mcporter';
 import { a2aTools } from '@/lib/a2a/a2a-tools';
+import { acpTools } from '@/lib/acp/acp-tools';
 
 // Max chars per file to avoid token overflow (~100k chars ≈ ~25k tokens)
 const MAX_FILE_CHARS = 20_000;
@@ -187,7 +188,7 @@ export function getOrganizeTools(): AgentTool<any>[] {
 }
 
 export async function getRequestScopedTools(): Promise<AgentTool<any>[]> {
-  const baseTools = [...knowledgeBaseTools, ...a2aTools];
+  const baseTools = [...knowledgeBaseTools, ...a2aTools, ...acpTools];
   try {
     const result = await listMcporterServers();
     const okServers = (result.servers ?? []).filter((server) => server.status === 'ok');

package/app/lib/i18n/_core.ts

@@ -0,0 +1,22 @@
+/**
+ * Recursively widen literal string types to `string` so zh values can differ from en.
+ *
+ * Without Widen<T>, TypeScript would require zh strings to be the *exact* literal values from en.
+ * E.g., if en has `common: { hello: "hello" as const }`, zh would be required to also have "hello".
+ *
+ * This type converts all string literals to generic `string`, allowing Chinese translations to use
+ * completely different values while maintaining structure compatibility.
+ *
+ * Example:
+ * ```
+ * en = { msg: "Hello" as const }                // string literal "Hello"
+ * zh_without = { msg: "你好" } satisfies typeof en  // ❌ ERROR: "你好" not assignable to "Hello"
+ * zh_with = { msg: "你好" } satisfies Widen<typeof en>  // ✅ OK: string satisfies string
+ * ```
+ */
+export type Widen<T> =
+  T extends string ? string :
+  T extends readonly (infer U)[] ? readonly Widen<U>[] :
+  T extends (...args: infer A) => infer R ? (...args: A) => Widen<R> :
+  T extends object ? { [K in keyof T]: Widen<T[K]> } :
+  T;

package/app/lib/i18n/index.ts

@@ -0,0 +1,35 @@
+import type { Widen } from './_core';
+import { commonEn, commonZh } from './modules/common';
+import { navigationEn, navigationZh } from './modules/navigation';
+import { aiChatEn, aiChatZh } from './modules/ai-chat';
+import { knowledgeEn, knowledgeZh } from './modules/knowledge';
+import { panelsEn, panelsZh } from './modules/panels';
+import { settingsEn, settingsZh } from './modules/settings';
+import { onboardingEn, onboardingZh } from './modules/onboarding';
+import { featuresEn, featuresZh } from './modules/features';
+
+export const en = {
+  ...commonEn,
+  ...navigationEn,
+  ...aiChatEn,
+  ...knowledgeEn,
+  ...panelsEn,
+  ...settingsEn,
+  ...onboardingEn,
+  ...featuresEn,
+} as const;
+
+export const zh: Widen<typeof en> = {
+  ...commonZh,
+  ...navigationZh,
+  ...aiChatZh,
+  ...knowledgeZh,
+  ...panelsZh,
+  ...settingsZh,
+  ...onboardingZh,
+  ...featuresZh,
+};
+
+export type Locale = 'en' | 'zh';
+export const messages = { en, zh } as const;
+export type Messages = typeof en;

package/app/lib/i18n/modules/ai-chat.ts

@@ -0,0 +1,215 @@
+// ask + changes + hints
+
+export const aiChatEn = {
+  ask: {
+    title: 'MindOS Agent',
+    fabLabel: 'Ask AI',
+    placeholder: 'Ask a question... @ files, / skills',
+    emptyPrompt: 'Ask anything about your knowledge base',
+    send: 'send',
+    newlineHint: 'new line',
+    panelComposerResize: 'Drag up to enlarge the input area',
+    panelComposerFooter: 'Resize height',
+    panelComposerResetHint: 'Double-click to reset height',
+    panelComposerKeyboard: 'Arrow keys adjust height; Home/End min/max',
+    attachFile: 'Context',
+    uploadedFiles: 'Uploaded',
+    skillsHint: 'skills',
+    attachCurrent: 'attach current file',
+    stopTitle: 'Stop',
+    cancelReconnect: 'Cancel reconnect',
+    connecting: 'Thinking with you...',
+    thinking: 'Thinking...',
+    thinkingLabel: 'Thinking',
+    searching: 'Searching knowledge base...',
+    generating: 'Generating response...',
+    stopped: 'Generation stopped.',
+    errorNoResponse: 'AI returned no content. Possible causes: model does not support streaming, proxy compatibility issue, or request exceeds context limit.',
+    reconnecting: (attempt: number, max: number) => `Connection lost. Reconnecting (${attempt}/${max})...`,
+    reconnectFailed: 'Connection failed after multiple attempts.',
+    retry: 'Retry',
+    suggestions: [
+      'Summarize this document',
+      'List all action items and TODOs',
+      'What are the key points?',
+      'Find related notes on this topic',
+    ],
+    sessionHistory: 'Session History',
+    clearAll: 'Clear all',
+    confirmClear: 'Confirm clear?',
+    noSessions: 'No saved sessions.',
+    draftingHint: 'AI is still running — you can draft the next step now.',
+  },
+  changes: {
+    unreadBanner: (n: number) => `${n} content change${n === 1 ? '' : 's'} unread`,
+    reviewNow: 'Review now',
+    dismiss: 'Dismiss notification',
+    title: 'Content changes',
+    subtitle: 'Review recent edits across user and agent operations.',
+    eventsCount: (n: number) => `${n} event${n === 1 ? '' : 's'}`,
+    unreadCount: (n: number) => `${n} unread`,
+    refresh: 'Refresh',
+    markSeen: 'Mark seen',
+    markAllRead: 'Mark all read',
+    filters: {
+      filePath: 'File path',
+      filePathPlaceholder: 'e.g. Projects/plan.md',
+      source: 'Agents (source)',
+      operation: 'Tools (operation)',
+      operationAll: 'All operations',
+      keyword: 'Keyword',
+      keywordPlaceholder: 'summary / op / path',
+      all: 'All',
+      agent: 'Agent',
+      user: 'User',
+      system: 'System',
+    },
+    loading: 'Loading changes...',
+    empty: 'No content changes yet.',
+    open: 'Open',
+    unchangedLines: (n: number) => `... ${n} unchanged lines ...`,
+    relativeTime: {
+      justNow: 'just now',
+      minutesAgo: (n: number) => `${n}m ago`,
+      hoursAgo: (n: number) => `${n}h ago`,
+      daysAgo: (n: number) => `${n}d ago`,
+    },
+  },
+  /** Disabled-state and contextual tooltip hints */
+  hints: {
+    noValidFiles: 'No valid files selected',
+    aiOrganizing: 'AI is organizing',
+    importInProgress: 'Import in progress',
+    templateInitializing: 'Another template is being initialized',
+    configureAiKey: 'Configure API key in Settings → AI',
+    syncInProgress: 'Sync already in progress',
+    toggleInProgress: 'Toggle operation in progress',
+    typeMessage: 'Type a message',
+    mentionInProgress: 'Mention or command in progress',
+    cleanupInProgress: 'Cleanup already in progress',
+    tokenResetInProgress: 'Token reset in progress',
+    aiNotConfigured: 'AI not configured or generation in progress',
+    generationInProgress: 'Generation in progress or AI not configured',
+    cannotJumpForward: 'Cannot jump forward in setup',
+    testInProgressOrNoKey: 'Test in progress or no API key',
+    workflowStepRunning: 'Workflow step already running',
+    workflowRunning: 'Workflow step is running',
+    sessionHistory: 'Session history',
+    newSession: 'New session',
+    attachFile: 'Attach local file',
+    maximizePanel: 'Maximize panel',
+    restorePanel: 'Restore panel',
+    dockToSide: 'Dock to side panel',
+    openAsPopup: 'Open as popup',
+    closePanel: 'Close',
+    newChat: 'New chat',
+    closeSession: 'Close session',
+  },
+} as const;
+
+export const aiChatZh = {
+  ask: {
+    title: 'MindOS Agent',
+    fabLabel: 'AI 助手',
+    placeholder: '输入问题… @ 附加文件，/ 技能',
+    emptyPrompt: '可以问任何关于知识库的问题',
+    send: '发送',
+    newlineHint: '换行',
+    panelComposerResize: '向上拖拽以拉高输入区',
+    panelComposerFooter: '拉高输入区',
+    panelComposerResetHint: '双击恢复默认高度',
+    panelComposerKeyboard: '方向键调节高度；Home/End 最小或最大',
+    attachFile: '上下文',
+    uploadedFiles: '已上传',
+    skillsHint: '技能',
+    attachCurrent: '附加当前文件',
+    stopTitle: '停止',
+    cancelReconnect: '取消重连',
+    connecting: '正在和你一起思考...',
+    thinking: '思考中...',
+    thinkingLabel: '思考中',
+    searching: '正在搜索知识库...',
+    generating: '正在生成回复...',
+    stopped: '已停止生成。',
+    errorNoResponse: 'AI 未返回有效内容。可能原因：模型不支持流式输出、中转站兼容性问题、或请求超出上下文限制。',
+    reconnecting: (attempt: number, max: number) => `连接中断，正在重连 (${attempt}/${max})...`,
+    reconnectFailed: '多次重连失败，请检查网络后重试。',
+    retry: '重试',
+    suggestions: [
+      '总结这篇文档',
+      '列出所有待办事项',
+      '这篇文档的核心要点是什么？',
+      '查找与这个主题相关的笔记',
+    ],
+    sessionHistory: '对话历史',
+    clearAll: '清除全部',
+    confirmClear: '确认清除？',
+    noSessions: '暂无历史对话。',
+    draftingHint: 'AI 仍在执行，你可以先输入下一步。',
+  },
+  changes: {
+    unreadBanner: (n: number) => `${n} 条内容变更未读`,
+    reviewNow: '立即查看',
+    dismiss: '关闭提醒',
+    title: '内容变更',
+    subtitle: '集中查看用户与 Agent 的最近编辑记录。',
+    eventsCount: (n: number) => `${n} 条事件`,
+    unreadCount: (n: number) => `${n} 条未读`,
+    refresh: '刷新',
+    markSeen: '标记已读',
+    markAllRead: '全部已读',
+    filters: {
+      filePath: '文件路径',
+      filePathPlaceholder: '例如：Projects/plan.md',
+      source: 'Agents（来源）',
+      operation: 'Tools（操作）',
+      operationAll: '全部操作',
+      keyword: '关键词',
+      keywordPlaceholder: '摘要 / 操作 / 路径',
+      all: '全部',
+      agent: 'Agent',
+      user: '用户',
+      system: '系统',
+    },
+    loading: '正在加载变更...',
+    empty: '暂无内容变更。',
+    open: '打开',
+    unchangedLines: (n: number) => `... ${n} 行未变更 ...`,
+    relativeTime: {
+      justNow: '刚刚',
+      minutesAgo: (n: number) => `${n} 分钟前`,
+      hoursAgo: (n: number) => `${n} 小时前`,
+      daysAgo: (n: number) => `${n} 天前`,
+    },
+  },
+  /** 禁用态和上下文提示文案 */
+  hints: {
+    noValidFiles: '未选择有效文件',
+    aiOrganizing: 'AI 正在整理中',
+    importInProgress: '正在导入',
+    templateInitializing: '正在初始化另一个模板',
+    configureAiKey: '请在 设置 → AI 中配置 API 密钥',
+    syncInProgress: '正在同步中',
+    toggleInProgress: '正在切换中',
+    typeMessage: '请输入消息',
+    mentionInProgress: '正在输入提及或命令',
+    cleanupInProgress: '正在清理中',
+    tokenResetInProgress: '正在重置令牌',
+    aiNotConfigured: 'AI 未配置或正在生成',
+    generationInProgress: '正在生成或 AI 未配置',
+    cannotJumpForward: '无法跳过前序步骤',
+    testInProgressOrNoKey: '正在测试或未配置 API 密钥',
+    workflowStepRunning: '工作流步骤正在运行',
+    workflowRunning: '工作流步骤正在运行',
+    sessionHistory: '会话历史',
+    newSession: '新会话',
+    attachFile: '附加本地文件',
+    maximizePanel: '最大化面板',
+    restorePanel: '还原面板',
+    dockToSide: '停靠到侧边栏',
+    openAsPopup: '弹窗模式',
+    closePanel: '关闭',
+    newChat: '新对话',
+    closeSession: '关闭会话',
+  },
+};