@epoch-agent/server 0.22.0 → 0.23.0

package/README.md

@@ -849,9 +849,12 @@ POST /api/sessions/abc/permission?lang=zh    → 错误消息也跟着这个语
 > `capability.ts` 答的是「那三栏取什么数」，这一条答的是「怎么建一个身份」）。
 
 能力页三栏里最后一个补上的写口 —— 在这条之前，全仓没有任何一条写角色的路。
-请求体是 `{name, description, prompt?, tools?, maxTurns?}`，**和角色文件的
-frontmatter 逐格对上**（`mcp.json` 那条刻意收窄，这一条刻意不收：角色文件认得的
-键总共就四个，砍掉任何一个都会让「从界面建的」和「手写的」变成两种东西）。
+请求体是 `{name, description, displayName?, prompt?, tools?, skills?, maxTurns?}`，
+**和角色文件的 frontmatter 逐格对上**（`mcp.json` 那条刻意收窄，这一条刻意不收：
+角色文件认得的键总共就那几个，砍掉任何一个都会让「从界面建的」和「手写的」变成
+两种东西）。⚠️ `displayName` 是 2026-10-08 跟着 `AgentRole.displayName` 一起加的
+（「要么连表单一起加，要么别加」——`skills` 刚还过这笔账），空白串在 core 归一成
+「没写」。
 
 ##### ⚠️ 闸门：绑在回环之外（`--host 0.0.0.0`）时**一律 403，一个字节都不写**
 

package/dist/index.d.ts

@@ -478,6 +478,8 @@ type McpAddResultView = {
  */
 interface RoleAddView {
     name: string;
+    /** 给人看的称呼（`RoleAddInput.displayName`，2026-10-08）。这一层原样透传 */
+    displayName?: string;
     description: string;
     prompt?: string;
     tools?: readonly string[];
@@ -957,6 +959,16 @@ interface SkillStageControlView {
  */
 interface RoleView {
     name: string;
+    /**
+     * 给人看的称呼（`AgentRole.displayName`，2026-10-08）。
+     *
+     * ⚠️ **镜像上漏掉这一格不会红**，判据逐字同下面 `skills` 那一条：真源上它是
+     * 可选的，少声明照样满足这份镜像，表现只是 `toWireRole()` 一声不吭地读不到
+     * 它 —— 而这一格是「带前缀的插件 / 宿主身份在屏幕上能不能印成人话」的唯一来源。
+     * 加它的时候**没有编译器会提醒**，所以往 `AgentRole` 上加展示类字段的人
+     * 要自己回来补这儿。
+     */
+    displayName?: string;
     description: string;
     tools?: readonly string[];
     /**
@@ -3223,6 +3235,8 @@ interface DependencyView {
     requiredBy: string;
     source?: string;
     reason?: string;
+    /** 清单里的 `displayName`。`unresolved` 那一档没有 —— 那个包没取到 */
+    displayName?: string;
     versionUnmet?: {
         required: string;
         current: string;

package/dist/index.js

@@ -1136,6 +1136,7 @@ function toWireRole(role, notices) {
   const cutOf = (kind) => notices.find((n) => n.role === role.name && n.kind === kind)?.cut ?? [];
   return {
     name: role.name,
+    displayName: role.displayName ?? null,
     description: role.description,
     source: role.source,
     tools: role.tools ?? null,
@@ -3438,6 +3439,7 @@ function toWireDependency(dep) {
     requiredBy: dep.requiredBy,
     source: dep.source ?? null,
     reason: dep.reason ?? null,
+    displayName: dep.displayName ?? null,
     version: dep.manifest?.version ?? null,
     versionUnmet: dep.versionUnmet ?? null,
     inventory: inventory ? {
@@ -3883,6 +3885,7 @@ async function addRole(ctx, req, res, lang) {
   const outcome = ctx.runtime.roleWrite.add(
     {
       name: typeof payload["name"] === "string" ? payload["name"].trim() : "",
+      ...typeof payload["displayName"] === "string" ? { displayName: payload["displayName"] } : {},
       description: typeof payload["description"] === "string" ? payload["description"].trim() : "",
       ...typeof payload["prompt"] === "string" ? { prompt: payload["prompt"] } : {},
       ...Array.isArray(payload["tools"]) ? { tools: stringList2(payload["tools"]) } : {},