@sema-agent/server 7.139.0 → 7.140.0

package/dist/plugins/schema-consistency.d.ts

@@ -50,7 +50,7 @@
  */
 import type { Pool as MysqlPool } from "mysql2/promise";
 import type { Pool as PgPool } from "pg";
-import { type SchemaDialect } from "./schema-ensure-legs.js";
+import type { SqlDialect } from "./sql-driver.js";
 import { type SchemaProbeRead } from "./schema-live-columns.js";
 import { StoreBootRefusalError } from "./store-contracts.js";
 /** 一列:名字 + 它在 `CREATE TABLE` 里的**原样定义文本**(生成 ADD COLUMN 指路用,不另手写)。 */
@@ -72,7 +72,7 @@ export interface ParsedTable {
  */
 export declare function parseCreateTable(stmt: string): ParsedTable | undefined;
 /** 启动时真会建出来的**全部**表形(录制 → 解析)。同名表二次出现以**先到**为准(`IF NOT EXISTS` 的真语义)。 */
-export declare function expectedTableShapes(dialect: SchemaDialect): Promise<Map<string, ParsedTable>>;
+export declare function expectedTableShapes(dialect: SqlDialect): Promise<Map<string, ParsedTable>>;
 /** 拒启码(机读)。附录 A / 拒启码表的登记名。 */
 export declare const SCHEMA_MISMATCH_ERROR_CODE = "config.schema_mismatch";
 /** 一张表的对账结论。 */
@@ -96,13 +96,13 @@ export declare function diffSchema(expected: Map<string, ParsedTable>, live: Map
  */
 export declare function describeMismatchedTables(mismatches: readonly TableMismatch[]): string[];
 /** 拒启文案(表头 + 逐表段与闭集三条出路 {@link describeMismatchedTables})。 */
-export declare function describeSchemaMismatch(dialect: SchemaDialect, mismatches: readonly TableMismatch[]): string;
+export declare function describeSchemaMismatch(dialect: SqlDialect, mismatches: readonly TableMismatch[]): string;
 /**
  * 启动期对账:**建表之后**跑,不符即抛(= 拒启)。两方言 + InnoDB 同腿(MySQL 协议共用 `mysql` 臂)。
  *
  * 失败方向见文件头注:读抛 / 整库零行 ⇒ 拒。
  */
-export declare function assertSchemaMatchesCode(read: SchemaProbeRead, dialect: SchemaDialect): Promise<void>;
+export declare function assertSchemaMatchesCode(read: SchemaProbeRead, dialect: SqlDialect): Promise<void>;
 /**
  * 跳版升级的库的拒启:退役 schema(快照索引表 / 单座列)任一仍在。**具名类型**:锚类型不锚文案(日志消费端与测试按 `code` / 类型分派);
  * 码取列册对账同一个 `config.schema_mismatch`,运维面一个拒启码一个读法。拒句点名在场的坐标、说明第三条(旧拼法改写)同样没跑过、给出路。
@@ -119,10 +119,10 @@ export declare class RetiredSchemaPresentError extends StoreBootRefusalError {
  * 快照索引表 / 单座列任一在场 ⇒ 抛 {@link RetiredSchemaPresentError}。新库(建表之前一列都没有)⇒ 不在场、过。读抛 ⇒ 原样上抛(拒启;不是确定的拒启表态,
  * 开库等待窗照常重试 —— 与修前两条目录探针抛出时同一个去向)。
  */
-export declare function assertRetiredSchemaAbsent(read: SchemaProbeRead, dialect: SchemaDialect): Promise<void>;
+export declare function assertRetiredSchemaAbsent(read: SchemaProbeRead, dialect: SqlDialect): Promise<void>;
 /** 探针口的池参数:方言与它的池一起走(判别联合 ⇒ 不靠调用方断言「这个池是哪种」)。 */
 export type RetiredSchemaProbeTarget = {
-    readonly dialect: "tidb";
+    readonly dialect: "mysql";
     readonly pool: MysqlPool;
 } | {
     readonly dialect: "pg";

package/dist/plugins/schema-consistency.js

@@ -199,7 +199,7 @@ export async function assertRetiredSchemaAbsent(read, dialect) {
         throw new RetiredSchemaPresentError(found);
 }
 export async function assertRetiredSchemaAbsentOnPool(target) {
-    if (target.dialect === "tidb") {
+    if (target.dialect === "mysql") {
         const conn = await target.pool.getConnection();
         try {
             await assertRetiredSchemaAbsent(async (sql) => (await conn.query(sql))[0], "mysql");

package/dist/plugins/schema-ensure-legs.d.ts

@@ -1,6 +1,5 @@
 import type { PgQueryFn } from "./pg-query.js";
-/** 录制的方言。`mysql` = MySQL 协议(TiDB / InnoDB 同腿),`pg` = PostgreSQL。 */
-export type SchemaDialect = "mysql" | "pg";
+import type { SqlDialect } from "./sql-driver.js";
 /** advisory lock 语句 —— 与 schema 无关,录制时跳过(但要答成功,否则 ensure* 走降级告警路径)。 */
 export declare const LOCK_RE: RegExp;
 /**
@@ -51,5 +50,5 @@ export declare const DRIVEN_ENSURES: {
     readonly pg: readonly string[];
 };
 /** 跑一遍一条方言的真 `ensure*` 全腿,返回**录制到的语句流**(顺序即执行顺序)。纯内存,不碰数据库。 */
-export declare function recordEnsureStatements(dialect: SchemaDialect): Promise<string[]>;
+export declare function recordEnsureStatements(dialect: SqlDialect): Promise<string[]>;
 //# sourceMappingURL=schema-ensure-legs.d.ts.map

package/dist/plugins/schema-ensure-legs.js

@@ -6,10 +6,10 @@ import { ensurePgMemoryEmbedderMetaSchema } from "./memory-embedder-fingerprint.
 import { ensureTiDBMemorySyncSchema, ensureTiDBMemoryHistorySchema } from "./memory-sync-store-tidb.js";
 import { ensurePgMemorySyncSchema, ensurePgMemoryHistorySchema } from "./memory-sync-store-pg.js";
 import { ensureTiDBRosterSchema, ensurePgRosterSchema } from "./roster-store-sql.js";
-import { ensureTiDBBackgroundAgentSchema, ensurePgBackgroundAgentSchema } from "./background-agent-store-sql.js";
+import { ensureTiDBBackgroundAgentSchema, ensurePgBackgroundAgentSchema } from "../stores-sql/background-agent-store-sql.js";
 import { ensureTiDBMailboxSchema, ensurePgMailboxSchema } from "./mailbox-store-sql.js";
 import { ensureTiDBTaskAttachmentSchema, ensurePgTaskAttachmentSchema } from "./task-attachment-store.js";
-import { ensureTiDBUsageWindowSchema, ensurePgUsageWindowSchema } from "./usage-window-store-sql.js";
+import { ensureTiDBUsageWindowSchema, ensurePgUsageWindowSchema } from "../stores-sql/usage-window-store-sql.js";
 import { ensureTiDBTaskListSchema, ensurePgTaskListSchema } from "./task-list-store-sql.js";
 import { ensureTiDBDeviceSchema, ensurePgDeviceSchema } from "./device-store-sql.js";
 export const LOCK_RE = /GET_LOCK|RELEASE_LOCK|pg_(try_)?advisory/i;

package/dist/plugins/schema-live-columns.d.ts

@@ -3,7 +3,7 @@
  * 缺这条索引的列」也读它)。叶子模块:不值依赖任何模块(列册探针那边经录制驱动 / 建表腿值依赖 `ensure-index.ts`,读者若住在那边,
  * `ensure-index.ts` 读它就是一个运行时环)。方言词是 `ensure-index.ts` 的闭集(类型边,擦除)。
  */
-import type { SqlDialect } from "./ensure-index.js";
+import type { SqlDialect } from "./sql-driver.js";
 /** 探针读口:一条 SQL → 行数组(两方言由调用方各自绑)。 */
 export type SchemaProbeRead = (sql: string) => Promise<Array<Record<string, unknown>>>;
 /**

package/dist/plugins/session-capture-record-store-sql.js

@@ -83,7 +83,7 @@ export class SqlSessionCaptureRecordStore {
 }
 export class TiDBSessionCaptureRecordStore extends SqlSessionCaptureRecordStore {
     constructor(pool) {
-        super(mysqlDriver(pool), "tidb");
+        super(mysqlDriver(pool), "mysql");
     }
 }
 export class PgSessionCaptureRecordStore extends SqlSessionCaptureRecordStore {

package/dist/plugins/session-rules-column.d.ts

@@ -10,7 +10,7 @@
  */
 export declare const SESSION_RULES_COLUMN: {
     readonly name: "rule_entries";
-    readonly tidb: "rule_entries JSON NOT NULL";
+    readonly mysql: "rule_entries JSON NOT NULL";
     readonly pg: "rule_entries JSONB NOT NULL";
 };
 //# sourceMappingURL=session-rules-column.d.ts.map

package/dist/plugins/session-rules-column.js

@@ -1,6 +1,6 @@
 export const SESSION_RULES_COLUMN = {
     name: "rule_entries",
-    tidb: "rule_entries JSON NOT NULL",
+    mysql: "rule_entries JSON NOT NULL",
     pg: "rule_entries JSONB NOT NULL",
 };
 //# sourceMappingURL=session-rules-column.js.map

package/dist/plugins/session-workspace-cell.d.ts

@@ -3,7 +3,7 @@ import { type JsonColumnReader } from "./sql-json-column.js";
 /** 列定义的唯一属主(两方言 DDL 内插它;存量库缺这一列 ⇒ 起服列册对账拒启,拒句里的 ALTER 由建表语句生成)。 */
 export declare const SESSION_META_WORKSPACE_COLUMN: {
     readonly name: "workspace";
-    readonly tidb: "workspace JSON NULL";
+    readonly mysql: "workspace JSON NULL";
     readonly pg: "workspace JSONB";
 };
 /** 这一格的形读者(三只店与帧投影同一只;写前也过它 —— 写得进的就是读得出的)。 */

package/dist/plugins/session-workspace-cell.js

@@ -4,7 +4,7 @@ import { recordFailOpen } from "../observability/fail-open.js";
 import { assertJsonColumnWritable, createZodColumnReader, decodeJsonColumn, isJsonColumnBodyProblem } from "./sql-json-column.js";
 export const SESSION_META_WORKSPACE_COLUMN = {
     name: "workspace",
-    tidb: "workspace JSON NULL",
+    mysql: "workspace JSON NULL",
     pg: "workspace JSONB",
 };
 const SESSION_WORKSPACE_SHAPE = z.object({

package/dist/plugins/shared-memory-store-sql.js

@@ -106,8 +106,8 @@ export class SqlSharedMemoryStore {
         this.now = opts.now ?? Date.now;
         this.maxListLimit = opts.maxListLimit ?? DEFAULT_MAX_LIST_LIMIT;
     }
-    q(tidb, pg) {
-        return this.db.dialect === "tidb" ? tidb : pg;
+    q(mysql, pg) {
+        return this.db.dialect === "mysql" ? mysql : pg;
     }
     async snapshot(ctx, opts) {
         throwIfAborted(opts.signal);

package/dist/plugins/sql-driver.d.ts

@@ -68,7 +68,7 @@
  * ─────────────────────────────────────────────────────────────────────────────────────────────────
  * Reference collapses: image-bake-store-sql.ts (class + transactions) and checkpoint-store-sql.ts
  * (class, no transactions). Function-style stores follow task-list-store-sql.ts instead (inline
- * `dialect === "tidb" ? … : …` ternaries, no driver object) — pick the shape the pair already has.
+ * `dialect === "mysql" ? … : …` ternaries, no driver object) — pick the shape the pair already has.
  *
  * STEPS
  *  1. Read BOTH twins end to end first. List every method and mark it identical / SQL-text-only /
@@ -79,7 +79,7 @@
  *  3. Per statement, write BOTH texts at the call site via a 2-arg `q(tidbSql, pgSql)` helper.
  *     Never build one text with a placeholder-numbering loop — the point is that a reviewer sees
  *     the two statements adjacent.
- *  4. Genuinely-divergent algorithms get an `if (dialect === "tidb") { … } else { … }` block with a
+ *  4. Genuinely-divergent algorithms get an `if (dialect === "mysql") { … } else { … }` block with a
  *     🔴 comment saying WHY both are correct. Never "unify" them by picking one engine's algorithm.
  *  5. Old files become thin re-export shims. Class names, ctor arity, exported constants/types and
  *     helper names stay EXACTLY as they were — consumers and tests must not move.
@@ -98,7 +98,7 @@
  *   (pgSafeJsonStringify / pgProtocolJsonStringify / pgSanitizeText / pgHasUnstorable) · DDL. Each arm's
  *   BEHAVIOR (what pgSafeJsonStringify/pgProtocolJsonStringify actually do to the bytes) stays written out
  *   in `pg-safe-json.ts`, untouched — `dialectJsonEncoder`/`dialectProtocolJsonEncoder` below ([ref]
- *   redesign①) only collect the identical `dialect === "tidb" ? JSON.stringify(v) : pgSafe…(v)` DISPATCH
+ *   redesign①) only collect the identical `dialect === "mysql" ? JSON.stringify(v) : pgSafe…(v)` DISPATCH
  *   ternary that five call sites duplicated verbatim; they are not a new abstraction over the encodings
  *   themselves, so this does not violate the rule above.
  *
@@ -112,7 +112,12 @@
 import type { Pool as MySqlPool } from "mysql2/promise";
 import type { Pool as PgPool } from "pg";
 import type { Logger } from "../observability/logger.js";
-export type SqlDialect = "tidb" | "pg";
+/**
+ * SQL **文本**的语法族(调用方说,不探):`mysql` = MySQL 协议(TiDB / MySQL InnoDB / MariaDB 同一套语句),`pg` = PostgreSQL。
+ * 与 `@sema-agent/core-stores-sql` 公面的 `SqlDialect` 同词同集 —— 部署词 / 引擎词都不是它的别名:谁在答是另一轴 {@link SqlEngine}(驱动探)。
+ * 本仓只这一份方言闭集(加腿 = 编译错,不是运行期的 `default` 臂)。
+ */
+export type SqlDialect = "mysql" | "pg";
 export type SqlRow = Record<string, unknown>;
 /** Normalized statement result: `rows` for SELECTs, `affected` for INSERT/UPDATE/DELETE. */
 export interface SqlResult {
@@ -337,7 +342,7 @@ export declare function sqlWallsOf(engine: SqlEngineReading | undefined): SqlWal
  * 放在某一只店里会让下一个需要它的店要么 import 一整只无关的店、要么自己抄一份(抄出来的两份会漂)。
  */
 export declare const SQL_DB_NOW_MS: {
-    readonly tidb: "CAST(UNIX_TIMESTAMP(NOW(3)) * 1000 AS SIGNED)";
+    readonly mysql: "CAST(UNIX_TIMESTAMP(NOW(3)) * 1000 AS SIGNED)";
     readonly pg: "(EXTRACT(EPOCH FROM clock_timestamp()) * 1000)::bigint";
 };
 /**

package/dist/plugins/sql-driver.js

@@ -48,7 +48,7 @@ export function sqlWallsOf(engine) {
     switch (engine.dialect) {
         case "pg":
             return NO_WALLS;
-        case "tidb":
+        case "mysql":
             return SQL_FACTS_ABSENT_WALLS;
         default: {
             const unhandled = engine.dialect;
@@ -57,11 +57,11 @@ export function sqlWallsOf(engine) {
     }
 }
 export const SQL_DB_NOW_MS = {
-    tidb: "CAST(UNIX_TIMESTAMP(NOW(3)) * 1000 AS SIGNED)",
+    mysql: "CAST(UNIX_TIMESTAMP(NOW(3)) * 1000 AS SIGNED)",
     pg: "(EXTRACT(EPOCH FROM clock_timestamp()) * 1000)::bigint",
 };
 export async function sqlDbNowMs(db, subject) {
-    const sql = db.dialect === "tidb" ? `SELECT ${SQL_DB_NOW_MS.tidb} AS db_now_ms` : `SELECT ${SQL_DB_NOW_MS.pg} AS db_now_ms`;
+    const sql = `SELECT ${SQL_DB_NOW_MS[db.dialect]} AS db_now_ms`;
     const { rows } = await db.query(sql, []);
     const n = Number(rows[0]?.["db_now_ms"] ?? Number.NaN);
     if (!Number.isFinite(n))
@@ -375,7 +375,7 @@ export function createCloseAwarePool(pool) {
 export function mysqlDriver(pool) {
     const session = poolSession(pool);
     return {
-        dialect: "tidb",
+        dialect: "mysql",
         get facts() {
             return session.facts;
         },
@@ -471,6 +471,6 @@ export function pgDriver(pool) {
         },
     };
 }
-export const dialectJsonEncoder = (dialect) => dialect === "tidb" ? JSON.stringify : pgSafeJsonStringify;
-export const dialectProtocolJsonEncoder = (dialect) => dialect === "tidb" ? (v) => JSON.stringify(v) : pgProtocolJsonStringify;
+export const dialectJsonEncoder = (dialect) => dialect === "mysql" ? JSON.stringify : pgSafeJsonStringify;
+export const dialectProtocolJsonEncoder = (dialect) => dialect === "mysql" ? (v) => JSON.stringify(v) : pgProtocolJsonStringify;
 //# sourceMappingURL=sql-driver.js.map

package/dist/plugins/sql-errors.js

@@ -13,7 +13,7 @@ export function isPgUniqueViolation(err) {
     return String(keyOf(err, "code")) === PG_UNIQUE_VIOLATION_SQLSTATE;
 }
 export function isDupKeyError(dialect, err) {
-    return dialect === "tidb" ? isMysqlDupKeyError(err) : isPgUniqueViolation(err);
+    return dialect === "mysql" ? isMysqlDupKeyError(err) : isPgUniqueViolation(err);
 }
 export const PG_UNDEFINED_COLUMN_SQLSTATE = "42703";
 export const MYSQL_ER_BAD_FIELD_ERRNO = 1054;

package/dist/plugins/store-backend.d.ts

@@ -16,7 +16,7 @@ import { type MemoryOptOutGrantStore } from "./memory-optout-grant-store-sql.js"
 import { type SendFileLedger } from "./send-file-ledger.js";
 import type { UserInputLedgerStore } from "../user-input-ledger.js";
 import { TiDBResumeAnchorStore, PgResumeAnchorStore } from "./resume-anchor-store-sql.js";
-import { type SessionPolicyStoreLogger } from "./session-policy-store-sql.js";
+import { type SessionPolicyStoreLogger } from "../stores-sql/session-policy-store-sql.js";
 import type { ServiceConfig } from "../config-types.js";
 import { TiDBRunStore, PgRunStore } from "./run-store-sql.js";
 import { TiDBCheckpointStore, PgCheckpointStore } from "./checkpoint-store-sql.js";
@@ -256,11 +256,9 @@ export interface StoreBackend {
      *  `fileSessionCaptureRecordStore(controlDir)` 按平面现造,依托是**记忆引擎的控制面目录** ⇒ 记忆面暗的
      *  部署上该平面不存在,于是这一支**随引擎接线门缺席**(唯一的 `undefined` 成因,逐字理由见 LocalBackend 的实装注)。
      *
-     *  🔴 修前 local 恒 `undefined` 且注称「缺席是一个真答案」—— 那句话在**事实层面**成立(单机的正确载体
-     *  确实就是文件三腿)、在**接线层面**是假的:core 的 `captureCarrierUnsupported`
-     *  (core 7.13.0 `prepare-task.js`)判的是「这个席位在不在」而不是「文件形能不能用」,叠上
-     *  `isRemoteExecutionEnv` 的接口形鸭子判(`remote-env.js`)把本仓 host lane 一并算作 remote,
-     *  于是单机默认部署上 `memoryCapture:"off"` 两条 ingress 结构性不可达([ref])。
+     *  🔴 local 不能答 `undefined`:引擎的 `captureCarrierUnsupported`(`prepare-task.js`)判的是「这个席位在不在」而不是「文件形能不能用」,
+     *  叠上执行环境块 `hostLocalPaths` 为假 —— 本地后端上跑沙箱 / 远端车道的部署,席位缺席 ⇒ `memoryCapture:"off"` 两条 ingress 结构性不可达。
+     *  (引擎按接口形判 remote 的那些版本里 host 车道也在射程;今天按块判,host 不在,供店对它是无害的同址声明。)
      *  刻意仍不给 local 一个**内存** twin:内存形会在重启时把一条隐私记录静默丢掉(比文件三腿严格更差)。 */
     sessionCaptureRecords(): SessionCaptureRecordSource | undefined;
     /** Retired-epoch byte hygiene: GC grace-passed orphan `snapshot_blob` rows/objects — the whole-tree snapshot

package/dist/plugins/store-backend.js

@@ -30,7 +30,7 @@ import { TiDBSendFileLedger, PgSendFileLedger, FileSendFileLedger } from "./send
 import { FileUserInputLedgerStore } from "./user-input-ledger-file.js";
 import { TiDBUserInputLedgerStore, PgUserInputLedgerStore } from "./user-input-ledger-sql.js";
 import { TiDBResumeAnchorStore, PgResumeAnchorStore } from "./resume-anchor-store-sql.js";
-import { TiDBSessionPolicyStore, PgSessionPolicyStore } from "./session-policy-store-sql.js";
+import { TiDBSessionPolicyStore, PgSessionPolicyStore } from "../stores-sql/session-policy-store-sql.js";
 import { TiDBWorkflowJournalStore, PgWorkflowJournalStore } from "./workflow-journal-store-sql.js";
 import { TiDBFileHistoryStore, PgFileHistoryStore, FILE_HISTORY_BLOB_TABLE, FILE_HISTORY_BLOB_KEY_PREFIX } from "./file-history-store-sql.js";
 import { MinioBlobBackend, SqlBlobBackend } from "./blob-backend.js";
@@ -92,7 +92,7 @@ function legacyBlobBackend(config, dialect, pool) {
 async function legacySweepImpl(config, dialect, pool) {
     const sql = "SELECT blob_hash FROM snapshot_blob";
     let orphans;
-    if (dialect === "tidb") {
+    if (dialect === "mysql") {
         const [rows] = await pool.query(sql);
         orphans = rows.map((r) => String(r.blob_hash));
     }
@@ -135,12 +135,12 @@ class TiDBBackend {
     sendFileLedger() { return new TiDBSendFileLedger(this.pool); }
     userInputLedger() { return new TiDBUserInputLedgerStore(this.pool); }
     sessionPolicy(logger) { return new TiDBSessionPolicyStore(this.pool, logger); }
-    fileHistory() { return new TiDBFileHistoryStore(this.pool, historyBlobBackend(this.config, "tidb", this.pool), this.config.fileHistory); }
+    fileHistory() { return new TiDBFileHistoryStore(this.pool, historyBlobBackend(this.config, "mysql", this.pool), this.config.fileHistory); }
     memoryOptOutGrant() { return new TiDBMemoryOptOutGrantStore(this.pool); }
     sessionCaptureRecords() { return () => (this.captureRecordsInst ??= new TiDBSessionCaptureRecordStore(this.pool)); }
     captureRecordsInst;
-    legacySnapshotBlobSweep() { return legacySweepImpl(this.config, "tidb", this.pool); }
-    runOneTimeMigrations() { return runSqlOneTimeMigrations("tidb", this.pool, { lanes: deployedExecutionLanes(this.config) }); }
+    legacySnapshotBlobSweep() { return legacySweepImpl(this.config, "mysql", this.pool); }
+    runOneTimeMigrations() { return runSqlOneTimeMigrations("mysql", this.pool, { lanes: deployedExecutionLanes(this.config) }); }
     workflowJournal() { return new TiDBWorkflowJournalStore(this.pool); }
     outcomeSink() { return new TiDBOutcomeLedger(this.pool); }
     workflowRun(onWarn) { return new TiDBWorkflowRunStore(this.pool, onWarn); }
@@ -380,7 +380,7 @@ export function createStoreBackend(config, onWarn, onError) {
     if (!config.tidb)
         return undefined;
     const pool = createTidbPool(config);
-    return withRetiredSchemaProbe(new TiDBBackend(pool, config), { dialect: "tidb", pool }, { lanes: deployedExecutionLanes(config) });
+    return withRetiredSchemaProbe(new TiDBBackend(pool, config), { dialect: "mysql", pool }, { lanes: deployedExecutionLanes(config) });
 }
 function withRetiredSchemaProbe(inner, target, executionPlacementSwitch) {
     const guarded = Object.create(inner);

package/dist/plugins/task-list-store-sql.js

@@ -68,33 +68,33 @@ export async function ensurePgTaskListSchema(q) {
   )`);
 }
 async function ensureMeta(exec, dialect, listKey) {
-    await exec(dialect === "tidb"
+    await exec(dialect === "mysql"
         ? `INSERT INTO ${TASK_LIST_META_TABLE} (list_key, next_id, next_sort) VALUES (?, 1, 1) ON DUPLICATE KEY UPDATE list_key = list_key`
         : `INSERT INTO ${TASK_LIST_META_TABLE} (list_key, next_id, next_sort) VALUES ($1, 1, 1) ON CONFLICT (list_key) DO NOTHING`, [listKey]);
 }
 async function allocateOn(exec, dialect, listKey) {
     await ensureMeta(exec, dialect, listKey);
-    const rows = await exec(dialect === "tidb"
+    const rows = await exec(dialect === "mysql"
         ? `SELECT next_id FROM ${TASK_LIST_META_TABLE} WHERE list_key = ? FOR UPDATE`
         : `SELECT next_id FROM ${TASK_LIST_META_TABLE} WHERE list_key = $1 FOR UPDATE`, [listKey]);
     const id = Number(rows[0].next_id);
-    await exec(dialect === "tidb"
+    await exec(dialect === "mysql"
         ? `UPDATE ${TASK_LIST_META_TABLE} SET next_id = ? WHERE list_key = ?`
         : `UPDATE ${TASK_LIST_META_TABLE} SET next_id = $1 WHERE list_key = $2`, [id + 1, listKey]);
     return String(id);
 }
 async function setOn(exec, dialect, listKey, id, itemJson) {
     await ensureMeta(exec, dialect, listKey);
-    const rows = await exec(dialect === "tidb"
+    const rows = await exec(dialect === "mysql"
         ? `SELECT next_sort FROM ${TASK_LIST_META_TABLE} WHERE list_key = ? FOR UPDATE`
         : `SELECT next_sort FROM ${TASK_LIST_META_TABLE} WHERE list_key = $1 FOR UPDATE`, [listKey]);
     const sort = Number(rows[0].next_sort);
-    await exec(dialect === "tidb"
+    await exec(dialect === "mysql"
         ? `INSERT INTO ${TASK_LIST_ITEM_TABLE} (list_key, id, id_num, sort_seq, item_json) VALUES (?, ?, ?, ?, ?)
          ON DUPLICATE KEY UPDATE item_json = VALUES(item_json)`
         : `INSERT INTO ${TASK_LIST_ITEM_TABLE} (list_key, id, id_num, sort_seq, item_json) VALUES ($1, $2, $3, $4, $5)
          ON CONFLICT (list_key, id) DO UPDATE SET item_json = EXCLUDED.item_json`, [listKey, id, arrayIndexOf(id), sort, itemJson]);
-    await exec(dialect === "tidb"
+    await exec(dialect === "mysql"
         ? `UPDATE ${TASK_LIST_META_TABLE} SET next_sort = ? WHERE list_key = ?`
         : `UPDATE ${TASK_LIST_META_TABLE} SET next_sort = $1 WHERE list_key = $2`, [sort + 1, listKey]);
 }
@@ -160,29 +160,29 @@ export function createTiDBTaskListStore(pool, listKey) {
     };
     const build = (q, inTx) => ({
         get: async (id) => {
-            const [rows] = (await q.query(`SELECT ${jsonColumnText("tidb", "item_json")} FROM ${TASK_LIST_ITEM_TABLE} WHERE list_key = ? AND id = ?${inTx ? " FOR UPDATE" : ""}`, [listKey, id]));
+            const [rows] = (await q.query(`SELECT ${jsonColumnText("mysql", "item_json")} FROM ${TASK_LIST_ITEM_TABLE} WHERE list_key = ? AND id = ?${inTx ? " FOR UPDATE" : ""}`, [listKey, id]));
             return rows.length > 0 ? parseItem(rows[0].item_json, `for list ${listKey} item ${JSON.stringify(id)}`) : undefined;
         },
         set: async (id, item) => {
             if (item.metadata)
                 assertJsonMetadata(item.metadata);
             const json = JSON.stringify(item);
-            await (inTx ? setOn(execOn(q), "tidb", listKey, id, json) : tx((c) => setOn(execOn(c), "tidb", listKey, id, json)));
+            await (inTx ? setOn(execOn(q), "mysql", listKey, id, json) : tx((c) => setOn(execOn(c), "mysql", listKey, id, json)));
         },
         delete: async (id) => {
             const [res] = (await q.query(`DELETE FROM ${TASK_LIST_ITEM_TABLE} WHERE list_key = ? AND id = ?`, [listKey, id]));
             return res.affectedRows === 1;
         },
         list: async () => {
-            const [rows] = (await q.query(`SELECT ${jsonColumnText("tidb", "item_json")} FROM ${TASK_LIST_ITEM_TABLE} WHERE list_key = ? ORDER BY id_num IS NULL, id_num, sort_seq${inTx ? " FOR UPDATE" : ""}`, [listKey]));
+            const [rows] = (await q.query(`SELECT ${jsonColumnText("mysql", "item_json")} FROM ${TASK_LIST_ITEM_TABLE} WHERE list_key = ? ORDER BY id_num IS NULL, id_num, sort_seq${inTx ? " FOR UPDATE" : ""}`, [listKey]));
             return rows.map((r) => parseItem(r.item_json, `for list ${listKey} (enumeration)`));
         },
-        allocateId: async () => (inTx ? allocateOn(execOn(q), "tidb", listKey) : tx((c) => allocateOn(execOn(c), "tidb", listKey))),
+        allocateId: async () => (inTx ? allocateOn(execOn(q), "mysql", listKey) : tx((c) => allocateOn(execOn(c), "mysql", listKey))),
         ...(inTx
             ? {}
             : {
                 mutate: (fn) => tx(async (c) => {
-                    await ensureMeta(execOn(c), "tidb", listKey);
+                    await ensureMeta(execOn(c), "mysql", listKey);
                     await c.query(`SELECT next_id FROM ${TASK_LIST_META_TABLE} WHERE list_key = ? FOR UPDATE`, [listKey]);
                     return fn(build(c, true));
                 }),

package/dist/plugins/tidb-pool.js

@@ -79,7 +79,7 @@ export const SCHEMA_STATEMENTS = [
      -- NULL = 还没有任何腿记过;唯一写者 = 腿的记录座(src/session-workspace.ts),列属主 = src/plugins/session-workspace-cell.ts
      -- (列定义、形读者、编解码;存量库缺这一列 ⇒ 起服列册对账拒启,拒句里给出 ALTER)。下一条腿的 TaskSpec.projectId 读它的 project.id。
      -- 服务端元数据:不进 wire 会话面、不进模型上下文;住在会话行上 ⇒ 随会话删除 / 留存清扫一起消失,fork 出的新行为 NULL。
-     ${SESSION_META_WORKSPACE_COLUMN.tidb},
+     ${SESSION_META_WORKSPACE_COLUMN.mysql},
      -- #292 C18(core 5.48.0 design/323)subagent 转录持久化 —— placement 元组,**创建时一次落行、
      -- first-write 不可变**(register 的 ON DUPLICATE 臂永不重写这六列)。判别位 = placement_kind:
      -- 在场 ⇒ 该会话住在 placement 分区里(不上宿主枚举、claim 形 acquire 恒拒、release=真删除、
@@ -96,12 +96,12 @@ export const SCHEMA_STATEMENTS = [
      -- 无 id 创建 / fork / 导入新行),删除随行消失,同 id 重登记铸新的;'' = 没铸过,读口响亮拒。列定义的唯一属主 =
      -- src/session-incarnation.ts 的 SESSION_META_INCARNATION_COLUMN(存量库缺这一列 ⇒ 起服列册对账拒启,拒句里的 ALTER 由本建表语句生成)。
      -- 不上 wire、不进模型上下文、日志只打前 8 位。
-     ${SESSION_META_INCARNATION_COLUMN.tidb},
+     ${SESSION_META_INCARNATION_COLUMN.mysql},
      -- 执行放置:根会话行上**这一位住客**的一格 —— execution_role('writer' | 'mirror' | NULL = absent)、execution_lane、device 车道的设备与绑定属主、
      -- 放下时刻、换绑序号;写只按住客谓词 (session_id, incarnation, owner) ∧ placement_kind IS NULL(换了住客 = 这一格不在)。fork_key = 建这一行的那次
      -- fork 请求的键(只由 fork 创建点写,此后每个写携带)。规则在 src/execution-placement.ts,列定义与语句的唯一属主 = src/plugins/execution-placement-sql.ts
      -- (存量库缺这些列 ⇒ 起服列册对账拒启;加列只由一次性迁移做)。
-     ${sessionMetaPlacementColumnsDdl("tidb")},
+     ${sessionMetaPlacementColumnsDdl("mysql")},
      PRIMARY KEY (session_id),
      KEY idx_session_meta_owner (owner),
      -- listPlaced 的检索腿(kind + 租户 + 年龄升序);普通会话这三列全 NULL ⇒ 不占索引选择性。
@@ -173,7 +173,7 @@ export const SCHEMA_STATEMENTS = [
      -- (rows from before these columns, unauthenticated-write acceptance, a run someone else accepted on the owner's behalf) ⇒ not
      -- qualified. Column definitions' single owner = src/identity-source.ts RUN_IDENTITY_COLUMNS (the boot column probe derives its
      -- ALTER suggestion from this statement). \`source\` above is attribution only, never an authentication source.
-     ${RUN_IDENTITY_COLUMNS.tidb},
+     ${RUN_IDENTITY_COLUMNS.mysql},
      -- objective_preview: the list's "what is this task" glance — redacted + truncated at write.
      objective_preview VARCHAR(160) NULL,
      -- cancel_requested: durable cross-replica CANCEL flag. The running instance's heartbeat tick honors it
@@ -463,7 +463,7 @@ export const SCHEMA_STATEMENTS = [
      principal  VARCHAR(190) NULL,
      -- 会话规则(三只桶,引擎的规则条目文法)。列定义唯一属主 = src/plugins/session-rules-column.ts 的 SESSION_RULES_COLUMN(一列一文法:
      -- 7.128.x 及以前这一列叫 rules、按整串工具名读;存量库由一次性迁移 M17 改名,带退役命令桶的行原样留着、读回判坏并逐行点名,见那份文件与 one-time-migrations.ts)。
-     ${SESSION_RULES_COLUMN.tidb},
+     ${SESSION_RULES_COLUMN.mysql},
      rev        BIGINT       NOT NULL,
      -- gen (core 7.25.0 StoredSessionRules.gen, S-529 二期):这一行的**血统**。rev 只在一条血统内计数,
      -- deleteBySession 终结血统并把下一代的号留在 session_policy_rev_mark.gen 上,于是活规则读者能把

package/dist/plugins/tidb-session-storage.js

@@ -9,8 +9,8 @@ import { jsonColumnText } from "./sql-json-column.js";
 import { incarnationFromCell } from "../session-incarnation.js";
 const SESSION_EVENT_BY_TYPE_HINT = "/*+ USE_INDEX(session_event, idx_session_event_type) */";
 export const SESSION_EVENT_LATEST_BY_TYPE_SQL = {
-    floor: `SELECT ${SESSION_EVENT_BY_TYPE_HINT} ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? AND type = 'compaction' ORDER BY seq DESC LIMIT 1`,
-    epochAnchor: `SELECT ${SESSION_EVENT_BY_TYPE_HINT} seq, ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? AND seq < ? AND type IN ('prompt_epoch','compaction') ORDER BY seq DESC LIMIT 100`,
+    floor: `SELECT ${SESSION_EVENT_BY_TYPE_HINT} ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? AND type = 'compaction' ORDER BY seq DESC LIMIT 1`,
+    epochAnchor: `SELECT ${SESSION_EVENT_BY_TYPE_HINT} seq, ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? AND seq < ? AND type IN ('prompt_epoch','compaction') ORDER BY seq DESC LIMIT 100`,
 };
 const isDupKey = isMysqlDupKeyError;
 export class TiDBSessionStorage extends BaseSessionStorage {
@@ -35,7 +35,7 @@ export class TiDBSessionStorage extends BaseSessionStorage {
         if (!meta)
             return null;
         const { floorEntryId, floorSeq } = await TiDBSessionStorage.computeFloor(pool, sessionId);
-        const [eventRows] = await pool.query(`SELECT seq, ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? AND seq >= ? ORDER BY seq ASC`, [sessionId, floorSeq]);
+        const [eventRows] = await pool.query(`SELECT seq, ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? AND seq >= ? ORDER BY seq ASC`, [sessionId, floorSeq]);
         const entries = eventRows.map((r) => decodeSessionEventPayload(r.payload, sessionId, r.seq));
         const placement = placementFromRow(meta);
         const metadata = { id: sessionId, createdAt: toIso(meta.created_at), incarnation: incarnationFromCell(sessionId, meta.incarnation), ...(placement !== undefined ? { placement } : {}) };
@@ -58,7 +58,7 @@ export class TiDBSessionStorage extends BaseSessionStorage {
         const inMem = await super.getEntry(id);
         if (inMem)
             return inMem;
-        const [rows] = await this.pool.query(`SELECT ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? AND entry_id = ?`, [this.sessionId, id]);
+        const [rows] = await this.pool.query(`SELECT ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? AND entry_id = ?`, [this.sessionId, id]);
         if (rows[0] === undefined)
             return undefined;
         return decodeSessionEventPayload(rows[0].payload, this.sessionId, id);

package/dist/plugins/tidb-session-store.js

@@ -89,7 +89,7 @@ export class TiDBSessionStore {
         }, this.log);
     }
     async claimOwnerless(sessionId, incarnation, owner) {
-        const [res] = await this.pool.query(CLAIM_OWNERLESS_PLACED_SQL.tidb, [...claimOwnerlessParams(sessionId, incarnation, owner)]);
+        const [res] = await this.pool.query(CLAIM_OWNERLESS_PLACED_SQL.mysql, [...claimOwnerlessParams(sessionId, incarnation, owner)]);
         return res.affectedRows > 0;
     }
     async sourceFaces(ids) {
@@ -256,7 +256,7 @@ export class TiDBSessionStore {
         }
     }
     async readSessionWorkspace(sessionId) {
-        const [rows] = await this.pool.query(`SELECT ${jsonColumnText("tidb", "workspace")} FROM session_meta WHERE session_id = ?`, [sessionId]);
+        const [rows] = await this.pool.query(`SELECT ${jsonColumnText("mysql", "workspace")} FROM session_meta WHERE session_id = ?`, [sessionId]);
         const row = rows[0];
         return row === undefined ? undefined : decodeSessionWorkspaceCell(row.workspace, sessionId);
     }
@@ -284,7 +284,7 @@ export class TiDBSessionStore {
         if (storage === null)
             return null;
         const point = await forkPointOf(storage);
-        const [allRows] = await this.pool.query(`SELECT entry_id, parent_id, type, ${jsonColumnText("tidb", "payload")}, ts FROM session_event WHERE session_id = ? ORDER BY seq ASC`, [sourceId]);
+        const [allRows] = await this.pool.query(`SELECT entry_id, parent_id, type, ${jsonColumnText("mysql", "payload")}, ts FROM session_event WHERE session_id = ? ORDER BY seq ASC`, [sourceId]);
         const { rows: eventRows, leafId: forkLeafId } = selectForkRows(allRows, leafId, point, FORK_LOG_ROW_SHAPE);
         const now = new Date();
         const conn = await this.pool.getConnection();
@@ -329,7 +329,7 @@ export class TiDBSessionStore {
         const [metaRows] = await this.pool.query("SELECT 1 FROM session_meta WHERE session_id = ?", [sessionId]);
         if (!metaRows[0])
             return null;
-        const [eventRows] = await this.pool.query(`SELECT seq, entry_id, parent_id, type, ${jsonColumnText("tidb", "payload")}, ts FROM session_event WHERE session_id = ? ORDER BY seq ASC`, [sessionId]);
+        const [eventRows] = await this.pool.query(`SELECT seq, entry_id, parent_id, type, ${jsonColumnText("mysql", "payload")}, ts FROM session_event WHERE session_id = ? ORDER BY seq ASC`, [sessionId]);
         return eventRows.map((r) => decodeSessionEventPayload(r.payload, sessionId, r.seq));
     }
     async listEntryIds(sessionId) {
@@ -348,7 +348,7 @@ export class TiDBSessionStore {
         async function* gen() {
             let cursor = opts?.afterSeq ?? -1;
             for (;;) {
-                const [rows] = await pool.query(`SELECT seq, ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? AND seq > ? ORDER BY seq ASC LIMIT ?`, [sessionId, cursor, batchSize]);
+                const [rows] = await pool.query(`SELECT seq, ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? AND seq > ? ORDER BY seq ASC LIMIT ?`, [sessionId, cursor, batchSize]);
                 for (const r of rows)
                     yield decodeSessionEventPayload(r.payload, sessionId, r.seq);
                 if (rows.length < batchSize)
@@ -431,7 +431,7 @@ export class TiDBSessionStore {
                 throw new SessionError("storage", `import of session ${sessionId} failed`, new Error(`session ${sessionId} already exists — importEntries only creates a session (replaceEntries rewrites one); nothing was written`));
             }
         }
-        const claim = await lockRootAndReadClaim(rowsOnConnection(conn), "tidb", sessionId);
+        const claim = await lockRootAndReadClaim(rowsOnConnection(conn), "mysql", sessionId);
         if (claim.activeTaskId !== null)
             throw new SessionActiveRunError(sessionId, claim.activeTaskId);
         if (mode === "replace")
@@ -451,7 +451,7 @@ export class TiDBSessionStore {
         }
     }
     async readStagedEntries(stagingId) {
-        const [rows] = await this.pool.query(`SELECT seq, ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? ORDER BY seq ASC`, [stagingId]);
+        const [rows] = await this.pool.query(`SELECT seq, ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? ORDER BY seq ASC`, [stagingId]);
         return rows.map((r) => decodeSessionEventPayload(r.payload, stagingId, r.seq));
     }
     async sweepStagingSessions() {
@@ -470,7 +470,7 @@ export class TiDBSessionStore {
         const conn = await this.pool.getConnection();
         try {
             await conn.beginTransaction();
-            const claim = await lockRootAndReadClaim(rowsOnConnection(conn), "tidb", sessionId);
+            const claim = await lockRootAndReadClaim(rowsOnConnection(conn), "mysql", sessionId);
             if (claim.activeTaskId !== null) {
                 await conn.rollback();
                 throw new SessionActiveRunError(sessionId, claim.activeTaskId);
@@ -553,7 +553,7 @@ class TiDBStagingHandle {
                     throw new StagedCommitOwnerChangedError(this.realSessionId);
                 }
             }
-            const claim = await lockRootAndReadClaim(rowsOnConnection(conn), "tidb", this.realSessionId);
+            const claim = await lockRootAndReadClaim(rowsOnConnection(conn), "mysql", this.realSessionId);
             if (claim.activeTaskId !== null) {
                 await conn.rollback();
                 throw new SessionActiveRunError(this.realSessionId, claim.activeTaskId);
@@ -573,8 +573,8 @@ class TiDBStagingHandle {
                 throw new SyncConflictError(this.realSessionId, rel);
             }
             if (rel.relation === "fast_forward" && opts.resolution !== "overwrite-dst" && dstIds !== null && dstIds.length > 0) {
-                const [dstFull] = await conn.query(`SELECT seq, ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? ORDER BY seq ASC FOR UPDATE`, [this.realSessionId]);
-                const [stagedFull] = await conn.query(`SELECT entry_id, ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? ORDER BY seq ASC FOR UPDATE`, [this.stagingId]);
+                const [dstFull] = await conn.query(`SELECT seq, ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? ORDER BY seq ASC FOR UPDATE`, [this.realSessionId]);
+                const [stagedFull] = await conn.query(`SELECT entry_id, ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? ORDER BY seq ASC FOR UPDATE`, [this.stagingId]);
                 const dstSet = new Set(dstIds);
                 const dstEntries = dstFull.map((r) => decodeSessionEventPayload(r.payload, this.realSessionId, r.seq));
                 const stagedShared = stagedFull
@@ -588,13 +588,13 @@ class TiDBStagingHandle {
             }
             await conn.query("DELETE FROM session_event WHERE session_id = ?", [this.realSessionId]);
             await conn.query("UPDATE session_event SET session_id = ? WHERE session_id = ?", [this.realSessionId, this.stagingId]);
-            const [lastRow] = await conn.query(`SELECT ${jsonColumnText("tidb", "payload")} FROM session_event WHERE session_id = ? ORDER BY seq DESC LIMIT 1 FOR UPDATE`, [this.realSessionId]);
+            const [lastRow] = await conn.query(`SELECT ${jsonColumnText("mysql", "payload")} FROM session_event WHERE session_id = ? ORDER BY seq DESC LIMIT 1 FOR UPDATE`, [this.realSessionId]);
             let leafId = null;
             if (lastRow[0])
                 leafId = leafIdAfterEntry(decodeSessionEventPayload(lastRow[0].payload, this.realSessionId, "last staged row"));
             const [settle] = await conn.query(`UPDATE session_meta SET owner = ?, updated_at = ?, leaf_id = ?, leaf_seq = ?, ${MIRROR_ON_COMMIT_SET} WHERE session_id = ? AND ${MIRROR_ON_COMMIT_GUARD}`, [owner, now, leafId, srcIds.length, this.realSessionId]);
             if (settle.affectedRows !== 1) {
-                const locked = readPlacementRowStatement("tidb", this.realSessionId, { lock: true });
+                const locked = readPlacementRowStatement("mysql", this.realSessionId, { lock: true });
                 const [lockedRows] = await conn.query(locked.text, [...locked.values]);
                 const cell = lockedRows[0] === undefined ? undefined : placementCellFromRow(this.realSessionId, lockedRows[0]);
                 await conn.rollback();

package/dist/plugins/tool-result-store-sql.d.ts

@@ -1,7 +1,7 @@
 import type { ToolResultProvenance, ToolResultStore, ToolResultSlice, ToolResultDeletionReport } from "@sema-agent/core";
 import type { Pool as MySqlPool } from "mysql2/promise";
 import type { Pool as PgPool, PoolClient as PgPoolClient } from "pg";
-import { type SqlDriver } from "./sql-driver.js";
+import { type SqlDriver, type SqlDialect } from "./sql-driver.js";
 import type { RetentionDeclaration } from "@sema-agent/core";
 import { type IndexSpec } from "./ensure-index.js";
 /** PG schema for the tool_result table — the PG translation of tidb-pool.ts's tool_result DDL
@@ -27,7 +27,7 @@ export declare function ensureSchema(pool: PgPool | PgPoolClient): Promise<void>
  */
 export declare function assertToolResultProvenanceSchema(query: (sql: string) => Promise<{
     rows: Record<string, unknown>[];
-}>, dialect: "tidb" | "pg"): Promise<void>;
+}>, dialect: SqlDialect): Promise<void>;
 /** Dual-dialect durable ToolResultStore. See the file header for the dialect-delta ledger. */
 export declare class SqlToolResultStore implements ToolResultStore {
     protected readonly db: SqlDriver;