Merge remote-tracking branch 'origin/main' into fix/background-task-notifications-clean

Author: Gujiassh

agents/s01_agent_loop.py

@@ -73,6 +73,8 @@ def run_bash(command: str) -> str:
         return out[:50000] if out else "(no output)"
     except subprocess.TimeoutExpired:
         return "Error: Timeout (120s)"
+    except (FileNotFoundError, OSError) as e:
+        return f"Error: {e}"
 
 
 # -- The core pattern: a while loop that calls tools until the model stops --

agents/s04_subagent.py

@@ -61,6 +61,8 @@ def run_bash(command: str) -> str:
         return out[:50000] if out else "(no output)"
     except subprocess.TimeoutExpired:
         return "Error: Timeout (120s)"
+    except (FileNotFoundError, OSError) as e:
+        return f"Error: {e}"
 
 def run_read(path: str, limit: int = None) -> str:
     try:
@@ -155,8 +157,9 @@ def agent_loop(messages: list):
             if block.type == "tool_use":
                 if block.name == "task":
                     desc = block.input.get("description", "subtask")
-                    print(f"> task ({desc}): {block.input['prompt'][:80]}")
-                    output = run_subagent(block.input["prompt"])
+                    prompt = block.input.get("prompt", "")
+                    print(f"> task ({desc}): {prompt[:80]}")
+                    output = run_subagent(prompt)
                 else:
                     handler = TOOL_HANDLERS.get(block.name)
                     output = handler(**block.input) if handler else f"Unknown tool: {block.name}"

agents/s06_context_compact.py

@@ -118,7 +118,9 @@ def auto_compact(messages: list) -> list:
             "Be concise but preserve critical details.\n\n" + conversation_text}],
         max_tokens=2000,
     )
-    summary = response.content[0].text
+    summary = next((block.text for block in response.content if hasattr(block, "text")), "")
+    if not summary:
+        summary = "No summary generated."
     # Replace all messages with compressed summary
     return [
         {"role": "user", "content": f"[Conversation compressed. Transcript: {transcript_path}]\n\n{summary}"},

docs/zh/s04-subagent.md

@@ -8,7 +8,7 @@
 
 ## 问题
 
-Agent 工作越久, messages 数组越胖。每次读文件、跑命令的输出都永久留在上下文里。"这个项目用什么测试框架?" 可能要读 5 个文件, 但父 Agent 只需要一个词: "pytest。"
+Agent 工作越久, messages 数组越臃肿。每次读文件、跑命令的输出都永久留在上下文里。"这个项目用什么测试框架?" 可能要读 5 个文件, 但父 Agent 只需要一个词: "pytest。"
 
 ## 解决方案
 

web/src/components/architecture/execution-flow.tsx

@@ -2,7 +2,6 @@
 
 import { useEffect, useState } from "react";
 import { motion } from "framer-motion";
-import { useTranslations } from "@/lib/i18n";
 import { getFlowForVersion } from "@/data/execution-flows";
 import type { FlowNode, FlowEdge } from "@/types/agent-data";
 
@@ -186,7 +185,6 @@ interface ExecutionFlowProps {
 }
 
 export function ExecutionFlow({ version }: ExecutionFlowProps) {
-  const t = useTranslations("version");
   const [flow, setFlow] = useState<ReturnType<typeof getFlowForVersion>>(null);
 
   useEffect(() => {
@@ -198,46 +196,43 @@ export function ExecutionFlow({ version }: ExecutionFlowProps) {
   const maxY = Math.max(...flow.nodes.map((n) => n.y)) + 50;
 
   return (
-    <section>
-      <h2 className="mb-4 text-xl font-semibold">{t("execution_flow")}</h2>
-      <div className="overflow-x-auto rounded-xl border border-[var(--color-border)] bg-[var(--color-bg)] p-4">
-        <svg
-          viewBox={`0 0 600 ${maxY}`}
-          className="mx-auto w-full max-w-[600px]"
-          style={{ minHeight: 300 }}
-        >
-          <defs>
-            <marker
-              id="arrowhead"
-              markerWidth={8}
-              markerHeight={6}
-              refX={8}
-              refY={3}
-              orient="auto"
-            >
-              <polygon
-                points="0 0, 8 3, 0 6"
-                fill="var(--color-text-secondary)"
-              />
-            </marker>
-          </defs>
-
-          {flow.edges.map((edge, i) => (
-            <EdgePath key={`${edge.from}-${edge.to}`} edge={edge} nodes={flow.nodes} index={i} />
-          ))}
-
-          {flow.nodes.map((node, i) => (
-            <motion.g
-              key={node.id}
-              initial={{ opacity: 0, y: -10 }}
-              animate={{ opacity: 1, y: 0 }}
-              transition={{ delay: i * 0.06, duration: 0.3 }}
-            >
-              <NodeShape node={node} />
-            </motion.g>
-          ))}
-        </svg>
-      </div>
-    </section>
+    <div className="overflow-x-auto rounded-xl border border-[var(--color-border)] bg-[var(--color-bg)] p-4">
+      <svg
+        viewBox={`0 0 600 ${maxY}`}
+        className="mx-auto w-full max-w-[600px]"
+        style={{ minHeight: 300 }}
+      >
+        <defs>
+          <marker
+            id="arrowhead"
+            markerWidth={8}
+            markerHeight={6}
+            refX={8}
+            refY={3}
+            orient="auto"
+          >
+            <polygon
+              points="0 0, 8 3, 0 6"
+              fill="var(--color-text-secondary)"
+            />
+          </marker>
+        </defs>
+
+        {flow.edges.map((edge, i) => (
+          <EdgePath key={`${edge.from}-${edge.to}`} edge={edge} nodes={flow.nodes} index={i} />
+        ))}
+
+        {flow.nodes.map((node, i) => (
+          <motion.g
+            key={node.id}
+            initial={{ opacity: 0, y: -10 }}
+            animate={{ opacity: 1, y: 0 }}
+            transition={{ delay: i * 0.06, duration: 0.3 }}
+          >
+            <NodeShape node={node} />
+          </motion.g>
+        ))}
+      </svg>
+    </div>
   );
 }