feat: update agent framework with new termination modes and enhance event visualization

tt-a1i · tt-a1i · commit 0b0545604750 · 2026-01-02T11:55:33.000+08:00
- Updated agent termination mode count from 5 to 6
- Renamed SubagentTerminateMode to AgentTerminateMode and added new ABORTED and ERROR_NO_COMPLETE_TASK_CALL modes
- Updated documentation and UI to reflect new termination modes
- Modified HookEventAnimation to show 11 event types with enhanced visual grouping
- Added BeforeAgent, AfterAgent, and Notification event types to visualization
- Adjusted grid layout for better event type display in HookEventAnimation
diff --git a/src/pages/AgentFramework.tsx b/src/pages/AgentFramework.tsx
@@ -45,7 +45,7 @@ function QuickSummary({ isExpanded, onToggle }: { isExpanded: boolean; onToggle:
               <div className="text-xs text-[var(--text-muted)]">Agent 类型</div>
             </div>
             <div className="bg-[var(--bg-card)] rounded-lg p-3 text-center border border-[var(--border-subtle)]">
-              <div className="text-2xl font-bold text-[var(--terminal-green)]">5</div>
+              <div className="text-2xl font-bold text-[var(--terminal-green)]">6</div>
               <div className="text-xs text-[var(--text-muted)]">终止模式</div>
             </div>
             <div className="bg-[var(--bg-card)] rounded-lg p-3 text-center border border-[var(--border-subtle)]">
@@ -156,13 +156,14 @@ export function AgentFramework() {
     style TURN fill:#1a1a2e,stroke:#00d4ff,stroke-width:2px`;
 
   const agentTypesCode = `// Agent 终止模式
-// packages/core/src/subagents/types.ts:172-193
-export enum SubagentTerminateMode {
+// packages/core/src/agents/types.ts
+export enum AgentTerminateMode {
   ERROR = 'ERROR',                           // 执行错误
   TIMEOUT = 'TIMEOUT',                       // 超时
   GOAL = 'GOAL',                             // 成功完成
   MAX_TURNS = 'MAX_TURNS',                   // 达到轮次上限
-  CANCELLED = 'CANCELLED',                   // 被取消
+  ABORTED = 'ABORTED',                       // 外部中止信号
+  ERROR_NO_COMPLETE_TASK_CALL = 'ERROR_NO_COMPLETE_TASK_CALL',  // 未调用 complete_task
 }
 
 // 基础 Agent 定义
@@ -855,8 +856,13 @@ this.emitActivity('ERROR', { error: errorMessage, context: 'tool_call' });`;
                 <td className="py-2 px-3 text-red-400">✗</td>
               </tr>
               <tr className="border-b border-[var(--border-subtle)]/50">
-                <td className="py-2 px-3 text-red-400 font-bold">CANCELLED</td>
-                <td className="py-2 px-3 text-[var(--text-secondary)]">用户取消 (AbortSignal)</td>
+                <td className="py-2 px-3 text-red-400 font-bold">ABORTED</td>
+                <td className="py-2 px-3 text-[var(--text-secondary)]">外部中止信号 (AbortSignal)</td>
+                <td className="py-2 px-3 text-red-400">✗</td>
+              </tr>
+              <tr className="border-b border-[var(--border-subtle)]/50">
+                <td className="py-2 px-3 text-red-400 font-bold">ERROR_NO_COMPLETE_TASK_CALL</td>
+                <td className="py-2 px-3 text-[var(--text-secondary)]">停止调用工具但未调用 complete_task</td>
                 <td className="py-2 px-3 text-red-400">✗</td>
               </tr>
             </tbody>
diff --git a/src/pages/HookEventAnimation.tsx b/src/pages/HookEventAnimation.tsx
@@ -56,15 +56,18 @@ function Introduction({ isExpanded, onToggle }: { isExpanded: boolean; onToggle:
 
           <div className="bg-[var(--bg-terminal)]/50 rounded-lg p-4 border-l-4 border-[var(--cyber-blue)]">
             <h4 className="text-[var(--cyber-blue)] font-bold mb-2">🔧 11 种事件类型</h4>
-            <div className="grid grid-cols-2 md:grid-cols-4 gap-2 mt-2 text-xs">
+            <div className="grid grid-cols-3 md:grid-cols-4 gap-2 mt-2 text-xs">
               <div className="bg-[var(--bg-card)] p-2 rounded text-center text-[var(--terminal-green)]">BeforeTool</div>
               <div className="bg-[var(--bg-card)] p-2 rounded text-center text-[var(--terminal-green)]">AfterTool</div>
+              <div className="bg-[var(--bg-card)] p-2 rounded text-center text-cyan-400">BeforeAgent</div>
+              <div className="bg-[var(--bg-card)] p-2 rounded text-center text-cyan-400">AfterAgent</div>
               <div className="bg-[var(--bg-card)] p-2 rounded text-center text-[var(--cyber-blue)]">BeforeModel</div>
               <div className="bg-[var(--bg-card)] p-2 rounded text-center text-[var(--cyber-blue)]">AfterModel</div>
               <div className="bg-[var(--bg-card)] p-2 rounded text-center text-[var(--amber)]">SessionStart</div>
               <div className="bg-[var(--bg-card)] p-2 rounded text-center text-[var(--amber)]">SessionEnd</div>
               <div className="bg-[var(--bg-card)] p-2 rounded text-center text-[var(--purple)]">PreCompress</div>
               <div className="bg-[var(--bg-card)] p-2 rounded text-center text-[var(--purple)]">BeforeToolSelection</div>
+              <div className="bg-[var(--bg-card)] p-2 rounded text-center text-orange-400">Notification</div>
             </div>
           </div>
 
diff --git a/src/pages/ToolSchedulerDetails.tsx b/src/pages/ToolSchedulerDetails.tsx
@@ -417,7 +417,7 @@ private async checkAndNotifyCompletion(): Promise<void> {
   }
 }`;
 
-  const toolCallStatusCode = `// packages/core/src/core/coreToolScheduler.ts:46-123
+  const toolCallStatusCode = `// packages/core/src/scheduler/types.ts:38-115
 
 // 工具调用状态类型定义
 export type ValidatingToolCall = {
@@ -453,7 +453,7 @@ export type ExecutingToolCall = {
   request: ToolCallRequestInfo;
   tool: AnyDeclarativeTool;
   invocation: AnyToolInvocation;
-  liveOutput?: ToolResultDisplay; // 实时输出
+  liveOutput?: string | AnsiOutput; // 实时输出（ANSI 格式）
   startTime?: number;
   outcome?: ToolConfirmationOutcome;
   pid?: number;                   // 进程 ID (Shell 工具)
diff --git a/src/pages/TurnStateMachine.tsx b/src/pages/TurnStateMachine.tsx
@@ -80,7 +80,7 @@ function Introduction({
             <h4 className="text-green-400 font-bold mb-2">📊 关键数字</h4>
             <div className="grid grid-cols-2 md:grid-cols-4 gap-3">
               <div className="text-center">
-                <div className="text-xl font-bold text-purple-400">14</div>
+                <div className="text-xl font-bold text-purple-400">17</div>
                 <div className="text-xs text-gray-500">事件类型</div>
               </div>
               <div className="text-center">
@@ -213,12 +213,28 @@ function EventTypesSection() {
       example: '{ type: "max_session_turns" }',
     },
     {
-      type: 'SessionTokenLimitExceeded',
-      icon: '📈',
+      type: 'ContextWindowWillOverflow',
+      icon: '⚠️',
+      color: 'amber',
+      description: '上下文窗口即将溢出',
+      when: 'Token 数接近模型上限时',
+      example: '{ type: "context_window_will_overflow" }',
+    },
+    {
+      type: 'InvalidStream',
+      icon: '🚫',
       color: 'red',
-      description: '超过会话 Token 限制',
-      when: 'totalTokens > sessionTokenLimit 时',
-      example: '{ type: "session_token_limit_exceeded", value: { currentTokens: 150000, limit: 100000 } }',
+      description: '无效的流数据',
+      when: '流解析失败或格式错误时',
+      example: '{ type: "invalid_stream" }',
+    },
+    {
+      type: 'ModelInfo',
+      icon: 'ℹ️',
+      color: 'blue',
+      description: '返回当前模型信息',
+      when: '获取模型元数据时',
+      example: '{ type: "model_info", value: { model: "gemini-pro", ... } }',
     },
   ];
 
