@chenkai114/dsh-team-admin 0.1.9 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenkai114/dsh-team-admin",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "description": "DSH 插件：GUI 管理任意会话的智能体团队 —— 查看成员、删除角色并清理其持久会话（进回收站，可恢复）",
   "type": "module",
   "main": "src/index.js",
@@ -55,4 +55,4 @@
     "test:real": "node tests/e2e/real-data.mjs",
     "test:pack": "npm pack --dry-run"
   }
-}
+}

package/src/api.mjs

@@ -79,7 +79,8 @@ export function createApi({ ctx, getStore, version, logSystem, services }) {
 
       if (path === '/api/team-admin/health') {
         if (method !== 'GET') { sendJson(res, 405, { error: '请求方法不支持' }); return }
-        sendJson(res, 200, { ok: true, name: 'team-admin', version })
+        const budget = typeof services.readRosterBudget === 'function' ? services.readRosterBudget() : null
+        sendJson(res, 200, { ok: true, name: 'team-admin', version, maxMembers: budget === null ? null : budget.maxMembers })
         return
       }
 
@@ -132,6 +133,7 @@ export function createApi({ ctx, getStore, version, logSystem, services }) {
           { sessionId, name, deleteSession: body.deleteSession !== false },
           { store, logSystem },
         )
+        if (typeof services.onMemberDismissed === 'function') services.onMemberDismissed()
         sendJson(res, 200, { ok: true, ...result })
         return
       }

package/src/index.js

@@ -21,12 +21,15 @@ const ROUTE_PREFIX = '/api/team-admin'
 const DISMISSED_TTL_MS = 2000
 /** 包装标记：apply 与延迟注入可能都执行一次，避免重复包装。 */
 const FILTER_MARK = Symbol.for('dsh.team-admin.projection-filter')
+/** roster 预算标记与刷新句柄：名额 = 配置上限 + 已删除成员数。 */
+const ROSTER_MARK = Symbol.for('dsh.team-admin.roster-budget')
+const ROSTER_REFRESH = Symbol.for('dsh.team-admin.roster-refresh')
 /** 单值出口：一次请求/一次流的快照。 */
 const UNARY_METHODS = ['list', 'projections']
 /** 流出口：control 基线携带全部投影，follow 携带单个会话的开场快照。 */
 const STREAM_METHODS = ['control', 'follow']
 /** 与 package.json 版本保持一致（发布前由测试校验）。 */
-const PLUGIN_VERSION = '0.1.9'
+const PLUGIN_VERSION = '0.2.1'
 
 /**
  * 解析插件数据目录。
@@ -41,7 +44,7 @@ export function resolveDataDir(env = process.env, home = homedir()) {
 }
 
 /**
- * 装配插件：惰性建 store，注册一条 prefix 路由，并给投影出口加过滤。
+ * 装配插件：惰性建 store，注册一条 prefix 路由；再给投影出口与成员名额加补丁。
  * @param {object} ctx - Cordis 插件上下文。
  */
 export function apply(ctx) {
@@ -59,23 +62,40 @@ export function apply(ctx) {
   const logSystem = (line) => {
     if (typeof ctx.logger?.warn === 'function') ctx.logger.warn(line)
   }
+  const ensureBudget = () => installRosterBudget(ctx, { getStore, logSystem, silent: true })
+  // 诊断用：读当前生效的成员上限（配置上限 + 已回收名额）。
+  const readRosterBudget = () => {
+    const service = typeof ctx.get === 'function' ? ctx.get('agentTeams') : undefined
+    const roster = service === null || service === undefined ? undefined : service.roster
+    return roster !== undefined && roster !== null && typeof roster.maxMembers === 'number' ? { maxMembers: roster.maxMembers } : null
+  }
   const handler = createApi({
     ctx,
     getStore,
     version: PLUGIN_VERSION,
     logSystem,
-    services: { listTeamSessions, readTeam, dismissMember },
+    services: {
+      listTeamSessions,
+      readTeam,
+      dismissMember,
+      // 删除成功后释放名额：名额外加数 = 墓碑数。
+      onMemberDismissed: () => { void ensureBudget()?.() },
+      readRosterBudget,
+    },
   })
   ctx.effect(
     () => ctx.webServer.register({ kind: 'prefix', path: ROUTE_PREFIX, handler }),
     'team-admin routes',
   )
+  ensureBudget()
+  if (typeof ctx.inject === 'function') {
+    ctx.inject(['agentTeams'], (sub) => installRosterBudget(sub, { getStore, logSystem }))
+  }
   if (!installSessionListFilter(ctx, { getStore, logSystem, silent: true }) && typeof ctx.inject === 'function') {
     // 插件可能早于 sessionController 注册；等服务可用后再包一次。
     ctx.inject(['sessionController'], (sub) => installSessionListFilter(sub, { getStore, logSystem }))
   }
 }
-
 /**
  * 建一个带短缓存的墓碑 id 读取器。
  * @param {() => Promise<object>} getStore - 惰性打开的状态存储。
@@ -148,3 +168,40 @@ export function installSessionListFilter(ctx, { getStore, logSystem, silent = fa
   service[FILTER_MARK] = true
   return true
 }
+
+/**
+ * 把「已删除成员」占掉的名额还给 roster：宿主用 roster 的 append-only 成员数判断 maxMembers，
+ * 删除只写墓碑不删记录，所以这里把上限动态抬到 `配置上限 + 墓碑数`。
+ * @param {object} ctx - Cordis 插件上下文。
+ * @param {{ getStore: () => Promise<object>, logSystem: (line: string) => void, silent?: boolean }} deps - 存储与日志。
+ * @returns {null | (() => Promise<number>)} 刷新预算的函数；宿主没有 agentTeams 时返回 null。
+ */
+export function installRosterBudget(ctx, { getStore, logSystem, silent = false }) {
+  const get = ctx !== null && typeof ctx?.get === 'function' ? ctx.get.bind(ctx) : null
+  const service = get === null ? undefined : get('agentTeams')
+  const roster = service === null || service === undefined ? undefined : service.roster
+  if (roster === undefined || roster === null || typeof roster.maxMembers !== 'number') {
+    if (silent !== true) logSystem('team-admin：未找到 agentTeams.roster，跳过名额回收')
+    return null
+  }
+  if (roster[ROSTER_MARK] === true) return roster[ROSTER_REFRESH]
+  const base = roster.maxMembers
+  const budget = { extra: 0 }
+  Object.defineProperty(roster, 'maxMembers', {
+    configurable: true,
+    enumerable: true,
+    get: () => base + budget.extra,
+  })
+  roster[ROSTER_MARK] = true
+  roster[ROSTER_REFRESH] = async () => {
+    try {
+      const store = await getStore()
+      budget.extra = collectDismissedIds(await store.readAll()).size
+    } catch (error) {
+      logSystem(`team-admin：读取墓碑失败，名额不回收（${error instanceof Error ? error.message : String(error)}）`)
+    }
+    return budget.extra
+  }
+  void roster[ROSTER_REFRESH]()
+  return roster[ROSTER_REFRESH]
+}