nolo-cli 0.83.0-alpha.2 → 0.83.0

package/{chunk-2OVE3GVB.js → chunk-6VFARHZW.js}

@@ -8,18 +8,19 @@ import {
   readSseFrames,
   streamSseDataValues,
   throwIfChatCompletionStreamFailed
-} from "./chunk-QC5LGHYP.js";
+} from "./chunk-ZCYXJSTU.js";
 import {
   DEVIN_CONNECT_URL
-} from "./chunk-FMODTASJ.js";
+} from "./chunk-Q5FJJ6XI.js";
 import {
   clipToolText,
   hasImageInRuntimeMessages,
+  resolveAgentContextWindow,
   resolveAgentImageInputSupport,
   resolveHistoricalToolContentCap,
   resolveToolOutputProfile,
   stripImagePartsFromMessages
-} from "./chunk-KIS76A2P.js";
+} from "./chunk-5H7KJX7J.js";
 import {
   downgradeUnparsableToolCalls,
   hasParsableObjectArguments,
@@ -37,13 +38,15 @@ import {
   TOOL_GUIDED_SECTION_ORDER,
   buildIdentityBlock,
   buildRuntimeGuidanceBlocks,
+  detectDispatchIntent,
+  detectDispatchIntentFromMessages,
   estimateContextTokens,
   hashStablePrefixContent,
   normalizeChatCompletionsBodyForProvider,
   requiresBareImageUrl,
   resolveToolGuidedSections,
   toBareImageUrlMessages
-} from "./chunk-CPSZJBLK.js";
+} from "./chunk-L5UXH3B2.js";
 import {
   convertMessagesToResponsesInput,
   extractReasoningFromResponseOutput,
@@ -67,16 +70,16 @@ import {
   parseNoloWorkspaceToolArguments,
   readTextStreamUpToChars,
   resolveNoloDialogInput
-} from "./chunk-ZVN6I33J.js";
+} from "./chunk-IIVGDG4I.js";
 import {
   getAntigravityUserAgent,
   readAntigravityProjectId,
   resolveAntigravityCloudCodeBaseUrl
-} from "./chunk-PGSKWZCB.js";
+} from "./chunk-UZGQNTVW.js";
 import {
   buildProviderAuthHeaders,
   buildProviderExecutionPlan
-} from "./chunk-CMH2SYHX.js";
+} from "./chunk-6OZ36FXI.js";
 import {
   buildDialogFallbackTitleFromUserInput
 } from "./chunk-2MBTWINN.js";
@@ -90,7 +93,7 @@ import {
   resolveEmptyAssistantFallbackMessage,
   resolveEmptyAssistantOutcome,
   resolveTruncatedReasoningTailLog
-} from "./chunk-DSRXPQWA.js";
+} from "./chunk-4OEFYTWL.js";
 import {
   COMPACTION_SUMMARY_SCHEMA_VERSION,
   COMPACTION_SUMMARY_SYSTEM_PROMPT,
@@ -109,7 +112,7 @@ import {
   resolveCompressionTriggerRatio,
   truncateToolOutputForContext,
   withProviderCallTimingFields
-} from "./chunk-E36HZARC.js";
+} from "./chunk-DNCEALKX.js";
 import {
   estimateTokenCount
 } from "./chunk-PSCNXBYA.js";
@@ -133,27 +136,25 @@ import {
   asRecordOrEmpty
 } from "./chunk-KX6YBIHG.js";
 import {
+  asTrimmedNonEmptyStringArray,
   dialogMessageKey,
   dialogMessageRange
-} from "./chunk-NHRQCXIQ.js";
+} from "./chunk-VMFTFOWF.js";
 import {
   asOptionalFiniteNumber
 } from "./chunk-WWC7I6TA.js";
-import {
-  asTrimmedNonEmptyStringArray
-} from "./chunk-I42VC5KR.js";
 import {
   asTrimmedLowercaseString
 } from "./chunk-QSJ3HFEF.js";
+import {
+  isRecord
+} from "./chunk-KUG52IAP.js";
 import {
   asTrimmedString
 } from "./chunk-3EUW3WEO.js";
 import {
   asOptionalPositiveFiniteNumber
 } from "./chunk-U6VC4MU4.js";
-import {
-  isRecord
-} from "./chunk-KUG52IAP.js";
 import {
   normalizeServerOrigin
 } from "./chunk-CF7PE763.js";
@@ -12203,8 +12204,208 @@ function summarizeToolArguments(toolName, rawArgs) {
   );
 }
 
+// packages/agent-runtime/progressGuard.ts
+var DEFAULT_MAX_CONSECUTIVE_IDENTICAL_ROUNDS = 5;
+var DEFAULT_MAX_CONSECUTIVE_STAGNANT_TOOL_ROUNDS = 8;
+function sortJsonKeys(obj) {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) return obj.map(sortJsonKeys);
+  const sorted = {};
+  for (const key of Object.keys(obj).sort()) {
+    sorted[key] = sortJsonKeys(obj[key]);
+  }
+  return sorted;
+}
+function normalizeToolArguments(rawArgs) {
+  if (typeof rawArgs !== "string") {
+    try {
+      return JSON.stringify(sortJsonKeys(rawArgs ?? ""));
+    } catch {
+      return String(rawArgs ?? "");
+    }
+  }
+  const trimmed = rawArgs.trim();
+  if (!trimmed) return "";
+  try {
+    const parsed = JSON.parse(trimmed);
+    return JSON.stringify(sortJsonKeys(parsed));
+  } catch {
+    return trimmed;
+  }
+}
+function extractNormalizedContentText(content) {
+  if (typeof content === "string") return content.trim();
+  if (!Array.isArray(content)) return "";
+  return content.map((part) => {
+    if (part?.type === "text") return String(part.text ?? "").trim();
+    if (part?.type === "image_url") return `[img:${part.image_url?.url ?? ""}]`;
+    return "";
+  }).filter(Boolean).join("\n");
+}
+function buildToolCallsSignature(toolCalls) {
+  if (!toolCalls || toolCalls.length === 0) return "";
+  return toolCalls.map(
+    (tc) => `${tc.function?.name ?? ""}:${normalizeToolArguments(tc.function?.arguments)}`
+  ).join(";;");
+}
+function buildAssistantActionFingerprint(result4) {
+  const content = extractNormalizedContentText(result4.content);
+  const reasoning = typeof result4.reasoning_content === "string" ? result4.reasoning_content.trim() : "";
+  let toolCallsSig = buildToolCallsSignature(result4.tool_calls);
+  let hasToolCalls = Array.isArray(result4.tool_calls) && result4.tool_calls.length > 0;
+  if (!toolCallsSig && Array.isArray(result4.output) && result4.output.length > 0) {
+    const blocksToolCalls = result4.output.filter(
+      (b) => b.type === "toolCall"
+    ).map((b) => b.toolCall);
+    if (blocksToolCalls.length > 0) {
+      toolCallsSig = buildToolCallsSignature(blocksToolCalls);
+      hasToolCalls = true;
+    }
+  }
+  const hasNonEmptyText = content.length > 0 || reasoning.length > 0;
+  const fingerprint = `${content}##${reasoning}##${toolCallsSig}`;
+  return {
+    fingerprint,
+    hasNonEmptyText,
+    hasToolCalls,
+    toolCallsSignature: toolCallsSig
+  };
+}
+function buildToolResultsSignature(toolExecutions) {
+  if (toolExecutions.length === 0) return "";
+  return toolExecutions.map((exec) => {
+    const contentStr = typeof exec.content === "string" ? exec.content.trim() : "";
+    const metaStr = exec.metadata ? JSON.stringify(sortJsonKeys(exec.metadata)) : "";
+    return `${exec.toolName}:${contentStr}:${metaStr}`;
+  }).join(";;");
+}
+function resolveProgressGuardConfig(options, env = typeof process !== "undefined" ? process.env : {}) {
+  const envDisabled = env.NOLO_LOOP_PROGRESS_GUARD_DISABLED === "true" || env.NOLO_LOOP_PROGRESS_GUARD_DISABLED === "1";
+  const disabled = options?.disabled ?? envDisabled ?? false;
+  const parsePositiveInt = (val, fallback) => {
+    if (typeof val === "number" && Number.isFinite(val) && val >= 1) {
+      return Math.floor(val);
+    }
+    if (typeof val === "string") {
+      const parsed = parseInt(val, 10);
+      if (Number.isFinite(parsed) && parsed >= 1) {
+        return parsed;
+      }
+    }
+    return fallback;
+  };
+  const maxConsecutiveIdenticalRounds = parsePositiveInt(
+    options?.maxConsecutiveIdenticalRounds ?? env.NOLO_LOOP_MAX_IDENTICAL_ROUNDS,
+    DEFAULT_MAX_CONSECUTIVE_IDENTICAL_ROUNDS
+  );
+  const maxConsecutiveStagnantToolRounds = parsePositiveInt(
+    options?.maxConsecutiveStagnantToolRounds ?? env.NOLO_LOOP_MAX_STAGNANT_TOOL_ROUNDS,
+    DEFAULT_MAX_CONSECUTIVE_STAGNANT_TOOL_ROUNDS
+  );
+  return {
+    disabled,
+    maxConsecutiveIdenticalRounds,
+    maxConsecutiveStagnantToolRounds
+  };
+}
+var LocalLoopProgressGuard = class {
+  config;
+  lastAssistantFingerprint = null;
+  lastAssistantHasNonEmptyText = false;
+  consecutiveIdenticalCount = 0;
+  lastToolCallsSignature = null;
+  lastToolResultsSignature = null;
+  consecutiveStagnantToolCount = 0;
+  constructor(config, env) {
+    this.config = resolveProgressGuardConfig(config, env);
+  }
+  /**
+   * 在 LLM 返回 assistant 响应后调用。
+   * 仅在纯文本/无工具调用且实质文本相同达到阈值时直接熔断；
+   * 若存在工具调用，则不在此处熔断，留待工具执行后结合工具结果综合判定。
+   */
+  observeAssistantResponse(result4) {
+    if (this.config.disabled) return { action: "continue" };
+    const { fingerprint, hasNonEmptyText, hasToolCalls } = buildAssistantActionFingerprint(result4);
+    if (this.lastAssistantFingerprint !== null && this.lastAssistantFingerprint === fingerprint) {
+      this.consecutiveIdenticalCount += 1;
+      if (!hasToolCalls && hasNonEmptyText && this.consecutiveIdenticalCount >= this.config.maxConsecutiveIdenticalRounds) {
+        return {
+          action: "stall",
+          reason: "repetition_loop",
+          detail: `Consecutive identical text-only assistant response for ${this.consecutiveIdenticalCount} rounds.`,
+          consecutiveRounds: this.consecutiveIdenticalCount
+        };
+      }
+    } else {
+      this.lastAssistantFingerprint = fingerprint;
+      this.lastAssistantHasNonEmptyText = hasNonEmptyText;
+      this.consecutiveIdenticalCount = 1;
+    }
+    return { action: "continue" };
+  }
+  /**
+   * 在本轮所有工具执行完毕后调用，检查是否陷入停滞死循环。
+   * 只有当工具返回内容与元数据完全无变化时才计入无进展 streak；
+   * 一旦工具结果发生变化（如合法轮询状态推进），立即重置 identical streak，确保绝不误杀正常长任务。
+   */
+  observeToolExecution(toolCalls, toolResults) {
+    if (this.config.disabled) return { action: "continue" };
+    if (!toolCalls || toolCalls.length === 0) return { action: "continue" };
+    const toolCallsSig = buildToolCallsSignature(toolCalls);
+    const toolResultsSig = buildToolResultsSignature(toolResults);
+    const toolCallsUnchanged = this.lastToolCallsSignature !== null && this.lastToolCallsSignature === toolCallsSig;
+    const toolResultsUnchanged = this.lastToolResultsSignature !== null && this.lastToolResultsSignature === toolResultsSig;
+    if (toolCallsUnchanged && toolResultsUnchanged) {
+      this.consecutiveStagnantToolCount += 1;
+      if (this.consecutiveIdenticalCount >= this.config.maxConsecutiveIdenticalRounds) {
+        return {
+          action: "stall",
+          reason: "repetition_loop",
+          detail: `Consecutive identical assistant response with unchanged tool results for ${this.consecutiveIdenticalCount} rounds.`,
+          consecutiveRounds: this.consecutiveIdenticalCount
+        };
+      }
+      if (this.consecutiveStagnantToolCount >= this.config.maxConsecutiveStagnantToolRounds) {
+        return {
+          action: "stall",
+          reason: "stagnant_tool_calls",
+          detail: `Consecutive stagnant tool calls with unchanged results for ${this.consecutiveStagnantToolCount} rounds.`,
+          consecutiveRounds: this.consecutiveStagnantToolCount
+        };
+      }
+    } else {
+      this.lastToolCallsSignature = toolCallsSig;
+      this.lastToolResultsSignature = toolResultsSig;
+      this.consecutiveStagnantToolCount = 1;
+      if (!toolResultsUnchanged) {
+        this.consecutiveIdenticalCount = 1;
+      }
+    }
+    return { action: "continue" };
+  }
+};
+function createLocalLoopProgressGuard(config, env) {
+  return new LocalLoopProgressGuard(config, env);
+}
+
+// packages/agent-runtime/toolArgumentsFingerprint.ts
+var hashFingerprintInput = (value) => {
+  let hash2 = 2166136261;
+  for (let index = 0; index < value.length; index += 1) {
+    hash2 ^= value.charCodeAt(index);
+    hash2 = Math.imul(hash2, 16777619);
+  }
+  return (hash2 >>> 0).toString(16).padStart(8, "0");
+};
+function buildToolArgumentsFingerprint(rawArguments) {
+  if (rawArguments === void 0 || rawArguments === null) return void 0;
+  const normalized = normalizeToolArguments(rawArguments);
+  return hashFingerprintInput(normalized);
+}
+
 // packages/agent-runtime/leafFinalHandoff.ts
-var LEAF_FINAL_HANDOFF_INSTRUCTIONS = `Leaf subtask final: return only the result, blockers/findings, and minimal evidence the parent needs. Do not narrate your process or restate the task. Keep success minimal (a one-line result is enough); on failure include the blocker, severity when relevant, and an evidence reference (file:line, test command, commit, artifact, or run/dialog). If the task explicitly requires a long-form deliverable (document, translation, dataset, code, or other artifact), provide that deliverable in full and keep only the handoff around it concise.`;
+var LEAF_FINAL_HANDOFF_INSTRUCTIONS = `Leaf subtask final: return only the result, blockers/findings, and minimal evidence the parent needs. Do not narrate your process or restate the task. Keep success minimal (a one-line result is enough); on failure include the blocker, severity when relevant, and an evidence reference (file:line, test command, commit, artifact, or run/dialog). If the task explicitly requires a long-form deliverable (document, translation, dataset, code, or other artifact), provide that deliverable in full and keep only the handoff around it concise. During execution, follow the brief as given: only when new evidence would materially change the goal, risk, irreversibility, or DoD should you surface it as a blocker/finding in the handoff \u2014 do not silently expand scope or re-litigate the settled direction.`;
 
 // packages/agent-runtime/contextBlockScope.ts
 var isContextBlockScope = (value) => {
@@ -12426,20 +12627,33 @@ function isColdResume(history, nowMs) {
 }
 async function maybeAutoCompactLocalHistory(args2) {
   const { adapter, dialogId, history } = args2;
-  const unchanged = () => ({
+  const unchanged = (decision) => ({
     history,
     compressed: false,
-    summaryGenerated: false
+    summaryGenerated: false,
+    decision
   });
-  if (!dialogId || history.length === 0 || typeof adapter.loadDialogSummary !== "function" || typeof adapter.saveDialogSummary !== "function") {
-    return unchanged();
+  if (!dialogId) {
+    return unchanged({ outcome: "skipped", skipReason: "no-dialog-id" });
+  }
+  if (history.length === 0) {
+    return unchanged({ outcome: "skipped", skipReason: "empty-history" });
+  }
+  if (typeof adapter.loadDialogSummary !== "function" || typeof adapter.saveDialogSummary !== "function") {
+    return unchanged({
+      outcome: "skipped",
+      skipReason: "adapter-missing-summary-methods"
+    });
   }
   let stored = null;
   try {
     stored = await adapter.loadDialogSummary(dialogId);
   } catch (error) {
     console.warn("[localLoop] loadDialogSummary failed:", error);
-    return unchanged();
+    return unchanged({
+      outcome: "skipped",
+      skipReason: "load-summary-failed"
+    });
   }
   const bridged = toPlanCompressionMessages(history);
   const validation = validateStoredSummary({ history, stored: stored ?? {} });
@@ -12475,7 +12689,21 @@ async function maybeAutoCompactLocalHistory(args2) {
     ...args2.realContextUsagePercent !== void 0 ? { realContextUsagePercent: args2.realContextUsagePercent } : {}
   });
   const projectExisting = () => {
-    if (!existingSummary.trim()) return unchanged();
+    const diag = plan.diagnostics;
+    const diagSnapshot = diag ? {
+      estimatedTokens: diag.totalUsed,
+      historyBudget: diag.historyBudget,
+      triggerRatio: diag.triggerRatio,
+      ...diag.realUsageRatio !== void 0 ? { realUsageRatio: diag.realUsageRatio } : {}
+    } : {};
+    const skippedDecision = {
+      outcome: "skipped",
+      skipReason: diag?.emptyReason === "no-pending" ? "no-pending" : diag?.emptyReason === "below-min-compress-count" ? "below-min-compress-count" : "below-trigger",
+      ...diagSnapshot,
+      ...diag ? { pendingMsgCount: diag.pendingMsgCount } : {},
+      ...diag?.compressCount !== void 0 ? { compressCount: diag.compressCount } : {}
+    };
+    if (!existingSummary.trim()) return unchanged(skippedDecision);
     return {
       history: projectHistoryWithSummary({
         history,
@@ -12483,7 +12711,12 @@ async function maybeAutoCompactLocalHistory(args2) {
         summarizedBeforeId
       }),
       compressed: true,
-      summaryGenerated: false
+      summaryGenerated: false,
+      decision: {
+        outcome: "compressed",
+        trigger: "existing-summary",
+        ...diagSnapshot
+      }
     };
   };
   if (!plan.shouldCompress) {
@@ -12513,7 +12746,11 @@ async function maybeAutoCompactLocalHistory(args2) {
       );
       return {
         ...projectExisting(),
-        failureMessage: "summary model returned empty content"
+        failureMessage: "summary model returned empty content",
+        decision: {
+          outcome: "failed",
+          detail: "summary model returned empty content"
+        }
       };
     }
     await adapter.saveDialogSummary({
@@ -12550,198 +12787,27 @@ async function maybeAutoCompactLocalHistory(args2) {
       beforeTokens: metrics.previousSummaryTokens + metrics.compressedTokens,
       afterTokens: metrics.newSummaryTokens + metrics.retainedTokens,
       ...result4.usage ? { usage: result4.usage } : {},
-      metrics
+      metrics,
+      decision: {
+        outcome: "compressed",
+        trigger: invalidSummary ? "invalid-summary" : coldResume ? "cold-resume" : plan.diagnostics?.triggeredByRealUsage ? "real-usage" : "estimate",
+        ...plan.diagnostics ? {
+          estimatedTokens: plan.diagnostics.totalUsed,
+          historyBudget: plan.diagnostics.historyBudget,
+          triggerRatio: plan.diagnostics.triggerRatio,
+          ...plan.diagnostics.realUsageRatio !== void 0 ? { realUsageRatio: plan.diagnostics.realUsageRatio } : {}
+        } : {}
+      }
     };
   } catch (error) {
     console.warn("[localLoop] auto-compaction failed:", error);
     const failureMessage = error instanceof Error && error.message ? error.message.slice(0, 200) : String(error).slice(0, 200);
-    return { ...projectExisting(), failureMessage };
-  }
-}
-
-// packages/agent-runtime/progressGuard.ts
-var DEFAULT_MAX_CONSECUTIVE_IDENTICAL_ROUNDS = 5;
-var DEFAULT_MAX_CONSECUTIVE_STAGNANT_TOOL_ROUNDS = 8;
-function sortJsonKeys(obj) {
-  if (obj === null || typeof obj !== "object") return obj;
-  if (Array.isArray(obj)) return obj.map(sortJsonKeys);
-  const sorted = {};
-  for (const key of Object.keys(obj).sort()) {
-    sorted[key] = sortJsonKeys(obj[key]);
-  }
-  return sorted;
-}
-function normalizeToolArguments(rawArgs) {
-  if (typeof rawArgs !== "string") {
-    try {
-      return JSON.stringify(sortJsonKeys(rawArgs ?? ""));
-    } catch {
-      return String(rawArgs ?? "");
-    }
-  }
-  const trimmed = rawArgs.trim();
-  if (!trimmed) return "";
-  try {
-    const parsed = JSON.parse(trimmed);
-    return JSON.stringify(sortJsonKeys(parsed));
-  } catch {
-    return trimmed;
-  }
-}
-function extractNormalizedContentText(content) {
-  if (typeof content === "string") return content.trim();
-  if (!Array.isArray(content)) return "";
-  return content.map((part) => {
-    if (part?.type === "text") return String(part.text ?? "").trim();
-    if (part?.type === "image_url") return `[img:${part.image_url?.url ?? ""}]`;
-    return "";
-  }).filter(Boolean).join("\n");
-}
-function buildToolCallsSignature(toolCalls) {
-  if (!toolCalls || toolCalls.length === 0) return "";
-  return toolCalls.map(
-    (tc) => `${tc.function?.name ?? ""}:${normalizeToolArguments(tc.function?.arguments)}`
-  ).join(";;");
-}
-function buildAssistantActionFingerprint(result4) {
-  const content = extractNormalizedContentText(result4.content);
-  const reasoning = typeof result4.reasoning_content === "string" ? result4.reasoning_content.trim() : "";
-  let toolCallsSig = buildToolCallsSignature(result4.tool_calls);
-  let hasToolCalls = Array.isArray(result4.tool_calls) && result4.tool_calls.length > 0;
-  if (!toolCallsSig && Array.isArray(result4.output) && result4.output.length > 0) {
-    const blocksToolCalls = result4.output.filter(
-      (b) => b.type === "toolCall"
-    ).map((b) => b.toolCall);
-    if (blocksToolCalls.length > 0) {
-      toolCallsSig = buildToolCallsSignature(blocksToolCalls);
-      hasToolCalls = true;
-    }
-  }
-  const hasNonEmptyText = content.length > 0 || reasoning.length > 0;
-  const fingerprint = `${content}##${reasoning}##${toolCallsSig}`;
-  return {
-    fingerprint,
-    hasNonEmptyText,
-    hasToolCalls,
-    toolCallsSignature: toolCallsSig
-  };
-}
-function buildToolResultsSignature(toolExecutions) {
-  if (toolExecutions.length === 0) return "";
-  return toolExecutions.map((exec) => {
-    const contentStr = typeof exec.content === "string" ? exec.content.trim() : "";
-    const metaStr = exec.metadata ? JSON.stringify(sortJsonKeys(exec.metadata)) : "";
-    return `${exec.toolName}:${contentStr}:${metaStr}`;
-  }).join(";;");
-}
-function resolveProgressGuardConfig(options, env = typeof process !== "undefined" ? process.env : {}) {
-  const envDisabled = env.NOLO_LOOP_PROGRESS_GUARD_DISABLED === "true" || env.NOLO_LOOP_PROGRESS_GUARD_DISABLED === "1";
-  const disabled = options?.disabled ?? envDisabled ?? false;
-  const parsePositiveInt = (val, fallback) => {
-    if (typeof val === "number" && Number.isFinite(val) && val >= 1) {
-      return Math.floor(val);
-    }
-    if (typeof val === "string") {
-      const parsed = parseInt(val, 10);
-      if (Number.isFinite(parsed) && parsed >= 1) {
-        return parsed;
-      }
-    }
-    return fallback;
-  };
-  const maxConsecutiveIdenticalRounds = parsePositiveInt(
-    options?.maxConsecutiveIdenticalRounds ?? env.NOLO_LOOP_MAX_IDENTICAL_ROUNDS,
-    DEFAULT_MAX_CONSECUTIVE_IDENTICAL_ROUNDS
-  );
-  const maxConsecutiveStagnantToolRounds = parsePositiveInt(
-    options?.maxConsecutiveStagnantToolRounds ?? env.NOLO_LOOP_MAX_STAGNANT_TOOL_ROUNDS,
-    DEFAULT_MAX_CONSECUTIVE_STAGNANT_TOOL_ROUNDS
-  );
-  return {
-    disabled,
-    maxConsecutiveIdenticalRounds,
-    maxConsecutiveStagnantToolRounds
-  };
-}
-var LocalLoopProgressGuard = class {
-  config;
-  lastAssistantFingerprint = null;
-  lastAssistantHasNonEmptyText = false;
-  consecutiveIdenticalCount = 0;
-  lastToolCallsSignature = null;
-  lastToolResultsSignature = null;
-  consecutiveStagnantToolCount = 0;
-  constructor(config, env) {
-    this.config = resolveProgressGuardConfig(config, env);
-  }
-  /**
-   * 在 LLM 返回 assistant 响应后调用。
-   * 仅在纯文本/无工具调用且实质文本相同达到阈值时直接熔断；
-   * 若存在工具调用，则不在此处熔断，留待工具执行后结合工具结果综合判定。
-   */
-  observeAssistantResponse(result4) {
-    if (this.config.disabled) return { action: "continue" };
-    const { fingerprint, hasNonEmptyText, hasToolCalls } = buildAssistantActionFingerprint(result4);
-    if (this.lastAssistantFingerprint !== null && this.lastAssistantFingerprint === fingerprint) {
-      this.consecutiveIdenticalCount += 1;
-      if (!hasToolCalls && hasNonEmptyText && this.consecutiveIdenticalCount >= this.config.maxConsecutiveIdenticalRounds) {
-        return {
-          action: "stall",
-          reason: "repetition_loop",
-          detail: `Consecutive identical text-only assistant response for ${this.consecutiveIdenticalCount} rounds.`,
-          consecutiveRounds: this.consecutiveIdenticalCount
-        };
-      }
-    } else {
-      this.lastAssistantFingerprint = fingerprint;
-      this.lastAssistantHasNonEmptyText = hasNonEmptyText;
-      this.consecutiveIdenticalCount = 1;
-    }
-    return { action: "continue" };
-  }
-  /**
-   * 在本轮所有工具执行完毕后调用，检查是否陷入停滞死循环。
-   * 只有当工具返回内容与元数据完全无变化时才计入无进展 streak；
-   * 一旦工具结果发生变化（如合法轮询状态推进），立即重置 identical streak，确保绝不误杀正常长任务。
-   */
-  observeToolExecution(toolCalls, toolResults) {
-    if (this.config.disabled) return { action: "continue" };
-    if (!toolCalls || toolCalls.length === 0) return { action: "continue" };
-    const toolCallsSig = buildToolCallsSignature(toolCalls);
-    const toolResultsSig = buildToolResultsSignature(toolResults);
-    const toolCallsUnchanged = this.lastToolCallsSignature !== null && this.lastToolCallsSignature === toolCallsSig;
-    const toolResultsUnchanged = this.lastToolResultsSignature !== null && this.lastToolResultsSignature === toolResultsSig;
-    if (toolCallsUnchanged && toolResultsUnchanged) {
-      this.consecutiveStagnantToolCount += 1;
-      if (this.consecutiveIdenticalCount >= this.config.maxConsecutiveIdenticalRounds) {
-        return {
-          action: "stall",
-          reason: "repetition_loop",
-          detail: `Consecutive identical assistant response with unchanged tool results for ${this.consecutiveIdenticalCount} rounds.`,
-          consecutiveRounds: this.consecutiveIdenticalCount
-        };
-      }
-      if (this.consecutiveStagnantToolCount >= this.config.maxConsecutiveStagnantToolRounds) {
-        return {
-          action: "stall",
-          reason: "stagnant_tool_calls",
-          detail: `Consecutive stagnant tool calls with unchanged results for ${this.consecutiveStagnantToolCount} rounds.`,
-          consecutiveRounds: this.consecutiveStagnantToolCount
-        };
-      }
-    } else {
-      this.lastToolCallsSignature = toolCallsSig;
-      this.lastToolResultsSignature = toolResultsSig;
-      this.consecutiveStagnantToolCount = 1;
-      if (!toolResultsUnchanged) {
-        this.consecutiveIdenticalCount = 1;
-      }
-    }
-    return { action: "continue" };
+    return {
+      ...projectExisting(),
+      failureMessage,
+      decision: { outcome: "failed", detail: failureMessage }
+    };
   }
-};
-function createLocalLoopProgressGuard(config, env) {
-  return new LocalLoopProgressGuard(config, env);
 }
 
 // packages/agent-runtime/localLoop.ts
@@ -13049,10 +13115,10 @@ var TOOL_METADATA_KEYS = [
   "pasteId",
   "source"
 ];
-function trimHistoryToContextBudget(history, model) {
+function trimHistoryToContextBudget(history, model, contextWindowOverride) {
   if (history.length === 0) return { history, droppedCount: 0 };
   const { rawMessageBudget } = planContextUsage({
-    contextWindow: getModelContextWindow(model ?? ""),
+    contextWindow: contextWindowOverride ?? getModelContextWindow(model ?? ""),
     summaryTokens: 0,
     // localLoop 没有 web 端的负载分档器；medium 是中性默认值，
     // 不为了省几个 token 在这里复制一份分类逻辑。
@@ -13515,7 +13581,14 @@ async function runLocalAgentTurn(input) {
       agentConfig.exposedToolNames ?? agentConfig.toolNames ?? []
     );
     const guidanceBlocks = buildRuntimeGuidanceBlocks(agentTools);
-    const toolGuidedSections = resolveToolGuidedSections(agentTools);
+    const toolGuidedSections = resolveToolGuidedSections(agentTools, {
+      // 单调锁定：历史里任一 user 消息命中派发关键词、或已出现过
+      // startAgentRun/controlAgentRun 的 tool_calls，后续每轮都保持 true，
+      // 防止 session-scope 的 agentCollaboration 段逐轮翻转击穿前缀缓存。
+      dispatchIntent: detectDispatchIntentFromMessages(history) || detectDispatchIntent(
+        typeof input.input === "string" ? input.input : void 0
+      )
+    });
     const guidanceScopes = [
       ...input.userLanguage?.trim() ? [buildUserResponseLanguageContext({ language: input.userLanguage })] : [],
       guidanceBlocks.startupProtocol,
@@ -13543,7 +13616,7 @@ async function runLocalAgentTurn(input) {
       }
       return resolvedProvider;
     };
-    const contextWindow = getModelContextWindow(agentConfig.model ?? "");
+    const contextWindow = resolveAgentContextWindow(agentConfig);
     const compressionTriggerRatio = resolveCompressionTriggerRatio(contextWindow);
     let realContextUsagePercent;
     if (input.continueDialogId && typeof input.adapter.loadLastContextUsage === "function") {
@@ -13564,19 +13637,29 @@ async function runLocalAgentTurn(input) {
     }
     let compactionUsage;
     const emitCompactionObservation = (compacted) => {
-      if (compacted.compressed || compacted.summaryGenerated || compacted.failureMessage) {
-        emitLoopEvent(observationBoundary, {
-          kind: "compaction",
-          atMs: Date.now(),
-          reason: compacted.reason ?? "context_budget",
-          summaryGenerated: compacted.summaryGenerated,
-          compressed: compacted.compressed,
-          ...compacted.failureMessage ? { failed: true, detail: compacted.failureMessage } : {},
-          ...compacted.beforeTokens !== void 0 ? { beforeTokens: compacted.beforeTokens } : {},
-          ...compacted.afterTokens !== void 0 ? { afterTokens: compacted.afterTokens } : {},
-          ...compacted.savedTokens !== void 0 ? { savedTokens: compacted.savedTokens } : {}
-        });
+      const decision = compacted.decision;
+      if (decision?.outcome === "skipped") {
+        const isProtectionGap = decision.skipReason === "adapter-missing-summary-methods" || decision.skipReason === "load-summary-failed";
+        const approachingBudget = decision.skipReason === "below-trigger" && typeof decision.estimatedTokens === "number" && typeof decision.historyBudget === "number" && decision.historyBudget > 0 && decision.estimatedTokens >= decision.historyBudget * 0.5;
+        if (!isProtectionGap && !approachingBudget) return;
       }
+      emitLoopEvent(observationBoundary, {
+        kind: "compaction",
+        atMs: Date.now(),
+        ...compacted.reason ? { reason: compacted.reason } : {},
+        summaryGenerated: compacted.summaryGenerated,
+        compressed: compacted.compressed,
+        ...compacted.failureMessage ? { failed: true, detail: compacted.failureMessage } : {},
+        ...decision?.outcome === "skipped" ? { skipped: true, skipReason: decision.skipReason } : {},
+        ...decision && "trigger" in decision && decision.trigger ? { trigger: decision.trigger } : {},
+        ...decision && "estimatedTokens" in decision && decision.estimatedTokens !== void 0 ? { estimatedTokens: decision.estimatedTokens } : {},
+        ...decision && "historyBudget" in decision && decision.historyBudget !== void 0 ? { historyBudget: decision.historyBudget } : {},
+        ...decision && "realUsageRatio" in decision && decision.realUsageRatio !== void 0 ? { realUsageRatio: decision.realUsageRatio } : {},
+        ...decision && "triggerRatio" in decision && decision.triggerRatio !== void 0 ? { triggerRatio: decision.triggerRatio } : {},
+        ...compacted.beforeTokens !== void 0 ? { beforeTokens: compacted.beforeTokens } : {},
+        ...compacted.afterTokens !== void 0 ? { afterTokens: compacted.afterTokens } : {},
+        ...compacted.savedTokens !== void 0 ? { savedTokens: compacted.savedTokens } : {}
+      });
     };
     try {
       const compacted = await maybeAutoCompactLocalHistory({
@@ -13585,6 +13668,7 @@ async function runLocalAgentTurn(input) {
         history,
         model: agentConfig.model,
         resolveProvider: resolveProviderOnce,
+        contextWindow,
         realContextUsagePercent
       });
       history = compacted.history;
@@ -13594,7 +13678,7 @@ async function runLocalAgentTurn(input) {
       console.warn("[localLoop] auto-compaction unexpected error:", error);
     }
     loopTimingMark("maybeAutoCompactLocalHistory", 0);
-    const trimmedHistory = trimHistoryToContextBudget(history, agentConfig.model);
+    const trimmedHistory = trimHistoryToContextBudget(history, agentConfig.model, contextWindow);
     if (trimmedHistory.droppedCount > 0) {
       history = trimmedHistory.history;
     }
@@ -13656,17 +13740,26 @@ async function runLocalAgentTurn(input) {
     let skipFinalAppend = false;
     let partialContent = "";
     const progressGuard = createLocalLoopProgressGuard(input.progressGuardConfig);
+    let ephemeralSummary = null;
+    const ephemeralDialogId = `ephemeral-${crypto.randomUUID()}`;
+    const compactionAdapter = input.continueDialogId ? input.adapter : {
+      ...input.adapter,
+      loadDialogSummary: async () => ephemeralSummary,
+      saveDialogSummary: async (summaryInput) => {
+        ephemeralSummary = summaryInput;
+      }
+    };
+    const compactionDialogId = input.continueDialogId ?? ephemeralDialogId;
     const maybeCompactInLoop = async () => {
-      if (!input.continueDialogId) return;
-      if (!contextUsage) return;
-      const inputTokens = normalizeUsage(contextUsage).input_tokens;
-      if (!inputTokens || inputTokens <= 0) return;
-      const ratio = Math.min(1, inputTokens / contextWindow);
-      if (ratio < compressionTriggerRatio) return;
+      const inputTokens = contextUsage ? normalizeUsage(contextUsage).input_tokens : 0;
+      const ratio = inputTokens > 0 ? Math.min(1, inputTokens / contextWindow) : void 0;
+      if (ratio !== void 0 && ratio < compressionTriggerRatio * 0.85) {
+        return;
+      }
       try {
         const compacted = await maybeAutoCompactLocalHistory({
-          adapter: input.adapter,
-          dialogId: input.continueDialogId,
+          adapter: compactionAdapter,
+          dialogId: compactionDialogId,
           // canonical 坐标：store 全量历史 + 本轮消息的「持久化形态」
           // （applyPersistedTurnInput 会把首条 user 消息换成 paste 展开形态）。
           // 锚点与 sourceHash 都必须按持久化形态计算——否则下轮从 store
@@ -13681,7 +13774,8 @@ async function runLocalAgentTurn(input) {
           ],
           model: agentConfig.model,
           resolveProvider: resolveProviderOnce,
-          realContextUsagePercent: ratio
+          contextWindow,
+          ...ratio !== void 0 ? { realContextUsagePercent: ratio } : {}
         });
         if (compacted.usage) {
           compactionUsage = addOutOfBandUsage(compactionUsage, compacted.usage);
@@ -13949,6 +14043,7 @@ ${reasoningTailLog}
           const startedAt = Date.now();
           loopTimingMark("toolCallStart", round);
           const argumentsPreview = summarizeToolArguments(toolName, toolCall.function.arguments);
+          const argumentsFingerprint = buildToolArgumentsFingerprint(toolCall.function.arguments);
           emitLoopEvent(
             observationBoundary,
             {
@@ -13957,7 +14052,8 @@ ${reasoningTailLog}
               toolCallId: toolCall.id,
               toolName,
               atMs: startedAt,
-              ...argumentsPreview ? { argumentsPreview } : {}
+              ...argumentsPreview ? { argumentsPreview } : {},
+              ...argumentsFingerprint ? { argumentsFingerprint } : {}
             },
             {
               type: "tool-call",
@@ -15571,11 +15667,12 @@ var DEFAULT_LOCAL_TOOLS = /* @__PURE__ */ new Set([
   "execShell",
   "launchProcess",
   "listProcesses",
-  // ProcessTask follow-up tools (Phase 1). Same tier as listProcesses: they
-  // observe/stop tasks the agent itself already spawned, so their blast radius
-  // is strictly narrower than launchProcess (which is default-enabled).
+  // ProcessTask follow-up tools. Same tier as listProcesses: they observe/stop
+  // tasks the agent itself already spawned, so their blast radius is strictly
+  // narrower than launchProcess (which is default-enabled). Model-facing
+  // follow-ups are taskWait/taskStop only — lifecycle history (taskLogs) stays
+  // runtime-internal.
   "taskWait",
-  "taskLogs",
   "taskStop",
   // Scheduling tools: forking/observing sub-agents is a declared capability
   // of capable agents, and the blast radius is strictly narrower than
@@ -17573,7 +17670,6 @@ var WORKSPACE_TOOL_NAMES = [
   "launchProcess",
   "listProcesses",
   "taskWait",
-  "taskLogs",
   "taskStop",
   "openDesktopPreview"
 ];
@@ -17582,7 +17678,6 @@ var SHELL_TOOL_NAMES = [
   "launchProcess",
   "listProcesses",
   "taskWait",
-  "taskLogs",
   "taskStop"
 ];
 var WORKSPACE_TOOL_NAME_SET = new Set(WORKSPACE_TOOL_NAMES);
@@ -17832,7 +17927,7 @@ function buildTaskWaitTool() {
     type: "function",
     function: {
       name: "taskWait",
-      description: 'Block until a background task (from launchProcess, or an execShell command that detached) reaches a terminal state, or until timeoutMs elapses. Returns {outcome, status, exitCode?, cursor, events}: outcome "terminal" with status exited|failed|stopped when it finished, outcome "timeout" with status "running" when it outlived the whole budget, outcome "not-found" for an unknown taskId, or outcome "evicted" when the event trail aged out (never wait again in that case). One call already waits the maximum budget and returns the moment the task ends, so a "timeout" means the task is genuinely longer than that \u2014 go do other work and come back, rather than re-waiting in a loop (each re-wait costs a full model round-trip). For a cheap liveness peek use taskLogs (non-blocking) or pass a small timeoutMs. `cursor` is the highest event seq covered by this response \u2014 pass it to taskLogs to read only newer events.',
+      description: 'Block until a background task (from launchProcess, or an execShell command that detached) reaches a terminal state, or until timeoutMs elapses. Returns {outcome, status, exitCode?, cursor, events}: outcome "terminal" with status exited|failed|stopped when it finished, outcome "timeout" with status "running" when it outlived the whole budget, outcome "not-found" for an unknown taskId, or outcome "evicted" when the event trail aged out (never wait again in that case). One call already waits the maximum budget and returns the moment the task ends, so a "timeout" means the task is genuinely longer than that \u2014 go do other work and come back, rather than re-waiting in a loop (each re-wait costs a full model round-trip). Pass a small timeoutMs for a cheap liveness peek instead of the full result. `cursor` is the highest event seq covered by this response.',
       parameters: {
         type: "object",
         properties: {
@@ -17851,30 +17946,6 @@ function buildTaskWaitTool() {
     }
   };
 }
-function buildTaskLogsTool() {
-  return {
-    type: "function",
-    function: {
-      name: "taskLogs",
-      description: "Read a background task's lifecycle events incrementally. Returns {outcome, status, cursor, events} where events are the started|promoted|exited|killed records with seq greater than the cursor you passed, and the returned `cursor` is the new high-water mark to pass next time (omit cursor to read from the beginning; repeating the same cursor is idempotent). Oversized output is spilled to a file and reported as `logRef`, which you can open with readFile.",
-      parameters: {
-        type: "object",
-        properties: {
-          taskId: {
-            type: "string",
-            minLength: 1,
-            description: "Task id returned by launchProcess or by a detached execShell result."
-          },
-          cursor: {
-            type: "number",
-            description: "Last event seq you already consumed; only events with a higher seq are returned. Defaults to 0 (all retained events)."
-          }
-        },
-        required: ["taskId"]
-      }
-    }
-  };
-}
 function buildTaskStopTool() {
   return {
     type: "function",
@@ -17914,7 +17985,6 @@ function buildWorkspaceToolDefinition(toolName) {
   if (toolName === "openDesktopPreview") return buildOpenDesktopPreviewTool();
   if (toolName === "listProcesses") return buildListProcessesTool();
   if (toolName === "taskWait") return buildTaskWaitTool();
-  if (toolName === "taskLogs") return buildTaskLogsTool();
   if (toolName === "taskStop") return buildTaskStopTool();
   return null;
 }
@@ -19381,15 +19451,23 @@ function buildLoadSkillExecutor(args2) {
     const { resolveSkillByName } = await import("./skillDiscovery-CYUCJMAG.js");
     const resolved = resolveSkillByName(args2.cwd, name);
     if (!resolved) {
-      const { resolveCodingBuiltinSlug, buildCodingSkillContentBySlug } = await import("./codingSkills-7S6523WH.js");
-      const builtinSlug = resolveCodingBuiltinSlug(name);
-      if (builtinSlug) {
-        const body = buildCodingSkillContentBySlug(builtinSlug);
+      const { resolveBuiltinSkillByName } = await import("./builtinSkillRegistry-FUAVTRVZ.js");
+      const builtin = resolveBuiltinSkillByName(name);
+      if (builtin) {
         return {
           content: `Skill "${name}" loaded inline. Follow its instructions.
 
-${body}`,
-          metadata: { loadSkill: true, resolved: true, name, requestedName: name, builtin: true }
+${builtin.content}`,
+          // toolNames 进 metadata：回退面已扩到全注册表，其中授工具型 skill
+          // （search-* 等）的工具在本宿主未必接线，宿主可据此降级提示。
+          metadata: {
+            loadSkill: true,
+            resolved: true,
+            name,
+            requestedName: name,
+            builtin: true,
+            ...builtin.config.toolNames?.length ? { toolNames: [...builtin.config.toolNames] } : {}
+          }
         };
       }
       return {
@@ -20221,11 +20299,33 @@ function encodeDevinClientMetadata(token) {
   ]);
 }
 function encodeDevinChatMessage(msg) {
-  const source = msg.role === "assistant" ? 2 : 1;
+  const source = msg.role === "assistant" ? 2 : msg.role === "tool" ? 4 : 1;
   return Buffer.concat([
     writeStringField(1, randomUUID2()),
     writeVarint(2, source),
-    writeStringField(3, msg.text)
+    writeStringField(3, msg.text),
+    ...(msg.toolCalls ?? []).map(
+      (toolCall) => writeMessageField(
+        6,
+        Buffer.concat([
+          writeStringField(1, toolCall.id),
+          writeStringField(2, toolCall.function.name),
+          writeStringField(3, toolCall.function.arguments)
+        ])
+      )
+    ),
+    ...msg.toolCallId ? [writeStringField(7, msg.toolCallId)] : []
+  ]);
+}
+function encodeDevinToolDefinition(tool) {
+  const fn3 = tool.function ?? {};
+  const name = typeof fn3.name === "string" ? fn3.name : "";
+  const description = typeof fn3.description === "string" ? fn3.description : "";
+  const parameters = fn3.parameters ?? {};
+  return Buffer.concat([
+    writeStringField(1, name),
+    writeStringField(2, description.length > 6998 ? `${description.slice(0, 6995)}...` : description),
+    writeStringField(3, JSON.stringify(parameters))
   ]);
 }
 function writeFixed64Field(fieldNum, val) {
@@ -20242,20 +20342,21 @@ function writeFixed64Field(fieldNum, val) {
   return Buffer.concat([Buffer.from(tagBytes), b]);
 }
 function buildCompletionConfig(params) {
-  const maxTokens = params?.maxTokens ?? 4096;
-  const temp = params?.temperature ?? 0.4;
+  const maxTokens = params?.maxTokens ?? 128e3;
+  const maxNewlines = params?.maxNewlines ?? 400;
+  const temp = params?.temperature ?? 1;
   const topP = params?.topP ?? 0.95;
   return Buffer.concat([
     writeVarint(1, 1),
     writeVarint(2, maxTokens),
-    writeVarint(3, 128e3),
+    writeVarint(3, maxNewlines),
     writeFixed64Field(5, temp),
     writeVarint(7, 40),
     writeFixed64Field(8, topP)
   ]);
 }
 function buildGetChatMessageRequest(params) {
-  const { token, messages, model } = params;
+  const { token, messages, model, tools = [], temperature } = params;
   const metadata = encodeDevinClientMetadata(token);
   let systemPrompt = "";
   const filteredMessages = [];
@@ -20265,14 +20366,19 @@ function buildGetChatMessageRequest(params) {
       systemPrompt = systemPrompt ? `${systemPrompt}
 
 ${text}` : text;
-    } else if (m.role === "user" || m.role === "assistant") {
-      filteredMessages.push({ role: m.role, text });
+    } else if (m.role === "user" || m.role === "assistant" || m.role === "tool") {
+      filteredMessages.push({
+        role: m.role,
+        text,
+        ...m.tool_call_id ? { toolCallId: m.tool_call_id } : {},
+        ...m.tool_calls?.length ? { toolCalls: m.tool_calls } : {}
+      });
     }
   }
   const coalesced = [];
   for (const item of filteredMessages) {
     const last = coalesced[coalesced.length - 1];
-    if (last && last.role === item.role) {
+    if (last && last.role === item.role && item.role !== "tool" && !last.toolCalls?.length && !item.toolCalls?.length) {
       last.text = `${last.text}
 
 ${item.text}`;
@@ -20281,7 +20387,7 @@ ${item.text}`;
     }
   }
   const chatMessageBuffers = coalesced.map((m) => encodeDevinChatMessage(m));
-  const completionConfig = buildCompletionConfig();
+  const completionConfig = buildCompletionConfig({ temperature });
   const modelConfig = Buffer.concat([
     writeStringField(1, randomUUID2()),
     writeVarint(2, 1),
@@ -20293,6 +20399,7 @@ ${item.text}`;
     ...chatMessageBuffers.map((b) => writeMessageField(3, b)),
     writeVarint(7, 5),
     writeMessageField(8, completionConfig),
+    ...tools.map((tool) => writeMessageField(10, encodeDevinToolDefinition(tool))),
     writeMessageField(15, modelConfig),
     writeStringField(16, randomUUID2()),
     writeVarint(20, 1),
@@ -20323,6 +20430,77 @@ function parseDevinConnectFrames(buffer3) {
     remainder: buffer3.subarray(offset)
   };
 }
+function parseDevinMetadataUsage(metaBytes) {
+  let prompt = 0;
+  let completion;
+  let cacheRead = 0;
+  let cacheWrite = 0;
+  let sawAny = false;
+  let offset = 0;
+  while (offset < metaBytes.length) {
+    let tag = 0;
+    let shift = 0;
+    while (offset < metaBytes.length) {
+      const b = metaBytes[offset++];
+      tag |= (b & 127) << shift;
+      if (!(b & 128)) break;
+      shift += 7;
+    }
+    const fieldNum = tag >>> 3;
+    const wireType = tag & 7;
+    if (wireType === 0) {
+      let val = 0;
+      let s = 0;
+      while (offset < metaBytes.length) {
+        const b = metaBytes[offset++];
+        val |= (b & 127) << s;
+        if (!(b & 128)) break;
+        s += 7;
+      }
+      if (fieldNum === 2) {
+        prompt = val;
+        sawAny = true;
+      } else if (fieldNum === 3) {
+        completion = val;
+        sawAny = true;
+      } else if (fieldNum === 4) {
+        cacheWrite = val;
+        sawAny = true;
+      } else if (fieldNum === 5) {
+        cacheRead = val;
+        sawAny = true;
+      }
+    } else if (wireType === 2) {
+      let len = 0;
+      let s = 0;
+      while (offset < metaBytes.length) {
+        const b = metaBytes[offset++];
+        len |= (b & 127) << s;
+        if (!(b & 128)) break;
+        s += 7;
+      }
+      offset += len;
+    } else {
+      break;
+    }
+  }
+  return sawAny ? { prompt, completion, cacheRead, cacheWrite } : null;
+}
+function attachDevinUpstreamFailure(error, failure) {
+  if (failure) {
+    error.devinUpstreamFailure = failure;
+  }
+  return error;
+}
+function readDevinUpstreamFailure(error) {
+  if (!error || typeof error !== "object") return void 0;
+  const failure = error.devinUpstreamFailure;
+  if (!failure || typeof failure !== "object") return void 0;
+  if (typeof failure.status !== "number" || !Number.isFinite(failure.status)) {
+    return void 0;
+  }
+  return failure;
+}
 function parseDevinConnectTrailer(payload) {
   const text = payload.toString("utf8").trim();
   if (!text || text === "{}") return null;
@@ -20333,7 +20511,11 @@ function parseDevinConnectTrailer(payload) {
     }
     const code = typeof parsed.error.code === "string" ? parsed.error.code : "unknown";
     const message = typeof parsed.error.message === "string" ? parsed.error.message : "Unknown error";
-    return new Error(`Devin Connect upstream error ${code}: ${message}`);
+    return attachDevinUpstreamFailure(
+      new Error(`Devin Connect upstream error ${code}: ${message}`),
+      // Connect/gRPC 的 resource_exhausted 与 HTTP 429 同义（限流/配额耗尽）。
+      code === "resource_exhausted" ? { status: 429, body: parsed.error } : void 0
+    );
   } catch {
     return new Error(`Devin Connect invalid terminal trailer: ${text}`);
   }
@@ -20343,6 +20525,7 @@ function decodeDevinResponsePayload(payload) {
   let content = "";
   let reasoning = "";
   let finishReason = null;
+  let usage = null;
   const events = [];
   while (offset < payload.length) {
     let tag = 0;
@@ -20365,7 +20548,7 @@ function decodeDevinResponsePayload(payload) {
         s += 7;
       }
       if (fieldNum === 5) {
-        finishReason = val === 2 ? "stop" : "length";
+        finishReason = val === 10 ? "tool_calls" : val === 1 || val === 3 ? "length" : "stop";
       }
     } else if (wireType === 2) {
       let len = 0;
@@ -20386,15 +20569,55 @@ function decodeDevinResponsePayload(payload) {
         const text = valBytes.toString("utf8");
         reasoning += text;
         events.push({ type: "reasoning", text });
+      } else if (fieldNum === 6) {
+        let nestedOffset = 0;
+        let id;
+        let name;
+        let argsDelta;
+        while (nestedOffset < valBytes.length) {
+          let nestedTag = 0;
+          let nestedShift = 0;
+          while (nestedOffset < valBytes.length) {
+            const b = valBytes[nestedOffset++];
+            nestedTag |= (b & 127) << nestedShift;
+            if (!(b & 128)) break;
+            nestedShift += 7;
+          }
+          const nestedField = nestedTag >>> 3;
+          const nestedWire = nestedTag & 7;
+          if (nestedWire !== 2) break;
+          let nestedLength = 0;
+          let lengthShift = 0;
+          while (nestedOffset < valBytes.length) {
+            const b = valBytes[nestedOffset++];
+            nestedLength |= (b & 127) << lengthShift;
+            if (!(b & 128)) break;
+            lengthShift += 7;
+          }
+          const nestedValue = valBytes.subarray(nestedOffset, nestedOffset + nestedLength);
+          nestedOffset += nestedLength;
+          const text = nestedValue.toString("utf8");
+          if (nestedField === 1) id = text;
+          else if (nestedField === 2) name = text;
+          else if (nestedField === 3) argsDelta = (argsDelta ?? "") + text;
+        }
+        if (id !== void 0 && name !== void 0) {
+          events.push({ type: "tool-call-start", id, name });
+        }
+        if (argsDelta !== void 0) {
+          events.push({ type: "tool-call-args", argsDelta, ...id ? { id } : {} });
+        }
+      } else if (fieldNum === 7) {
+        usage = parseDevinMetadataUsage(valBytes);
       }
     } else {
       break;
     }
   }
-  return { content, reasoning, finishReason, events };
+  return { content, reasoning, finishReason, events, usage };
 }
 function createDevinProvider(options) {
-  const { token, model = "swe-2", fetchImpl = fetch } = options;
+  const { token, model = "swe-2-max", fetchImpl = fetch, tools = [], temperature } = options;
   return {
     model,
     async complete(messages, opts) {
@@ -20402,7 +20625,9 @@ function createDevinProvider(options) {
       const requestPayload = buildGetChatMessageRequest({
         token,
         messages,
-        model: selectedModel
+        model: selectedModel,
+        tools,
+        temperature
       });
       const frame = buildDevinConnectFrame(requestPayload);
       const response = await fetchImpl(DEVIN_CONNECT_URL, {
@@ -20417,8 +20642,11 @@ function createDevinProvider(options) {
       });
       if (!response.ok) {
         const errText = await response.text().catch(() => "");
-        throw new Error(
-          `Devin Connect upstream returned error ${response.status}: ${errText}`
+        throw attachDevinUpstreamFailure(
+          new Error(
+            `Devin Connect upstream returned error ${response.status}: ${errText}`
+          ),
+          { status: response.status, body: errText }
         );
       }
       if (!response.body) {
@@ -20426,6 +20654,11 @@ function createDevinProvider(options) {
       }
       let text = "";
       let reasoning = "";
+      let finishReason = null;
+      let frameUsage = null;
+      const toolCallOrder = [];
+      const toolCallById = /* @__PURE__ */ new Map();
+      let currentToolCallId = null;
       let buffer3 = Buffer.alloc(0);
       let sawTrailer = false;
       const reader = response.body.getReader();
@@ -20447,13 +20680,34 @@ function createDevinProvider(options) {
               continue;
             }
             const delta = decodeDevinResponsePayload(f.payload);
+            if (delta.usage?.completion !== void 0) {
+              frameUsage = delta.usage;
+            }
             text += delta.content;
             reasoning += delta.reasoning;
+            if (delta.finishReason) finishReason = delta.finishReason;
             for (const event of delta.events) {
               if (event.type === "reasoning") {
                 opts?.onReasoningDelta?.(event.text);
-              } else {
+              } else if (event.type === "content") {
                 opts?.onTextDelta?.(event.text);
+              } else if (event.type === "tool-call-start") {
+                const existing = toolCallById.get(event.id);
+                if (existing) {
+                  existing.name = event.name;
+                } else {
+                  toolCallOrder.push(event.id);
+                  toolCallById.set(event.id, {
+                    id: event.id,
+                    name: event.name,
+                    argumentsText: ""
+                  });
+                }
+                currentToolCallId = event.id;
+              } else {
+                const targetId = event.id ?? currentToolCallId;
+                const target = targetId ? toolCallById.get(targetId) : void 0;
+                if (target) target.argumentsText += event.argsDelta;
               }
             }
           }
@@ -20467,14 +20721,42 @@ function createDevinProvider(options) {
       if (!sawTrailer) {
         throw new Error("Devin Connect upstream ended before the terminal trailer");
       }
-      if (!text && !reasoning) {
-        throw new Error("Devin Connect upstream completed without content");
+      const toolCalls = toolCallOrder.map((id) => {
+        const call = toolCallById.get(id);
+        return {
+          id: call.id,
+          type: "function",
+          function: {
+            name: call.name,
+            arguments: call.argumentsText || "{}"
+          }
+        };
+      });
+      if (!text && !reasoning && toolCalls.length === 0) {
+        throw new Error("Devin Connect upstream completed without content or tool calls");
       }
+      const usage = frameUsage ? {
+        prompt_tokens: frameUsage.prompt + frameUsage.cacheRead,
+        completion_tokens: frameUsage.completion ?? 0,
+        total_tokens: frameUsage.prompt + frameUsage.cacheRead + (frameUsage.completion ?? 0) + frameUsage.cacheWrite,
+        ...frameUsage.cacheRead > 0 ? { prompt_tokens_details: { cached_tokens: frameUsage.cacheRead } } : {},
+        ...frameUsage.cacheWrite > 0 ? { cache_creation_input_tokens: frameUsage.cacheWrite } : {}
+      } : void 0;
       return {
         content: text,
         model: selectedModel,
         provider: "devin",
-        reasoning_content: reasoning || void 0
+        ...usage ? { usage } : {},
+        ...reasoning ? { reasoning_content: reasoning } : {},
+        ...toolCalls.length > 0 ? { tool_calls: toolCalls } : {},
+        // The upstream finish event wins whenever it is present. A tool call
+        // cut off by the length limit has to stay "length" instead of being
+        // relabelled "tool_calls", so probes/telemetry and any downstream
+        // consumer of the final finish_reason no longer see a truncated turn
+        // mislabelled as a normal one. localLoop keeps its own truncation
+        // gates and excludes tool-bearing turns from them.
+        finish_reason: finishReason ?? (toolCalls.length > 0 ? "tool_calls" : "stop"),
+        stream_complete: true
       };
     }
   };
@@ -20533,5 +20815,6 @@ export {
   buildGeminiGenerateContentRequest,
   resolveAntigravityFinishReason,
   fetchAntigravityCloudCodeCompletion,
+  readDevinUpstreamFailure,
   createDevinProvider
 };