newmark-agent 0.3.12 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/dist/cli-commands.d.ts +1 -0
  2. package/dist/cli-commands.js +11 -2
  3. package/dist/context/domain/types.d.ts +37 -0
  4. package/dist/context/services/context-orchestrator.js +2 -0
  5. package/dist/conversation-utility-host.bundle.cjs +1147 -131
  6. package/dist/conversation-utility-host.js +3 -0
  7. package/dist/core/agent.d.ts +139 -5
  8. package/dist/core/agent.js +962 -82
  9. package/dist/core/agentKernel/agent-loop.js +29 -3
  10. package/dist/core/agentKernel/types.d.ts +7 -0
  11. package/dist/core/agentKernelRunner.d.ts +2 -0
  12. package/dist/core/agentKernelRunner.js +121 -19
  13. package/dist/core/conversationKernel.d.ts +5 -0
  14. package/dist/core/conversationKernel.js +29 -0
  15. package/dist/core/dshCompatibility.d.ts +198 -0
  16. package/dist/core/dshCompatibility.js +600 -0
  17. package/dist/core/electronUtilityAgentClient.d.ts +4 -0
  18. package/dist/core/electronUtilityAgentClient.js +4 -0
  19. package/dist/core/electronUtilityRuntimePool.d.ts +8 -0
  20. package/dist/core/electronUtilityRuntimePool.js +14 -0
  21. package/dist/core/mcpManager.d.ts +1 -0
  22. package/dist/core/mcpManager.js +100 -10
  23. package/dist/core/subagent.d.ts +6 -0
  24. package/dist/core/subagent.js +22 -1
  25. package/dist/core/toolPolicy.d.ts +6 -0
  26. package/dist/core/toolPolicy.js +49 -1
  27. package/dist/core/types.d.ts +1 -1
  28. package/dist/core/utilityAgentProtocol.d.ts +8 -1
  29. package/dist/core/workspace.d.ts +9 -0
  30. package/dist/core/workspace.js +48 -1
  31. package/dist/core/wslAgentClient.d.ts +4 -0
  32. package/dist/core/wslAgentClient.js +4 -0
  33. package/dist/core/wslAgentProtocol.d.ts +8 -1
  34. package/dist/core/wslAgentRuntimePool.d.ts +8 -0
  35. package/dist/core/wslAgentRuntimePool.js +15 -0
  36. package/dist/launcher.js +8 -0
  37. package/dist/llm/provider.d.ts +1 -1
  38. package/dist/llm/provider.js +4 -3
  39. package/dist/main.js +163 -11
  40. package/dist/preload.js +11 -0
  41. package/dist/providers/chat-completions.adapter.js +41 -15
  42. package/dist/providers/provider-adapter.d.ts +3 -0
  43. package/dist/toolchain/registry/tool-registry.d.ts +13 -1
  44. package/dist/toolchain/registry/tool-registry.js +8 -0
  45. package/dist/toolchain/registry-seeder.js +51 -5
  46. package/dist/tools/index.js +11 -2
  47. package/dist/tools/nativeTools.js +5 -1
  48. package/dist/ui/index.html +2530 -205
  49. package/dist/ui/lucide-sprite.svg +26 -0
  50. package/dist/wsl-agent-host.bundle.cjs +1147 -131
  51. package/dist/wsl-agent-host.js +3 -0
  52. package/package.json +4 -2
@@ -326424,7 +326424,27 @@ async function executeToolCalls(toolCalls, context, config, signal) {
326424
326424
  }
326425
326425
  };
326426
326426
  if (config.toolExecution === "parallel") {
326427
- return await Promise.all(toolCalls.map((call) => executeOne(call)));
326427
+ const results2 = [];
326428
+ let index = 0;
326429
+ while (index < toolCalls.length) {
326430
+ const call = toolCalls[index];
326431
+ const tool = tools.find((candidate) => candidate.name === call.name);
326432
+ if (tool && tool.concurrencySafe === true) {
326433
+ const batch = [];
326434
+ while (index < toolCalls.length) {
326435
+ const candidate = toolCalls[index];
326436
+ const candidateTool = tools.find((t3) => t3.name === candidate.name);
326437
+ if (!candidateTool || candidateTool.concurrencySafe !== true) break;
326438
+ batch.push(candidate);
326439
+ index += 1;
326440
+ }
326441
+ results2.push(...await Promise.all(batch.map((c3) => executeOne(c3))));
326442
+ } else {
326443
+ results2.push(await executeOne(call));
326444
+ index += 1;
326445
+ }
326446
+ }
326447
+ return results2;
326428
326448
  }
326429
326449
  const results = [];
326430
326450
  for (const call of toolCalls) results.push(await executeOne(call));
@@ -327548,10 +327568,14 @@ var NATIVE_TOOL_CATALOG = [
327548
327568
  { name: "subagent_send", label: "Subagent send", description: "Persist a message to a peer mailbox.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327549
327569
  { name: "subagent_result", label: "Subagent result", description: "Read peer transcript and result.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327550
327570
  { name: "subagent_close", label: "Subagent close", description: "Close a same-conversation peer agent.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327571
+ { name: "branch_list", label: "Branch list", description: "List all conversation branches and their mailbox/activity status. Only available when branch communication is enabled.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327572
+ { name: "branch_send", label: "Branch send", description: "Send a message to another conversation branch. Only available when branch communication is enabled.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327573
+ { name: "branch_read", label: "Branch read", description: "Read inbound messages and recent activity from another conversation branch. Only available when branch communication is enabled.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327574
+ { name: "branch_create", label: "Branch create", description: "Create a new conversation branch at a historical block position. Only available when branch communication is enabled.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327551
327575
  { name: "linked_plan", label: "Linked plan", description: "Read or conservatively update the conversation-linked Markdown plan.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327552
327576
  { name: "build_history_query", label: "Build history query", description: "Read concrete public work details for one historical Build Block.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327553
327577
  { name: "context_compress", label: "Context compress", description: "Actively compress the LLM context history, leaving the displayed conversation history unchanged.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327554
- { name: "context_history_manage", label: "Context history manage", description: "Inspect, search, restore, or fold LLM context history without touching the displayed conversation history.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327578
+ { name: "context_history_manage", label: "Context history manage", description: "Inspect, search, restore, fold, or unload LLM context history without touching the displayed conversation history. Unload (remove) targets long-term entries only and takes effect after the current Build Block, for subsequent Blocks only.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327555
327579
  { name: "question", label: "Ask question", description: "Ask the user for structured option feedback.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
327556
327580
  { name: "skill_download", label: "Skill download", description: "Download and install a skill.", category: "agent", defaultEnabled: true },
327557
327581
  { name: "skill", label: "Skill", description: "Search enabled skill metadata or load one skill body on demand.", category: "agent", defaultEnabled: true, protected: true, availability: "mode-scoped" },
@@ -328844,6 +328868,7 @@ var ChatCompletionsAdapter = class {
328844
328868
  tool_choice: "auto"
328845
328869
  };
328846
328870
  if (request.reasoningEffort) body.reasoning_effort = request.reasoningEffort;
328871
+ if (request.sessionId) body.session_id = request.sessionId;
328847
328872
  const base2 = request.baseUrl.replace(/\/+$/, "");
328848
328873
  return {
328849
328874
  url: `${base2}/chat/completions`,
@@ -328885,7 +328910,10 @@ var ChatCompletionsAdapter = class {
328885
328910
  }
328886
328911
  const decoder = new TextDecoder();
328887
328912
  let buffer = "";
328888
- let currentToolCall = null;
328913
+ const toolCalls = /* @__PURE__ */ new Map();
328914
+ const toolCallOrder = [];
328915
+ let syntheticToolIndex = 0;
328916
+ let lastToolIndex = 0;
328889
328917
  let contentPolicyBlocked = false;
328890
328918
  let emittedContent = false;
328891
328919
  let emittedTool = false;
@@ -328924,31 +328952,47 @@ var ChatCompletionsAdapter = class {
328924
328952
  emittedContent = true;
328925
328953
  yield { type: "text.delta", delta: textDelta };
328926
328954
  }
328927
- const toolCalls = Array.isArray(delta.tool_calls) ? delta.tool_calls : [];
328928
- for (const raw of toolCalls) {
328955
+ const deltaToolCalls = Array.isArray(delta.tool_calls) ? delta.tool_calls : [];
328956
+ for (const raw of deltaToolCalls) {
328929
328957
  const tc = raw;
328930
328958
  const fn = tc.function && typeof tc.function === "object" ? tc.function : {};
328931
- if (tc.id) {
328932
- if (currentToolCall) {
328933
- emittedTool = true;
328934
- yield { type: "tool_call.completed", id: currentToolCall.id, name: currentToolCall.name, arguments: currentToolCall.arguments };
328935
- }
328959
+ const rawIndex = Number(tc.index);
328960
+ const index = Number.isInteger(rawIndex) && rawIndex >= 0 ? rawIndex : tc.id ? syntheticToolIndex++ : lastToolIndex;
328961
+ lastToolIndex = index;
328962
+ let currentToolCall = toolCalls.get(index);
328963
+ if (!currentToolCall && tc.id) {
328936
328964
  currentToolCall = {
328937
328965
  id: String(tc.id || ""),
328938
328966
  name: openAIToolName(String(fn.name || "")),
328939
- arguments: String(fn.arguments || "")
328967
+ argumentParts: []
328940
328968
  };
328969
+ toolCalls.set(index, currentToolCall);
328970
+ toolCallOrder.push(index);
328941
328971
  yield { type: "tool_call.started", id: currentToolCall.id, name: currentToolCall.name };
328942
- } else if (fn.arguments && currentToolCall) {
328943
- currentToolCall.arguments += String(fn.arguments);
328944
- yield { type: "tool_call.arguments.delta", id: currentToolCall.id, delta: String(fn.arguments) };
328972
+ }
328973
+ if (currentToolCall && fn.name && !currentToolCall.name) currentToolCall.name = openAIToolName(String(fn.name));
328974
+ if (currentToolCall && fn.arguments !== void 0 && fn.arguments !== null) {
328975
+ const argumentDelta = String(fn.arguments);
328976
+ if (argumentDelta) {
328977
+ currentToolCall.argumentParts.push(argumentDelta);
328978
+ yield { type: "tool_call.arguments.delta", id: currentToolCall.id, delta: argumentDelta };
328979
+ }
328945
328980
  }
328946
328981
  }
328947
328982
  }
328948
328983
  }
328949
- if (currentToolCall && currentToolCall.arguments) {
328950
- emittedTool = true;
328951
- yield { type: "tool_call.completed", id: currentToolCall.id, name: currentToolCall.name, arguments: currentToolCall.arguments };
328984
+ if (toolCallOrder.length) {
328985
+ for (const index of toolCallOrder) {
328986
+ const currentToolCall = toolCalls.get(index);
328987
+ if (!currentToolCall) continue;
328988
+ emittedTool = true;
328989
+ yield {
328990
+ type: "tool_call.completed",
328991
+ id: currentToolCall.id,
328992
+ name: currentToolCall.name,
328993
+ arguments: currentToolCall.argumentParts.join("")
328994
+ };
328995
+ }
328952
328996
  } else if (!emittedContent && !emittedTool && contentPolicyBlocked) {
328953
328997
  yield { type: "response.failed", error: "[Error] Content policy refusal (content_filter)." };
328954
328998
  return;
@@ -330047,7 +330091,7 @@ ${responsePath}
330047
330091
  * The emitted request body and StreamToken stream are byte-equivalent to
330048
330092
  * the legacy inlined path.
330049
330093
  */
330050
- async *chatStreamWithToolsV2(model, messages, systemPrompt, temperature, maxTokens, tools, signal, reasoningTier) {
330094
+ async *chatStreamWithToolsV2(model, messages, systemPrompt, temperature, maxTokens, tools, signal, reasoningTier, sessionId) {
330051
330095
  const mode = this.openAITransportMode();
330052
330096
  if (mode === "responses") {
330053
330097
  yield* this.adapterResponsesBridge(model, messages, systemPrompt, temperature, maxTokens, tools, signal, reasoningTier);
@@ -330064,7 +330108,8 @@ ${responsePath}
330064
330108
  temperature,
330065
330109
  maxOutputTokens: maxTokens,
330066
330110
  apiKey: this.apiKey,
330067
- baseUrl: this.cleanBaseUrl()
330111
+ baseUrl: this.cleanBaseUrl(),
330112
+ ...sessionId ? { sessionId } : {}
330068
330113
  };
330069
330114
  const serialized = await adapter.serializeRequest(request);
330070
330115
  serialized.body.stream = mode === "chat" ? false : true;
@@ -330274,7 +330319,7 @@ ${responsePath}
330274
330319
  };
330275
330320
  });
330276
330321
  }
330277
- async *chatStreamWithTools(model, messages, systemPrompt, temperature, maxTokens, tools, signal, reasoningTier) {
330322
+ async *chatStreamWithTools(model, messages, systemPrompt, temperature, maxTokens, tools, signal, reasoningTier, sessionId) {
330278
330323
  if (signal?.aborted) throw abortFailure(signal);
330279
330324
  if (this.protocol() === "anthropic") {
330280
330325
  yield* this.anthropicChatWithTools(model, messages, systemPrompt, temperature, maxTokens, tools, signal);
@@ -330285,7 +330330,7 @@ ${responsePath}
330285
330330
  return;
330286
330331
  }
330287
330332
  if (this.useProviderAdaptersV2) {
330288
- yield* this.chatStreamWithToolsV2(model, messages, systemPrompt, temperature, maxTokens, tools, signal, reasoningTier);
330333
+ yield* this.chatStreamWithToolsV2(model, messages, systemPrompt, temperature, maxTokens, tools, signal, reasoningTier, sessionId);
330289
330334
  return;
330290
330335
  }
330291
330336
  throw new Error("LLMProvider legacy OpenAI streaming was removed in dev-0.3.0: enable provider_adapters_v2 (useProviderAdaptersV2).");
@@ -335120,13 +335165,22 @@ var MODE_SCOPED_TOOLS = /* @__PURE__ */ new Set([
335120
335165
  "build_history_query",
335121
335166
  "context_compress",
335122
335167
  "context_history_manage",
335168
+ "compress_tool_result",
335169
+ "background_tool",
335170
+ "read_tool_result",
335171
+ "goal_manage",
335172
+ "conversation_rename",
335123
335173
  "question",
335124
335174
  "task",
335125
335175
  "subagent_list",
335126
335176
  "subagent_read",
335127
335177
  "subagent_send",
335128
335178
  "subagent_result",
335129
- "subagent_close"
335179
+ "subagent_close",
335180
+ "branch_list",
335181
+ "branch_send",
335182
+ "branch_read",
335183
+ "branch_create"
335130
335184
  ]);
335131
335185
  var PLAN_READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
335132
335186
  "pwd",
@@ -335155,12 +335209,30 @@ var PLAN_READ_ONLY_TOOLS = /* @__PURE__ */ new Set([
335155
335209
  "subagent_send",
335156
335210
  "subagent_result",
335157
335211
  "subagent_close",
335212
+ "branch_list",
335213
+ "branch_read",
335158
335214
  "question"
335159
335215
  ]);
335160
335216
  var PLAN_COMPUTER_USE_ACTIONS = ["observe", "app_list", "app_observe"];
335161
335217
  var PLAN_BROWSER_USE_ACTIONS = ["observe", "navigate", "wait", "extract"];
335162
335218
  var PLAN_COMPUTER_USE_ACTION_SET = new Set(PLAN_COMPUTER_USE_ACTIONS);
335163
335219
  var PLAN_BROWSER_USE_ACTION_SET = new Set(PLAN_BROWSER_USE_ACTIONS);
335220
+ var CONCURRENCY_SAFE_TOOLS = /* @__PURE__ */ new Set([
335221
+ "pwd",
335222
+ "read",
335223
+ "glob",
335224
+ "grep",
335225
+ "web_search",
335226
+ "web_fetch",
335227
+ "git_status",
335228
+ "file_audit",
335229
+ "repo_security_audit"
335230
+ ]);
335231
+ function isConcurrencySafeTool(name50, riskLevel) {
335232
+ const toolName = String(name50 || "").trim();
335233
+ if (CONCURRENCY_SAFE_TOOLS.has(toolName)) return true;
335234
+ return riskLevel === "read";
335235
+ }
335164
335236
  function isReadOnlyScopedToolAction(name50, action) {
335165
335237
  if (name50 === "computer_use") return PLAN_COMPUTER_USE_ACTION_SET.has(action);
335166
335238
  if (name50 === "browser_use") return PLAN_BROWSER_USE_ACTION_SET.has(action);
@@ -335196,7 +335268,7 @@ function evaluateToolPolicy(request) {
335196
335268
  }
335197
335269
  }
335198
335270
  if (request.isSubagent) {
335199
- if (name50 === "skill_download" || name50 === "question" || name50.startsWith("automation_")) {
335271
+ if (name50 === "skill_download" || name50 === "question" || name50.startsWith("automation_") || name50 === "goal_manage" || name50 === "conversation_rename") {
335200
335272
  return { ...base2, allowed: false, reason: `[Subagent sandbox] Tool '${name50}' is disabled for peer agents.` };
335201
335273
  }
335202
335274
  }
@@ -336215,9 +336287,9 @@ var ToolExecutor = class {
336215
336287
  t3("subagent_result", "Return the persisted transcript, mailbox summary, status, and latest result for a peer agent. Target by exact id (preferred) or name.", { id: { type: "string", description: "Exact peer id from subagent_list." }, name: { type: "string", description: "Convenience peer name." } }, []),
336216
336288
  t3("subagent_close", "Close a same-conversation peer. Root can close any peer; a peer can close only itself. Target by exact id (preferred) or name.", { id: { type: "string", description: "Exact peer id from subagent_list." }, name: { type: "string", description: "Convenience peer name." } }, []),
336217
336289
  t3("linked_plan", "Read or update the current conversation linked Markdown plan. Update requires the current expected_revision.", { action: { type: "string", enum: ["get", "update"] }, markdown: { type: "string" }, expected_revision: { type: "number" } }, ["action"]),
336218
- t3("build_history_query", "Read the concrete public work details of one historical Build Block. The prompt already exposes user input, final summary, and completion status; call this read-only tool only when the user asks what specifically happened. Select by newest-to-oldest history_index, or by run_id returned from an earlier query.", { history_index: { type: "number", minimum: 1, description: "1-based historical Build Block index from the request ledger; 1 is the newest previous task." }, run_id: { type: "string", description: "Exact run id returned by an earlier build_history_query result." }, max_events: { type: "number", minimum: 1, maximum: 200, description: "Maximum trailing public work events; defaults to 80." } }, []),
336290
+ t3("build_history_query", "Read the concrete public work details of one historical Build Block. The prompt already exposes user input, final summary, and completion status; call this read-only tool only when the user asks what specifically happened. Select by newest-to-oldest history_index, or by run_id returned from an earlier query. Every activity/guide content is bounded to max_chars (default 2000) to keep the read lean and cache-friendly.", { history_index: { type: "number", minimum: 1, description: "1-based historical Build Block index from the request ledger; 1 is the newest previous task." }, run_id: { type: "string", description: "Exact run id returned by an earlier build_history_query result." }, max_events: { type: "number", minimum: 1, maximum: 200, description: "Maximum trailing public work events; defaults to 80." }, max_chars: { type: "number", minimum: 100, maximum: 4e3, description: "Per-event/per-guide content character bound; defaults to 2000." } }, []),
336219
336291
  t3("context_compress", "Actively compress the LLM context history for this conversation. This collapses older history entries into a concise summary while preserving the recent tail, which reduces context tokens and cost. IMPORTANT: it affects only the LLM context (what the model sees); the displayed conversation history shown to the user is never altered. Call this when the conversation is long, token pressure is high, or you judge that older turns are no longer needed in full. Idempotent and safe: repeated calls produce incremental summaries.", { keep_recent: { type: "number", minimum: 2, maximum: 60, description: "Recent message count to keep uncompressed at the tail. Defaults to the configured keep_recent_messages." }, force: { type: "boolean", description: "Compress even if the context is not yet over the automatic threshold. Defaults to false." } }, []),
336220
- t3("context_history_manage", "Manage the LLM context history for this conversation without affecting the displayed conversation history. This is the active context-management surface. The hot cache stays bounded; evicted folded segments remain in a conversation-isolated append-only cold archive and are loaded only by explicit search/read/restore calls. Actions: list returns a bounded index of current context entries; remove deletes one current entry; summarize folds a contiguous current range; restore reinserts a folded segment when its summary marker is still present; search finds matching hot or archived segments; read returns one bounded segment without injecting the whole archive; status reports budgets, hot cache, cold archive, and the protected recent zone. The recent context tail and last user message are protected from remove/summarize unless dangerous is true.", {
336292
+ t3("context_history_manage", "Manage the LLM context history for this conversation without affecting the displayed conversation history. This is the active context-management surface. The hot cache stays bounded; evicted folded segments remain in a conversation-isolated append-only cold archive and are loaded only by explicit search/read/restore calls. Actions: list returns a bounded index of current context entries; remove declares one long-term entry for unload (see below); summarize folds a contiguous current range; restore reinserts a folded segment when its summary marker is still present; search finds matching hot or archived segments; read returns one bounded segment without injecting the whole archive; status reports budgets, hot cache, cold archive, the protected recent zone, and pending removals. The recent context tail and last user message are protected from remove/summarize unless dangerous is true. For cache-optimization, remove ONLY targets long-term history (never the protected recent tail or last user message) and does NOT unload immediately: the declared entry stays in context for the rest of the current Build Block so the provider prefix cache stays stable, then is physically removed when the Block ends \u2014 applying to subsequent Blocks only.", {
336221
336293
  action: { type: "string", enum: ["list", "remove", "summarize", "restore", "search", "read", "status"], description: "list current entries; remove one; summarize a range; restore by restore_id; search hot/cold folded segments; read one bounded folded segment; status report context budgets and storage." },
336222
336294
  position: { type: "number", minimum: 0, description: "0-based context entry index for remove, or the start of the range for summarize." },
336223
336295
  to: { type: "number", minimum: 0, description: "0-based inclusive end of the range for summarize. Defaults to position." },
@@ -336229,6 +336301,15 @@ var ToolExecutor = class {
336229
336301
  max_chars: { type: "number", minimum: 1e3, maximum: 6e4, description: "Maximum message-content characters returned by read (default 12000)." },
336230
336302
  dangerous: { type: "boolean", description: "Set true to override the protected recent-message zone and allow removing/summarizing entries that include the recent context tail or the last user message." }
336231
336303
  }, ["action"]),
336304
+ t3("branch_list", 'List all branches in this conversation and their mailbox/activity status. Only available when the conversation was created with "\u5141\u8BB8\u5206\u652F\u4EA4\u6D41" (allow branch communication) enabled. Returns each branch id, active flag, source message index, message/history/workRun counts, and unread mailbox counts so you can decide who to message or read next.', {}, []),
336305
+ t3("branch_send", "Send a message to another branch in this conversation. Only available when branch communication is enabled. The message is persisted to the target branch mailbox and becomes visible to that branch on its next branch_read. Use this to coordinate work across concurrently running branches. A branch cannot message itself.", { to_branch: { type: "string", description: "Target branch id (from branch_list)." }, message: { type: "string", description: "Message body to deliver." }, kind: { type: "string", enum: ["message", "directive", "result"], description: "Message kind; defaults to message." }, correlation_id: { type: "string", description: "Optional correlation id for reply tracking." }, reply_to: { type: "string", description: "Optional message id this message replies to." } }, ["to_branch", "message"]),
336306
+ t3("branch_read", "Read inbound messages and recent activity from another branch in this conversation. Only available when branch communication is enabled. Marks inbound messages read. Returns the branch metadata, inbound messages, and recent Build Block activity (final results and recent events).", { branch: { type: "string", description: "Branch id to read (from branch_list)." }, max_chars: { type: "number", minimum: 100, maximum: 16e3, description: "Maximum characters for final-result text; defaults to 8000." } }, ["branch"]),
336307
+ t3("branch_create", "Create a new conversation branch at a historical block position (a user message index) with a new initial instruction. Only available when branch communication is enabled. The new branch becomes an additional running branch. Use this to spin off alternative work from a past point without disturbing existing branches.", { message_index: { type: "number", minimum: 0, description: "0-based index of a user message in the conversation history (the historical block position to branch from)." }, prompt: { type: "string", description: "The new branch initial instruction (becomes the branch user message)." }, message_id: { type: "string", description: "Optional exact message id to anchor the branch target." }, guide_id: { type: "string", description: "Optional guide id to anchor the branch target." } }, ["message_index", "prompt"]),
336308
+ t3("compress_tool_result", "Compress ONE oversized tool result into a concise, format-preserving summary using the model, instead of hard truncation. Pass the artifact_id returned inline by an oversized tool result (the full raw content stays out of context, on disk). Use this when a read/grep/bash result reported an oversized_tool_result marker and you want to recover its structure (JSON arrays, table rows, code blocks, identifiers, error strings) as a compact summary. This runs an isolated compression call whose system prefix does not touch the conversation prompt cache, so it does not disturb cache hit rate.", { artifact_id: { type: "string", description: "The artifact_id from the oversized_tool_result marker returned inline by an oversized tool result." }, content: { type: "string", description: "Optional fallback: a SHORT raw result text to compress directly when no artifact_id exists." }, format_hint: { type: "string", description: 'Optional description of the structure to preserve verbatim (e.g. "keep JSON arrays and file paths", "keep table columns and error strings").' } }, []),
336309
+ t3("background_tool", "Run a tool call in the background WITHOUT blocking the conversation turn. Pass the target tool name and its arguments; this tool returns a background_id IMMEDIATELY, and the real tool keeps running in the background. The result is persisted and can be retrieved later with read_tool_result. Use this for long-running or non-critical tools (bash, web_fetch, long read/grep) so the conversation continues without waiting. The background result stays OUT of context until you explicitly read it, preserving prompt-cache hit rate. Orchestration/flow/subagent/question tools cannot be backgrounded.", { tool: { type: "string", description: "The tool name to run in the background (e.g. bash, web_fetch, read, grep)." }, args: { type: "object", description: "The arguments object for the target tool, matching its normal schema." } }, ["tool"]),
336310
+ t3("read_tool_result", "Read the result of a background tool. Pass the background_id returned by background_tool. When status is running, returns a running marker; when done, returns the persisted result (optionally release it from storage after reading); when error, returns the failure. Background results are released from storage only when you set release=true.", { background_id: { type: "string", description: "The background_id returned by background_tool." }, release: { type: "boolean", description: "Set true to release the persisted result from storage after reading it." } }, ["background_id"]),
336311
+ t3("goal_manage", "Actively manage the persistent Goal state for this conversation. You may enter Goal mode, update (edit) its objective, mark it complete, or exit Goal mode yourself. Call this when the user asks you to pursue a persistent objective, when the objective changes, when you have verified the objective is genuinely achieved, or when you judge the Goal is no longer needed and should be cleared. This is the agent-side state control that mirrors the GUI goal panel controls. enter/update require objective; complete marks the objective verified and exits Goal mode; exit clears the Goal (and returns to Build mode) without claiming completion.", { action: { type: "string", enum: ["enter", "update", "complete", "exit"], description: "enter=enter Goal mode and set the objective; update=edit the objective (records a change); complete=mark the objective verified-achieved and exit Goal mode; exit=clear the Goal and return to Build mode without claiming completion." }, objective: { type: "string", description: "The Goal objective text. Required for enter and update." }, reason: { type: "string", description: "Optional one-line reason for the state change, recorded for audit." } }, ["action"]),
336312
+ t3("conversation_rename", "Rename the CURRENT conversation to a concise, descriptive title you choose. On the FIRST Build Block of a NEW conversation the runtime asks you to call this once so the conversation list shows a meaningful name instead of an auto-generated one. Keep the title short (a few words) and cache-friendly: a concrete noun phrase describing the task, never a sentence or quoted prompt.", { title: { type: "string", description: 'The new conversation title (a short noun phrase, e.g. "Fix TUI color leak", "Add goal_manage tool").' } }, ["title"]),
336232
336313
  t3("question", "Ask user a multiple-choice question", { questions: { type: "array" } }, ["questions"]),
336233
336314
  t3("skill_download", "Download a skill", { name: { type: "string" }, source: { type: "string" } }, ["name", "source"]),
336234
336315
  t3("skill", "Search enabled skill metadata or load one exact skill body on demand. Use query when unsure, then name to load the selected skill.", { query: { type: "string", maxLength: 200 }, name: { type: "string", maxLength: 200 } }, []),
@@ -337734,6 +337815,28 @@ function normalizeHostWorkspacePath(input, platform = process.platform) {
337734
337815
  }
337735
337816
  return path16.posix.resolve(raw || ".");
337736
337817
  }
337818
+ function isPathInside(parent, child) {
337819
+ try {
337820
+ const relative6 = path16.relative(path16.resolve(parent), path16.resolve(child));
337821
+ return relative6 === "" || !!relative6 && !relative6.startsWith("..") && !path16.isAbsolute(relative6);
337822
+ } catch {
337823
+ return false;
337824
+ }
337825
+ }
337826
+ function isProtectedInstallWorkspacePath(candidate) {
337827
+ const value = String(candidate || "").trim();
337828
+ if (!value) return false;
337829
+ const roots = [path16.dirname(process.execPath)];
337830
+ if (process.platform === "win32") {
337831
+ roots.push(
337832
+ process.env.ProgramFiles || "",
337833
+ process.env["ProgramFiles(x86)"] || "",
337834
+ process.env.ProgramW6432 || ""
337835
+ );
337836
+ }
337837
+ const resolved = path16.resolve(value);
337838
+ return roots.filter(Boolean).some((root2) => isPathInside(root2, resolved));
337839
+ }
337737
337840
  var WorkspaceManager = class {
337738
337841
  constructor(rootPath, config, options = {}) {
337739
337842
  this.rootPath = rootPath;
@@ -337799,9 +337902,14 @@ var WorkspaceManager = class {
337799
337902
  }
337800
337903
  try {
337801
337904
  const ext = JSON.parse(fs14.readFileSync(path16.join(w, "External.json"), "utf-8"));
337802
- this.external = Array.isArray(ext) ? ext.map((item) => this.normalizeExternalWorkspace(item, (changed) => {
337905
+ const normalized = Array.isArray(ext) ? ext.map((item) => this.normalizeExternalWorkspace(item, (changed) => {
337803
337906
  externalChanged = externalChanged || changed;
337804
337907
  })) : [];
337908
+ this.external = normalized.filter((workspace) => {
337909
+ if (!isProtectedInstallWorkspacePath(workspace.path)) return true;
337910
+ externalChanged = true;
337911
+ return false;
337912
+ });
337805
337913
  } catch {
337806
337914
  }
337807
337915
  for (const entry of fs14.readdirSync(w, { withFileTypes: true })) {
@@ -337985,6 +338093,11 @@ var WorkspaceManager = class {
337985
338093
  }
337986
338094
  restoreCurrent() {
337987
338095
  const stateCurrent = this.readState().current || null;
338096
+ if (stateCurrent?.path && isProtectedInstallWorkspacePath(stateCurrent.path)) {
338097
+ this.current = null;
338098
+ this.saveState();
338099
+ return;
338100
+ }
337988
338101
  const stored = this.findWorkspace(stateCurrent);
337989
338102
  if (stored) {
337990
338103
  this.current = stored;
@@ -338384,7 +338497,7 @@ var SubagentManager = class {
338384
338497
  fromAgentId,
338385
338498
  toAgentId: target.id,
338386
338499
  kind,
338387
- body,
338500
+ body: truncateText(body, 32e3),
338388
338501
  correlationId: details.correlationId,
338389
338502
  replyTo: details.replyTo,
338390
338503
  createdAt: now()
@@ -338636,6 +338749,24 @@ var SubagentManager = class {
338636
338749
  if (!record) return "";
338637
338750
  return record.result || record.messages.filter((message) => message.role === "assistant").map((message) => message.content).join("\n");
338638
338751
  }
338752
+ /**
338753
+ * 有界结果 transcript:subagent_result 注入主 Agent 上下文时,不再放大完整
338754
+ * 消息历史(含所有中间 tool call/result 洪水)。只保留最近若干条非 tool 消息,
338755
+ * 按字符上限截断,杜绝上下文回归。完整历史按需走 subagent_read(max_chars)。
338756
+ */
338757
+ boundedResultTranscript(idOrName) {
338758
+ const record = this.get(idOrName);
338759
+ if (!record) return "";
338760
+ const MAX_MSG = 8;
338761
+ const MAX_CHARS = 8e3;
338762
+ const messages = record.messages.filter((message) => message.role === "assistant" || message.role === "user" || message.role === "system").slice(-MAX_MSG).map((message) => `[${message.role}] ${truncateText(String(message.content || ""), 1200)}`);
338763
+ let text = messages.join("\n");
338764
+ if (text.length > MAX_CHARS) {
338765
+ text = text.slice(0, MAX_CHARS) + `
338766
+ [...transcript truncated: ${record.messages.length} total messages, ${record.messages.length - MAX_MSG} older omitted; use subagent_read for full history...]`;
338767
+ }
338768
+ return text || "(no transcript)";
338769
+ }
338639
338770
  listActive() {
338640
338771
  return this.listAll().filter((item) => item.status !== "closed");
338641
338772
  }
@@ -339534,7 +339665,15 @@ var ToolRegistry = class {
339534
339665
  schemaHash: sha256({ inputSchema: input.inputSchema, outputSchema: input.outputSchema, name: input.name, version: input.version }),
339535
339666
  implementationHash: input.implementationHash,
339536
339667
  cacheGroup: input.cacheGroup || `${input.namespace}.${input.name}`,
339537
- enabled: true
339668
+ enabled: true,
339669
+ execute: input.execute,
339670
+ isConcurrencySafe: input.isConcurrencySafe,
339671
+ render: input.render,
339672
+ presentationMeta: input.presentationMeta,
339673
+ finalizeContent: input.finalizeContent,
339674
+ timeoutMs: input.timeoutMs,
339675
+ presentCall: input.presentCall,
339676
+ presentResult: input.presentResult
339538
339677
  };
339539
339678
  this.tools.set(input.toolId, descriptor);
339540
339679
  return descriptor;
@@ -339811,13 +339950,20 @@ function inferRiskLevel(name50, description, annotations) {
339811
339950
  if (DESTRUCTIVE_PATTERN.test(text)) return "destructive";
339812
339951
  if (/^(web_|browser_|ssh_|gh_)/.test(name50) || /^git_(clone|pull|fetch)$/.test(name50)) return "external";
339813
339952
  if (READ_TOOL_PATTERN.test(name50)) return "read";
339953
+ if (/^(get_|list_|query_|inspect_|read_)/.test(name50) && !/_(create|update|set|write|delete|remove|run|execute|send|save|push|edit|toggle|define|stop|start)$/.test(name50)) return "read";
339814
339954
  return "write";
339815
339955
  }
339816
339956
  function inferIdempotency(name50) {
339817
- if (/^(bash|computer_use|browser_use|run|exec|execute|task)$/.test(name50)) return "non_idempotent";
339957
+ if (/^(bash|pwsh|powershell|cmd|shell|terminal|computer_use|browser_use|run|exec|execute|task)$/.test(name50)) return "non_idempotent";
339818
339958
  if (/^(write|edit|append|send|save|create|update|set|put|register|patch)/.test(name50)) return "conditionally_idempotent";
339819
339959
  return void 0;
339820
339960
  }
339961
+ function compactDescription(description, fallback) {
339962
+ const clean = String(description || "").replace(/\s+/g, " ").trim();
339963
+ if (!clean) return fallback;
339964
+ const firstSentence = clean.split(/(?<=[.!?])\s+/)[0] || clean;
339965
+ return firstSentence.slice(0, 120);
339966
+ }
339821
339967
  function resolveDefinition(definition) {
339822
339968
  if (!definition || typeof definition !== "object") return null;
339823
339969
  const record = definition;
@@ -339830,11 +339976,31 @@ function resolveDefinition(definition) {
339830
339976
  };
339831
339977
  }
339832
339978
  if (typeof record.name === "string") {
339979
+ const rawParameters = record.inputSchema ?? record.parameters;
339980
+ const rawExecute = record.execute;
339981
+ const rawConcurrencySafe = record.isConcurrencySafe;
339982
+ const rawOutput = record.output;
339983
+ const outputSchema = record.outputSchema ?? rawOutput?.schema;
339984
+ const render = rawOutput?.render;
339985
+ const presentationMeta = rawOutput?.presentationMeta;
339986
+ const finalizeContent = record.finalizeContent;
339987
+ const timeoutMs = record.timeoutMs;
339988
+ const presentCall = record.presentCall;
339989
+ const presentResult = record.presentResult;
339833
339990
  return {
339834
339991
  name: record.name,
339835
339992
  description: typeof record.description === "string" ? record.description : "",
339836
- parameters: record.inputSchema,
339837
- annotations: record.annotations
339993
+ parameters: rawParameters,
339994
+ outputSchema,
339995
+ annotations: record.annotations,
339996
+ execute: typeof rawExecute === "function" ? rawExecute : void 0,
339997
+ isConcurrencySafe: typeof rawConcurrencySafe === "function" ? rawConcurrencySafe : void 0,
339998
+ render: typeof render === "function" ? render : void 0,
339999
+ presentationMeta: typeof presentationMeta === "function" ? presentationMeta : void 0,
340000
+ finalizeContent: typeof finalizeContent === "function" ? finalizeContent : void 0,
340001
+ timeoutMs: typeof timeoutMs === "number" ? timeoutMs : void 0,
340002
+ presentCall: typeof presentCall === "function" ? presentCall : void 0,
340003
+ presentResult: typeof presentResult === "function" ? presentResult : void 0
339838
340004
  };
339839
340005
  }
339840
340006
  return null;
@@ -339873,7 +340039,7 @@ function seedToolchainFromDefinitions(definitions, options) {
339873
340039
  if (riskLevel === "destructive" || riskLevel === "external" && entry.input.riskLevel !== "destructive") {
339874
340040
  entry.input.riskLevel = riskLevel;
339875
340041
  }
339876
- entry.resolved.push({ name: definition.name, riskLevel, parameters: definition.parameters });
340042
+ entry.resolved.push({ ...definition, riskLevel, domain });
339877
340043
  }
339878
340044
  for (const [domain, entry] of byDomain) {
339879
340045
  const requiredPermissions = entry.input.riskLevel === "destructive" ? ["destructive"] : entry.input.riskLevel === "external" ? ["network"] : entry.input.riskLevel === "write" ? ["workspace_write"] : [];
@@ -339892,13 +340058,22 @@ function seedToolchainFromDefinitions(definitions, options) {
339892
340058
  namespace,
339893
340059
  name: tool.name,
339894
340060
  version: version2,
339895
- shortDescription: tool.name,
339896
- fullDescription: `${tool.name} (${domain})`,
340061
+ shortDescription: compactDescription(tool.description, tool.name),
340062
+ fullDescription: tool.description && tool.description.trim() ? tool.description : `${tool.name} (${domain})`,
339897
340063
  inputSchema: tool.parameters ?? { type: "object", properties: {}, required: [] },
340064
+ outputSchema: tool.outputSchema,
339898
340065
  riskLevel: tool.riskLevel,
339899
340066
  idempotency,
339900
340067
  requiredPermissions: required,
339901
- implementationHash: sha256(tool.name)
340068
+ implementationHash: sha256(tool.name),
340069
+ execute: tool.execute,
340070
+ isConcurrencySafe: tool.isConcurrencySafe,
340071
+ render: tool.render,
340072
+ presentationMeta: tool.presentationMeta,
340073
+ finalizeContent: tool.finalizeContent,
340074
+ timeoutMs: tool.timeoutMs,
340075
+ presentCall: tool.presentCall,
340076
+ presentResult: tool.presentResult
339902
340077
  };
339903
340078
  core.registry.register(input);
339904
340079
  toolIds.push(tool.name);
@@ -340311,6 +340486,8 @@ async function runAgentKernel(agent) {
340311
340486
  stream2.push({ type: "start", partial });
340312
340487
  let text = "";
340313
340488
  let thinking = "";
340489
+ let thinkingStarted = false;
340490
+ let thinkingRecorded = false;
340314
340491
  let contentIndex = 0;
340315
340492
  const finalContent = [];
340316
340493
  let textStarted = false;
@@ -340330,12 +340507,12 @@ async function runAgentKernel(agent) {
340330
340507
  const includeBootstrap = providerRequestCount === 0 || compressionCompleted;
340331
340508
  const requestSystemPrompt = [
340332
340509
  context.systemPrompt || "",
340333
- buildRequestTaskFocus(currentAgent, context.messages, {
340510
+ includeBootstrap || compressionCompleted ? buildRequestTaskFocus(currentAgent, context.messages, {
340334
340511
  includeBootstrap,
340335
340512
  compressionCompleted,
340336
340513
  activeTools: context.tools || [],
340337
340514
  toolCatalog: currentAgent.cachedToolDefinitions()
340338
- })
340515
+ }) : ""
340339
340516
  ].filter(Boolean).join("\n\n");
340340
340517
  providerRequestCount += 1;
340341
340518
  if (compressionCompleted) bootstrappedCompressionAt = currentCompressionAt;
@@ -340353,7 +340530,8 @@ async function runAgentKernel(agent) {
340353
340530
  maxTokens,
340354
340531
  toProviderToolDefinitions(context.tools || []),
340355
340532
  options?.signal,
340356
- reasoningEffort
340533
+ reasoningEffort,
340534
+ currentAgent.config.getBool("context", "provider_session_id") ? currentAgent.activeConversationId : void 0
340357
340535
  )) {
340358
340536
  if (!firstTokenRecorded && (token.type === "text" && token.text || token.type === "tool_call" && token.toolCall)) {
340359
340537
  firstTokenRecorded = true;
@@ -340374,10 +340552,18 @@ async function runAgentKernel(agent) {
340374
340552
  if (token.reasoningContent) {
340375
340553
  const delta = token.reasoningContent.slice(thinking.length);
340376
340554
  thinking = token.reasoningContent;
340555
+ if (!thinkingStarted) {
340556
+ thinkingStarted = true;
340557
+ currentAgent.emitWorkEvent({ type: "thought", content: "" });
340558
+ }
340377
340559
  if (delta) {
340378
340560
  stream2.push({ type: "thinking_delta", contentIndex, delta, partial: assistantMessage2(model, thinking ? [{ type: "text", text }] : [], "stop") });
340379
340561
  }
340380
340562
  }
340563
+ if (thinkingStarted && !thinkingRecorded && (token.type === "text" && token.text || token.type === "tool_call" && token.toolCall)) {
340564
+ thinkingRecorded = true;
340565
+ currentAgent.emitWorkEvent({ type: "thought_result", content: thinking });
340566
+ }
340381
340567
  if (token.type === "text" && token.text) {
340382
340568
  if (currentAgent.isLlmErrorText(token.text)) {
340383
340569
  text += token.text;
@@ -340417,6 +340603,10 @@ async function runAgentKernel(agent) {
340417
340603
  }
340418
340604
  }
340419
340605
  if (process.env.NEWMARK_PROVIDER_DIAGNOSTICS === "1") console.error("[NewmarkKernel] provider-loop-complete");
340606
+ if (thinkingStarted && !thinkingRecorded) {
340607
+ thinkingRecorded = true;
340608
+ currentAgent.emitWorkEvent({ type: "thought_result", content: thinking });
340609
+ }
340420
340610
  if (options?.signal?.aborted) {
340421
340611
  const aborted = assistantMessage2(model, text ? [{ type: "text", text }] : [], "aborted");
340422
340612
  stream2.push({ type: "done", reason: "aborted", message: aborted });
@@ -340522,15 +340712,19 @@ function buildBuildContextBootstrap(agent, messages, options) {
340522
340712
  const activeNames = activeTools.map(toolDefinitionName).filter((name50) => name50 && name50 !== TOOL_PROVISION_NAME);
340523
340713
  const catalogLines = catalog.filter((definition) => toolDefinitionName(definition) !== TOOL_PROVISION_NAME).map((definition) => `- ${toolDefinitionName(definition)}: ${compactToolDescription(toolDefinitionDescription(definition))}`);
340524
340714
  const retainedMessages = messages.length;
340525
- const compressionSummary = options.compressionCompleted ? compactTaskLedgerText(agent.lastCompression?.summary || "(compression summary unavailable)", 4e3) : "";
340715
+ const renameDirective = agent.shouldPromptConversationRename() ? [
340716
+ "## Conversation Naming Bootstrap",
340717
+ "This is the FIRST Build Block of a NEW conversation whose title is still auto-generated. Call conversation_rename ONCE now with a short, concrete noun-phrase title describing this task (a few words, no sentences, no quoted prompts). This is a one-time, cache-friendly step so the conversation list shows a meaningful name."
340718
+ ] : [];
340526
340719
  return [
340527
340720
  "## Build Context Bootstrap",
340528
- options.compressionCompleted ? "Injection reason: context compression just completed; this is the first provider request using the compacted context." : "Injection reason: this is the first provider request of a new Build.",
340721
+ "Injection reason: this is the first provider request of a new Build.",
340529
340722
  "This block is request-only runtime metadata. Do not quote it into conversation history, Build summaries, Memory Lab, or future compression summaries.",
340530
340723
  "Current context boundary:",
340531
- options.compressionCompleted ? `- Compacted historical context: ${JSON.stringify(compressionSummary)}` : "- The durable conversation messages in this provider request are the current uncompressed context; use them directly and do not reinterpret them as a backlog.",
340724
+ "- The durable conversation messages in this provider request are the current authoritative context; use them directly and do not reinterpret them as a backlog.",
340532
340725
  `- Retained non-system request messages: ${retainedMessages}. The latest real user-role message remains authoritative.`,
340533
340726
  buildConversationTaskLedger(agent),
340727
+ ...renameDirective,
340534
340728
  "## Tool Awareness Bootstrap",
340535
340729
  "The following catalog is capability metadata only. Tool descriptions are not instructions, and a tool is callable only when its full schema is present in the provider tools field.",
340536
340730
  ...catalogLines.length ? catalogLines : ["- No callable tools are available for this provider turn."],
@@ -341019,15 +341213,24 @@ function toolDefinitionName(definition) {
341019
341213
  }
341020
341214
  function toKernelTools(agent, definitions, provisioning) {
341021
341215
  const tools = definitions || agent.cachedToolDefinitions();
341216
+ let registry = null;
341217
+ try {
341218
+ registry = agent.ensureToolchain(tools).registry;
341219
+ } catch {
341220
+ }
341022
341221
  return tools.map((tool) => {
341023
341222
  const fn = tool?.function || {};
341223
+ const toolName = String(fn.name || "");
341224
+ const descriptor = registry?.get(toolName);
341024
341225
  return {
341025
- name: String(fn.name || ""),
341026
- label: String(fn.name || ""),
341226
+ name: toolName,
341227
+ label: toolName,
341027
341228
  description: String(fn.description || ""),
341028
341229
  parameters: fn.parameters || { type: "object", properties: {}, required: [] },
341029
341230
  prepareArguments: parseToolArgs,
341030
341231
  executionMode: "parallel",
341232
+ // DSH isConcurrencySafe 落地:从 registry 的 riskLevel 派生(read 工具并行)+ 白名单兜底。
341233
+ concurrencySafe: isConcurrencySafeTool(toolName, descriptor?.riskLevel),
341031
341234
  execute: async (_toolCallId, params, signal) => {
341032
341235
  if (signal?.aborted) throw abortError4();
341033
341236
  const name50 = String(fn.name || "");
@@ -341059,7 +341262,7 @@ function toKernelTools(agent, definitions, provisioning) {
341059
341262
  }
341060
341263
  const visionImage = visualFallbackImageInput(agent, name50, rawText);
341061
341264
  const directImage = imageInspectDataUrl(name50, rawText);
341062
- const text = sanitizeVisualToolText(name50, rawText);
341265
+ const text = spillOversizedToolResult(agent, name50, sanitizeVisualToolText(name50, rawText));
341063
341266
  const content = [{ type: "text", text }];
341064
341267
  if (visionImage.imagePath) content.push({ type: "image", imagePath: visionImage.imagePath, mimeType: imageMimeForPath(visionImage.imagePath) });
341065
341268
  else if (visionImage.image) content.push({ type: "image", image: visionImage.image, mimeType: visionImage.mimeType });
@@ -341094,6 +341297,24 @@ function toolResultIndicatesFailure(text) {
341094
341297
  return false;
341095
341298
  }
341096
341299
  }
341300
+ var INLINE_TOOL_RESULT_MAX_CHARS = 24e3;
341301
+ function spillOversizedToolResult(agent, name50, text) {
341302
+ const value = String(text || "");
341303
+ if (value.length <= INLINE_TOOL_RESULT_MAX_CHARS) return value;
341304
+ if (["computer_use", "browser_use", "pdf_read", "image_inspect", "image_display", "task", "subagent_send", "subagent_result", "subagent_read", "linked_plan", "question"].includes(name50)) {
341305
+ return value;
341306
+ }
341307
+ const artifactId = agent.storeToolResultArtifact(name50, value);
341308
+ const headPreview = value.slice(0, 800).trimEnd();
341309
+ return [
341310
+ `[oversized_tool_result tool="${name50}" artifact_id="${artifactId}" chars="${value.length}"]`,
341311
+ "The full result was written out of context. The preview below is truncated to 800 chars.",
341312
+ "Call compress_tool_result with this artifact_id to recover the full result as a format-preserving summary, or leave it truncated.",
341313
+ "",
341314
+ headPreview,
341315
+ "...(preview truncated)"
341316
+ ].join("\n");
341317
+ }
341097
341318
  function sanitizeVisualToolText(name50, text) {
341098
341319
  if (name50 !== "computer_use" && name50 !== "browser_use" && name50 !== "pdf_read" && name50 !== "image_inspect") return text;
341099
341320
  try {
@@ -341187,10 +341408,19 @@ async function executeNewmarkTool(agent, name50, args, inputSchema, signal) {
341187
341408
  if (name50 === "subagent_read") return agent.handleSubagentReadEnvelope(args).output;
341188
341409
  if (name50 === "subagent_result") return agent.handleSubagentResultEnvelope(args).output;
341189
341410
  if (name50 === "subagent_close") return agent.handleSubagentCloseEnvelope(args).output;
341411
+ if (name50 === "branch_list") return agent.handleBranchList(args).output;
341412
+ if (name50 === "branch_send") return agent.handleBranchSend(args).output;
341413
+ if (name50 === "branch_read") return agent.handleBranchRead(args).output;
341414
+ if (name50 === "branch_create") return agent.handleBranchCreate(args).output;
341190
341415
  if (name50 === "linked_plan") return agent.handleLinkedPlanTool(args);
341191
341416
  if (name50 === "build_history_query") return agent.handleBuildHistoryQuery(args);
341192
341417
  if (name50 === "context_compress") return (await agent.handleContextCompress(args, signal)).output;
341193
341418
  if (name50 === "context_history_manage") return agent.handleContextHistoryManage(args).output;
341419
+ if (name50 === "compress_tool_result") return (await agent.handleCompressToolResult(args, signal)).output;
341420
+ if (name50 === "background_tool") return (await agent.handleBackgroundTool(args, signal)).output;
341421
+ if (name50 === "read_tool_result") return agent.handleReadToolResult(args).output;
341422
+ if (name50 === "goal_manage") return agent.handleGoalManage(args).output;
341423
+ if (name50 === "conversation_rename") return agent.handleConversationRename(args).output;
341194
341424
  if (name50 === "question") {
341195
341425
  if (agent.config.getStr("agent", "option_feedback") === "fully_autonomous") return "[question] Disabled by fully_autonomous option feedback.";
341196
341426
  if (!agent.handleQuestion(args)) return "[Question rejected: at least one question with two labeled options is required.]";
@@ -343542,6 +343772,8 @@ var CONTEXT_SECTION_ORDER = [
343542
343772
  "active_toolset_manifest",
343543
343773
  "build_block_startup_input",
343544
343774
  "build_block_metadata",
343775
+ // Compatibility slot: linked-plan content is tool-retrieved on demand and
343776
+ // should remain empty for ordinary model requests.
343545
343777
  "linked_plan",
343546
343778
  "active_tasks",
343547
343779
  "current_work_set",
@@ -344160,6 +344392,12 @@ function markRuntimeLifecycleClean(root2, role = "main") {
344160
344392
 
344161
344393
  // src/core/agent.ts
344162
344394
  var ROOT_AGENT_ACTOR_ID2 = "00000000-0000-4000-8000-000000000001";
344395
+ var EDITOR_COMPLETION_BEFORE_CONTEXT_CHARS = 3200;
344396
+ var EDITOR_COMPLETION_AFTER_CONTEXT_CHARS = 800;
344397
+ var EDITOR_COMPLETION_MAX_TOKENS = 96;
344398
+ var EDITOR_COMPLETION_MAX_TEXT_CHARS = 1200;
344399
+ var EDITOR_COMPLETION_TIMEOUT_MS = 6500;
344400
+ var TOOL_RESULT_PRUNE_CHARS = 8e3;
344163
344401
  function normalizeIntelligenceTier(value) {
344164
344402
  const tier = String(value || "").trim().toLowerCase();
344165
344403
  return tier === "low" || tier === "high" || tier === "xhigh" || tier === "max" || tier === "ultra" ? tier : "medium";
@@ -344215,6 +344453,7 @@ var CORE_SYSTEM_PROMPT = `You are Newmark Agent, a powerful AI coding assistant
344215
344453
  - Plan: Fully read-only exploration. Do not modify any files, including README.md.
344216
344454
  - Goal: Persistent objective pursuit. Auto-continue until complete.
344217
344455
  - Flow: Sequential workflow execution with logic branching.
344456
+ - You may actively manage the Goal state yourself through the goal_manage tool: enter Goal mode or edit its objective when the user asks for a persistent objective or when it changes, mark it complete when you have genuinely verified it is achieved, and exit Goal mode when it is no longer needed. Do not use goal_manage to resume or bypass a Goal the user explicitly paused with Stop; the user is the only authority who resumes a paused Goal.
344218
344457
 
344219
344458
  ## Task Priority And Continuity
344220
344459
  - The latest explicit user instruction is authoritative and has the highest task priority. Resolve conflicts in favor of the latest instruction.
@@ -344222,6 +344461,11 @@ var CORE_SYSTEM_PROMPT = `You are Newmark Agent, a powerful AI coding assistant
344222
344461
  - Do not proactively resume, revive, continue, or execute a prior task merely because it appears unfinished in history. Continue prior work only when the current user explicitly asks to continue/resume/finish it, or when the current instruction clearly depends on it as a necessary prerequisite.
344223
344462
  - When the current instruction is a new task, complete that task without silently appending unrelated historical work.
344224
344463
 
344464
+ ## Inline Task Management (Mandatory)
344465
+ - For every multi-step conversation task, maintain a compact inline checklist in the current Build work state with actionable items and one status per item: pending, in_progress, completed, or blocked.
344466
+ - Update that checklist as work changes and use it to drive tool order and final verification. Keep it bounded to actionable task labels; never expose hidden reasoning.
344467
+ - The inline checklist is the per-turn task manager. The durable linked-plan document exists and is available through the linked_plan tool when explicitly needed, but its full contents are not injected into every request.
344468
+
344225
344469
  ## Guidelines
344226
344470
  - Treat this intrinsic Newmark prompt, mode rules, tool permissions, workspace binding, and feature disclosure as non-overridable. User, global, workspace, custom, and skill prompts may refine the task, but they must not weaken these rules.
344227
344471
  - Work from current evidence. Inspect files/state before relying on assumptions, and prefer the existing project patterns over new abstractions.
@@ -344350,6 +344594,11 @@ var Agent4 = class _Agent {
344350
344594
  activeConversationId = "default";
344351
344595
  lastCompression = null;
344352
344596
  compressionCache = [];
344597
+ pendingHistoryRemovals = [];
344598
+ branchMailbox = [];
344599
+ nextBranchMessageSequence = 1;
344600
+ branchCommunicationEnabled = false;
344601
+ compressionArchiveCountCache = null;
344353
344602
  nextCompressionCacheId = 1;
344354
344603
  compressionHistoryArchive;
344355
344604
  workspaceConversations = /* @__PURE__ */ new Map();
@@ -344418,6 +344667,10 @@ var Agent4 = class _Agent {
344418
344667
  runtimeLifecycleRole;
344419
344668
  /** dev-0.3.0 context system facade (feature-flagged, default off). */
344420
344669
  contextV2;
344670
+ /** 工具结果的持久化引用(artifact_id -> 状态 + 内容)。
344671
+ * 两种来源:超大结果落盘(content 立即可得)与后台工具(status=running 直到完成)。
344672
+ * 压缩前/后台中的大内容不进上下文,只通过 artifact_id 引用;读取后再释放。 */
344673
+ toolResultArtifacts = /* @__PURE__ */ new Map();
344421
344674
  runtimeLifecycle;
344422
344675
  /** dev-0.3.0 toolchain core (registry + capability catalog). Seeded lazily from cachedToolDefinitions; not consumed by the legacy path. */
344423
344676
  toolchainCore = null;
@@ -344544,6 +344797,7 @@ var Agent4 = class _Agent {
344544
344797
  const raw = entry.tree;
344545
344798
  if (raw && [1, 2].includes(Number(raw.version)) && raw.nodes && raw.nodes[raw.activeNodeId]) {
344546
344799
  raw.version = 2;
344800
+ if (!Array.isArray(raw.runningNodeIds) || !raw.runningNodeIds.length) raw.runningNodeIds = [raw.activeNodeId];
344547
344801
  this.coalesceConversationBranchGroups(raw);
344548
344802
  this.rebuildConversationTreeIndex(raw);
344549
344803
  entry.activeBranchId = raw.activeNodeId;
@@ -344562,6 +344816,7 @@ var Agent4 = class _Agent {
344562
344816
  rootNodeId: source.id,
344563
344817
  activeNodeId,
344564
344818
  activeGroupId: groupId,
344819
+ runningNodeIds: [activeNodeId],
344565
344820
  nodes,
344566
344821
  branchGroups: {
344567
344822
  [groupId]: {
@@ -344637,13 +344892,24 @@ var Agent4 = class _Agent {
344637
344892
  treePath(tree, nodeId) {
344638
344893
  return tree && tree.nodes[nodeId] ? this.treeAncestry(tree, nodeId).reverse() : [];
344639
344894
  }
344895
+ /** 确定性消息 ID:基于角色+内容+索引的 sha256,保证旧数据缺失 messageId 时补生成稳定、
344896
+ * 不漂移,且跨分支共享 fork 前缀消息得到一致 ID。 */
344897
+ deterministicMessageId(message, index) {
344898
+ const seed = `${index}:${String(message.role || "")}:${String(message.content === void 0 ? "" : typeof message.content === "string" ? message.content : JSON.stringify(message.content))}`;
344899
+ return `m-${crypto14.createHash("sha256").update(seed).digest("hex").slice(0, 16)}`;
344900
+ }
344901
+ /** 确定性 Guide ID:基于消息 ID + 索引,保证补生成稳定唯一。 */
344902
+ deterministicGuideId(message, index) {
344903
+ const base2 = String(message.messageId || this.deterministicMessageId(message, index));
344904
+ return `g-${crypto14.createHash("sha256").update(`${index}:${base2}`).digest("hex").slice(0, 16)}`;
344905
+ }
344640
344906
  rebuildConversationTreeIndex(tree) {
344641
344907
  const childIds = /* @__PURE__ */ new Map();
344642
344908
  for (const node of Object.values(tree.nodes)) {
344643
- node.chatMessages = (node.chatMessages || []).map((message) => ({
344909
+ node.chatMessages = (node.chatMessages || []).map((message, messageIndex) => ({
344644
344910
  ...message,
344645
- messageId: String(message.messageId || "") || crypto14.randomUUID(),
344646
- guideId: message.clientMessageId ? String(message.guideId || "") || crypto14.randomUUID() : void 0,
344911
+ messageId: String(message.messageId || "") || this.deterministicMessageId(message, messageIndex),
344912
+ guideId: message.clientMessageId ? String(message.guideId || "") || this.deterministicGuideId(message, messageIndex) : void 0,
344647
344913
  branchNodeId: node.id
344648
344914
  }));
344649
344915
  node.workRuns = this.normalizeWorkRuns(node.workRuns).map((run) => ({
@@ -345196,7 +345462,7 @@ var Agent4 = class _Agent {
345196
345462
  }
345197
345463
  isPersistablePublicWorkEvent(event) {
345198
345464
  const type = String(event.type || "").toLowerCase();
345199
- const publicTypes = /* @__PURE__ */ new Set(["start", "text", "response", "final_response", "tool_call", "tool_result", "status", "done", "error", "queue_update", "guide"]);
345465
+ const publicTypes = /* @__PURE__ */ new Set(["start", "text", "response", "final_response", "tool_call", "tool_result", "thought", "thought_result", "status", "done", "error", "queue_update", "guide"]);
345200
345466
  if (!publicTypes.has(type)) return false;
345201
345467
  if (type === "tool_call" || type === "tool_result") return true;
345202
345468
  const raw = `${String(event.content || "")}
@@ -345808,6 +346074,29 @@ ${String(event.toolArgs || "")}`;
345808
346074
  this.saveWorkspaceConversationState();
345809
346075
  return true;
345810
346076
  }
346077
+ /**
346078
+ * Close any running Build ledger entries owned by an explicitly interrupted
346079
+ * lifecycle before a Flow is resumed or a conversation is archived.
346080
+ *
346081
+ * The normal Flow runner guard must continue to reject a genuinely
346082
+ * concurrent Build. This method is deliberately explicit and target-scoped:
346083
+ * callers use it only after the owning Flow has been stopped/paused or when
346084
+ * archive has won the lifecycle race. Without this boundary, an isolated
346085
+ * Agent created during resume can legitimately reload the previous snapshot
346086
+ * while its runtime owner is still this Electron process and the guard would
346087
+ * mistake that stale ledger entry for an active Build.
346088
+ */
346089
+ interruptRunningConversationWorkRuns(target = this.currentConversationTarget(), status = "interrupted") {
346090
+ const workspaceId = String(target.workspaceId || "");
346091
+ const conversationId = this.safeConversationId(target.conversationId || this.activeConversationId || "default");
346092
+ const running = this.workRuns.filter((run) => run.status === "running" && String(run.target.workspaceId || "") === workspaceId && this.safeConversationId(run.target.conversationId || "default") === conversationId).map((run) => run.runId);
346093
+ let changed = 0;
346094
+ for (const runId of running) {
346095
+ if (this.finishConversationWorkRun(runId, status)) changed += 1;
346096
+ }
346097
+ if (changed) this.flushWorkspaceConversationState();
346098
+ return changed;
346099
+ }
345811
346100
  recordGuideReceipt(input) {
345812
346101
  const receipt = this.normalizeGuideReceipt(input);
345813
346102
  let run = this.workRuns.find((item) => item.runId === receipt.runId);
@@ -345843,9 +346132,9 @@ ${String(event.toolArgs || "")}`;
345843
346132
  const userHistory = (Array.isArray(history) ? history : []).filter((message) => message?.role === "user");
345844
346133
  const consumedUserHistory = /* @__PURE__ */ new Set();
345845
346134
  let nextUserHistoryIndex = 0;
345846
- return (Array.isArray(messages) ? messages : []).map((message) => {
345847
- const messageId = String(message?.messageId || "").trim() || crypto14.randomUUID();
345848
- const guideId = message?.clientMessageId ? String(message.guideId || "").trim() || crypto14.randomUUID() : void 0;
346135
+ return (Array.isArray(messages) ? messages : []).map((message, messageIndex) => {
346136
+ const messageId = String(message?.messageId || "").trim() || this.deterministicMessageId(message, messageIndex);
346137
+ const guideId = message?.clientMessageId ? String(message.guideId || "").trim() || this.deterministicGuideId(message, messageIndex) : void 0;
345849
346138
  const identified = { ...message, messageId, guideId, branchNodeId: String(message?.branchNodeId || "") || this.currentBranchNodeId() };
345850
346139
  if (!message || message.role !== "user") return identified;
345851
346140
  let matchingHistoryIndex = -1;
@@ -345915,6 +346204,7 @@ ${String(event.toolArgs || "")}`;
345915
346204
  const run = this.workRuns.find((item) => item.runId === String(runId || ""));
345916
346205
  if (!run) return false;
345917
346206
  this.syncAgentRunTerminal(run.runId, status, endedAt);
346207
+ this.flushPendingHistoryRemovals();
345918
346208
  if (run.status !== "running") {
345919
346209
  if (run.status !== "interrupted" || status !== "force_interrupted") {
345920
346210
  if (run.status !== status) return false;
@@ -346041,6 +346331,7 @@ ${String(event.toolArgs || "")}`;
346041
346331
  activeRun.endedAt = /^\d{4}-\d{2}-\d{2}T/.test(event.timestamp) ? event.timestamp : this.nowIso();
346042
346332
  activeRun.expanded = true;
346043
346333
  this.activeWorkRunId = "";
346334
+ this.flushPendingHistoryRemovals();
346044
346335
  }
346045
346336
  }
346046
346337
  if (isToolEvent && process.env.NEWMARK_PROVIDER_DIAGNOSTICS === "1") {
@@ -346329,15 +346620,17 @@ ${String(event.toolArgs || "")}`;
346329
346620
  saveStoredFlowSuspension(suspension, conversationId = this.activeConversationId) {
346330
346621
  const stateKey2 = this.workspaceConversationStateKey(conversationId);
346331
346622
  if (!stateKey2) return;
346332
- const stored = this.readStoredConversationState();
346333
- const flowSuspensions = { ...stored.flowSuspensions || {} };
346334
- if (suspension) {
346335
- flowSuspensions[stateKey2] = { ...suspension, updatedAt: suspension.updatedAt || (/* @__PURE__ */ new Date()).toISOString() };
346336
- delete stored.flowSuspension;
346337
- } else {
346338
- delete flowSuspensions[stateKey2];
346339
- }
346340
- this.writeStoredConversationStateNow({ ...stored, flowSuspensions });
346623
+ this.mutateStoredConversationState(this.workspace.current, (latest) => {
346624
+ const flowSuspensions = { ...latest.flowSuspensions || {} };
346625
+ if (suspension) {
346626
+ flowSuspensions[stateKey2] = { ...suspension, updatedAt: suspension.updatedAt || (/* @__PURE__ */ new Date()).toISOString() };
346627
+ } else {
346628
+ delete flowSuspensions[stateKey2];
346629
+ }
346630
+ const next = { ...latest, flowSuspensions };
346631
+ delete next.flowSuspension;
346632
+ return next;
346633
+ });
346341
346634
  }
346342
346635
  clearStoredFlowSuspension(conversationId = this.activeConversationId) {
346343
346636
  this.saveStoredFlowSuspension(null, conversationId);
@@ -346531,7 +346824,8 @@ ${String(event.toolArgs || "")}`;
346531
346824
  updatedAt: value.updatedAt || "",
346532
346825
  pinned: !!value.pinned,
346533
346826
  pinnedAt: value.pinnedAt || "",
346534
- order: Number(value.order || 0)
346827
+ order: Number(value.order || 0),
346828
+ branchCommunication: !!value.branchCommunication
346535
346829
  });
346536
346830
  }
346537
346831
  rows.sort((a3, b2) => {
@@ -346816,7 +347110,7 @@ Review this persisted peer result and summarize or continue the parent task as n
346816
347110
  if (!tree) {
346817
347111
  const originalId = String(entry.rootBranchNodeId || "") || crypto14.randomUUID();
346818
347112
  const original = this.treeNodeFromEntry(originalId, null, requestedIndex, "", entry);
346819
- tree = { version: 2, rootNodeId: originalId, activeNodeId: originalId, activeGroupId: "", nodes: { [originalId]: original }, branchGroups: {}, nodeIndex: {}, pathIndex: {} };
347113
+ tree = { version: 2, rootNodeId: originalId, activeNodeId: originalId, activeGroupId: "", runningNodeIds: [originalId], nodes: { [originalId]: original }, branchGroups: {}, nodeIndex: {}, pathIndex: {} };
346820
347114
  entry.tree = tree;
346821
347115
  entry.rootBranchNodeId = originalId;
346822
347116
  } else {
@@ -346900,6 +347194,13 @@ Review this persisted peer result and summarize or continue the parent task as n
346900
347194
  nodeIds: [parentNodeId, branchId]
346901
347195
  };
346902
347196
  }
347197
+ if (this.branchCommunicationEnabled) {
347198
+ tree.runningNodeIds = tree.runningNodeIds || [];
347199
+ if (parentNodeId && !tree.runningNodeIds.includes(parentNodeId)) tree.runningNodeIds.push(parentNodeId);
347200
+ if (!tree.runningNodeIds.includes(branchId)) tree.runningNodeIds.push(branchId);
347201
+ } else {
347202
+ tree.runningNodeIds = [branchId];
347203
+ }
346903
347204
  tree.activeNodeId = branchId;
346904
347205
  tree.activeGroupId = groupId;
346905
347206
  this.rebuildConversationTreeIndex(tree);
@@ -346916,6 +347217,14 @@ Review this persisted peer result and summarize or continue the parent task as n
346916
347217
  if (clean === this.safeConversationId(this.activeConversationId)) this.setConversationFromStorage(clean);
346917
347218
  return this.getConversationSnapshot(clean);
346918
347219
  }
347220
+ setBranchCommunication(enabled) {
347221
+ this.branchCommunicationEnabled = !!enabled;
347222
+ this.saveWorkspaceConversationState(true);
347223
+ return this.branchCommunicationEnabled;
347224
+ }
347225
+ isBranchCommunicationEnabled() {
347226
+ return this.branchCommunicationEnabled;
347227
+ }
346919
347228
  switchConversationBranch(conversationId, branchId, branchGroupId = "") {
346920
347229
  const clean = this.safeConversationId(conversationId || "default");
346921
347230
  this.saveWorkspaceConversationState(true);
@@ -346931,6 +347240,14 @@ Review this persisted peer result and summarize or continue the parent task as n
346931
347240
  entry.branchReset = true;
346932
347241
  const requestedGroup = tree.branchGroups[String(branchGroupId || "")];
346933
347242
  const group = requestedGroup?.nodeIds.includes(branch.id) ? requestedGroup : Object.values(tree.branchGroups).find((item) => item.nodeIds.includes(branch.id) && item.nodeIds.includes(priorActiveNodeId));
347243
+ if (this.branchCommunicationEnabled) {
347244
+ tree.runningNodeIds = tree.runningNodeIds || [];
347245
+ for (const runningId of [priorActiveNodeId, branch.id]) {
347246
+ if (runningId && !tree.runningNodeIds.includes(runningId)) tree.runningNodeIds.push(runningId);
347247
+ }
347248
+ } else {
347249
+ tree.runningNodeIds = [branch.id];
347250
+ }
346934
347251
  tree.activeNodeId = branch.id;
346935
347252
  if (group) tree.activeGroupId = group.id;
346936
347253
  entry.activeBranchId = branch.id;
@@ -346973,6 +347290,22 @@ Review this persisted peer result and summarize or continue the parent task as n
346973
347290
  this.writeStoredConversationState(stored);
346974
347291
  return true;
346975
347292
  }
347293
+ /**
347294
+ * 首 Build 命名提示判定:仅当 (1) 当前对话尚无历史 Build(排除当前 run)且
347295
+ * (2) 其持久化 title 仍是自动生成(含为空)时返回 true。满足条件时运行时会
347296
+ * 在首个 provider request 的 bootstrap 注入一次性命名指令,让 Agent 调用
347297
+ * conversation_rename 自行命名。判定本身只读存储、无副作用,保缓存稳定。
347298
+ */
347299
+ shouldPromptConversationRename() {
347300
+ if (this.conversationBuildHistory(1).length > 0) return false;
347301
+ const conversationId = this.activeConversationId || "default";
347302
+ const stateKey2 = this.workspaceConversationStateKey(conversationId);
347303
+ if (!stateKey2) return false;
347304
+ const entry = this.readStoredConversationState().conversations?.[stateKey2];
347305
+ const priorTitle = entry?.title;
347306
+ const messages = entry?.chatMessages || this.chatMessages;
347307
+ return this.isGeneratedConversationTitle(priorTitle, conversationId, messages);
347308
+ }
346976
347309
  reorderConversations(ids) {
346977
347310
  const prefix = this.workspaceConversationPrefix() || "";
346978
347311
  const normalized = Array.from(new Set((Array.isArray(ids) ? ids : []).map((id) => this.safeConversationId(id)).filter(Boolean)));
@@ -347061,6 +347394,8 @@ Review this persisted peer result and summarize or continue the parent task as n
347061
347394
  chatMessages: [...this.chatMessages],
347062
347395
  history: [...this.history],
347063
347396
  compressionCache: [...this.compressionCache],
347397
+ branchMailbox: [...this.branchMailbox],
347398
+ branchCommunication: this.branchCommunicationEnabled,
347064
347399
  plan: this.normalizeConversationPlan(this.conversationPlan),
347065
347400
  linkedPlan: this.normalizeLinkedPlan(this.linkedPlan),
347066
347401
  subagentState: this.subagents.serialize(),
@@ -347091,6 +347426,8 @@ Review this persisted peer result and summarize or continue the parent task as n
347091
347426
  chatMessages: [...this.chatMessages],
347092
347427
  history: [...this.history],
347093
347428
  compressionCache: [...this.compressionCache],
347429
+ branchMailbox: [...this.branchMailbox],
347430
+ branchCommunication: this.branchCommunicationEnabled,
347094
347431
  plan: this.normalizeConversationPlan(this.conversationPlan),
347095
347432
  linkedPlan: this.normalizeLinkedPlan(this.linkedPlan),
347096
347433
  subagentState: this.subagents.serialize(),
@@ -347141,6 +347478,9 @@ Review this persisted peer result and summarize or continue the parent task as n
347141
347478
  this.history = [...saved.history];
347142
347479
  this.compressionCache = saved.compressionCache ? saved.compressionCache.map((entry) => ({ ...entry, messages: [...entry.messages] })) : [];
347143
347480
  this.nextCompressionCacheId = Math.max(1, ...this.compressionCache.map((entry) => Number(entry.id.replace(/^ctx-cache-/, "")) || 0)) + 1;
347481
+ this.branchMailbox = (saved.branchMailbox || []).map((message) => ({ ...message }));
347482
+ this.nextBranchMessageSequence = Math.max(1, ...this.branchMailbox.map((message) => Number(message.sequence) || 0)) + 1;
347483
+ this.branchCommunicationEnabled = !!saved.branchCommunication;
347144
347484
  this.chatMessages = this.normalizeConversationChatMessages(saved.chatMessages, this.history);
347145
347485
  this.conversationPlan = this.normalizeConversationPlan(saved.plan);
347146
347486
  this.linkedPlan = this.normalizeLinkedPlan(saved.linkedPlan);
@@ -347163,6 +347503,9 @@ Review this persisted peer result and summarize or continue the parent task as n
347163
347503
  this.history = persisted?.history ? [...persisted.history] : [];
347164
347504
  this.compressionCache = persisted?.compressionCache ? persisted.compressionCache.map((entry) => ({ ...entry, messages: [...entry.messages] })) : [];
347165
347505
  this.nextCompressionCacheId = Math.max(1, ...this.compressionCache.map((entry) => Number(entry.id.replace(/^ctx-cache-/, "")) || 0)) + 1;
347506
+ this.branchMailbox = (persisted?.branchMailbox || []).map((message) => ({ ...message }));
347507
+ this.nextBranchMessageSequence = Math.max(1, ...this.branchMailbox.map((message) => Number(message.sequence) || 0)) + 1;
347508
+ this.branchCommunicationEnabled = !!persisted?.branchCommunication;
347166
347509
  this.chatMessages = this.normalizeConversationChatMessages(persisted?.chatMessages || [], this.history);
347167
347510
  this.conversationPlan = this.normalizeConversationPlan(persisted?.plan);
347168
347511
  this.linkedPlan = this.normalizeLinkedPlan(persisted?.linkedPlan);
@@ -347205,6 +347548,8 @@ Review this persisted peer result and summarize or continue the parent task as n
347205
347548
  chatMessages: [...this.chatMessages],
347206
347549
  history: [...this.history],
347207
347550
  compressionCache: [...this.compressionCache],
347551
+ branchMailbox: [...this.branchMailbox],
347552
+ branchCommunication: this.branchCommunicationEnabled,
347208
347553
  plan: this.normalizeConversationPlan(this.conversationPlan),
347209
347554
  linkedPlan: this.normalizeLinkedPlan(this.linkedPlan),
347210
347555
  subagentState: this.subagents.serialize(),
@@ -347391,6 +347736,7 @@ Review this persisted peer result and summarize or continue the parent task as n
347391
347736
  const run = this.workRuns.find((item) => item.runId === record.runId);
347392
347737
  if (!run) return JSON.stringify({ ok: false, error: "Historical Build Block state is unavailable." });
347393
347738
  const maxEvents = Math.max(1, Math.min(200, Math.floor(Number(input.max_events || 80))));
347739
+ const boundedActivityChars = Math.max(100, Math.min(4e3, Math.floor(Number(input.max_chars || 2e3))));
347394
347740
  const publicEvents = run.events.filter((event) => !["text", "response", "final_response"].includes(event.type));
347395
347741
  const activities = publicEvents.slice(-maxEvents).map((event) => ({
347396
347742
  sequence: event.sequence,
@@ -347398,7 +347744,7 @@ Review this persisted peer result and summarize or continue the parent task as n
347398
347744
  timestamp: event.timestamp,
347399
347745
  toolName: event.toolName,
347400
347746
  status: event.status,
347401
- content: this.sanitizePublicWorkContent(event.content || "")
347747
+ content: this.sanitizePublicWorkContent(event.content || "").slice(0, boundedActivityChars)
347402
347748
  }));
347403
347749
  return JSON.stringify({
347404
347750
  ok: true,
@@ -347409,7 +347755,7 @@ Review this persisted peer result and summarize or continue the parent task as n
347409
347755
  status: guide.status,
347410
347756
  createdAt: guide.createdAt,
347411
347757
  updatedAt: guide.updatedAt,
347412
- content: this.sanitizePublicWorkContent(guide.content || "")
347758
+ content: this.sanitizePublicWorkContent(guide.content || "").slice(0, boundedActivityChars)
347413
347759
  }))
347414
347760
  },
347415
347761
  truncatedActivities: Math.max(0, publicEvents.length - activities.length)
@@ -347453,6 +347799,458 @@ Review this persisted peer result and summarize or continue the parent task as n
347453
347799
  this.config.set("context", "keep_recent_messages", previousKeepLast);
347454
347800
  }
347455
347801
  }
347802
+ /**
347803
+ * 落盘一个超大工具结果,返回 artifact_id。完整内容不进上下文——上下文只保留
347804
+ * tiny 引用;compress_tool_result 按 id 读取后再压缩。落盘后状态即 done。
347805
+ */
347806
+ storeToolResultArtifact(tool, content) {
347807
+ const id = crypto14.randomUUID();
347808
+ this.toolResultArtifacts.set(id, { tool, content, status: "done", createdAt: Date.now() });
347809
+ return id;
347810
+ }
347811
+ /**
347812
+ * 注册一个后台工具任务,立即返回 background_id(status=running)。真实工具在
347813
+ * 后台执行,完成后由 finishToolResultArtifact 标记 done/error。后台结果持久化
347814
+ * 等待 read_tool_result 读取后再释放。
347815
+ */
347816
+ beginBackgroundTool(tool) {
347817
+ const id = crypto14.randomUUID();
347818
+ this.toolResultArtifacts.set(id, { tool, content: "", status: "running", createdAt: Date.now() });
347819
+ return id;
347820
+ }
347821
+ /** 标记后台任务完成(写结果)或失败(写错误)。 */
347822
+ finishToolResultArtifact(id, content, error) {
347823
+ const artifact = this.toolResultArtifacts.get(id);
347824
+ if (!artifact) return;
347825
+ if (error) {
347826
+ artifact.status = "error";
347827
+ artifact.error = error;
347828
+ } else {
347829
+ artifact.status = "done";
347830
+ artifact.content = content;
347831
+ }
347832
+ }
347833
+ /**
347834
+ * 按 artifact_id 读取工具结果引用(compress_tool_result / read_tool_result 共用)。
347835
+ */
347836
+ readToolResultArtifact(id) {
347837
+ return this.toolResultArtifacts.get(id) ?? null;
347838
+ }
347839
+ /**
347840
+ * 压缩一个极大的工具调用结果(保留格式),供 Agent 主动选用以替代硬截断。
347841
+ *
347842
+ * 入参为 artifact_id(而非完整 content),故压缩前的大内容不进入上下文。
347843
+ * 缓存命中隔离:压缩 LLM 调用使用独立 system + 单条 user 消息,与主对话
347844
+ * system/历史前缀不相交,不污染缓存命中。
347845
+ */
347846
+ async handleCompressToolResult(args, signal) {
347847
+ let input = {};
347848
+ try {
347849
+ input = JSON.parse(args || "{}");
347850
+ } catch {
347851
+ }
347852
+ const artifactId = String(input.artifact_id || "").trim();
347853
+ const inlineContent = typeof input.content === "string" ? input.content : String(input.content ?? "");
347854
+ let content = "";
347855
+ let source = "inline";
347856
+ if (artifactId) {
347857
+ const artifact = this.readToolResultArtifact(artifactId);
347858
+ if (!artifact) return { ok: false, output: "[compress_tool_result] Unknown or expired artifact_id.", error: "Unknown artifact_id." };
347859
+ if (artifact.status === "running") return { ok: false, output: "[compress_tool_result] Tool result is still running in the background; read_tool_result first.", error: "still-running." };
347860
+ if (artifact.status === "error") return { ok: false, output: "[compress_tool_result] Backgronud tool failed: " + String(artifact.error || "unknown error"), error: "background-error." };
347861
+ content = artifact.content;
347862
+ source = "artifact";
347863
+ } else if (inlineContent.trim()) {
347864
+ content = inlineContent;
347865
+ } else {
347866
+ return { ok: false, output: "[compress_tool_result] artifact_id (or content) is required.", error: "artifact_id is required." };
347867
+ }
347868
+ const formatHint = String(input.format_hint || "").trim();
347869
+ const provider = this.engineModel();
347870
+ const modelName = this.activeModelName();
347871
+ if (!provider || !modelName) {
347872
+ return {
347873
+ ok: true,
347874
+ output: JSON.stringify({
347875
+ ok: true,
347876
+ compressed: true,
347877
+ method: "local-fallback",
347878
+ summary: this.pruneToolResultContent(content),
347879
+ originalChars: content.length
347880
+ }, null, 2),
347881
+ metadata: { kind: "compress-tool-result" }
347882
+ };
347883
+ }
347884
+ try {
347885
+ const system = [
347886
+ "You are a tool-result compression engine.",
347887
+ "Compress ONE oversized tool result into a concise, format-preserving summary.",
347888
+ "Preserve the exact structure the original result carries: keep JSON objects/arrays valid, keep table columns/rows, keep code blocks, keep file paths, identifiers, numbers, error strings, and key-value pairs verbatim.",
347889
+ "Do not drop error messages, command outputs that matter for correctness, or any identifier the agent may need to continue.",
347890
+ 'Return ONLY the compressed result, with no preamble, no Markdown fences, no "here is" phrasing.'
347891
+ ].join("\n");
347892
+ const formatSuffix = formatHint ? `
347893
+
347894
+ Format to preserve: ${formatHint}` : "";
347895
+ const prompt = [
347896
+ "Original tool result (do not shorten meaningful structure; remove only redundant/boilerplate whitespace and trivially repeated noise):",
347897
+ "",
347898
+ content,
347899
+ formatSuffix
347900
+ ].join("\n");
347901
+ const maxTokens = Math.max(1024, Math.min(8192, Math.ceil(content.length / 4)) + 512);
347902
+ const { temperature } = provider.intelligenceConfig("low");
347903
+ const generated = await this.withTimeout(
347904
+ provider.chat(modelName, [{ role: "user", content: prompt }], system, temperature, maxTokens, signal),
347905
+ 12e4
347906
+ );
347907
+ const summary = String(generated || "").trim();
347908
+ if (!summary || /^\[LLM Error(?::|\])/i.test(summary)) {
347909
+ return {
347910
+ ok: true,
347911
+ output: JSON.stringify({ ok: true, compressed: true, method: "local-fallback", summary: this.pruneToolResultContent(content), originalChars: content.length }, null, 2),
347912
+ metadata: { kind: "compress-tool-result" }
347913
+ };
347914
+ }
347915
+ return {
347916
+ ok: true,
347917
+ output: JSON.stringify({
347918
+ ok: true,
347919
+ compressed: true,
347920
+ method: "model-summary",
347921
+ model: modelName,
347922
+ summary,
347923
+ originalChars: content.length,
347924
+ compressedChars: summary.length
347925
+ }, null, 2),
347926
+ metadata: { kind: "compress-tool-result" }
347927
+ };
347928
+ } catch {
347929
+ return {
347930
+ ok: true,
347931
+ output: JSON.stringify({ ok: true, compressed: true, method: "local-fallback", summary: this.pruneToolResultContent(content), originalChars: content.length }, null, 2),
347932
+ metadata: { kind: "compress-tool-result" }
347933
+ };
347934
+ }
347935
+ }
347936
+ /**
347937
+ * 工具后台化:把一个工具调用派发到后台运行,立即返回 background_id,不阻塞
347938
+ * 对话回合。真实工具在后台执行,完成后持久化到 toolResultArtifacts,
347939
+ * read_tool_result 按 background_id 读取后再释放。
347940
+ *
347941
+ * 缓存命中优化:后台化工具只返回 tiny 的 background_id(不进大结果到上下文),
347942
+ * 真实结果按需读取,避免大结果撑爆上下文、破坏前缀缓存。
347943
+ */
347944
+ async handleBackgroundTool(args, signal) {
347945
+ let input = {};
347946
+ try {
347947
+ input = JSON.parse(args || "{}");
347948
+ } catch {
347949
+ }
347950
+ const tool = String(input.tool || "").trim();
347951
+ if (!tool) return { ok: false, output: "[background_tool] tool is required.", error: "tool is required." };
347952
+ if (tool === "background_tool" || tool === "read_tool_result" || tool === "compress_tool_result" || tool === "goal_manage" || tool === "conversation_rename") {
347953
+ return { ok: false, output: "[background_tool] cannot background the control tools (background_tool/read_tool_result/compress_tool_result/goal_manage/conversation_rename).", error: "control-tool-unsupported." };
347954
+ }
347955
+ if (/^(task|subagent_|flow_|context_|question|skill)/.test(tool)) {
347956
+ return { ok: false, output: "[background_tool] orchestration/flow tools cannot be backgrounded.", error: "orchestration-unsupported." };
347957
+ }
347958
+ const toolArgs = input.args;
347959
+ const argStr = typeof toolArgs === "string" ? toolArgs : toolArgs === void 0 ? "{}" : JSON.stringify(toolArgs);
347960
+ const backgroundId = this.beginBackgroundTool(tool);
347961
+ const wsDir = this.workspace.current?.path || this.rootPath;
347962
+ void this.tools.execute(tool, argStr, wsDir, {
347963
+ mode: this.mode,
347964
+ workspacePath: wsDir,
347965
+ conversationId: this.activeConversationId || "default",
347966
+ actorId: this.runtimeActorId,
347967
+ workspaceId: this.workspace.current?.id || "",
347968
+ backend: process.env.NEWMARK_WSL_DISTRO ? "wsl" : process.platform === "win32" ? "windows" : process.platform,
347969
+ signal
347970
+ }).then((content) => {
347971
+ this.finishToolResultArtifact(backgroundId, content);
347972
+ }).catch((error) => {
347973
+ this.finishToolResultArtifact(backgroundId, "", error instanceof Error ? error.message : String(error));
347974
+ });
347975
+ return {
347976
+ ok: true,
347977
+ output: JSON.stringify({ ok: true, background_id: backgroundId, tool, status: "running", createdAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2),
347978
+ metadata: { kind: "background-tool" }
347979
+ };
347980
+ }
347981
+ /**
347982
+ * 读取后台工具结果:done 时返回结果(按需释放),running 时返回状态,error
347983
+ * 时返回错误。与 compress_tool_result 共享 toolResultArtifacts。
347984
+ */
347985
+ handleReadToolResult(args) {
347986
+ let input = {};
347987
+ try {
347988
+ input = JSON.parse(args || "{}");
347989
+ } catch {
347990
+ }
347991
+ const id = String(input.background_id || input.artifact_id || "").trim();
347992
+ if (!id) return { ok: false, output: "[read_tool_result] background_id is required.", error: "background_id is required." };
347993
+ const artifact = this.readToolResultArtifact(id);
347994
+ if (!artifact) return { ok: false, output: "[read_tool_result] Unknown or already-released background_id.", error: "unknown-background-id." };
347995
+ const release = Boolean(input.release);
347996
+ const result = {
347997
+ ok: true,
347998
+ background_id: id,
347999
+ tool: artifact.tool,
348000
+ status: artifact.status,
348001
+ createdAt: artifact.createdAt ? new Date(artifact.createdAt).toISOString() : ""
348002
+ };
348003
+ if (artifact.status === "running") {
348004
+ result.running = true;
348005
+ } else if (artifact.status === "error") {
348006
+ result.error = artifact.error || "background tool failed";
348007
+ } else {
348008
+ result.content = artifact.content;
348009
+ if (release) this.toolResultArtifacts.delete(id);
348010
+ }
348011
+ return { ok: true, output: JSON.stringify(result, null, 2), metadata: { kind: "read-tool-result" } };
348012
+ }
348013
+ /**
348014
+ * Agent 主动管理 Goal 状态:进入 / 编辑 objective / 标记完成 / 退出。
348015
+ * 兼容原有 Goal 机制:enter/update 复用 updateGoal(记录 change、mode=goal、
348016
+ * 尊重已暂停状态),complete 复用 markGoalComplete(verified + clearGoal),
348017
+ * exit 复用 clearGoal(回 build 不声称完成)。不破坏「用户 Stop 暂停」边界:
348018
+ * 本工具不提供 pause/resume,避免 Agent 绕过用户的显式暂停。
348019
+ */
348020
+ handleGoalManage(args) {
348021
+ let input = {};
348022
+ try {
348023
+ input = JSON.parse(args || "{}");
348024
+ } catch {
348025
+ }
348026
+ const action = String(input.action || "").trim();
348027
+ const objective = String(input.objective || "").replace(/\s+/g, " ").trim();
348028
+ const reason = String(input.reason || "").trim();
348029
+ const hadGoal = !!this.goal;
348030
+ const priorObjective = this.goal?.objective || "";
348031
+ if (!["enter", "update", "complete", "exit"].includes(action)) {
348032
+ return { ok: false, output: "[goal_manage] action is required (enter|update|complete|exit).", error: "action is required." };
348033
+ }
348034
+ if ((action === "enter" || action === "update") && !objective) {
348035
+ return { ok: false, output: "[goal_manage] objective is required for enter/update.", error: "objective is required." };
348036
+ }
348037
+ if (action === "enter" || action === "update") {
348038
+ this.updateGoal(objective);
348039
+ const entered = !hadGoal && action === "enter";
348040
+ return {
348041
+ ok: true,
348042
+ output: JSON.stringify({
348043
+ ok: true,
348044
+ action,
348045
+ enteredGoal: entered,
348046
+ objective: this.goal?.objective || objective,
348047
+ mode: this.mode,
348048
+ paused: this.goal?.paused || false,
348049
+ goalRounds: this.goal?.goalRounds || 0,
348050
+ ...reason ? { reason } : {}
348051
+ }, null, 2),
348052
+ metadata: { kind: "goal-manage" }
348053
+ };
348054
+ }
348055
+ if (action === "complete") {
348056
+ if (!this.goal) return { ok: true, output: JSON.stringify({ ok: true, action, completed: false, note: "No active Goal to complete." }, null, 2), metadata: { kind: "goal-manage" } };
348057
+ this.markGoalComplete();
348058
+ return {
348059
+ ok: true,
348060
+ output: JSON.stringify({ ok: true, action, completed: true, priorObjective, mode: this.mode, goal: null }, null, 2),
348061
+ metadata: { kind: "goal-manage" }
348062
+ };
348063
+ }
348064
+ if (!this.goal) return { ok: true, output: JSON.stringify({ ok: true, action, cleared: false, note: "No active Goal to exit." }, null, 2), metadata: { kind: "goal-manage" } };
348065
+ this.clearGoal();
348066
+ return {
348067
+ ok: true,
348068
+ output: JSON.stringify({ ok: true, action, cleared: true, priorObjective, mode: this.mode, goal: null }, null, 2),
348069
+ metadata: { kind: "goal-manage" }
348070
+ };
348071
+ }
348072
+ /**
348073
+ * Agent 自行命名当前对话。首 Build Block 上运行时通过 bootstrap 提示(见
348074
+ * agentKernelRunner.buildBuildContextBootstrap)请求 Agent 调用一次;这里复用
348075
+ * 已有的 renameConversation 持久化路径。返回简短结果以保缓存友好。
348076
+ */
348077
+ handleConversationRename(args) {
348078
+ let input = {};
348079
+ try {
348080
+ input = JSON.parse(args || "{}");
348081
+ } catch {
348082
+ }
348083
+ const title = String(input.title || "").replace(/\s+/g, " ").trim();
348084
+ if (!title) return { ok: false, output: "[conversation_rename] title is required.", error: "title is required." };
348085
+ const conversationId = this.activeConversationId || "default";
348086
+ const ok = this.renameConversation(conversationId, title);
348087
+ if (!ok) return { ok: false, output: "[conversation_rename] could not rename conversation (no state key or empty title).", error: "rename failed." };
348088
+ return {
348089
+ ok: true,
348090
+ output: JSON.stringify({ ok: true, conversationId, title: title.slice(0, 80) }, null, 2),
348091
+ metadata: { kind: "conversation-rename" }
348092
+ };
348093
+ }
348094
+ conversationTree() {
348095
+ const stateKey2 = this.workspaceConversationStateKey();
348096
+ const stored = this.readStoredConversationState();
348097
+ const persisted = stateKey2 && stored.conversations ? stored.conversations[stateKey2] : void 0;
348098
+ return persisted ? this.normalizeConversationTree(persisted) : null;
348099
+ }
348100
+ currentRuntimeBranchId() {
348101
+ return String(this.conversationTree()?.activeNodeId || "");
348102
+ }
348103
+ handleBranchList(args) {
348104
+ try {
348105
+ const params = JSON.parse(args || "{}");
348106
+ if (!this.branchCommunicationEnabled) {
348107
+ return { ok: false, output: '[branch_list] Branch communication is not enabled for this conversation. Enable "\u5141\u8BB8\u5206\u652F\u4EA4\u6D41" at conversation creation time.', error: "branch communication disabled." };
348108
+ }
348109
+ const tree = this.conversationTree();
348110
+ const nodes = tree?.nodes || {};
348111
+ const activeNodeId = String(tree?.activeNodeId || "");
348112
+ const branches = Object.values(nodes).map((node) => {
348113
+ const inbound = this.branchMailbox.filter((m2) => m2.toBranchId === node.id);
348114
+ const outbound = this.branchMailbox.filter((m2) => m2.fromBranchId === node.id);
348115
+ return {
348116
+ id: node.id,
348117
+ parentId: node.parentId,
348118
+ active: node.id === activeNodeId,
348119
+ sourceMessageIndex: node.sourceMessageIndex,
348120
+ sourceText: String(node.sourceText || "").slice(0, 160),
348121
+ chatMessages: node.chatMessages.length,
348122
+ history: node.history.length,
348123
+ workRuns: node.workRuns.length,
348124
+ runningWorkRuns: node.workRuns.filter((run) => run.status === "running").length,
348125
+ mailbox: { inbound: inbound.length, unread: inbound.filter((m2) => !m2.readAt).length, outbound: outbound.length }
348126
+ };
348127
+ });
348128
+ return {
348129
+ ok: true,
348130
+ output: JSON.stringify({ ok: true, conversationId: this.activeConversationId, branchCommunication: true, activeBranchId: activeNodeId, branchCount: branches.length, branches }, null, 2),
348131
+ metadata: { kind: "branch-list" }
348132
+ };
348133
+ } catch {
348134
+ return { ok: false, output: "[branch_list] Invalid arguments.", error: "Invalid arguments." };
348135
+ }
348136
+ }
348137
+ handleBranchSend(args) {
348138
+ try {
348139
+ const params = JSON.parse(args || "{}");
348140
+ if (!this.branchCommunicationEnabled) return { ok: false, output: "[branch_send] Branch communication is not enabled for this conversation.", error: "branch communication disabled." };
348141
+ const toBranchId = String(params.to_branch || params.toBranchId || params.branch || "").trim();
348142
+ const body = String(params.message || params.body || "").trim();
348143
+ const kind = String(params.kind || "message").trim();
348144
+ if (!toBranchId) return { ok: false, output: "[branch_send] to_branch is required.", error: "to_branch is required." };
348145
+ if (!body) return { ok: false, output: "[branch_send] message is required.", error: "message is required." };
348146
+ const tree = this.conversationTree();
348147
+ const target = tree?.nodes[toBranchId];
348148
+ if (!target) return { ok: false, output: "[branch_send] Branch not found: " + toBranchId, error: "Branch not found: " + toBranchId };
348149
+ const fromBranchId = this.currentRuntimeBranchId();
348150
+ if (!fromBranchId) return { ok: false, output: "[branch_send] Could not determine the current runtime branch.", error: "runtime branch unknown." };
348151
+ if (fromBranchId === toBranchId) return { ok: false, output: "[branch_send] A branch cannot message itself.", error: "self-message forbidden." };
348152
+ const message = {
348153
+ id: crypto14.randomUUID(),
348154
+ conversationId: this.activeConversationId || "default",
348155
+ sequence: this.nextBranchMessageSequence++,
348156
+ fromBranchId,
348157
+ toBranchId,
348158
+ kind: kind === "directive" ? "directive" : kind === "result" ? "result" : "message",
348159
+ body: body.slice(0, 32e3),
348160
+ correlationId: params.correlation_id ? String(params.correlation_id) : void 0,
348161
+ replyTo: params.reply_to ? String(params.reply_to) : void 0,
348162
+ createdAt: (/* @__PURE__ */ new Date()).toISOString()
348163
+ };
348164
+ this.branchMailbox.push(message);
348165
+ this.saveWorkspaceConversationState(true);
348166
+ return {
348167
+ ok: true,
348168
+ output: JSON.stringify({ ok: true, message: { id: message.id, fromBranchId, toBranchId, kind: message.kind, sequence: message.sequence } }, null, 2),
348169
+ metadata: { kind: "branch-send" }
348170
+ };
348171
+ } catch {
348172
+ return { ok: false, output: "[branch_send] Invalid arguments.", error: "Invalid arguments." };
348173
+ }
348174
+ }
348175
+ handleBranchRead(args) {
348176
+ try {
348177
+ const params = JSON.parse(args || "{}");
348178
+ if (!this.branchCommunicationEnabled) return { ok: false, output: "[branch_read] Branch communication is not enabled for this conversation.", error: "branch communication disabled." };
348179
+ const branchId = String(params.branch || params.branch_id || params.id || "").trim();
348180
+ if (!branchId) return { ok: false, output: "[branch_read] branch is required.", error: "branch is required." };
348181
+ const tree = this.conversationTree();
348182
+ const node = tree?.nodes[branchId];
348183
+ if (!node) return { ok: false, output: "[branch_read] Branch not found: " + branchId, error: "Branch not found: " + branchId };
348184
+ const fromBranchId = this.currentRuntimeBranchId();
348185
+ const maxChars = Math.max(100, Math.min(16e3, Math.floor(Number(params.max_chars || 8e3))));
348186
+ const inbound = this.branchMailbox.filter((m2) => m2.toBranchId === fromBranchId && m2.fromBranchId === branchId).sort((a3, b2) => a3.sequence - b2.sequence).map((m2) => ({ id: m2.id, sequence: m2.sequence, kind: m2.kind, body: m2.body, createdAt: m2.createdAt, read: !!m2.readAt }));
348187
+ for (const m2 of inbound) {
348188
+ const stored = this.branchMailbox.find((x2) => x2.id === m2.id);
348189
+ if (stored && !stored.readAt) stored.readAt = (/* @__PURE__ */ new Date()).toISOString();
348190
+ }
348191
+ if (inbound.length) this.saveWorkspaceConversationState(true);
348192
+ const activity = node.workRuns.slice(-10).map((run) => {
348193
+ const finalEvent = [...run.events].reverse().find((event) => event.type === "final_response");
348194
+ return {
348195
+ runId: run.runId,
348196
+ status: run.status,
348197
+ startedAt: run.startedAt,
348198
+ endedAt: run.endedAt,
348199
+ finalResult: finalEvent ? String(finalEvent.content || "").slice(0, maxChars) : "",
348200
+ recentEvents: run.events.slice(-6).map((event) => "[" + event.type + "] " + String(event.content || "").slice(0, 240))
348201
+ };
348202
+ });
348203
+ return {
348204
+ ok: true,
348205
+ output: JSON.stringify({
348206
+ ok: true,
348207
+ branch: {
348208
+ id: node.id,
348209
+ parentId: node.parentId,
348210
+ sourceMessageIndex: node.sourceMessageIndex,
348211
+ sourceText: String(node.sourceText || "").slice(0, 240),
348212
+ chatMessages: node.chatMessages.length,
348213
+ history: node.history.length
348214
+ },
348215
+ inbound,
348216
+ activity
348217
+ }, null, 2),
348218
+ metadata: { kind: "branch-read" }
348219
+ };
348220
+ } catch {
348221
+ return { ok: false, output: "[branch_read] Invalid arguments.", error: "Invalid arguments." };
348222
+ }
348223
+ }
348224
+ handleBranchCreate(args) {
348225
+ try {
348226
+ const params = JSON.parse(args || "{}");
348227
+ if (!this.branchCommunicationEnabled) return { ok: false, output: '[branch_create] Branch communication is not enabled for this conversation. Enable "\u5141\u8BB8\u5206\u652F\u4EA4\u6D41" at conversation creation time.', error: "branch communication disabled." };
348228
+ const messageIndex = Math.floor(Number(params.message_index ?? params.messageIndex ?? params.index));
348229
+ const prompt = String(params.prompt || params.message || params.text || "").trim();
348230
+ if (!Number.isFinite(messageIndex) || messageIndex < 0) return { ok: false, output: "[branch_create] message_index is required (0-based index of a user message in the conversation history, i.e. the historical block position).", error: "message_index is required." };
348231
+ if (!prompt) return { ok: false, output: "[branch_create] prompt is required (the new branch initial instruction).", error: "prompt is required." };
348232
+ const locator = {};
348233
+ if (params.message_id) locator.messageId = String(params.message_id);
348234
+ if (params.guide_id) locator.guideId = String(params.guide_id);
348235
+ if (params.client_message_id) locator.clientMessageId = String(params.client_message_id);
348236
+ if (params.run_id) locator.runId = String(params.run_id);
348237
+ const snapshot2 = this.branchConversation(this.activeConversationId || "default", messageIndex, prompt, locator);
348238
+ return {
348239
+ ok: true,
348240
+ output: JSON.stringify({
348241
+ ok: true,
348242
+ branchId: snapshot2.activeBranchId,
348243
+ runtimeBranchId: snapshot2.runtimeBranchId,
348244
+ messageIndex,
348245
+ prompt: prompt.slice(0, 240),
348246
+ branches: snapshot2.branches
348247
+ }, null, 2),
348248
+ metadata: { kind: "branch-create" }
348249
+ };
348250
+ } catch (e3) {
348251
+ return { ok: false, output: "[branch_create] " + (e3 instanceof Error ? e3.message : String(e3)), error: e3 instanceof Error ? e3.message : String(e3) };
348252
+ }
348253
+ }
347456
348254
  handleContextHistoryManage(args) {
347457
348255
  let input = {};
347458
348256
  try {
@@ -347496,16 +348294,21 @@ Review this persisted peer result and summarize or continue the parent task as n
347496
348294
  error: "remove position is in the protected context zone."
347497
348295
  };
347498
348296
  }
347499
- const removed = this.history.splice(position, 1)[0];
347500
- this.saveWorkspaceConversationState(true);
348297
+ const target = this.history[position];
348298
+ const fingerprint2 = this.historyRecordFingerprint(target);
348299
+ if (!this.pendingHistoryRemovals.some((item) => item.fingerprint === fingerprint2 && item.position === position)) {
348300
+ this.pendingHistoryRemovals.push({ position, fingerprint: fingerprint2 });
348301
+ }
347501
348302
  return {
347502
348303
  ok: true,
347503
348304
  output: JSON.stringify({
347504
348305
  ok: true,
347505
348306
  action: "remove",
347506
348307
  removedPosition: position,
347507
- removedRole: String(removed?.role || ""),
348308
+ removedRole: String(target?.role || ""),
348309
+ deferred: true,
347508
348310
  remaining: this.history.length,
348311
+ effectiveAt: "after the current Build Block ends; applies to subsequent Blocks only",
347509
348312
  displayHistory: { untouched: true, messageCount: this.chatMessages.length }
347510
348313
  }, null, 2),
347511
348314
  metadata: { kind: "context-history-remove" }
@@ -347700,9 +348503,17 @@ ${summary}`, segment, "local-summarize", true);
347700
348503
  maxTokens,
347701
348504
  triggerTokens: budget.triggerTokens,
347702
348505
  targetTokens: budget.targetTokens,
348506
+ buildBlockTokens: budget.buildBlockTokens,
348507
+ longHistoryTokens: budget.longHistoryTokens,
348508
+ buildBlockTriggerTokens: budget.buildBlockTriggerTokens,
348509
+ longHistoryTriggerTokens: budget.longHistoryTriggerTokens,
348510
+ buildBlockRetentionTokens: budget.buildBlockRetentionTokens,
348511
+ longHistoryRetentionTokens: budget.longHistoryRetentionTokens,
348512
+ buildBlockUsagePercent: maxTokens > 0 ? Math.round(budget.buildBlockTokens / maxTokens * 1e3) / 10 : 0,
348513
+ longHistoryUsagePercent: maxTokens > 0 ? Math.round(budget.longHistoryTokens / maxTokens * 1e3) / 10 : 0,
347703
348514
  summaryTokens: budget.summaryTokens,
347704
348515
  usagePercent: maxTokens > 0 ? Math.round(estimatedTokens / maxTokens * 1e3) / 10 : 0,
347705
- thresholdReached: budget.triggerTokens > 0 && estimatedTokens >= budget.triggerTokens,
348516
+ thresholdReached: budget.buildBlockTokens >= budget.buildBlockTriggerTokens || budget.longHistoryTokens >= budget.longHistoryTriggerTokens,
347706
348517
  keepRecentMessages: this.config.getNum("context", "keep_recent_messages") || 10,
347707
348518
  lastCompression: this.lastCompression ? {
347708
348519
  at: this.lastCompression.at,
@@ -347731,6 +348542,11 @@ ${summary}`, segment, "local-summarize", true);
347731
348542
  lastUserMessageIndex: lastUserIndex,
347732
348543
  protectedCount: protectedStartIndex >= 0 ? this.history.length - protectedStartIndex : 0
347733
348544
  },
348545
+ pendingRemovals: {
348546
+ count: this.pendingHistoryRemovals.length,
348547
+ positions: this.pendingHistoryRemovals.map((item) => item.position),
348548
+ effectiveAt: "after the current Build Block ends; applies to subsequent Blocks only"
348549
+ },
347734
348550
  displayHistory: { untouched: true, messageCount: this.chatMessages.length }
347735
348551
  }, null, 2),
347736
348552
  metadata: { kind: "context-history-status" }
@@ -347985,32 +348801,71 @@ ${summary}`, segment, "local-summarize", true);
347985
348801
  return names.find((n3) => n3.includes(this.model)) || this.model;
347986
348802
  }
347987
348803
  estimateContextTokens(messages = this.history) {
348804
+ return this.estimateContextTokenComponents(messages, 0).estimatedTokens;
348805
+ }
348806
+ estimateContextTokenComponents(messages, buildBlockStart) {
347988
348807
  let asciiChars = 0;
347989
348808
  let nonAsciiChars = 0;
347990
348809
  let structuralChars = 0;
347991
- for (const m2 of messages) {
348810
+ let longHistoryAsciiChars = 0;
348811
+ let longHistoryNonAsciiChars = 0;
348812
+ let longHistoryStructuralChars = 0;
348813
+ let buildBlockAsciiChars = 0;
348814
+ let buildBlockNonAsciiChars = 0;
348815
+ let buildBlockStructuralChars = 0;
348816
+ const boundary = Math.max(0, Math.min(messages.length, Math.floor(buildBlockStart)));
348817
+ for (let index = 0; index < messages.length; index += 1) {
348818
+ const m2 = messages[index];
347992
348819
  const content = typeof m2.content === "string" ? m2.content : JSON.stringify(m2.content || "");
347993
348820
  const toolCalls = Array.isArray(m2.tool_calls) ? JSON.stringify(m2.tool_calls) : "";
347994
348821
  const text = `${content}${toolCalls}`;
347995
348822
  const nonAscii = text.length - text.replace(/[\u0080-\uFFFF]/g, "").length;
347996
348823
  nonAsciiChars += nonAscii;
347997
348824
  asciiChars += Math.max(0, text.length - nonAscii);
347998
- if (typeof m2.content === "object" && m2.content) structuralChars += Math.max(0, content.length);
347999
- if (toolCalls) structuralChars += Math.max(0, toolCalls.length);
348825
+ const structural = (typeof m2.content === "object" && m2.content ? Math.max(0, content.length) : 0) + (toolCalls ? Math.max(0, toolCalls.length) : 0);
348826
+ structuralChars += structural;
348827
+ if (index < boundary) {
348828
+ longHistoryAsciiChars += Math.max(0, text.length - nonAscii);
348829
+ longHistoryNonAsciiChars += nonAscii;
348830
+ longHistoryStructuralChars += structural;
348831
+ } else {
348832
+ buildBlockAsciiChars += Math.max(0, text.length - nonAscii);
348833
+ buildBlockNonAsciiChars += nonAscii;
348834
+ buildBlockStructuralChars += structural;
348835
+ }
348000
348836
  }
348001
- return Math.max(1, Math.ceil(asciiChars / 4 + nonAsciiChars + structuralChars / 6));
348837
+ const estimate = (ascii2, nonAscii, structural, emptyIsZero = false) => {
348838
+ const raw = ascii2 / 4 + nonAscii + structural / 6;
348839
+ return emptyIsZero && raw <= 0 ? 0 : Math.max(1, Math.ceil(raw));
348840
+ };
348841
+ return {
348842
+ estimatedTokens: estimate(asciiChars, nonAsciiChars, structuralChars),
348843
+ longHistoryTokens: estimate(longHistoryAsciiChars, longHistoryNonAsciiChars, longHistoryStructuralChars, true),
348844
+ buildBlockTokens: estimate(buildBlockAsciiChars, buildBlockNonAsciiChars, buildBlockStructuralChars, true)
348845
+ };
348002
348846
  }
348003
348847
  contextWindow(modelName = this.model) {
348004
348848
  const estimatedTokens = this.estimateContextTokens();
348005
348849
  const model = this.resolveWindowModel(modelName);
348006
348850
  const maxTokens = Math.max(1, Number(model?.max_tokens || 0) || 128e3);
348007
348851
  const ratio = estimatedTokens / maxTokens;
348852
+ const budget = this.compressionBudget(this.history, modelName);
348008
348853
  return {
348009
348854
  estimatedTokens,
348010
348855
  maxTokens,
348011
348856
  ratio,
348012
348857
  warning: ratio >= 1 ? "over_limit" : ratio >= 0.85 ? "near_limit" : "ok",
348013
- model: modelName
348858
+ model: modelName,
348859
+ buildBlockTokens: budget.buildBlockTokens,
348860
+ longHistoryTokens: budget.longHistoryTokens,
348861
+ buildBlockTriggerTokens: budget.buildBlockTriggerTokens,
348862
+ longHistoryTriggerTokens: budget.longHistoryTriggerTokens,
348863
+ buildBlockRetentionTokens: budget.buildBlockRetentionTokens,
348864
+ longHistoryRetentionTokens: budget.longHistoryRetentionTokens,
348865
+ thresholdReached: budget.buildBlockTokens >= budget.buildBlockTriggerTokens || budget.longHistoryTokens >= budget.longHistoryTriggerTokens,
348866
+ compressionEnabled: this.config.getBool("context", "auto_compress"),
348867
+ cacheEntries: this.compressionCache.length,
348868
+ archiveEntries: this.compressionArchiveEntryCount()
348014
348869
  };
348015
348870
  }
348016
348871
  resolveWindowModel(modelName) {
@@ -348021,15 +348876,35 @@ ${summary}`, segment, "local-summarize", true);
348021
348876
  const model = this.resolveWindowModel(modelName);
348022
348877
  return Math.max(1, Number(model?.max_tokens || 0) || 128e3);
348023
348878
  }
348024
- compressionBudget(messages) {
348025
- const maxTokens = this.contextMaxTokens();
348879
+ compressionBudget(messages, modelName = this.model) {
348880
+ const maxTokens = this.contextMaxTokens(modelName);
348881
+ const buildBlockStart = this.compressionBuildBlockStart(messages);
348882
+ const estimates = this.estimateContextTokenComponents(messages, buildBlockStart);
348883
+ const buildBlockTriggerTokens = Math.max(128, Math.floor(maxTokens * 0.7));
348884
+ const longHistoryTriggerTokens = Math.max(128, Math.floor(maxTokens * 0.2));
348885
+ const longHistoryRetentionTokens = longHistoryTriggerTokens;
348026
348886
  return {
348027
- estimatedTokens: this.estimateContextTokens(messages),
348887
+ estimatedTokens: estimates.estimatedTokens,
348028
348888
  maxTokens,
348029
- triggerTokens: Math.max(128, Math.floor(maxTokens * 0.8)),
348030
- targetTokens: Math.max(128, Math.floor(maxTokens * 0.2)),
348031
- summaryTokens: Math.max(96, Math.min(1600, Math.floor(maxTokens * 0.12)))
348032
- };
348889
+ // Keep the legacy names for status consumers and older integrations:
348890
+ // triggerTokens is the active Build-block threshold and targetTokens is
348891
+ // the long-history summary budget.
348892
+ triggerTokens: buildBlockTriggerTokens,
348893
+ targetTokens: longHistoryRetentionTokens,
348894
+ summaryTokens: Math.max(96, Math.min(1600, Math.floor(maxTokens * 0.12))),
348895
+ buildBlockTokens: estimates.buildBlockTokens,
348896
+ longHistoryTokens: estimates.longHistoryTokens,
348897
+ buildBlockTriggerTokens,
348898
+ longHistoryTriggerTokens,
348899
+ buildBlockRetentionTokens: buildBlockTriggerTokens,
348900
+ longHistoryRetentionTokens
348901
+ };
348902
+ }
348903
+ compressionBuildBlockStart(messages) {
348904
+ const activeRunId = this.currentWorkRunId();
348905
+ if (!activeRunId) return 0;
348906
+ const index = messages.findIndex((message) => String(message.run_id || message.runId || "") === activeRunId);
348907
+ return index >= 0 ? index : 0;
348033
348908
  }
348034
348909
  recentContextSuffix(messages, maxMessages, tokenBudget) {
348035
348910
  if (!messages.length) return [];
@@ -349199,30 +350074,77 @@ ${msg.content}
349199
350074
  return new LLMProvider(m2.provider, m2.provider_url, m2.api_key, m2.provider_protocol, this.config.openAIApiMode(), this.config.contextFlag("provider_adapters_v2"));
349200
350075
  }
349201
350076
  async editorModelRequest(input, signal) {
349202
- const models = this.config.allModels().filter((model) => (model.evaluation?.status || "unvalidated") !== "unavailable" && !String(model.evaluation?.status || "").startsWith("error"));
350077
+ const models = this.config.allModels().filter((model) => {
350078
+ if (model.enabled === false) return false;
350079
+ if (!String(model.api_key || "").trim() || !String(model.provider_url || "").trim()) return false;
350080
+ const statuses = [model.evaluation?.status, model.validation?.status].map((status) => String(status || "").trim().toLowerCase()).filter(Boolean);
350081
+ if (statuses.some((status) => status === "auth_error" || status === "invalid_config" || status.startsWith("error"))) return false;
350082
+ const hasPositiveEvidence = statuses.some((status) => status === "available" || status === "verified" || status === "degraded" || status === "rate_limited");
350083
+ return !statuses.length || hasPositiveEvidence;
350084
+ });
349203
350085
  const current = this.activeModelConfig();
349204
350086
  const copilot = input.preferCopilot ? models.find((model) => model.provider_protocol === "github_models" && model.enabled !== false) : void 0;
349205
350087
  const selected = copilot || current && models.find((model) => model.provider_id === current.provider_id && model.name === current.name) || models.find(
349206
- (model) => (model.validation?.level === "standard" || model.validation?.level === "extended") && (model.validation.status === "verified" || model.validation.status === "degraded")
350088
+ (model) => (model.validation?.level === "standard" || model.validation?.level === "extended") && (model.validation?.status === "verified" || model.validation?.status === "degraded")
349207
350089
  ) || models.find((model) => model.evaluation?.status === "available") || models[0];
349208
350090
  if (!selected?.api_key || !selected.provider_url) return { ok: false, text: "", error: "No available editor prediction model." };
349209
- const provider = new LLMProvider(selected.provider, selected.provider_url, selected.api_key, selected.provider_protocol, this.config.openAIApiMode(), this.config.contextFlag("provider_adapters_v2"));
350091
+ const provider = input.completion ? new LLMProvider(selected.provider, selected.provider_url, selected.api_key, selected.provider_protocol, "chat_stream", this.config.contextFlag("provider_adapters_v2"), EDITOR_COMPLETION_TIMEOUT_MS) : new LLMProvider(selected.provider, selected.provider_url, selected.api_key, selected.provider_protocol, this.config.openAIApiMode(), this.config.contextFlag("provider_adapters_v2"));
349210
350092
  const language = path28.extname(String(input.path || "")).replace(/^\./, "") || "text";
349211
350093
  const system = input.completion ? "You are an inline code completion engine. Return only the exact text to insert at the cursor. Do not use Markdown fences or explanations." : "You are Newmark Editor Agent. Give concise, actionable code guidance grounded in the supplied file and selection. Do not claim changes were applied.";
350094
+ const before = String(input.before || "").slice(-EDITOR_COMPLETION_BEFORE_CONTEXT_CHARS);
350095
+ const after = String(input.after || "").slice(0, EDITOR_COMPLETION_AFTER_CONTEXT_CHARS);
349212
350096
  const prompt = input.completion ? `Language: ${language}
349213
350097
  File: ${input.path || ""}
349214
- Recent code before cursor:
349215
- ${String(input.before || "").slice(-6e3)}
350098
+ Code before cursor:
350099
+ ${before}
349216
350100
  Code after cursor:
349217
- ${String(input.after || "").slice(0, 1600)}
349218
- Return the shortest syntactically complete continuation.` : `File: ${input.path || ""}
350101
+ ${after}
350102
+ Return only the shortest useful continuation.` : `File: ${input.path || ""}
349219
350103
  Instruction: ${input.instruction || "Review the current code and suggest the next useful change."}
349220
350104
  Selection:
349221
350105
  ${String(input.selection || "").slice(0, 8e3)}
349222
350106
  File content:
349223
350107
  ${String(input.content || "").slice(0, 18e3)}`;
349224
350108
  try {
349225
- const text = (await provider.chat(selected.name, [{ role: "user", content: prompt }], system, 0.05, input.completion ? 192 : 1800, signal)).replace(/^```[\w-]*\s*|\s*```$/g, "");
350109
+ const messages = [{ role: "user", content: prompt }];
350110
+ let rawText = "";
350111
+ const canStreamCompletion = !!input.completion && typeof input.onTextDelta === "function" && (selected.provider_protocol !== "openai" || this.config.contextFlag("provider_adapters_v2"));
350112
+ if (canStreamCompletion) {
350113
+ const streamed = [];
350114
+ let streamFailure = null;
350115
+ try {
350116
+ for await (const token of provider.chatStreamWithTools(
350117
+ selected.name,
350118
+ messages,
350119
+ system,
350120
+ 0.05,
350121
+ EDITOR_COMPLETION_MAX_TOKENS,
350122
+ [],
350123
+ signal
350124
+ )) {
350125
+ if (token.type !== "text" || !token.text) continue;
350126
+ const delta = String(token.text);
350127
+ if (/^\[(?:LLM )?Error\b/i.test(delta)) {
350128
+ streamFailure = new Error(delta);
350129
+ continue;
350130
+ }
350131
+ streamed.push(delta);
350132
+ input.onTextDelta?.(delta);
350133
+ }
350134
+ } catch (error) {
350135
+ if (signal?.aborted) throw error;
350136
+ streamFailure = error instanceof Error ? error : new Error(String(error));
350137
+ }
350138
+ if (streamFailure) {
350139
+ rawText = await provider.chat(selected.name, messages, system, 0.05, EDITOR_COMPLETION_MAX_TOKENS, signal);
350140
+ } else {
350141
+ rawText = streamed.join("");
350142
+ }
350143
+ } else {
350144
+ rawText = await provider.chat(selected.name, messages, system, 0.05, input.completion ? EDITOR_COMPLETION_MAX_TOKENS : 1800, signal);
350145
+ }
350146
+ rawText = rawText.replace(/^```[\w-]*\s*|\s*```$/g, "");
350147
+ const text = rawText.trim() ? rawText.slice(0, input.completion ? EDITOR_COMPLETION_MAX_TEXT_CHARS : rawText.length) : "";
349226
350148
  return { ok: !!text, text, model: selected.name, provider: selected.provider };
349227
350149
  } catch (error) {
349228
350150
  return { ok: false, text: "", model: selected.name, provider: selected.provider, error: error instanceof Error ? error.message : String(error) };
@@ -349728,7 +350650,7 @@ ${settled?.result || settled?.error || ""}`.trim();
349728
350650
  const name50 = params.name || params.id || "";
349729
350651
  const sa = this.subagents.get(name50);
349730
350652
  if (!sa) return { ok: false, output: `[Subagent] Not found: ${name50}`, error: `Not found: ${name50}` };
349731
- const transcript = sa.messages.map((m2) => `[${m2.role}] ${m2.content}`).join("\n");
350653
+ const transcript = this.subagents.boundedResultTranscript(sa.id);
349732
350654
  return this.subagents.toToolResult(
349733
350655
  sa.id,
349734
350656
  `get.subagent("${sa.name}", id="${sa.id}")
@@ -349739,7 +350661,7 @@ Mode: ${sa.agentMode}
349739
350661
  Result:
349740
350662
  ${sa.result || ""}
349741
350663
 
349742
- Conversation:
350664
+ Recent Conversation (bounded):
349743
350665
  ${transcript}`,
349744
350666
  true
349745
350667
  );
@@ -350272,7 +351194,7 @@ ${items.map((item) => this.formatAutomation(item)).join("\n")}`;
350272
351194
  const continuation = (reason === "mailbox" || reason === "resume") && persistedMessages.length ? "[Peer Job Continuation]\nYou are continuing the same peer run from the transcript below. The preceding turns are your working history, not a task to redo. Continue the active task, honoring the newest instruction at the bottom. Do not restart, restate, or summarize what was already done; only produce the next step." : "";
350273
351195
  const delegatedPrompt = [
350274
351196
  continuation,
350275
- requestedFlowName ? `[Workflow requested: ${requestedFlowName} @ ${child.flowPc}]` : "",
351197
+ requestedFlowName ? `[Workflow requested: ${requestedFlowName}]` : "",
350276
351198
  child.goal ? `[Goal objective: ${child.goal.objective}]` : "",
350277
351199
  `Workspace: ${workspacePath}`,
350278
351200
  prompt
@@ -350523,21 +351445,25 @@ Falling back to built-in engine.` }];
350523
351445
  if (!this.config.getBool("context", "auto_compress")) return false;
350524
351446
  const total = msgs.reduce((sum, m2) => sum + (typeof m2.content === "string" ? m2.content.length : JSON.stringify(m2.content || "").length), 0);
350525
351447
  const budget = this.compressionBudget(msgs);
350526
- if (budget.estimatedTokens < budget.triggerTokens && !force) return false;
350527
- if (!force && this.lastCompression && String(msgs[0]?.content || "").includes(this.lastCompression.summary)) {
351448
+ const thresholdReached = budget.buildBlockTokens >= budget.buildBlockTriggerTokens || budget.longHistoryTokens >= budget.longHistoryTriggerTokens;
351449
+ if (!thresholdReached && !force) return false;
351450
+ const priorSummary = String(this.lastCompression?.summary || "").trim();
351451
+ const priorSummaryMarker = priorSummary.slice(0, 240);
351452
+ const priorSummaryPresent = !!priorSummaryMarker && msgs.some((message) => String(message.content || "").includes(priorSummaryMarker));
351453
+ if (!force && this.lastCompression && priorSummaryPresent) {
350528
351454
  const baselineChars = Math.max(0, Number(this.lastCompression.compressedChars || 0));
350529
351455
  const baselineTokens = Math.max(0, Number(this.lastCompression.compressedTokens || 0));
350530
351456
  const charGrowth = baselineChars ? Math.max(0, total - baselineChars) : Number.POSITIVE_INFINITY;
350531
351457
  const tokenGrowth = baselineTokens ? Math.max(0, budget.estimatedTokens - baselineTokens) : Number.POSITIVE_INFINITY;
350532
351458
  const minCharGrowth = Math.max(12e3, Math.floor(baselineChars * 0.25));
350533
- const minTokenGrowth = Math.max(1024, Math.floor(budget.triggerTokens * 0.2));
351459
+ const minTokenGrowth = Math.max(1024, Math.floor(budget.buildBlockTriggerTokens * 0.2));
350534
351460
  if (charGrowth < minCharGrowth && tokenGrowth < minTokenGrowth) return false;
350535
351461
  }
350536
351462
  const originalMessageCount = msgs.length;
350537
351463
  const configuredKeepLast = this.config.getNum("context", "keep_recent_messages") || 10;
350538
351464
  if (msgs.length <= 1) return false;
350539
351465
  const continuationAnchorTokens = this.estimateContextTokens([this.postCompressionContinuationMessage()]);
350540
- const recentBudget = Math.max(64, budget.targetTokens - budget.summaryTokens - continuationAnchorTokens);
351466
+ const recentBudget = Math.max(64, budget.buildBlockRetentionTokens - budget.summaryTokens - continuationAnchorTokens);
350541
351467
  const recent = this.recentContextSuffix(msgs, configuredKeepLast, recentBudget);
350542
351468
  const recentStart = Math.max(0, msgs.length - recent.length);
350543
351469
  if (recentStart <= 0) return false;
@@ -350608,19 +351534,35 @@ ${content}`;
350608
351534
  if (!provider) return { summary: fallbackSummary, model: "local-fallback", fallback: true };
350609
351535
  try {
350610
351536
  const { temperature } = provider.intelligenceConfig("low");
350611
- const system = [
350612
- "You are Newmark context compression.",
350613
- "Summarize an older omitted conversation segment for a coding agent. The latest retained user instruction is outside this segment and remains authoritative.",
351537
+ const system = this.buildSystemPrompt();
351538
+ const prunedPrefixMessages = middle.map((message) => {
351539
+ const record = message;
351540
+ const role = String(record.role || "");
351541
+ const isToolResult = role === "tool" || role === "function";
351542
+ const content = record.content;
351543
+ if (isToolResult && typeof content === "string" && content.length > TOOL_RESULT_PRUNE_CHARS) {
351544
+ return {
351545
+ ...message,
351546
+ content: this.pruneToolResultContent(content)
351547
+ };
351548
+ }
351549
+ return message;
351550
+ });
351551
+ const prefixMessages = prunedPrefixMessages.map((message) => {
351552
+ if (!Array.isArray(message.content)) return { ...message };
351553
+ const parts = message.content.map((part) => part?.type === "image_url" ? { type: "text", text: "[Historical image attachment omitted after context compression.]" } : { ...part });
351554
+ return { ...message, content: parts };
351555
+ });
351556
+ const prompt = [
351557
+ "Compress the following conversation segment into a structured checkpoint for this coding assistant.",
351558
+ "The omitted transcript below is the conversation ABOVE this instruction; the latest retained user instruction is OUTSIDE the segment and remains authoritative.",
351559
+ "",
350614
351560
  "Classify task state instead of treating every historical user request as still active.",
350615
351561
  "Preserve an older task as active or unfinished only when the transcript or explicit tracker shows concrete unfinished work and it remains relevant to the latest instruction or a required dependency.",
350616
351562
  "Within Active Or Unfinished Work, order every retained historical task from newest to oldest. The newest unfinished task must be completed before the next-newest task.",
350617
351563
  "Completed, superseded, abandoned, and unrelated tasks belong under Completed Or Background Work and must not be revived as the current objective.",
350618
351564
  "Preserve concrete facts, current workspace, mode, model, tool results, files changed, decisions, errors, constraints, and user preferences.",
350619
351565
  "Do not invent completion. Mark uncertainty explicitly.",
350620
- "Return concise Markdown with these stable headings: Active Or Unfinished Work; Completed Or Background Work; Decisions And Constraints; Tool And Verification Evidence; Relevant Files."
350621
- ].join("\n");
350622
- const prompt = [
350623
- "Compress the following conversation segment.",
350624
351566
  "",
350625
351567
  "Required metadata to preserve:",
350626
351568
  meta,
@@ -350628,16 +351570,16 @@ ${content}`;
350628
351570
  `Original message count in omitted segment: ${middle.length}`,
350629
351571
  `Original total message chars before compression: ${totalChars}`,
350630
351572
  "",
350631
- "Latest retained user instruction (authoritative and not part of the omitted transcript):",
351573
+ "Latest retained user instruction (authoritative and not part of the omitted segment):",
350632
351574
  currentInstruction || "(No retained user text was available; preserve uncertainty and do not promote old tasks without evidence.)",
350633
351575
  "",
350634
- "Omitted transcript:",
350635
- transcript
351576
+ "Return ONLY concise Markdown with these stable headings:",
351577
+ "Active Or Unfinished Work; Completed Or Background Work; Decisions And Constraints; Tool And Verification Evidence; Relevant Files."
350636
351578
  ].join("\n");
350637
351579
  const modelName = String(compressionModel || this.activeModelName()).trim();
350638
351580
  if (!modelName) return { summary: fallbackSummary, model: "local-fallback", fallback: true };
350639
351581
  const generated = await this.withTimeout(
350640
- provider.chat(modelName, [{ role: "user", content: prompt }], system, temperature, budget.summaryTokens, signal),
351582
+ provider.chat(modelName, [...prefixMessages, { role: "user", content: prompt }], system, temperature, budget.summaryTokens, signal),
350641
351583
  12e4
350642
351584
  );
350643
351585
  const generatedText = String(generated || "").trim();
@@ -350681,6 +351623,20 @@ ${content}`;
350681
351623
  }
350682
351624
  return "";
350683
351625
  }
351626
+ /** 裁剪超长工具结果:保留头部结论性内容 + 尾部证据(路径/错误/收尾),
351627
+ * 中间用占位标记省略。与 DSH toolResultPruner 的语义一致。 */
351628
+ pruneToolResultContent(content) {
351629
+ const text = String(content || "");
351630
+ const headChars = Math.floor(TOOL_RESULT_PRUNE_CHARS * 0.6);
351631
+ const tailChars = Math.max(0, TOOL_RESULT_PRUNE_CHARS - headChars - 48);
351632
+ const head = text.slice(0, headChars).trimEnd();
351633
+ const tail = text.slice(-tailChars).trimStart();
351634
+ return `${head}
351635
+
351636
+ [...tool result pruned ${text.length - headChars - tailChars} chars...]
351637
+
351638
+ ${tail}`;
351639
+ }
350684
351640
  compressionHistoryContent(content) {
350685
351641
  if (!Array.isArray(content)) return String(content || "");
350686
351642
  return content.map((part) => {
@@ -350739,6 +351695,15 @@ ${text.slice(-tailChars).trimStart()}`;
350739
351695
  return [];
350740
351696
  }
350741
351697
  }
351698
+ compressionArchiveEntryCount() {
351699
+ const scopeKey = this.compressionArchiveScopeKey();
351700
+ if (!scopeKey) return 0;
351701
+ if (this.compressionArchiveCountCache?.scopeKey === scopeKey) return this.compressionArchiveCountCache.count;
351702
+ const hotIds = new Set(this.compressionCache.map((entry) => entry.id));
351703
+ const count = this.compressionHistoryArchive.activeEntries(scopeKey).filter((entry) => !hotIds.has(entry.id)).length;
351704
+ this.compressionArchiveCountCache = { scopeKey, count };
351705
+ return count;
351706
+ }
350742
351707
  archiveColdCompressionEntries(entries) {
350743
351708
  const scopeKey = this.compressionArchiveScopeKey();
350744
351709
  if (!scopeKey) return [];
@@ -350757,6 +351722,7 @@ ${text.slice(-tailChars).trimStart()}`;
350757
351722
  if (!scopeKey) return;
350758
351723
  try {
350759
351724
  this.compressionHistoryArchive.markRestored(scopeKey, id);
351725
+ this.compressionArchiveCountCache = null;
350760
351726
  } catch {
350761
351727
  }
350762
351728
  }
@@ -350789,6 +351755,7 @@ ${text.slice(-tailChars).trimStart()}`;
350789
351755
  const failed = this.archiveColdCompressionEntries(evicted);
350790
351756
  this.compressionCache = [...failed, ...this.compressionCache.slice(this.compressionCache.length - maxEntries)];
350791
351757
  }
351758
+ this.compressionArchiveCountCache = null;
350792
351759
  this.saveWorkspaceConversationState(true);
350793
351760
  }
350794
351761
  contextHistoryProtectedStartIndex() {
@@ -350799,6 +351766,30 @@ ${text.slice(-tailChars).trimStart()}`;
350799
351766
  if (lastUserIndex >= 0) candidates.push(lastUserIndex);
350800
351767
  return candidates.length ? Math.min(...candidates) : -1;
350801
351768
  }
351769
+ historyRecordFingerprint(record) {
351770
+ if (!record) return "";
351771
+ return `${String(record.role || "")}\0${JSON.stringify(record.content ?? "")}`;
351772
+ }
351773
+ flushPendingHistoryRemovals() {
351774
+ if (!this.pendingHistoryRemovals.length) return;
351775
+ const pending3 = this.pendingHistoryRemovals;
351776
+ this.pendingHistoryRemovals = [];
351777
+ const ordered = pending3.slice().sort((a3, b2) => b2.position - a3.position);
351778
+ for (const item of ordered) {
351779
+ const atPosition = this.history[item.position];
351780
+ if (atPosition && this.historyRecordFingerprint(atPosition) === item.fingerprint) {
351781
+ this.history.splice(item.position, 1);
351782
+ continue;
351783
+ }
351784
+ for (let i4 = this.history.length - 1; i4 >= 0; i4 -= 1) {
351785
+ if (this.historyRecordFingerprint(this.history[i4]) === item.fingerprint) {
351786
+ this.history.splice(i4, 1);
351787
+ break;
351788
+ }
351789
+ }
351790
+ }
351791
+ this.saveWorkspaceConversationState(true);
351792
+ }
350802
351793
  contextHistoryProtectedZone() {
350803
351794
  const start = this.contextHistoryProtectedStartIndex();
350804
351795
  const zone = /* @__PURE__ */ new Set();
@@ -350816,9 +351807,6 @@ ${text.slice(-tailChars).trimStart()}`;
350816
351807
  buildSystemPrompt() {
350817
351808
  const cwd = this.workspace.current?.path || this.rootPath;
350818
351809
  const enabledSkills = this.skills.active();
350819
- const currentSkillTask = this.latestUserHistoryText(this.history);
350820
- const relevantSkills = this.skills.search(currentSkillTask, 8);
350821
- const linkedPlan = this.getLinkedPlan();
350822
351810
  const globalPromptPath = path28.join(this.rootPath, "agent.md");
350823
351811
  const globalPrompt = normalizeInjectedPrompt(fs25.existsSync(globalPromptPath) ? fs25.readFileSync(globalPromptPath, "utf-8") : "");
350824
351812
  const workspacePrompt = normalizeInjectedPrompt(this.workspace.currentAgentPrompt());
@@ -350827,7 +351815,6 @@ ${text.slice(-tailChars).trimStart()}`;
350827
351815
  mode: this.mode,
350828
351816
  conversationId: this.activeConversationId,
350829
351817
  subagent: this.isSubagentRuntime ? [this.subagentName, this.subagentPrompt] : null,
350830
- linkedPlanRevision: linkedPlan.revision,
350831
351818
  goal: this.goal ? [this.goal.objective, this.goal.paused] : null,
350832
351819
  promptMode: this.config.getStr("workspace", "prompt_mode"),
350833
351820
  customPrompt: this.config.getStr("agent", "custom_prompt"),
@@ -350836,8 +351823,7 @@ ${text.slice(-tailChars).trimStart()}`;
350836
351823
  optionFeedback: this.config.getStr("agent", "option_feedback"),
350837
351824
  model: this.model,
350838
351825
  intelligence: this.intelligence,
350839
- skills: enabledSkills.map((skill) => [skill.name, skill.description]),
350840
- relevantSkills: relevantSkills.map((skill) => [skill.name, skill.description]),
351826
+ skills: enabledSkills.slice(0, 8).map((skill) => [skill.name, skill.description]),
350841
351827
  globalPrompt,
350842
351828
  workspacePrompt
350843
351829
  });
@@ -350862,8 +351848,6 @@ When using file tools (read, write, edit, glob), use ABSOLUTE paths rooted at th
350862
351848
  parts.push(this.buildFeatureDisclosurePrompt());
350863
351849
  if (this.mode === "plan") parts.push(`[Plan Tool Policy]
350864
351850
  ${planModePolicyPrompt()}`);
350865
- parts.push(`[Linked Plan revision=${linkedPlan.revision}]
350866
- ${linkedPlan.markdown || "(empty)"}`);
350867
351851
  const pm = this.config.getStr("workspace", "prompt_mode") || "both";
350868
351852
  const injectedPrompts = /* @__PURE__ */ new Set();
350869
351853
  if ((pm === "global_only" || pm === "both") && globalPrompt) {
@@ -350884,7 +351868,7 @@ ${custom}`);
350884
351868
  if (enabledSkills.length) {
350885
351869
  parts.push([
350886
351870
  "[Enabled Skills]",
350887
- ...(!currentSkillTask ? enabledSkills.slice(0, 8) : relevantSkills).map((s3) => `- ${s3.name}: ${s3.description || "No description"}`),
351871
+ ...enabledSkills.slice(0, 8).map((s3) => `- ${s3.name}: ${s3.description || "No description"}`),
350888
351872
  "Use the skill tool with query when the matching skill is uncertain, then load exactly one skill by name. Skill bodies and paths are intentionally omitted until loaded. Disabled skills are intentionally omitted."
350889
351873
  ].join("\n"));
350890
351874
  }
@@ -350897,18 +351881,21 @@ ${custom}`);
350897
351881
  }
350898
351882
  parts.push(this.buildModePrompt());
350899
351883
  const value = this.contextV2.orchestrator.assemble({
350900
- generalPrompt: parts[0] ?? "",
350901
- responseProtocol: parts[1] ?? "",
351884
+ // Keep the complete base prompt in one stable section. The linked_plan
351885
+ // section remains structurally present for Context V2 compatibility but
351886
+ // is intentionally empty: plan contents are retrieved through the tool.
351887
+ generalPrompt: parts.filter(Boolean).join("\n\n"),
351888
+ responseProtocol: "",
350902
351889
  baseToolDefinitions: void 0,
350903
- workspaceAgentProfile: parts[2] ?? "",
350904
- agentRoleAndPermissions: parts[3] ?? "",
350905
- capabilityBoundarySummary: parts[4] ?? "",
350906
- activeToolsetManifest: parts[5] ?? "",
350907
- buildBlockStartupInput: parts[6] ?? "",
350908
- buildBlockMetadata: parts[7] ?? "",
350909
- linkedPlan: parts[8] ?? "",
350910
- activeTasks: parts[9] ?? "",
350911
- currentWorkSet: parts[10] ?? "",
351890
+ workspaceAgentProfile: "",
351891
+ agentRoleAndPermissions: "",
351892
+ capabilityBoundarySummary: "",
351893
+ activeToolsetManifest: "",
351894
+ buildBlockStartupInput: "",
351895
+ buildBlockMetadata: "",
351896
+ linkedPlan: "",
351897
+ activeTasks: "",
351898
+ currentWorkSet: "",
350912
351899
  branchLogSummary: "",
350913
351900
  retrievedOldBlockSummary: "",
350914
351901
  buildHistoryCheckpoint: "",
@@ -350923,11 +351910,9 @@ ${custom}`);
350923
351910
  * dev-0.3.0: assemble the model-request system prompt through the Context
350924
351911
  * Orchestrator, the single assembly point for every model request. No inline
350925
351912
  * prompt concatenation remains in agent.ts: buildSystemPrompt() itself
350926
- * routes its section content through the orchestrator (byte-identical to the
350927
- * legacy parts.join), and this method appends the tool surface notice.
350928
- * Later iterations split content into the fixed 18 sections with exact
350929
- * semantics; for now the legacy sections occupy the first string slots in
350930
- * their original order and empty sections are skipped.
351913
+ * routes its stable base prompt through the orchestrator, and this method
351914
+ * appends the tool surface notice. The linked-plan section is deliberately
351915
+ * empty here; linked-plan content is tool-retrieved on demand.
350931
351916
  */
350932
351917
  assembleContextV2(toolSurfaceNotice) {
350933
351918
  return this.contextV2.orchestrator.assemble({
@@ -350994,6 +351979,7 @@ ${custom}`);
350994
351979
  "- Before memory_lab_update, inspect the target with memory_lab_query or memory_lab_read. For an existing component pass expectedUpdatedAt so concurrent/stale writes fail closed; preserve established tag parent paths.",
350995
351980
  "- Use memory_lab_delete only for an explicit user request to forget/remove memory. Prior revisions are retained under Memory Lab/archive and mutation decisions are appended to policy.jsonl for replay.",
350996
351981
  "- Build history disclosure is two-layered. The request prompt contains only each historical Build Block user input, final summary, and completion status. Use build_history_query only when the current user asks what specifically happened in one Build Block; querying history is read-only and never authorizes resuming that work.",
351982
+ "- Linked plan disclosure: a durable conversation-linked Markdown plan exists and can be inspected or updated with linked_plan when explicitly needed or required by Plan mode. Its full Markdown and revision are not injected into every model request.",
350997
351983
  "- A memory_lab_update, memory_lab_delete, or memory_lab_reindex call is unfinished until its awaited tool result contains rebuildReceipt.completed=true. The completion receipt is represented by the tool activity inside the current Build block and should not be repeated as a separate completion message.",
350998
351984
  `- Skills and subagents: skill searches enabled metadata and loads one SKILL.md body on demand; skill_download installs offline skill folders; task creates constrained subagents tracked in agent state.`,
350999
351985
  `- Visible output contract: assistant replies are sanitized before display to remove hidden-reasoning markers. ${visibleOutputContract}`,
@@ -351737,6 +352723,33 @@ var ConversationKernel = class {
351737
352723
  at: (/* @__PURE__ */ new Date()).toISOString()
351738
352724
  };
351739
352725
  }
352726
+ async compressContext(target, options = {}) {
352727
+ const normalized = this.normalizeTarget(target);
352728
+ const runtime = this.findRuntime(normalized);
352729
+ if (runtime?.activePromise) {
352730
+ return { ok: false, error: "Context compression is unavailable while this conversation is running." };
352731
+ }
352732
+ const runner = runtime?.runner || this.createRunner(normalized);
352733
+ const result = await runner.handleContextCompress(JSON.stringify({
352734
+ keep_recent: options.keepRecent,
352735
+ force: options.force !== false
352736
+ }));
352737
+ let payload = {};
352738
+ try {
352739
+ const parsed = JSON.parse(result.output || "{}");
352740
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) payload = parsed;
352741
+ } catch {
352742
+ payload = { output: result.output };
352743
+ }
352744
+ return {
352745
+ ...payload,
352746
+ ok: result.ok && payload.ok !== false,
352747
+ error: result.error,
352748
+ contextWindow: runner.contextWindow(),
352749
+ contextCompression: runner.lastCompression,
352750
+ displayHistory: { untouched: true, messageCount: runner.chatMessages.length }
352751
+ };
352752
+ }
351740
352753
  rateAutoRoute(target, score, expectedRouteId = "") {
351741
352754
  const runtime = this.findRuntime(target);
351742
352755
  if (!runtime) return { ok: false, reason: "no_active_auto_route" };
@@ -352624,6 +353637,9 @@ async function handle(request) {
352624
353637
  });
352625
353638
  }
352626
353639
  if (request.method === "checkpoint") return kernel.checkpoint(checkedTarget(request.params.target));
353640
+ if (request.method === "context_compress") {
353641
+ return kernel.compressContext(checkedTarget(request.params.target), request.params.options);
353642
+ }
352627
353643
  if (request.method === "rate_auto_route") {
352628
353644
  return kernel.rateAutoRoute(
352629
353645
  checkedTarget(request.params.target),