@epoch-agent/core 0.30.0 → 1.1.0

package/dist/index.d.ts

@@ -7265,13 +7265,17 @@ declare function loadPlugins(opts: PluginLoadOptions): PluginArtifacts;
  * | 族                                              | 谁读它                                   |
  * | ----------------------------------------------- | ---------------------------------------- |
  * | `name` / `version` / `epochVersion` / `author`  | **epoch 自己** —— 装不装得上、叫什么     |
- * | `displayName` / `category` / `visibility` / `changelog` | **上传那一屏的预填**，epoch 一个字不读 |
+ * | `displayName` / `category` / `visibility` / `changelog` | **上传那一屏的预填**（`displayName` 例外，见下） |
  * | `description` / `homepage` / `keywords` / `icon` | 两边都读（`icon` 见它那一格）           |
  * | `dependencies`                                  | **epoch 自己** —— 装它时要一起装谁       |
  *
  * 第二族 2026-09-15 加的，判据在它们自己那几格上。要紧的一条：它们是**预填**，
  * 用户在那一屏上改得动，改了之后发出去的是改后的 —— 包里这一份原地不动。
  *
+ * ⚠️ **`displayName` 不只是预填**（这张表原来写的「epoch 一个字不读」早就不成立了）：
+ * 安装前那一屏预览和依赖清单读它（`install.ts`），已装那一栏在市场目录说不出名字时
+ * 也拿它兜底（2026-10-14，runtime 的 `PluginEntryView.packageDisplayName`）。
+ *
  * 文件名放在**插件根**，不学竞品的 `.claude-plugin/` 子目录 —— 多一层目录没带来
  * 任何好处，而「插件根下有没有 `epoch-plugin.json`」是判定「这是不是一个插件」
  * 最省事的问法。
@@ -12332,11 +12336,15 @@ declare const EpochConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     brand: z.ZodOptional<z.ZodString>;
+    brandWhenSidebarCollapsed: z.ZodOptional<z.ZodEnum<{
+        hide: "hide";
+        show: "show";
+    }>>;
     sidebarMenu: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
         icon: z.ZodOptional<z.ZodString>;
-        pinned: z.ZodOptional<z.ZodBoolean>;
+        primary: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>;
     userMenu: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -15527,6 +15535,12 @@ interface StoredAppearance {
     theme?: string;
     /** 语言偏好（`system | zh | en`）。缺席 = 没选过 */
     lang?: string;
+    /**
+     * 宽屏侧栏宽度（px，2026-10-14 侧栏可拖之后）。缺席 = 没拖过。
+     * 同上面两格：这一层**只判结构**（正整数），上下限归 protocol 的
+     * `isAppearanceSidebarWidth`，由写入口和首屏那段脚本各自把关 —— 盘上一个越界的数是惰性的
+     */
+    sidebarWidth?: number;
 }
 declare class AppearanceStore {
     private readonly filePath;

package/dist/index.js

@@ -1,4 +1,4 @@
-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, cronTimes, SCHEDULE_MAX_TIMES_PER_DAY, SCHEDULE_INTERVAL_MIN_MINUTES, SCHEDULE_INTERVAL_MAX_MINUTES, ToolExposure, MAX_OPTIONS, MIN_OPTIONS, MAX_HEADER_CHARS, MAX_QUESTIONS, 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, BRAND_WHEN_SIDEBAR_COLLAPSED, PERMISSION_LEVELS, SHELL_KINDS, cronTimes, SCHEDULE_MAX_TIMES_PER_DAY, SCHEDULE_INTERVAL_MIN_MINUTES, SCHEDULE_INTERVAL_MAX_MINUTES, ToolExposure, MAX_OPTIONS, MIN_OPTIONS, MAX_HEADER_CHARS, MAX_QUESTIONS, 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 { 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';
@@ -1568,7 +1568,7 @@ async function* runTurnStreaming(opts) {
           if (chunk.warnings) warnings = chunk.warnings;
           break;
         case "error":
-          streamError = chunk.error ?? t("agent_run.unknown_provider_error");
+          streamError = chunk.error || t("provider_route.no_detail");
           break;
         case "tool-result":
           break;
@@ -8953,14 +8953,28 @@ function describeBackgroundTask(task) {
 }
 var HEAVY_SOURCE_RATIO = 0.15;
 var HEAVY_SKILL_RATIO = 0.02;
-function seg(label, text, detail) {
-  const tokens = text ? estimateTokens(text) : 0;
-  if (tokens === 0) return null;
-  return { label, tokens, ...detail ? { detail } : {} };
+var SEG_KEY = {
+  system: "context_breakdown.seg_system",
+  instructions: "context_breakdown.seg_instructions",
+  tools: "context_breakdown.seg_tools",
+  skills: "context_breakdown.seg_skills",
+  memory: "context_breakdown.seg_memory",
+  history: "context_breakdown.seg_history"
+};
+var NOTE_KEY = {
+  heavy_mcp: "context_breakdown.heavy_mcp",
+  heavy_tools: "context_breakdown.heavy_tools",
+  heavy_skills: "context_breakdown.heavy_skills",
+  heavy_skills_owner: "context_breakdown.heavy_skills_owner",
+  skills_capped: "context_breakdown.skills_capped",
+  near_limit: "context_breakdown.near_limit"
+};
+function seg(kind, text, detail) {
+  return segOf(kind, text ? estimateTokens(text) : 0, detail);
 }
-function segOf(label, tokens, detail) {
+function segOf(kind, tokens, detail, extra) {
   if (tokens === 0) return null;
-  return { label, tokens, ...detail ? { detail } : {} };
+  return { label: t(SEG_KEY[kind]), tokens, kind, ...detail ? { detail } : {}, ...extra };
 }
 function toolDetail(input, toolTokens) {
   const bySource = /* @__PURE__ */ new Map();
@@ -8971,93 +8985,80 @@ function toolDetail(input, toolTokens) {
     bySource.set(source, entry);
   }
   const mcp = [...bySource.entries()].filter(([source]) => source.startsWith("mcp:"));
-  const localCount = input.tools.length - mcp.reduce((n, [, e]) => n + e.count, 0);
-  const detail = mcp.length > 0 ? t("context_breakdown.tools_mixed", {
-    local: localCount,
-    mcp: mcp.reduce((n, [, e]) => n + e.count, 0)
-  }) : t("context_breakdown.tools_local_only", { local: localCount });
-  const hints = [];
+  const mcpCount = mcp.reduce((n, [, e]) => n + e.count, 0);
+  const localCount = input.tools.length - mcpCount;
+  const detail = mcp.length > 0 ? t("context_breakdown.tools_mixed", { local: localCount, mcp: mcpCount }) : t("context_breakdown.tools_local_only", { local: localCount });
+  const notes = [];
   if (input.limit > 0) {
     for (const [source, entry] of mcp) {
       const ratio = entry.tokens / input.limit;
       if (ratio < HEAVY_SOURCE_RATIO) continue;
       const server = source.slice("mcp:".length);
-      hints.push(
-        t("context_breakdown.heavy_mcp", {
+      notes.push({
+        code: "heavy_mcp",
+        params: {
           server,
           count: entry.count,
           percent: Math.round(ratio * 100),
           tokens: Math.round(entry.tokens / 100) / 10
-        })
-      );
+        }
+      });
     }
   }
-  if (input.limit > 0 && toolTokens / input.limit > 0.3 && hints.length === 0) {
-    hints.push(
-      t("context_breakdown.heavy_tools", {
-        percent: Math.round(toolTokens / input.limit * 100)
-      })
-    );
+  if (input.limit > 0 && toolTokens / input.limit > 0.3 && notes.length === 0) {
+    notes.push({
+      code: "heavy_tools",
+      params: { percent: Math.round(toolTokens / input.limit * 100) }
+    });
   }
-  return { detail, hints };
+  return { detail, counts: { local: localCount, mcp: mcpCount }, notes };
 }
-function skillHints(input, skillTokens) {
+function skillNotes(input, skillTokens) {
   const stats = input.skillIndex;
   if (!stats || stats.total === 0 || skillTokens === 0) return [];
   if (stats.dropped > 0) {
-    return [
-      t("context_breakdown.skills_capped", {
-        indexed: stats.indexed,
-        dropped: stats.dropped
-      })
-    ];
+    return [{ code: "skills_capped", params: { indexed: stats.indexed, dropped: stats.dropped } }];
   }
-  const hints = [];
+  const notes = [];
   if (input.limit > 0 && skillTokens / input.limit >= HEAVY_SKILL_RATIO) {
-    hints.push(
-      t("context_breakdown.heavy_skills", {
+    notes.push({
+      code: "heavy_skills",
+      params: {
         count: stats.indexed,
         percent: Math.round(skillTokens / input.limit * 100)
-      })
-    );
+      }
+    });
     if (stats.heaviest) {
-      hints.push(
-        t("context_breakdown.heavy_skills_owner", {
-          owner: stats.heaviest.owner,
-          count: stats.heaviest.count
-        })
-      );
+      notes.push({
+        code: "heavy_skills_owner",
+        params: { owner: stats.heaviest.owner, count: stats.heaviest.count }
+      });
     }
   }
-  return hints;
+  return notes;
 }
 function buildContextBreakdown(input) {
   const toolTokens = input.tools.reduce((sum, { tool }) => sum + toolDefinitionTokens(tool), 0);
-  const { detail, hints } = toolDetail(input, toolTokens);
-  const skillsSeg = seg(t("context_breakdown.seg_skills"), input.system.skills);
+  const { detail, counts, notes } = toolDetail(input, toolTokens);
+  const skillsSeg = seg("skills", input.system.skills);
   const segments = [
-    seg("system prompt", `${input.system.identity}
+    seg("system", `${input.system.identity}
 ${input.system.head}
 ${input.system.rules}`),
-    seg(
-      t("context_breakdown.seg_instructions"),
-      input.projectBlock,
-      t("context_breakdown.seg_instructions_detail")
-    ),
-    segOf(t("context_breakdown.seg_tools"), toolTokens, detail),
+    seg("instructions", input.projectBlock, t("context_breakdown.seg_instructions_detail")),
+    segOf("tools", toolTokens, detail, { toolCounts: counts }),
     skillsSeg,
-    seg(t("context_breakdown.seg_memory"), input.memoryBlock),
-    seg(t("context_breakdown.seg_history"), input.historyText)
+    seg("memory", input.memoryBlock),
+    seg("history", input.historyText)
   ].filter((s) => s !== null);
-  hints.push(...skillHints(input, skillsSeg?.tokens ?? 0));
+  notes.push(...skillNotes(input, skillsSeg?.tokens ?? 0));
   const used = segments.reduce((sum, s) => sum + s.tokens, 0);
   const remaining = input.limit > 0 ? Math.max(0, input.limit - used) : 0;
   if (input.limit > 0 && used / input.limit > 0.8) {
-    hints.push(
-      t("context_breakdown.near_limit", { percent: Math.round(used / input.limit * 100) })
-    );
+    notes.push({ code: "near_limit", params: { percent: Math.round(used / input.limit * 100) } });
   }
-  return { limit: input.limit, used, remaining, segments, hints };
+  const hints = notes.map((note) => t(NOTE_KEY[note.code], note.params));
+  return { limit: input.limit, used, remaining, segments, hints, notes };
 }
 // src/cost/display.ts
 var currency;
@@ -10738,8 +10739,12 @@ var NETWORK_MESSAGE_RE = /timeout|timed.?out|etimedout|econnreset|enotfound|sock
 function describeProviderError(err) {
   const chain = causeChain(err);
   const head = chain[0]?.message ?? (typeof err === "string" ? err : String(err));
-  if (chain.length === 0) return head;
   const root = [...chain].reverse().find((link) => link.message !== "" && link.message !== head)?.message;
+  if (!head.trim()) {
+    if (root) return root;
+    const status = extractStatus(err);
+    return status === void 0 ? t("provider_route.no_detail") : t("provider_route.no_detail_status", { status });
+  }
   return root ? t("provider_route.root_cause", { message: head, cause: root }) : head;
 }
 function extractStatus(err) {
@@ -13096,7 +13101,7 @@ var SidebarMenuItemSchema = z.object({
   icon: z.string().min(1).optional()
 });
 var SidebarNavItemSchema = SidebarMenuItemSchema.extend({
-  pinned: z.boolean().optional()
+  primary: z.boolean().optional()
 });
 var BlankCardSchema = z.object({
   id: z.string().min(1),
@@ -13181,8 +13186,11 @@ var EpochConfigSchema = z.object({
   statusLine: StatusLineSchema.optional(),
   display: DisplaySchema2.optional(),
   brand: z.string().min(1).optional(),
+  brandWhenSidebarCollapsed: z.enum(BRAND_WHEN_SIDEBAR_COLLAPSED).optional(),
   sidebarMenu: z.array(SidebarNavItemSchema).min(1).refine((items) => new Set(items.map((item) => item.id)).size === items.length, {
     message: "sidebarMenu: id must be unique"
+  }).refine((items) => items.filter((item) => item.primary === true).length <= 1, {
+    message: "sidebarMenu: at most one item can be primary"
   }).optional(),
   userMenu: z.array(SidebarMenuItemSchema).min(1).refine((items) => new Set(items.map((item) => item.id)).size === items.length, {
     message: "userMenu: id must be unique"
@@ -14876,7 +14884,10 @@ var ProviderRouter = class {
     if (next) return next;
     return {
       kind: "give-up",
-      message: recovery === "rotate_credential" ? t("provider_route.keys_exhausted") : message,
+      message: recovery === "rotate_credential" ? t("provider_route.root_cause", {
+        message: t("provider_route.credential_rejected"),
+        cause: message
+      }) : message,
       code
     };
   }
@@ -17589,21 +17600,32 @@ var SessionDB = class {
   search(input) {
     const limit = input.limit ?? 5;
     const scope = input.scope ?? "all";
-    if (scope === "title") {
-      const safe = "%" + sanitizeFtsQuery(input.query) + "%";
-      const rows = this.db.prepare(
-        `SELECT * FROM sessions WHERE archived = 0 AND title LIKE @q ORDER BY started_at DESC LIMIT @limit`
-      ).all({ q: safe, limit });
-      return {
-        results: rows.map((r) => ({
-          session: this.rowToMeta(r),
-          matches: [{ messageIndex: -1, snippet: r["title"] ?? "", score: 1 }],
-          score: 1
-        }))
-      };
-    }
-    const safeQuery = sanitizeFtsQuery(input.query);
-    if (!safeQuery) return { results: [] };
+    if (scope === "title") return { results: this.searchTitles(input.query, limit) };
+    const content = this.searchContent(input.query, limit);
+    if (scope === "content") return { results: content };
+    const titles = this.searchTitles(input.query, limit);
+    const seen = new Set(titles.map((r) => r.session.id));
+    return {
+      results: [...titles, ...content.filter((r) => !seen.has(r.session.id))].slice(0, limit)
+    };
+  }
+  searchTitles(query, limit) {
+    const needle = query.trim();
+    if (!needle) return [];
+    const like = "%" + needle.replace(/[\\%_]/g, "\\$&") + "%";
+    const rows = this.db.prepare(
+      `SELECT * FROM sessions WHERE archived = 0 AND title LIKE @q ESCAPE '\\'
+         ORDER BY started_at DESC LIMIT @limit`
+    ).all({ q: like, limit });
+    return rows.map((r) => ({
+      session: this.rowToMeta(r),
+      matches: [{ messageIndex: -1, snippet: r["title"] ?? "", score: 1 }],
+      score: 1
+    }));
+  }
+  searchContent(query, limit) {
+    const safeQuery = sanitizeFtsQuery(query);
+    if (!safeQuery) return [];
     const ftsQuery = buildFtsMatchQuery(safeQuery);
     const ftsRows = this.db.prepare(
       `
@@ -17650,7 +17672,7 @@ var SessionDB = class {
           score: 1
         });
       }
-      return { results: results2 };
+      return results2;
     }
     const seen = /* @__PURE__ */ new Set();
     const results = [];
@@ -17671,7 +17693,7 @@ var SessionDB = class {
         score: 1
       });
     }
-    return { results };
+    return results;
   }
   pruneCandidates(input) {
     const clauses = ["ended_at IS NOT NULL", "updated_at < @cutoff", "ended_at < @cutoff"];
@@ -19084,6 +19106,7 @@ function isLastOpenSession(value) {
   const v = value;
   return typeof v["root"] === "string" && v["root"].length > 0 && typeof v["sessionId"] === "string" && v["sessionId"].length > 0 && typeof v["at"] === "number";
 }
+var isWidthShaped = (value) => typeof value === "number" && Number.isInteger(value) && value > 0;
 var FILE_VERSION4 = 1;
 function describe9(err) {
   return err instanceof Error ? err.message : String(err);
@@ -19106,7 +19129,10 @@ var AppearanceStore = class {
       const value = patch[key];
       if (typeof value === "string" && value.length > 0) next[key] = value;
     }
-    if (next.theme === this.prefs.theme && next.lang === this.prefs.lang) return;
+    if (isWidthShaped(patch.sidebarWidth)) next.sidebarWidth = patch.sidebarWidth;
+    if (next.theme === this.prefs.theme && next.lang === this.prefs.lang && next.sidebarWidth === this.prefs.sidebarWidth) {
+      return;
+    }
     this.prefs = next;
     this.save();
   }
@@ -19130,6 +19156,7 @@ var AppearanceStore = class {
     if (file.version !== FILE_VERSION4) return;
     if (typeof file.theme === "string" && file.theme.length > 0) this.prefs.theme = file.theme;
     if (typeof file.lang === "string" && file.lang.length > 0) this.prefs.lang = file.lang;
+    if (isWidthShaped(file.sidebarWidth)) this.prefs.sidebarWidth = file.sidebarWidth;
   }
   save() {
     const body2 = JSON.stringify(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/core",
-  "version": "0.30.0",
+  "version": "1.1.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.30.0",
-    "@epoch-agent/protocol": "0.30.0"
+    "@epoch-agent/infra": "1.1.0",
+    "@epoch-agent/protocol": "1.1.0"
   },
   "devDependencies": {
     "@ai-sdk/alibaba": "^2.0.59",