weifuwu 0.75.0 → 0.77.0

package/dist/index.js

@@ -2315,1140 +2315,577 @@ function isConnClosed(e) {
 // src/scheduler/index.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
 
-// src/db/redis/connection.ts
-import net2 from "node:net";
-
-// src/db/errors.ts
-var DbError = class extends Error {
-  kind;
-  code;
-  cause;
-  constructor(kind, message, options) {
-    super(message);
-    this.name = "DbError";
-    this.kind = kind;
-    this.code = options?.code;
-    this.cause = options?.cause;
-  }
-};
-var ProtocolError = class extends DbError {
-  constructor(feature, message) {
-    super("protocol", message ?? `${feature} is not supported by weifuwu/db`, { code: "UNSUPPORTED" });
-    this.name = "ProtocolError";
-  }
-};
-var ConnectionError = class extends DbError {
-  attempts;
-  constructor(message, attempts = 1, cause) {
-    super("connection", message, { cause });
-    this.name = "ConnectionError";
-    this.attempts = attempts;
-  }
-};
-var TimeoutError = class extends DbError {
-  operation;
-  ms;
-  constructor(operation, ms) {
-    super("timeout", `${operation} timed out after ${ms}ms`);
-    this.name = "TimeoutError";
-    this.operation = operation;
-    this.ms = ms;
-  }
-};
-var ValidationError = class extends DbError {
-  constructor(message) {
-    super("validation", message);
-    this.name = "ValidationError";
-  }
-};
-
-// src/db/redis/resp.ts
-var RespError = class extends DbError {
-  constructor(message) {
-    super("protocol", message, { code: "RESP" });
-    this.name = "RespError";
-  }
-};
-var IncompleteError = class extends Error {
-  constructor() {
-    super("incomplete RESP message");
-    this.name = "IncompleteError";
-  }
-};
-function decodeValue(v, decodeBytes) {
-  if (v instanceof Uint8Array) return decodeBytes ? _decoder.decode(v) : v;
-  if (Array.isArray(v)) return v.map((x) => decodeValue(x, decodeBytes));
-  return v;
-}
-function encodeCommand(args) {
-  const lens = new Array(args.length);
-  let total = headerLen(args.length);
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    const len = typeof arg === "string" ? Buffer.byteLength(arg) : arg instanceof Buffer ? arg.length : String(arg).length;
-    lens[i] = len;
-    total += headerLen(len) + len + 2;
+// src/scheduler/cron.ts
+var RANGES = [
+  [0, 59],
+  // 分
+  [0, 23],
+  // 时
+  [1, 31],
+  // 日
+  [1, 12],
+  // 月
+  [0, 6]
+  // 周
+];
+function parseField(field, idx) {
+  const [min, max] = RANGES[idx];
+  const name = ["minute", "hour", "day", "month", "weekday"][idx];
+  if (field === "*") return null;
+  if (field.startsWith("*/")) {
+    const n = Number(field.slice(2));
+    if (!Number.isInteger(n) || n <= 0 || n > max) {
+      throw new Error(`cron: invalid step '${field}' in ${name} field (must be 1..${max})`);
+    }
+    const set2 = /* @__PURE__ */ new Set();
+    for (let v = min; v <= max; v += n) set2.add(v);
+    return set2;
   }
-  const out = new Uint8Array(total);
-  let off = 0;
-  const head = `*${args.length}\r
-`;
-  out.set(_encoder.encode(head), 0);
-  off = head.length;
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    const len = lens[i];
-    const lh = `$${len}\r
-`;
-    out.set(_encoder.encode(lh), off);
-    off += lh.length;
-    if (typeof arg === "string") {
-      out.set(_encoder.encode(arg), off);
-    } else if (arg instanceof Buffer) {
-      out.set(arg, off);
+  const set = /* @__PURE__ */ new Set();
+  for (const part of field.split(",")) {
+    if (part === "") throw new Error(`cron: empty item in '${field}' (${name})`);
+    if (part.includes("-")) {
+      const [rangePart, stepPart] = part.split("/");
+      const step = stepPart !== void 0 ? Number(stepPart) : 1;
+      const [a, b] = rangePart.split("-").map(Number);
+      if (!Number.isInteger(a) || !Number.isInteger(b) || a < min || b > max || a > b) {
+        throw new Error(`cron: invalid range '${part}' in ${name} field (${min}..${max})`);
+      }
+      if (!Number.isInteger(step) || step <= 0) throw new Error(`cron: invalid step in '${part}'`);
+      for (let v = a; v <= b; v += step) set.add(v);
     } else {
-      out.set(_encoder.encode(String(arg)), off);
+      const v = Number(part);
+      if (!Number.isInteger(v) || v < min || v > max) {
+        throw new Error(`cron: value '${part}' out of range ${min}..${max} in ${name} field`);
+      }
+      set.add(v);
     }
-    off += len;
-    out[off] = 13;
-    out[off + 1] = 10;
-    off += 2;
   }
-  return out;
+  return set;
 }
-function headerLen(n) {
-  if (n < 10) return 4;
-  if (n < 100) return 5;
-  if (n < 1e3) return 6;
-  if (n < 1e4) return 7;
-  return 8;
+function parseCron(expr) {
+  const parts = expr.trim().split(/\s+/);
+  if (parts.length !== 5) {
+    throw new Error(`cron: expected 5 fields (min hour dom month dow), got ${parts.length}: '${expr}'`);
+  }
+  const fields = parts.map((p, i) => parseField(p, i));
+  return {
+    fields: fields.map((values) => ({ values })),
+    domExplicit: fields[2] !== null,
+    dowExplicit: fields[4] !== null
+  };
 }
-var _decoder = new TextDecoder();
-var _encoder = new TextEncoder();
-var RespParser = class {
-  buf = new Uint8Array(0);
-  off = 0;
-  /** 喂入数据分片。返回 { value, incomplete }；incomplete=true 时需继续喂。 */
-  push(chunk) {
-    this.append(chunk);
-    const saved = this.off;
-    try {
-      const value = this.parseValue();
-      this.compact();
-      return { value, incomplete: false };
-    } catch (e) {
-      this.off = saved;
-      if (e instanceof IncompleteError) return { value: null, incomplete: true };
-      throw e;
+function fieldMatches(values, v) {
+  if (values === null) return true;
+  return values.has(v);
+}
+function dayMatches(expr, dom, dow) {
+  const domOk = fieldMatches(expr.fields[2].values, dom);
+  const dowOk = fieldMatches(expr.fields[4].values, dow);
+  if (expr.domExplicit && expr.dowExplicit) return domOk || dowOk;
+  if (expr.domExplicit) return domOk;
+  if (expr.dowExplicit) return dowOk;
+  return true;
+}
+function nextMatch(values, v, min, max) {
+  if (values === null) return v;
+  for (let x = v; x <= max; x++) if (values.has(x)) return x;
+  return null;
+}
+function nextRun(expr, from) {
+  const d = new Date(from.getTime());
+  d.setSeconds(0, 0);
+  d.setMinutes(d.getMinutes() + 1);
+  const deadline = from.getTime() + 5 * 366 * 24 * 3600 * 1e3;
+  while (d.getTime() <= deadline) {
+    const year = d.getFullYear();
+    const month = d.getMonth() + 1;
+    const dom = d.getDate();
+    const dow = d.getDay();
+    if (!fieldMatches(expr.fields[3].values, month)) {
+      d.setMonth(month, 1);
+      d.setHours(0, 0, 0, 0);
+      d.setMonth(month);
+      continue;
     }
-  }
-  /** 喂入分片并解析 buffer 中所有完整响应（连接层：一次 data 事件可能含多个回复） */
-  pushAll(chunk) {
-    this.append(chunk);
-    const out = [];
-    while (true) {
-      const saved = this.off;
-      try {
-        out.push(this.parseValue());
-      } catch (e) {
-        this.off = saved;
-        if (e instanceof IncompleteError) break;
-        throw e;
-      }
+    if (!dayMatches(expr, dom, dow)) {
+      d.setDate(dom + 1);
+      d.setHours(0, 0, 0, 0);
+      continue;
     }
-    if (out.length > 0) this.compact();
-    return out;
-  }
-  /** 追加分片：已消费部分先行压缩（一次拷贝），避免 O(n²) 累积 */
-  append(chunk) {
-    if (chunk.length === 0) return;
-    const rest = this.buf.length - this.off;
-    if (rest === 0) {
-      this.buf = chunk;
-      this.off = 0;
-      return;
+    const hour = d.getHours();
+    const nextHour = nextMatch(expr.fields[1].values, hour, 0, 23);
+    if (nextHour === null) {
+      d.setDate(dom + 1);
+      d.setHours(0, 0, 0, 0);
+      continue;
     }
-    const merged = new Uint8Array(rest + chunk.length);
-    merged.set(this.buf.subarray(this.off), 0);
-    merged.set(chunk, rest);
-    this.buf = merged;
-    this.off = 0;
-  }
-  /** 全部消费后压缩（释放底层） */
-  compact() {
-    if (this.off === this.buf.length) {
-      this.buf = new Uint8Array(0);
-      this.off = 0;
-    } else if (this.off > 0) {
-      this.buf = this.buf.subarray(this.off);
-      this.off = 0;
+    if (nextHour !== hour) {
+      d.setHours(nextHour, 0, 0, 0);
+      continue;
     }
-  }
-  parseValue() {
-    if (this.buf.length - this.off < 3) throw new IncompleteError();
-    const type = String.fromCharCode(this.buf[this.off]);
-    this.off++;
-    switch (type) {
-      case "+": {
-        const line = this.readLine();
-        return line;
-      }
-      case "-": {
-        const line = this.readLine();
-        return new RespError(line);
-      }
-      case ":": {
-        return this.readInt();
-      }
-      case "$": {
-        const len = this.readInt();
-        if (len === -1) return null;
-        return this.readBulkBytes(len);
-      }
-      case "*": {
-        const count = this.readInt();
-        if (count === -1) return null;
-        const items = [];
-        for (let i = 0; i < count; i++) items.push(this.parseValue());
-        return items;
-      }
-      default:
-        throw new DbError("protocol", `unknown RESP type byte: ${type}`, { code: "RESP" });
-    }
-  }
-  /**
-   * 读整数（: 或 $ 长度）：扫描数字字符边算值，直到 \r\n（手动解析，免 parseInt + 字符串）。
-   * 支持负号（-1）。未读到终止符抛 IncompleteError（push 回滚）。
-   */
-  readInt() {
-    const buf = this.buf;
-    let i = this.off;
-    let neg = false;
-    if (i < buf.length && buf[i] === 45) {
-      neg = true;
-      i++;
-    }
-    let n = 0;
-    while (i < buf.length && buf[i] >= 48 && buf[i] <= 57) {
-      n = n * 10 + (buf[i] - 48);
-      i++;
+    const minute = d.getMinutes();
+    const nextMinute = nextMatch(expr.fields[0].values, minute, 0, 59);
+    if (nextMinute === null) {
+      d.setHours(hour + 1, 0, 0, 0);
+      continue;
     }
-    if (i + 1 < buf.length && buf[i] === 13 && buf[i + 1] === 10) {
-      this.off = i + 2;
-      return neg ? -n : n;
+    if (nextMinute !== minute) {
+      d.setMinutes(nextMinute, 0, 0);
+      continue;
     }
-    throw new IncompleteError();
-  }
-  /** 读一行（到 \r\n），返回行内容（不含 type 字节与 \r\n），并推进 off */
-  readLine() {
-    const idx = indexOfCRLF(this.buf, this.off);
-    if (idx === -1) throw new IncompleteError();
-    const line = _decoder.decode(this.buf.subarray(this.off, idx));
-    this.off = idx + 2;
-    return line;
-  }
-  /** 读 len 字节的 bulk 内容 + \r\n（字节中立——不 decode，由调用方决定 string/Buffer） */
-  readBulkBytes(len) {
-    if (this.buf.length - this.off < len + 2) throw new IncompleteError();
-    const value = this.buf.subarray(this.off, this.off + len);
-    this.off += len + 2;
-    return value;
-  }
-};
-function indexOfCRLF(buf, from = 0) {
-  let i = buf.indexOf(13, from);
-  while (i !== -1) {
-    if (i + 1 < buf.length && buf[i + 1] === 10) return i;
-    i = buf.indexOf(13, i + 1);
+    return d;
   }
-  return -1;
+  throw new Error("cron: no next run within 5 years (invalid expression?)");
 }
 
-// src/db/redis/connection.ts
-var PUSH_TYPES = /* @__PURE__ */ new Set(["message", "pmessage"]);
-var BLOCKING_COMMANDS = /* @__PURE__ */ new Set(["BLPOP", "BRPOP", "BLMPOP", "BRPOPLPUSH", "BZPOPMIN", "BZPOPMAX", "WAIT", "XREAD", "XREADGROUP"]);
-var RedisConnection = class {
-  ready = false;
-  opts;
-  socket = null;
-  parser = new RespParser();
-  pending = [];
-  /** pending 头指针（避免 shift() O(n)——消费后定期 compact） */
-  pendingHead = 0;
-  offlineQueue = [];
-  subs = /* @__PURE__ */ new Map();
-  psubs = /* @__PURE__ */ new Map();
-  status = "idle";
-  retries = 0;
-  reconnectTimer = null;
-  socketTimeoutTimer = null;
-  connectPromise = null;
-  closed = false;
-  connectedOnce = false;
-  constructor(options = {}) {
-    this.opts = {
-      host: options.host ?? "127.0.0.1",
-      port: options.port ?? 6379,
-      retryDelayMs: options.retryDelayMs ?? 100,
-      maxRetries: options.maxRetries ?? 10,
-      enableOfflineQueue: options.enableOfflineQueue ?? true,
-      maxOfflineQueue: options.maxOfflineQueue ?? 5e3,
-      commandTimeoutMs: options.commandTimeoutMs ?? 0,
-      socketTimeoutMs: options.socketTimeoutMs ?? 0,
-      onCommand: options.onCommand
-    };
-  }
-  /** 建立连接并等待 ready。重连失败（超过 maxRetries）抛 ConnectionError。 */
-  connect() {
-    if (this.connectPromise) return this.connectPromise;
-    this.closed = false;
-    this.connectPromise = new Promise((resolve3, reject) => {
-      this.openSocket();
-      this.onceReady = () => resolve3();
-      this.onceFailed = (err) => reject(err);
-    }).finally(() => {
-      this.connectPromise = null;
-      this.onceReady = void 0;
-      this.onceFailed = void 0;
-    });
-    return this.connectPromise;
+// src/scheduler/index.ts
+function scheduler(options) {
+  const prefix = options.prefix ?? "wf:sched:";
+  const tickMs = options.tickMs ?? 1e3;
+  const delayedKey = `${prefix}delayed`;
+  const cronsKey = `${prefix}crons`;
+  const queueModule = options.queue;
+  let connPromise = null;
+  function getConn() {
+    if (!connPromise) connPromise = options.redis.createConnection();
+    return connPromise;
   }
-  onceReady;
-  onceFailed;
-  openSocket() {
-    this.status = "connecting";
-    const sock = net2.connect(this.opts.port, this.opts.host);
-    this.socket = sock;
-    sock.on("connect", () => {
-      sock.setNoDelay(true);
-      this.status = "ready";
-      this.retries = 0;
-      if (this.connectedOnce) {
-        for (const ch of this.subs.keys()) this.sendNow("SUBSCRIBE", [ch]);
-        for (const pat of this.psubs.keys()) this.sendNow("PSUBSCRIBE", [pat]);
-      }
-      this.connectedOnce = true;
-      this.flushOffline();
-      this.onceReady?.();
-    });
-    sock.on("data", (chunk) => this.onData(new Uint8Array(chunk)));
-    sock.on("error", (err) => {
-      if (this.status === "connecting") {
-        this.handleDisconnect(err);
+  let running = false;
+  let tickTimer = null;
+  async function tick() {
+    await tickCrons();
+    let due;
+    try {
+      due = await (await getConn()).command("ZRANGEBYSCORE", delayedKey, 0, Date.now());
+    } catch {
+      return;
+    }
+    for (const member of due) {
+      let removed;
+      try {
+        removed = await (await getConn()).command("ZREM", delayedKey, member);
+      } catch {
+        return;
       }
-    });
-    sock.on("close", () => {
-      this.socket = null;
-      if (this.status !== "closed" && this.status !== "idle") {
-        this.handleDisconnect(new ConnectionError("redis: socket closed"));
+      if (removed !== 1) continue;
+      try {
+        const task = JSON.parse(member);
+        await queueModule.queue.add(task.name, task.data);
+      } catch (e) {
+        console.error("[scheduler] enqueue:", e instanceof Error ? e.message : e);
       }
-    });
-  }
-  handleDisconnect(err) {
-    const queue2 = this.pending.slice(this.pendingHead);
-    this.pending = [];
-    this.pendingHead = 0;
-    for (const p of queue2) p.reject(err);
-    this.clearSocketTimeout();
-    if (this.closed || this.status === "closed") return;
-    this.retries++;
-    this.status = "connecting";
-    if (this.opts.maxRetries > 0 && this.retries > this.opts.maxRetries) {
-      this.status = "closed";
-      const failErr = err instanceof ConnectionError ? err : new ConnectionError(`redis: connect to ${this.opts.host}:${this.opts.port} failed`, this.retries, err);
-      this.onceFailed?.(failErr);
-      return;
     }
-    const delay = Math.min(this.opts.retryDelayMs * 2 ** (this.retries - 1), 5e3);
-    this.reconnectTimer = setTimeout(() => {
-      this.reconnectTimer = null;
-      this.openSocket();
-    }, delay);
   }
-  onData(chunk) {
+  async function tickCrons() {
+    let crons;
     try {
-      const values = this.parser.pushAll(chunk);
-      for (const raw of values) {
-        const first = Array.isArray(raw) && raw.length > 0 ? decodeValue(raw[0], true) : void 0;
-        if (typeof first === "string" && PUSH_TYPES.has(first)) {
-          this.dispatchSubscribe(decodeValue(raw, true));
-          continue;
-        }
-        const p = this.pending[this.pendingHead++];
-        if (!p) break;
-        if (p.timedOut) continue;
-        if (raw instanceof RespError) p.reject(raw);
-        else p.resolve(decodeValue(raw, !p.asBuffer));
+      crons = await (await getConn()).command("HGETALL", cronsKey);
+    } catch {
+      return;
+    }
+    const now = Date.now();
+    const entries = crons;
+    for (let i = 0; i + 1 < entries.length; i += 2) {
+      const field = entries[i];
+      const value = entries[i + 1];
+      let def;
+      try {
+        def = JSON.parse(value);
+      } catch {
+        continue;
       }
-      if (this.pendingHead > 64 && this.pendingHead * 2 > this.pending.length) {
-        this.pending = this.pending.slice(this.pendingHead);
-        this.pendingHead = 0;
+      const parsed = parseCron(def.expr);
+      let next = def.nextRunAt;
+      while (next <= now) {
+        const ts = next;
+        const member = JSON.stringify({ id: `cron:${field}:${ts}`, name: def.name, data: def.data });
+        try {
+          await (await getConn()).command("ZADD", delayedKey, "NX", ts, member);
+        } catch {
+          break;
+        }
+        next = nextRun(parsed, new Date(ts)).getTime();
       }
-      if (this.opts.socketTimeoutMs > 0) {
-        if (this.pendingHead < this.pending.length) this.armSocketTimeout();
-        else this.clearSocketTimeout();
+      if (next !== def.nextRunAt) {
+        await (await getConn()).command("HSET", cronsKey, field, JSON.stringify({ ...def, nextRunAt: next }));
       }
-    } catch (e) {
-      const queue2 = this.pending.slice(this.pendingHead);
-      this.pending = [];
-      this.pendingHead = 0;
-      for (const q of queue2) q.reject(e);
-      this.socket?.destroy();
     }
   }
-  /**
-   * 发送命令并等待响应（单连接严格有序）。未 ready 时入离线队列（enableOfflineQueue）或拒绝。
-   * opts.asBuffer=true：响应保留原始字节（Uint8Array）——getBuffer 等二进制场景。
-   */
-  command(name, ...args) {
-    const last = args[args.length - 1];
-    const opts = typeof last === "object" && last !== null && !(last instanceof Uint8Array) ? args.pop() : void 0;
-    if (this.status === "ready" && this.socket && !this.socket.destroyed) {
-      return this.sendNow(name, args, opts?.asBuffer);
+  const cron = async (expr, name, data) => {
+    const parsed = parseCron(expr);
+    const firstRun = nextRun(parsed, /* @__PURE__ */ new Date());
+    const def = JSON.stringify({ expr, name, data, nextRunAt: firstRun.getTime() });
+    await (await getConn()).command("HSET", cronsKey, name, def);
+  };
+  const cancelCron = async (name) => {
+    const removed = await (await getConn()).command("HDEL", cronsKey, name);
+    try {
+      const pending = await (await getConn()).command("ZRANGE", delayedKey, 0, -1);
+      for (const member of pending) {
+        if (member.includes(`"id":"cron:${name}:`)) {
+          await (await getConn()).command("ZREM", delayedKey, member);
+        }
+      }
+    } catch {
     }
-    if (this.closed || this.status === "closed" || !this.opts.enableOfflineQueue) {
-      return Promise.reject(new ConnectionError("redis: not connected"));
+    return removed === 1;
+  };
+  async function start() {
+    if (running) return;
+    running = true;
+    await getConn();
+    await tick();
+    tickTimer = setInterval(() => {
+      tick().catch((e) => console.error("[scheduler] tick:", e instanceof Error ? e.message : e));
+    }, tickMs);
+    tickTimer.unref?.();
+  }
+  const schedule = async (name, data, opts = {}) => {
+    const delayMs = opts.delayMs ?? 0;
+    const runAt = opts.when ? opts.when.getTime() : Date.now() + delayMs;
+    if (!Number.isFinite(runAt)) throw new Error("scheduler: invalid when/delayMs");
+    const id = randomUUID2();
+    const member = JSON.stringify({ id, name, data });
+    await (await getConn()).command("ZADD", delayedKey, runAt, member);
+    return { id };
+  };
+  const cancelSchedule = async (id) => {
+    try {
+      const pending = await (await getConn()).command("ZRANGE", delayedKey, 0, -1);
+      for (const member of pending) {
+        if (member.includes(`"id":"${id}"`)) {
+          const removed = await (await getConn()).command("ZREM", delayedKey, member);
+          if (removed === 1) return true;
+        }
+      }
+    } catch {
     }
-    if (this.offlineQueue.length >= this.opts.maxOfflineQueue) {
-      return Promise.reject(new ConnectionError(`redis: offline queue full (${this.opts.maxOfflineQueue})`));
+    return false;
+  };
+  const mw = (async (req, ctx, next) => {
+    ctx.schedule = schedule;
+    ctx.cron = cron;
+    ctx.cancelCron = cancelCron;
+    ctx.cancelSchedule = cancelSchedule;
+    return next(req, ctx);
+  });
+  mw.__meta = { injects: ["schedule", "cron", "cancelCron", "cancelSchedule"], depends: ["queue"] };
+  mw.schedule = schedule;
+  mw.cron = cron;
+  mw.cancelCron = cancelCron;
+  mw.cancelSchedule = cancelSchedule;
+  mw.close = async () => {
+    running = false;
+    if (tickTimer) {
+      clearInterval(tickTimer);
+      tickTimer = null;
     }
-    return new Promise((resolve3, reject) => {
-      this.offlineQueue.push({ name, args, resolve: resolve3, reject, asBuffer: opts?.asBuffer });
+    if (connPromise) await connPromise.then((c) => c.close()).catch(() => {
     });
-  }
-  sendNow(name, args, asBuffer) {
-    const start = performance.now();
-    return new Promise((resolve3, reject) => {
-      const p = {
-        resolve: resolve3,
-        reject,
-        asBuffer,
-        blocking: BLOCKING_COMMANDS.has(name.toUpperCase())
+  };
+  start().catch((e) => console.error("[scheduler] start:", e instanceof Error ? e.message : e));
+  return mw;
+}
+
+// src/ai/client.ts
+import { randomUUID as randomUUID3 } from "node:crypto";
+
+// src/ai/sse.ts
+function sseResponse(run, options) {
+  const encoder = new TextEncoder();
+  const stream = new ReadableStream({
+    async start(controller) {
+      const emit = (name, data) => {
+        controller.enqueue(encoder.encode(`event: ${name}
+data: ${JSON.stringify(data)}
+
+`));
       };
-      this.armTimeout(p);
-      this.pending.push(p);
-      this.armSocketTimeout();
-      this.socket.write(encodeCommand([name, ...args]), (err) => {
-        if (err) {
-          const idx = this.pending.indexOf(p);
-          if (idx >= 0) this.pending.splice(idx, 1);
-          p.reject(err instanceof Error ? err : new ConnectionError("redis: socket write failed"));
+      try {
+        await run(emit);
+        controller.close();
+      } catch (err) {
+        try {
+          emit("wf:error", {
+            code: "provider_error",
+            message: err instanceof Error ? err.message : String(err)
+          });
+          controller.close();
+        } catch {
+          controller.error(err);
         }
-      });
-    }).then(
-      (v) => {
-        if (this.opts.onCommand) this.opts.onCommand(name, args, performance.now() - start);
-        return v;
-      },
-      (e) => {
-        if (this.opts.onCommand) this.opts.onCommand(name, args, performance.now() - start);
-        throw e;
       }
-    );
-  }
-  /** 命令超时（commandTimeoutMs > 0）：超时标记 timedOut + 处理（阻塞命令 resolve(null)，其余 reject） */
-  armTimeout(p) {
-    const ms = this.opts.commandTimeoutMs;
-    if (ms <= 0) return;
-    p.timer = setTimeout(() => {
-      p.timedOut = true;
-      if (p.blocking) p.resolve(null);
-      else p.reject(new TimeoutError("redis: command timeout", ms));
-    }, ms);
-  }
-  /** socket 响应超时（socketTimeoutMs > 0）：期望数据但超时未达 → 僵尸连接 → 主动断开走标准重连 */
-  armSocketTimeout() {
-    const ms = this.opts.socketTimeoutMs;
-    if (ms <= 0) return;
-    this.clearSocketTimeout();
-    this.socketTimeoutTimer = setTimeout(() => {
-      this.socketTimeoutTimer = null;
-      const err = new ConnectionError(`redis: socket timeout (no data in ${ms}ms)`);
-      const queue2 = this.pending.slice(this.pendingHead);
-      this.pending = [];
-      this.pendingHead = 0;
-      for (const q of queue2) q.reject(err);
-      this.clearSocketTimeout();
-      this.socket?.destroy();
-    }, ms);
-  }
-  clearSocketTimeout() {
-    if (this.socketTimeoutTimer) {
-      clearTimeout(this.socketTimeoutTimer);
-      this.socketTimeoutTimer = null;
+    },
+    cancel() {
+      options?.onAbort?.();
     }
-  }
-  flushOffline() {
-    const queue2 = this.offlineQueue;
-    this.offlineQueue = [];
-    for (const q of queue2) {
-      this.sendNow(q.name, q.args, q.asBuffer).then(q.resolve, q.reject);
+  });
+  return new Response(stream, {
+    headers: {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache",
+      Connection: "keep-alive"
     }
+  });
+}
+
+// src/ai/client.ts
+var AiError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "AiError";
+    this.code = code;
   }
-  /** 批量执行：一次 write 发送所有命令字节，响应按序路由（管道） */
-  batch(payload, count) {
-    if (this.status !== "ready" || !this.socket) {
-      return Promise.reject(new ConnectionError("redis: not connected"));
-    }
-    return new Promise((resolve3, reject) => {
-      const results = [];
-      const batchPending = [];
-      let settled = false;
-      const maybeResolve = () => {
-        if (settled) return;
-        if (results.length === count) {
-          settled = true;
-          if (batchTimer) clearTimeout(batchTimer);
-          resolve3(results);
+};
+async function* parseProviderSse(stream) {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith(":")) continue;
+        const data = trimmed.startsWith("data: ") ? trimmed.slice(6) : trimmed;
+        if (data === "[DONE]") return;
+        try {
+          yield JSON.parse(data);
+        } catch {
         }
-      };
-      for (let i = 0; i < count; i++) {
-        const p = {
-          // 正常响应与错误响应（RespError）都作为结果值收集——管道语义
-          resolve: (v) => {
-            results.push(v);
-            maybeResolve();
-          },
-          reject: (e) => {
-            results.push(e);
-            maybeResolve();
-          }
-        };
-        batchPending.push(p);
-        this.pending.push(p);
-      }
-      let batchTimer;
-      const ms = this.opts.commandTimeoutMs;
-      if (ms > 0) {
-        batchTimer = setTimeout(() => {
-          settled = true;
-          for (const p of batchPending) p.timedOut = true;
-          reject(new TimeoutError("redis: batch timeout", ms));
-        }, ms);
       }
-      this.socket.write(payload);
-      this.armSocketTimeout();
-    });
-  }
-  /** 订阅频道：回调式（channel, message） */
-  async subscribe(channel, fn) {
-    this.subs.set(channel, fn);
-    await this.command("SUBSCRIBE", channel);
+    }
+  } finally {
+    reader.releaseLock();
   }
-  /** 订阅模式：回调式（channel, message） */
-  async psubscribe(pattern, fn) {
-    this.psubs.set(pattern, fn);
-    await this.command("PSUBSCRIBE", pattern);
+}
+async function providerError(res) {
+  let message = "";
+  try {
+    const body = await res.json();
+    message = body?.error?.message ?? JSON.stringify(body);
+  } catch {
+    message = await res.text().catch(() => "");
   }
-  /** 旁路分发订阅消息（RESP 数组路由到回调） */
-  dispatchSubscribe(value) {
-    const [type, a, b] = value;
-    if (type === "message") {
-      const fn = this.subs.get(a);
-      fn?.(a, b);
-    } else if (type === "pmessage") {
-      const fn = this.psubs.get(a);
-      fn?.(b, value[3] ?? "");
+  const status = res.status;
+  let code;
+  if (status === 401 || status === 403) code = "auth_failed";
+  else if (status === 429) code = "rate_limited";
+  else if (status >= 500) code = "provider_error";
+  else if (/context|token|length/i.test(message)) code = "context_length";
+  else if (status === 400) code = "invalid_request";
+  else code = "provider_error";
+  return { code, message: message || `provider error (${status})` };
+}
+function createEmbeddingClient(ebd) {
+  const apiKey = ebd?.apiKey ?? process.env.DASHSCOPE_API_KEY ?? "";
+  const configured = !!(ebd?.apiKey || process.env.DASHSCOPE_API_KEY);
+  const baseUrl = ebd?.baseUrl ?? process.env.DASHSCOPE_BASE_URL ?? "https://dashscope.aliyuncs.com/compatible-mode/v1";
+  const defaultModel = ebd?.defaultModel ?? process.env.DASHSCOPE_EMBEDDING_MODEL ?? "text-embedding-v4";
+  const endpoint = `${baseUrl.replace(/\/$/, "")}/embeddings`;
+  const headers = { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` };
+  async function embedMany(texts) {
+    if (!configured) {
+      throw new AiError("unsupported", "ai embedding: \u672A\u914D\u7F6E\u2014\u2014\u4F20 ai({ embedding }) \u6216\u8BBE DASHSCOPE_API_KEY\uFF08DeepSeek \u65E0 embedding API\uFF0C\u9700\u72EC\u7ACB provider\uFF09");
     }
-  }
-  /** 主动关闭——不再重连 */
-  async close() {
-    this.closed = true;
-    this.status = "closed";
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = null;
+    if (!apiKey) {
+      throw new AiError("auth_failed", "ai embedding: DASHSCOPE_API_KEY \u672A\u8BBE\u7F6E");
     }
-    this.clearSocketTimeout();
-    const queue2 = this.pending.slice(this.pendingHead);
-    this.pending = [];
-    this.pendingHead = 0;
-    for (const p of queue2) p.reject(new ConnectionError("redis: connection closed"));
-    const oq = this.offlineQueue;
-    this.offlineQueue = [];
-    for (const q of oq) q.reject(new ConnectionError("redis: connection closed"));
-    const sock = this.socket;
-    this.socket = null;
-    sock?.destroy();
-  }
-  get connected() {
-    return this.status === "ready";
-  }
-};
-
-// src/scheduler/cron.ts
-var RANGES = [
-  [0, 59],
-  // 分
-  [0, 23],
-  // 时
-  [1, 31],
-  // 日
-  [1, 12],
-  // 月
-  [0, 6]
-  // 周
-];
-function parseField(field, idx) {
-  const [min, max] = RANGES[idx];
-  const name = ["minute", "hour", "day", "month", "weekday"][idx];
-  if (field === "*") return null;
-  if (field.startsWith("*/")) {
-    const n = Number(field.slice(2));
-    if (!Number.isInteger(n) || n <= 0 || n > max) {
-      throw new Error(`cron: invalid step '${field}' in ${name} field (must be 1..${max})`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 3e3);
+    let res;
+    try {
+      res = await fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ model: defaultModel, input: texts }),
+        signal: controller.signal
+      });
+    } catch (err) {
+      if (controller.signal.aborted) throw new AiError("provider_error", "embedding \u8BF7\u6C42\u8D85\u65F6\uFF083s\uFF09");
+      throw new AiError("provider_error", err instanceof Error ? err.message : String(err));
+    } finally {
+      clearTimeout(timer);
     }
-    const set2 = /* @__PURE__ */ new Set();
-    for (let v = min; v <= max; v += n) set2.add(v);
-    return set2;
-  }
-  const set = /* @__PURE__ */ new Set();
-  for (const part of field.split(",")) {
-    if (part === "") throw new Error(`cron: empty item in '${field}' (${name})`);
-    if (part.includes("-")) {
-      const [rangePart, stepPart] = part.split("/");
-      const step = stepPart !== void 0 ? Number(stepPart) : 1;
-      const [a, b] = rangePart.split("-").map(Number);
-      if (!Number.isInteger(a) || !Number.isInteger(b) || a < min || b > max || a > b) {
-        throw new Error(`cron: invalid range '${part}' in ${name} field (${min}..${max})`);
-      }
-      if (!Number.isInteger(step) || step <= 0) throw new Error(`cron: invalid step in '${part}'`);
-      for (let v = a; v <= b; v += step) set.add(v);
-    } else {
-      const v = Number(part);
-      if (!Number.isInteger(v) || v < min || v > max) {
-        throw new Error(`cron: value '${part}' out of range ${min}..${max} in ${name} field`);
-      }
-      set.add(v);
+    if (!res.ok) {
+      const { code, message } = await providerError(res);
+      throw new AiError(code, message);
     }
+    const data = await res.json();
+    data.data.sort((a, b) => a.index - b.index);
+    return data.data.map((item) => item.embedding);
   }
-  return set;
-}
-function parseCron(expr) {
-  const parts = expr.trim().split(/\s+/);
-  if (parts.length !== 5) {
-    throw new Error(`cron: expected 5 fields (min hour dom month dow), got ${parts.length}: '${expr}'`);
-  }
-  const fields = parts.map((p, i) => parseField(p, i));
   return {
-    fields: fields.map((values) => ({ values })),
-    domExplicit: fields[2] !== null,
-    dowExplicit: fields[4] !== null
+    async embed(text) {
+      const results = await embedMany([text]);
+      return results[0];
+    },
+    embedMany
   };
 }
-function fieldMatches(values, v) {
-  if (values === null) return true;
-  return values.has(v);
-}
-function dayMatches(expr, dom, dow) {
-  const domOk = fieldMatches(expr.fields[2].values, dom);
-  const dowOk = fieldMatches(expr.fields[4].values, dow);
-  if (expr.domExplicit && expr.dowExplicit) return domOk || dowOk;
-  if (expr.domExplicit) return domOk;
-  if (expr.dowExplicit) return dowOk;
-  return true;
-}
-function nextMatch(values, v, min, max) {
-  if (values === null) return v;
-  for (let x = v; x <= max; x++) if (values.has(x)) return x;
-  return null;
-}
-function nextRun(expr, from) {
-  const d = new Date(from.getTime());
-  d.setSeconds(0, 0);
-  d.setMinutes(d.getMinutes() + 1);
-  const deadline = from.getTime() + 5 * 366 * 24 * 3600 * 1e3;
-  while (d.getTime() <= deadline) {
-    const year = d.getFullYear();
-    const month = d.getMonth() + 1;
-    const dom = d.getDate();
-    const dow = d.getDay();
-    if (!fieldMatches(expr.fields[3].values, month)) {
-      d.setMonth(month, 1);
-      d.setHours(0, 0, 0, 0);
-      d.setMonth(month);
-      continue;
-    }
-    if (!dayMatches(expr, dom, dow)) {
-      d.setDate(dom + 1);
-      d.setHours(0, 0, 0, 0);
-      continue;
+function createAiClient(opts) {
+  const endpoint = `${opts.baseUrl.replace(/\/$/, "")}/chat/completions`;
+  const headers = { "Content-Type": "application/json", Authorization: `Bearer ${opts.apiKey}` };
+  const embedding = createEmbeddingClient(opts.embedding);
+  const approvals = /* @__PURE__ */ new Map();
+  function approve(response) {
+    const resolve3 = approvals.get(response.id);
+    if (!resolve3) return false;
+    approvals.delete(response.id);
+    resolve3(response);
+    return true;
+  }
+  async function waitApproval(req, emit, timeoutMs = DEFAULT_APPROVAL_TIMEOUT) {
+    const expiresAt = Date.now() + timeoutMs;
+    emit("wf:approval_request", { ...req, expiresAt });
+    return new Promise((resolve3) => {
+      const timer = setTimeout(() => {
+        if (approvals.has(req.id)) {
+          approvals.delete(req.id);
+          resolve3({ id: req.id, decision: "rejected" });
+        }
+      }, timeoutMs);
+      approvals.set(req.id, (resp) => {
+        clearTimeout(timer);
+        resolve3(resp);
+      });
+    });
+  }
+  function aggregateToolCalls(chunks) {
+    const calls = [];
+    for (const chunk of chunks) {
+      const delta = chunk.choices[0]?.delta;
+      if (!delta?.tool_calls) continue;
+      for (const tc of delta.tool_calls) {
+        if (tc.id) {
+          calls.push(tc);
+        } else if (calls.length > 0) {
+          const last = calls[calls.length - 1];
+          if (tc.function?.arguments) last.function.arguments += tc.function.arguments;
+        }
+      }
     }
-    const hour = d.getHours();
-    const nextHour = nextMatch(expr.fields[1].values, hour, 0, 23);
-    if (nextHour === null) {
-      d.setDate(dom + 1);
-      d.setHours(0, 0, 0, 0);
-      continue;
+    return calls;
+  }
+  async function chat(params, options) {
+    const res = await fetch(endpoint, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({ ...params, model: params.model ?? opts.defaultModel, stream: false }),
+      signal: options?.signal
+    });
+    if (!res.ok) {
+      const { code, message } = await providerError(res);
+      throw new AiError(code, message);
     }
-    if (nextHour !== hour) {
-      d.setHours(nextHour, 0, 0, 0);
-      continue;
+    return res.json();
+  }
+  function stream(params, options) {
+    const controller = new AbortController();
+    const external = options?.signal;
+    if (external) {
+      if (external.aborted) controller.abort();
+      else external.addEventListener("abort", () => controller.abort(), { once: true });
     }
-    const minute = d.getMinutes();
-    const nextMinute = nextMatch(expr.fields[0].values, minute, 0, 59);
-    if (nextMinute === null) {
-      d.setHours(hour + 1, 0, 0, 0);
-      continue;
-    }
-    if (nextMinute !== minute) {
-      d.setMinutes(nextMinute, 0, 0);
-      continue;
-    }
-    return d;
+    return sseResponse(
+      async (emit) => {
+        emit("wf:message_start", { id: options?.traceId ?? randomUUID3() });
+        await streamStep(params, {
+          emit,
+          signal: controller.signal,
+          onFinish: (r) => emit("wf:done", { content: r.content, usage: r.usage })
+        });
+      },
+      { onAbort: () => controller.abort() }
+    );
   }
-  throw new Error("cron: no next run within 5 years (invalid expression?)");
-}
-
-// src/scheduler/index.ts
-function parseUrl(options) {
-  const url = options?.url ?? process.env.REDIS_URL ?? "redis://localhost:6379";
-  const u = new URL(url);
-  return { host: u.hostname, port: Number(u.port || 6379) };
-}
-function scheduler(options) {
-  const prefix = options.prefix ?? "wf:sched:";
-  const tickMs = options.tickMs ?? 1e3;
-  const delayedKey = `${prefix}delayed`;
-  const cronsKey = `${prefix}crons`;
-  const connOpts = parseUrl(options);
-  const queueModule = options.queue;
-  const conn = new RedisConnection(connOpts);
-  let running = false;
-  let tickTimer = null;
-  async function tick() {
-    await tickCrons();
-    let due;
+  async function streamStep(params, stepOpts) {
+    const { emit, signal } = stepOpts;
+    let res;
     try {
-      due = await conn.command("ZRANGEBYSCORE", delayedKey, 0, Date.now());
-    } catch {
+      res = await fetch(endpoint, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ ...params, model: params.model ?? opts.defaultModel, stream: true }),
+        signal
+      });
+    } catch (err) {
+      if (signal?.aborted) return;
+      emit("wf:error", { code: "provider_error", message: err instanceof Error ? err.message : String(err) });
       return;
     }
-    for (const member of due) {
-      let removed;
-      try {
-        removed = await conn.command("ZREM", delayedKey, member);
-      } catch {
-        return;
-      }
-      if (removed !== 1) continue;
-      try {
-        const task = JSON.parse(member);
-        await queueModule.queue.add(task.name, task.data);
-      } catch (e) {
-        console.error("[scheduler] enqueue:", e instanceof Error ? e.message : e);
-      }
-    }
-  }
-  async function tickCrons() {
-    let crons;
-    try {
-      crons = await conn.command("HGETALL", cronsKey);
-    } catch {
+    if (!res.ok) {
+      const { code, message } = await providerError(res);
+      emit("wf:error", { code, message });
       return;
     }
-    const now = Date.now();
-    const entries = crons;
-    for (let i = 0; i + 1 < entries.length; i += 2) {
-      const field = entries[i];
-      const value = entries[i + 1];
-      let def;
-      try {
-        def = JSON.parse(value);
-      } catch {
-        continue;
-      }
-      const parsed = parseCron(def.expr);
-      let next = def.nextRunAt;
-      while (next <= now) {
-        const ts = next;
-        const member = JSON.stringify({ id: `cron:${field}:${ts}`, name: def.name, data: def.data });
-        try {
-          await conn.command("ZADD", delayedKey, "NX", ts, member);
-        } catch {
-          break;
-        }
-        next = nextRun(parsed, new Date(ts)).getTime();
-      }
-      if (next !== def.nextRunAt) {
-        await conn.command("HSET", cronsKey, field, JSON.stringify({ ...def, nextRunAt: next }));
-      }
-    }
-  }
-  const cron = async (expr, name, data) => {
-    const parsed = parseCron(expr);
-    const firstRun = nextRun(parsed, /* @__PURE__ */ new Date());
-    const def = JSON.stringify({ expr, name, data, nextRunAt: firstRun.getTime() });
-    await conn.command("HSET", cronsKey, name, def);
-  };
-  const cancelCron = async (name) => {
-    const removed = await conn.command("HDEL", cronsKey, name);
+    let content = "";
+    let reasoning = "";
+    const chunks = [];
+    let usage;
     try {
-      const pending = await conn.command("ZRANGE", delayedKey, 0, -1);
-      for (const member of pending) {
-        if (member.includes(`"id":"cron:${name}:`)) {
-          await conn.command("ZREM", delayedKey, member);
+      for await (const chunk of parseProviderSse(res.body)) {
+        if (signal?.aborted) return;
+        const delta = chunk.choices[0]?.delta;
+        if (delta?.content) {
+          content += delta.content;
+          emit("wf:token", { text: delta.content });
         }
+        if (delta?.reasoning_content) reasoning += delta.reasoning_content;
+        if (delta?.tool_calls) chunks.push(chunk);
+        if (chunk.usage) usage = chunk.usage;
       }
-    } catch {
+    } catch (err) {
+      if (signal?.aborted) return;
+      emit("wf:error", { code: "provider_error", message: err instanceof Error ? err.message : String(err) });
+      return;
     }
-    return removed === 1;
-  };
-  async function start() {
-    if (running) return;
-    running = true;
-    await conn.connect();
-    await tick();
-    tickTimer = setInterval(() => {
-      tick().catch((e) => console.error("[scheduler] tick:", e instanceof Error ? e.message : e));
-    }, tickMs);
-    tickTimer.unref?.();
-  }
-  const schedule = async (name, data, opts = {}) => {
-    const delayMs = opts.delayMs ?? 0;
-    const runAt = opts.when ? opts.when.getTime() : Date.now() + delayMs;
-    if (!Number.isFinite(runAt)) throw new Error("scheduler: invalid when/delayMs");
-    const id = randomUUID2();
-    const member = JSON.stringify({ id, name, data });
-    await conn.command("ZADD", delayedKey, runAt, member);
-    return { id };
-  };
-  const cancelSchedule = async (id) => {
-    try {
-      const pending = await conn.command("ZRANGE", delayedKey, 0, -1);
-      for (const member of pending) {
-        if (member.includes(`"id":"${id}"`)) {
-          const removed = await conn.command("ZREM", delayedKey, member);
-          if (removed === 1) return true;
-        }
-      }
-    } catch {
+    const toolCalls = aggregateToolCalls(chunks);
+    for (const tc of toolCalls) {
+      emit("wf:tool_call", {
+        id: tc.id,
+        name: tc.function?.name ?? "",
+        args: safeParseArgs(tc.function?.arguments ?? "")
+      });
     }
-    return false;
-  };
-  const mw = (async (req, ctx, next) => {
-    ctx.schedule = schedule;
-    ctx.cron = cron;
-    ctx.cancelCron = cancelCron;
-    ctx.cancelSchedule = cancelSchedule;
-    return next(req, ctx);
-  });
-  mw.__meta = { injects: ["schedule", "cron", "cancelCron", "cancelSchedule"], depends: ["queue"] };
-  mw.schedule = schedule;
-  mw.cron = cron;
-  mw.cancelCron = cancelCron;
-  mw.cancelSchedule = cancelSchedule;
-  mw.close = async () => {
-    running = false;
-    if (tickTimer) {
-      clearInterval(tickTimer);
-      tickTimer = null;
+    if (usage && stepOpts.emitUsage !== false) emit("wf:usage", usage);
+    stepOpts.onFinish?.({ content, reasoning_content: reasoning || void 0, toolCalls, usage });
+  }
+  function sse(run, options) {
+    const controller = new AbortController();
+    const external = options?.signal;
+    if (external) {
+      if (external.aborted) controller.abort();
+      else external.addEventListener("abort", () => controller.abort(), { once: true });
     }
-    await conn.close().catch(() => {
-    });
+    return sseResponse(run, { onAbort: () => controller.abort() });
+  }
+  return {
+    chat,
+    stream,
+    sse,
+    streamStep,
+    waitApproval,
+    approve,
+    // embedding：未配置 provider 时明确抛 AiError（诚实裁剪：不静默降级）
+    embed: (text) => embedding.embed(text),
+    embedMany: (texts) => embedding.embedMany(texts)
   };
-  start().catch((e) => console.error("[scheduler] start:", e instanceof Error ? e.message : e));
-  return mw;
 }
-
-// src/ai/client.ts
-import { randomUUID as randomUUID3 } from "node:crypto";
-
-// src/ai/sse.ts
-function sseResponse(run, options) {
-  const encoder = new TextEncoder();
-  const stream = new ReadableStream({
-    async start(controller) {
-      const emit = (name, data) => {
-        controller.enqueue(encoder.encode(`event: ${name}
-data: ${JSON.stringify(data)}
-
-`));
-      };
-      try {
-        await run(emit);
-        controller.close();
-      } catch (err) {
-        try {
-          emit("wf:error", {
-            code: "provider_error",
-            message: err instanceof Error ? err.message : String(err)
-          });
-          controller.close();
-        } catch {
-          controller.error(err);
-        }
-      }
-    },
-    cancel() {
-      options?.onAbort?.();
-    }
-  });
-  return new Response(stream, {
-    headers: {
-      "Content-Type": "text/event-stream",
-      "Cache-Control": "no-cache",
-      Connection: "keep-alive"
-    }
-  });
-}
-
-// src/ai/client.ts
-var AiError = class extends Error {
-  code;
-  constructor(code, message) {
-    super(message);
-    this.name = "AiError";
-    this.code = code;
-  }
-};
-async function* parseProviderSse(stream) {
-  const reader = stream.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      buffer += decoder.decode(value, { stream: true });
-      const lines = buffer.split("\n");
-      buffer = lines.pop() ?? "";
-      for (const line of lines) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith(":")) continue;
-        const data = trimmed.startsWith("data: ") ? trimmed.slice(6) : trimmed;
-        if (data === "[DONE]") return;
-        try {
-          yield JSON.parse(data);
-        } catch {
-        }
-      }
-    }
-  } finally {
-    reader.releaseLock();
-  }
-}
-async function providerError(res) {
-  let message = "";
-  try {
-    const body = await res.json();
-    message = body?.error?.message ?? JSON.stringify(body);
-  } catch {
-    message = await res.text().catch(() => "");
-  }
-  const status = res.status;
-  let code;
-  if (status === 401 || status === 403) code = "auth_failed";
-  else if (status === 429) code = "rate_limited";
-  else if (status >= 500) code = "provider_error";
-  else if (/context|token|length/i.test(message)) code = "context_length";
-  else if (status === 400) code = "invalid_request";
-  else code = "provider_error";
-  return { code, message: message || `provider error (${status})` };
-}
-function createEmbeddingClient(ebd) {
-  const apiKey = ebd?.apiKey ?? process.env.DASHSCOPE_API_KEY ?? "";
-  const configured = !!(ebd?.apiKey || process.env.DASHSCOPE_API_KEY);
-  const baseUrl = ebd?.baseUrl ?? process.env.DASHSCOPE_BASE_URL ?? "https://dashscope.aliyuncs.com/compatible-mode/v1";
-  const defaultModel = ebd?.defaultModel ?? process.env.DASHSCOPE_EMBEDDING_MODEL ?? "text-embedding-v4";
-  const endpoint = `${baseUrl.replace(/\/$/, "")}/embeddings`;
-  const headers = { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` };
-  async function embedMany(texts) {
-    if (!configured) {
-      throw new AiError("unsupported", "ai embedding: \u672A\u914D\u7F6E\u2014\u2014\u4F20 ai({ embedding }) \u6216\u8BBE DASHSCOPE_API_KEY\uFF08DeepSeek \u65E0 embedding API\uFF0C\u9700\u72EC\u7ACB provider\uFF09");
-    }
-    if (!apiKey) {
-      throw new AiError("auth_failed", "ai embedding: DASHSCOPE_API_KEY \u672A\u8BBE\u7F6E");
-    }
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), 3e3);
-    let res;
-    try {
-      res = await fetch(endpoint, {
-        method: "POST",
-        headers,
-        body: JSON.stringify({ model: defaultModel, input: texts }),
-        signal: controller.signal
-      });
-    } catch (err) {
-      if (controller.signal.aborted) throw new AiError("provider_error", "embedding \u8BF7\u6C42\u8D85\u65F6\uFF083s\uFF09");
-      throw new AiError("provider_error", err instanceof Error ? err.message : String(err));
-    } finally {
-      clearTimeout(timer);
-    }
-    if (!res.ok) {
-      const { code, message } = await providerError(res);
-      throw new AiError(code, message);
-    }
-    const data = await res.json();
-    data.data.sort((a, b) => a.index - b.index);
-    return data.data.map((item) => item.embedding);
-  }
-  return {
-    async embed(text) {
-      const results = await embedMany([text]);
-      return results[0];
-    },
-    embedMany
-  };
-}
-function createAiClient(opts) {
-  const endpoint = `${opts.baseUrl.replace(/\/$/, "")}/chat/completions`;
-  const headers = { "Content-Type": "application/json", Authorization: `Bearer ${opts.apiKey}` };
-  const embedding = createEmbeddingClient(opts.embedding);
-  const approvals = /* @__PURE__ */ new Map();
-  function approve(response) {
-    const resolve3 = approvals.get(response.id);
-    if (!resolve3) return false;
-    approvals.delete(response.id);
-    resolve3(response);
-    return true;
-  }
-  async function waitApproval(req, emit, timeoutMs = DEFAULT_APPROVAL_TIMEOUT) {
-    const expiresAt = Date.now() + timeoutMs;
-    emit("wf:approval_request", { ...req, expiresAt });
-    return new Promise((resolve3) => {
-      const timer = setTimeout(() => {
-        if (approvals.has(req.id)) {
-          approvals.delete(req.id);
-          resolve3({ id: req.id, decision: "rejected" });
-        }
-      }, timeoutMs);
-      approvals.set(req.id, (resp) => {
-        clearTimeout(timer);
-        resolve3(resp);
-      });
-    });
-  }
-  function aggregateToolCalls(chunks) {
-    const calls = [];
-    for (const chunk of chunks) {
-      const delta = chunk.choices[0]?.delta;
-      if (!delta?.tool_calls) continue;
-      for (const tc of delta.tool_calls) {
-        if (tc.id) {
-          calls.push(tc);
-        } else if (calls.length > 0) {
-          const last = calls[calls.length - 1];
-          if (tc.function?.arguments) last.function.arguments += tc.function.arguments;
-        }
-      }
-    }
-    return calls;
-  }
-  async function chat(params, options) {
-    const res = await fetch(endpoint, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({ ...params, model: params.model ?? opts.defaultModel, stream: false }),
-      signal: options?.signal
-    });
-    if (!res.ok) {
-      const { code, message } = await providerError(res);
-      throw new AiError(code, message);
-    }
-    return res.json();
-  }
-  function stream(params, options) {
-    const controller = new AbortController();
-    const external = options?.signal;
-    if (external) {
-      if (external.aborted) controller.abort();
-      else external.addEventListener("abort", () => controller.abort(), { once: true });
-    }
-    return sseResponse(
-      async (emit) => {
-        emit("wf:message_start", { id: options?.traceId ?? randomUUID3() });
-        await streamStep(params, {
-          emit,
-          signal: controller.signal,
-          onFinish: (r) => emit("wf:done", { content: r.content, usage: r.usage })
-        });
-      },
-      { onAbort: () => controller.abort() }
-    );
-  }
-  async function streamStep(params, stepOpts) {
-    const { emit, signal } = stepOpts;
-    let res;
-    try {
-      res = await fetch(endpoint, {
-        method: "POST",
-        headers,
-        body: JSON.stringify({ ...params, model: params.model ?? opts.defaultModel, stream: true }),
-        signal
-      });
-    } catch (err) {
-      if (signal?.aborted) return;
-      emit("wf:error", { code: "provider_error", message: err instanceof Error ? err.message : String(err) });
-      return;
-    }
-    if (!res.ok) {
-      const { code, message } = await providerError(res);
-      emit("wf:error", { code, message });
-      return;
-    }
-    let content = "";
-    let reasoning = "";
-    const chunks = [];
-    let usage;
-    try {
-      for await (const chunk of parseProviderSse(res.body)) {
-        if (signal?.aborted) return;
-        const delta = chunk.choices[0]?.delta;
-        if (delta?.content) {
-          content += delta.content;
-          emit("wf:token", { text: delta.content });
-        }
-        if (delta?.reasoning_content) reasoning += delta.reasoning_content;
-        if (delta?.tool_calls) chunks.push(chunk);
-        if (chunk.usage) usage = chunk.usage;
-      }
-    } catch (err) {
-      if (signal?.aborted) return;
-      emit("wf:error", { code: "provider_error", message: err instanceof Error ? err.message : String(err) });
-      return;
-    }
-    const toolCalls = aggregateToolCalls(chunks);
-    for (const tc of toolCalls) {
-      emit("wf:tool_call", {
-        id: tc.id,
-        name: tc.function?.name ?? "",
-        args: safeParseArgs(tc.function?.arguments ?? "")
-      });
-    }
-    if (usage && stepOpts.emitUsage !== false) emit("wf:usage", usage);
-    stepOpts.onFinish?.({ content, reasoning_content: reasoning || void 0, toolCalls, usage });
-  }
-  function sse(run, options) {
-    const controller = new AbortController();
-    const external = options?.signal;
-    if (external) {
-      if (external.aborted) controller.abort();
-      else external.addEventListener("abort", () => controller.abort(), { once: true });
-    }
-    return sseResponse(run, { onAbort: () => controller.abort() });
-  }
-  return {
-    chat,
-    stream,
-    sse,
-    streamStep,
-    waitApproval,
-    approve,
-    // embedding：未配置 provider 时明确抛 AiError（诚实裁剪：不静默降级）
-    embed: (text) => embedding.embed(text),
-    embedMany: (texts) => embedding.embedMany(texts)
-  };
-}
-var DEFAULT_APPROVAL_TIMEOUT = 5 * 6e4;
-function safeParseArgs(raw) {
-  if (!raw) return {};
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return {};
-  }
+var DEFAULT_APPROVAL_TIMEOUT = 5 * 6e4;
+function safeParseArgs(raw) {
+  if (!raw) return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
 }
 
 // src/ai/agent.ts
@@ -3540,7 +2977,7 @@ function createAgent(client, config) {
       if (signal?.aborted) return;
       if (!finish.toolCalls?.length) {
         emit("wf:usage", usage);
-        emit("wf:done", { content: finish.content, usage });
+        emit("wf:done", { content: finish.content, usage, reasoning: finish.reasoning_content });
         return;
       }
       all.push({
@@ -3641,338 +3078,43 @@ var HtmlSafe = class {
 var Fragment = /* @__PURE__ */ Symbol("Fragment");
 var Portal = /* @__PURE__ */ Symbol("Portal");
 
-// src/ui-dom/debug.ts
-var _enabled = null;
-function uiDebugEnabled() {
-  if (_enabled !== null) return _enabled;
-  _enabled = typeof process !== "undefined" && process.env?.UI_DEBUG === "1" || globalThis.__UI_DEBUG === true || typeof localStorage !== "undefined" && localStorage.getItem("__UI_DEBUG") === "1";
-  return _enabled;
-}
-var _depth = 0;
-var counters = /* @__PURE__ */ new Map();
-function uiLog(label, msg, opts) {
-  if (!uiDebugEnabled()) return;
-  const n = (counters.get(label) ?? 0) + 1;
-  counters.set(label, n);
-  const first = 10;
-  const every = opts?.throttle ?? 100;
-  if (n > first && n % every !== 0) return;
-  const d = opts?.depth !== void 0 ? opts.depth : _depth;
-  const indent = "  ".repeat(Math.min(d, 30));
-  console.log(`[ui-debug] ${indent}${label}#${n} ${msg}`);
+// src/ui-dom/vdom/ssr.ts
+var VOID_TAGS = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
+var SVG_TAGS = /* @__PURE__ */ new Set(["svg", "path", "circle", "rect", "line", "polyline", "polygon", "g", "text", "defs", "use", "clipPath"]);
+function escape(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-
-// src/ui-dom/reactive.ts
-function createReactiveState(dirty) {
-  const _debugSets = /* @__PURE__ */ new Map();
-  const _dbg = (key, label) => {
-    const n = (_debugSets.get(key) ?? 0) + 1;
-    _debugSets.set(key, n);
-    if (n <= 5 || n % 100 === 0) uiLog(label, key + " count=" + n, { throttle: 100 });
-  };
-  const proxyCache = /* @__PURE__ */ new WeakMap();
-  const watchers = /* @__PURE__ */ new Set();
-  const reactive = (target) => {
-    if (target === null || typeof target !== "object") return target;
-    if (target instanceof Set || target instanceof Map) {
-      if (proxyCache.has(target)) return proxyCache.get(target);
-      const MUTATING = target instanceof Set ? /* @__PURE__ */ new Set(["add", "delete", "clear"]) : /* @__PURE__ */ new Set(["set", "delete", "clear"]);
-      const proxy2 = new Proxy(target, {
-        get(t, prop) {
-          const v = Reflect.get(t, prop);
-          if (typeof v === "function") {
-            if (!MUTATING.has(String(prop))) return v.bind(t);
-            return (...args) => {
-              const result = v.apply(t, args);
-              dirty();
-              for (const w of watchers) w();
-              return result;
-            };
-          }
-          return v;
-        },
-        set(t, key, value) {
-          Reflect.set(t, key, value);
-          _dbg(String(key), "set");
-          dirty();
-          for (const w of watchers) w();
-          return true;
-        }
-      });
-      proxyCache.set(target, proxy2);
-      return proxy2;
-    }
-    if (target instanceof Date || target instanceof RegExp) return target;
-    if (proxyCache.has(target)) return proxyCache.get(target);
-    const proxy = new Proxy(target, {
-      set(target2, key, value) {
-        const old = Reflect.get(target2, key);
-        if (old === value) return true;
-        Reflect.set(target2, key, value);
-        dirty();
-        for (const w of watchers) w();
-        return true;
-      },
-      get(target2, key) {
-        const value = Reflect.get(target2, key);
-        if (typeof value === "object" && value !== null) return reactive(value);
-        return value;
-      },
-      deleteProperty(target2, key) {
-        if (Reflect.has(target2, key)) {
-          Reflect.deleteProperty(target2, key);
-          dirty();
-          for (const w of watchers) w();
-        }
-        return true;
-      }
-    });
-    proxyCache.set(target, proxy);
-    return proxy;
-  };
-  const root = reactive({});
-  Object.defineProperty(root, "__watch", {
-    value: (cb) => {
-      watchers.add(cb);
-      return () => {
-        watchers.delete(cb);
-      };
-    },
-    writable: false,
-    enumerable: false
-  });
-  return root;
-}
-
-// src/ui/ssr.ts
-function escape(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
-var VOID_TAGS = /* @__PURE__ */ new Set([
-  "area",
-  "base",
-  "br",
-  "col",
-  "embed",
-  "hr",
-  "img",
-  "input",
-  "link",
-  "meta",
-  "param",
-  "source",
-  "track",
-  "wbr"
-]);
 function classToString(v) {
   if (typeof v === "string") return v;
   if (Array.isArray(v)) return v.filter(Boolean).join(" ");
-  if (v && typeof v === "object") {
-    return Object.entries(v).filter(([, b]) => b).map(([k]) => k).join(" ");
-  }
+  if (v && typeof v === "object") return Object.entries(v).filter(([, on]) => on).map(([k]) => k).join(" ");
   return "";
 }
 function styleToString(v) {
-  if (typeof v === "string") return v;
-  if (v && typeof v === "object") {
-    return Object.entries(v).filter(([, x]) => x != null).map(([k, x]) => `${k}:${typeof x === "number" ? x + "px" : String(x)}`).join(";");
-  }
-  return "";
-}
-function createSsrContext(serverCtx, dataStore) {
-  const usedIds = /* @__PURE__ */ new Set();
-  const ui2 = {
-    $: () => createReactiveState(() => {
-    }),
-    dirty: () => {
-    },
-    render: () => {
-    },
-    selfId: (name) => {
-      if (usedIds.has(name)) throw new Error(`[weifuwu] Duplicate component ID: "${name}"`);
-      usedIds.add(name);
-    },
-    useMedia: () => {
-    },
-    useBreakpoint: () => {
-    },
-    usePopupPosition: () => ({ top: 0, left: 0, refresh: () => {
-    } }),
-    // 新原语族：SSR 确定性 no-op（不启动监听/会话/取数；组件挂载不崩即契约）
-    useHoverCapable: () => false,
-    useVisualViewport: () => ({ height: 0, offsetTop: 0, keyboardOpen: false }),
-    useLongPress: () => ({}),
-    useInView: () => ({ isIn: false, ready: false, observe: () => {
-    }, refresh: () => {
-    }, disconnect: () => {
-    } }),
-    useScrollPosition: () => ({ y: 0, refresh: () => {
-    } }),
-    useStableRef: (init) => (el) => {
-      if (el) init?.(el);
-    },
-    useGlobalKey: () => () => {
-    },
-    useReducedMotion: () => false,
-    useAnimationEnd: () => () => {
-    },
-    useTween: (target) => {
-      const handle = { value: target, reset: (to) => {
-        handle.value = to;
-      } };
-      return handle;
-    },
-    useDrag: () => ({ onPointerDown: () => {
-    } }),
-    useDragDrop: () => ({ dropProps: {}, dragProps: {} }),
-    useControlled: (options) => ({
-      value: options.value,
-      setValue: (v) => {
-        options.onChange?.(v);
-      },
-      controlled: options.value !== void 0
-    }),
-    useControlledInput: (options) => ({
-      value: options.value,
-      setValue: (v) => {
-        options.onChange?.(v);
-      },
-      controlled: options.value !== void 0,
-      keyword: "",
-      setKeyword: () => {
-      },
-      selectedLabel: "",
-      setSelectedLabel: () => {
-      }
-    }),
-    useOpen: (options) => ({
-      get open() {
-        return !!options.open;
-      },
-      setOpen: (v) => {
-        options.onOpenChange?.(v);
-      },
-      triggerProps: {}
-    }),
-    useAsync: () => ({ data: void 0, loading: true, error: void 0, reload: () => {
-    } }),
-    usePopup: () => ({
-      open: false,
-      setOpen: () => {
-      },
-      wrapProps: {},
-      portal: () => null,
-      refresh: () => {
-      }
-    }),
-    usePresence: () => ({
-      phase: "closed",
-      ref: () => {
-      },
-      sync: (open2) => open2 ? "open" : "closed"
-    }),
-    useDialog: () => ({
-      phase: "closed",
-      rootRef: () => {
-      },
-      panelRef: () => {
-      },
-      sync: (open2) => open2 ? "open" : "closed"
-    }),
-    // SSR 确定性空态：会话不启动（无事件/无网络），仅保证挂载不崩
-    useChat: () => ({
-      messages: [],
-      input: "",
-      streaming: false,
-      error: null,
-      usage: null,
-      step: null,
-      send: () => {
-      },
-      stop: () => {
-      },
-      retry: () => {
-      },
-      clear: () => {
-      },
-      approve: async () => {
-      },
-      dispose: () => {
-      }
-    })
-  };
-  const browser = {
-    activeElement: () => null,
-    byId: () => null,
-    query: () => null,
-    createElement: () => null,
-    bodyAppend: () => {
-    },
-    bodyRemove: () => {
-    },
-    copyText: async () => false,
-    execCommand: () => false,
-    selectionText: () => null,
-    getSelection: () => null,
-    queryCommandState: () => false,
-    queryCommandValue: () => "",
-    viewportHeight: () => 0,
-    scrollTop: () => 0,
-    hash: () => "",
-    setHash: () => {
-    },
-    timeout: () => 0,
-    rootElement: () => null,
-    storageGet: () => null,
-    storageSet: () => {
-    }
-  };
-  const ctx = Object.create(serverCtx ?? {});
-  ctx.ui = ui2;
-  ctx.browser = browser;
-  ctx.data = {
-    async get(key, fetcher) {
-      if (dataStore.has(key)) return dataStore.get(key);
-      if (!fetcher) return void 0;
-      const val = await fetcher();
-      dataStore.set(key, val);
-      return val;
-    },
-    set(key, val) {
-      dataStore.set(key, val);
-    },
-    has(key) {
-      return dataStore.has(key);
-    }
-  };
-  return ctx;
+  return Object.entries(v).filter(([, val]) => val != null).map(([k, val]) => {
+    const key = k.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase());
+    const value = typeof val === "number" && val !== 0 ? `${val}px` : String(val);
+    return `${key}:${value}`;
+  }).join(";");
 }
 async function renderSsr(input, ctx) {
   if (input == null || typeof input === "boolean") return "";
   if (typeof input === "string" || typeof input === "number") return escape(String(input));
   if (Array.isArray(input)) {
-    let s = "";
-    for (const c of input) s += await renderSsr(c, ctx);
-    return s;
+    const parts = await Promise.all(input.map((c) => renderSsr(c, ctx)));
+    return parts.join("");
   }
   const vnode = input;
-  if (vnode.type === Portal) return renderSsr(vnode.props?.children, ctx);
-  if (vnode.type === Fragment) return renderSsr(vnode.props?.children, ctx);
+  if (vnode.type === Portal || vnode.type === Fragment) return renderSsr(vnode.props?.children, ctx);
   if (typeof vnode.type === "function") {
     const childCtx = Object.create(ctx);
-    let renderFn;
-    try {
-      renderFn = vnode.type(vnode.props ?? {}, childCtx);
-    } catch (e) {
-      throw e;
-    }
-    if (renderFn instanceof Promise) renderFn = await renderFn;
+    const renderFn = await vnode.type(vnode.props ?? {}, childCtx);
     if (typeof renderFn !== "function") {
       throw new Error(
         `Component ${vnode.type.name || "anonymous"} must return a render function. Use (init_props, ctx) => (props) => VNode pattern.`
       );
     }
-    return renderSsr(renderFn(vnode.props ?? {}), childCtx);
+    return renderSsr(await renderFn(vnode.props ?? {}), childCtx);
   }
   const tag = vnode.type;
   const props = vnode.props ?? {};
@@ -3995,6 +3137,10 @@ async function renderSsr(input, ctx) {
       attrs.push(` style="${escape(styleToString(value))}"`);
       continue;
     }
+    if (key === "draggable" || key === "contenteditable" || key === "spellcheck") {
+      attrs.push(` ${key}="${value ? "true" : "false"}"`);
+      continue;
+    }
     if (value === true) {
       attrs.push(` ${key}`);
       continue;
@@ -4003,21 +3149,134 @@ async function renderSsr(input, ctx) {
     attrs.push(` ${key}="${escape(String(value))}"`);
   }
   const attrStr = attrs.join("");
+  const svgWrap = SVG_TAGS.has(tag);
   if (VOID_TAGS.has(tag)) return `<${tag}${attrStr}>`;
   if (innerHTML !== void 0) return `<${tag}${attrStr}>${innerHTML}</${tag}>`;
   const children = await renderSsr(props.children, ctx);
+  if (svgWrap) return `<${tag}${attrStr}>${children}</${tag}>`;
   return `<${tag}${attrStr}>${children}</${tag}>`;
 }
-async function ssrToString(Comp, props, serverCtx, opts = {}) {
-  const dataStore = opts.data ?? /* @__PURE__ */ new Map();
-  const ctx = createSsrContext(serverCtx, dataStore);
-  const html = await renderSsr({ type: Comp, props: props ?? {}, key: void 0 }, ctx);
-  return new HtmlSafe(html);
+function createSsrUi() {
+  const noop = () => () => {
+  };
+  const noopReturn = () => ({});
+  return {
+    _selfId: "_wf_root",
+    render: () => {
+    },
+    selfId: () => {
+    },
+    bumpCtxVersion: () => {
+    },
+    setMounting: () => {
+    },
+    endMounting: () => {
+    },
+    // hooks no-op（组件 SSR 安全——不注册监听/定时器）
+    useChat: () => ({ messages: [], input: "", streaming: false, error: null, usage: null, step: null, send: () => {
+    }, stop: () => {
+    }, retry: () => {
+    }, clear: () => {
+    }, approve: () => {
+    }, subscribe: () => () => {
+    } }),
+    useExternal: (store) => store,
+    useMedia: noop,
+    useBreakpoint: noop,
+    usePopupPosition: () => ({ top: 0, left: 0, refresh: () => {
+    } }),
+    useHoverCapable: () => false,
+    useStableRef: (init) => (el) => {
+      if (el) init?.(el);
+    },
+    useVisualViewport: () => ({ height: 0, offsetTop: 0, keyboardOpen: false }),
+    usePopup: () => ({ open: false, setOpen: () => {
+    }, phase: "closed", sync: (open2) => open2 ? "open" : "closed", wrapProps: {}, portal: (content) => content, refresh: () => {
+    } }),
+    useLongPress: noopReturn,
+    useInView: () => ({ isIn: false, ready: false, observe: () => {
+    }, refresh: () => {
+    }, disconnect: () => {
+    } }),
+    useScrollPosition: () => ({ y: 0, refresh: () => {
+    } }),
+    useAsync: () => ({ data: void 0, loading: true, error: void 0, reload: () => {
+    } }),
+    useControlled: () => ({ value: void 0, setValue: () => {
+    }, controlled: false }),
+    useControlledInput: () => ({ value: void 0, setValue: () => {
+    }, keyword: "", setKeyword: () => {
+    }, selectedLabel: "", setSelectedLabel: () => {
+    }, controlled: false }),
+    useOpen: () => ({ open: false, setOpen: () => {
+    }, triggerProps: {} }),
+    usePresence: () => ({ phase: "closed", ref: () => {
+    }, sync: () => "closed" }),
+    useGlobalKey: () => () => {
+    },
+    useDrag: noopReturn,
+    useDragDrop: () => ({ dropProps: {}, dragProps: {} }),
+    useReducedMotion: () => true,
+    // SSR 无动画——组件直落终值
+    useAnimationEnd: () => () => {
+    },
+    useTween: (t) => {
+      let v = t;
+      return {
+        get value() {
+          return v;
+        },
+        set value(n) {
+          v = n;
+        },
+        reset: (n) => {
+          if (n !== void 0) v = n;
+          return v;
+        }
+      };
+    }
+  };
+}
+function createSsrContext(serverCtx, dataStore) {
+  const ctx = {
+    ...serverCtx,
+    ui: createSsrUi(),
+    browser: void 0
+  };
+  const dataCache = /* @__PURE__ */ new Map();
+  ctx.data = {
+    async get(key, fetcher) {
+      const entry = dataCache.get(key);
+      if (entry && "value" in entry) return entry.value;
+      if (entry?.promise) return entry.promise;
+      if (!fetcher) return void 0;
+      const promise = Promise.resolve().then(() => fetcher()).then((val) => {
+        dataCache.set(key, { value: val });
+        dataStore.set(key, val);
+        return val;
+      });
+      dataCache.set(key, { promise });
+      return promise;
+    },
+    set(key, value) {
+      dataCache.set(key, { value });
+      dataStore.set(key, value);
+    },
+    has(key) {
+      return dataCache.has(key);
+    }
+  };
+  return ctx;
 }
 function serializeData(data) {
   const json = JSON.stringify(Object.fromEntries(data)).replace(/</g, "\\u003c");
   return `<script>window.__DATA__=${json};</script>`;
 }
+async function ssrToString(Comp, props, serverCtx, opts = {}) {
+  const dataStore = opts.data ?? /* @__PURE__ */ new Map();
+  const ctx = createSsrContext(serverCtx, dataStore);
+  return renderSsr({ type: Comp, props: props ?? {}, key: void 0 }, ctx);
+}
 
 // src/ui/index.ts
 function escape2(s) {
@@ -4166,9 +3425,53 @@ function ui() {
 }
 
 // src/db/postgres/connection.ts
-import net3 from "node:net";
+import net2 from "node:net";
 import crypto2 from "node:crypto";
 
+// src/db/errors.ts
+var DbError = class extends Error {
+  kind;
+  code;
+  cause;
+  constructor(kind, message, options) {
+    super(message);
+    this.name = "DbError";
+    this.kind = kind;
+    this.code = options?.code;
+    this.cause = options?.cause;
+  }
+};
+var ProtocolError = class extends DbError {
+  constructor(feature, message) {
+    super("protocol", message ?? `${feature} is not supported by weifuwu/db`, { code: "UNSUPPORTED" });
+    this.name = "ProtocolError";
+  }
+};
+var ConnectionError = class extends DbError {
+  attempts;
+  constructor(message, attempts = 1, cause) {
+    super("connection", message, { cause });
+    this.name = "ConnectionError";
+    this.attempts = attempts;
+  }
+};
+var TimeoutError = class extends DbError {
+  operation;
+  ms;
+  constructor(operation, ms) {
+    super("timeout", `${operation} timed out after ${ms}ms`);
+    this.name = "TimeoutError";
+    this.operation = operation;
+    this.ms = ms;
+  }
+};
+var ValidationError = class extends DbError {
+  constructor(message) {
+    super("validation", message);
+    this.name = "ValidationError";
+  }
+};
+
 // src/db/postgres/protocol.ts
 function encodeMessage(type, payload) {
   const out = new Uint8Array(1 + 4 + payload.length);
@@ -4377,7 +3680,7 @@ function parseRowDescription(payload) {
   for (let c = 0; c < count; c++) {
     let j = i;
     while (payload[j] !== 0) j++;
-    const name = _decoder2.decode(payload.subarray(i, j));
+    const name = _decoder.decode(payload.subarray(i, j));
     i = j + 1;
     i += 6;
     const typeOid = payload[i] << 24 | payload[i + 1] << 16 | payload[i + 2] << 8 | payload[i + 3];
@@ -4399,7 +3702,7 @@ function parseDataRow(payload) {
     if (len === -1) {
       values.push(null);
     } else {
-      values.push(_decoder2.decode(payload.subarray(i, i + len)));
+      values.push(_decoder.decode(payload.subarray(i, i + len)));
       i += len;
     }
   }
@@ -4412,7 +3715,7 @@ function parseErrorFields(payload) {
     const type = String.fromCharCode(payload[i]);
     let j = i + 1;
     while (j < payload.length && payload[j] !== 0) j++;
-    const value = _decoder2.decode(payload.subarray(i + 1, j));
+    const value = _decoder.decode(payload.subarray(i + 1, j));
     switch (type) {
       case "S":
         out.severity = value;
@@ -4437,10 +3740,10 @@ function parseErrorFields(payload) {
   }
   return out;
 }
-var _decoder2 = new TextDecoder();
-var _encoder2 = new TextEncoder();
+var _decoder = new TextDecoder();
+var _encoder = new TextEncoder();
 function utf8(s) {
-  return _encoder2.encode(s);
+  return _encoder.encode(s);
 }
 function concat(...parts) {
   let total = 0;
@@ -4486,7 +3789,7 @@ var PgConnection = class _PgConnection {
   connect() {
     return new Promise((resolve3, reject) => {
       this.status = "connecting";
-      const sock = net3.connect(this.opts.port, this.opts.host);
+      const sock = net2.connect(this.opts.port, this.opts.host);
       this.socket = sock;
       const timeout = setTimeout(() => {
         sock.destroy();
@@ -5657,151 +4960,668 @@ function createQueryBuilder(sql, exec) {
         const [t, a] = table2.split(/\s+/);
         return mkSelect(t, a);
       }
-      return mkSelect(table2, alias);
-    },
-    insert: (table2) => mkInsert(table2),
-    update: (table2) => mkUpdate(table2),
-    delete: (table2) => mkDelete(table2)
-  };
-}
-
-// src/postgres/client.ts
-var MIGRATIONS_TABLE = "_weifuwu_migrations";
-var traceStore = new AsyncLocalStorage();
-function postgres(options) {
-  const opts = typeof options === "string" ? { connection: options } : options ?? {};
-  const connection = opts.connection ?? process.env.DATABASE_URL;
-  if (!connection) {
-    throw new Error(
-      "postgres: DATABASE_URL is not set. Pass a connection string or set the DATABASE_URL environment variable."
+      return mkSelect(table2, alias);
+    },
+    insert: (table2) => mkInsert(table2),
+    update: (table2) => mkUpdate(table2),
+    delete: (table2) => mkDelete(table2)
+  };
+}
+
+// src/postgres/client.ts
+var MIGRATIONS_TABLE = "_weifuwu_migrations";
+var traceStore = new AsyncLocalStorage();
+function postgres(options) {
+  const opts = typeof options === "string" ? { connection: options } : options ?? {};
+  const connection = opts.connection ?? process.env.DATABASE_URL;
+  if (!connection) {
+    throw new Error(
+      "postgres: DATABASE_URL is not set. Pass a connection string or set the DATABASE_URL environment variable."
+    );
+  }
+  const u = new URL(connection);
+  const pool = new PgPool({
+    host: u.hostname,
+    port: Number(u.port || 5432),
+    user: decodeURIComponent(u.username),
+    password: decodeURIComponent(u.password),
+    database: u.pathname.replace(/^\//, ""),
+    poolSize: opts.max ?? opts.poolSize ?? 10,
+    acquireTimeoutMs: opts.acquireTimeoutMs,
+    statementTimeoutMs: opts.statementTimeoutMs ?? opts.statementTimeout,
+    // onQuery 包装：从 ALS 读请求级 traceId 追加到第 4 参数（后端兼容——不传时不注入）
+    onQuery: opts.onQuery ? (sql2, durationMs, rowCount) => {
+      const tid = traceStore.getStore();
+      opts.onQuery?.(sql2, durationMs, rowCount, tid || void 0);
+    } : void 0
+  });
+  const sql = makeSql(pool);
+  const mw = ((req, ctx, next) => {
+    ctx.sql = sql;
+    return traceStore.run(req.headers.get("x-trace-id") ?? "", () => next(req, ctx));
+  });
+  mw.__meta = { injects: ["sql"], depends: [] };
+  mw.sql = sql;
+  mw.migrate = async () => {
+    await sql.unsafe(`
+      CREATE TABLE IF NOT EXISTS "_weifuwu_migrations" (
+        name TEXT PRIMARY KEY,
+        applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+      )
+    `);
+  };
+  mw.markMigrated = async (moduleName) => {
+    await sql.unsafe(`INSERT INTO "_weifuwu_migrations" (name) VALUES ($1) ON CONFLICT DO NOTHING`, [
+      moduleName
+    ]);
+  };
+  mw.isMigrated = async (moduleName) => {
+    const rows = await sql.unsafe(`SELECT 1 FROM "_weifuwu_migrations" WHERE name = $1`, [moduleName]);
+    return rows.length > 0;
+  };
+  mw.transaction = ((fn) => pool.begin(fn));
+  mw.poolStats = () => ({ active: 0, idle: pool.size, waiting: 0, max: pool.size });
+  mw.close = () => pool.close();
+  return mw;
+}
+var TaggedQuery = class {
+  text;
+  params;
+  executor;
+  constructor(text, params, executor) {
+    this.text = text;
+    this.params = params;
+    this.executor = executor;
+  }
+  then(resolve3, reject) {
+    return this.executor(this.text, this.params).then(resolve3, reject);
+  }
+  catch(reject) {
+    return this.executor(this.text, this.params).catch(reject);
+  }
+  finally(fn) {
+    return this.executor(this.text, this.params).finally(fn);
+  }
+  /** 嵌套片段（agent-platform 条件过滤模式） */
+  get __fragment() {
+    return { sql: this.text, params: this.params };
+  }
+};
+function makeSql(pool) {
+  const sql = ((strings, ...values) => {
+    const { sql: text, params } = parseTaggedFromPool(strings, values);
+    return new TaggedQuery(text, params, (s, p) => wrapError(pool.query(s, p)));
+  });
+  sql.unsafe = (query, params) => wrapError(pool.unsafe(query, params));
+  sql.query = createQueryBuilder(sql, async (q) => {
+    const { sql: text, params: p } = compileQuery(q);
+    return wrapError(pool.query(text, p));
+  });
+  sql.raw = (strings, ...values) => rawSql(
+    strings.reduce((acc, s, i) => acc + s + (i < values.length ? `$${i + 1}` : ""), ""),
+    values
+  );
+  sql.close = () => pool.close();
+  return sql;
+}
+function parseTaggedFromPool(strings, values) {
+  let sql = strings[0];
+  const params = [];
+  for (let i = 0; i < values.length; i++) {
+    const frag = values[i]?.__fragment;
+    if (frag) {
+      const renumbered = frag.sql.replace(/\$(\d+)/g, (_m, idx) => {
+        params.push(frag.params[parseInt(idx, 10) - 1]);
+        return `$${params.length}`;
+      });
+      sql += renumbered + strings[i + 1];
+    } else {
+      params.push(values[i]);
+      sql += `$${params.length}` + strings[i + 1];
+    }
+  }
+  return { sql, params };
+}
+var PG_ERROR_MAP = {
+  "23505": 409,
+  // unique_violation
+  "23503": 400,
+  // foreign_key_violation
+  "23502": 400,
+  // not_null_violation
+  "23514": 400,
+  // check_violation
+  "22P02": 400,
+  // invalid_text_representation
+  "22003": 400
+  // numeric_value_out_of_range
+};
+function wrapError(promise) {
+  return promise.catch((err) => {
+    const code = err?.code;
+    if (code && PG_ERROR_MAP[code]) {
+      throw new HttpError(`\u6570\u636E\u5E93\u9519\u8BEF: ${err.message}`, PG_ERROR_MAP[code]);
+    }
+    throw err;
+  });
+}
+
+// src/db/redis/connection.ts
+import net3 from "node:net";
+
+// src/db/redis/resp.ts
+var RespError = class extends DbError {
+  constructor(message) {
+    super("protocol", message, { code: "RESP" });
+    this.name = "RespError";
+  }
+};
+var IncompleteError = class extends Error {
+  constructor() {
+    super("incomplete RESP message");
+    this.name = "IncompleteError";
+  }
+};
+function decodeValue(v, decodeBytes) {
+  if (v instanceof Uint8Array) return decodeBytes ? _decoder2.decode(v) : v;
+  if (Array.isArray(v)) return v.map((x) => decodeValue(x, decodeBytes));
+  return v;
+}
+function encodeCommand(args) {
+  const lens = new Array(args.length);
+  let total = headerLen(args.length);
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    const len = typeof arg === "string" ? Buffer.byteLength(arg) : arg instanceof Buffer ? arg.length : String(arg).length;
+    lens[i] = len;
+    total += headerLen(len) + len + 2;
+  }
+  const out = new Uint8Array(total);
+  let off = 0;
+  const head = `*${args.length}\r
+`;
+  out.set(_encoder2.encode(head), 0);
+  off = head.length;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    const len = lens[i];
+    const lh = `$${len}\r
+`;
+    out.set(_encoder2.encode(lh), off);
+    off += lh.length;
+    if (typeof arg === "string") {
+      out.set(_encoder2.encode(arg), off);
+    } else if (arg instanceof Buffer) {
+      out.set(arg, off);
+    } else {
+      out.set(_encoder2.encode(String(arg)), off);
+    }
+    off += len;
+    out[off] = 13;
+    out[off + 1] = 10;
+    off += 2;
+  }
+  return out;
+}
+function headerLen(n) {
+  if (n < 10) return 4;
+  if (n < 100) return 5;
+  if (n < 1e3) return 6;
+  if (n < 1e4) return 7;
+  return 8;
+}
+var _decoder2 = new TextDecoder();
+var _encoder2 = new TextEncoder();
+var RespParser = class {
+  buf = new Uint8Array(0);
+  off = 0;
+  /** 喂入数据分片。返回 { value, incomplete }；incomplete=true 时需继续喂。 */
+  push(chunk) {
+    this.append(chunk);
+    const saved = this.off;
+    try {
+      const value = this.parseValue();
+      this.compact();
+      return { value, incomplete: false };
+    } catch (e) {
+      this.off = saved;
+      if (e instanceof IncompleteError) return { value: null, incomplete: true };
+      throw e;
+    }
+  }
+  /** 喂入分片并解析 buffer 中所有完整响应（连接层：一次 data 事件可能含多个回复） */
+  pushAll(chunk) {
+    this.append(chunk);
+    const out = [];
+    while (true) {
+      const saved = this.off;
+      try {
+        out.push(this.parseValue());
+      } catch (e) {
+        this.off = saved;
+        if (e instanceof IncompleteError) break;
+        throw e;
+      }
+    }
+    if (out.length > 0) this.compact();
+    return out;
+  }
+  /** 追加分片：已消费部分先行压缩（一次拷贝），避免 O(n²) 累积 */
+  append(chunk) {
+    if (chunk.length === 0) return;
+    const rest = this.buf.length - this.off;
+    if (rest === 0) {
+      this.buf = chunk;
+      this.off = 0;
+      return;
+    }
+    const merged = new Uint8Array(rest + chunk.length);
+    merged.set(this.buf.subarray(this.off), 0);
+    merged.set(chunk, rest);
+    this.buf = merged;
+    this.off = 0;
+  }
+  /** 全部消费后压缩（释放底层） */
+  compact() {
+    if (this.off === this.buf.length) {
+      this.buf = new Uint8Array(0);
+      this.off = 0;
+    } else if (this.off > 0) {
+      this.buf = this.buf.subarray(this.off);
+      this.off = 0;
+    }
+  }
+  parseValue() {
+    if (this.buf.length - this.off < 3) throw new IncompleteError();
+    const type = String.fromCharCode(this.buf[this.off]);
+    this.off++;
+    switch (type) {
+      case "+": {
+        const line = this.readLine();
+        return line;
+      }
+      case "-": {
+        const line = this.readLine();
+        return new RespError(line);
+      }
+      case ":": {
+        return this.readInt();
+      }
+      case "$": {
+        const len = this.readInt();
+        if (len === -1) return null;
+        return this.readBulkBytes(len);
+      }
+      case "*": {
+        const count = this.readInt();
+        if (count === -1) return null;
+        const items = [];
+        for (let i = 0; i < count; i++) items.push(this.parseValue());
+        return items;
+      }
+      default:
+        throw new DbError("protocol", `unknown RESP type byte: ${type}`, { code: "RESP" });
+    }
+  }
+  /**
+   * 读整数（: 或 $ 长度）：扫描数字字符边算值，直到 \r\n（手动解析，免 parseInt + 字符串）。
+   * 支持负号（-1）。未读到终止符抛 IncompleteError（push 回滚）。
+   */
+  readInt() {
+    const buf = this.buf;
+    let i = this.off;
+    let neg = false;
+    if (i < buf.length && buf[i] === 45) {
+      neg = true;
+      i++;
+    }
+    let n = 0;
+    while (i < buf.length && buf[i] >= 48 && buf[i] <= 57) {
+      n = n * 10 + (buf[i] - 48);
+      i++;
+    }
+    if (i + 1 < buf.length && buf[i] === 13 && buf[i + 1] === 10) {
+      this.off = i + 2;
+      return neg ? -n : n;
+    }
+    throw new IncompleteError();
+  }
+  /** 读一行（到 \r\n），返回行内容（不含 type 字节与 \r\n），并推进 off */
+  readLine() {
+    const idx = indexOfCRLF(this.buf, this.off);
+    if (idx === -1) throw new IncompleteError();
+    const line = _decoder2.decode(this.buf.subarray(this.off, idx));
+    this.off = idx + 2;
+    return line;
+  }
+  /** 读 len 字节的 bulk 内容 + \r\n（字节中立——不 decode，由调用方决定 string/Buffer） */
+  readBulkBytes(len) {
+    if (this.buf.length - this.off < len + 2) throw new IncompleteError();
+    const value = this.buf.subarray(this.off, this.off + len);
+    this.off += len + 2;
+    return value;
+  }
+};
+function indexOfCRLF(buf, from = 0) {
+  let i = buf.indexOf(13, from);
+  while (i !== -1) {
+    if (i + 1 < buf.length && buf[i + 1] === 10) return i;
+    i = buf.indexOf(13, i + 1);
+  }
+  return -1;
+}
+
+// src/db/redis/connection.ts
+var PUSH_TYPES = /* @__PURE__ */ new Set(["message", "pmessage"]);
+var BLOCKING_COMMANDS = /* @__PURE__ */ new Set(["BLPOP", "BRPOP", "BLMPOP", "BRPOPLPUSH", "BZPOPMIN", "BZPOPMAX", "WAIT", "XREAD", "XREADGROUP"]);
+var RedisConnection = class {
+  ready = false;
+  opts;
+  socket = null;
+  parser = new RespParser();
+  pending = [];
+  /** pending 头指针（避免 shift() O(n)——消费后定期 compact） */
+  pendingHead = 0;
+  offlineQueue = [];
+  subs = /* @__PURE__ */ new Map();
+  psubs = /* @__PURE__ */ new Map();
+  status = "idle";
+  retries = 0;
+  reconnectTimer = null;
+  socketTimeoutTimer = null;
+  connectPromise = null;
+  closed = false;
+  connectedOnce = false;
+  constructor(options = {}) {
+    this.opts = {
+      host: options.host ?? "127.0.0.1",
+      port: options.port ?? 6379,
+      retryDelayMs: options.retryDelayMs ?? 100,
+      maxRetries: options.maxRetries ?? 10,
+      enableOfflineQueue: options.enableOfflineQueue ?? true,
+      maxOfflineQueue: options.maxOfflineQueue ?? 5e3,
+      commandTimeoutMs: options.commandTimeoutMs ?? 0,
+      socketTimeoutMs: options.socketTimeoutMs ?? 0,
+      onCommand: options.onCommand
+    };
+  }
+  /** 建立连接并等待 ready。重连失败（超过 maxRetries）抛 ConnectionError。 */
+  connect() {
+    if (this.connectPromise) return this.connectPromise;
+    this.closed = false;
+    this.connectPromise = new Promise((resolve3, reject) => {
+      this.openSocket();
+      this.onceReady = () => resolve3();
+      this.onceFailed = (err) => reject(err);
+    }).finally(() => {
+      this.connectPromise = null;
+      this.onceReady = void 0;
+      this.onceFailed = void 0;
+    });
+    return this.connectPromise;
+  }
+  onceReady;
+  onceFailed;
+  openSocket() {
+    this.status = "connecting";
+    const sock = net3.connect(this.opts.port, this.opts.host);
+    this.socket = sock;
+    sock.on("connect", () => {
+      sock.setNoDelay(true);
+      this.status = "ready";
+      this.retries = 0;
+      if (this.connectedOnce) {
+        for (const ch of this.subs.keys()) this.sendNow("SUBSCRIBE", [ch]);
+        for (const pat of this.psubs.keys()) this.sendNow("PSUBSCRIBE", [pat]);
+      }
+      this.connectedOnce = true;
+      this.flushOffline();
+      this.onceReady?.();
+    });
+    sock.on("data", (chunk) => this.onData(new Uint8Array(chunk)));
+    sock.on("error", (err) => {
+      if (this.status === "connecting") {
+        this.handleDisconnect(err);
+      }
+    });
+    sock.on("close", () => {
+      this.socket = null;
+      if (this.status !== "closed" && this.status !== "idle") {
+        this.handleDisconnect(new ConnectionError("redis: socket closed"));
+      }
+    });
+  }
+  handleDisconnect(err) {
+    const queue2 = this.pending.slice(this.pendingHead);
+    this.pending = [];
+    this.pendingHead = 0;
+    for (const p of queue2) p.reject(err);
+    this.clearSocketTimeout();
+    if (this.closed || this.status === "closed") return;
+    this.retries++;
+    this.status = "connecting";
+    if (this.opts.maxRetries > 0 && this.retries > this.opts.maxRetries) {
+      this.status = "closed";
+      const failErr = err instanceof ConnectionError ? err : new ConnectionError(`redis: connect to ${this.opts.host}:${this.opts.port} failed`, this.retries, err);
+      this.onceFailed?.(failErr);
+      return;
+    }
+    const delay = Math.min(this.opts.retryDelayMs * 2 ** (this.retries - 1), 5e3);
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null;
+      this.openSocket();
+    }, delay);
+  }
+  onData(chunk) {
+    try {
+      const values = this.parser.pushAll(chunk);
+      for (const raw of values) {
+        const first = Array.isArray(raw) && raw.length > 0 ? decodeValue(raw[0], true) : void 0;
+        if (typeof first === "string" && PUSH_TYPES.has(first)) {
+          this.dispatchSubscribe(decodeValue(raw, true));
+          continue;
+        }
+        const p = this.pending[this.pendingHead++];
+        if (!p) break;
+        if (p.timedOut) continue;
+        if (raw instanceof RespError) p.reject(raw);
+        else p.resolve(decodeValue(raw, !p.asBuffer));
+      }
+      if (this.pendingHead > 64 && this.pendingHead * 2 > this.pending.length) {
+        this.pending = this.pending.slice(this.pendingHead);
+        this.pendingHead = 0;
+      }
+      if (this.opts.socketTimeoutMs > 0) {
+        if (this.pendingHead < this.pending.length) this.armSocketTimeout();
+        else this.clearSocketTimeout();
+      }
+    } catch (e) {
+      const queue2 = this.pending.slice(this.pendingHead);
+      this.pending = [];
+      this.pendingHead = 0;
+      for (const q of queue2) q.reject(e);
+      this.socket?.destroy();
+    }
+  }
+  /**
+   * 发送命令并等待响应（单连接严格有序）。未 ready 时入离线队列（enableOfflineQueue）或拒绝。
+   * opts.asBuffer=true：响应保留原始字节（Uint8Array）——getBuffer 等二进制场景。
+   */
+  command(name, ...args) {
+    const last = args[args.length - 1];
+    const opts = typeof last === "object" && last !== null && !(last instanceof Uint8Array) ? args.pop() : void 0;
+    if (this.status === "ready" && this.socket && !this.socket.destroyed) {
+      return this.sendNow(name, args, opts?.asBuffer);
+    }
+    if (this.closed || this.status === "closed" || !this.opts.enableOfflineQueue) {
+      return Promise.reject(new ConnectionError("redis: not connected"));
+    }
+    if (this.offlineQueue.length >= this.opts.maxOfflineQueue) {
+      return Promise.reject(new ConnectionError(`redis: offline queue full (${this.opts.maxOfflineQueue})`));
+    }
+    return new Promise((resolve3, reject) => {
+      this.offlineQueue.push({ name, args, resolve: resolve3, reject, asBuffer: opts?.asBuffer });
+    });
+  }
+  sendNow(name, args, asBuffer) {
+    const start = performance.now();
+    return new Promise((resolve3, reject) => {
+      const p = {
+        resolve: resolve3,
+        reject,
+        asBuffer,
+        blocking: BLOCKING_COMMANDS.has(name.toUpperCase())
+      };
+      this.armTimeout(p);
+      this.pending.push(p);
+      this.armSocketTimeout();
+      this.socket.write(encodeCommand([name, ...args]), (err) => {
+        if (err) {
+          const idx = this.pending.indexOf(p);
+          if (idx >= 0) this.pending.splice(idx, 1);
+          p.reject(err instanceof Error ? err : new ConnectionError("redis: socket write failed"));
+        }
+      });
+    }).then(
+      (v) => {
+        if (this.opts.onCommand) this.opts.onCommand(name, args, performance.now() - start);
+        return v;
+      },
+      (e) => {
+        if (this.opts.onCommand) this.opts.onCommand(name, args, performance.now() - start);
+        throw e;
+      }
     );
   }
-  const u = new URL(connection);
-  const pool = new PgPool({
-    host: u.hostname,
-    port: Number(u.port || 5432),
-    user: decodeURIComponent(u.username),
-    password: decodeURIComponent(u.password),
-    database: u.pathname.replace(/^\//, ""),
-    poolSize: opts.max ?? opts.poolSize ?? 10,
-    acquireTimeoutMs: opts.acquireTimeoutMs,
-    statementTimeoutMs: opts.statementTimeoutMs ?? opts.statementTimeout,
-    // onQuery 包装：从 ALS 读请求级 traceId 追加到第 4 参数（后端兼容——不传时不注入）
-    onQuery: opts.onQuery ? (sql2, durationMs, rowCount) => {
-      const tid = traceStore.getStore();
-      opts.onQuery?.(sql2, durationMs, rowCount, tid || void 0);
-    } : void 0
-  });
-  const sql = makeSql(pool);
-  const mw = ((req, ctx, next) => {
-    ctx.sql = sql;
-    return traceStore.run(req.headers.get("x-trace-id") ?? "", () => next(req, ctx));
-  });
-  mw.__meta = { injects: ["sql"], depends: [] };
-  mw.sql = sql;
-  mw.migrate = async () => {
-    await sql.unsafe(`
-      CREATE TABLE IF NOT EXISTS "_weifuwu_migrations" (
-        name TEXT PRIMARY KEY,
-        applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
-      )
-    `);
-  };
-  mw.markMigrated = async (moduleName) => {
-    await sql.unsafe(`INSERT INTO "_weifuwu_migrations" (name) VALUES ($1) ON CONFLICT DO NOTHING`, [
-      moduleName
-    ]);
-  };
-  mw.isMigrated = async (moduleName) => {
-    const rows = await sql.unsafe(`SELECT 1 FROM "_weifuwu_migrations" WHERE name = $1`, [moduleName]);
-    return rows.length > 0;
-  };
-  mw.transaction = ((fn) => pool.begin(fn));
-  mw.poolStats = () => ({ active: 0, idle: pool.size, waiting: 0, max: pool.size });
-  mw.close = () => pool.close();
-  return mw;
-}
-var TaggedQuery = class {
-  text;
-  params;
-  executor;
-  constructor(text, params, executor) {
-    this.text = text;
-    this.params = params;
-    this.executor = executor;
+  /** 命令超时（commandTimeoutMs > 0）：超时标记 timedOut + 处理（阻塞命令 resolve(null)，其余 reject） */
+  armTimeout(p) {
+    const ms = this.opts.commandTimeoutMs;
+    if (ms <= 0) return;
+    p.timer = setTimeout(() => {
+      p.timedOut = true;
+      if (p.blocking) p.resolve(null);
+      else p.reject(new TimeoutError("redis: command timeout", ms));
+    }, ms);
   }
-  then(resolve3, reject) {
-    return this.executor(this.text, this.params).then(resolve3, reject);
+  /** socket 响应超时（socketTimeoutMs > 0）：期望数据但超时未达 → 僵尸连接 → 主动断开走标准重连 */
+  armSocketTimeout() {
+    const ms = this.opts.socketTimeoutMs;
+    if (ms <= 0) return;
+    this.clearSocketTimeout();
+    this.socketTimeoutTimer = setTimeout(() => {
+      this.socketTimeoutTimer = null;
+      const err = new ConnectionError(`redis: socket timeout (no data in ${ms}ms)`);
+      const queue2 = this.pending.slice(this.pendingHead);
+      this.pending = [];
+      this.pendingHead = 0;
+      for (const q of queue2) q.reject(err);
+      this.clearSocketTimeout();
+      this.socket?.destroy();
+    }, ms);
   }
-  catch(reject) {
-    return this.executor(this.text, this.params).catch(reject);
+  clearSocketTimeout() {
+    if (this.socketTimeoutTimer) {
+      clearTimeout(this.socketTimeoutTimer);
+      this.socketTimeoutTimer = null;
+    }
   }
-  finally(fn) {
-    return this.executor(this.text, this.params).finally(fn);
+  flushOffline() {
+    const queue2 = this.offlineQueue;
+    this.offlineQueue = [];
+    for (const q of queue2) {
+      this.sendNow(q.name, q.args, q.asBuffer).then(q.resolve, q.reject);
+    }
   }
-  /** 嵌套片段（agent-platform 条件过滤模式） */
-  get __fragment() {
-    return { sql: this.text, params: this.params };
+  /** 批量执行：一次 write 发送所有命令字节，响应按序路由（管道） */
+  batch(payload, count) {
+    if (this.status !== "ready" || !this.socket) {
+      return Promise.reject(new ConnectionError("redis: not connected"));
+    }
+    return new Promise((resolve3, reject) => {
+      const results = [];
+      const batchPending = [];
+      let settled = false;
+      const maybeResolve = () => {
+        if (settled) return;
+        if (results.length === count) {
+          settled = true;
+          if (batchTimer) clearTimeout(batchTimer);
+          resolve3(results);
+        }
+      };
+      for (let i = 0; i < count; i++) {
+        const p = {
+          // 正常响应与错误响应（RespError）都作为结果值收集——管道语义
+          resolve: (v) => {
+            results.push(v);
+            maybeResolve();
+          },
+          reject: (e) => {
+            results.push(e);
+            maybeResolve();
+          }
+        };
+        batchPending.push(p);
+        this.pending.push(p);
+      }
+      let batchTimer;
+      const ms = this.opts.commandTimeoutMs;
+      if (ms > 0) {
+        batchTimer = setTimeout(() => {
+          settled = true;
+          for (const p of batchPending) p.timedOut = true;
+          reject(new TimeoutError("redis: batch timeout", ms));
+        }, ms);
+      }
+      this.socket.write(payload);
+      this.armSocketTimeout();
+    });
   }
-};
-function makeSql(pool) {
-  const sql = ((strings, ...values) => {
-    const { sql: text, params } = parseTaggedFromPool(strings, values);
-    return new TaggedQuery(text, params, (s, p) => wrapError(pool.query(s, p)));
-  });
-  sql.unsafe = (query, params) => wrapError(pool.unsafe(query, params));
-  sql.query = createQueryBuilder(sql, async (q) => {
-    const { sql: text, params: p } = compileQuery(q);
-    return wrapError(pool.query(text, p));
-  });
-  sql.raw = (strings, ...values) => rawSql(
-    strings.reduce((acc, s, i) => acc + s + (i < values.length ? `$${i + 1}` : ""), ""),
-    values
-  );
-  sql.close = () => pool.close();
-  return sql;
-}
-function parseTaggedFromPool(strings, values) {
-  let sql = strings[0];
-  const params = [];
-  for (let i = 0; i < values.length; i++) {
-    const frag = values[i]?.__fragment;
-    if (frag) {
-      const renumbered = frag.sql.replace(/\$(\d+)/g, (_m, idx) => {
-        params.push(frag.params[parseInt(idx, 10) - 1]);
-        return `$${params.length}`;
-      });
-      sql += renumbered + strings[i + 1];
-    } else {
-      params.push(values[i]);
-      sql += `$${params.length}` + strings[i + 1];
+  /** 订阅频道：回调式（channel, message） */
+  async subscribe(channel, fn) {
+    this.subs.set(channel, fn);
+    await this.command("SUBSCRIBE", channel);
+  }
+  /** 订阅模式：回调式（channel, message） */
+  async psubscribe(pattern, fn) {
+    this.psubs.set(pattern, fn);
+    await this.command("PSUBSCRIBE", pattern);
+  }
+  /** 旁路分发订阅消息（RESP 数组路由到回调） */
+  dispatchSubscribe(value) {
+    const [type, a, b] = value;
+    if (type === "message") {
+      const fn = this.subs.get(a);
+      fn?.(a, b);
+    } else if (type === "pmessage") {
+      const fn = this.psubs.get(a);
+      fn?.(b, value[3] ?? "");
     }
   }
-  return { sql, params };
-}
-var PG_ERROR_MAP = {
-  "23505": 409,
-  // unique_violation
-  "23503": 400,
-  // foreign_key_violation
-  "23502": 400,
-  // not_null_violation
-  "23514": 400,
-  // check_violation
-  "22P02": 400,
-  // invalid_text_representation
-  "22003": 400
-  // numeric_value_out_of_range
-};
-function wrapError(promise) {
-  return promise.catch((err) => {
-    const code = err?.code;
-    if (code && PG_ERROR_MAP[code]) {
-      throw new HttpError(`\u6570\u636E\u5E93\u9519\u8BEF: ${err.message}`, PG_ERROR_MAP[code]);
+  /** 主动关闭——不再重连 */
+  async close() {
+    this.closed = true;
+    this.status = "closed";
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
     }
-    throw err;
-  });
-}
+    this.clearSocketTimeout();
+    const queue2 = this.pending.slice(this.pendingHead);
+    this.pending = [];
+    this.pendingHead = 0;
+    for (const p of queue2) p.reject(new ConnectionError("redis: connection closed"));
+    const oq = this.offlineQueue;
+    this.offlineQueue = [];
+    for (const q of oq) q.reject(new ConnectionError("redis: connection closed"));
+    const sock = this.socket;
+    this.socket = null;
+    sock?.destroy();
+  }
+  get connected() {
+    return this.status === "ready";
+  }
+};
 
 // src/db/redis/pipeline.ts
 var RedisPipeline = class {