@epoch-agent/core 2.2.0 → 2.4.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { REASONING_EFFORTS, MODEL_ENTRY_PROTOCOLS, PROVIDER_TYPES, isModelEntryId, parseModelRef, OPERATION_TYPES as OPERATION_TYPES$1, COMPLIANCE_CATEGORIES, COMPLIANCE_ACTIONS, SEARCH_PROVIDER_TYPES, CURRENCIES, LANGS, isSettingsPaneId, SETTINGS_PANE_IDS, BRAND_WHEN_SIDEBAR_COLLAPSED, PERMISSION_LEVELS, SHELL_KINDS, cronTimes, SCHEDULE_MAX_TIMES_PER_DAY, SCHEDULE_INTERVAL_MIN_MINUTES, SCHEDULE_INTERVAL_MAX_MINUTES, ToolExposure, MIN_OPTIONS, MAX_OPTIONS, MAX_HEADER_CHARS, MAX_QUESTIONS, isPermissionLevel, SCHEDULE_DRAFT_TOOL, isValidAgentRoleName, DEFAULT_AGENT_ROLE, isValidCommandName, RESERVED_COMMAND_NAMES, isWirePluginArchiveName, systemNote, formatMoney, totalUsageTokens, NOOP_TELEMETRY, METRIC, contentToText, GEN_AI, isPromptOversize, promptTokens, entrySecretName, isEntrySecretName, entryRef, KEY_ACTIONS, tableOf, perAction, isKeyAction, parseSequence, RESERVED_CHORDS, chordId, sequenceId, ACTION_CONTEXTS, SEQUENCE_CONTEXTS, assertNeverPart, normalizeAppearanceTranslucent, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_SESSION_REFS, utf8ByteLength, truncateToBudget, attachSessionSurface, isContextNearlyFull, isOperationType, normalizeApproval, imagePartOmittedSummary, ENTRY_REF_PREFIX, MAX_ATTACH_BYTES, SIMULTANEOUS_CONTEXTS, SESSION_REFERENCE_ERROR_CODES, filePartSummary, sessionPartSummary } from '@epoch-agent/protocol';
+import { REASONING_EFFORTS, MODEL_ENTRY_PROTOCOLS, PROVIDER_TYPES, isModelEntryId, parseModelRef, OPERATION_TYPES as OPERATION_TYPES$1, COMPLIANCE_CATEGORIES, COMPLIANCE_ACTIONS, SEARCH_PROVIDER_TYPES, CURRENCIES, LANGS, isSettingsPaneId, SETTINGS_PANE_IDS, BRAND_WHEN_SIDEBAR_COLLAPSED, PERMISSION_LEVELS, SHELL_KINDS, cronTimes, SCHEDULE_MAX_TIMES_PER_DAY, SCHEDULE_INTERVAL_MIN_MINUTES, SCHEDULE_INTERVAL_MAX_MINUTES, ToolExposure, MIN_OPTIONS, MAX_OPTIONS, MAX_HEADER_CHARS, MAX_QUESTIONS, isPermissionLevel, SCHEDULE_DRAFT_TOOL, isValidAgentRoleName, DEFAULT_AGENT_ROLE, isValidCommandName, RESERVED_COMMAND_NAMES, isWirePluginArchiveName, systemNote, formatMoney, totalUsageTokens, NOOP_TELEMETRY, METRIC, contentToText, GEN_AI, isPromptOversize, promptTokens, entrySecretName, isEntrySecretName, entryRef, KEY_ACTIONS, tableOf, perAction, isKeyAction, parseSequence, RESERVED_CHORDS, chordId, sequenceId, ACTION_CONTEXTS, SEQUENCE_CONTEXTS, assertNeverPart, normalizeAppearanceTranslucent, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_SESSION_REFS, utf8ByteLength, truncateToBudget, attachSessionSurface, isContextNearlyFull, isOperationType, normalizeApproval, SCHEDULE_DRAFT_SAVED_MARK, imagePartOmittedSummary, ENTRY_REF_PREFIX, 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 { existsSync, statSync, readdirSync, readFileSync, mkdirSync, writeFileSync, rmSync, renameSync, realpathSync, symlinkSync, cpSync, lstatSync, unlinkSync, rmdirSync, mkdtempSync, copyFileSync, openSync, writeSync, closeSync, readSync } from 'fs';
 import { homedir, platform, tmpdir, hostname } from 'os';
@@ -2707,13 +2707,48 @@ function createExitTool(deps) {
 function createPlanModeTools(deps) {
   return [createEnterTool(deps), createExitTool(deps)];
 }
+var SCHEDULE_ISSUE_CODES = [
+  "name-empty",
+  "prompt-empty",
+  "permission-unknown",
+  "work-dir-missing",
+  "budget-missing",
+  "max-turns-invalid",
+  "timeout-invalid",
+  "trigger-time-invalid",
+  "trigger-times-too-many",
+  "trigger-weekdays-empty",
+  "trigger-days-invalid",
+  "trigger-interval-invalid",
+  "trigger-once-date-invalid",
+  "trigger-once-past",
+  "date-range-invalid",
+  "date-range-on-once",
+  "rule-invalid",
+  "bypass-needs-workdir",
+  "bypass-workdir-too-broad",
+  "bypass-needs-limits",
+  "bypass-not-confirmed"
+];
+var SCHEDULE_DEFAULTS = {
+  maxTurns: DEFAULT_MAX_TURNS,
+  timeoutMs: 60 * 60 * 1e3
+};
+var SCHEDULE_FORM_BUDGET_USD = 200;
+var SCHEDULE_DEFAULT_ALLOWLIST = {
+  allowTools: [],
+  allowOperations: ["file_read"],
+  allowRules: []
+};
+// src/schedule/draft.ts
 var bad = (message) => ({ ok: false, message });
 var good = (value) => ({ ok: true, value });
 var PERMISSION_ORDER = [
   "plan",
   "default",
   "acceptEdits",
-  "auto"
+  "auto",
+  "bypass"
 ];
 var OPERATION_TYPES = [
   "file_read",
@@ -2755,16 +2790,18 @@ function operationList(v) {
 function permission(v) {
   const s = str(v);
   if (s === void 0) return bad("permission \u662F\u7A7A\u7684");
-  if (s === "bypass") {
-    return bad(
-      "\u8349\u7A3F\u4E0D\u8BB8\u7528 bypass\uFF08\u8DF3\u8FC7\u5168\u90E8\u68C0\u67E5\uFF09\u3002\u65E0\u4EBA\u503C\u5B88\u4E0B\u90A3\u4E00\u6863\u8981\u4EBA\u4EB2\u624B\u52FE\u4E00\u6B21\u786E\u8BA4\uFF0C\u8BA9\u8349\u7A3F\u63D0\u8BAE\u5B83\u7B49\u4E8E\u628A\u90A3\u6B21\u786E\u8BA4\u53D8\u6210\u4F8B\u884C\u624B\u7EED\u3002\u8981\u653E\u5F00\u67D0\u51E0\u4EF6\u4E8B\uFF0C\u7528 permission: default \u52A0\u4E00\u4EFD\u7CBE\u786E\u7684 allowRules"
-    );
-  }
   if (!PERMISSION_ORDER.includes(s)) {
     return bad(`permission \u53EA\u80FD\u662F ${PERMISSION_ORDER.join(" / ")} \u4E4B\u4E00\uFF0C\u6536\u5230\u7684\u662F ${s}`);
   }
   return good(s);
 }
+function budget(v) {
+  if (v === void 0) return good(void 0);
+  if (typeof v !== "number" || !Number.isFinite(v) || v <= 0) {
+    return bad("maxBudgetUsd \u8981\u662F\u5927\u4E8E 0 \u7684\u6570\uFF08\u5355\u4F4D\u7F8E\u5143\uFF09\u3002\u4E0D\u7ED9\u5C31\u6309\u65B0\u5EFA\u8868\u5355\u90A3\u4E2A\u7F3A\u7701\uFF08200\uFF09");
+  }
+  return good(v);
+}
 function clock(v) {
   const s = str(v);
   if (s === void 0 || !/^\d{1,2}:\d{2}$/.test(s))
@@ -2881,6 +2918,8 @@ function parseCreate(raw, note) {
   const allow = parseAllowlist(raw);
   if (!allow.ok) return allow;
   const workDir = str(raw["workDir"]);
+  const usd = budget(raw["maxBudgetUsd"]);
+  if (!usd.ok) return usd;
   return good({
     action: "create",
     name,
@@ -2889,6 +2928,7 @@ function parseCreate(raw, note) {
     permission: level.value,
     note,
     ...workDir === void 0 ? {} : { workDir },
+    ...usd.value === void 0 ? {} : { maxBudgetUsd: usd.value },
     ...allow.value
   });
 }
@@ -2923,6 +2963,9 @@ function parseUpdate(raw, note) {
   const timeout = posInt(raw["timeoutMs"], "timeoutMs");
   if (!timeout.ok) return timeout;
   if (timeout.value !== void 0) patch.timeoutMs = timeout.value;
+  const usd = budget(raw["maxBudgetUsd"]);
+  if (!usd.ok) return usd;
+  if (usd.value !== void 0) patch.maxBudgetUsd = usd.value;
   if (Object.keys(patch).length === 0) {
     return bad(
       "update \u4E00\u683C\u90FD\u6CA1\u6539\u3002\u4E00\u4EFD\u4EC0\u4E48\u90FD\u4E0D\u6539\u7684\u63D0\u6848\u4F1A\u767D\u5360\u7528\u6237\u4E00\u6B21\u70B9\u51FB \u2014\u2014 \u8981\u4E48\u7ED9\u51FA\u5177\u4F53\u6539\u54EA\u51E0\u683C\uFF0C\u8981\u4E48\u522B\u63D0"
@@ -2948,7 +2991,7 @@ function parseScheduleDraft(raw) {
 }
 function draftWidening(draft, current) {
   const out = [];
-  const base2 = draft.action === "update" && current ? current.permission === "bypass" ? "auto" : current.permission : "default";
+  const base2 = draft.action === "update" && current ? current.permission : "default";
   const level = draft.permission;
   if (level !== void 0 && PERMISSION_ORDER.indexOf(level) > PERMISSION_ORDER.indexOf(base2)) {
     out.push("permission");
@@ -3002,42 +3045,9 @@ function draftCommandLine(draft) {
   for (const tool of draft.allowTools ?? []) argv.push("--allow-tool", shellArg(tool));
   for (const op2 of draft.allowOperations ?? []) argv.push("--allow-operation", op2);
   for (const rule of draft.allowRules ?? []) argv.push("--allow-rule", shellArg(rule));
-  argv.push("--budget", shellArg("<\u4F60\u5B9A\u4E00\u4E2A\u4E0A\u9650\uFF0C\u5355\u4F4D\u7F8E\u5143>"));
+  argv.push("--budget", String(draft.maxBudgetUsd ?? SCHEDULE_FORM_BUDGET_USD));
   return argv.join(" ");
 }
-var SCHEDULE_ISSUE_CODES = [
-  "name-empty",
-  "prompt-empty",
-  "permission-unknown",
-  "work-dir-missing",
-  "budget-missing",
-  "max-turns-invalid",
-  "timeout-invalid",
-  "trigger-time-invalid",
-  "trigger-times-too-many",
-  "trigger-weekdays-empty",
-  "trigger-days-invalid",
-  "trigger-interval-invalid",
-  "trigger-once-date-invalid",
-  "trigger-once-past",
-  "date-range-invalid",
-  "date-range-on-once",
-  "rule-invalid",
-  "bypass-needs-workdir",
-  "bypass-workdir-too-broad",
-  "bypass-needs-limits",
-  "bypass-not-confirmed"
-];
-var SCHEDULE_DEFAULTS = {
-  maxTurns: DEFAULT_MAX_TURNS,
-  timeoutMs: 60 * 60 * 1e3
-};
-var SCHEDULE_FORM_BUDGET_USD = 200;
-var SCHEDULE_DEFAULT_ALLOWLIST = {
-  allowTools: [],
-  allowOperations: ["file_read"],
-  allowRules: []
-};
 // src/schedule/unattended-lint.ts
 var ANCHORS = [
   { kind: "asks-human", zh: /问(?:一下|下)?我/, en: /\bask\s+(?:me|us)\b/i },
@@ -3473,7 +3483,7 @@ function validateSchedule(input) {
   if (input.workDir && !isExistingDir(input.workDir)) {
     issues.push({ code: "work-dir-missing", detail: input.workDir });
   }
-  if (!input.budgetPending && (!Number.isFinite(input.maxBudgetUsd) || input.maxBudgetUsd <= 0)) {
+  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) {
@@ -3535,29 +3545,34 @@ var WIDENING_TEXT = {
   allowlist: "\u6E05\u5355\u591A\u4E86\u6761\u76EE\uFF08= \u591A\u4E86\u51E0\u4EF6\u4E0D\u7ECF\u786E\u8BA4\u5C31\u4F1A\u505A\u7684\u4E8B\uFF09",
   enabled: "\u628A\u4E00\u6761\u505C\u7528\u7684\u4EFB\u52A1\u6539\u6210\u542F\u7528"
 };
+function budgetOf(draft, current) {
+  return draft.maxBudgetUsd ?? current?.maxBudgetUsd ?? SCHEDULE_FORM_BUDGET_USD;
+}
 function validateDraft(draft, homeDir, current) {
+  const permission2 = draft.permission ?? current?.permission ?? "default";
   const merged = draft.action === "create" ? {
     name: draft.name,
     prompt: draft.prompt,
-    permission: draft.permission,
+    permission: permission2,
     workDir: draft.workDir ?? "",
     maxTurns: SCHEDULE_DEFAULTS.maxTurns,
-    maxBudgetUsd: 0,
+    maxBudgetUsd: budgetOf(draft),
     timeoutMs: SCHEDULE_DEFAULTS.timeoutMs,
     trigger: draft.trigger,
     allowRules: draft.allowRules ?? [],
-    budgetPending: true,
+    bypassAcknowledged: permission2 === "bypass",
     homeDir
   } : {
     name: draft.name ?? current?.name ?? "",
     prompt: draft.prompt ?? current?.prompt ?? "",
-    permission: draft.permission ?? current?.permission ?? "default",
+    permission: permission2,
     workDir: draft.workDir ?? current?.workDir ?? "",
     maxTurns: draft.maxTurns ?? current?.maxTurns ?? SCHEDULE_DEFAULTS.maxTurns,
-    maxBudgetUsd: current?.maxBudgetUsd ?? 0,
+    maxBudgetUsd: budgetOf(draft, current),
     timeoutMs: draft.timeoutMs ?? current?.timeoutMs ?? SCHEDULE_DEFAULTS.timeoutMs,
     trigger: draft.trigger ?? current?.trigger ?? { kind: "cron", cycle: "daily", at: "09:00" },
     allowRules: draft.allowRules ?? current?.allowRules ?? [],
+    bypassAcknowledged: permission2 === "bypass",
     homeDir
   };
   return validateSchedule(merged).issues.map(
@@ -3590,13 +3605,27 @@ function structuralNotes(draft, current) {
   }
   return out;
 }
-function summarize(draft, current) {
+function registrationLine(outcome) {
+  if (outcome === void 0) return void 0;
+  if (outcome.ok) {
+    return "\u5DF2\u7ECF\u6CE8\u518C\u8FDB\u64CD\u4F5C\u7CFB\u7EDF\uFF0C\u5230\u70B9\u4F1A\u81EA\u5DF1\u8DD1\uFF08\u5173\u6389\u8FD9\u4E2A\u5E94\u7528\u4E5F\u8DD1\uFF09\u3002";
+  }
+  switch (outcome.reason) {
+    case "unsupported-platform":
+      return "\u26A0\uFE0F \u8FD9\u53F0\u673A\u5668\uFF08Linux\uFF09\u6682\u4E0D\u652F\u6301\u81EA\u52A8\u89E6\u53D1 \u2014\u2014 \u4EFB\u52A1\u5B58\u4E0B\u6765\u4E86\uFF0C\u4F46\u5230\u70B9\u4E0D\u4F1A\u81EA\u5DF1\u8DD1\u3002";
+    case "refused":
+      return outcome.refusal === "npx" ? "\u26A0\uFE0F \u6CA1\u6CE8\u518C\u8FDB\u64CD\u4F5C\u7CFB\u7EDF\uFF1A\u8FD9\u4E00\u4EFD\u662F npx \u4E34\u65F6\u8DD1\u8D77\u6765\u7684\uFF0C\u7F13\u5B58\u76EE\u5F55\u4E00\u6E05\u90A3\u6761\u4EFB\u52A1\u5C31\u5E9F\u3002\u88C5\u6210\u5168\u5C40\uFF08`npm i -g`\uFF09\u4E4B\u540E\u91CD\u5EFA\u4E00\u6B21\u624D\u6CE8\u518C\u5F97\u4E0A\u3002\u4EFB\u52A1\u672C\u8EAB\u5B58\u4E0B\u6765\u4E86\u3002" : "\u26A0\uFE0F \u6CA1\u6CE8\u518C\u8FDB\u64CD\u4F5C\u7CFB\u7EDF\uFF1A\u8FD9\u4E2A\u5BBF\u4E3B\u6CA1\u7ED9\u300C\u5230\u70B9\u4E86\u600E\u4E48\u8D77\u4E00\u6B21\u300D\u7684\u5165\u53E3\u3002\u4EFB\u52A1\u5B58\u4E0B\u6765\u4E86\uFF0C\u4F46\u5E94\u7528\u5173\u7740\u7684\u65F6\u5019\u5B83\u4E0D\u4F1A\u8DD1\u3002";
+    case "backend-error":
+      return `\u26A0\uFE0F \u6CE8\u518C\u8FDB\u64CD\u4F5C\u7CFB\u7EDF\u5931\u8D25\u4E86\uFF1A${outcome.detail}\u3002\u4EFB\u52A1\u5B58\u4E0B\u6765\u4E86\uFF0C\u4F46\u5230\u70B9\u4E0D\u4F1A\u81EA\u5DF1\u8DD1\u3002`;
+  }
+}
+function summarizeProposal(draft, current, readOnly) {
   const lines = [];
   lines.push(
     draft.action === "create" ? `\u8349\u7A3F\u5DF2\u7ECF\u6446\u5230\u7528\u6237\u773C\u524D\u4E86\uFF08\u4E00\u5F20\u5361\u7247\uFF0C\u6807\u9898\u300C${draft.name}\u300D\uFF09\u3002` : `\u6539\u52A8\u63D0\u6848\u5DF2\u7ECF\u6446\u5230\u7528\u6237\u773C\u524D\u4E86\uFF08\u9488\u5BF9\u300C${current?.name ?? draft.id}\u300D\uFF09\u3002`
   );
   lines.push(
-    "\u5B83**\u8FD8\u6CA1\u6709\u751F\u6548\uFF0C\u4E5F\u6CA1\u6709\u843D\u5E93** \u2014\u2014 \u8981\u7528\u6237\u5728\u5361\u7247\u4E0A\u70B9\u300C\u5BA1\u9605\u5E76\u4FDD\u5B58\u300D\u3001\u5728\u8868\u5355\u91CC\u81EA\u5DF1\u586B\u4E00\u4E2A\u9884\u7B97\u4E0A\u9650\uFF0C\u90A3\u4E00\u4E0B\u624D\u662F\u771F\u7684\u5EFA\u7ACB\u3002"
+    readOnly ? "\u5B83**\u8FD8\u6CA1\u6709\u751F\u6548\uFF0C\u4E5F\u6CA1\u6709\u843D\u5E93** \u2014\u2014 \u4F60\u5728\u53EA\u8BFB\u8C03\u7814\u6A21\u5F0F\uFF08plan\uFF09\u4E0B\uFF0C\u8FD9\u4E00\u6863\u4E0D\u5199\u76D8\u3002\u8981\u7528\u6237\u81EA\u5DF1\u5BA1\u4E00\u904D\u3001\u70B9\u300C\u5BA1\u9605\u5E76\u4FDD\u5B58\u300D\u624D\u662F\u771F\u7684\u5EFA\u7ACB\u3002" : "\u5B83**\u8FD8\u6CA1\u6709\u843D\u5E93** \u2014\u2014 \u8FD9\u4E2A\u5BBF\u4E3B\u6CA1\u6709\u63A5\u5199\u5165\u8DEF\uFF0C\u8981\u7528\u6237\u81EA\u5DF1\u5BA1\u4E00\u904D\u3001\u70B9\u300C\u5BA1\u9605\u5E76\u4FDD\u5B58\u300D\u624D\u662F\u771F\u7684\u5EFA\u7ACB\u3002"
   );
   const widening = draftWidening(draft, current);
   if (widening.length > 0) {
@@ -3607,16 +3636,77 @@ function summarize(draft, current) {
   for (const note of structuralNotes(draft, current)) lines.push(`\u26A0\uFE0F ${note}`);
   const cli = draftCommandLine(draft);
   lines.push(
-    cli === void 0 ? "\uFF08\u6CA1\u6709\u754C\u9762\u7684\u5BBF\u4E3B\u4E0A\uFF1A\u6539\u4E00\u6761\u5DF2\u6709\u4EFB\u52A1\u4ECA\u5929\u53EA\u6709\u754C\u9762\u90A3\u6761\u8DEF \u2014\u2014 `epoch schedule` \u5E95\u4E0B\u6CA1\u6709\u6539\u5B57\u6BB5\u7684\u5B50\u547D\u4EE4\uFF0C\u53EA\u6709 enable / disable / rm\u3002\u522B\u7F16\u4E00\u6761 update \u51FA\u6765\u3002\uFF09" : `\u6CA1\u6709\u754C\u9762\u7684\u5BBF\u4E3B\u4E0A\uFF0C\u7B49\u4EF7\u7684\u547D\u4EE4\u884C\u662F\uFF08\u9884\u7B97\u90A3\u4E00\u683C\u8981\u7528\u6237\u81EA\u5DF1\u586B\uFF09\uFF1A
+    cli === void 0 ? "\uFF08\u6CA1\u6709\u754C\u9762\u7684\u5BBF\u4E3B\u4E0A\uFF1A\u6539\u4E00\u6761\u5DF2\u6709\u4EFB\u52A1\u4ECA\u5929\u53EA\u6709\u754C\u9762\u90A3\u6761\u8DEF \u2014\u2014 `epoch schedule` \u5E95\u4E0B\u6CA1\u6709\u6539\u5B57\u6BB5\u7684\u5B50\u547D\u4EE4\uFF0C\u53EA\u6709 enable / disable / rm\u3002\u522B\u7F16\u4E00\u6761 update \u51FA\u6765\u3002\uFF09" : `\u6CA1\u6709\u754C\u9762\u7684\u5BBF\u4E3B\u4E0A\uFF0C\u7B49\u4EF7\u7684\u547D\u4EE4\u884C\u662F\uFF1A
 ${cli}`
   );
-  lines.push("\u522B\u91CD\u590D\u63D0\u4EA4\u540C\u4E00\u4EFD\u8349\u7A3F\u7B49\u5B83\u300C\u751F\u6548\u300D\u2014\u2014 \u7528\u6237\u4EC0\u4E48\u65F6\u5019\u5BA1\u662F\u4ED6\u7684\u4E8B\uFF0C\u4F60\u8FD9\u4E00\u8F6E\u5230\u6B64\u4E3A\u6B62\u3002");
   return lines.join("\n");
 }
+function summarizeSaved(draft, def, registration, current) {
+  const lines = [];
+  lines.push(
+    `${SCHEDULE_DRAFT_SAVED_MARK}${def.id}`,
+    draft.action === "create" ? `\u5DF2\u7ECF\u5EFA\u7ACB\u5E76\u751F\u6548\uFF1A\u300C${def.name}\u300D\u3002` : `\u5DF2\u7ECF\u6539\u597D\u4E86\uFF1A\u300C${current?.name ?? def.name}\u300D\u3002`
+  );
+  const when = draft.action === "create" ? draft.trigger : draft.trigger ?? current?.trigger;
+  if (when !== void 0) lines.push(`\u5230\u70B9\uFF1A${JSON.stringify(when)}`);
+  const permission2 = draft.permission ?? current?.permission;
+  if (permission2 !== void 0) lines.push(`\u6743\u9650\u6863\uFF1A${permission2}`);
+  const registered = registrationLine(registration);
+  if (registered !== void 0) lines.push(registered);
+  const widening = draftWidening(draft, current);
+  if (widening.length > 0) {
+    lines.push(
+      `\u26A0\uFE0F \u8FD9\u6B21\u6539\u52A8\u653E\u5BBD\u4E86\u6388\u6743\u9762\uFF1A${widening.map((k) => WIDENING_TEXT[k]).join("\uFF1B")}\u3002\u5728\u4F60\u7684\u56DE\u590D\u91CC**\u4E3B\u52A8**\u628A\u8FD9\u4E00\u70B9\u8BF4\u7ED9\u7528\u6237\u542C \u2014\u2014 \u5B83\u5DF2\u7ECF\u751F\u6548\u4E86\uFF0C\u90A3\u4E2A\u4EBA\u53EA\u6709\u9760\u4F60\u8FD9\u53E5\u8BDD\u624D\u77E5\u9053\u521A\u624D\u591A\u653E\u884C\u4E86\u4EC0\u4E48\u3002`
+    );
+  }
+  for (const note of structuralNotes(draft, current)) lines.push(`\u26A0\uFE0F ${note}`);
+  lines.push(
+    "\u5728\u4F60\u7684\u56DE\u590D\u91CC\u7528\u4E00\u53E5\u8BDD\u4EA4\u4EE3\u300C\u5EFA\u4E86\u4EC0\u4E48\u3001\u4EC0\u4E48\u65F6\u5019\u8DD1\u300D\u5C31\u591F\u4E86\u3002**\u522B\u518D\u8BF4\u300C\u8981\u4E0D\u8981\u6211\u5EFA\u4E00\u6761\u300D** \u2014\u2014 \u5B83\u5DF2\u7ECF\u5728\u4E86\uFF1B\u7528\u6237\u60F3\u64A4\u6389\uFF0C\u5361\u7247\u4E0A\u6709\u64A4\u9500\u952E\uFF0C\u4E5F\u53EF\u4EE5\u53BB\u81EA\u52A8\u5316\u9762\u677F\u5220\u3002"
+  );
+  return lines.join("\n");
+}
+async function persist(save, draft, current) {
+  const permission2 = draft.permission ?? current?.permission ?? "default";
+  const acknowledged = { bypassAcknowledged: permission2 === "bypass" };
+  if (draft.action === "create") {
+    return save.create(
+      {
+        name: draft.name,
+        prompt: draft.prompt,
+        permission: draft.permission,
+        maxBudgetUsd: budgetOf(draft),
+        trigger: draft.trigger,
+        ...draft.workDir === void 0 ? {} : { workDir: draft.workDir },
+        ...draft.allowTools === void 0 ? {} : { allowTools: draft.allowTools },
+        ...draft.allowOperations === void 0 ? {} : { allowOperations: draft.allowOperations },
+        ...draft.allowRules === void 0 ? {} : { allowRules: draft.allowRules }
+      },
+      acknowledged
+    );
+  }
+  return save.update(
+    draft.id,
+    {
+      ...draft.name === void 0 ? {} : { name: draft.name },
+      ...draft.prompt === void 0 ? {} : { prompt: draft.prompt },
+      ...draft.permission === void 0 ? {} : { permission: draft.permission },
+      ...draft.trigger === void 0 ? {} : { trigger: draft.trigger },
+      ...draft.workDir === void 0 ? {} : { workDir: draft.workDir },
+      ...draft.enabled === void 0 ? {} : { enabled: draft.enabled },
+      ...draft.maxTurns === void 0 ? {} : { maxTurns: draft.maxTurns },
+      ...draft.timeoutMs === void 0 ? {} : { timeoutMs: draft.timeoutMs },
+      ...draft.maxBudgetUsd === void 0 ? {} : { maxBudgetUsd: draft.maxBudgetUsd },
+      ...draft.allowTools === void 0 ? {} : { allowTools: draft.allowTools },
+      ...draft.allowOperations === void 0 ? {} : { allowOperations: draft.allowOperations },
+      ...draft.allowRules === void 0 ? {} : { allowRules: draft.allowRules }
+    },
+    acknowledged
+  );
+}
 function createScheduleDraftTool(deps) {
   return {
     name: SCHEDULE_DRAFT_TOOL,
-    description: "\u8D77\u8349\u4E00\u6761\u5B9A\u65F6\u4EFB\u52A1\uFF0C\u4EA4\u7ED9\u7528\u6237\u5BA1\u3002\u5B9A\u65F6\u4EFB\u52A1\u662F\u300C\u5230\u70B9\u4E86\u81EA\u5DF1\u8DD1\u4E00\u6B21\u300D\u2014\u2014\u7528\u6237\u8BF4\u300C\u4EE5\u540E\u6BCF\u5929/\u6BCF\u5468\u5E2E\u6211\u505A\u67D0\u4EF6\u4E8B\u300D\u300C\u5B9A\u671F\u68C0\u67E5\u67D0\u67D0\u300D\uFF0C\u6216\u8005\u4F60\u53D1\u73B0\u67D0\u4EF6\u4E8B\u4ED6\u6BCF\u6B21\u90FD\u8981\u624B\u52A8\u505A\u4E00\u904D\u65F6\uFF0C\u7528\u5B83\u3002action=list \u770B\u73B0\u6709\u4EFB\u52A1\uFF08\u8981\u6539\u67D0\u6761\u5FC5\u987B\u5148 list \u62FF\u5230 id\uFF09\uFF1Baction=create \u8D77\u8349\u65B0\u7684\uFF1Baction=update \u63D0\u8BAE\u6539\u4E00\u6761\u5DF2\u6709\u7684\u3002\u26A0\uFE0F \u4F60\u4EA4\u7684\u662F\u8349\u7A3F\uFF0C\u4E0D\u662F\u4EFB\u52A1\uFF1A\u5B83\u4E0D\u4F1A\u751F\u6548\uFF0C\u8981\u7528\u6237\u81EA\u5DF1\u5BA1\u4E00\u904D\u3001\u586B\u4E00\u4E2A\u9884\u7B97\u4E0A\u9650\u624D\u5EFA\u7ACB\u3002\u4EA4\u5B8C\u8FD9\u4E00\u8F6E\u5C31\u7ED3\u675F\uFF0C\u522B\u53CD\u590D\u63D0\u4EA4\u7B49\u5B83\u751F\u6548\u3002\u6743\u9650\u6863\u53EA\u6709 plan/default/acceptEdits/auto \u2014\u2014 bypass \u4E0D\u8BB8\u63D0\u8BAE\u3002\u8981\u653E\u5F00\u67D0\u51E0\u4EF6\u4E8B\u5C31\u7528 default \u52A0\u7CBE\u786E\u7684 allowRules\uFF08\u6BD4\u5982 terminal(git status)\uFF09\uFF0C\u522B\u6574\u4F53\u8C03\u677E\u3002",
+    description: "\u5EFA\u4E00\u6761\u5B9A\u65F6\u4EFB\u52A1\uFF0C\u6216\u8005\u6539\u4E00\u6761\u5DF2\u6709\u7684\u3002\u5B9A\u65F6\u4EFB\u52A1\u662F\u300C\u5230\u70B9\u4E86\u81EA\u5DF1\u8DD1\u4E00\u6B21\u300D\u2014\u2014\u7528\u6237\u8BF4\u300C\u4EE5\u540E\u6BCF\u5929/\u6BCF\u5468\u5E2E\u6211\u505A\u67D0\u4EF6\u4E8B\u300D\u300C\u5B9A\u671F\u68C0\u67E5\u67D0\u67D0\u300D\uFF0C\u6216\u8005\u4F60\u53D1\u73B0\u67D0\u4EF6\u4E8B\u4ED6\u6BCF\u6B21\u90FD\u8981\u624B\u52A8\u505A\u4E00\u904D\u65F6\uFF0C\u7528\u5B83\u3002action=list \u770B\u73B0\u6709\u4EFB\u52A1\uFF08\u8981\u6539\u67D0\u6761\u5FC5\u987B\u5148 list \u62FF\u5230 id\uFF09\uFF1Baction=create \u76F4\u63A5\u5EFA\u4E00\u6761\uFF1Baction=update \u76F4\u63A5\u6539\u4E00\u6761\u3002\u26A0\uFE0F **\u5B83\u4EA4\u4E0A\u53BB\u5C31\u751F\u6548**\uFF08plan \u53EA\u8BFB\u6863\u4E0B\u9664\u5916\uFF0C\u90A3\u4E00\u6863\u53EA\u4EA4\u63D0\u6848\uFF09\u2014\u2014 \u5EFA\u5B8C\u5728\u4F60\u7684\u56DE\u590D\u91CC\u4EA4\u4EE3\u4E00\u53E5\u5C31\u884C\uFF0C\u522B\u95EE\u300C\u8981\u4E0D\u8981\u6211\u5EFA\u300D\u3002\u9884\u7B97\u4E0D\u7ED9\u5C31\u662F 200 \u7F8E\u5143\uFF1B\u8FD9\u6D3B\u660E\u663E\u66F4\u8F7B\u6216\u66F4\u91CD\u65F6\u81EA\u5DF1\u7ED9 maxBudgetUsd\u3002\u6743\u9650\u6863 plan/default/acceptEdits/auto/bypass \u90FD\u80FD\u63D0 \u2014\u2014 \u4F46**\u9ED8\u8BA4\u7528 plan**\uFF1A\u53EA\u8BFB\u6863\u5929\u7136\u96F6\u6388\u6743\u9762\uFF0C\u9700\u8981\u5199\u4E1C\u897F\u518D\u7528 default \u52A0\u4E00\u4EFD\u7CBE\u786E\u7684 allowRules\uFF08\u6BD4\u5982 terminal(git status)\uFF09\uFF0C\u522B\u4E00\u4E0A\u6765\u5C31 bypass\u3002",
     parameters: {
       type: "object",
       properties: {
@@ -3627,7 +3717,7 @@ function createScheduleDraftTool(deps) {
         },
         note: {
           type: "string",
-          description: "\u4E3A\u4EC0\u4E48\u5EFA\u8BAE\u8FD9\u6761\uFF0C\u4E00\u53E5\u8BDD\u3002create / update \u5FC5\u586B\uFF0C\u4F1A\u5370\u5728\u7528\u6237\u770B\u5230\u7684\u5361\u7247\u4E0A\uFF1B\u8BF4\u4E0D\u51FA\u771F\u5B9E\u7406\u7531\u5C31\u522B\u63D0\u8FD9\u4E2A\u5EFA\u8BAE"
+          description: "\u4E3A\u4EC0\u4E48\u5EFA\u8FD9\u6761\uFF0C\u4E00\u53E5\u8BDD\u3002create / update \u5FC5\u586B\uFF0C\u4F1A\u5370\u5728\u7528\u6237\u770B\u5230\u7684\u5361\u7247\u4E0A\uFF1B\u8BF4\u4E0D\u51FA\u771F\u5B9E\u7406\u7531\u5C31\u522B\u63D0\u8FD9\u4E2A\u5EFA\u8BAE"
         },
         id: { type: "string", description: "\u6539\u54EA\u4E00\u6761\u3002update \u5FC5\u586B\uFF0C\u4ECE action=list \u91CC\u62FF" },
         name: { type: "string", description: "\u4EFB\u52A1\u540D\uFF0C\u7528\u6237\u5728\u5217\u8868\u91CC\u770B\u5230\u7684\u5C31\u662F\u5B83" },
@@ -3660,8 +3750,12 @@ function createScheduleDraftTool(deps) {
         },
         permission: {
           type: "string",
-          description: "\u6743\u9650\u6863\u3002plan=\u53EA\u8BFB\uFF08\u8BFB\u4E00\u904D\u5199\u4EFD\u62A5\u544A\u7684\u4EFB\u52A1\u5C31\u8BE5\u7528\u5B83\uFF0C\u5929\u7136\u96F6\u6388\u6743\u9762\uFF09\uFF1Bdefault=\u6309\u9700\u786E\u8BA4\uFF1BacceptEdits=\u81EA\u52A8\u63A5\u53D7\u6539\u52A8\uFF1Bauto=\u4E0D\u518D\u786E\u8BA4",
-          enum: ["plan", "default", "acceptEdits", "auto"]
+          description: "\u6743\u9650\u6863\u3002plan=\u53EA\u8BFB\uFF08\u8BFB\u4E00\u904D\u5199\u4EFD\u62A5\u544A\u7684\u4EFB\u52A1\u5C31\u8BE5\u7528\u5B83\uFF0C\u5929\u7136\u96F6\u6388\u6743\u9762\uFF09\uFF1Bdefault=\u6309\u9700\u786E\u8BA4\uFF1BacceptEdits=\u81EA\u52A8\u63A5\u53D7\u6539\u52A8\uFF1Bauto=\u4E0D\u518D\u786E\u8BA4\uFF1Bbypass=\u8DF3\u8FC7\u5168\u90E8\u68C0\u67E5\uFF08**\u6700\u540E\u624B\u6BB5**\uFF1A\u5230\u70B9\u4E86\u5B83\u60F3\u8DD1\u4EC0\u4E48\u5C31\u8DD1\u4EC0\u4E48\uFF09",
+          enum: ["plan", "default", "acceptEdits", "auto", "bypass"]
+        },
+        maxBudgetUsd: {
+          type: "number",
+          description: "\u6BCF\u6B21\u6700\u591A\u82B1\u591A\u5C11\u94B1\uFF08\u7F8E\u5143\uFF0C\u8981\u5927\u4E8E 0\uFF09\u3002\u4E0D\u7ED9\u5C31\u662F 200\u3002\u8FD9\u6D3B\u660E\u663E\u66F4\u8F7B\uFF08\u8BFB\u4E00\u4E2A\u6587\u4EF6\u3001\u53D1\u4E00\u6761\u6D88\u606F\uFF09\u5C31\u7ED9\u5C0F\u4E00\u70B9\uFF0C\u660E\u663E\u66F4\u91CD\uFF08\u626B\u5927\u4ED3\u3001\u591A\u8F6E\u8C03\u7814\uFF09\u5C31\u653E\u5927 \u2014\u2014 \u82B1\u8D85\u4E86\u90A3\u4E00\u8F6E\u4F1A\u505C\u4F4F"
         },
         allowTools: {
           type: "array",
@@ -3687,58 +3781,71 @@ function createScheduleDraftTool(deps) {
     exposure: ToolExposure.Direct,
     supportsParallel: false,
     annotations: {
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
       openWorldHint: false
     },
     operation: "file_read",
     describeTarget: (args) => `schedule_draft:${String(args["action"] ?? "list")}`,
-    execute(rawArgs, _ctx) {
+    async execute(rawArgs, ctx) {
       const startedAt = Date.now();
       const action = rawArgs["action"];
       if (action === "list") {
         const rows = deps.list();
-        return Promise.resolve(
-          say4(
-            rows.length === 0 ? "\u4E00\u6761\u5B9A\u65F6\u4EFB\u52A1\u90FD\u8FD8\u6CA1\u6709\u3002\u8981\u65B0\u5EFA\u5C31\u7528 action=create\u3002" : `\u73B0\u6709 ${rows.length} \u6761\uFF1A
+        return say4(
+          rows.length === 0 ? "\u4E00\u6761\u5B9A\u65F6\u4EFB\u52A1\u90FD\u8FD8\u6CA1\u6709\u3002\u8981\u65B0\u5EFA\u5C31\u7528 action=create\u3002" : `\u73B0\u6709 ${rows.length} \u6761\uFF1A
 ${rows.map(describeRow).join("\n")}`,
-            true,
-            startedAt
-          )
+          true,
+          startedAt
         );
       }
       const parsed = parseScheduleDraft(rawArgs);
-      if (!parsed.ok) return Promise.resolve(say4(parsed.message, false, startedAt));
+      if (!parsed.ok) return say4(parsed.message, false, startedAt);
       const draft = parsed.value;
       const current = draft.action === "update" ? deps.get(draft.id) : void 0;
       if (draft.action === "update" && current === void 0) {
-        return Promise.resolve(
-          say4(`\u6CA1\u6709 id \u4E3A ${draft.id} \u7684\u4EFB\u52A1\u3002\u5148\u7528 action=list \u770B\u4E00\u773C\u73B0\u6709\u7684\u3002`, false, startedAt)
+        return say4(
+          `\u6CA1\u6709 id \u4E3A ${draft.id} \u7684\u4EFB\u52A1\u3002\u5148\u7528 action=list \u770B\u4E00\u773C\u73B0\u6709\u7684\u3002`,
+          false,
+          startedAt
         );
       }
       const issues = validateDraft(draft, deps.homeDir, current);
       if (issues.length > 0) {
-        return Promise.resolve(
-          say4(
-            `\u8FD9\u4EFD\u8349\u7A3F\u4FDD\u5B58\u4E0D\u4E86\uFF0C\u5148\u6539\u8FD9\u51E0\u5904\u518D\u4EA4\uFF1A${issues.join("\u3001")}\u3002\uFF08\u8FD9\u4E9B\u662F\u6821\u9A8C\u7801\uFF0C\u542B\u4E49\u770B\u5B57\u9762\uFF1Bdetail \u62EC\u5728\u540E\u9762\uFF09`,
-            false,
-            startedAt
-          )
+        return say4(
+          `\u8FD9\u4EFD\u63D0\u6848\u5B58\u4E0D\u4E0B\u6765\uFF0C\u5148\u6539\u8FD9\u51E0\u5904\u518D\u8BF4\uFF1A${issues.join("\u3001")}\u3002\uFF08\u8FD9\u4E9B\u662F\u6821\u9A8C\u7801\uFF0C\u542B\u4E49\u770B\u5B57\u9762\uFF1Bdetail \u62EC\u5728\u540E\u9762\uFF09`,
+          false,
+          startedAt
         );
       }
       const unattended = unattendedIssues(draft);
       if (unattended.length > 0) {
-        return Promise.resolve(
-          say4(
-            `\u8FD9\u4EFD\u8349\u7A3F\u4FDD\u5B58\u5F97\u4E86\uFF0C\u4F46\u5B83\u5230\u70B9\u4E86**\u8DD1\u4E0D\u51FA\u7ED3\u679C** \u2014\u2014 \u5B9A\u65F6\u4EFB\u52A1\u662F\u65E0\u4EBA\u503C\u5B88\u7684\uFF0C\u6CA1\u4EBA\u5728\u65C1\u8FB9\u56DE\u8BDD\u3002\u6539\u5B8C\u518D\u4EA4\uFF1A
+        return say4(
+          `\u8FD9\u4EFD\u63D0\u6848\u5B58\u5F97\u4E0B\u6765\uFF0C\u4F46\u5B83\u5230\u70B9\u4E86**\u8DD1\u4E0D\u51FA\u7ED3\u679C** \u2014\u2014 \u5B9A\u65F6\u4EFB\u52A1\u662F\u65E0\u4EBA\u503C\u5B88\u7684\uFF0C\u6CA1\u4EBA\u5728\u65C1\u8FB9\u56DE\u8BDD\u3002\u6539\u5B8C\u518D\u4EA4\uFF1A
 ${unattended.map((x) => `\xB7 ${x}`).join("\n")}`,
-            false,
-            startedAt
-          )
+          false,
+          startedAt
+        );
+      }
+      const readOnly = ctx.permissionLevel === "plan";
+      if (readOnly || deps.save === void 0) {
+        return say4(summarizeProposal(draft, current, readOnly), true, startedAt);
+      }
+      const saved = await persist(deps.save, draft, current);
+      if (saved.issues.length > 0) {
+        const codes = saved.issues.map((x) => x.detail ? `${x.code}\uFF08${x.detail}\uFF09` : x.code);
+        return say4(`\u5F15\u64CE\u62D2\u7EDD\u4E86\u8FD9\u4EFD\u63D0\u6848\uFF0C\u4E00\u4E2A\u5B57\u90FD\u6CA1\u5199\uFF1A${codes.join("\u3001")}\u3002`, false, startedAt);
+      }
+      const def = saved.schedule;
+      if (def === void 0) {
+        return say4(
+          "\u5F15\u64CE\u8BF4\u5B58\u4E0B\u6765\u4E86\uFF0C\u4F46\u6CA1\u56DE\u90A3\u6761\u4EFB\u52A1 \u2014\u2014 \u53BB\u81EA\u52A8\u5316\u9762\u677F\u770B\u4E00\u773C\u5B83\u5230\u5E95\u5728\u4E0D\u5728\u3002",
+          false,
+          startedAt
         );
       }
-      return Promise.resolve(say4(summarize(draft, current), true, startedAt));
+      return say4(summarizeSaved(draft, def, saved.registration, current), true, startedAt);
     }
   };
 }
@@ -4229,41 +4336,41 @@ function clampWindow(raw, fallback2, max) {
 function stamp2(ms) {
   return new Date(ms).toISOString().slice(0, 16).replace("T", " ");
 }
-function budgetOf(total) {
+function budgetOf2(total) {
   const shares = ANCHOR_SHARE + Math.max(0, total - 1);
   const unit = Math.max(MIN_BODY, Math.floor(BODY_BUDGET / shares));
   return { anchor: unit * ANCHOR_SHARE, other: unit };
 }
-function body(text, budget) {
+function body(text, budget2) {
   const flat = text.replace(/\r\n/g, "\n").trimEnd();
-  if (flat.length <= budget) return flat;
-  const rest = flat.length - budget;
-  return `${flat.slice(0, budget)}
+  if (flat.length <= budget2) return flat;
+  const rest = flat.length - budget2;
+  return `${flat.slice(0, budget2)}
    \u2026[cut ${rest} more chars \u2014 lower before/after to spend the budget on fewer messages]`;
 }
 function surfaceOf(record, isCurrent) {
   if (!isCurrent) return record.surface === "active" ? "active there" : "compacted there";
   return record.surface === "active" ? "still in your context" : "compacted out of your context";
 }
-function renderRecord(record, mark, budget, isCurrent) {
+function renderRecord(record, mark, budget2, isCurrent) {
   const tool = record.toolName ? ` \xB7 ${record.toolName}` : "";
   return [
     `${mark} #${record.messageId} [${record.role}${tool} \xB7 ${stamp2(record.timestamp)} \xB7 ${surfaceOf(record, isCurrent)}]`,
-    `   ${body(record.content, budget).split("\n").join("\n   ")}`
+    `   ${body(record.content, budget2).split("\n").join("\n   ")}`
   ].join("\n");
 }
 function renderWindow(out, sessionId, isCurrent) {
   const anchor = out.anchor;
   if (!anchor) return "";
   const count = out.before.length + out.after.length + 1;
-  const budget = budgetOf(count);
+  const budget2 = budgetOf2(count);
   return [
     `Session ${sessionId}${isCurrent ? " (this session)" : ""} \u2014 ${out.title || "(untitled)"}`,
     `${count} of ${out.total} message(s), around #${anchor.messageId}:`,
     "",
-    ...out.before.map((r) => renderRecord(r, " ", budget.other, isCurrent)),
-    renderRecord(anchor, "\xBB", budget.anchor, isCurrent),
-    ...out.after.map((r) => renderRecord(r, " ", budget.other, isCurrent))
+    ...out.before.map((r) => renderRecord(r, " ", budget2.other, isCurrent)),
+    renderRecord(anchor, "\xBB", budget2.anchor, isCurrent),
+    ...out.after.map((r) => renderRecord(r, " ", budget2.other, isCurrent))
   ].join("\n");
 }
 function createSessionMessagesReadTool(deps) {
@@ -5976,6 +6083,7 @@ var CommandFrontmatterSchema = z.object({
 });
 var FRONTMATTER_KEYS3 = Object.keys(CommandFrontmatterSchema.shape);
 var MAX_POSITIONAL = 9;
+var ARG_PREVIEW_MAX = 120;
 var UTILITY_KEYWORD = "utility";
 function loadCommands(files, source, prefix) {
   const commands = [];
@@ -6081,6 +6189,14 @@ function expandCommand(def, args, opts = {}) {
       })
     );
   }
+  if (trimmed !== "" && used.size === 0 && !def.prompt.includes("$ARGUMENTS")) {
+    warnings.push(
+      t("custom_command.unused_args", {
+        name: def.name,
+        args: trimmed.length > ARG_PREVIEW_MAX ? `${trimmed.slice(0, ARG_PREVIEW_MAX)}\u2026` : trimmed
+      })
+    );
+  }
   const model = resolveCommandModel(def, opts, warnings);
   return {
     prompt: out,
@@ -6156,7 +6272,7 @@ function loadCommandDefinitions(opts) {
   }
   diags?.ok(
     SLASH_COMMANDS_DIAG_MODULE,
-    summarize2(commands.length, plugin.commands.length, user, project)
+    summarize(commands.length, plugin.commands.length, user, project)
   );
   return {
     commands,
@@ -6167,7 +6283,7 @@ function loadCommandDefinitions(opts) {
     issues: [...plugin.issues, ...user.issues, ...project.issues]
   };
 }
-function summarize2(total, pluginCount, user, project) {
+function summarize(total, pluginCount, user, project) {
   if (total === 0) return t("custom_command.none");
   const parts = [
     t("custom_command.count_user", { count: user.commands.length }),
@@ -8924,7 +9040,7 @@ async function snapshotFiles(paths) {
 }
 async function collectDiffs(before, workDir) {
   const out = [];
-  let budget = MAX_CALL_BYTES;
+  let budget2 = MAX_CALL_BYTES;
   for (const [path, old] of before) {
     if (old.kind === "opaque") continue;
     const now = await readSnapshot(path);
@@ -8932,8 +9048,8 @@ async function collectDiffs(before, workDir) {
     if (old.kind === "absent" && now.kind === "absent") continue;
     if (old.kind === "text" && now.kind === "text" && old.text === now.text) continue;
     const bytes = (old.kind === "text" ? old.bytes : 0) + (now.kind === "text" ? now.bytes : 0);
-    if (bytes > budget) continue;
-    budget -= bytes;
+    if (bytes > budget2) continue;
+    budget2 -= bytes;
     out.push({
       filePath: workspaceDisplayPath(path, workDir),
       ...old.kind === "text" ? { oldContent: old.text } : {},
@@ -9521,10 +9637,10 @@ function renderSettings(s) {
   bits.push(`\u4E0A\u4E0B\u6587\u7A97\u53E3 ${s.contextLength}`);
   bits.push(`\u81EA\u52A8\u538B\u7F29 ${s.compression.enabled ? `\u5F00\uFF08${s.compression.threshold}\uFF09` : "\u5173"}`);
   bits.push(`\u7EC8\u7AEF\u6C99\u7BB1 ${s.sandboxTerminal ? "\u5F00" : "\u5173"}`);
-  const budget = [];
-  if (s.budget?.maxCostUsd !== void 0) budget.push(`$${s.budget.maxCostUsd}`);
-  if (s.budget?.maxTokens !== void 0) budget.push(`${s.budget.maxTokens} tokens`);
-  bits.push(`\u9884\u7B97\u4E0A\u9650 ${budget.length > 0 ? budget.join(" / ") : "\u672A\u8BBE"}`);
+  const budget2 = [];
+  if (s.budget?.maxCostUsd !== void 0) budget2.push(`$${s.budget.maxCostUsd}`);
+  if (s.budget?.maxTokens !== void 0) budget2.push(`${s.budget.maxTokens} tokens`);
+  bits.push(`\u9884\u7B97\u4E0A\u9650 ${budget2.length > 0 ? budget2.join(" / ") : "\u672A\u8BBE"}`);
   return [
     "<settings>",
     bits.join(" \xB7 "),
@@ -9641,7 +9757,7 @@ function extensionFor(mediaType) {
   if (sub === "jpeg") return ".jpg";
   return /^[a-z0-9]{1,8}$/.test(sub) ? `.${sub}` : ".bin";
 }
-function persist(bytes, mediaType, dir, hint) {
+function persist2(bytes, mediaType, dir, hint) {
   const digest2 = createHash("sha256").update(bytes).digest("hex").slice(0, 16);
   const safeHint = (hint ?? "").replace(/[^A-Za-z0-9_-]/g, "").slice(0, 40);
   const stem = safeHint ? `${safeHint}-${digest2}` : digest2;
@@ -9682,7 +9798,7 @@ function admitArtifact(raw, policy) {
   const bytes = Buffer.from(raw.base64, "base64");
   const byteLen = bytes.length;
   const size = raw.kind === "image" ? readImageSize(bytes) : void 0;
-  const path = policy.artifactsDir ? persist(bytes, raw.mediaType, policy.artifactsDir, raw.filename) : void 0;
+  const path = policy.artifactsDir ? persist2(bytes, raw.mediaType, policy.artifactsDir, raw.filename) : void 0;
   const dims = size ? ` ${size.width}\xD7${size.height}` : "";
   const head = raw.note ? `${raw.note} ` : "";
   const reason9 = rejectionReason(raw, policy, byteLen, size);
@@ -11768,7 +11884,7 @@ function toAbsolute2(path, workDir) {
 }
 var MAX_TOOL_OUTPUT = 3e4;
 var MAX_SUB_CALL_OUTPUT = CODE_MODE_LIMITS.maxValueChars;
-function budgetOf2(tool, depth, path = "success") {
+function budgetOf3(tool, depth, path = "success") {
   if (tool.governsOwnOutput && path === "success") return Number.POSITIVE_INFINITY;
   return depth > 0 ? MAX_SUB_CALL_OUTPUT : MAX_TOOL_OUTPUT;
 }
@@ -12019,7 +12135,7 @@ var ToolExecutor = class {
         permissionLevel: this.deps.permissionManager?.getLevel() || "auto",
         ...signal ? { signal } : {},
         ...onOutput ? { onOutput } : {},
-        outputBudget: budgetOf2(et, depth),
+        outputBudget: budgetOf3(et, depth),
         ...depth < MAX_SUB_CALL_DEPTH ? { callTool: this.subCallChannel(sessionId, signal, span, depth) } : {}
       });
       if (snapshotted.length > 0) {
@@ -12051,7 +12167,7 @@ var ToolExecutor = class {
           success: true,
           output: this.renderOutput(
             et,
-            appendArtifactSummaries(text, artifacts, budgetOf2(et, depth), shapeOf(r.output))
+            appendArtifactSummaries(text, artifacts, budgetOf3(et, depth), shapeOf(r.output))
           ),
           ...artifacts.length > 0 ? { artifacts } : {},
           ...diffs.length > 0 ? { diffs } : {}
@@ -12062,7 +12178,7 @@ var ToolExecutor = class {
         success: false,
         output: this.renderOutput(
           et,
-          truncateForModel(failureText(r), budgetOf2(et, depth, "failure"), "text")
+          truncateForModel(failureText(r), budgetOf3(et, depth, "failure"), "text")
         )
       });
     } catch (err) {
@@ -12239,13 +12355,13 @@ function stripHistoryImages(history) {
   });
   return { messages, stripped };
 }
-function budgetStop(budget, messages) {
-  const breach = budget.breachReason();
-  if (breach) return { message: budget.describeBreach(breach), breach };
+function budgetStop(budget2, messages) {
+  const breach = budget2.breachReason();
+  if (breach) return { message: budget2.describeBreach(breach), breach };
   const imageTokens = pendingImageTokens(messages);
-  const projected = budget.projectedBreach(imageTokens);
+  const projected = budget2.projectedBreach(imageTokens);
   if (!projected) return void 0;
-  return { message: budget.describeProjectedBreach(projected, imageTokens), breach: projected };
+  return { message: budget2.describeProjectedBreach(projected, imageTokens), breach: projected };
 }
 var AgentLoop = class {
   config;
@@ -12481,7 +12597,7 @@ var AgentLoop = class {
     const addRun = (u) => {
       runUsage = runUsage ? addUsage(runUsage, u) : u;
     };
-    const budget = new BudgetGuard({
+    const budget2 = new BudgetGuard({
       ...this.config.budget ? { budget: this.config.budget } : {},
       ...this.config.modelPricing ? { pricing: this.config.modelPricing } : {},
       ...input.maxCallCostUsd !== void 0 ? { maxCallCostUsd: input.maxCallCostUsd } : {},
@@ -12493,7 +12609,7 @@ var AgentLoop = class {
     const finish = (reason9, breach) => ({
       type: "finish",
       reason: reason9,
-      usage: budget.snapshot(),
+      usage: budget2.snapshot(),
       ...runUsage ? { runUsage } : {},
       ...lastModel ? { model: lastModel } : {},
       ...lastRequestedModel ? { requestedModel: lastRequestedModel } : {},
@@ -12545,8 +12661,8 @@ var AgentLoop = class {
           await this.prompt.syncMemory(userText, lastText);
           return;
         }
-        budget.syncFromStore();
-        const stop = budgetStop(budget, messages);
+        budget2.syncFromStore();
+        const stop = budgetStop(budget2, messages);
         if (stop) {
           yield { type: "text-delta", text: stop.message };
           await this.prompt.syncMemory(userText, lastText || stop.message);
@@ -12598,8 +12714,8 @@ var AgentLoop = class {
             }
             if (rescued.usage) {
               addRun(rescued.usage);
-              yield* budget.toEvents(
-                budget.add(rescued.usage, this.rateOf(rescued.model)),
+              yield* budget2.toEvents(
+                budget2.add(rescued.usage, this.rateOf(rescued.model)),
                 runUsage
               );
             }
@@ -12675,7 +12791,7 @@ var AgentLoop = class {
           });
           if (rescued.usage) {
             addRun(rescued.usage);
-            yield* budget.toEvents(budget.add(rescued.usage, this.rateOf(rescued.model)), runUsage);
+            yield* budget2.toEvents(budget2.add(rescued.usage, this.rateOf(rescued.model)), runUsage);
           }
           if (!shrank(messages, rescued.messages)) throw err;
           messages = rescued.messages;
@@ -12732,14 +12848,14 @@ var AgentLoop = class {
               "epoch.token_type": "cache_write"
             });
           }
-          const status = budget.add(usage, this.rateOf(result.model));
+          const status = budget2.add(usage, this.rateOf(result.model));
           input.onTurnUsage?.(
             status.turnCostUsd === void 0 ? usage : { ...usage, costUsd: status.turnCostUsd }
           );
           addRun(usage);
           lastModel = result.model;
           lastRequestedModel = result.requestedModel;
-          yield* budget.toEvents(status, runUsage);
+          yield* budget2.toEvents(status, runUsage);
         }
         const verdict = mergeVerdicts(guard?.verdict(), reasoningGuard?.verdict());
         if (verdict) this.reportCompliance(verdict, "output");
@@ -12976,8 +13092,8 @@ ${finalText}` };
         messages = compacted.messages;
         if (compacted.usage) {
           addRun(compacted.usage);
-          yield* budget.toEvents(
-            budget.add(compacted.usage, this.rateOf(compacted.model)),
+          yield* budget2.toEvents(
+            budget2.add(compacted.usage, this.rateOf(compacted.model)),
             runUsage
           );
         }
@@ -16916,8 +17032,8 @@ var MemoryManager = class {
   async add(target, content) {
     const label = injectionLabelOf(content);
     if (label !== void 0) return this.refuseInjection(label);
-    const budget = this.getBudget()[target];
-    if (budget.current + content.length > budget.limit) {
+    const budget2 = this.getBudget()[target];
+    if (budget2.current + content.length > budget2.limit) {
       this.consolidationFailures++;
       if (this.consolidationFailures > MAX_CONSOLIDATION_FAILURES_PER_TURN) {
         return {
@@ -16964,9 +17080,9 @@ var MemoryManager = class {
     }
     const label = injectionLabelOf(content);
     if (label !== void 0) return this.refuseInjection(label);
-    const budget = this.getBudget()[target];
+    const budget2 = this.getBudget()[target];
     const delta = content.length - existing.charLength;
-    if (budget.current + delta > budget.limit) {
+    if (budget2.current + delta > budget2.limit) {
       this.consolidationFailures++;
       if (this.consolidationFailures > MAX_CONSOLIDATION_FAILURES_PER_TURN) {
         return { success: false, done: true, error: "Consolidation limit reached" };
@@ -17171,11 +17287,11 @@ var MemoryManager = class {
     for (const target of ["memory", "user"]) {
       const rows = kept.filter((e) => e.target === target);
       if (rows.length === 0) continue;
-      const budget = this.getBudget()[target];
+      const budget2 = this.getBudget()[target];
       const label = target === "user" ? "USER PROFILE (who the user is)" : "MEMORY (your personal notes)";
       sections.push(
         [
-          `${label} [${rows.length} entries \xB7 ${budget.current.toLocaleString()}/${budget.limit.toLocaleString()} chars]`,
+          `${label} [${rows.length} entries \xB7 ${budget2.current.toLocaleString()}/${budget2.limit.toLocaleString()} chars]`,
           ...rows.map((e) => this.indexLine(e))
         ].join("\n")
       );
@@ -17206,7 +17322,7 @@ var MemoryManager = class {
     return `${e.id}  ${e.summary}  (${e.charLength} chars)`;
   }
   buildConsolidateHint(target) {
-    const budget = this.getBudget()[target];
+    const budget2 = this.getBudget()[target];
     const heat = /* @__PURE__ */ new Map();
     for (const row of this.db.getAll(target)) {
       const id = this.idByContent.get(contentKey(row.target, row.content));
@@ -17214,7 +17330,7 @@ var MemoryManager = class {
     }
     const candidates2 = this.indexEntries(target).sort((a, b) => (heat.get(a.id) ?? 0) - (heat.get(b.id) ?? 0) || b.charLength - a.charLength).slice(0, 5);
     return [
-      `Memory at ${budget.current.toLocaleString()}/${budget.limit.toLocaleString()} chars (${budget.percent}%) for ${target}. Cannot add new entry.`,
+      `Memory at ${budget2.current.toLocaleString()}/${budget2.limit.toLocaleString()} chars (${budget2.percent}%) for ${target}. Cannot add new entry.`,
       "",
       "To make room, work by id \u2014 NOT by old_text. The MEMORY INDEX only shows a truncated",
       "first line, so text copied from it will never match an entry exactly.",
@@ -17628,6 +17744,28 @@ function parseTurnFacts(json) {
 function encodeTurnFacts(facts) {
   return facts ? JSON.stringify(facts) : null;
 }
+function parseUserCommand(json) {
+  if (typeof json !== "string" || json.length === 0) return void 0;
+  let raw;
+  try {
+    raw = JSON.parse(json);
+  } catch {
+    return void 0;
+  }
+  if (!isRecord4(raw)) return void 0;
+  const name = str3(raw["name"]);
+  if (!name) return void 0;
+  const displayName = str3(raw["displayName"]);
+  const args = str3(raw["args"]);
+  return {
+    name,
+    ...displayName ? { displayName } : {},
+    ...args ? { args } : {}
+  };
+}
+function encodeUserCommand(command) {
+  return command ? JSON.stringify(command) : null;
+}
 // src/session/db.ts
 var NS3 = "session";
 var log2 = createLogger("session-db");
@@ -17923,7 +18061,7 @@ var FTS_EXTERNAL_SCHEMA = `
 var FTS_EXTERNAL_MIGRATIONS = [
   {
     id: "fts-external-content",
-    version: 14,
+    version: 16,
     description: "\u4E24\u5F20 FTS \u8868\u6539\u6210\u5916\u90E8\u5185\u5BB9\u8868\uFF08\u6B63\u6587\u4E0D\u518D\u5B58\u4E09\u4EFD\uFF0C2026-08-21\uFF09",
     up: (db) => {
       db.exec(FTS_EXTERNAL_SCHEMA);
@@ -17935,6 +18073,14 @@ var FTS_EXTERNAL_MIGRATIONS = [
         db.prepare(`INSERT INTO ${table}(${table}, rank) VALUES('integrity-check', 1)`).run();
       }
     }
+  },
+  {
+    id: "messages-command",
+    version: 15,
+    description: "\u6D88\u606F\u8868\u52A0 command \u4E00\u5217\uFF08\u8FD9\u6761\u7528\u6237\u6D88\u606F\u662F\u6309\u54EA\u6761\u659C\u6760\u547D\u4EE4\u53D1\u7684\uFF0C2026-10-21\uFF09",
+    up: (db) => {
+      db.exec(`ALTER TABLE messages ADD COLUMN command TEXT`);
+    }
   }
 ];
 var SessionDB = class {
@@ -18128,8 +18274,8 @@ var SessionDB = class {
   insertMessage(msg) {
     const info = this.db.prepare(
       `
-      INSERT INTO messages (session_id, role, content, tool_call_id, tool_calls, tool_results, parts, tool_name, timestamp, token_count, finish_reason, reasoning, turn_facts, active, compacted, observed)
-      VALUES (@sessionId, @role, @content, @toolCallId, @toolCalls, @toolResults, @parts, @toolName, @timestamp, @tokenCount, @finishReason, @reasoning, @turnFacts, 1, 0, 0)
+      INSERT INTO messages (session_id, role, content, tool_call_id, tool_calls, tool_results, parts, command, tool_name, timestamp, token_count, finish_reason, reasoning, turn_facts, active, compacted, observed)
+      VALUES (@sessionId, @role, @content, @toolCallId, @toolCalls, @toolResults, @parts, @command, @toolName, @timestamp, @tokenCount, @finishReason, @reasoning, @turnFacts, 1, 0, 0)
     `
     ).run({
       ...msg,
@@ -18137,6 +18283,7 @@ var SessionDB = class {
       toolCalls: encodeColumn(msg.toolCalls),
       toolResults: encodeColumn(msg.toolResults),
       parts: encodeColumn(msg.parts),
+      command: encodeUserCommand(msg.command),
       toolName: msg.toolName ?? null,
       tokenCount: msg.tokenCount ?? null,
       finishReason: msg.finishReason ?? null,
@@ -18402,8 +18549,8 @@ var SessionDB = class {
   forkMessages(fromSessionId, toSessionId, upToIndex) {
     const messages = this.db.prepare("SELECT * FROM messages WHERE session_id = ? AND id <= ? ORDER BY timestamp ASC").all(fromSessionId, upToIndex);
     const stmt = this.db.prepare(`
-      INSERT INTO messages (session_id, role, content, tool_call_id, tool_calls, tool_results, parts, tool_name, timestamp, token_count, finish_reason, reasoning, turn_facts, active, compacted, observed)
-      VALUES (@sessionId, @role, @content, @toolCallId, @toolCalls, @toolResults, @parts, @toolName, @timestamp, @tokenCount, @finishReason, @reasoning, @turnFacts, @active, @compacted, @observed)
+      INSERT INTO messages (session_id, role, content, tool_call_id, tool_calls, tool_results, parts, command, tool_name, timestamp, token_count, finish_reason, reasoning, turn_facts, active, compacted, observed)
+      VALUES (@sessionId, @role, @content, @toolCallId, @toolCalls, @toolResults, @parts, @command, @toolName, @timestamp, @tokenCount, @finishReason, @reasoning, @turnFacts, @active, @compacted, @observed)
     `);
     for (const m of messages) {
       const { id: _id, ...rest } = m;
@@ -18415,6 +18562,7 @@ var SessionDB = class {
         toolCalls: rest["tool_calls"] ?? null,
         toolResults: rest["tool_results"] ?? null,
         parts: rest["parts"] ?? null,
+        command: rest["command"] ?? null,
         toolName: rest["tool_name"] ?? null,
         timestamp: rest["timestamp"] ?? Date.now(),
         tokenCount: rest["token_count"] ?? null,
@@ -18496,6 +18644,7 @@ var SessionDB = class {
       toolCalls: parseToolCalls(row["tool_calls"]),
       toolResults: parseToolResults(row["tool_results"]),
       parts: parseParts(row["parts"]),
+      command: parseUserCommand(row["command"]),
       turnFacts: parseTurnFacts(row["turn_facts"]),
       toolName: row["tool_name"],
       timestamp: row["timestamp"],
@@ -19087,7 +19236,7 @@ var SessionManager = class {
   search(input) {
     return this.db.search(input);
   }
-  async compact(sessionId, summarize3) {
+  async compact(sessionId, summarize2) {
     const messages = this.db.getMessages(sessionId);
     const beforeCount = messages.length;
     const IMPORTANT_ROUNDS = 5;
@@ -19098,17 +19247,17 @@ var SessionManager = class {
       0,
       Math.max(0, keyMessages.length - IMPORTANT_ROUNDS * 2)
     );
-    const summary = toSummarize.length === 0 ? "" : await this.buildSummary(toSummarize, summarize3) ?? outlineOf(toSummarize);
+    const summary = toSummarize.length === 0 ? "" : await this.buildSummary(toSummarize, summarize2) ?? outlineOf(toSummarize);
     return this.db.compact(sessionId, summary, beforeCount, IMPORTANT_ROUNDS * 2);
   }
   archiveAndCompact(sessionId, input) {
     return this.db.archiveAndCompact(sessionId, input);
   }
-  async buildSummary(msgs, summarize3) {
-    if (!summarize3) return null;
+  async buildSummary(msgs, summarize2) {
+    if (!summarize2) return null;
     const transcript = msgs.map((m) => `[${m.role}] ${m.content}`).join("\n\n");
     try {
-      const result = await summarize3(transcript);
+      const result = await summarize2(transcript);
       return result?.trim() ? result.trim() : null;
     } catch {
       return null;
@@ -19296,8 +19445,8 @@ var GoalService = class {
     const text = objective.trim();
     if (!text) return { ok: false, reason: "empty-objective" };
     if (text.length > MAX_OBJECTIVE_CHARS) return { ok: false, reason: "objective-too-long" };
-    const budget = maxRounds ?? DEFAULT_GOAL_MAX_ROUNDS;
-    if (!Number.isInteger(budget) || budget < 1 || budget > MAX_GOAL_MAX_ROUNDS) {
+    const budget2 = maxRounds ?? DEFAULT_GOAL_MAX_ROUNDS;
+    if (!Number.isInteger(budget2) || budget2 < 1 || budget2 > MAX_GOAL_MAX_ROUNDS) {
       return { ok: false, reason: "bad-budget" };
     }
     const existing = this.current(sessionId);
@@ -19309,7 +19458,7 @@ var GoalService = class {
       objective: text,
       phase: "active",
       block: void 0,
-      maxRounds: budget,
+      maxRounds: budget2,
       roundsUsed: 0,
       completeEvidence: void 0,
       createdAt: at,
@@ -23437,7 +23586,7 @@ function stageSkillDir(source, staging, category, name, skills, issues, lang) {
   const dir = join(staging, category, name);
   mkdirSync(dir, { recursive: true });
   copyFileSync(join(source, SKILL_FILE), join(dir, SKILL_FILE));
-  let budget = MAX_FILES_PER_SKILL - 1;
+  let budget2 = MAX_FILES_PER_SKILL - 1;
   for (const entry of readEntries2(source, label, issues, lang)) {
     if (entry.name === SKILL_FILE) continue;
     if (!entry.isDir || !SKILL_ASSET_DIRS.includes(entry.name)) {
@@ -23447,7 +23596,7 @@ function stageSkillDir(source, staging, category, name, skills, issues, lang) {
       });
       continue;
     }
-    budget = copyTree(join(source, entry.name), join(dir, entry.name), label, budget, issues, lang);
+    budget2 = copyTree(join(source, entry.name), join(dir, entry.name), label, budget2, issues, lang);
   }
   skills.push({ name, category, dir });
 }
@@ -23506,8 +23655,8 @@ function placeOf(root, parts, lang) {
   const category = parts.at(-2) ?? "general";
   return { name, category: skillSegmentIssue(category, lang) === void 0 ? category : "general" };
 }
-function copyTree(from, to, label, budget, issues, lang) {
-  let left = budget;
+function copyTree(from, to, label, budget2, issues, lang) {
+  let left = budget2;
   mkdirSync(to, { recursive: true });
   for (const entry of readEntries2(from, label, issues, lang)) {
     if (left <= 0) {
@@ -24571,11 +24720,11 @@ function readOne(path, opts, usedBytes) {
   }
   const remaining = MAX_ATTACH_TOTAL_BYTES - usedBytes;
   if (remaining <= 0) return { part: { type: "file", path, omitted: "over-limit", bytes: size } };
-  const budget = Math.min(MAX_ATTACH_BYTES, remaining);
-  if (raw.length <= budget) {
+  const budget2 = Math.min(MAX_ATTACH_BYTES, remaining);
+  if (raw.length <= budget2) {
     return { part: { type: "file", path, text: raw.toString("utf8"), bytes: size } };
   }
-  const { text, truncatedTo } = truncateToBudget(raw, budget);
+  const { text, truncatedTo } = truncateToBudget(raw, budget2);
   return {
     part: { type: "file", path, text, truncatedTo, bytes: size },
     notice: t("mentions.truncated", {