scream-code 0.8.1 → 0.8.3

package/dist/{app-BkxFc8Y9.mjs → app-Dpd7ZDc_.mjs}

@@ -5,7 +5,7 @@ const __filename = __cjsShimFileURLToPath(import.meta.url);
 const __dirname = __cjsShimDirname(__filename);
 import { a as __toESM, i as __require, r as __exportAll, t as __commonJSMin } from "./chunk-apG1qJts.mjs";
 import "./suppress-sqlite-warning-C2VB0doZ.mjs";
-import { C as parse$7, S as normalize, T as resolve$1, _ as KnowledgeStore, b as isAbsolute$1, i as isSupportedFile, n as ingestDirectory, r as ingestFile, t as multiSearch, v as basename$1, w as relative$1, x as join$1, y as dirname$2 } from "./src-CFaXGblk.mjs";
+import { C as join$1, D as resolve$1, E as relative$1, S as isAbsolute$1, T as parse$7, a as isSupportedFile, b as basename$1, i as ingestFile, r as ingestDirectory, t as multiSearch, w as normalize, x as dirname$2, y as KnowledgeStore } from "./src-DWWVKqBK.mjs";
 import { createRequire } from "node:module";
 import { createHash, randomBytes, randomInt, randomUUID } from "node:crypto";
 import Jn, { access, appendFile, chmod, copyFile, cp, lstat, mkdir, mkdtemp, open, readFile, readdir, realpath, rename, rm, rmdir, stat, unlink, writeFile } from "node:fs/promises";
@@ -58216,8 +58216,8 @@ var KnowledgeLookupTool = class {
 				const llm = { generate: async (systemPrompt, userPrompt) => {
 					return this.agent.generateText(systemPrompt, userPrompt);
 				} };
-				const { multiSearch } = await import("./src-BJO7qNnY.mjs");
-				const results = await multiSearch(store, llm, query, { topK });
+				const { multiSearchWithTrace } = await import("./src-BChzuWm-.mjs");
+				const { results, trace } = await multiSearchWithTrace(store, llm, query, { topK });
 				if (results.length === 0) return {
 					isError: false,
 					output: `No knowledge base entries found for query "${query}".`
@@ -58228,6 +58228,13 @@ var KnowledgeLookupTool = class {
 					const eventLine = result.eventTitle !== null ? `  Event: ${result.eventTitle}` : void 0;
 					lines.push(`**${i + 1}. ${heading}** (from: ${result.sourceName})`, `  Score: ${result.score.toFixed(3)}`, ...eventLine !== void 0 ? [eventLine] : [], `  ${result.content}`, "");
 				}
+				lines.push("---", "Retrieval trace:");
+				if (trace.fallbackReason !== null) lines.push(`  ⚠ Fallback: ${trace.fallbackReason}`);
+				for (const step of trace.steps) {
+					const payloadStr = step.payload !== void 0 ? ` ${JSON.stringify(step.payload)}` : "";
+					lines.push(`  • ${step.step} (${step.durationMs}ms) — ${step.detail}${payloadStr}`);
+				}
+				if (trace.rerankedEventTitles.length > 0) lines.push(`  Reranked events: ${trace.rerankedEventTitles.join(" | ")}`);
 				return {
 					isError: false,
 					output: lines.join("\n")
@@ -78393,7 +78400,21 @@ function stripContextMetadata(message) {
 //#region ../../packages/agent-core/src/agent/compaction/compaction-instruction.md
 var compaction_instruction_default = "\n--- This message is a direct task, not part of the above conversation ---\n\nYou are now given a task to compact this conversation context according to specific priorities and output requirements.\n\nOutput text only. DO NOT CALL ANY TOOLS. Calling tools will be rejected and fails the task. You already have all the information you need in the conversation history. You have only one chance.\n\nThe goal of compaction is to keep essential code patterns, technical details, and architectural decisions for continuing development without losing context after the above messages are cleared work.\n\n{{ customInstruction }}\n\n<!-- Memory Memo Extraction (PRIORITY — do not skip) -->\n\n## 任务经验提取\n\nAFTER completing the compaction summary below, scan the messages being compacted for **completed task loops**. A task loop is \"completed\" when:\n- The user made a clear request or asked a specific question\n- You provided a solution or answer\n- The outcome is clear (success, partial success, or failure)\n\nFor each completed task loop found, output a structured experience record **at the very end of your response**:\n\n```memory-memo\n{\n  \"userNeed\": \"<the user's need or goal, one sentence>\",\n  \"approach\": \"<what was done — the approach taken, 2-4 sentences>\",\n  \"outcome\": \"<final result, e.g. '完成', '部分完成', '失败: reason'>\",\n  \"whatFailed\": \"<dead ends tried — things that didn't work, or 'none'>\",\n  \"whatWorked\": \"<key actions that ultimately worked, or 'none'>\",\n  \"tags\": [\"<tag1>\", \"<tag2>\", \"<tag3>\"]\n}\n```\n\nGuidelines:\n- Record important failed attempts in \"whatFailed\" to help avoid repeating mistakes.\n- Record key successful actions in \"whatWorked\" to help reuse effective approaches.\n- Include 3-5 semantic \"tags\" summarizing the task domain, tech stack, or action type (e.g. [\"react\", \"auth\", \"部署\"]).\n- Skip in-progress work unless it contains a valuable error+fix experience.\n- Merge closely related sub-tasks into a single record.\n- Use the exact field names and JSON format shown above.\n\nIf no completed task loops are found in the compacted messages, output:\n```memory-memo\n{\"none\": true}\n```\n\n<!-- Compression Priorities (in order) -->\n\n1. **Current Task State**: What is being worked on RIGHT NOW\n2. **Errors & Solutions**: All encountered errors and their resolutions\n3. **Code Evolution**: Final working versions only (remove intermediate attempts)\n4. **System Context**: Project structure, dependencies, environment setup\n5. **Design Decisions**: Architectural choices and their rationale\n6. **TODO Items**: Unfinished tasks and known issues\n\n<!-- Required Output Structure -->\n\n## Current Focus\n\n[What we're working on now]\n\n## Environment\n\n- [Key setup/config points]\n- ...\n\n## Completed Tasks\n\n- [Task]: [Brief outcome]\n- ...\n\n## Active Issues\n\n- [Issue]: [Status/Next steps]\n- ...\n\n## Code State\n\n### [Critical file name]\n\n[Brief description of the file's purpose and current state]\n\n```\n[The latest version of critical code snippets in this file, <20 lines]\n```\n\n### [Critical file name]\n\n- [Useful classes/methods/functions]: [Brief description/usage]\n- ...\n\n<!-- Omit non-critical code, intermediate attempts, and resolved errors -->\n\n## Important Context\n\n- [Any crucial information not covered above]\n- ...\n\n## All User Messages\n\n- [Detailed non tool use user message]\n- ...\n";
 //#endregion
+//#region ../../packages/agent-core/src/agent/compaction/compaction-update-instruction.md
+var compaction_update_instruction_default = "\n--- This message is a direct task, not part of the above conversation ---\n\nYou are now given a task to UPDATE an existing compaction summary with new messages that came in after the last compaction.\n\nA previous compaction summary already exists at the top of the conversation (the first assistant message). You must NOT discard it. Instead, merge the new information into the existing structure, keeping all previously captured state intact unless explicitly contradicted or resolved by the new messages.\n\nOutput text only. DO NOT CALL ANY TOOLS. Calling tools will be rejected and fails the task. You have only one chance.\n\n{{ customInstruction }}\n\n<!-- Previous Summary Reference -->\n\nThe first assistant message above is the PREVIOUS summary. Treat it as the source of truth for everything that happened before the new messages. Do not restate it verbatim — produce an updated, merged summary.\n\n<!-- Memory Memo Extraction (PRIORITY — do not skip) -->\n\n## 任务经验提取\n\nAFTER completing the updated summary below, scan ONLY the new messages being compacted (not those already covered by the previous summary) for **completed task loops**. A task loop is \"completed\" when:\n- The user made a clear request or asked a specific question\n- You provided a solution or answer\n- The outcome is clear (success, partial success, or failure)\n\nFor each completed task loop found, output a structured experience record **at the very end of your response**:\n\n```memory-memo\n{\n  \"userNeed\": \"<the user's need or goal, one sentence>\",\n  \"approach\": \"<what was done — the approach taken, 2-4 sentences>\",\n  \"outcome\": \"<final result, e.g. '完成', '部分完成', '失败: reason'>\",\n  \"whatFailed\": \"<dead ends tried — things that didn't work, or 'none'>\",\n  \"whatWorked\": \"<key actions that ultimately worked, or 'none'>\",\n  \"tags\": [\"<tag1>\", \"<tag2>\", \"<tag3>\"]\n}\n```\n\nGuidelines:\n- Record important failed attempts in \"whatFailed\" to help avoid repeating mistakes.\n- Record key successful actions in \"whatWorked\" to help reuse effective approaches.\n- Include 3-5 semantic \"tags\" summarizing the task domain, tech stack, or action type.\n- Skip in-progress work unless it contains a valuable error+fix experience.\n- Merge closely related sub-tasks into a single record.\n- Use the exact field names and JSON format shown above.\n\nIf no completed task loops are found in the new compacted messages, output:\n```memory-memo\n{\"none\": true}\n```\n\n<!-- Update Rules -->\n\n1. Preserve the section structure of the previous summary (Current Focus, Environment, Completed Tasks, Active Issues, Code State, Important Context, All User Messages).\n2. Move newly-completed tasks from \"Current Focus\" / \"Active Issues\" into \"Completed Tasks\".\n3. Update \"Current Focus\" to reflect what is being worked on RIGHT NOW.\n4. Append new user messages to \"All User Messages\" — do not repeat those already captured.\n5. Refresh \"Code State\" code snippets only if newer versions exist in the new messages.\n6. Drop resolved issues from \"Active Issues\"; add newly-discovered ones.\n7. Do not invent new information. If the new messages say nothing about a section, carry the previous content forward unchanged.\n\n<!-- Required Output Structure -->\n\n## Current Focus\n\n[What we're working on now]\n\n## Environment\n\n- [Key setup/config points]\n- ...\n\n## Completed Tasks\n\n- [Task]: [Brief outcome]\n- ...\n\n## Active Issues\n\n- [Issue]: [Status/Next steps]\n- ...\n\n## Code State\n\n### [Critical file name]\n\n[Brief description of the file's purpose and current state]\n\n```\n[The latest version of critical code snippets in this file, <20 lines]\n```\n\n## Important Context\n\n- [Any crucial information not covered above]\n- ...\n\n## All User Messages\n\n- [Detailed non tool use user message]\n- ...\n";
+//#endregion
 //#region ../../packages/agent-core/src/agent/compaction/render-messages.ts
+const TOOL_RESULT_MAX_CHARS = 2e3;
+const TOOL_CALL_MAX_CHARS = 2e3;
+const TRUNCATE_HEAD_RATIO = .6;
+function truncateForSummary(text, maxChars, headRatio = TRUNCATE_HEAD_RATIO) {
+	if (text.length <= maxChars) return text;
+	const headChars = Math.round(maxChars * Math.min(Math.max(headRatio, 0), 1));
+	const tailChars = maxChars - headChars;
+	const elided = text.length - maxChars;
+	const tail = tailChars > 0 ? text.slice(-tailChars) : "";
+	return `${text.slice(0, headChars)} […${elided}ch elided…] ${tail}`;
+}
 function renderMessagesToText(messages) {
 	return messages.map((message, index) => renderMessageToText(message, index)).join("\n\n");
 }
@@ -78413,8 +78434,8 @@ function renderMessageToText(message, index) {
 }
 function renderContentPartToText(part) {
 	switch (part.type) {
-		case "text": return renderBlock("text", part.text);
-		case "think": return renderBlock("think", part.think);
+		case "text": return renderBlock("text", truncateForSummary(part.text, TOOL_RESULT_MAX_CHARS));
+		case "think": return renderBlock("think", truncateForSummary(part.think, TOOL_RESULT_MAX_CHARS));
 		case "image_url": return renderMediaPart("image_url", part.imageUrl.url, part.imageUrl.id);
 		case "audio_url": return renderMediaPart("audio_url", part.audioUrl.url, part.audioUrl.id);
 		case "video_url": return renderMediaPart("video_url", part.videoUrl.url, part.videoUrl.id);
@@ -78428,11 +78449,13 @@ function renderToolCallToText(toolCall) {
 }
 function renderToolCallArguments(args) {
 	if (args === null) return "null";
+	let pretty;
 	try {
-		return stringifyJsonish(JSON.parse(args));
+		pretty = stringifyJsonish(JSON.parse(args));
 	} catch {
-		return args;
+		pretty = args;
 	}
+	return truncateForSummary(pretty, TOOL_CALL_MAX_CHARS);
 }
 function renderMediaPart(type, url, id) {
 	if (id === void 0) return `${type}: ${url}`;
@@ -78471,7 +78494,7 @@ const DEFAULT_COMPACTION_CONFIG = {
 	reservedContextSize: 5e4,
 	maxCompactionPerTurn: 3,
 	maxRecentMessages: 4,
-	maxRecentUserMessages: Infinity,
+	maxRecentUserMessages: 2,
 	maxRecentSizeRatio: .2,
 	minOverflowReductionRatio: .05,
 	turnGrowthMultiplier: 2.5
@@ -78567,6 +78590,117 @@ function canSplitAfter(messages, index) {
 	if (messages[index + 1]?.role === "tool") return false;
 	return true;
 }
+//#endregion
+//#region ../../packages/agent-core/src/agent/compaction/file-operations.ts
+function createFileOps() {
+	return {
+		read: /* @__PURE__ */ new Set(),
+		written: /* @__PURE__ */ new Set(),
+		edited: /* @__PURE__ */ new Set()
+	};
+}
+function extractFileOpsFromMessage(message, ops) {
+	if (message.role !== "assistant") return;
+	for (const call of message.toolCalls) {
+		if (call.type !== "function" || call.arguments === null) continue;
+		let args;
+		try {
+			args = JSON.parse(call.arguments);
+		} catch {
+			continue;
+		}
+		const path = typeof args["path"] === "string" ? args["path"] : void 0;
+		if (path === void 0 || path.length === 0) continue;
+		switch (call.name) {
+			case "Read":
+				ops.read.add(path);
+				break;
+			case "Edit":
+				ops.edited.add(path);
+				break;
+			case "Write":
+				ops.written.add(path);
+				break;
+		}
+	}
+}
+const FILE_LIMIT = 20;
+function formatFileOperations(ops) {
+	const modified = new Set([...ops.edited, ...ops.written]);
+	const readOnly = [...ops.read].filter((f) => !modified.has(f)).sort();
+	const modifiedFiles = [...modified].sort();
+	const all = [...new Set([...readOnly, ...modifiedFiles])].sort();
+	if (all.length === 0) return "";
+	const mode = /* @__PURE__ */ new Map();
+	for (const f of readOnly) mode.set(f, "Read");
+	for (const f of modifiedFiles) mode.set(f, ops.read.has(f) ? "RW" : "Write");
+	const lines = ["<files>"];
+	for (const f of all.slice(0, FILE_LIMIT)) lines.push(`${f} (${mode.get(f)})`);
+	if (all.length > FILE_LIMIT) lines.push(`[…${all.length - FILE_LIMIT} files elided…]`);
+	lines.push("</files>");
+	return lines.join("\n");
+}
+/** Max recursion depth for re-summarize fallback. Each level halves the
+*  input, so depth 3 means we can compress a 8x-oversized input down to a
+*  single summary by chaining 2^3 = 8 partial summaries. */
+const MAX_RE_SUMMARIZE_DEPTH = 3;
+var TruncatedError = class extends Error {};
+/**
+* Recursive re-summarize fallback for context overflow. When even the
+* minimum safe split still overflows the model (typically because a single
+* message contains a giant tool result), split the input in half at a safe
+* boundary, summarize each half, then concatenate the two partial summaries
+* and re-summarize them into one. If a half still overflows, recurse.
+*
+* The split uses `canSplitAfter` from the strategy to make sure each half
+* ends at a message boundary that doesn't orphan tool results. If no safe
+* split exists in the half (e.g. one giant message), feed it as-is to the
+* model and let the outer retry loop handle the overflow.
+*/
+async function summarizeWithFallback(messages, summarizeOnce, depth = 0) {
+	if (messages.length <= 1) return summarizeOnce(messages);
+	let split = -1;
+	const mid = Math.floor(messages.length / 2);
+	for (let i = mid; i > 0; i--) if (canSplitAfterContext(messages, i - 1)) {
+		split = i;
+		break;
+	}
+	if (split === -1) {
+		for (let i = mid + 1; i < messages.length; i++) if (canSplitAfterContext(messages, i - 1)) {
+			split = i;
+			break;
+		}
+	}
+	if (split === -1) return summarizeOnce(messages);
+	const firstHalf = messages.slice(0, split);
+	const secondHalf = messages.slice(split);
+	const summarizeHalf = async (half) => {
+		try {
+			return (await summarizeOnce(half)).summary;
+		} catch (error) {
+			if ((error instanceof APIContextOverflowError || error instanceof TruncatedError) && depth + 1 < MAX_RE_SUMMARIZE_DEPTH) return (await summarizeWithFallback(half, summarizeOnce, depth + 1)).summary;
+			throw error;
+		}
+	};
+	return summarizeOnce([{
+		role: "user",
+		content: [{
+			type: "text",
+			text: `${await summarizeHalf(firstHalf)}\n\n---\n\n${await summarizeHalf(secondHalf)}`
+		}],
+		toolCalls: []
+	}]);
+}
+/** Same split-safety rule as DefaultCompactionStrategy.canSplitAfter, but
+*  operates on ContextMessage (which carries toolCalls on assistant msgs). */
+function canSplitAfterContext(messages, index) {
+	const m = messages[index];
+	if (m === void 0) return false;
+	if (m.role === "user") return false;
+	if (m.role === "assistant" && m.toolCalls.length > 0) return false;
+	if (messages[index + 1]?.role === "tool") return false;
+	return true;
+}
 /** Max consecutive compaction failures before auto-compaction is
 *  disabled for the remainder of the turn. Resets each turn. */
 const MAX_CONSECUTIVE_FAILURES = 3;
@@ -78582,6 +78716,16 @@ var FullCompaction = class {
 	consecutiveCompactionFailures = 0;
 	_shouldInjectSessionSummary = false;
 	compactionTimedOut = false;
+	/** Token count below which compaction should not re-trigger. Set after a
+	*  successful compaction to 110% of the post-compaction token count, so
+	*  that a context sitting just above triggerRatio doesn't immediately
+	*  re-trigger on every step. Reset each turn. */
+	lowWaterMark = 0;
+	/** Whether a reactive (overflow-triggered) compaction has already been
+	*  attempted this turn. Prevents the overflow → compact → still near
+	*  limit → overflow → compact cycle from consuming the entire
+	*  maxCompactionPerTurn budget with marginal savings. */
+	reactiveAttempted = false;
 	compacting = null;
 	_compactedHistory = [];
 	strategy;
@@ -78660,8 +78804,11 @@ var FullCompaction = class {
 	resetForTurn() {
 		this.compactionCountInTurn = 0;
 		this.consecutiveCompactionFailures = 0;
+		this.lowWaterMark = 0;
+		this.reactiveAttempted = false;
 	}
 	async handleOverflowError(signal, error) {
+		if (this.reactiveAttempted) throw error;
 		if (!this.beginAutoCompaction(false) && !this.compacting) {
 			if (this.consecutiveCompactionFailures >= MAX_CONSECUTIVE_FAILURES) this.agent.emitEvent({
 				type: "warning",
@@ -78670,11 +78817,12 @@ var FullCompaction = class {
 			});
 			throw error;
 		}
+		this.reactiveAttempted = true;
 	}
 	async beforeStep(signal) {
 		this.agent.microCompaction.detect();
 		const effectiveTokens = this.effectiveTokenCount;
-		const isReactiveTrigger = this.strategy.shouldCompact(effectiveTokens);
+		const isReactiveTrigger = this.strategy.shouldCompact(effectiveTokens) && effectiveTokens >= this.lowWaterMark;
 		const isProactiveTrigger = !isReactiveTrigger && this.strategy.shouldCompactProactively(effectiveTokens, this.estimatedMaxOutputTokens);
 		if (isReactiveTrigger) this.checkAutoCompaction();
 		else if (isProactiveTrigger) this.beginAutoCompaction();
@@ -78697,7 +78845,9 @@ var FullCompaction = class {
 	}
 	checkAutoCompaction(throwOnLimit = true) {
 		if (this.compacting) return true;
-		if (!this.strategy.shouldCompact(this.tokenCountWithPending)) return false;
+		const effectiveTokens = this.effectiveTokenCount;
+		if (!this.strategy.shouldCompact(effectiveTokens)) return false;
+		if (effectiveTokens < this.lowWaterMark) return false;
 		return this.beginAutoCompaction(throwOnLimit);
 	}
 	beginAutoCompaction(throwOnLimit = true) {
@@ -78744,32 +78894,52 @@ var FullCompaction = class {
 		const originalHistory = [...this.agent.context.history];
 		const tokensBefore = estimateTokensForMessages(originalHistory);
 		const model = this.agent.config.model;
+		const isUpdate = extractPreviousSummary(originalHistory) !== null;
 		let retryCount = 0;
 		try {
 			await this.triggerPreCompactHook(data, tokensBefore, signal);
 			const delays = retryBackoffDelays(5);
-			let usage;
-			let summary;
-			while (true) {
-				const messagesToCompact = originalHistory.slice(0, compactedCount);
+			const summarizeOnce = async (messagesToCompact) => {
+				const instruction = isUpdate ? COMPACTION_UPDATE_INSTRUCTION(data.instruction) : COMPACTION_INSTRUCTION(data.instruction);
 				const messages = [...project(messagesToCompact), {
 					role: "user",
 					content: [{
 						type: "text",
-						text: COMPACTION_INSTRUCTION(data.instruction)
+						text: instruction
 					}],
 					toolCalls: []
 				}];
-				class TruncatedError extends Error {}
+				const response = await this.agent.generate(this.agent.config.provider, COMPACTION_SYSTEM_PROMPT, [], messages, void 0, { signal });
+				if (response.finishReason === "truncated") throw new TruncatedError();
+				return {
+					summary: extractCompactionSummary(response, model),
+					usage: response.usage
+				};
+			};
+			let usage;
+			let summary;
+			while (true) {
+				const messagesToCompact = originalHistory.slice(0, compactedCount);
 				try {
-					const response = await this.agent.generate(this.agent.config.provider, COMPACTION_SYSTEM_PROMPT, [], messages, void 0, { signal });
-					if (response.finishReason === "truncated") throw new TruncatedError();
-					usage = response.usage;
-					summary = extractCompactionSummary(response, model);
+					const result = await summarizeOnce(messagesToCompact);
+					usage = result.usage;
+					summary = result.summary;
 					break;
 				} catch (error) {
-					if (error instanceof APIContextOverflowError || error instanceof TruncatedError) compactedCount = this.strategy.reduceCompactOnOverflow(messagesToCompact);
-					else if (!isRetryableGenerateError(error)) throw error;
+					if (error instanceof APIContextOverflowError || error instanceof TruncatedError) {
+						const reduced = this.strategy.reduceCompactOnOverflow(messagesToCompact);
+						if (reduced < compactedCount) compactedCount = reduced;
+						else {
+							this.agent.log.warn("compaction overflow at minimum split, falling back to re-summarize", {
+								compactedCount,
+								tokensBefore: estimateTokensForMessages(messagesToCompact)
+							});
+							const result = await summarizeWithFallback(messagesToCompact, summarizeOnce);
+							summary = result.summary;
+							usage = result.usage;
+							break;
+						}
+					} else if (!isRetryableGenerateError(error)) throw error;
 					if (retryCount + 1 >= 5) throw error;
 					await sleepForRetry(delays[retryCount], signal);
 					retryCount += 1;
@@ -78782,12 +78952,17 @@ var FullCompaction = class {
 				return;
 			}
 			const recent = originalHistory.slice(compactedCount);
-			const tokensAfter = estimateTokens$1(summary) + estimateTokensForMessages(recent);
+			const messagesToCompactForOps = originalHistory.slice(0, compactedCount);
+			const fileOps = createFileOps();
+			for (const msg of messagesToCompactForOps) extractFileOpsFromMessage(msg, fileOps);
+			const processedSummary = this.postProcessSummary(summary, fileOps);
+			const tokensAfter = estimateTokens$1(processedSummary) + estimateTokensForMessages(recent);
 			const result = {
-				summary,
+				summary: processedSummary,
 				compactedCount,
 				tokensBefore,
-				tokensAfter
+				tokensAfter,
+				...isUpdate ? { isUpdate: true } : {}
 			};
 			this.markCompleted();
 			this.agent.emitEvent({
@@ -78795,7 +78970,8 @@ var FullCompaction = class {
 				result
 			});
 			this.agent.context.applyCompaction(result);
-			await this.extractAndStoreMemos(summary);
+			this.lowWaterMark = Math.floor(this.effectiveTokenCount * 1.1);
+			await this.extractAndStoreMemos(processedSummary);
 			this.triggerPostCompactHook(data, result);
 			this.consecutiveCompactionFailures = 0;
 			this._shouldInjectSessionSummary = true;
@@ -78887,22 +79063,27 @@ var FullCompaction = class {
 		});
 	}
 	/**
-	* Append the current todo list as a markdown section to the compaction
-	* summary so active tasks survive compression. This mirrors kimi-code's
-	* approach: without it, the todo list is lost after compaction because
-	* the original messages containing it are removed from the context window.
+	* Append the current todo list and file operations as markdown sections to
+	* the compaction summary so active tasks and file context survive
+	* compression. Without this, both are lost after compaction because the
+	* original messages containing them are removed from the context window.
 	*/
-	postProcessSummary(summary) {
+	postProcessSummary(summary, fileOps) {
 		const todos = this.agent.tools.storeData()["todo"] ?? [];
-		if (todos.length === 0) return summary;
-		const todoMarkdown = [
-			"## TODO List",
-			"",
-			...todos.map((t) => {
+		const sections = [summary.trim()];
+		if (todos.length > 0) {
+			const lines = todos.map((t) => {
 				return `- [${t.status === "done" ? "x" : t.status === "in_progress" ? "-" : " "}] ${t.title}`;
-			})
-		].join("\n");
-		return `${summary.trim()}\n\n${todoMarkdown}`;
+			});
+			sections.push([
+				"## TODO List",
+				"",
+				...lines
+			].join("\n"));
+		}
+		const filesSection = formatFileOperations(fileOps);
+		if (filesSection.length > 0) sections.push(filesSection);
+		return sections.join("\n\n");
 	}
 };
 function extractCompactionSummary(response, model) {
@@ -78911,6 +79092,18 @@ function extractCompactionSummary(response, model) {
 	return summary;
 }
 const COMPACTION_INSTRUCTION = (customInstruction = "") => renderPrompt(compaction_instruction_default, { customInstruction });
+const COMPACTION_UPDATE_INSTRUCTION = (customInstruction = "") => renderPrompt(compaction_update_instruction_default, { customInstruction });
+/**
+* If history starts with a compaction_summary message, return its text so the
+* next compaction can merge new content into it instead of starting fresh.
+* Returns null when no prior summary exists (first compaction in the session).
+*/
+function extractPreviousSummary(history) {
+	const head = history[0];
+	if (head?.origin?.kind !== "compaction_summary") return null;
+	const text = head.content.filter((p) => p.type === "text").map((p) => p.text).join("");
+	return text.length > 0 ? text : null;
+}
 //#endregion
 //#region ../../packages/agent-core/src/flags/registry.ts
 /**
@@ -78993,11 +79186,33 @@ const flags = new FlagResolver();
 //#region ../../packages/agent-core/src/agent/compaction/micro.ts
 const DEFAULT_CONFIG = {
 	keepRecentMessages: 20,
+	keepRecentTokens: 4e4,
+	pruneMinReclaimTokens: 2e4,
 	minContentTokens: 100,
 	minContextUsageRatio: .5,
-	truncatedMarker: "[Old tool result content cleared]"
+	truncatedMarker: "[Old tool result content cleared]",
+	uselessMarker: "[Uneventful result elided]"
 };
 /**
+* Compute the cutoff index: everything at index < cutoff is eligible for
+* truncation. The default floor is `keepRecentMessages` (the message-count
+* protection window). But if the trailing window exceeds `keepRecentTokens`,
+* the cutoff walks forward (toward the tail) until the window fits — so a
+* few giant tool results can't pin the cutoff behind them and starve the
+* prefix of reclaimable content.
+*/
+function computeCutoff(messages, config) {
+	const messageFloor = Math.max(0, messages.length - config.keepRecentMessages);
+	let windowTokens = estimateTokensForMessages(messages.slice(messageFloor));
+	let cutoff = messageFloor;
+	while (cutoff < messages.length && windowTokens > config.keepRecentTokens) {
+		const removed = messages[cutoff];
+		windowTokens -= estimateTokensForMessages([removed]);
+		cutoff += 1;
+	}
+	return cutoff;
+}
+/**
 * Walk the message list and find Read tool calls whose file paths were
 * superseded by a later Read of the same path. Returns a map from the
 * superseded tool call's ID to the file path (for the marker text).
@@ -79047,8 +79262,8 @@ var MicroCompaction = class {
 		};
 	}
 	/** Reset the internal cutoff line (e.g. after a full compaction). */
-	reset(maxCutoff = 0) {
-		this.cutoff = Math.min(this.cutoff, maxCutoff);
+	reset() {
+		this.cutoff = 0;
 	}
 	/** Advance the cutoff line and log the change. */
 	apply(cutoff) {
@@ -79066,14 +79281,19 @@ var MicroCompaction = class {
 		const maxContextTokens = this.agent.config.modelCapabilities.max_context_tokens;
 		const contextTokens = this.agent.context.tokenCountWithPending;
 		if ((maxContextTokens !== void 0 && maxContextTokens > 0 ? contextTokens / maxContextTokens : 0) < config.minContextUsageRatio) return;
-		const nextCutoff = Math.max(0, history.length - config.keepRecentMessages);
+		const nextCutoff = computeCutoff(history, config);
+		if (nextCutoff <= this.cutoff) return;
+		const { beforeTokens, afterTokens } = this.measureEffect(history, nextCutoff);
+		if (beforeTokens - afterTokens < config.pruneMinReclaimTokens) return;
 		this.apply(nextCutoff);
 	}
 	/**
 	* Apply micro-compaction to a message list: replace old tool results
 	* before the cutoff line with truncated markers. Read results for files
 	* that were re-read later get a supersede marker so the model knows
-	* the old content is stale.
+	* the old content is stale. Tool results explicitly marked useless are
+	* elided with a short notice regardless of size, since they carry no
+	* actionable information.
 	*/
 	compact(messages) {
 		const config = this.config;
@@ -79081,7 +79301,16 @@ var MicroCompaction = class {
 		const result = [];
 		let i = 0;
 		for (const msg of messages) {
-			if (i < this.cutoff && msg.role === "tool" && msg.toolCallId !== void 0 && estimateTokensForMessages([msg]) >= config.minContentTokens) {
+			const isUseless = i < this.cutoff && msg.role === "tool" && msg.toolCallId !== void 0 && msg.useless === true;
+			const isOversizedTruncatable = i < this.cutoff && msg.role === "tool" && msg.toolCallId !== void 0 && estimateTokensForMessages([msg]) >= config.minContentTokens;
+			if (isUseless) result.push({
+				...msg,
+				content: [{
+					type: "text",
+					text: config.uselessMarker
+				}]
+			});
+			else if (isOversizedTruncatable) {
 				const marker = msg.toolCallId !== void 0 && superseded.has(msg.toolCallId) ? `[Superseded by a newer read of ${superseded.get(msg.toolCallId)}]` : config.truncatedMarker;
 				result.push({
 					...msg,
@@ -79106,6 +79335,7 @@ var MicroCompaction = class {
 	}
 	measureEffect(messages, cutoff) {
 		let markerTokenCount;
+		let uselessMarkerTokenCount;
 		let truncatedToolResultCount = 0;
 		let beforeTokens = 0;
 		let afterTokens = 0;
@@ -79113,11 +79343,19 @@ var MicroCompaction = class {
 			const message = messages[i];
 			if (message?.role !== "tool" || message.toolCallId === void 0) continue;
 			const contentTokens = estimateTokensForMessages([message]);
-			if (contentTokens < this.config.minContentTokens) continue;
-			markerTokenCount ??= estimateTokens$1(this.config.truncatedMarker);
-			truncatedToolResultCount += 1;
-			beforeTokens += contentTokens;
-			afterTokens += markerTokenCount;
+			const isUseless = message.useless === true;
+			if (!isUseless && contentTokens < this.config.minContentTokens) continue;
+			if (isUseless) {
+				uselessMarkerTokenCount ??= estimateTokens$1(this.config.uselessMarker);
+				truncatedToolResultCount += 1;
+				beforeTokens += contentTokens;
+				afterTokens += uselessMarkerTokenCount;
+			} else {
+				markerTokenCount ??= estimateTokens$1(this.config.truncatedMarker);
+				truncatedToolResultCount += 1;
+				beforeTokens += contentTokens;
+				afterTokens += markerTokenCount;
+			}
 		}
 		return {
 			truncatedToolResultCount,
@@ -80326,7 +80564,8 @@ var ContextMemory = class {
 				this.pushHistory({
 					...message,
 					role: "tool",
-					isError: event.result.isError
+					isError: event.result.isError,
+					useless: event.result.isError !== true && event.result.useless === true ? true : void 0
 				});
 				this.pendingToolResultIds.delete(event.toolCallId);
 				this.flushDeferredMessagesIfToolExchangeClosed();
@@ -122014,7 +122253,7 @@ function optionalBuildString(value) {
 	return typeof value === "string" && value.length > 0 ? value : void 0;
 }
 const SCREAM_BUILD_INFO = {
-	version: optionalBuildString("0.8.1"),
+	version: optionalBuildString("0.8.3"),
 	channel: optionalBuildString(""),
 	commit: optionalBuildString(""),
 	buildTarget: optionalBuildString("darwin-arm64")
@@ -122173,7 +122412,7 @@ function errorMessage(error) {
 //#region src/cli/commands.ts
 function createProgram(version, onMain, onMigrate, onPluginNodeRunner = () => {}, onStreamJson = () => {}, onChannelSetup = () => {}) {
 	const program = new Command(CLI_COMMAND_NAME).description("下一代智能体的起点").version(version, "-V, --version").allowUnknownOption(false).configureHelp({ helpWidth: 100 }).helpOption("-h, --help", "显示帮助。").addHelpText("after", "\n文档：        https://scream-cli.github.io/scream-code/\n");
-	program.addOption(new Option("-S, --session [id]", "恢复会话。带 ID：恢复该会话。不带 ID：交互式选择。").argParser((val) => val === true ? "" : val)).addOption(new Option("-r, --resume [id]").hideHelp().argParser((val) => val === true ? "" : val)).option("-C, --continue", "继续当前工作目录的上一个会话。", false).option("-y, --yolo", "自动批准所有操作。", false).option("--auto", "以自动权限模式启动。", false).addOption(new Option("-m, --model <model>", "本次调用使用的 LLM 模型别名。默认使用 config.toml 中的 default_model。")).addOption(new Option("-p, --prompt <prompt>", "非交互式运行一条提示并打印响应。")).addOption(new Option("--output-format <format>", "提示模式的输出格式。默认为 text。").choices(["text", "stream-json"])).addOption(new Option("--skills-dir <dir>", "从该目录加载技能，而不是自动发现的用户和项目目录。可多次指定。").argParser((value, previous) => [...previous ?? [], value]).default([])).addOption(new Option("--yes").hideHelp().default(false)).addOption(new Option("--auto-approve").hideHelp().default(false)).option("--plan", "以计划模式启动。", false);
+	program.addOption(new Option("-S, --session [id]", "恢复会话。带 ID：恢复该会话。不带 ID：交互式选择。").argParser((val) => val === true ? "" : val)).addOption(new Option("-r, --resume [id]").hideHelp().argParser((val) => val === true ? "" : val)).option("-C, --continue", "继续当前工作目录的上一个会话。", false).option("-y, --yolo", "自动批准所有操作。", false).option("--auto", "以自动权限模式启动。", false).addOption(new Option("-m, --model <model>", "本次调用使用的 LLM 模型别名。默认使用 config.toml 中的 default_model。")).addOption(new Option("-p, --prompt <prompt>", "非交互式运行一条提示并打印响应。")).addOption(new Option("--output-format <format>", "提示模式的输出格式。默认为 text。").choices(["text", "stream-json"])).addOption(new Option("--skills-dir <dir>", "从该目录加载技能，而不是自动发现的用户和项目目录。可多次指定。").argParser((value, previous) => [...previous ?? [], value]).default([])).addOption(new Option("--yes").hideHelp().default(false)).addOption(new Option("--auto-approve").hideHelp().default(false)).option("--plan", "以计划模式启动。", false).option("--wolfpack", "启动时默认开启 WolfPack 批量并发模式。", false);
 	registerExportCommand(program);
 	registerMigrateCommand(program, onMigrate);
 	program.command("stream-json", { hidden: true }).option("--input-format <fmt>", "stream-json").option("--output-format <fmt>", "stream-json").option("--resume <id>", "resume a previous session").option("--model <model>", "model to use").option("--permission-mode <mode>", "permission mode").option("--permission-prompt-tool <mode>", "(ignored, cc-connect compat)").option("--replay-user-messages", "(ignored, cc-connect compat)").option("--verbose", "(ignored, cc-connect compat)").option("--system-prompt <text>", "(ignored, cc-connect compat)").option("--append-system-prompt <text>", "(passed through to agent)").option("--append-system-prompt-file <path>", "(passed through to agent; file contents are read and merged)").option("--allowedTools <list>", "(ignored, cc-connect compat)").option("--disallowedTools <list>", "(ignored, cc-connect compat)").option("--effort <value>", "(ignored, cc-connect compat)").option("--max-context-tokens <N>", "(ignored, cc-connect compat)").option("--skills-dir <dir>", "additional skills directory (repeatable)", (value, previous) => [...previous ?? [], value], []).option("--plugin-dir <dir>", "(ignored, cc-connect compat; repeatable)", (value, previous) => [...previous ?? [], value], []).action((subOpts) => {
@@ -122204,6 +122443,7 @@ function createProgram(version, onMain, onMigrate, onPluginNodeRunner = () => {}
 			yolo: yoloValue,
 			auto: autoValue,
 			plan: raw["plan"],
+			wolfpack: raw["wolfpack"],
 			model: raw["model"],
 			outputFormat: raw["outputFormat"],
 			prompt: raw["prompt"],
@@ -122229,12 +122469,14 @@ function validateOptions(opts) {
 	if (promptMode && opts.yolo) throw new OptionConflictError("--prompt 不能与 --yolo 同时使用。");
 	if (promptMode && opts.auto) throw new OptionConflictError("--prompt 不能与 --auto 同时使用。");
 	if (promptMode && opts.plan) throw new OptionConflictError("--prompt 不能与 --plan 同时使用。");
+	if (promptMode && opts.wolfpack) throw new OptionConflictError("--prompt 不能与 --wolfpack 同时使用。");
 	if (promptMode && opts.session === "") throw new OptionConflictError("在提示模式下不能使用不带 ID 的 --session。");
 	if (opts.continue && opts.session !== void 0) throw new OptionConflictError("--continue 和 --session 不能同时使用。");
 	if (opts.yolo && opts.auto) throw new OptionConflictError("--yolo 不能与 --auto 同时使用。");
 	if (!promptMode && (opts.continue || opts.session !== void 0) && opts.yolo) throw new OptionConflictError("--yolo 不能与 --continue 或 --session 同时使用。");
 	if (!promptMode && (opts.continue || opts.session !== void 0) && opts.auto) throw new OptionConflictError("--auto 不能与 --continue 或 --session 同时使用。");
 	if (!promptMode && (opts.continue || opts.session !== void 0) && opts.plan) throw new OptionConflictError("--plan 不能与 --continue 或 --session 同时使用。");
+	if (!promptMode && (opts.continue || opts.session !== void 0) && opts.wolfpack) throw new OptionConflictError("--wolfpack 不能与 --continue 或 --session 同时使用。");
 	return {
 		options: opts,
 		uiMode: promptMode ? "print" : "shell"
@@ -132838,6 +133080,517 @@ async function handleLikeCommand(host) {
 	host.showStatus("偏好已保存（下次新会话生效）", host.state.theme.colors.success);
 }
 //#endregion
+//#region src/tui/utils/open-url.ts
+function openUrl(url) {
+	const command = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", [
+		"/c",
+		"start",
+		"",
+		url
+	]] : ["xdg-open", [url]];
+	execFile(command[0], command[1], () => {});
+}
+//#endregion
+//#region src/tui/commands/knowledge-store.ts
+let knowledgeStoreInstance;
+async function getKnowledgeStore() {
+	if (knowledgeStoreInstance === void 0) {
+		knowledgeStoreInstance = new KnowledgeStore(getDataDir());
+		await knowledgeStoreInstance.init();
+		knowledgeStoreInstance.setEmbeddingEngine(createFastEmbedEngine());
+	}
+	return knowledgeStoreInstance;
+}
+//#endregion
+//#region src/tui/commands/knowledge-web.ts
+/**
+* /knowledge web — start a local HTTP server and open the browser
+* to display an interactive Cytoscape.js knowledge graph visualization.
+*/
+const activeServers = /* @__PURE__ */ new Set();
+function registerServer(server) {
+	activeServers.add(server);
+	server.on("close", () => {
+		activeServers.delete(server);
+	});
+}
+function closeAllServers() {
+	for (const server of activeServers) server.close();
+}
+process.on("exit", closeAllServers);
+const HTML = `<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Scream 知识图谱</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+html,body{width:100%;height:100%;overflow:hidden;font-family:Inter,"PingFang SC","Microsoft YaHei",system-ui,sans-serif;background:#fff;color:#18181b}
+#container{width:100%;height:100%;position:relative;overflow:hidden}
+svg{position:absolute;top:0;left:0;width:100%;height:100%;pointer-events:none;z-index:1}
+.node{position:absolute;border-radius:10px;display:flex;align-items:center;justify-content:center;text-align:center;cursor:pointer;z-index:2;user-select:none;transition:opacity .25s,box-shadow .25s,border-color .25s;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;padding:0 14px;font-size:12px;line-height:1.3;animation:float 6s ease-in-out infinite}
+.node.entity{background:#fff;border:1.5px solid #d4d4d8;font-weight:600;color:#1a1a1a;box-shadow:0 2px 8px rgba(0,0,0,.06)}
+.node.entity.root{border:2px solid #15803d;background:#f0fdf4;box-shadow:0 4px 20px rgba(21,128,61,.15);font-size:14px}
+.node.entity.expanded{border-color:#15803d;box-shadow:0 2px 12px rgba(21,128,61,.1)}
+.node.event{background:#fafafa;border:1px solid #e5e7eb;font-weight:500;color:#525252;box-shadow:0 1px 4px rgba(0,0,0,.04);border-radius:8px}
+.node.event.expanded{border-color:#22c55e;background:#f8fef9;box-shadow:0 2px 8px rgba(21,128,61,.08)}
+.node.selected{border-color:#15803d !important;background:#f0fdf4 !important;box-shadow:0 0 0 3px rgba(21,128,61,.12),0 4px 16px rgba(21,128,61,.14) !important}
+.node.dimmed{opacity:.12;filter:grayscale(.6)}
+.node:hover{box-shadow:0 4px 16px rgba(0,0,0,.08) !important}
+.edge{stroke:#b0b0b0;stroke-width:.8;fill:none;opacity:.6}
+.edge.animated{stroke:#999;stroke-width:1;stroke-dasharray:6 4;animation:dash 1.2s linear infinite;opacity:.45}
+.edge.dimmed{stroke:#e0e0e0;stroke-width:.4;opacity:.06}
+.edge.highlighted{stroke:#15803d;stroke-width:1.8;opacity:1}
+@keyframes dash{to{stroke-dashoffset:-10}}
+@keyframes float{0%,100%{transform:translateY(0)}50%{transform:translateY(-5px)}}
+#toolbar{position:absolute;left:16px;top:16px;z-index:10;display:flex;align-items:center;gap:10px;background:#fff;border:1px solid #e5e7eb;border-radius:12px;padding:8px 18px;box-shadow:0 2px 8px rgba(0,0,0,.04)}
+#toolbar button{background:#fff;color:#525252;border:1px solid #d4d4d8;padding:5px 16px;border-radius:8px;cursor:pointer;font-size:12px;font-weight:500;transition:all .15s}
+#toolbar button:hover{background:#f0fdf4;border-color:#15803d;color:#15803d}
+#toolbar .sep{width:1px;height:16px;background:#e5e7eb}
+#toolbar .chip{color:#a1a1aa;font-size:11px;letter-spacing:.3px}
+#toolbar .chip b{color:#15803d;font-size:13px;font-weight:700;margin-left:4px}
+#hint{position:absolute;left:16px;bottom:16px;z-index:10;color:#c4c4c4;font-size:11px;letter-spacing:.2px}
+#detail{position:fixed;right:0;top:0;width:380px;height:100vh;background:#fff;border-left:1px solid #e5e7eb;transform:translateX(100%);transition:transform .3s cubic-bezier(.4,0,.2,1);z-index:20;overflow-y:auto;padding:32px 28px;box-shadow:-4px 0 24px rgba(0,0,0,.04)}
+#detail.open{transform:translateX(0)}
+#detail h3{font-size:17px;font-weight:700;color:#18181b;margin-bottom:20px;padding-right:32px;line-height:1.4}
+#detail .field{margin-bottom:18px}
+#detail .field .label{font-size:10px;color:#15803d;text-transform:uppercase;letter-spacing:1px;font-weight:700;margin-bottom:5px}
+#detail .field .value{font-size:13px;color:#525252;line-height:1.6}
+#detail .close{position:absolute;top:20px;right:20px;background:none;border:none;color:#c4c4c4;cursor:pointer;font-size:18px;width:32px;height:32px;display:flex;align-items:center;justify-content:center;border-radius:8px;transition:all .15s}
+#detail .close:hover{color:#18181b;background:#f4f4f5}
+#detail .conn-item{font-size:13px;color:#15803d;cursor:pointer;padding:7px 10px;border-radius:8px;transition:all .15s;border:1px solid transparent}
+#detail .conn-item:hover{background:#f0fdf4;border-color:#bbf7d0}
+#detail .badge{font-size:10px;color:#15803d;background:#f0fdf4;border:1px solid #bbf7d0;border-radius:5px;padding:1px 7px;margin-left:8px;font-weight:500}
+#detail .back-btn{display:inline-flex;align-items:center;gap:5px;background:none;border:1px solid #d4d4d8;color:#525252;padding:6px 14px;border-radius:8px;cursor:pointer;font-size:12px;font-weight:500;margin-bottom:16px;transition:all .15s}
+#detail .back-btn:hover{background:#f0fdf4;border-color:#15803d;color:#15803d}
+#detail .type-tag{display:inline-block;font-size:10px;color:#15803d;background:#f0fdf4;border:1px solid #bbf7d0;border-radius:5px;padding:2px 10px;font-weight:600;margin-bottom:16px;letter-spacing:.3px}
+#detail .divider{height:1px;background:#f0f0f0;margin:18px 0}
+#loading{position:absolute;left:50%;top:50%;transform:translate(-50%,-50%);z-index:30;color:#15803d;font-size:14px;font-weight:500;display:flex;align-items:center;gap:8px}
+#loading .dot{width:6px;height:6px;background:#15803d;border-radius:50%;animation:blink 1.2s ease-in-out infinite}
+#loading .dot:nth-child(2){animation-delay:.2s}
+#loading .dot:nth-child(3){animation-delay:.4s}
+@keyframes blink{0%,80%,100%{opacity:.2}40%{opacity:1}}
+</style>
+</head>
+<body>
+<div id="container"><svg id="edges-svg"></svg></div>
+<div id="toolbar">
+  <span class="chip">实体<b id="stat-ent">0</b></span>
+  <span class="chip">事件<b id="stat-evt">0</b></span>
+  <span class="chip">关系<b id="stat-edg">0</b></span>
+  <span class="sep"></span>
+  <button id="btn-reset">重置</button>
+  <button id="btn-expand">展开全部</button>
+</div>
+<div id="hint">单击展开/收起 · 双击查看详情 · 滚轮缩放 · 拖拽平移</div>
+<div id="detail"><button class="close" id="btn-close">&times;</button><div id="detail-body"></div></div>
+<div id="loading"><span class="dot"></span><span class="dot"></span><span class="dot"></span>加载知识图谱...</div>
+<script>
+(function(){
+  var graphData;
+  var container = document.getElementById('container');
+  var svg = document.getElementById('edges-svg');
+
+  // camera
+  var cam = {x:0,y:0,zoom:1};
+  var W=window.innerWidth, H=window.innerHeight;
+
+  function w2s(wx,wy){return{x:(wx-cam.x)*cam.zoom+W/2,y:(wy-cam.y)*cam.zoom+H/2}}
+  function s2w(sx,sy){return{x:(sx-W/2)/cam.zoom+cam.x,y:(sy-H/2)/cam.zoom+cam.y}}
+
+  // pan & zoom
+  var drag=false,moved=false,dragX,dragY;
+  container.addEventListener('mousedown',function(e){if(e.target!==container&&e.target!==svg)return;drag=true;moved=false;dragX=e.clientX;dragY=e.clientY});
+  window.addEventListener('mousemove',function(e){if(!drag)return;var dx=e.clientX-dragX,dy=e.clientY-dragY;if(Math.abs(dx)>2||Math.abs(dy)>2)moved=true;cam.x-=dx/cam.zoom;cam.y-=dy/cam.zoom;dragX=e.clientX;dragY=e.clientY;render()});
+  window.addEventListener('mouseup',function(){drag=false});
+  container.addEventListener('wheel',function(e){e.preventDefault();var pt=s2w(e.clientX,e.clientY);var f=e.deltaY<0?1.12:1/1.12;cam.zoom=Math.max(.15,Math.min(4,cam.zoom*f));cam.x=pt.x-(e.clientX-W/2)/cam.zoom;cam.y=pt.y-(e.clientY-H/2)/cam.zoom;render()},{passive:false});
+  window.addEventListener('resize',function(){W=window.innerWidth;H=window.innerHeight;render()});
+
+  // layout constants (SAG)
+  var EW=160,EH=40,EVW=170,EVH=40;
+  var ER_START=220,ER_GAP=190,ER_SLOT=200;
+  var VR_START=500,VR_GAP=180,VR_SLOT=220;
+  var ROOT_LIMIT=8;
+  var GA=Math.PI*(3-Math.sqrt(5));
+
+  // state
+  var eById={},evById={};
+  var evByEnt={},entByEv={};
+  var expEnt=new Set(),expEv=new Set();
+  var selId=null;
+  var pos={};
+  var navStack=[];
+
+  // node/edge DOM elements
+  var nodeEls={},edgeEls=[];
+
+  fetch('/api/graph').then(function(r){return r.json()}).then(function(data){
+    graphData=data;
+    document.getElementById('stat-ent').textContent=data.entities.length;
+    document.getElementById('stat-evt').textContent=data.events.length;
+    document.getElementById('stat-edg').textContent=data.edges.length;
+    document.getElementById('loading').style.display='none';
+
+    data.entities.sort(function(a,b){return(b.eventCount||0)-(a.eventCount||0)||a.name.localeCompare(b.name)});
+    data.events.sort(function(a,b){return(a.rank||0)-(b.rank||0)||a.title.localeCompare(b.title)});
+
+    data.entities.forEach(function(e){eById[e.id]=e});
+    data.events.forEach(function(e){evById[e.id]=e});
+
+    data.edges.forEach(function(e){
+      if(!evByEnt[e.entityId])evByEnt[e.entityId]=[];
+      evByEnt[e.entityId].push(e.eventId);
+      if(!entByEv[e.eventId])entByEv[e.eventId]=[];
+      entByEv[e.eventId].push(e.entityId);
+    });
+
+    // default: show all entities, no events expanded
+    graphData.entities.forEach(function(e){expEnt.add(e.id)});
+
+    buildPositions();
+    fitView();
+    rebuildDOM();
+  });
+
+  function buildPositions(){
+    pos={};
+    var root=graphData.entities[0];
+    if(root)pos[root.id]={x:-EW/2,y:-EH/2,root:true};
+    var sec=graphData.entities.slice(1);
+    placeRings(sec.map(function(e){return e.id}),ER_START,ER_GAP,ER_SLOT,EW,EH,-Math.PI/2);
+    placeEvents(graphData.events,-Math.PI/2+Math.PI/12);
+  }
+
+  function placeRings(ids,sr,gap,slot,nw,nh,aoff){
+    var idx=0,ring=0;
+    while(idx<ids.length){
+      var r=sr+ring*gap;
+      var cap=Math.max(6,Math.floor(2*Math.PI*r/slot));
+      for(var s=0;s<cap&&idx<ids.length;s++){
+        var a=aoff+(2*Math.PI*s)/cap;
+        pos[ids[idx]]={x:Math.cos(a)*r-nw/2,y:Math.sin(a)*r-nh/2};
+        idx++;
+      }
+      ring++;
+    }
+  }
+
+  function placeEvents(events,aoff){
+    var occ={};
+    for(var i=0;i<events.length;i++){
+      var da=i*GA;
+      var sl=findSlot(da,aoff,occ);
+      var r=VR_START+sl.ring*VR_GAP;
+      var a=aoff+(2*Math.PI*sl.idx)/sl.cap;
+      pos[events[i].id]={x:Math.cos(a)*r-EVW/2,y:Math.sin(a)*r-EVH/2};
+    }
+  }
+
+  function findSlot(da,aoff,occ){
+    var ring=0;
+    while(true){
+      var r=VR_START+ring*VR_GAP;
+      var cap=Math.max(8,Math.floor(2*Math.PI*r/VR_SLOT));
+      var o=occ[ring]||{};
+      var ds=((Math.round(((da-aoff)/(2*Math.PI))*cap)%cap)+cap)%cap;
+      var f=nearFree(ds,cap,o);
+      if(f!=null){o[f]=true;occ[ring]=o;return{ring:ring,idx:f,cap:cap}}
+      ring++;
+    }
+  }
+
+  function nearFree(d,cap,o){
+    for(var i=0;i<cap;i++){
+      var cs=i===0?[d]:[((d-i)%cap+cap)%cap,((d+i)%cap+cap)%cap];
+      for(var j=0;j<cs.length;j++)if(!o[cs[j]])return cs[j];
+    }
+    return null;
+  }
+
+  function fitView(){
+    var vis=getVisible();
+    var ids=[];
+    vis.entities.forEach(function(id){ids.push(id)});
+    vis.events.forEach(function(id){ids.push(id)});
+    if(!ids.length){cam.x=0;cam.y=0;cam.zoom=1;return}
+    var x0=Infinity,x1=-Infinity,y0=Infinity,y1=-Infinity;
+    ids.forEach(function(id){var p=pos[id];if(!p)return;var w=eById[id]?EW:EVW,h=eById[id]?EH:EVH;if(p.x<x0)x0=p.x;if(p.x+w>x1)x1=p.x+w;if(p.y<y0)y0=p.y;if(p.y+h>y1)y1=p.y+h});
+    cam.x=(x0+x1)/2;cam.y=(y0+y1)/2;
+    cam.zoom=Math.min((W-120)/(x1-x0),(H-120)/(y1-y0),1.2);
+  }
+
+  function getVisible(){
+    var ve=new Set(),vv=new Set();
+    graphData.entities.slice(0,ROOT_LIMIT).forEach(function(e){ve.add(e.id)});
+    expEnt.forEach(function(eid){ve.add(eid);(evByEnt[eid]||[]).forEach(function(v){vv.add(v)})});
+    expEv.forEach(function(eid){vv.add(eid);(entByEv[eid]||[]).forEach(function(e){ve.add(e)})});
+    return{entities:ve,events:vv};
+  }
+
+  function rebuildDOM(){
+    // clear old
+    Object.keys(nodeEls).forEach(function(id){if(nodeEls[id].parentNode)nodeEls[id].parentNode.removeChild(nodeEls[id])});
+    while(svg.firstChild)svg.removeChild(svg.firstChild);
+    nodeEls={};edgeEls=[];
+
+    var vis=getVisible();
+    var visAll=new Set();vis.entities.forEach(function(id){visAll.add(id)});vis.events.forEach(function(id){visAll.add(id)});
+
+    // connection set for highlighting
+    var conn=null;
+    if(selId){
+      conn=new Set();conn.add(selId);
+      graphData.edges.forEach(function(e){
+        if(!visAll.has(e.entityId)||!visAll.has(e.eventId))return;
+        if(e.entityId===selId||e.eventId===selId){conn.add(e.entityId);conn.add(e.eventId)}
+      });
+    }
+
+    // edges
+    graphData.edges.forEach(function(e){
+      if(!visAll.has(e.entityId)||!visAll.has(e.eventId))return;
+      var line=document.createElementNS('http://www.w3.org/2000/svg','line');
+      var isDir=selId&&(e.entityId===selId||e.eventId===selId);
+      var isRel=conn&&conn.has(e.entityId)&&conn.has(e.eventId);
+      var isExp=expEnt.has(e.entityId)||expEv.has(e.eventId);
+      if(isDir)line.setAttribute('class','edge highlighted');
+      else if(isRel)line.setAttribute('class','edge');
+      else if(conn)line.setAttribute('class','edge dimmed');
+      else line.setAttribute('class',isExp?'edge animated':'edge');
+      line.setAttribute('data-src',e.entityId);
+      line.setAttribute('data-tgt',e.eventId);
+      svg.appendChild(line);
+      edgeEls.push(line);
+    });
+
+    // nodes
+    graphData.entities.forEach(function(ent){
+      if(!vis.entities.has(ent.id))return;
+      var el=mkNode(ent.id,ent.name,'entity',pos[ent.id].root,expEnt.has(ent.id));
+      container.appendChild(el);nodeEls[ent.id]=el;
+    });
+    graphData.events.forEach(function(ev){
+      if(!vis.events.has(ev.id))return;
+      var el=mkNode(ev.id,ev.title,'event',false,expEv.has(ev.id));
+      container.appendChild(el);nodeEls[ev.id]=el;
+    });
+
+    // apply dimming
+    if(conn){
+      Object.keys(nodeEls).forEach(function(id){
+        if(conn.has(id))nodeEls[id].classList.remove('dimmed');
+        else nodeEls[id].classList.add('dimmed');
+      });
+      if(selId&&nodeEls[selId])nodeEls[selId].classList.add('selected');
+    }
+
+    render();
+  }
+
+  function mkNode(id,label,kind,root,expanded){
+    var el=document.createElement('div');
+    el.className='node '+kind;
+    if(root)el.classList.add('root');
+    if(expanded)el.classList.add('expanded');
+    el.textContent=label;
+    el.setAttribute('data-id',id);
+    el.setAttribute('data-kind',kind);
+    var dur=5+Math.random()*4;
+    var del=Math.random()*dur;
+    el.style.animationDuration=dur+'s';
+    el.style.animationDelay='-'+del+'s';
+
+    var clickTimer=null;
+    el.addEventListener('click',function(e){
+      e.stopPropagation();
+      if(clickTimer){clearTimeout(clickTimer);clickTimer=null;return}
+      clickTimer=setTimeout(function(){
+        clickTimer=null;
+        toggleNode(id,kind);
+        selId=id;
+        rebuildDOM();
+      },200);
+    });
+    el.addEventListener('dblclick',function(e){
+      e.stopPropagation();
+      if(clickTimer){clearTimeout(clickTimer);clickTimer=null}
+      navStack=[];
+      showDetail(id,kind);
+    });
+    return el;
+  }
+
+  function toggleNode(id,kind){
+    if(kind==='entity'){
+      if(expEnt.has(id)){
+        expEnt.delete(id);
+        var related=new Set(evByEnt[id]||[]);
+        expEv.forEach(function(eid){if(related.has(eid))expEv.delete(eid)});
+      }else expEnt.add(id);
+    }else{
+      if(expEv.has(id))expEv.delete(id);
+      else expEv.add(id);
+    }
+  }
+
+  function render(){
+    // position nodes
+    Object.keys(nodeEls).forEach(function(id){
+      var p=pos[id];if(!p)return;
+      var sp=w2s(p.x,p.y);
+      var w=eById[id]?EW:EVW,h=eById[id]?EH:EVH;
+      var el=nodeEls[id];
+      el.style.left=sp.x+'px';
+      el.style.top=sp.y+'px';
+      el.style.width=(w*cam.zoom)+'px';
+      el.style.height=(h*cam.zoom)+'px';
+      el.style.fontSize=Math.max(8,12*cam.zoom)+'px';
+    });
+
+    // position edges
+    edgeEls.forEach(function(line){
+      var srcId=line.getAttribute('data-src');
+      var tgtId=line.getAttribute('data-tgt');
+      var sp=pos[srcId],tp=pos[tgtId];
+      if(!sp||!tp)return;
+      var s=w2s(sp.x+EW/2,sp.y+EH/2);
+      var t=w2s(tp.x+EVW/2,tp.y+EVH/2);
+      line.setAttribute('x1',s.x);line.setAttribute('y1',s.y);
+      line.setAttribute('x2',t.x);line.setAttribute('y2',t.y);
+    });
+  }
+
+  // click background to deselect
+  container.addEventListener('click',function(e){
+    if(e.target===container||e.target===svg){selId=null;rebuildDOM()}
+  });
+
+  // detail panel
+  function showDetail(id,kind,pushNav){
+    if(pushNav!==false)navStack.push({id:id,kind:kind});
+    var panel=document.getElementById('detail');
+    var body=document.getElementById('detail-body');
+    var html='';
+    if(navStack.length>1)html+='<button class="back-btn" id="btn-back">← 返回</button>';
+    if(kind==='entity'){
+      var e=eById[id];
+      html+='<div class="type-tag">'+esc(e.type)+'</div>';
+      html+='<h3>'+esc(e.name)+'</h3>';
+      html+='<div class="field"><div class="label">关联事件</div><div class="value">'+(e.eventCount||0)+' 个</div></div>';
+      var ce=evByEnt[id]||[];
+      if(ce.length){html+='<div class="divider"></div><div class="field"><div class="label">事件列表</div>';ce.forEach(function(eid){var ev=evById[eid];if(ev)html+='<div class="conn-item" data-id="'+eid+'" data-kind="event">'+esc(ev.title)+'</div>'});html+='</div>'}
+    }else{
+      var ev=evById[id];
+      html+='<h3>'+esc(ev.title)+'</h3>';
+      var ce=entByEv[id]||[];
+      if(ce.length){html+='<div class="divider"></div><div class="field"><div class="label">关联实体</div>';ce.forEach(function(eid){var e=eById[eid];if(e)html+='<div class="conn-item" data-id="'+eid+'" data-kind="entity">'+esc(e.name)+'<span class="badge">'+esc(e.type)+'</span></div>'});html+='</div>'}
+    }
+    body.innerHTML=html;panel.classList.add('open');
+    var backBtn=document.getElementById('btn-back');
+    if(backBtn)backBtn.addEventListener('click',function(){
+      navStack.pop();
+      var prev=navStack[navStack.length-1];
+      if(prev){selId=prev.id;rebuildDOM();showDetail(prev.id,prev.kind,false)}
+      else{panel.classList.remove('open')}
+    });
+    body.querySelectorAll('.conn-item').forEach(function(el){
+      el.addEventListener('click',function(){
+        var nid=el.getAttribute('data-id'),nk=el.getAttribute('data-kind');
+        if(nk==='entity'&&!expEnt.has(nid))expEnt.add(nid);
+        if(nk==='event'&&!expEv.has(nid))expEv.add(nid);
+        selId=nid;rebuildDOM();showDetail(nid,nk);
+      });
+    });
+  }
+
+  function esc(s){if(!s)return'';return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;')}
+
+  document.getElementById('btn-reset').onclick=function(){expEnt.clear();expEv.clear();selId=null;graphData.entities.forEach(function(e){expEnt.add(e.id)});document.getElementById('detail').classList.remove('open');navStack=[];fitView();rebuildDOM()};
+  document.getElementById('btn-expand').onclick=function(){graphData.entities.forEach(function(e){expEnt.add(e.id)});graphData.events.forEach(function(e){expEv.add(e.id)});selId=null;document.getElementById('detail').classList.remove('open');fitView();rebuildDOM()};
+  document.getElementById('btn-close').onclick=function(){document.getElementById('detail').classList.remove('open');navStack=[]};
+})();
+<\/script>
+</body>
+</html>`;
+async function serveGraphJSON(store, res) {
+	try {
+		const [entities, events, edges, sources] = await Promise.all([
+			store.listEntities(),
+			store.listEvents(),
+			store.listEventEntities(),
+			store.listSources()
+		]);
+		const eventEntityMap = /* @__PURE__ */ new Map();
+		for (const edge of edges) {
+			const list = eventEntityMap.get(edge.eventId) ?? [];
+			list.push(edge.entityId);
+			eventEntityMap.set(edge.eventId, list);
+		}
+		const data = {
+			entities: entities.map(({ id, sourceId, type, name, normalizedName, eventCount }) => ({
+				id,
+				sourceId,
+				type,
+				name,
+				normalizedName,
+				eventCount
+			})),
+			events: events.map(({ id, sourceId, documentId, title, rank }) => ({
+				id,
+				sourceId,
+				documentId,
+				title,
+				rank,
+				entityIds: eventEntityMap.get(id) ?? []
+			})),
+			edges,
+			sources: sources.map(({ id, name }) => ({
+				id,
+				name
+			}))
+		};
+		res.writeHead(200, {
+			"Content-Type": "application/json",
+			"Cache-Control": "no-store"
+		});
+		res.end(JSON.stringify(data));
+	} catch (error) {
+		res.writeHead(500, { "Content-Type": "application/json" });
+		res.end(JSON.stringify({ error: String(error) }));
+	}
+}
+function serveHTML(res) {
+	res.writeHead(200, {
+		"Content-Type": "text/html; charset=utf-8",
+		"Cache-Control": "no-store"
+	});
+	res.end(HTML);
+}
+async function handleWeb() {
+	const store = await getKnowledgeStore();
+	const s = await store.stats();
+	if (s.entities === 0 && s.events === 0) throw new Error("知识库为空，请先用 /knowledge 摄入文档");
+	const server = createServer((req, res) => {
+		if (req.url === "/api/graph") {
+			serveGraphJSON(store, res);
+			return;
+		}
+		serveHTML(res);
+	});
+	registerServer(server);
+	await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(0, "127.0.0.1", () => {
+			server.off("error", reject);
+			resolve();
+		});
+	});
+	const url = `http://127.0.0.1:${server.address().port}`;
+	openUrl(url);
+	console.log(`\n  知识图谱: ${url}\n  按 Ctrl+C 停止服务器\n`);
+}
+//#endregion
 //#region src/tui/components/dialogs/knowledge-result-viewer.ts
 /**
 * KnowledgeResultViewer — full-screen scrollable text viewer for /knowledge
@@ -133192,15 +133945,6 @@ function fitExactly$3(line, width) {
 }
 //#endregion
 //#region src/tui/commands/knowledge.ts
-let knowledgeStoreInstance;
-async function getKnowledgeStore() {
-	if (knowledgeStoreInstance === void 0) {
-		knowledgeStoreInstance = new KnowledgeStore(getDataDir());
-		await knowledgeStoreInstance.init();
-		knowledgeStoreInstance.setEmbeddingEngine(createFastEmbedEngine());
-	}
-	return knowledgeStoreInstance;
-}
 function promptTextInput(host, title, opts) {
 	const { promise, resolve } = Promise.withResolvers();
 	const dialog = new TextInputDialogComponent((result) => {
@@ -133505,6 +134249,11 @@ async function handleKnowledgeCommand(host, _args) {
 			value: "stats",
 			label: "📊 统计信息",
 			description: "查看知识库整体统计"
+		},
+		{
+			value: "web",
+			label: "🌐 知识图谱",
+			description: "在浏览器中查看交互式知识图谱"
 		}
 	];
 	const showMenu = () => {
@@ -133522,6 +134271,7 @@ async function handleKnowledgeCommand(host, _args) {
 						else if (value === "search") await handleSearch(host);
 						else if (value === "delete") await handleDelete(host);
 						else if (value === "stats") await handleStats(host);
+						else if (value === "web") await handleWeb();
 					} catch (error) {
 						const msg = error instanceof Error ? error.message : String(error);
 						host.showError(`操作失败: ${msg}`);
@@ -134863,17 +135613,6 @@ function mcpServerStatusKey(server) {
 	]);
 }
 //#endregion
-//#region src/tui/utils/open-url.ts
-function openUrl(url) {
-	const command = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", [
-		"/c",
-		"start",
-		"",
-		url
-	]] : ["xdg-open", [url]];
-	execFile(command[0], command[1], () => {});
-}
-//#endregion
 //#region src/tui/utils/mcp-oauth.ts
 const MAX_AUTH_URL_SET_SIZE = 200;
 var McpOAuthAuthorizationUrlOpener = class {
@@ -142940,6 +143679,7 @@ var SessionManager = class {
 		if (session === void 0) throw new Error("启动会话未初始化。");
 		await this.setSession(session);
 		await this.syncRuntimeState(session);
+		if (startup.wolfpack && !isResumeStartup) await session.setWolfpackMode(true);
 		this.host.state.startupState = "ready";
 		this.host.sessionEventHandler.startSubscription();
 		return {
@@ -145057,7 +145797,7 @@ function createInitialAppState(input) {
 		goalActive: false,
 		goalContinuationCount: 0,
 		ccConnectActive: false,
-		wolfpackMode: false,
+		wolfpackMode: input.cliOptions.wolfpack === true,
 		loopModeEnabled: false,
 		loopPrompt: void 0,
 		loopLimit: void 0,
@@ -145117,6 +145857,7 @@ var ScreamTUI = class {
 				yolo: startupInput.cliOptions.yolo,
 				auto: startupInput.cliOptions.auto,
 				plan: startupInput.cliOptions.plan,
+				wolfpack: startupInput.cliOptions.wolfpack,
 				model: startupInput.cliOptions.model,
 				startupNotice: startupInput.startupNotice
 			},
@@ -146391,6 +147132,14 @@ var ClaudeStreamJsonWriter = class {
 		if (input > 0) this.tokenUsage.input += input;
 		if (output > 0) this.tokenUsage.output += output;
 	}
+	/** Returns the accumulated token usage for the current turn. Used by
+	*  the result event emitter so the final `result` event carries the
+	*  turn's total token usage. Without this, usage was accumulated but
+	*  never emitted — consumers (cc-connect, mobile clients) saw empty
+	*  usage fields. */
+	getTokenUsage() {
+		return { ...this.tokenUsage };
+	}
 	nextMsgId() {
 		this.msgCounter += 1;
 		return `msg_${this.msgCounter.toString(36)}`;
@@ -146637,22 +147386,26 @@ async function runStreamJson(opts) {
 			let activeAgentId;
 			let settled = false;
 			let unsubscribe;
-			const finish = (error) => {
+			const finish = (error, exitCode) => {
 				if (settled) return;
 				settled = true;
 				unsubscribe?.();
 				if (error) {
-					writer.emitResult("error", error.message);
+					writer.emitResult("error", error.message, writer.getTokenUsage());
+					if (exitCode !== void 0) process.exitCode = exitCode;
 					reject(error);
 				} else {
-					writer.emitResult("success", "");
+					writer.emitResult("success", "", writer.getTokenUsage());
 					resolve();
 				}
 			};
 			unsubscribe = session.onEvent((event) => {
 				if (event.type === "error") {
 					if (event.agentId !== "main") return;
-					finish(/* @__PURE__ */ new Error(`${event.code}: ${event.message}`));
+					const errCode = event.code;
+					let exitCode = 1;
+					if (errCode === "provider.auth_error" || errCode === "provider.rate_limit" || errCode === "provider.api_error" || errCode === "provider.connection_error") exitCode = 3;
+					finish(/* @__PURE__ */ new Error(`${event.code}: ${event.message}`), exitCode);
 					return;
 				}
 				if (event.type === "subagent.spawned") {
@@ -146689,9 +147442,14 @@ async function runStreamJson(opts) {
 						writer.updateUsage(inputTotal, event.usage.output ?? 0);
 					}
 				} else if (type === "turn.ended") if (event.reason === "completed") finish();
+				else if (event.reason === "cancelled") finish(/* @__PURE__ */ new Error("Turn cancelled"));
 				else {
+					const errCode = event.error?.code;
 					const errMsg = event.error !== void 0 ? `${event.error.code}: ${event.error.message}` : `Turn ended: ${event.reason}`;
-					finish(new Error(errMsg));
+					let code = 1;
+					if (errCode === "loop.max_steps_exceeded") code = 4;
+					else if (errCode === "provider.auth_error" || errCode === "provider.rate_limit" || errCode === "provider.api_error" || errCode === "provider.connection_error") code = 3;
+					finish(new Error(errMsg), code);
 				}
 			});
 			session.prompt(userText).catch((error) => {
@@ -146712,9 +147470,11 @@ async function runStreamJson(opts) {
 			await turnPromise;
 		}
 	} catch (error) {
-		log.error("stream-json: fatal", { error });
-		writer.emitResult("error", error instanceof Error ? error.message : String(error));
-		process.exitCode = 1;
+		if (process.exitCode === void 0) {
+			log.error("stream-json: fatal", { error });
+			writer.emitResult("error", error instanceof Error ? error.message : String(error), writer.getTokenUsage());
+			process.exitCode = 1;
+		} else log.error("stream-json: turn error (exitCode already set)", { error });
 	} finally {
 		for (const [, pending] of pendingApprovals) pending.resolve({
 			decision: "rejected",