feat: 升级至 v0.3.7 — 前后端状态同步与错误处理全量修复

核心引擎修复:
- CE-1: 上下文压缩摘要 role 从 system 改为 user，避免被 adapter 过滤
- CE-2: 工具失败时优先使用 error 字段（engine/openai-format/ollama 三处）
- P0-1: DeadLoopError 终止时正确传 error 参数，前端可见 ERROR 事件
- MT-1: 新增 waitForAbort 方法，abortSession 等待 run 结束再返回
- MT-2: TERMINATED 状态到达时标记步骤完成，避免 Trace Viewer 转圈
- MT-3: 压缩边界检测孤立 tool 消息，避免 API 400 错误
- isRetryableError 与 catch 分支统一 toLowerCase

IPC 与主进程修复:
- P0-2: createAdapter 配置缺失返回 null，FALLBACK_ADAPTER 兜底
- P0-3: reloadAdapter 失败返回 success:false 通知前端
- P1-5: 校验失败发 ERROR+DONE 流事件，防止 isStreaming 卡死
- P1-6: configLoaded 标志，配置加载前禁用发送按钮
- P1-7: MCP initialize 移到 agentLoop 后，完成后同步工具
- P2-11: beforeLoad 在 loadURL 前注册 IPC handler
- P2-12: provider 切换竞态保护

前端状态同步修复:
- clearSessions 后同步清空前端会话与消息状态
- clearMemories 通过 memoryVersion 触发 MemoryViewer 重新加载
- ContextMenu 4 个 session 操作补全 IPC 调用与 try/catch
- useConfig 配置保存失败回滚 UI 并提示
- handleToggle 工具切换失败回滚单个工具状态

错误处理全量补全:
- 所有 await window.metona 调用补全 try/catch 与 toast 反馈
- MCP addServer/toggleServer/removeServer 检查返回值
- showItemInFolder 检查返回值（handleOpen/handleOpenInFolder）
- sse-stream/ollama NDJSON 解析失败改为 log.warn
- adapter throwHttpError 带 status 属性供 isRetryableError 判断

electron/harness/agent-loop/engine.ts

@@ -258,7 +258,11 @@ export class AgentLoopEngine extends EventEmitter {
           for (const result of step.toolResults) {
             messages.push({
               role: 'tool',
-              content: typeof result.result === 'string' ? result.result : JSON.stringify(result.result),
+              // CE-2 修复: 工具失败时 result.result 为 null，LLM 会看到 "null" 而非错误信息
+              // 优先使用 error 字段，让 LLM 知道失败原因，避免重复调用导致死循环
+              content: result.error
+                ? result.error
+                : (typeof result.result === 'string' ? result.result : JSON.stringify(result.result)),
               toolResult: result,
               timestamp: Date.now(),
               iteration: this.currentIteration,
@@ -274,11 +278,16 @@ export class AgentLoopEngine extends EventEmitter {
       return this.finish(TerminationReason.TIMEOUT);
     } catch (error) {
       // v0.3.0: 捕获 DeadLoopError — 以 DEAD_LOOP 原因终止
+      // P0-1 审查修复: 必须传 error 参数（第三参数），否则 finish() 不会发射 ERROR 事件
+      // 前端只收到 DONE 会导致 agentStatus 被设为 'idle' 而非 'error'，且无错误消息卡片
       if (error instanceof DeadLoopError) {
-        return this.finish(TerminationReason.DEAD_LOOP, error.message);
+        return this.finish(TerminationReason.DEAD_LOOP, undefined, error as Error);
       }
-      const errMsg = (error as Error).message;
-      if (this.aborted || errMsg.includes('Aborted')) {
+      const errMsg = (error as Error).message ?? '';
+      // P2-9 修复: toLowerCase 避免大小写敏感导致超时误判为 ERROR
+      // Node fetch 超时错误 "The operation timed out" / abort "Aborted" 都需覆盖
+      const errMsgLower = errMsg.toLowerCase();
+      if (this.aborted || errMsgLower.includes('aborted') || errMsgLower.includes('timed out') || errMsgLower.includes('timeout')) {
         return this.finish(TerminationReason.USER_INTERRUPT);
       }
       // v0.3.0 修复: 不使用 emit('error') — Node EventEmitter 对无监听器的 'error' 事件会同步 throw，
@@ -310,6 +319,29 @@ export class AgentLoopEngine extends EventEmitter {
     this.emit('aborted');
   }
 
+  /**
+   * MT-1 修复: 等待当前 run 结束（用于 abortSession IPC handler）
+   *
+   * abort() 只是设置了标志和触发了 abortController，
+   * 但 currentRunPromise 仍在进行中（可能在等待工具超时或 LLM 响应）。
+   * 如果不等待就返回，用户立即重发会导致新消息卡在 runStream 的 currentRunPromise 等待中。
+   *
+   * @param timeoutMs 等待超时（默认 5 秒，防止永久挂起）
+   * @returns true 表示 run 已结束，false 表示等待超时
+   */
+  async waitForAbort(timeoutMs: number = 5_000): Promise<boolean> {
+    if (!this.currentRunPromise) return true;
+    try {
+      await Promise.race([
+        this.currentRunPromise.catch(() => {}),
+        new Promise<void>((resolve) => setTimeout(resolve, timeoutMs)),
+      ]);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
   /**
    * 销毁引擎，清理所有监听器
    */
@@ -854,8 +886,10 @@ export class AgentLoopEngine extends EventEmitter {
     if (err.status && err.status >= 500 && err.status < 600) return true;
     // 网络超时/连接错误 — 可重试
     if (err.code === 'ECONNRESET' || err.code === 'ETIMEDOUT' || err.code === 'ENOTFOUND') return true;
-    // SSE 流中断 — 可重试
-    if (err.message?.includes('aborted') || err.message?.includes('socket hang up')) return true;
+    // P2-9 一致性修复: toLowerCase 避免大小写敏感漏判
+    // SSE 流中断 — 可重试（注意：用户主动 abort 已在 chatStreamWithRetry 入口由 this.aborted 提前拦截）
+    const msg = err.message?.toLowerCase() ?? '';
+    if (msg.includes('aborted') || msg.includes('socket hang up')) return true;
     // 其他错误（400/401/403/4xx）不重试
     return false;
   }
@@ -954,8 +988,34 @@ export class AgentLoopEngine extends EventEmitter {
     const keepRecent = 10; // 保留最近 10 条消息（约 3 轮 user+assistant+tool）
     if (messages.length <= keepRecent) return null;
 
-    const toCompress = messages.slice(0, messages.length - keepRecent);
-    const toKeep = messages.slice(messages.length - keepRecent);
+    let toCompress = messages.slice(0, messages.length - keepRecent);
+    let toKeep = messages.slice(messages.length - keepRecent);
+
+    // MT-3 修复: 确保 toKeep 不以孤立的 tool 消息开头
+    // OpenAI/DeepSeek API 要求 tool 消息前必须有带 tool_calls 的 assistant 消息
+    // 如果压缩边界正好切在 assistant(tool_calls) 和 tool 之间，下一轮 LLM 调用会返回 400
+    if (toKeep.length > 0 && toKeep[0].role === 'tool' && toCompress.length > 0) {
+      // 反向查找最近的带 tool_calls 的 assistant 消息
+      let assistantIdx = -1;
+      for (let i = toCompress.length - 1; i >= 0; i--) {
+        if (toCompress[i].role === 'assistant' && toCompress[i].toolCalls?.length) {
+          assistantIdx = i;
+          break;
+        }
+      }
+      if (assistantIdx < 0) {
+        // 找不到配对的 assistant 消息，直接丢弃孤立的 tool 消息
+        toKeep = toKeep.slice(1);
+      } else {
+        // 将配对的 assistant 消息及其之后的所有消息移到 toKeep 开头
+        const moved = toCompress.slice(assistantIdx);
+        toCompress = toCompress.slice(0, assistantIdx);
+        toKeep = [...moved, ...toKeep];
+      }
+    }
+
+    // 如果 toCompress 为空，无法生成摘要
+    if (toCompress.length === 0) return null;
 
     // 构建摘要请求
     // 不截断单条消息——摘要请求是独立 API 调用，不共享主对话上下文窗口
@@ -998,7 +1058,11 @@ export class AgentLoopEngine extends EventEmitter {
       if (!summary) return null;
 
       const summaryMessage: MetonaMessage = {
-        role: 'system',
+        // CE-1 修复: 使用 role: 'user' 而非 'system'
+        // adapter 的 buildOpenAICompatibleMessages 会过滤所有 role !== 'system' 的消息，
+        // 只保留 systemPrompt 构建的 system 消息。如果用 'system'，摘要会被丢弃，压缩无效。
+        // 改为 'user' 后 LLM 会看到：system(systemPrompt) → user(摘要) → ...toKeep
+        role: 'user',
         content: `[Context Summary] The following is a summary of earlier conversation:\n\n${summary}`,
         timestamp: Date.now(),
       };
@@ -1023,6 +1087,26 @@ export class AgentLoopEngine extends EventEmitter {
     answer?: string,
     error?: Error,
   ): AgentLoopOutput {
+    // P0-1 修复: ERROR/DEAD_LOOP 终止时先发 ERROR 流式事件，让前端能看到错误
+    // v0.3.0 删除了 emit('error') 导致所有 adapter 错误对前端不可见
+    // 此处用 emit('streamEvent', { type: ERROR }) 不会触发 EventEmitter 的同步 throw
+    if ((reason === TerminationReason.ERROR || reason === TerminationReason.DEAD_LOOP) && error) {
+      this.emit('streamEvent', {
+        type: MetonaStreamEventType.ERROR,
+        requestId: this.currentRequestId,
+        sessionId: this.currentSessionId,
+        iteration: this.currentIteration,
+        seq: this.nextSeq(),
+        timestamp: Date.now(),
+        runId: this.runId,
+        error: {
+          code: MetonaErrorCode.UNKNOWN,
+          message: error.message,
+          retryable: false,
+        },
+      });
+    }
+
     // 发送唯一的最终 DONE 事件 — UI 只在此处结束流式状态
     this.emit('streamEvent', {
       type: MetonaStreamEventType.DONE,
@@ -1032,6 +1116,7 @@ export class AgentLoopEngine extends EventEmitter {
       seq: this.nextSeq(),
       timestamp: Date.now(),
       runId: this.runId,
+      terminationReason: reason,
     });
 
     // H-3: 通过 stateChange 发射 TERMINATED 状态（前端可据此清理 UI）