@epoch-agent/core 0.19.0 → 0.20.0

package/dist/index.d.ts

@@ -8280,11 +8280,27 @@ declare function updatePlugin(name: string, opts: InstallOptions): Promise<Insta
 
 /** 市场清单的文件名，同插件清单一样放在根 */
 declare const MARKETPLACE_FILE = "epoch-marketplace.json";
-declare const EntrySchema: z.ZodObject<{
+/**
+ * 条目**解析之后**的形状 —— {@link EntryShape} 走完「分类那一格归一化成数组」的那一份。
+ *
+ * ## ⚠️ 归一化做在**边界上**，不是让每个消费者各自 `?? []`
+ *
+ * 分类那一格写进文件里有两种形状（字符串 / 数组，判据在它那一格上），而下游三处
+ * 消费者（core 的检索面、server 的网线投影、CLI 的打印）要的是同一个结论。
+ * 让它们各自处理那个联合类型的下场是**漏掉一处**：漏掉的那一处不是报错，
+ * 是"那一条少归了几类"—— 屏幕上少一个桶里的一条，一个字不报。
+ *
+ * ⚠️ **空数组和缺席在归一化之后是同一件事**（都没写分类），所以这儿把 `[]`
+ * 也收掉：下游只需要认一种「没有分类」的形状（判据同 `uploadChoiceHas` 那条
+ * 「全仓只有一处判闭集」）。
+ * ⚠️ 返回的是**新数组**（`[...category]`）而不是原来那个引用：解析产物会被缓存
+ * 下来、也可能被下游就地改动，共享一个数组的话，改一处会改到别人手里那一份。
+ */
+declare const EntrySchema: z.ZodPipe<z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     source: z.ZodString;
-    category: z.ZodOptional<z.ZodString>;
+    category: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
     keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
     author: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
@@ -8309,7 +8325,49 @@ declare const EntrySchema: z.ZodObject<{
         reviewing: "reviewing";
         offline: "offline";
     }>>>;
-}, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<{
+    category?: string[] | undefined;
+    name: string;
+    source: string;
+    description?: string | undefined;
+    keywords?: string[] | undefined;
+    author?: {
+        name: string;
+        email?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    downloads?: number | undefined;
+    likes?: number | undefined;
+    displayName?: string | undefined;
+    icon?: string | undefined;
+    version?: string | undefined;
+    changelog?: string | undefined;
+    size?: number | undefined;
+    homepage?: string | undefined;
+    visibility?: "private" | "public" | undefined;
+    status?: "rejected" | "listed" | "reviewing" | "offline" | undefined;
+}, {
+    name: string;
+    source: string;
+    description?: string | undefined;
+    category?: string | string[] | undefined;
+    keywords?: string[] | undefined;
+    author?: {
+        name: string;
+        email?: string | undefined;
+        url?: string | undefined;
+    } | undefined;
+    downloads?: number | undefined;
+    likes?: number | undefined;
+    displayName?: string | undefined;
+    icon?: string | undefined;
+    version?: string | undefined;
+    changelog?: string | undefined;
+    size?: number | undefined;
+    homepage?: string | undefined;
+    visibility?: "private" | "public" | undefined;
+    status?: "rejected" | "listed" | "reviewing" | "offline" | undefined;
+}>>;
 /**
  * 市场说了算的那几格「要不要印在屏幕上」（2026-09-10）。
  *
@@ -8341,8 +8399,9 @@ declare const DisplaySchema: z.ZodObject<{
  *
  * ## ⚠️ 条目那一侧引用的是**裸 id**，不是一条 `办公/表格` 那样的路径
  *
- * 也就是说 {@link EntrySchema} 的 `category` **一个字都没改** —— 它今天是什么形状
- * 明天还是什么形状，变的只是「那串字符现在可以被这棵树放进层级里」。两条判据：
+ * 也就是说 {@link EntrySchema} 的 `category` 里装的**仍旧是一串 id**（2026-09-28 起
+ * 是**好几个** id），不是一条 `办公/表格` 那样的路径 —— 变的只是「那些字符现在
+ * 可以被这棵树放进层级里」。两条判据：
  *
  * 1. **存量目录加一棵树不用动任何一条插件。** 一份写着 `category: "dev"` 的目录，
  *    只要在顶上补一个 `{ "id": "dev", "label": "开发" }`，那一批条目当场归位。
@@ -8374,11 +8433,11 @@ declare const CatalogSchema: z.ZodObject<{
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
     categories: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodType<MarketplaceCategoryInput, unknown, z.core.$ZodTypeInternals<MarketplaceCategoryInput, unknown>>>>>;
-    plugins: z.ZodArray<z.ZodObject<{
+    plugins: z.ZodArray<z.ZodPipe<z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         source: z.ZodString;
-        category: z.ZodOptional<z.ZodString>;
+        category: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
         keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
         author: z.ZodOptional<z.ZodObject<{
             name: z.ZodString;
@@ -8403,7 +8462,49 @@ declare const CatalogSchema: z.ZodObject<{
             reviewing: "reviewing";
             offline: "offline";
         }>>>;
-    }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodTransform<{
+        category?: string[] | undefined;
+        name: string;
+        source: string;
+        description?: string | undefined;
+        keywords?: string[] | undefined;
+        author?: {
+            name: string;
+            email?: string | undefined;
+            url?: string | undefined;
+        } | undefined;
+        downloads?: number | undefined;
+        likes?: number | undefined;
+        displayName?: string | undefined;
+        icon?: string | undefined;
+        version?: string | undefined;
+        changelog?: string | undefined;
+        size?: number | undefined;
+        homepage?: string | undefined;
+        visibility?: "private" | "public" | undefined;
+        status?: "rejected" | "listed" | "reviewing" | "offline" | undefined;
+    }, {
+        name: string;
+        source: string;
+        description?: string | undefined;
+        category?: string | string[] | undefined;
+        keywords?: string[] | undefined;
+        author?: {
+            name: string;
+            email?: string | undefined;
+            url?: string | undefined;
+        } | undefined;
+        downloads?: number | undefined;
+        likes?: number | undefined;
+        displayName?: string | undefined;
+        icon?: string | undefined;
+        version?: string | undefined;
+        changelog?: string | undefined;
+        size?: number | undefined;
+        homepage?: string | undefined;
+        visibility?: "private" | "public" | undefined;
+        status?: "rejected" | "listed" | "reviewing" | "offline" | undefined;
+    }>>>;
 }, z.core.$strip>;
 declare const RecordSchema: z.ZodObject<{
     name: z.ZodString;
@@ -8420,11 +8521,11 @@ declare const RecordSchema: z.ZodObject<{
             fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
         categories: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodType<MarketplaceCategoryInput, unknown, z.core.$ZodTypeInternals<MarketplaceCategoryInput, unknown>>>>>;
-        plugins: z.ZodArray<z.ZodObject<{
+        plugins: z.ZodArray<z.ZodPipe<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             source: z.ZodString;
-            category: z.ZodOptional<z.ZodString>;
+            category: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
             keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
             author: z.ZodOptional<z.ZodObject<{
                 name: z.ZodString;
@@ -8449,7 +8550,49 @@ declare const RecordSchema: z.ZodObject<{
                 reviewing: "reviewing";
                 offline: "offline";
             }>>>;
-        }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodTransform<{
+            category?: string[] | undefined;
+            name: string;
+            source: string;
+            description?: string | undefined;
+            keywords?: string[] | undefined;
+            author?: {
+                name: string;
+                email?: string | undefined;
+                url?: string | undefined;
+            } | undefined;
+            downloads?: number | undefined;
+            likes?: number | undefined;
+            displayName?: string | undefined;
+            icon?: string | undefined;
+            version?: string | undefined;
+            changelog?: string | undefined;
+            size?: number | undefined;
+            homepage?: string | undefined;
+            visibility?: "private" | "public" | undefined;
+            status?: "rejected" | "listed" | "reviewing" | "offline" | undefined;
+        }, {
+            name: string;
+            source: string;
+            description?: string | undefined;
+            category?: string | string[] | undefined;
+            keywords?: string[] | undefined;
+            author?: {
+                name: string;
+                email?: string | undefined;
+                url?: string | undefined;
+            } | undefined;
+            downloads?: number | undefined;
+            likes?: number | undefined;
+            displayName?: string | undefined;
+            icon?: string | undefined;
+            version?: string | undefined;
+            changelog?: string | undefined;
+            size?: number | undefined;
+            homepage?: string | undefined;
+            visibility?: "private" | "public" | undefined;
+            status?: "rejected" | "listed" | "reviewing" | "offline" | undefined;
+        }>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 type MarketplaceEntry = z.infer<typeof EntrySchema>;

package/dist/index.js

@@ -7386,11 +7386,12 @@ async function updatePlugin(name, opts) {
 }
 var MARKETPLACE_FILE = "epoch-marketplace.json";
 var NAME_PATTERN = PLUGIN_NAME_PATTERN;
-var EntrySchema = z.object({
+var EntryCategoryInput = z.union([z.string().min(1), z.array(z.string().min(1))]).optional().catch(void 0);
+var EntryShape = z.object({
   name: z.string().regex(NAME_PATTERN),
   description: z.string().min(1).optional(),
   source: z.string().min(1),
-  category: z.string().min(1).optional(),
+  category: EntryCategoryInput,
   keywords: z.array(z.string().min(1)).optional(),
   author: PluginAuthorSchema.optional(),
   downloads: z.number().int().nonnegative().optional(),
@@ -7404,6 +7405,10 @@ var EntrySchema = z.object({
   visibility: z.enum(PLUGIN_VISIBILITY).optional().catch(void 0),
   status: z.enum(["listed", "reviewing", "rejected", "offline"]).optional().catch(void 0)
 });
+var EntrySchema = EntryShape.transform(({ category, ...rest }) => {
+  const picked = category === void 0 ? [] : typeof category === "string" ? [category] : category;
+  return { ...rest, ...picked.length === 0 ? {} : { category: [...picked] } };
+});
 var MARKETPLACE_DISPLAY_FIELDS = [
   "status",
   "downloads",
@@ -7554,7 +7559,7 @@ function searchMarketplaces(keyword, statePath) {
       const haystack = [
         entry.name,
         entry.description ?? "",
-        entry.category ?? "",
+        ...entry.category ?? [],
         entry.author?.name ?? "",
         ...entry.keywords ?? []
       ].join(" ").toLowerCase();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/core",
-  "version": "0.19.0",
+  "version": "0.20.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/protocol": "0.19.0",
-    "@epoch-agent/infra": "0.19.0"
+    "@epoch-agent/infra": "0.20.0",
+    "@epoch-agent/protocol": "0.20.0"
   },
   "devDependencies": {
     "@ai-sdk/amazon-bedrock": "^5.0.40",