@sema-agent/server 7.43.0 → 7.44.0

package/dist/plugins/roster-store-sql.js

@@ -1,8 +1,5 @@
 import { normalizeAgentName } from "@sema-agent/core";
 export const ROSTER_TABLE = "agent_roster";
-/** 行 → RosterEntry(缺席键省略,core 形逐字;session_scoped 数值/布尔双方言归一)。
- *  core 1.365 BREAKING:owner/scope 升类型必填——两方言 CREATE 直接建成 NOT NULL(当年的「清死行 +
- *  MODIFY/SET NOT NULL」运行期迁移腿已折进建表,由来见两 ensure 上方顶注 ①),故此处直取不条件展开。 */
 function rowToEntry(r) {
     return {
         name: String(r.name),
@@ -14,57 +11,14 @@ function rowToEntry(r) {
         ...(r.session_scoped !== null && r.session_scoped !== undefined ? { sessionScoped: Boolean(Number(r.session_scoped)) || r.session_scoped === true } : {}),
         ...(r.root_session_id !== null && r.root_session_id !== undefined ? { rootSessionId: String(r.root_session_id) } : {}),
         ...(r.model !== null && r.model !== undefined ? { model: String(r.model) } : {}),
-        // core 5.10.0 additive:modelFallback(请求词未绑臂,子代跑在继承默认上)——现词表单成员;等值守卫
-        // 而非裸 String cast:core 若扩成员,这里 tsc 先红(勿静默放行未知词进 RosterEntry 窄类型)。
         ...(r.model_fallback === "inherit_no_tier_binding" ? { modelFallback: "inherit_no_tier_binding" } : {}),
         createdAt: Number(r.created_at_ms),
     };
 }
-// F2(发版复审):TiDB 表级 COLLATE utf8mb4_bin / PG 授权列 COLLATE "C"——'=' 恢复字节等价(JS 严格
-// 相等同义),大小写/重音/PAD 近撞值不再穿过谓词;真库混合大小写+尾空格案钉住。
-/** resolve 的 access 谓词(两方言同形,占位符各自)——core 1.365 A-2 终态:**default-deny 双轴**
- *  (entryAccessible 新极性,旧「缺轴=放行」两支已删)。scope 轴:`scope = :accessScope` 硬等——行值
- *  NULL(前代残行)或 access.scope 缺席(参数 NULL,`= NULL` 恒假)都拒 ✓。owner 轴:相等,或
- *  sessionScoped 显式真且 owner=access.sessionId;owner NULL 行两支 `= NULL` 恒假=拒 ✓。
- *  全部在查询内完成(语义条 1)。
- *  ⚠️ 上面两处「行值 NULL」现在只是**推理留档**:两列自建表起 NOT NULL,行值侧 NULL 结构上不可能
- *  (顶注 ③);仍然可达的是**参数侧** NULL —— access 缺 scope/owner 时 `= NULL` 恒假 = default-deny。 */
-// 数据列(owner/scope)仍是 VARCHAR——谓词一侧 CAST 为 BINARY 即整个比较按字节(残余过滤行数极小,
-// 无索引损耗;主过滤=VARBINARY name_key PK 前缀)。
 const RESOLVE_WHERE_TIDB = `name_key = ? AND BINARY scope = ? AND (BINARY owner = ? OR (session_scoped = 1 AND ? IS NOT NULL AND BINARY owner = ?))`;
 const RESOLVE_WHERE_PG = `name_key = $1 AND scope = $2 AND (owner = $3 OR (session_scoped = 1 AND $4::varchar IS NOT NULL AND owner = $5))`;
-// core 1.373 additive:RosterEntry.model(spawn 记录的解析后模型 id)——列投影型 store 必须显式接
-// (File/Memory 后端整对象持久化天然保住;列白名单剥键=SDK 0.0.72 中继剥键同族教训,发车复审抓获)。
 const COLS = "name, agent_id, session_id, tool_use_id, owner, scope, session_scoped, root_session_id, model, model_fallback, created_at_ms";
-/* ┌─ 历史:曾经的运行期迁移腿(已折进 CREATE,2026-07-26 clay 裁「删库重建」)────────────────────┐
- * 本文件的两个 ensure 曾在每次 boot 跑三族迁移语句,现已全部折叠为 CREATE TABLE 里的列定义。
- * 保留由来,因为它解释了这些列**为什么长这样**,以及当年为什么不能只写一条 CREATE:
- *
- * ① owner / scope 曾是 nullable(1.247 及更早的 `agent_roster`)。core 1.365 BREAKING(本仓
- *    commit `1172f31`,[1509] 对表)把注册面改成 **default-deny 双轴**:缺轴行在新谓词下永不可达
- *    (resolve 恒拒)= 死行。于是当年的 ensure 必须先 `DELETE … WHERE owner IS NULL OR scope IS NULL`
- *    再 `MODIFY/SET … NOT NULL`——带数据的收紧遇 NULL 会**砖 boot**,清完才幂等。
- *    ⚠️ 该迁移腿有一个真实的**滚动升级窗**(当年复审 #1 如实记):共库上仍在跑的 1.247 旧副本此后写
- *    缺轴条目会撞 NOT NULL 约束错——core 调用侧 record 有 catch 兜底,窗内退化为该条 roster-miss、
- *    不崩;而 DELETE→ALTER 之间旧副本恰好插入一行 NULL,会砖**当次** ALTER(boot 失败),下次 boot
- *    再清即自愈。BREAKING 当年在 CHANGELOG 声明整队同拍升级。
- *    → 删库重建口径下这个窗**消失**:两列自建表起即 NOT NULL,不存在「先有 NULL 行再收紧」的时刻;
- *      那条 DELETE 也结构上删不到任何行(NOT NULL 列不可能有 NULL 值),删之无损。
- *
- * ② root_session_id(core 1.367 δ)/ model(core 1.373)曾靠**探针式 ADD COLUMN** 补进存量表:
- *    先查 information_schema.COLUMNS、缺了才 ALTER。之所以不用 `ADD COLUMN IF NOT EXISTS`,是因为
- *    MySQL 8 没有该语法(TiDB/MariaDB 才有),而本仓 MySQL-protocol 口径要求可移植
- *    (tidb-pool.ts COLUMN_MIGRATIONS 同姿势;PG 腿则直接用 IF NOT EXISTS)。
- *    → 新库 CREATE 已带列,探针恒 no-op,连同 ALTER 一并删。
- *
- * ③ 语义位:当年 `model IS NULL` 兼有「pre-1.373 行」一义。删库重建后**不再产生**这类行——NULL 只
- *    剩「该 spawn 没记录模型」一义(RosterEntry.model 本就可选)。读侧的条件展开分支({@link rowToEntry}
- *    里 root_session_id / model 两支)因此仍然可达,**不动**;同理 RESOLVE_WHERE_* 谓词里
- *    「行值 NULL ⇒ `= NULL` 恒假」那一层推理只对 **参数侧** NULL(access 缺轴)仍成立,行值侧已结构不可能。
- * └────────────────────────────────────────────────────────────────────────────────────────────┘ */
 export async function ensureTiDBRosterSchema(pool) {
-    // VARBINARY 键列(F2 终形):`utf8mb4_bin` 仍是 PAD SPACE collation——VARCHAR '=' 尾空格填充,
-    // 'x' 与 'x ' 同键/同谓词命中(真库红实测)。VARBINARY 比较=纯字节,upsert 域键与授权谓词双正。
     await pool.query(`CREATE TABLE IF NOT EXISTS ${ROSTER_TABLE} (
     name_key VARBINARY(190) NOT NULL,
     owner_key VARBINARY(190) NOT NULL,
@@ -90,8 +44,6 @@ export async function ensureTiDBRosterSchema(pool) {
   ) COLLATE utf8mb4_bin`);
 }
 export async function ensurePgRosterSchema(q) {
-    // COLLATE "C"(F2 双方言对齐):授权谓词列的 '=' 必须是字节等价——数据库缺省 collation 若非确定性/
-    // 大小写不敏感,近撞 scope/owner 会穿过 in-query access 过滤(信任边界弱化)。
     await q(`CREATE TABLE IF NOT EXISTS ${ROSTER_TABLE} (
     name_key VARCHAR(190) COLLATE "C" NOT NULL,
     owner_key VARCHAR(190) COLLATE "C" NOT NULL,
@@ -116,7 +68,6 @@ export async function ensurePgRosterSchema(q) {
   )`);
     await q(`CREATE INDEX IF NOT EXISTS idx_roster_agent ON ${ROSTER_TABLE} (agent_id)`);
 }
-/** upsert 参数序(两方言共用;core 1.365 起 owner/scope 类型必填——键列直取,与 core upsertKey 同键)。 */
 function upsertParams(entry, now) {
     return [
         normalizeAgentName(entry.name),
@@ -128,8 +79,6 @@ function upsertParams(entry, now) {
         entry.toolUseId ?? null,
         entry.owner,
         entry.scope,
-        // TINYINT(1) 归一(clay 批 2026-07-26):写入参双方言统一 0/1(PG 列已 SMALLINT,裸 boolean 参数
-        // 会在 'true'::smallint 上炸;MySQL TINYINT 本就收 0/1)。三态保留:undefined → NULL。
         entry.sessionScoped === undefined ? null : entry.sessionScoped ? 1 : 0,
         entry.rootSessionId ?? null,
         entry.model ?? null,
@@ -167,9 +116,6 @@ export class TiDBRosterStore {
     async releaseAgent(agentId) {
         await this.pool.query(`DELETE FROM ${ROSTER_TABLE} WHERE agent_id = ?`, [agentId]);
     }
-    /** [1522] MED2(server 扩展,非 core 接口;core RB-23②③ 派给部署的清理半场):TTL 清理——
-     *  task-scoped 具名 spawn 的 owner=宿主 taskId=每 run 一新行,无清理=线性无界。按 recorded_at_ms
-     *  (最后一次 upsert 触碰)删,latest 语义不受影响(活跃名恒被新 spawn 刷新)。 */
     async reapOlderThan(cutoffMs) {
         const [res] = (await this.pool.query(`DELETE FROM ${ROSTER_TABLE} WHERE recorded_at_ms < ?`, [cutoffMs]));
         return res.affectedRows;
@@ -204,7 +150,6 @@ export class PgRosterStore {
     async releaseAgent(agentId) {
         await this.q(`DELETE FROM ${ROSTER_TABLE} WHERE agent_id = $1`, [agentId]);
     }
-    /** [1522] MED2(TiDB twin 同案注)。 */
     async reapOlderThan(cutoffMs) {
         const { rows } = await this.q(`DELETE FROM ${ROSTER_TABLE} WHERE recorded_at_ms < $1 RETURNING agent_id`, [cutoffMs]);
         return rows.length;