@epoch-agent/core 0.3.2 → 0.5.0

package/dist/index.d.ts

@@ -7563,6 +7563,13 @@ interface AgentConfig {
      * 和 `LogFn` 同一条规矩：库不替宿主决定往哪儿发数据，真 SDK 的装配在 runtime。
      */
     telemetry?: Telemetry;
+    /**
+     * 一条用户消息底下最多几次模型请求。**`0` = 不设上限**，也是缺省
+     * （判据全文在 infra 的 `DEFAULT_MAX_TURNS` / `UNLIMITED_TURNS` 上）。
+     *
+     * `undefined` 和 `0` 在这一格上**同义**（都落到 `DEFAULT_MAX_TURNS`），
+     * 两者的区别只在 `RunInput.maxTurns` 那一格上才成立 —— 见那儿。
+     */
     maxTurns?: number;
     /**
      * 工作目录。
@@ -7909,6 +7916,11 @@ interface RunInput {
      *
      * 是 per-call 而不是改配置：长驻宿主（`--input-format stream-json`）一个进程
      * 服务很多次调用，把「这一次最多跑几轮」写进进程级配置就没法逐次收紧了。
+     *
+     * ⚠️ **这一格上 `undefined` 和 `0` 是两个意思**（2026-09-06）：`undefined` =
+     * 「这次没给，跟配置走」，`0` = 「这次不限轮次」（`--max-turns 0`，压过一个
+     * 配置里设了上限的会话）。所以消费它的那一行必须是 `??` 而不是 `||` ——
+     * 判据在 `loop.ts` 的 `runTurns()` 上。
      */
     maxTurns?: number;
     /**
@@ -9817,6 +9829,28 @@ declare const EpochConfigSchema: z.ZodObject<{
         label: z.ZodString;
         icon: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    blankCards: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        subtitle: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    blankGreeting: z.ZodOptional<z.ZodObject<{
+        eyebrow: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            zh: "zh";
+            en: "en";
+        }> & z.core.$partial, z.ZodString>>;
+        title: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            zh: "zh";
+            en: "en";
+        }> & z.core.$partial, z.ZodString>>;
+        subtitle: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            zh: "zh";
+            en: "en";
+        }> & z.core.$partial, z.ZodString>>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * 全默认配置 —— 从 schema 派生，不是第二份字面量。
@@ -12961,8 +12995,27 @@ type UpdateScheduleInput = Partial<Omit<CreateScheduleInput, 'maxBudgetUsd'>> &
  * `maxBudgetUsd` **不在这里**，那是刻意的 —— 它没有缺省值。
  */
 declare const SCHEDULE_DEFAULTS: {
-    /** 交互缺省是 50。无人看着的一轮不该比有人看着的更长 */
-    readonly maxTurns: 20;
+    /**
+     * 和交互缺省**同一个常量**（2026-09-04，原来这儿是自己的一个 `20`）。
+     *
+     * 那个 20 的理由写的是「无人看着的一轮不该比有人看着的更长」。它不成立了 ——
+     * 它当初拦的是「跑飞了没人按 Esc」，而这一层真正拦住那件事的是 `maxBudgetUsd`：
+     * 它在这套功能里**必填**（所以它不在这份缺省里），而钱是比轮次准的尺子。
+     * 用轮次替它把无人值守的活压到 20，拦掉的绝大多数不是跑飞，是「这个任务本来
+     * 就要 60 轮」—— 而那种失败要等到第二天 9 点才看得见（同下面
+     * `SCHEDULE_DEFAULT_ALLOWLIST` 那节的判据）。
+     *
+     * ⚠️ 这一份是**没有配置在手时的兜底**。真正拿着用户那格 `maxTurns` 的地方是
+     * `server/src/schedule/handlers.ts` 的 `defaultsOf()` —— 表单预填走它，
+     * 所以用户把设置里那个数改成 500，新建任务那一格就预填 500。
+     *
+     * ⚠️ **2026-09-06 起这个缺省是「不设上限」**（`UNLIMITED_TURNS`），因为上面那条
+     * 判据跟着交互缺省一起走到了头：既然轮次拦掉的绝大多数不是跑飞，那把它当无人
+     * 值守的兜底闸门就是**拿错了尺子**。这条路上兜住跑飞的仍然是 `maxBudgetUsd`
+     * （必填，所以它不在这份缺省里）和 `timeoutMs`。要一道轮次闸门的人在新建任务
+     * 那一格自己填一个数。
+     */
+    readonly maxTurns: 0;
     /** 15 分钟。唯一能拦住「一条命令挂住了」的那把尺子 */
     readonly timeoutMs: number;
 };
@@ -14367,6 +14420,32 @@ declare class HookManager implements HookManager$1 {
     } | null>;
     trigger(type: HookType, event: HookEvent, ctx: HookContext): Promise<void>;
     triggerTransform<T>(type: HookType, event: HookEvent, ctx: HookContext): Promise<T | null>;
+    /**
+     * ## ⚠️ 这个方法**必须**同时读 `commandHooks`（2026-09-04 补的那一半）
+     *
+     * 它原来是三个分发方法里唯一不读配置文件那一半的：
+     *
+     * | 方法 | 读 `this.hooks` | 读 `this.commandHooks` |
+     * | ---- | :--: | :--: |
+     * | {@link trigger} | ✅ | ✅ |
+     * | {@link triggerCommandHooks} | ❌ | ✅ |
+     * | 这一个（改之前） | ✅ | **❌** |
+     *
+     * 而 `verify:stop` **只**走这一条路。两条路当时都是死的：配置文件那一半没人读，
+     * 进程内注册那一半对嵌入宿主也够不着（`BuildRuntimeOptions` 没有 hooks 字段、
+     * `EpochRuntime` 上没有 `hookManager`）。于是「模型说完就停」那唯一一道闸
+     * 对所有人都是关着的，而且**零诊断**：配置合法、`parseHooksConfig` 收下了它、
+     * `issues` 是空的、`commandHooks` map 里真的有它 —— 只是没有任何一处会去读。
+     * 写了它的人拿不到任何反馈，只会以为「配了但模型不听」。
+     *
+     * ## 这里是 `await`，不是 `trigger` 那种 fire-and-forget
+     *
+     * 表决要参与判断（`AgentLoop` 据此决定要不要再跑一轮），所以必须等。
+     * 超时用的是**每条 hook 自己的** `config.timeout`（`runCommandHook` 里缺省
+     * 30 秒），不是上面那个给 JS hook 的 {@link HOOK_TIMEOUT_MS} 5 秒 ——
+     * 那 5 秒对一条要跑测试或跑 lint 的 `verify:stop` 明显偏紧，
+     * 而 `HookEntrySchema` 里本来就有 `timeout` 这一格。
+     */
     triggerVerify(type: HookType, event: HookEvent, ctx: HookContext): Promise<VerifyResult[]>;
     private getSorted;
 }

package/dist/index.js

@@ -2,7 +2,7 @@ import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync, rmSync
 import { homedir, platform, tmpdir, hostname } from 'os';
 import { join, dirname, isAbsolute, resolve, relative, sep, extname, basename } from 'path';
 import { execFile, execSync, execFileSync, spawn } from 'child_process';
-import { createLogger, dbPath, resolveHomeDir, t, unknownKeyIssues, parseLenient, issueDetails, splitWords, checkpointsDir, trustedImportsPath, budgetStatePath, artifactsDir, configPath, managedSettingsPath, projectSettingsPath, projectLocalSettingsPath, getSecretValues, listStoredSecretNames, maskApiKey, setSectionField, isInWorkspace, workspacesPath, openDatabase, migrate, releaseDatabase, automationLogsDir, projectPoliciesDir, projectComplianceDir, projectHooksPath, projectClaudeSettingsPath, projectClaudeLocalSettingsPath, projectSkillsDir, trustPath, detectBackend, EXEC_PATH_AS_NODE_ENV, isolate, createStreamDecoder, writeArtifact, parseShellCommand, envPath, checkDangerousCommand, checkObfuscation, countCodePoints, keepHeadAndTail, normalizeForMatch, isReadOnlyCommand, CODE_EXEC_ROOTS } from '@epoch-agent/infra';
+import { createLogger, dbPath, resolveHomeDir, DEFAULT_MAX_TURNS, t, unknownKeyIssues, parseLenient, issueDetails, splitWords, checkpointsDir, trustedImportsPath, budgetStatePath, artifactsDir, UNLIMITED_TURNS, turnLimitOf, configPath, managedSettingsPath, projectSettingsPath, projectLocalSettingsPath, getSecretValues, listStoredSecretNames, maskApiKey, setSectionField, isInWorkspace, workspacesPath, openDatabase, migrate, releaseDatabase, automationLogsDir, projectPoliciesDir, projectComplianceDir, projectHooksPath, projectClaudeSettingsPath, projectClaudeLocalSettingsPath, projectSkillsDir, trustPath, detectBackend, EXEC_PATH_AS_NODE_ENV, isolate, createStreamDecoder, writeArtifact, parseShellCommand, envPath, checkDangerousCommand, checkObfuscation, countCodePoints, keepHeadAndTail, normalizeForMatch, isReadOnlyCommand, CODE_EXEC_ROOTS } 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, COMPLIANCE_CATEGORIES, COMPLIANCE_ACTIONS, SEARCH_PROVIDER_TYPES, LANGS, PERMISSION_LEVELS, SHELL_KINDS, ToolExposure, MAX_OPTIONS, MIN_OPTIONS, MAX_HEADER_CHARS, MAX_QUESTIONS, isValidAgentRoleName, DEFAULT_AGENT_ROLE, isValidCommandName, RESERVED_COMMAND_NAMES, parseModelRef, systemNote, totalUsageTokens, NOOP_TELEMETRY, METRIC, contentToText, GEN_AI, promptTokens, apiKeyEnvVar, PROVIDER_INFOS, isProviderType, API_KEY_ENV_VARS, isPermissionLevel, KEY_ACTIONS, tableOf, perAction, isKeyAction, parseSequence, RESERVED_CHORDS, chordId, sequenceId, ACTION_CONTEXTS, SEQUENCE_CONTEXTS, assertNeverPart, SCHEDULE_INTERVAL_MINUTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_SESSION_REFS, utf8ByteLength, attachSessionSurface, isContextNearlyFull, isOperationType, normalizeApproval, 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';
@@ -3571,7 +3571,7 @@ var ROLE_FRONTMATTER_SCHEMA = z.object({
   description: z.string().min(1),
   tools: z.array(z.string().min(1)).optional(),
   skills: z.array(z.string().min(1)).optional(),
-  maxTurns: z.int().positive().max(200).optional()
+  maxTurns: z.int().nonnegative().optional()
 });
 var FrontmatterSchema = ROLE_FRONTMATTER_SCHEMA;
 var FRONTMATTER_KEYS2 = Object.keys(FrontmatterSchema.shape);
@@ -3646,7 +3646,7 @@ function parseRoleDefinition(raw, file, source) {
       ...prompt ? { prompt } : {},
       ...fm.tools ? { tools: fm.tools } : {},
       ...fm.skills ? { skills: fm.skills } : {},
-      ...fm.maxTurns ? { maxTurns: fm.maxTurns } : {},
+      ...fm.maxTurns !== void 0 ? { maxTurns: fm.maxTurns } : {},
       source
     },
     issues
@@ -3734,7 +3734,6 @@ var BUILTIN_ROLES = [
     description: "\u53EA\u8BFB\u68C0\u7D22\u3002\u627E\u6587\u4EF6\u3001\u627E\u7B26\u53F7\u3001\u56DE\u7B54\u300CX \u5728\u54EA\u5B9E\u73B0\u7684\u300D\u3002\u5B83\u6539\u4E0D\u4E86\u4EFB\u4F55\u4E1C\u897F\uFF0C\u56DE\u4F20\u7684\u662F\u6587\u4EF6\u8DEF\u5F84 + \u884C\u53F7\u800C\u4E0D\u662F\u4EE3\u7801\u539F\u6587\uFF0C\u9002\u5408\u9700\u8981\u7FFB\u5F88\u591A\u6587\u4EF6\u4F46\u7ED3\u8BBA\u5F88\u77ED\u7684\u4EFB\u52A1",
     prompt: EXPLORE_PROMPT,
     tools: [...READ_ONLY_TOOLS],
-    maxTurns: 8,
     source: "builtin"
   },
   {
@@ -3742,7 +3741,6 @@ var BUILTIN_ROLES = [
     description: "\u4EE3\u7801\u5BA1\u67E5\u3002\u53EA\u8BFB\uFF0C\u8F93\u51FA\u300C\u6587\u4EF6:\u884C \xB7 \u4E25\u91CD\u5EA6 \xB7 \u4E00\u53E5\u8BDD\u300D\u7684\u95EE\u9898\u6E05\u5355\u3002\u9002\u5408\u6539\u5B8C\u4E00\u6279\u4EE3\u7801\u4E4B\u540E\u627E\u95EE\u9898\uFF0C\u4E0D\u9002\u5408\u8BA9\u5B83\u987A\u624B\u628A\u95EE\u9898\u4FEE\u6389\uFF08\u5B83\u6CA1\u6709\u5199\u5DE5\u5177\uFF09",
     prompt: REVIEW_PROMPT,
     tools: [...READ_ONLY_TOOLS],
-    maxTurns: 10,
     source: "builtin"
   }
 ];
@@ -3774,7 +3772,7 @@ function mergeRoles(overrides) {
       ...existing,
       ...incoming.description ? { description: incoming.description } : {},
       ...incoming.prompt ? { prompt: incoming.prompt } : {},
-      ...incoming.maxTurns ? { maxTurns: incoming.maxTurns } : {},
+      ...incoming.maxTurns !== void 0 ? { maxTurns: incoming.maxTurns } : {},
       ...tools ? { tools } : {},
       ...skills ? { skills } : {},
       source: incoming.source
@@ -8510,6 +8508,15 @@ function wrapUntrusted(source, text) {
 ${escaped}
 </${OUTPUT_TAG}>`;
 }
+function outputText(output) {
+  if (output === void 0 || output === null) return "";
+  return typeof output === "string" ? output : JSON.stringify(output) ?? "";
+}
+function failureText(r) {
+  const detail = r.error?.message?.trim() || outputText(r.output).trim();
+  if (!detail) return "\u5DE5\u5177\u6267\u884C\u5931\u8D25\uFF08\u5DE5\u5177\u672A\u63D0\u4F9B\u539F\u56E0\uFF09";
+  return r.error?.code === void 0 ? `\u5DE5\u5177\u6267\u884C\u5931\u8D25\uFF1A${detail}` : `\u5DE5\u5177\u6267\u884C\u5931\u8D25 [${r.error.code}]: ${detail}`;
+}
 var ToolExecutor = class {
   constructor(deps) {
     this.deps = deps;
@@ -8603,7 +8610,7 @@ var ToolExecutor = class {
           toolName: et.name,
           toolResult: {
             success: r.success,
-            output: typeof r.output === "string" ? r.output : JSON.stringify(r.output),
+            output: outputText(r.output),
             error: r.error
           }
         },
@@ -8611,7 +8618,7 @@ var ToolExecutor = class {
       ).catch(() => {
       });
       if (r.success) {
-        const text = typeof r.output === "string" ? r.output : JSON.stringify(r.output);
+        const text = outputText(r.output);
         const artifacts = r.artifacts ? admitArtifacts(r.artifacts, this.policy(sessionId)) : [];
         const diffs = before ? await collectDiffs(before, this.deps.workDir()) : [];
         return finish({
@@ -8632,7 +8639,10 @@ var ToolExecutor = class {
       return finish({
         ...base,
         success: false,
-        output: `\u5DE5\u5177\u6267\u884C\u5931\u8D25 [${r.error?.code}]: ${r.error?.message}`
+        output: this.renderOutput(
+          et,
+          truncate(failureText(r), depth > 0 ? MAX_SUB_CALL_OUTPUT : MAX_TOOL_OUTPUT)
+        )
       });
     } catch (err) {
       span.recordError(err);
@@ -8900,12 +8910,12 @@ var AgentLoop = class {
   learnedSkills = [];
   constructor(config) {
     this.config = {
-      maxTurns: 50,
+      maxTurns: DEFAULT_MAX_TURNS,
       workDir: process.cwd(),
       contextLength: DEFAULT_CONTEXT_LENGTH,
       ...config
     };
-    if (this.config.maxTurns < 1) this.config.maxTurns = 1;
+    if (this.config.maxTurns < 0) this.config.maxTurns = UNLIMITED_TURNS;
     if (this.config.site) {
       this.site = this.config.site;
     } else {
@@ -9032,7 +9042,7 @@ var AgentLoop = class {
     yield* this.runTurns(input, turns);
   }
   async *runTurns(input, turns) {
-    const maxTurns = input.maxTurns ?? this.config.maxTurns;
+    const maxTurns = turnLimitOf(input.maxTurns ?? this.config.maxTurns);
     this.stallDetector.resetOnSuccess();
     const rawUserText = contentToText(input.userMessage, { imagesCarriedAsParts: true });
     const images = imageParts(input.userMessage);
@@ -9267,6 +9277,10 @@ var AgentLoop = class {
           return;
         }
         const toolCalls = result.toolCalls ?? [];
+        const truncated = result.finishReason === "length" && toolCalls.length === 0;
+        if (truncated) {
+          yield { type: "notice", code: "response-truncated", text: t("agent_run.truncated") };
+        }
         if (toolCalls.length === 0) {
           turns.push({
             index: turn,
@@ -9311,7 +9325,7 @@ ${finalText}` };
             turns
           });
           this.maybeLearn(userText, finalText);
-          yield finish("stop");
+          yield finish(truncated ? "length" : "stop");
           return;
         }
         messages.push({
@@ -9613,6 +9627,24 @@ var SidebarMenuItemSchema = z.object({
   label: z.string().min(1),
   icon: z.string().min(1).optional()
 });
+var BlankCardSchema = z.object({
+  id: z.string().min(1),
+  title: z.string().min(1),
+  subtitle: z.string().min(1).optional(),
+  prompt: z.string().min(1),
+  icon: z.string().min(1).optional()
+});
+var HostTextSchema = z.partialRecord(z.enum(LANGS), z.string().min(1)).refine((text) => Object.values(text).some((value) => value !== void 0), {
+  message: "at least one language must be given"
+});
+var BlankGreetingSchema = z.object({
+  eyebrow: HostTextSchema.optional(),
+  title: HostTextSchema.optional(),
+  subtitle: HostTextSchema.optional(),
+  hidden: z.boolean().optional()
+}).refine((greeting) => Object.values(greeting).some((value) => value !== void 0), {
+  message: "blankGreeting: must set at least one of eyebrow / title / subtitle / hidden"
+});
 var ArtifactsSchema = z.object({
   maxAgeDays: z.int().positive().max(3650).default(ARTIFACT_RETENTION_DEFAULTS.maxAgeDays),
   maxTotalBytes: z.int().positive().default(ARTIFACT_RETENTION_DEFAULTS.maxTotalBytes)
@@ -9628,7 +9660,7 @@ var EpochConfigSchema = z.object({
   model: z.string().min(1).default("gpt-4o-mini"),
   models: z.object({ utility: z.string().min(1).optional() }).optional(),
   shell: z.enum(SHELL_KINDS).optional(),
-  maxTurns: z.int().positive().default(50),
+  maxTurns: z.int().nonnegative().default(DEFAULT_MAX_TURNS),
   contextLength: z.int().positive().default(2e5),
   homeDir: z.string().min(1).default(() => resolveHomeDir()),
   dbPath: z.string().min(1).default(() => dbPath(resolveHomeDir())),
@@ -9663,7 +9695,11 @@ var EpochConfigSchema = z.object({
   brand: z.string().min(1).optional(),
   sidebarMenu: z.array(SidebarMenuItemSchema).min(1).refine((items) => new Set(items.map((item) => item.id)).size === items.length, {
     message: "sidebarMenu: id must be unique"
-  }).optional()
+  }).optional(),
+  blankCards: z.array(BlankCardSchema).min(1).refine((items) => new Set(items.map((item) => item.id)).size === items.length, {
+    message: "blankCards: id must be unique"
+  }).optional(),
+  blankGreeting: BlankGreetingSchema.optional()
 });
 function defaultConfig() {
   return EpochConfigSchema.parse({});
@@ -10501,7 +10537,7 @@ function applyEnvOverrides(config, issues, track) {
   }
   if (env.EPOCH_MAX_TURNS) {
     const turns = Number(env.EPOCH_MAX_TURNS);
-    if (Number.isInteger(turns) && turns > 0) {
+    if (Number.isInteger(turns) && turns >= 0) {
       config.maxTurns = turns;
       track.env.add("maxTurns");
     } else {
@@ -12040,7 +12076,7 @@ var DESCRIPTIONS = {
   "permissions.ask": "\u6BCF\u6B21\u90FD\u95EE\u4E00\u53E5\uFF0C\u5373\u4F7F\u6743\u9650\u7EA7\u522B\u672C\u6765\u4E0D\u95EE\u3002\u5199\u6CD5\u540C allow\u3002",
   "permissions.deny": "\u4E00\u5F8B\u62D2\u7EDD\uFF0C\u538B\u8FC7 allow / ask \u548C\u5BA1\u6279\u7F13\u5B58\u3002\u5199\u6CD5\u540C allow\uFF1B\u672A\u4FE1\u4EFB\u7684\u4ED3\u5E93\u91CC\u53EA\u6709\u8FD9\u4E00\u5F20\u5217\u8868\u8FD8\u751F\u6548\u3002",
   model: "\u672C\u5C42\u4F7F\u7528\u7684\u6A21\u578B ID\uFF0C\u8986\u76D6\u4F4E\u5C42\u7EA7\u7684\u8BBE\u7F6E\u3002",
-  maxTurns: "\u5355\u6B21\u4F1A\u8BDD\u6700\u591A\u51E0\u8F6E\uFF08\u4E00\u8F6E = \u4E00\u6B21\u6A21\u578B\u8C03\u7528 + \u5B83\u89E6\u53D1\u7684\u5DE5\u5177\u6267\u884C\uFF09\u3002\u6B63\u6574\u6570\u3002",
+  maxTurns: "\u5355\u6B21\u4F1A\u8BDD\u6700\u591A\u51E0\u8F6E\uFF08\u4E00\u8F6E = \u4E00\u6B21\u6A21\u578B\u8C03\u7528 + \u5B83\u89E6\u53D1\u7684\u5DE5\u5177\u6267\u884C\uFF09\u30020 \u6216\u6B63\u6574\u6570\uFF0C**0 = \u4E0D\u8BBE\u4E0A\u9650**\uFF08\u7F3A\u7701\uFF09\u3002",
   allowManagedPermissionRulesOnly: "\u6253\u5F00\u540E\uFF0C\u5176\u4F59\u5404\u5C42\uFF08\u7528\u6237\u7EA7 / \u9879\u76EE\u7EA7 / \u9879\u76EE\u672C\u5730 / --settings\uFF09\u7684 allow / ask / deny **\u6574\u4EFD\u5FFD\u7565**\uFF0C\u53EA\u6709\u8FD9\u4EFD\u6258\u7BA1\u6587\u4EF6\u91CC\u7684\u89C4\u5219\u7B97\u6570\u3002\u8FD9\u662F\u5168\u6D41\u7A0B\u552F\u4E00\u4E00\u5904\u66FF\u6362\u8BED\u4E49\uFF0C\u4E0D\u662F\u5E76\u96C6\u3002\u9ED8\u8BA4 false\u3002",
   allowManagedHooksOnly: "\u6253\u5F00\u540E\uFF0C\u7528\u6237\u7EA7 hook \u4E00\u6761\u90FD\u4E0D\u52A0\u8F7D\uFF08hook \u80FD spawn \u4EFB\u610F\u5B50\u8FDB\u7A0B\uFF09\u3002\u9ED8\u8BA4 false\u3002",
   disableBypassPermissionsMode: "\u6253\u5F00\u540E\uFF0C`permission: bypass` **\u62D2\u7EDD\u542F\u52A8**\uFF08\u9000\u51FA\u7801 4\uFF09\uFF0C\u8FD0\u884C\u671F\u5207\u5230 bypass \u4E5F\u4F1A\u88AB\u6321\u4E0B\u3002\u9ED8\u8BA4 false\u3002"
@@ -15665,7 +15701,6 @@ function suggestRuleFromApproval(request) {
     ].join("\n")
   };
 }
-// src/schedule/types.ts
 var SCHEDULE_ISSUE_CODES = [
   "name-empty",
   "prompt-empty",
@@ -15689,7 +15724,7 @@ var SCHEDULE_ISSUE_CODES = [
   "bypass-not-confirmed"
 ];
 var SCHEDULE_DEFAULTS = {
-  maxTurns: 20,
+  maxTurns: DEFAULT_MAX_TURNS,
   timeoutMs: 15 * 60 * 1e3
 };
 var SCHEDULE_DEFAULT_ALLOWLIST = {
@@ -16277,7 +16312,6 @@ function onceInstant(trigger) {
   if (!date || !clock) return null;
   return new Date(date.year, date.month - 1, date.day, clock.hour, clock.minute, 0, 0).getTime();
 }
-var MAX_TURNS_CEILING = 1e3;
 var MAX_TIMEOUT_MS = 24 * 60 * 60 * 1e3;
 function validateSchedule(input) {
   const issues = [];
@@ -16293,7 +16327,7 @@ function validateSchedule(input) {
   if (!Number.isFinite(input.maxBudgetUsd) || input.maxBudgetUsd <= 0) {
     issues.push({ code: "budget-missing", detail: String(input.maxBudgetUsd) });
   }
-  if (!Number.isInteger(input.maxTurns) || input.maxTurns <= 0 || input.maxTurns > MAX_TURNS_CEILING) {
+  if (!Number.isInteger(input.maxTurns) || input.maxTurns < 0) {
     issues.push({ code: "max-turns-invalid", detail: String(input.maxTurns) });
   }
   if (!Number.isFinite(input.timeoutMs) || input.timeoutMs <= 0 || input.timeoutMs > MAX_TIMEOUT_MS) {
@@ -16320,7 +16354,7 @@ function bypassIssues(input) {
   } else if (isTooBroad(input.workDir, input.homeDir)) {
     issues.push({ code: "bypass-workdir-too-broad", detail: input.workDir });
   }
-  const missingRuler = !(input.maxBudgetUsd > 0) || !(input.maxTurns > 0) || !(input.timeoutMs > 0);
+  const missingRuler = !(input.maxBudgetUsd > 0) || !(input.timeoutMs > 0);
   if (missingRuler) issues.push({ code: "bypass-needs-limits" });
   if (input.bypassAcknowledged !== true) issues.push({ code: "bypass-not-confirmed" });
   return issues;
@@ -17893,6 +17927,25 @@ var HookManager = class {
         });
       }
     }
+    const cmdEntries = this.commandHooks.get(type);
+    if (cmdEntries) {
+      for (const entry of cmdEntries) {
+        if (!matchesHook(entry.matcher, event)) continue;
+        for (const config of entry.configs) {
+          try {
+            const result = await runCommandHook(config, event, ctx.workDir);
+            reportIfNeverRan(this.log, type, config, result);
+            const verdict = verdictOf2(result);
+            if (verdict) results.push(verdict);
+          } catch (err) {
+            this.log("warn", `[HookManager] ${type} \u7684 command hook \u6267\u884C\u5F02\u5E38: ${describe7(err)}`, {
+              hookType: type,
+              command: config.command
+            });
+          }
+        }
+      }
+    }
     return results;
   }
   getSorted(type) {
@@ -17904,6 +17957,17 @@ var HookManager = class {
 function describe7(err) {
   return err instanceof Error ? err.message : String(err);
 }
+function verdictOf2(result) {
+  const action = result.output?.["action"];
+  if (action === "continue" || action === "stop") {
+    const message = typeof result.output?.["message"] === "string" ? result.output["message"] : "";
+    return { action, ...message ? { message } : {} };
+  }
+  if (result.blocked) {
+    return { action: "continue", ...result.rejectReason ? { message: result.rejectReason } : {} };
+  }
+  return void 0;
+}
 function reportIfNeverRan(log5, type, config, result) {
   if (result.exitCode !== -1) return;
   log5(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/core",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "private": false,
   "description": "epoch-agent 核心引擎：ReAct 循环、Provider 路由、工具调度、记忆管理",
   "repository": {
@@ -27,8 +27,8 @@
     "gpt-tokenizer": "^3.4.0",
     "js-yaml": "^5.2.3",
     "zod": "^4.4.3",
-    "@epoch-agent/infra": "0.3.2",
-    "@epoch-agent/protocol": "0.3.2"
+    "@epoch-agent/infra": "0.5.0",
+    "@epoch-agent/protocol": "0.5.0"
   },
   "devDependencies": {
     "@ai-sdk/amazon-bedrock": "^5.0.40",