@epoch-agent/core 0.15.0 → 0.17.0

package/dist/index.js

@@ -4,7 +4,7 @@ import { join, dirname, resolve, relative, isAbsolute, sep, extname, basename }
 import { execFile, execSync, execFileSync, spawn } from 'child_process';
 import { createLogger, dbPath, resolveHomeDir, DEFAULT_MAX_TURNS, PROJECT_DIR_NAME, guardSpawn, t, suggestKey, misspelledKeyIssues, openDatabase, migrate, releaseDatabase, parseLenient, issueDetails, splitWords, unknownKeyIssues, checkpointsDir, pluginsDir, projectHooksPath, projectClaudeSettingsPath, projectClaudeLocalSettingsPath, projectSettingsPath, projectLocalSettingsPath, projectPoliciesDir, trustedImportsPath, canProbeGit, budgetStatePath, artifactsDir, UNLIMITED_TURNS, turnLimitOf, configPath, managedSettingsPath, getSecretValues, listStoredSecretNames, maskApiKey, setSectionField, countCodePoints, headCodePoints, attachmentsDir, isInWorkspace, workspacesPath, samePath, lastSessionsPath, automationLogsDir, projectComplianceDir, projectSkillsDir, trustPath, projectCommandsDir, detectBackend, EXEC_PATH_AS_NODE_ENV, isolate, createStreamDecoder, parseShellCommand, writeArtifact, envPath, checkDangerousCommand, checkObfuscation, keepHeadAndTail, normalizeForMatch, isReadOnlyCommand, CODE_EXEC_ROOTS, tailCodePoints } from '@epoch-agent/infra';
 export { IS_WINDOWS, WINDOWS_HIDE_FLAGS, buildBwrapArgs, buildProfile, checkDangerousCommand, checkObfuscation, createLogger, detectBackend, getDefaultShell, getPythonCommand, isInWorkspace, isReadOnlyCommand, isolate, maskApiKey, probeBubblewrap, probeSeatbelt, complianceDir as resolveComplianceDir, policiesDir as resolvePoliciesDir, setLogLevel } from '@epoch-agent/infra';
-import { PROVIDER_TYPES, OPERATION_TYPES as OPERATION_TYPES$1, COMPLIANCE_CATEGORIES, COMPLIANCE_ACTIONS, SEARCH_PROVIDER_TYPES, CURRENCIES, LANGS, PERMISSION_LEVELS, SHELL_KINDS, ToolExposure, MAX_OPTIONS, MIN_OPTIONS, MAX_HEADER_CHARS, MAX_QUESTIONS, SCHEDULE_INTERVAL_MINUTES, isPermissionLevel, SCHEDULE_DRAFT_TOOL, isValidAgentRoleName, DEFAULT_AGENT_ROLE, isValidCommandName, RESERVED_COMMAND_NAMES, parseModelRef, isWirePluginArchiveName, systemNote, formatMoney, totalUsageTokens, NOOP_TELEMETRY, METRIC, contentToText, GEN_AI, isPromptOversize, promptTokens, apiKeyEnvVar, PROVIDER_INFOS, isProviderType, API_KEY_ENV_VARS, KEY_ACTIONS, tableOf, perAction, isKeyAction, parseSequence, RESERVED_CHORDS, chordId, sequenceId, ACTION_CONTEXTS, SEQUENCE_CONTEXTS, assertNeverPart, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_SESSION_REFS, utf8ByteLength, truncateToBudget, attachSessionSurface, isContextNearlyFull, isOperationType, normalizeApproval, imagePartOmittedSummary, MAX_ATTACH_BYTES, SIMULTANEOUS_CONTEXTS, SESSION_REFERENCE_ERROR_CODES, filePartSummary, sessionPartSummary } from '@epoch-agent/protocol';
+import { PROVIDER_TYPES, OPERATION_TYPES as OPERATION_TYPES$1, COMPLIANCE_CATEGORIES, COMPLIANCE_ACTIONS, SEARCH_PROVIDER_TYPES, CURRENCIES, LANGS, isSettingsPaneId, SETTINGS_PANE_IDS, PERMISSION_LEVELS, SHELL_KINDS, ToolExposure, MAX_OPTIONS, MIN_OPTIONS, MAX_HEADER_CHARS, MAX_QUESTIONS, SCHEDULE_INTERVAL_MINUTES, isPermissionLevel, SCHEDULE_DRAFT_TOOL, isValidAgentRoleName, DEFAULT_AGENT_ROLE, isValidCommandName, RESERVED_COMMAND_NAMES, parseModelRef, isWirePluginArchiveName, systemNote, formatMoney, totalUsageTokens, NOOP_TELEMETRY, METRIC, contentToText, GEN_AI, isPromptOversize, promptTokens, apiKeyEnvVar, PROVIDER_INFOS, isProviderType, API_KEY_ENV_VARS, KEY_ACTIONS, tableOf, perAction, isKeyAction, parseSequence, RESERVED_CHORDS, chordId, sequenceId, ACTION_CONTEXTS, SEQUENCE_CONTEXTS, assertNeverPart, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_SESSION_REFS, utf8ByteLength, truncateToBudget, attachSessionSurface, isContextNearlyFull, isOperationType, normalizeApproval, imagePartOmittedSummary, MAX_ATTACH_BYTES, SIMULTANEOUS_CONTEXTS, SESSION_REFERENCE_ERROR_CODES, filePartSummary, sessionPartSummary } from '@epoch-agent/protocol';
 export { API_KEY_ENV_VARS, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, OPERATION_TYPES, PERMISSION_LEVELS, PLAN_OUTCOMES, PROVIDER_INFOS, PROVIDER_TYPES, ToolExposure, apiKeyEnvVar, extractAllMentions, extractMentions, extractSessionMentions, getProviderInfo, isOperationType, isPermissionLevel, isPlanOutcome, isProviderType, normalizeApproval } from '@epoch-agent/protocol';
 import { createRequire } from 'module';
 import { randomUUID, createHash, randomBytes } from 'crypto';
@@ -34,7 +34,8 @@ __export(schtasks_exports, {
   quoteTaskRun: () => quoteTaskRun,
   scheduleArgs: () => scheduleArgs,
   specFromTrigger: () => specFromTrigger,
-  specFromXml: () => specFromXml
+  specFromXml: () => specFromXml,
+  taskRunArgv: () => taskRunArgv
 });
 function createSchtasksBackend(opts = {}) {
   const run = opts.run ?? runCommand2;
@@ -99,9 +100,11 @@ function createSchtasksBackend(opts = {}) {
     async inspect(osTaskId) {
       const res = await run("schtasks", ["/Query", "/TN", osTaskId, "/XML"]);
       if (res.code !== 0) return null;
+      const commandLine = commandLineFromXml(res.stdout);
       return {
         osTaskId,
-        commandLine: commandLineFromXml(res.stdout),
+        commandLine,
+        argv: taskRunArgv(commandLine),
         spec: specFromXml(res.stdout),
         enabled: !/<Enabled>\s*false\s*<\/Enabled>/i.test(res.stdout)
       };
@@ -118,6 +121,13 @@ function createSchtasksBackend(opts = {}) {
 function quoteTaskRun(argv) {
   return argv.map((part) => `"${part.replace(/"/g, "")}"`).join(" ");
 }
+function taskRunArgv(commandLine) {
+  const out = [];
+  const re = /"([^"]*)"|(\S+)/g;
+  let m;
+  while ((m = re.exec(commandLine)) !== null) out.push(m[1] ?? m[2] ?? "");
+  return out;
+}
 function scheduleArgs(trigger) {
   if (trigger.kind === "interval") {
     const slots = intervalSlots(trigger.everyMinutes);
@@ -331,9 +341,11 @@ function createLaunchdBackend(opts = {}) {
         return null;
       }
       const disabled = await isDisabled(run, label);
+      const argv = extractProgramArguments(xml2);
       return {
         osTaskId: label,
-        commandLine: extractProgramArguments(xml2).join(" "),
+        commandLine: argv.join(" "),
+        argv,
         spec: extractCalendarSpec(xml2),
         enabled: !disabled
       };
@@ -1001,6 +1013,11 @@ function createAskQuestionTool(deps) {
     }
   };
 }
+// src/agent/types.ts
+function isAbortSignal(signal) {
+  return !!signal && typeof signal.addEventListener === "function" && typeof signal.removeEventListener === "function";
+}
+// src/tools/builtin/code-exec.ts
 var MAX_CODE_LENGTH = 1e5;
 function createCodeExecTool(sandbox) {
   const iso = sandbox.getIsolation();
@@ -1046,7 +1063,7 @@ function createCodeExecTool(sandbox) {
     },
     operation: "code_exec",
     describeTarget: (args) => `${String(args["language"] ?? "")}:${String(args["code"] ?? "")}`,
-    async execute(args, _ctx) {
+    async execute(args, ctx) {
       const start = Date.now();
       const language = String(args["language"] ?? "");
       const code = String(args["code"] ?? "");
@@ -1084,7 +1101,8 @@ function createCodeExecTool(sandbox) {
         language,
         code,
         timeout,
-        allowNetwork: args["allow_network"] === true
+        allowNetwork: args["allow_network"] === true,
+        ...isAbortSignal(ctx.signal) ? { signal: ctx.signal } : {}
       });
       const header = `[\u9694\u79BB: ${result.isolation === "os" ? "OS \u7EA7" : "\u4EC5\u8FDB\u7A0B\u7EA7"}]`;
       const body2 = result.output || "(\u65E0\u8F93\u51FA)";
@@ -1096,7 +1114,9 @@ ${body2}`,
           error: {
             code: 6004,
             message: result.error ?? "\u6267\u884C\u5931\u8D25",
-            ...result.errorType === "oom" ? { suggestion: "\u51CF\u5C11\u5185\u5B58\u5360\u7528\uFF0C\u6216\u5206\u6279\u5904\u7406\u6570\u636E" } : result.errorType === "timeout" ? { suggestion: "\u4F18\u5316\u7B97\u6CD5\uFF0C\u6216\u63D0\u9AD8 timeout\uFF08\u4E0A\u9650 120 \u79D2\uFF09" } : {}
+            ...result.errorType === "oom" ? { suggestion: "\u51CF\u5C11\u5185\u5B58\u5360\u7528\uFF0C\u6216\u5206\u6279\u5904\u7406\u6570\u636E" } : (
+              result.errorType === "timeout" && !ctx.signal?.aborted ? { suggestion: "\u4F18\u5316\u7B97\u6CD5\uFF0C\u6216\u63D0\u9AD8 timeout\uFF08\u4E0A\u9650 120 \u79D2\uFF09" } : {}
+            )
           },
           duration: result.duration
         };
@@ -1106,6 +1126,218 @@ ${body2}`, duration: result.duration };
     }
   };
 }
+var WINDOW_CHARS = 1024;
+var NGRAM = 16;
+var MAX_DISTINCT_RATIO = 0.2;
+var CHECK_EVERY_CHARS = 256;
+var SUSTAIN_CHECKS = 2;
+var MIN_NORMALIZED_CHARS = 256;
+function normalizeRuns(text) {
+  return text.replace(/\s+/g, " ").replace(/(.)\1{3,}/gu, (_m, c) => c.repeat(3));
+}
+function distinctNgramRatio(text, n = NGRAM) {
+  if (text.length < n) return 1;
+  const seen = /* @__PURE__ */ new Set();
+  let total = 0;
+  for (let i = 0; i + n <= text.length; i++) {
+    seen.add(text.slice(i, i + n));
+    total++;
+  }
+  return total === 0 ? 1 : seen.size / total;
+}
+var RepetitionDetector = class {
+  buf = "";
+  sinceCheck = 0;
+  streak = 0;
+  chars = 0;
+  hit = null;
+  push(delta) {
+    if (this.hit) return true;
+    if (!delta) return false;
+    this.chars += delta.length;
+    this.buf = (this.buf + delta).slice(-WINDOW_CHARS);
+    this.sinceCheck += delta.length;
+    if (this.sinceCheck < CHECK_EVERY_CHARS) return false;
+    this.sinceCheck = 0;
+    if (this.buf.length < WINDOW_CHARS) return false;
+    const norm = normalizeRuns(this.buf);
+    if (norm.length < MIN_NORMALIZED_CHARS) {
+      this.streak = 0;
+      return false;
+    }
+    const ratio = distinctNgramRatio(norm);
+    if (ratio > MAX_DISTINCT_RATIO) {
+      this.streak = 0;
+      return false;
+    }
+    if (++this.streak < SUSTAIN_CHECKS) return false;
+    this.hit = { chars: this.chars, distinctRatio: ratio };
+    return true;
+  }
+  pushAll(text) {
+    for (let i = 0; i < text.length; i += CHECK_EVERY_CHARS) {
+      if (this.push(text.slice(i, i + CHECK_EVERY_CHARS))) return true;
+    }
+    return false;
+  }
+  isLooping() {
+    return this.hit !== null;
+  }
+  getInfo() {
+    if (!this.hit) return null;
+    return t("agent_run.looping_info", {
+      chars: this.hit.chars,
+      percent: Math.round(this.hit.distinctRatio * 100)
+    });
+  }
+};
+// src/agent/turn.ts
+async function* runTurn(opts) {
+  if (opts.streaming) {
+    return yield* runTurnStreaming(opts);
+  }
+  return yield* runTurnBuffered(opts);
+}
+async function* runTurnStreaming(opts) {
+  const { provider, input, guard, reasoningGuard } = opts;
+  const repetition = new RepetitionDetector();
+  const reasoningRepetition = new RepetitionDetector();
+  let text = "";
+  let reasoningText = "";
+  let finishReason = "stop";
+  let looping;
+  let usage;
+  const toolCalls = [];
+  let streamError;
+  let model;
+  let requestedModel;
+  let warnings;
+  const ac = new AbortController();
+  const unlink = linkAbort(input.signal, ac);
+  try {
+    for await (const chunk of provider.stream({ ...input, signal: ac.signal })) {
+      switch (chunk.type) {
+        case "text-delta": {
+          const raw = chunk.textDelta ?? "";
+          if (!raw) break;
+          const delta = guard ? guard.push(raw) : raw;
+          if (!delta) break;
+          text += delta;
+          yield { type: "text-delta", text: delta };
+          if (repetition.push(delta)) looping = repetition;
+          break;
+        }
+        case "reasoning-delta": {
+          const raw = chunk.textDelta ?? "";
+          if (!raw) break;
+          const delta = reasoningGuard ? reasoningGuard.push(raw) : raw;
+          if (!delta) break;
+          reasoningText += delta;
+          yield { type: "reasoning-delta", text: delta };
+          if (reasoningRepetition.push(delta)) looping = reasoningRepetition;
+          break;
+        }
+        case "tool-call":
+          if (chunk.toolCall) {
+            toolCalls.push({
+              toolCallId: chunk.toolCall.toolCallId,
+              toolName: chunk.toolCall.toolName,
+              input: chunk.toolCall.input
+            });
+          }
+          break;
+        case "finish":
+          if (chunk.usage) usage = chunk.usage;
+          if (chunk.finishReason) finishReason = chunk.finishReason;
+          if (chunk.model) model = chunk.model;
+          if (chunk.requestedModel) requestedModel = chunk.requestedModel;
+          if (chunk.warnings) warnings = chunk.warnings;
+          break;
+        case "error":
+          streamError = chunk.error ?? t("agent_run.unknown_provider_error");
+          break;
+        case "tool-result":
+          break;
+      }
+      if (looping) {
+        ac.abort();
+        break;
+      }
+    }
+  } finally {
+    unlink();
+  }
+  if (streamError && !looping) throw new Error(streamError);
+  if (guard) {
+    const tail = guard.flush();
+    if (tail) {
+      text += tail;
+      yield { type: "text-delta", text: tail };
+    }
+  }
+  if (reasoningGuard) {
+    const tail = reasoningGuard.flush();
+    if (tail) {
+      reasoningText += tail;
+      yield { type: "reasoning-delta", text: tail };
+    }
+  }
+  return {
+    text,
+    ...usage ? { usage } : {},
+    finishReason: looping ? "looping" : finishReason,
+    ...looping ? { loopingInfo: looping.getInfo() ?? "" } : {},
+    ...toolCalls.length > 0 ? { toolCalls } : {},
+    ...reasoningText ? { reasoningText } : {},
+    ...model ? { model } : {},
+    ...requestedModel ? { requestedModel } : {},
+    ...warnings && warnings.length > 0 ? { warnings } : {}
+  };
+}
+async function* runTurnBuffered(opts) {
+  const { provider, input, guard, reasoningGuard } = opts;
+  const result = await provider.generate(input);
+  const reasoningText = result.reasoningText ? filterWhole(reasoningGuard, result.reasoningText) : result.reasoningText;
+  if (reasoningText) {
+    yield { type: "reasoning-delta", text: reasoningText };
+  }
+  const text = filterWhole(guard, result.text);
+  if (text) {
+    yield { type: "text-delta", text };
+  }
+  const { reasoningText: _replaced, ...rest } = result;
+  const textLoop = new RepetitionDetector();
+  const reasoningLoop = new RepetitionDetector();
+  textLoop.pushAll(text);
+  if (reasoningText) reasoningLoop.pushAll(reasoningText);
+  let looping;
+  if (textLoop.isLooping()) looping = textLoop;
+  else if (reasoningLoop.isLooping()) looping = reasoningLoop;
+  return {
+    ...rest,
+    text,
+    ...reasoningText ? { reasoningText } : {},
+    ...looping ? { finishReason: "looping", loopingInfo: looping.getInfo() ?? "" } : {}
+  };
+}
+function linkAbort(outer, ac) {
+  if (!outer) return () => {
+  };
+  if (outer.aborted) {
+    ac.abort(outer.reason);
+    return () => {
+    };
+  }
+  const onAbort = () => ac.abort(outer.reason);
+  outer.addEventListener("abort", onAbort, { once: true });
+  return () => outer.removeEventListener("abort", onAbort);
+}
+function filterWhole(guard, text) {
+  if (!guard || !text) return text;
+  return guard.push(text) + guard.flush();
+}
+// src/delegate/manager.ts
+var ABORTED = "\u5DF2\u4E2D\u6B62\uFF1A\u7528\u6237\u7EC8\u6B62\u4E86\u8FD9\u4E00\u8F6E";
 var BLOCKED_TOOLS = Object.freeze([
   "delegate_task",
   "clarify",
@@ -1135,7 +1367,7 @@ var DelegateManager = class {
       ...config
     };
   }
-  async delegate(args, parentSessionId) {
+  async delegate(args, parentSessionId, signal) {
     const start = Date.now();
     const tasks = this.normalizeTasks(args);
     const maxConcurrent = args.max_concurrent ?? this.config.max_concurrent_children;
@@ -1146,7 +1378,7 @@ var DelegateManager = class {
         duration: 0
       };
     }
-    const results = await this.runWithConcurrency(tasks, maxConcurrent, parentSessionId);
+    const results = await this.runWithConcurrency(tasks, maxConcurrent, parentSessionId, signal);
     const summary = this.buildSummary(results, Date.now() - start);
     return {
       success: results.every((r) => r.success),
@@ -1161,12 +1393,12 @@ var DelegateManager = class {
     if (args.goal) return [{ goal: args.goal, ...args.role ? { role: args.role } : {} }];
     return [];
   }
-  async runWithConcurrency(tasks, maxConcurrent, parentSessionId) {
+  async runWithConcurrency(tasks, maxConcurrent, parentSessionId, signal) {
     const results = [];
     for (let i = 0; i < tasks.length; i += maxConcurrent) {
       const batch = tasks.slice(i, i + maxConcurrent);
       const batchResults = await Promise.allSettled(
-        batch.map((t81) => this.runSingleTask(t81, parentSessionId))
+        batch.map((t81) => this.runSingleTask(t81, parentSessionId, signal))
       );
       for (const r of batchResults) {
         if (r.status === "fulfilled") {
@@ -1184,14 +1416,40 @@ var DelegateManager = class {
     }
     return results;
   }
-  async runSingleTask(task, parentSessionId) {
+  async runSingleTask(task, parentSessionId, signal) {
     const start = Date.now();
     const sessionId = `delegate-${randomUUID().slice(0, 8)}`;
+    const failed = (error, summary = "") => ({
+      goal: task.goal,
+      success: false,
+      summary,
+      error,
+      duration: Date.now() - start,
+      ...task.role ? { role: task.role } : {}
+    });
+    if (signal?.aborted) return failed(ABORTED);
+    const controller = new AbortController();
+    const unlink = linkAbort(isAbortSignal(signal) ? signal : void 0, controller);
+    const ms = this.config.task_timeout;
+    let timer;
     try {
-      const result = await this.runWithTimeout(
-        this.runner(task.goal, task.context ?? "", sessionId, task.role, parentSessionId),
-        this.config.task_timeout
-      );
+      const result = await Promise.race([
+        this.runner(
+          task.goal,
+          task.context ?? "",
+          sessionId,
+          task.role,
+          parentSessionId,
+          controller.signal
+        ),
+        new Promise((_, reject2) => {
+          timer = setTimeout(() => {
+            reject2(new Error(`\u8D85\u65F6 (${ms / 1e3}s)`));
+            controller.abort();
+          }, ms);
+        })
+      ]);
+      if (controller.signal.aborted) return failed(ABORTED, result.text);
       return {
         goal: task.goal,
         success: !result.error,
@@ -1202,22 +1460,13 @@ var DelegateManager = class {
       };
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
-      return {
-        goal: task.goal,
-        success: false,
-        summary: "",
-        error: msg.includes("\u8D85\u65F6") ? `[\u8D85\u65F6] ${msg}` : msg,
-        duration: Date.now() - start,
-        ...task.role ? { role: task.role } : {}
-      };
+      if (signal?.aborted) return failed(ABORTED);
+      return failed(msg.includes("\u8D85\u65F6") ? `[\u8D85\u65F6] ${msg}` : msg);
+    } finally {
+      clearTimeout(timer);
+      unlink();
     }
   }
-  async runWithTimeout(promise, ms) {
-    const timeout = new Promise(
-      (_, reject2) => setTimeout(() => reject2(new Error(`\u8D85\u65F6 (${ms / 1e3}s)`)), ms)
-    );
-    return Promise.race([promise, timeout]);
-  }
   buildSummary(results, totalDuration) {
     const lines = [];
     const succeeded = results.filter((r) => r.success).length;
@@ -1361,12 +1610,13 @@ function createDelegateTool(runner, config, roles) {
           ...topRole ? { role: topRole } : {},
           ...maxConcurrent ? { max_concurrent: maxConcurrent } : {}
         },
-        ctx.sessionId
+        ctx.sessionId,
+        ctx.signal
       );
       return {
         success: result.success,
         output: result.output,
-        ...result.success ? {} : { error: { code: 7002, message: "\u90E8\u5206\u5B50\u4EFB\u52A1\u5931\u8D25\uFF0C\u8BE6\u60C5\u89C1\u8F93\u51FA" } },
+        ...result.success ? {} : { error: { code: 7002, message: result.output } },
         duration: result.duration
       };
     }
@@ -10430,6 +10680,17 @@ function blankResponseNote(chars) {
     "\u4E0A\u4E00\u8F6E\u7684\u5DE5\u5177\u7ED3\u679C\u90FD\u8FD8\u5728\u4E0A\u9762\u7684\u4E0A\u4E0B\u6587\u91CC\uFF0C\u76F4\u63A5\u636E\u6B64\u4F5C\u7B54\uFF0C\u522B\u628A\u90A3\u4E9B\u5DE5\u5177\u91CD\u8DD1\u4E00\u904D\u3002"
   ].join("\n");
 }
+var STALL_NOTE_ARGS_MAX_CHARS = 200;
+function stallNote(detail) {
+  const args = detail.args.length > STALL_NOTE_ARGS_MAX_CHARS ? `${detail.args.slice(0, STALL_NOTE_ARGS_MAX_CHARS)}\u2026` : detail.args;
+  const fact = detail.kind === "failure" ? `\u4F60\u5DF2\u7ECF\u7528\u540C\u4E00\u4EFD\u53C2\u6570\u8C03\u4E86 ${detail.count} \u6B21 ${detail.tool}\uFF08${args}\uFF09\uFF0C\u6BCF\u6B21\u90FD\u5931\u8D25\uFF0C\u800C\u4E14\u662F\u540C\u4E00\u6761\u9519\u8BEF\uFF1A${detail.error ?? ""}` : `\u4F60\u5DF2\u7ECF\u8FDE\u7EED ${detail.count} \u8F6E\u7528\u540C\u4E00\u4EFD\u53C2\u6570\u8C03 ${detail.tool}\uFF08${args}\uFF09\uFF0C\u7ED3\u679C\u4E0D\u4F1A\u56E0\u4E3A\u518D\u8C03\u4E00\u6B21\u800C\u6539\u53D8\u3002`;
+  return [
+    `${fact} \u2014\u2014 \u8FD9\u662F\u5728\u539F\u5730\u6253\u8F6C\u3002`,
+    detail.kind === "failure" ? "\u522B\u518D\u539F\u6837\u91CD\u8BD5\u3002\u5148\u8BFB\u61C2\u8FD9\u6761\u9519\u8BEF\u8BF4\u7684\u662F\u4EC0\u4E48\uFF0C\u7136\u540E\u6362\u4E00\u79CD\u505A\u6CD5\uFF1A\u6362\u53C2\u6570\u3001\u6362\u4E00\u4E2A\u5DE5\u5177\uFF0C\u6216\u8005\u7ED5\u5F00\u8FD9\u4E00\u6B65\u7528\u5DF2\u7ECF\u62FF\u5230\u7684\u7ED3\u679C\u5F80\u4E0B\u8D70\u3002" : "\u522B\u518D\u539F\u6837\u8C03\u4E00\u6B21\u3002\u5B83\u7684\u7ED3\u679C\u5DF2\u7ECF\u5728\u4E0A\u9762\u7684\u4E0A\u4E0B\u6587\u91CC\u4E86\uFF0C\u76F4\u63A5\u7528\uFF1B\u8981\u4E48\u6362\u53C2\u6570\u3001\u6362\u4E00\u4E2A\u5DE5\u5177\uFF0C\u6362\u4E00\u79CD\u505A\u6CD5\u5F80\u4E0B\u8D70\u3002",
+    "\u5982\u679C\u786E\u5B9E\u6CA1\u6709\u522B\u7684\u8DEF\uFF08\u5DE5\u5177\u672C\u8EAB\u574F\u4E86\u3001\u7F3A\u6743\u9650\u6216\u51ED\u636E\u3001\u9700\u8981\u7528\u6237\u5148\u505A\u70B9\u4EC0\u4E48\uFF09\uFF0C\u5C31\u505C\u4E0B\u6765\uFF0C\u76F4\u63A5\u544A\u8BC9\u7528\u6237\u5361\u5728\u54EA\u4E00\u6B65\u3001\u9700\u8981\u4ED6\u505A\u4EC0\u4E48\u3002",
+    "\u8FD9\u662F\u552F\u4E00\u4E00\u6B21\u63D0\u9192\uFF1A\u518D\u9677\u8FDB\u540C\u6837\u7684\u91CD\u590D\uFF0C\u4EFB\u52A1\u4F1A\u88AB\u76F4\u63A5\u7EC8\u6B62\u3002"
+  ].join("\n");
+}
 var CODE_VERIFICATION_POLICY = [
   "<code_verification>",
   "\u6539\u5B8C\u4EE3\u7801\u3001\u5BA3\u5E03\u5B8C\u6210\u4E4B\u524D\uFF0C\u8C03\u4E00\u6B21 `lsp_diagnostics`\uFF0C\u628A\u672C\u8F6E\u65B0\u5EFA\u6216\u4FEE\u6539\u8FC7\u7684\u6E90\u6587\u4EF6\u5217\u8FDB\u53BB\u3002",
@@ -10615,6 +10876,28 @@ var StallDetector = class {
     }
     return null;
   }
+  getStallDetail() {
+    const failure = this.stalledFailure();
+    if (failure) {
+      return {
+        kind: "failure",
+        tool: failure.toolName,
+        args: failure.args,
+        count: failure.count,
+        error: failure.error
+      };
+    }
+    const streak = this.stalledStreak();
+    if (streak) {
+      return {
+        kind: "streak",
+        tool: streak.toolName,
+        args: streak.args,
+        count: streak.consecutive
+      };
+    }
+    return null;
+  }
   reset() {
     this.history = [];
     this.failures.clear();
@@ -10933,7 +11216,7 @@ var ToolExecutor = class {
           output: `\u64CD\u4F5C\u88AB hook \u963B\u6B62: ${blocked.reason || "\u672A\u77E5\u539F\u56E0"}`
         });
       }
-      const gate = await this.checkPermission(et, tc.input);
+      const gate = await this.checkPermission(et, tc.input, signal);
       if (!gate.allowed) {
         return finish({ ...base, success: false, output: gate.output });
       }
@@ -11076,7 +11359,7 @@ var ToolExecutor = class {
     );
     return guessed || argsKey(args);
   }
-  async checkPermission(et, args) {
+  async checkPermission(et, args, signal) {
     const pm = this.deps.permissionManager;
     if (!pm) return { allowed: true };
     const toolName = et.name;
@@ -11110,6 +11393,9 @@ var ToolExecutor = class {
         ...decision.rememberable === false ? { rememberable: false } : {}
       })
     );
+    if (signal?.aborted) {
+      return { allowed: false, output: "\u64CD\u4F5C\u5DF2\u4E2D\u6B62\uFF1A\u7528\u6237\u7EC8\u6B62\u4E86\u8FD9\u4E00\u8F6E\u3002" };
+    }
     this.deps.telemetry?.counter(METRIC.TOOL_APPROVAL, 1, {
       [GEN_AI.TOOL_NAME]: toolName,
       "epoch.approval.outcome": outcome
@@ -11131,220 +11417,6 @@ var ToolExecutor = class {
     return { allowed: true };
   }
 };
-var WINDOW_CHARS = 1024;
-var NGRAM = 16;
-var MAX_DISTINCT_RATIO = 0.2;
-var CHECK_EVERY_CHARS = 256;
-var SUSTAIN_CHECKS = 2;
-var MIN_NORMALIZED_CHARS = 256;
-function normalizeRuns(text) {
-  return text.replace(/\s+/g, " ").replace(/(.)\1{3,}/gu, (_m, c) => c.repeat(3));
-}
-function distinctNgramRatio(text, n = NGRAM) {
-  if (text.length < n) return 1;
-  const seen = /* @__PURE__ */ new Set();
-  let total = 0;
-  for (let i = 0; i + n <= text.length; i++) {
-    seen.add(text.slice(i, i + n));
-    total++;
-  }
-  return total === 0 ? 1 : seen.size / total;
-}
-var RepetitionDetector = class {
-  buf = "";
-  sinceCheck = 0;
-  streak = 0;
-  chars = 0;
-  hit = null;
-  push(delta) {
-    if (this.hit) return true;
-    if (!delta) return false;
-    this.chars += delta.length;
-    this.buf = (this.buf + delta).slice(-WINDOW_CHARS);
-    this.sinceCheck += delta.length;
-    if (this.sinceCheck < CHECK_EVERY_CHARS) return false;
-    this.sinceCheck = 0;
-    if (this.buf.length < WINDOW_CHARS) return false;
-    const norm = normalizeRuns(this.buf);
-    if (norm.length < MIN_NORMALIZED_CHARS) {
-      this.streak = 0;
-      return false;
-    }
-    const ratio = distinctNgramRatio(norm);
-    if (ratio > MAX_DISTINCT_RATIO) {
-      this.streak = 0;
-      return false;
-    }
-    if (++this.streak < SUSTAIN_CHECKS) return false;
-    this.hit = { chars: this.chars, distinctRatio: ratio };
-    return true;
-  }
-  pushAll(text) {
-    for (let i = 0; i < text.length; i += CHECK_EVERY_CHARS) {
-      if (this.push(text.slice(i, i + CHECK_EVERY_CHARS))) return true;
-    }
-    return false;
-  }
-  isLooping() {
-    return this.hit !== null;
-  }
-  getInfo() {
-    if (!this.hit) return null;
-    return t("agent_run.looping_info", {
-      chars: this.hit.chars,
-      percent: Math.round(this.hit.distinctRatio * 100)
-    });
-  }
-};
-// src/agent/turn.ts
-async function* runTurn(opts) {
-  if (opts.streaming) {
-    return yield* runTurnStreaming(opts);
-  }
-  return yield* runTurnBuffered(opts);
-}
-async function* runTurnStreaming(opts) {
-  const { provider, input, guard, reasoningGuard } = opts;
-  const repetition = new RepetitionDetector();
-  const reasoningRepetition = new RepetitionDetector();
-  let text = "";
-  let reasoningText = "";
-  let finishReason = "stop";
-  let looping;
-  let usage;
-  const toolCalls = [];
-  let streamError;
-  let model;
-  let requestedModel;
-  let warnings;
-  const ac = new AbortController();
-  const unlink = linkAbort(input.signal, ac);
-  try {
-    for await (const chunk of provider.stream({ ...input, signal: ac.signal })) {
-      switch (chunk.type) {
-        case "text-delta": {
-          const raw = chunk.textDelta ?? "";
-          if (!raw) break;
-          const delta = guard ? guard.push(raw) : raw;
-          if (!delta) break;
-          text += delta;
-          yield { type: "text-delta", text: delta };
-          if (repetition.push(delta)) looping = repetition;
-          break;
-        }
-        case "reasoning-delta": {
-          const raw = chunk.textDelta ?? "";
-          if (!raw) break;
-          const delta = reasoningGuard ? reasoningGuard.push(raw) : raw;
-          if (!delta) break;
-          reasoningText += delta;
-          yield { type: "reasoning-delta", text: delta };
-          if (reasoningRepetition.push(delta)) looping = reasoningRepetition;
-          break;
-        }
-        case "tool-call":
-          if (chunk.toolCall) {
-            toolCalls.push({
-              toolCallId: chunk.toolCall.toolCallId,
-              toolName: chunk.toolCall.toolName,
-              input: chunk.toolCall.input
-            });
-          }
-          break;
-        case "finish":
-          if (chunk.usage) usage = chunk.usage;
-          if (chunk.finishReason) finishReason = chunk.finishReason;
-          if (chunk.model) model = chunk.model;
-          if (chunk.requestedModel) requestedModel = chunk.requestedModel;
-          if (chunk.warnings) warnings = chunk.warnings;
-          break;
-        case "error":
-          streamError = chunk.error ?? t("agent_run.unknown_provider_error");
-          break;
-        case "tool-result":
-          break;
-      }
-      if (looping) {
-        ac.abort();
-        break;
-      }
-    }
-  } finally {
-    unlink();
-  }
-  if (streamError && !looping) throw new Error(streamError);
-  if (guard) {
-    const tail = guard.flush();
-    if (tail) {
-      text += tail;
-      yield { type: "text-delta", text: tail };
-    }
-  }
-  if (reasoningGuard) {
-    const tail = reasoningGuard.flush();
-    if (tail) {
-      reasoningText += tail;
-      yield { type: "reasoning-delta", text: tail };
-    }
-  }
-  return {
-    text,
-    ...usage ? { usage } : {},
-    finishReason: looping ? "looping" : finishReason,
-    ...looping ? { loopingInfo: looping.getInfo() ?? "" } : {},
-    ...toolCalls.length > 0 ? { toolCalls } : {},
-    ...reasoningText ? { reasoningText } : {},
-    ...model ? { model } : {},
-    ...requestedModel ? { requestedModel } : {},
-    ...warnings && warnings.length > 0 ? { warnings } : {}
-  };
-}
-async function* runTurnBuffered(opts) {
-  const { provider, input, guard, reasoningGuard } = opts;
-  const result = await provider.generate(input);
-  const reasoningText = result.reasoningText ? filterWhole(reasoningGuard, result.reasoningText) : result.reasoningText;
-  if (reasoningText) {
-    yield { type: "reasoning-delta", text: reasoningText };
-  }
-  const text = filterWhole(guard, result.text);
-  if (text) {
-    yield { type: "text-delta", text };
-  }
-  const { reasoningText: _replaced, ...rest } = result;
-  const textLoop = new RepetitionDetector();
-  const reasoningLoop = new RepetitionDetector();
-  textLoop.pushAll(text);
-  if (reasoningText) reasoningLoop.pushAll(reasoningText);
-  let looping;
-  if (textLoop.isLooping()) looping = textLoop;
-  else if (reasoningLoop.isLooping()) looping = reasoningLoop;
-  return {
-    ...rest,
-    text,
-    ...reasoningText ? { reasoningText } : {},
-    ...looping ? { finishReason: "looping", loopingInfo: looping.getInfo() ?? "" } : {}
-  };
-}
-function linkAbort(outer, ac) {
-  if (!outer) return () => {
-  };
-  if (outer.aborted) {
-    ac.abort(outer.reason);
-    return () => {
-    };
-  }
-  const onAbort = () => ac.abort(outer.reason);
-  outer.addEventListener("abort", onAbort, { once: true });
-  return () => outer.removeEventListener("abort", onAbort);
-}
-function filterWhole(guard, text) {
-  if (!guard || !text) return text;
-  return guard.push(text) + guard.flush();
-}
-// src/agent/types.ts
-function isAbortSignal(signal) {
-  return !!signal && typeof signal.addEventListener === "function" && typeof signal.removeEventListener === "function";
-}
 // src/agent/loop.ts
 var DEFAULT_CONTEXT_LENGTH = 128e3;
 function shrank(before, after) {
@@ -11671,6 +11743,7 @@ var AgentLoop = class {
       let idleNudged = false;
       let blankNudged = false;
       let blankAfterNudge = false;
+      let stallNudged = false;
       for (let turn = 1; turn <= maxTurns; turn++) {
         if (this.isAborted(input.signal)) {
           if (turns.length > 0 || lastText) {
@@ -12069,7 +12142,17 @@ ${finalText}` };
           turn
         });
         yield { type: "turn-complete", turn };
-        if (this.stallDetector.isStalled()) {
+        const stall = this.stallDetector.getStallDetail();
+        if (stall && !stallNudged && turn < maxTurns) {
+          stallNudged = true;
+          yield {
+            type: "notice",
+            code: "stall-nudged",
+            text: t("agent_run.stall_nudged", { info: this.stallDetector.getStallInfo() ?? "" })
+          };
+          this.stallDetector.reset();
+          messages.push({ role: "user", content: systemNote(stallNote(stall)) });
+        } else if (stall) {
           const msg2 = t("agent_run.stalled", { info: this.stallDetector.getStallInfo() ?? "" });
           yield { type: "text-delta", text: msg2 };
           await this.prompt.syncMemory(userText, msg2);
@@ -12421,8 +12504,48 @@ var EpochConfigSchema = z.object({
     message: "blankCards: id must be unique"
   }).optional(),
   blankGreeting: BlankGreetingSchema.optional(),
-  user: HostUserSchema.optional()
+  user: HostUserSchema.optional(),
+  settingsHidden: z.array(z.string().min(1)).min(1).optional(),
+  settingsPanes: z.array(
+    z.object({
+      id: z.string().min(1).refine((id) => !isSettingsPaneId(id), {
+        message: `id must not collide with a built-in pane (${SETTINGS_PANE_IDS.join(", ")})`
+      }),
+      label: z.string().min(1),
+      icon: z.string().min(1).optional(),
+      url: z.string().min(1).refine(
+        (url) => {
+          try {
+            const scheme = new URL(url).protocol;
+            return scheme === "http:" || scheme === "https:";
+          } catch {
+            return false;
+          }
+        },
+        { message: "url must be an absolute http(s) URL" }
+      ),
+      before: z.string().min(1).optional()
+    })
+  ).min(1).refine((items) => new Set(items.map((item) => item.id)).size === items.length, {
+    message: "settingsPanes: id must be unique"
+  }).optional()
 });
+function settingsHiddenIssues(config) {
+  const hidden = config.settingsHidden;
+  if (hidden === void 0) return [];
+  return hidden.filter((id) => !isSettingsPaneId(id)).map((id) => ({
+    path: "settingsHidden",
+    message: `unknown settings pane id: ${id} (known: ${SETTINGS_PANE_IDS.join(", ")})`
+  }));
+}
+function settingsPaneBeforeIssues(config) {
+  const panes = config.settingsPanes;
+  if (panes === void 0) return [];
+  return panes.filter((pane) => pane.before !== void 0 && !isSettingsPaneId(pane.before)).map((pane) => ({
+    path: `settingsPanes.${pane.id}.before`,
+    message: `unknown settings pane id: ${String(pane.before)} (known: ${SETTINGS_PANE_IDS.join(", ")})`
+  }));
+}
 function defaultConfig() {
   return EpochConfigSchema.parse({});
 }
@@ -12893,6 +13016,8 @@ function parseRawConfig(raw, issues, track) {
     EpochConfigSchema.parse({})
   );
   issues.push(...outcome.issues);
+  issues.push(...settingsHiddenIssues(outcome.value));
+  issues.push(...settingsPaneBeforeIssues(outcome.value));
   if (outcome.issues.length === 0) collectKeyPaths(migrated.raw, track.file);
   return outcome.value;
 }
@@ -19524,6 +19649,9 @@ var ScheduleRegistrar = class {
     this.opts = opts;
   }
   opts;
+  get homeDir() {
+    return this.opts.homeDir;
+  }
   osTaskIdFor(taskId) {
     const backend = this.opts.backend;
     if (!backend) return "";
@@ -19594,7 +19722,6 @@ var ScheduleRegistrar = class {
     if (this.opts.backend && def.osTaskId) await this.opts.backend.retire(def.osTaskId);
   }
 };
-// src/schedule/doctor.ts
 async function diagnoseSchedules(opts) {
   const { store, backend, registrar } = opts;
   if (!backend) return { checked: 0, drifts: [], unsupported: true };
@@ -19631,8 +19758,18 @@ async function diagnoseSchedules(opts) {
       });
     }
   }
+  let foreign = 0;
   for (const osTaskId of osTaskIds) {
     if (seen.has(osTaskId)) continue;
+    const snapshot = await backend.inspect(osTaskId);
+    if (!snapshot) {
+      foreign++;
+      continue;
+    }
+    if (!ownedByThisHome(snapshot.argv, registrar.homeDir)) {
+      foreign++;
+      continue;
+    }
     const taskId = backend.taskIdFrom(osTaskId);
     drifts.push({
       kind: "orphan-in-os",
@@ -19640,7 +19777,17 @@ async function diagnoseSchedules(opts) {
       ...taskId ? { scheduleId: taskId } : {}
     });
   }
-  return { checked: defs.length + osTaskIds.length - seen.size, drifts, unsupported: false };
+  return {
+    checked: defs.length + osTaskIds.length - seen.size - foreign,
+    drifts,
+    unsupported: false
+  };
+}
+function ownedByThisHome(argv, homeDir) {
+  const at = argv.indexOf("--home");
+  const home = at >= 0 ? argv[at + 1] : void 0;
+  if (home === void 0 || home.length === 0) return true;
+  return samePath(home, homeDir);
 }
 function compare2(def, snapshot, backend, registrar) {
   const expected = backend.expectedSnapshot(registrar.toRegisterInput(def, def.osCommand));