@yoooclaw/phone-notifications 1.10.3 → 1.10.5

package/dist/index.cjs

@@ -206,9 +206,38 @@ var init_credentials = __esm({
 });
 
 // src/env.ts
+function writeDotEnv(key, value) {
+  const path2 = resolveStateFile(".env");
+  (0, import_node_fs9.mkdirSync)((0, import_node_path8.dirname)(path2), { recursive: true });
+  const existing = (0, import_node_fs9.existsSync)(path2) ? (0, import_node_fs9.readFileSync)(path2, "utf-8") : "";
+  const lines = existing.split("\n");
+  const prefix = `${key}=`;
+  const idx = lines.findIndex((l) => l.startsWith(prefix));
+  const newLine = `${prefix}${value}`;
+  if (idx >= 0) {
+    lines[idx] = newLine;
+  } else {
+    if (existing && !existing.endsWith("\n")) lines.push("");
+    lines.push(newLine);
+  }
+  (0, import_node_fs9.writeFileSync)(path2, lines.join("\n"), "utf-8");
+}
+function readDotEnv() {
+  const path2 = resolveStateFile(".env");
+  if (!(0, import_node_fs9.existsSync)(path2)) return {};
+  return Object.fromEntries(
+    (0, import_node_fs9.readFileSync)(path2, "utf-8").split("\n").flatMap((line) => {
+      const eq = line.indexOf("=");
+      if (eq < 1) return [];
+      return [[line.slice(0, eq).trim(), line.slice(eq + 1).trim()]];
+    })
+  );
+}
 function loadEnvName() {
-  const fromEnvVar = process.env.OPENCLAW_ENV?.trim();
+  const fromEnvVar = process.env.PHONE_NOTIFICATIONS_ENV?.trim();
   if (fromEnvVar && VALID_ENVS.has(fromEnvVar)) return fromEnvVar;
+  const fromDotEnv = readDotEnv()["PHONE_NOTIFICATIONS_ENV"]?.trim();
+  if (fromDotEnv && VALID_ENVS.has(fromDotEnv)) return fromDotEnv;
   const { env } = readCredentials();
   if (env && VALID_ENVS.has(env)) return env;
   return "production";
@@ -219,7 +248,7 @@ function saveEnvName(env) {
       `\u65E0\u6548\u7684\u73AF\u5883\u540D\u79F0: ${env}\uFF0C\u53EF\u9009\u503C: ${[...VALID_ENVS].join(", ")}`
     );
   }
-  writeCredentials({ ...readCredentials(), env });
+  writeDotEnv("PHONE_NOTIFICATIONS_ENV", env);
 }
 function getEnvUrls(env) {
   return ENV_CONFIG[env ?? loadEnvName()];
@@ -227,11 +256,14 @@ function getEnvUrls(env) {
 function getAvailableEnvs() {
   return Object.keys(ENV_CONFIG);
 }
-var ENV_CONFIG, VALID_ENVS;
+var import_node_fs9, import_node_path8, ENV_CONFIG, VALID_ENVS;
 var init_env = __esm({
   "src/env.ts"() {
     "use strict";
+    import_node_fs9 = require("fs");
+    import_node_path8 = require("path");
     init_credentials();
+    init_host();
     ENV_CONFIG = {
       development: {
         lightApiUrl: "https://openclaw-service-dev.yoooclaw.com/api/message/tob/sendMessage",
@@ -500,20 +532,20 @@ function selectModelByMemory(availableGB, isAppleSilicon = false) {
   return "tiny";
 }
 function resolveModelsDir(dataDir) {
-  const dir = (0, import_node_path21.join)(dataDir, WHISPER_MODELS_DIR);
-  (0, import_node_fs25.mkdirSync)(dir, { recursive: true });
+  const dir = (0, import_node_path22.join)(dataDir, WHISPER_MODELS_DIR);
+  (0, import_node_fs26.mkdirSync)(dir, { recursive: true });
   return dir;
 }
 function resolveBinDir(dataDir) {
-  const dir = (0, import_node_path21.join)(dataDir, WHISPER_BIN_DIR);
-  (0, import_node_fs25.mkdirSync)(dir, { recursive: true });
+  const dir = (0, import_node_path22.join)(dataDir, WHISPER_BIN_DIR);
+  (0, import_node_fs26.mkdirSync)(dir, { recursive: true });
   return dir;
 }
 function isModelDownloaded(modelsDir, modelSize) {
-  const modelPath = (0, import_node_path21.join)(modelsDir, MODEL_FILENAMES[modelSize]);
-  if (!(0, import_node_fs25.existsSync)(modelPath)) return false;
+  const modelPath = (0, import_node_path22.join)(modelsDir, MODEL_FILENAMES[modelSize]);
+  if (!(0, import_node_fs26.existsSync)(modelPath)) return false;
   try {
-    const stat = (0, import_node_fs25.statSync)(modelPath);
+    const stat = (0, import_node_fs26.statSync)(modelPath);
     const expectedSize = MODEL_DISK_SIZES[modelSize];
     return stat.size >= expectedSize * 0.8;
   } catch {
@@ -522,7 +554,7 @@ function isModelDownloaded(modelsDir, modelSize) {
 }
 async function downloadModel(modelsDir, modelSize, logger, modelSource, mirrorUrl) {
   const filename = MODEL_FILENAMES[modelSize];
-  const modelPath = (0, import_node_path21.join)(modelsDir, filename);
+  const modelPath = (0, import_node_path22.join)(modelsDir, filename);
   if (isModelDownloaded(modelsDir, modelSize)) {
     logger.info(`[whisper-local] \u6A21\u578B\u5DF2\u5B58\u5728\uFF0C\u8DF3\u8FC7\u4E0B\u8F7D: ${filename}`);
     return { ok: true, modelPath };
@@ -578,9 +610,9 @@ async function probeUrl(url, logger) {
     } finally {
       clearTimeout(timer);
     }
-  } catch (err) {
+  } catch (err2) {
     logger.info(
-      `[whisper-local] \u8FDE\u901A\u6027\u63A2\u6D4B\u5931\u8D25: ${url} (${err?.name ?? err?.message ?? "unknown"})`
+      `[whisper-local] \u8FDE\u901A\u6027\u63A2\u6D4B\u5931\u8D25: ${url} (${err2?.name ?? err2?.message ?? "unknown"})`
     );
     return false;
   }
@@ -588,7 +620,7 @@ async function probeUrl(url, logger) {
 async function downloadFromUrl(url, modelPath, logger) {
   const tmpPath = `${modelPath}.downloading`;
   try {
-    (0, import_node_fs25.mkdirSync)((0, import_node_path21.dirname)(modelPath), { recursive: true });
+    (0, import_node_fs26.mkdirSync)((0, import_node_path22.dirname)(modelPath), { recursive: true });
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), 30 * 60 * 1e3);
     try {
@@ -604,7 +636,7 @@ async function downloadFromUrl(url, modelPath, logger) {
         return { ok: false, modelPath, error: "\u6A21\u578B\u4E0B\u8F7D\u5931\u8D25: \u54CD\u5E94\u4F53\u4E3A\u7A7A" };
       }
       const contentLength = Number(res.headers.get("content-length") ?? 0);
-      const writeStream = (0, import_node_fs25.createWriteStream)(tmpPath);
+      const writeStream = (0, import_node_fs26.createWriteStream)(tmpPath);
       const readable = import_node_stream2.Readable.fromWeb(res.body);
       let downloaded = 0;
       let lastLogPercent = 0;
@@ -626,17 +658,17 @@ async function downloadFromUrl(url, modelPath, logger) {
     }
     const { renameSync: renameSync2 } = await import("fs");
     renameSync2(tmpPath, modelPath);
-    const fileSize = (0, import_node_fs25.statSync)(modelPath).size;
+    const fileSize = (0, import_node_fs26.statSync)(modelPath).size;
     logger.info(
-      `[whisper-local] \u6A21\u578B\u4E0B\u8F7D\u5B8C\u6210: ${(0, import_node_path21.basename)(modelPath)} (${formatBytes2(fileSize)})`
+      `[whisper-local] \u6A21\u578B\u4E0B\u8F7D\u5B8C\u6210: ${(0, import_node_path22.basename)(modelPath)} (${formatBytes2(fileSize)})`
     );
     return { ok: true, modelPath };
-  } catch (err) {
+  } catch (err2) {
     try {
-      if ((0, import_node_fs25.existsSync)(tmpPath)) (0, import_node_fs25.unlinkSync)(tmpPath);
+      if ((0, import_node_fs26.existsSync)(tmpPath)) (0, import_node_fs26.unlinkSync)(tmpPath);
     } catch {
     }
-    const msg = err?.name === "AbortError" ? "\u6A21\u578B\u4E0B\u8F7D\u8D85\u65F6\uFF0830 \u5206\u949F\uFF09" : err?.message ?? String(err);
+    const msg = err2?.name === "AbortError" ? "\u6A21\u578B\u4E0B\u8F7D\u8D85\u65F6\uFF0830 \u5206\u949F\uFF09" : err2?.message ?? String(err2);
     logger.error(`[whisper-local] \u6A21\u578B\u4E0B\u8F7D\u5931\u8D25: ${msg}`);
     return { ok: false, modelPath, error: msg };
   }
@@ -645,8 +677,8 @@ function findWhisperBinary(dataDir, logger) {
   const binDir = resolveBinDir(dataDir);
   const binNames = (0, import_node_os4.platform)() === "win32" ? ["whisper-cli.exe", "whisper.exe", "main.exe"] : ["whisper-cli", "whisper", "main"];
   for (const name of binNames) {
-    const binPath = (0, import_node_path21.join)(binDir, name);
-    if ((0, import_node_fs25.existsSync)(binPath)) {
+    const binPath = (0, import_node_path22.join)(binDir, name);
+    if ((0, import_node_fs26.existsSync)(binPath)) {
       logger.info(`[whisper-local] \u627E\u5230\u672C\u5730\u4E8C\u8FDB\u5236: ${binPath}`);
       return binPath;
     }
@@ -697,7 +729,7 @@ async function transcribeWithWhisperLocal(audioFilePath, localConfig, dataDir, l
       return { ok: false, error: `\u6A21\u578B\u4E0B\u8F7D\u5931\u8D25: ${downloadResult.error}` };
     }
   }
-  const modelPath = (0, import_node_path21.join)(modelsDir, MODEL_FILENAMES[modelSize]);
+  const modelPath = (0, import_node_path22.join)(modelsDir, MODEL_FILENAMES[modelSize]);
   let inputPath = audioFilePath;
   let tmpWavPath = null;
   const actualFmt = detectAudioFormat(audioFilePath);
@@ -733,9 +765,9 @@ async function transcribeWithWhisperLocal(audioFilePath, localConfig, dataDir, l
         // 100MB stdout buffer
         stdio: ["pipe", "pipe", "pipe"]
       });
-    } catch (err) {
+    } catch (err2) {
       cleanupTmpWav(tmpWavPath);
-      return { ok: false, error: `whisper.cpp \u6267\u884C\u5931\u8D25: ${err?.message ?? err}` };
+      return { ok: false, error: `whisper.cpp \u6267\u884C\u5931\u8D25: ${err2?.message ?? err2}` };
     }
     if (result.status !== 0) {
       cleanupTmpWav(tmpWavPath);
@@ -749,10 +781,10 @@ async function transcribeWithWhisperLocal(audioFilePath, localConfig, dataDir, l
     logger.info(`[whisper-local] \u8F6C\u5199\u8017\u65F6: ${Math.round(elapsed / 1e3)}s`);
     const jsonPath = inputPath + ".json";
     let jsonContent;
-    if ((0, import_node_fs25.existsSync)(jsonPath)) {
-      jsonContent = (0, import_node_fs25.readFileSync)(jsonPath, "utf-8");
+    if ((0, import_node_fs26.existsSync)(jsonPath)) {
+      jsonContent = (0, import_node_fs26.readFileSync)(jsonPath, "utf-8");
       try {
-        (0, import_node_fs25.unlinkSync)(jsonPath);
+        (0, import_node_fs26.unlinkSync)(jsonPath);
       } catch {
       }
     } else {
@@ -760,9 +792,9 @@ async function transcribeWithWhisperLocal(audioFilePath, localConfig, dataDir, l
     }
     cleanupTmpWav(tmpWavPath);
     return parseWhisperOutput(jsonContent, logger);
-  } catch (err) {
+  } catch (err2) {
     cleanupTmpWav(tmpWavPath);
-    return { ok: false, error: `whisper.cpp \u8F6C\u5199\u5F02\u5E38: ${err?.message ?? err}` };
+    return { ok: false, error: `whisper.cpp \u8F6C\u5199\u5F02\u5E38: ${err2?.message ?? err2}` };
   }
 }
 function getWhisperLocalStatus(dataDir, logger) {
@@ -830,10 +862,10 @@ function getPhysicalCoreCount() {
 }
 function detectAudioFormat(filePath) {
   try {
-    const fd = (0, import_node_fs25.openSync)(filePath, "r");
+    const fd = (0, import_node_fs26.openSync)(filePath, "r");
     const buf = Buffer.alloc(12);
-    (0, import_node_fs25.readSync)(fd, buf, 0, 12, 0);
-    (0, import_node_fs25.closeSync)(fd);
+    (0, import_node_fs26.readSync)(fd, buf, 0, 12, 0);
+    (0, import_node_fs26.closeSync)(fd);
     const header = buf.toString("ascii", 0, 4);
     const header8 = buf.toString("ascii", 0, 8);
     if (header === "RIFF" && buf.toString("ascii", 8, 12) === "WAVE") return ".wav";
@@ -868,7 +900,7 @@ function convertToWav(inputPath, outputPath, actualFmt, logger) {
       timeout: 12e4,
       stdio: ["pipe", "pipe", "pipe"]
     });
-    if (ffmpegResult.status === 0 && (0, import_node_fs25.existsSync)(outputPath)) {
+    if (ffmpegResult.status === 0 && (0, import_node_fs26.existsSync)(outputPath)) {
       logger.info(`[whisper-local] ffmpeg \u8F6C\u6362\u5B8C\u6210: ${outputPath}`);
       return { ok: true };
     }
@@ -881,7 +913,7 @@ function convertToWav(inputPath, outputPath, actualFmt, logger) {
         ["--rate", "16000", "--mono", inputPath, outputPath],
         { encoding: "utf-8", timeout: 12e4, stdio: ["pipe", "pipe", "pipe"] }
       );
-      if (opusResult.status === 0 && (0, import_node_fs25.existsSync)(outputPath)) {
+      if (opusResult.status === 0 && (0, import_node_fs26.existsSync)(outputPath)) {
         logger.info(`[whisper-local] opusdec \u8F6C\u6362\u5B8C\u6210: ${outputPath}`);
         return { ok: true };
       }
@@ -895,7 +927,7 @@ function convertToWav(inputPath, outputPath, actualFmt, logger) {
     if (detectedExt && !inputPath.endsWith(detectedExt)) {
       tmpCopy = inputPath + ".detected" + detectedExt;
       try {
-        (0, import_node_fs25.copyFileSync)(inputPath, tmpCopy);
+        (0, import_node_fs26.copyFileSync)(inputPath, tmpCopy);
         actualInputPath = tmpCopy;
         logger.info(
           `[whisper-local] \u68C0\u6D4B\u5230\u5B9E\u9645\u683C\u5F0F ${detectedExt}\uFF0C\u4E34\u65F6\u91CD\u547D\u540D`
@@ -919,35 +951,35 @@ function convertToWav(inputPath, outputPath, actualFmt, logger) {
         timeout: 12e4,
         stdio: ["pipe", "pipe", "pipe"]
       });
-      if (tmpCopy && (0, import_node_fs25.existsSync)(tmpCopy)) {
+      if (tmpCopy && (0, import_node_fs26.existsSync)(tmpCopy)) {
         try {
-          (0, import_node_fs25.unlinkSync)(tmpCopy);
+          (0, import_node_fs26.unlinkSync)(tmpCopy);
         } catch {
         }
       }
-      if (afResult.status === 0 && (0, import_node_fs25.existsSync)(outputPath)) {
+      if (afResult.status === 0 && (0, import_node_fs26.existsSync)(outputPath)) {
         logger.info(`[whisper-local] afconvert \u8F6C\u6362\u5B8C\u6210: ${outputPath}`);
         return { ok: true };
       }
       const stderr = afResult.stderr?.slice(0, 200) ?? "";
       return { ok: false, error: `afconvert \u8F6C\u6362\u5931\u8D25 (exit ${afResult.status}): ${stderr}` };
-    } catch (err) {
-      if (tmpCopy && (0, import_node_fs25.existsSync)(tmpCopy)) {
+    } catch (err2) {
+      if (tmpCopy && (0, import_node_fs26.existsSync)(tmpCopy)) {
         try {
-          (0, import_node_fs25.unlinkSync)(tmpCopy);
+          (0, import_node_fs26.unlinkSync)(tmpCopy);
         } catch {
         }
       }
-      return { ok: false, error: `afconvert \u4E0D\u53EF\u7528: ${err?.message}` };
+      return { ok: false, error: `afconvert \u4E0D\u53EF\u7528: ${err2?.message}` };
     }
   }
   const fmtHint = actualFmt === ".ogg" ? "OGG/Opus \u683C\u5F0F\u9700\u8981 ffmpeg \u6216 opus-tools\uFF08brew install opus-tools\uFF09" : "\u8BF7\u5B89\u88C5 ffmpeg\uFF08brew install ffmpeg\uFF09\u6216\u786E\u4FDD\u97F3\u9891\u6587\u4EF6\u4E3A WAV \u683C\u5F0F";
   return { ok: false, error: `\u65E0\u6CD5\u5C06\u97F3\u9891\u8F6C\u6362\u4E3A WAV \u683C\u5F0F\u3002${fmtHint}` };
 }
 function cleanupTmpWav(path2) {
-  if (path2 && (0, import_node_fs25.existsSync)(path2)) {
+  if (path2 && (0, import_node_fs26.existsSync)(path2)) {
     try {
-      (0, import_node_fs25.unlinkSync)(path2);
+      (0, import_node_fs26.unlinkSync)(path2);
     } catch {
     }
   }
@@ -1011,8 +1043,8 @@ function parseWhisperOutput(stdout, logger) {
       text: fullText,
       segments
     };
-  } catch (err) {
-    logger.warn(`[whisper-local] JSON \u89E3\u6790\u5931\u8D25\uFF0C\u5C1D\u8BD5\u7EAF\u6587\u672C: ${err?.message}`);
+  } catch (err2) {
+    logger.warn(`[whisper-local] JSON \u89E3\u6790\u5931\u8D25\uFF0C\u5C1D\u8BD5\u7EAF\u6587\u672C: ${err2?.message}`);
     return {
       ok: true,
       text: stdout.trim(),
@@ -1033,13 +1065,13 @@ function formatBytes2(bytes) {
   if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
   return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)}GB`;
 }
-var import_node_child_process2, import_node_fs25, import_node_path21, import_promises3, import_node_stream2, import_node_os4, WHISPER_MODELS_DIR, WHISPER_BIN_DIR, HF_MODEL_URL_TEMPLATE, MODELSCOPE_MODEL_URL_TEMPLATE, PROBE_TIMEOUT_MS, MODEL_FILENAMES, MODEL_DISK_SIZES;
+var import_node_child_process2, import_node_fs26, import_node_path22, import_promises3, import_node_stream2, import_node_os4, WHISPER_MODELS_DIR, WHISPER_BIN_DIR, HF_MODEL_URL_TEMPLATE, MODELSCOPE_MODEL_URL_TEMPLATE, PROBE_TIMEOUT_MS, MODEL_FILENAMES, MODEL_DISK_SIZES;
 var init_whisper_local = __esm({
   "src/recording/whisper-local.ts"() {
     "use strict";
     import_node_child_process2 = require("child_process");
-    import_node_fs25 = require("fs");
-    import_node_path21 = require("path");
+    import_node_fs26 = require("fs");
+    import_node_path22 = require("path");
     import_promises3 = require("stream/promises");
     import_node_stream2 = require("stream");
     import_node_os4 = require("os");
@@ -1194,7 +1226,7 @@ async function initializeAsr(config, dataDir, logger) {
   }
 }
 async function transcribeAudio(audioFilePath, config, logger, options = {}) {
-  if (!(0, import_node_fs26.existsSync)(audioFilePath)) {
+  if (!(0, import_node_fs27.existsSync)(audioFilePath)) {
     return { ok: false, error: `\u97F3\u9891\u6587\u4EF6\u4E0D\u5B58\u5728: ${audioFilePath}` };
   }
   logger.info(
@@ -1218,8 +1250,8 @@ async function transcribeAudio(audioFilePath, config, logger, options = {}) {
           error: `\u672A\u77E5\u7684 ASR mode: ${config.mode}`
         };
     }
-  } catch (err) {
-    const msg = err?.message ?? String(err);
+  } catch (err2) {
+    const msg = err2?.message ?? String(err2);
     logger.error(`[asr] \u8F6C\u5199\u5F02\u5E38: ${msg}`);
     return { ok: false, error: msg };
   }
@@ -1338,8 +1370,8 @@ async function runTranscriptionWorkflow(params) {
     createdAt
   );
   const transcriptDataFilename = buildTranscriptDataFilename(recordingId);
-  const transcriptDataPath = (0, import_node_path22.join)(transcriptDataDir, transcriptDataFilename);
-  (0, import_node_fs26.writeFileSync)(
+  const transcriptDataPath = (0, import_node_path23.join)(transcriptDataDir, transcriptDataFilename);
+  (0, import_node_fs27.writeFileSync)(
     transcriptDataPath,
     JSON.stringify(transcriptData, null, 2),
     "utf-8"
@@ -1347,14 +1379,14 @@ async function runTranscriptionWorkflow(params) {
   logger.info(`[asr] \u8F6C\u5199 JSON \u5DF2\u5199\u5165: ${transcriptDataPath}`);
   const safeSummary = title.replace(/[/\\:*?"<>|]/g, "").trim().slice(0, 20);
   const filename = safeSummary ? `${recordingId}_${safeSummary}.md` : `${recordingId}.md`;
-  const filePath = (0, import_node_path22.join)(transcriptsDir, filename);
-  (0, import_node_fs26.writeFileSync)(filePath, markdown, "utf-8");
+  const filePath = (0, import_node_path23.join)(transcriptsDir, filename);
+  (0, import_node_fs27.writeFileSync)(filePath, markdown, "utf-8");
   logger.info(`[asr] \u8F6C\u5199\u6587\u672C\u5DF2\u5199\u5165: ${filePath}`);
   let summaryFilename;
   if (summary) {
     summaryFilename = `${recordingId}.md`;
-    const summaryFilePath = (0, import_node_path22.join)(summariesDir, summaryFilename);
-    (0, import_node_fs26.writeFileSync)(summaryFilePath, summary, "utf-8");
+    const summaryFilePath = (0, import_node_path23.join)(summariesDir, summaryFilename);
+    (0, import_node_fs27.writeFileSync)(summaryFilePath, summary, "utf-8");
     logger.info(`[asr] \u6458\u8981\u6587\u672C\u5DF2\u5199\u5165: ${summaryFilePath}`);
   }
   return {
@@ -1439,7 +1471,7 @@ async function transcribeWithModelProxy(audioOssUrl, apiConfig, logger) {
 }
 async function transcribeWithWhisperLocal2(audioFilePath, config, logger) {
   const { transcribeWithWhisperLocal: runLocal } = await Promise.resolve().then(() => (init_whisper_local(), whisper_local_exports));
-  const dataDir = process.env.OPENCLAW_STATE_DIR ?? process.env.QCLAW_STATE_DIR ?? (0, import_node_path22.join)(audioFilePath, "..", "..", "..");
+  const dataDir = process.env.OPENCLAW_STATE_DIR ?? process.env.QCLAW_STATE_DIR ?? (0, import_node_path23.join)(audioFilePath, "..", "..", "..");
   const localConfig = config.local ?? {};
   const result = await runLocal(
     audioFilePath,
@@ -1742,12 +1774,12 @@ function formatTranscriptSegmentText(segment) {
   }
   return text;
 }
-var import_node_fs26, import_node_path22, DEFAULT_LONG_RECORDING_POLL_INTERVAL_MS, DEFAULT_LONG_RECORDING_MAX_POLL_ATTEMPTS, LONG_RECORDING_RUNNING_STATUSES, LONG_RECORDING_TERMINAL_FAILURE_STATUSES;
+var import_node_fs27, import_node_path23, DEFAULT_LONG_RECORDING_POLL_INTERVAL_MS, DEFAULT_LONG_RECORDING_MAX_POLL_ATTEMPTS, LONG_RECORDING_RUNNING_STATUSES, LONG_RECORDING_TERMINAL_FAILURE_STATUSES;
 var init_asr = __esm({
   "src/recording/asr.ts"() {
     "use strict";
-    import_node_fs26 = require("fs");
-    import_node_path22 = require("path");
+    import_node_fs27 = require("fs");
+    import_node_path23 = require("path");
     init_credentials();
     init_env();
     init_transcript_document();
@@ -2143,9 +2175,9 @@ var require_permessage_deflate = __commonJS({
        */
       decompress(data, fin, callback) {
         zlibLimiter.add((done) => {
-          this._decompress(data, fin, (err, result) => {
+          this._decompress(data, fin, (err2, result) => {
             done();
-            callback(err, result);
+            callback(err2, result);
           });
         });
       }
@@ -2159,9 +2191,9 @@ var require_permessage_deflate = __commonJS({
        */
       compress(data, fin, callback) {
         zlibLimiter.add((done) => {
-          this._compress(data, fin, (err, result) => {
+          this._compress(data, fin, (err2, result) => {
             done();
-            callback(err, result);
+            callback(err2, result);
           });
         });
       }
@@ -2192,11 +2224,11 @@ var require_permessage_deflate = __commonJS({
         this._inflate.write(data);
         if (fin) this._inflate.write(TRAILER);
         this._inflate.flush(() => {
-          const err = this._inflate[kError];
-          if (err) {
+          const err2 = this._inflate[kError];
+          if (err2) {
             this._inflate.close();
             this._inflate = null;
-            callback(err);
+            callback(err2);
             return;
           }
           const data2 = bufferUtil.concat(
@@ -2277,14 +2309,14 @@ var require_permessage_deflate = __commonJS({
       this.removeListener("data", inflateOnData);
       this.reset();
     }
-    function inflateOnError(err) {
+    function inflateOnError(err2) {
       this[kPerMessageDeflate]._inflate = null;
       if (this[kError]) {
         this[kCallback](this[kError]);
         return;
       }
-      err[kStatusCode] = 1007;
-      this[kCallback](err);
+      err2[kStatusCode] = 1007;
+      this[kCallback](err2);
     }
   }
 });
@@ -2907,8 +2939,8 @@ var require_receiver = __commonJS({
        */
       decompress(data, cb) {
         const perMessageDeflate = this._extensions[PerMessageDeflate.extensionName];
-        perMessageDeflate.decompress(data, this._fin, (err, buf) => {
-          if (err) return cb(err);
+        perMessageDeflate.decompress(data, this._fin, (err2, buf) => {
+          if (err2) return cb(err2);
           if (buf.length) {
             this._messageLength += buf.length;
             if (this._messageLength > this._maxPayload && this._maxPayload > 0) {
@@ -3069,13 +3101,13 @@ var require_receiver = __commonJS({
       createError(ErrorCtor, message, prefix, statusCode, errorCode) {
         this._loop = false;
         this._errored = true;
-        const err = new ErrorCtor(
+        const err2 = new ErrorCtor(
           prefix ? `Invalid WebSocket frame: ${message}` : message
         );
-        Error.captureStackTrace(err, this.createError);
-        err.code = errorCode;
-        err[kStatusCode] = statusCode;
-        return err;
+        Error.captureStackTrace(err2, this.createError);
+        err2.code = errorCode;
+        err2[kStatusCode] = statusCode;
+        return err2;
       }
     };
     module2.exports = Receiver2;
@@ -3449,10 +3481,10 @@ var require_sender = __commonJS({
         this._state = GET_BLOB_DATA;
         blob.arrayBuffer().then((arrayBuffer) => {
           if (this._socket.destroyed) {
-            const err = new Error(
+            const err2 = new Error(
               "The socket was closed while the blob was being read"
             );
-            process.nextTick(callCallbacks, this, err, cb);
+            process.nextTick(callCallbacks, this, err2, cb);
             return;
           }
           this._bufferedBytes -= options[kByteLength];
@@ -3464,8 +3496,8 @@ var require_sender = __commonJS({
           } else {
             this.dispatch(data, compress, options, cb);
           }
-        }).catch((err) => {
-          process.nextTick(onError, this, err, cb);
+        }).catch((err2) => {
+          process.nextTick(onError, this, err2, cb);
         });
       }
       /**
@@ -3501,10 +3533,10 @@ var require_sender = __commonJS({
         this._state = DEFLATING;
         perMessageDeflate.compress(data, options.fin, (_, buf) => {
           if (this._socket.destroyed) {
-            const err = new Error(
+            const err2 = new Error(
               "The socket was closed while data was being compressed"
             );
-            callCallbacks(this, err, cb);
+            callCallbacks(this, err2, cb);
             return;
           }
           this._bufferedBytes -= options[kByteLength];
@@ -3555,17 +3587,17 @@ var require_sender = __commonJS({
       }
     };
     module2.exports = Sender2;
-    function callCallbacks(sender, err, cb) {
-      if (typeof cb === "function") cb(err);
+    function callCallbacks(sender, err2, cb) {
+      if (typeof cb === "function") cb(err2);
       for (let i = 0; i < sender._queue.length; i++) {
         const params = sender._queue[i];
         const callback = params[params.length - 1];
-        if (typeof callback === "function") callback(err);
+        if (typeof callback === "function") callback(err2);
       }
     }
-    function onError(sender, err, cb) {
-      callCallbacks(sender, err, cb);
-      sender.onerror(err);
+    function onError(sender, err2, cb) {
+      callCallbacks(sender, err2, cb);
+      sender.onerror(err2);
     }
   }
 });
@@ -4213,8 +4245,8 @@ var require_websocket = __commonJS({
           return;
         }
         this._readyState = _WebSocket.CLOSING;
-        this._sender.close(code, data, !this._isServer, (err) => {
-          if (err) return;
+        this._sender.close(code, data, !this._isServer, (err2) => {
+          if (err2) return;
           this._closeFrameSent = true;
           if (this._closeFrameReceived || this._receiver._writableState.errorEmitted) {
             this._socket.end();
@@ -4482,11 +4514,11 @@ var require_websocket = __commonJS({
         invalidUrlMessage = "The URL contains a fragment identifier";
       }
       if (invalidUrlMessage) {
-        const err = new SyntaxError(invalidUrlMessage);
+        const err2 = new SyntaxError(invalidUrlMessage);
         if (websocket._redirects === 0) {
-          throw err;
+          throw err2;
         } else {
-          emitErrorAndClose(websocket, err);
+          emitErrorAndClose(websocket, err2);
           return;
         }
       }
@@ -4581,10 +4613,10 @@ var require_websocket = __commonJS({
           abortHandshake(websocket, req, "Opening handshake has timed out");
         });
       }
-      req.on("error", (err) => {
+      req.on("error", (err2) => {
         if (req === null || req[kAborted]) return;
         req = websocket._req = null;
-        emitErrorAndClose(websocket, err);
+        emitErrorAndClose(websocket, err2);
       });
       req.on("response", (res) => {
         const location = res.headers.location;
@@ -4599,8 +4631,8 @@ var require_websocket = __commonJS({
           try {
             addr = new URL2(location, address);
           } catch (e) {
-            const err = new SyntaxError(`Invalid URL: ${location}`);
-            emitErrorAndClose(websocket, err);
+            const err2 = new SyntaxError(`Invalid URL: ${location}`);
+            emitErrorAndClose(websocket, err2);
             return;
           }
           initAsClient(websocket, addr, protocols, options);
@@ -4652,7 +4684,7 @@ var require_websocket = __commonJS({
           let extensions;
           try {
             extensions = parse(secWebSocketExtensions);
-          } catch (err) {
+          } catch (err2) {
             const message = "Invalid Sec-WebSocket-Extensions header";
             abortHandshake(websocket, socket, message);
             return;
@@ -4665,7 +4697,7 @@ var require_websocket = __commonJS({
           }
           try {
             perMessageDeflate.accept(extensions[PerMessageDeflate.extensionName]);
-          } catch (err) {
+          } catch (err2) {
             const message = "Invalid Sec-WebSocket-Extensions header";
             abortHandshake(websocket, socket, message);
             return;
@@ -4685,10 +4717,10 @@ var require_websocket = __commonJS({
         req.end();
       }
     }
-    function emitErrorAndClose(websocket, err) {
+    function emitErrorAndClose(websocket, err2) {
       websocket._readyState = WebSocket2.CLOSING;
       websocket._errorEmitted = true;
-      websocket.emit("error", err);
+      websocket.emit("error", err2);
       websocket.emitClose();
     }
     function netConnect(options) {
@@ -4704,17 +4736,17 @@ var require_websocket = __commonJS({
     }
     function abortHandshake(websocket, stream, message) {
       websocket._readyState = WebSocket2.CLOSING;
-      const err = new Error(message);
-      Error.captureStackTrace(err, abortHandshake);
+      const err2 = new Error(message);
+      Error.captureStackTrace(err2, abortHandshake);
       if (stream.setHeader) {
         stream[kAborted] = true;
         stream.abort();
         if (stream.socket && !stream.socket.destroyed) {
           stream.socket.destroy();
         }
-        process.nextTick(emitErrorAndClose, websocket, err);
+        process.nextTick(emitErrorAndClose, websocket, err2);
       } else {
-        stream.destroy(err);
+        stream.destroy(err2);
         stream.once("error", websocket.emit.bind(websocket, "error"));
         stream.once("close", websocket.emitClose.bind(websocket));
       }
@@ -4726,10 +4758,10 @@ var require_websocket = __commonJS({
         else websocket._bufferedAmount += length;
       }
       if (cb) {
-        const err = new Error(
+        const err2 = new Error(
           `WebSocket is not open: readyState ${websocket.readyState} (${readyStates[websocket.readyState]})`
         );
-        process.nextTick(cb, err);
+        process.nextTick(cb, err2);
       }
     }
     function receiverOnConclude(code, reason) {
@@ -4747,16 +4779,16 @@ var require_websocket = __commonJS({
       const websocket = this[kWebSocket];
       if (!websocket.isPaused) websocket._socket.resume();
     }
-    function receiverOnError(err) {
+    function receiverOnError(err2) {
       const websocket = this[kWebSocket];
       if (websocket._socket[kWebSocket] !== void 0) {
         websocket._socket.removeListener("data", socketOnData);
         process.nextTick(resume, websocket._socket);
-        websocket.close(err[kStatusCode]);
+        websocket.close(err2[kStatusCode]);
       }
       if (!websocket._errorEmitted) {
         websocket._errorEmitted = true;
-        websocket.emit("error", err);
+        websocket.emit("error", err2);
       }
     }
     function receiverOnFinish() {
@@ -4776,7 +4808,7 @@ var require_websocket = __commonJS({
     function resume(stream) {
       stream.resume();
     }
-    function senderOnError(err) {
+    function senderOnError(err2) {
       const websocket = this[kWebSocket];
       if (websocket.readyState === WebSocket2.CLOSED) return;
       if (websocket.readyState === WebSocket2.OPEN) {
@@ -4786,7 +4818,7 @@ var require_websocket = __commonJS({
       this._socket.end();
       if (!websocket._errorEmitted) {
         websocket._errorEmitted = true;
-        websocket.emit("error", err);
+        websocket.emit("error", err2);
       }
     }
     function setCloseTimer(websocket) {
@@ -4852,11 +4884,11 @@ var require_stream = __commonJS({
         this.destroy();
       }
     }
-    function duplexOnError(err) {
+    function duplexOnError(err2) {
       this.removeListener("error", duplexOnError);
       this.destroy();
       if (this.listenerCount("error") === 0) {
-        this.emit("error", err);
+        this.emit("error", err2);
       }
     }
     function createWebSocketStream2(ws, options) {
@@ -4872,28 +4904,28 @@ var require_stream = __commonJS({
         const data = !isBinary && duplex._readableState.objectMode ? msg.toString() : msg;
         if (!duplex.push(data)) ws.pause();
       });
-      ws.once("error", function error(err) {
+      ws.once("error", function error(err2) {
         if (duplex.destroyed) return;
         terminateOnDestroy = false;
-        duplex.destroy(err);
+        duplex.destroy(err2);
       });
       ws.once("close", function close() {
         if (duplex.destroyed) return;
         duplex.push(null);
       });
-      duplex._destroy = function(err, callback) {
+      duplex._destroy = function(err2, callback) {
         if (ws.readyState === ws.CLOSED) {
-          callback(err);
+          callback(err2);
           process.nextTick(emitClose, duplex);
           return;
         }
         let called = false;
-        ws.once("error", function error(err2) {
+        ws.once("error", function error(err3) {
           called = true;
-          callback(err2);
+          callback(err3);
         });
         ws.once("close", function close() {
-          if (!called) callback(err);
+          if (!called) callback(err2);
           process.nextTick(emitClose, duplex);
         });
         if (terminateOnDestroy) ws.terminate();
@@ -5215,7 +5247,7 @@ var require_websocket_server = __commonJS({
         if (secWebSocketProtocol !== void 0) {
           try {
             protocols = subprotocol.parse(secWebSocketProtocol);
-          } catch (err) {
+          } catch (err2) {
             const message = "Invalid Sec-WebSocket-Protocol header";
             abortHandshakeOrEmitwsClientError(this, req, socket, 400, message);
             return;
@@ -5235,7 +5267,7 @@ var require_websocket_server = __commonJS({
               perMessageDeflate.accept(offers[PerMessageDeflate.extensionName]);
               extensions[PerMessageDeflate.extensionName] = perMessageDeflate;
             }
-          } catch (err) {
+          } catch (err2) {
             const message = "Invalid or unacceptable Sec-WebSocket-Extensions header";
             abortHandshakeOrEmitwsClientError(this, req, socket, 400, message);
             return;
@@ -5364,9 +5396,9 @@ var require_websocket_server = __commonJS({
     }
     function abortHandshakeOrEmitwsClientError(server, req, socket, code, message, headers) {
       if (server.listenerCount("wsClientError")) {
-        const err = new Error(message);
-        Error.captureStackTrace(err, abortHandshakeOrEmitwsClientError);
-        server.emit("wsClientError", err, socket, req);
+        const err2 = new Error(message);
+        Error.captureStackTrace(err2, abortHandshakeOrEmitwsClientError);
+        server.emit("wsClientError", err2, socket, req);
       } else {
         abortHandshake(socket, code, message, headers);
       }
@@ -5392,7 +5424,7 @@ function readBuildInjectedVersion() {
   if (false) {
     return void 0;
   }
-  const version = "1.10.3".trim();
+  const version = "1.10.5".trim();
   return version || void 0;
 }
 function readPluginVersionFromPackageJson() {
@@ -6649,11 +6681,11 @@ function registerLightRulesGateway(api, registry, logger, rememberBroadcast) {
         id: rule.name
       }));
       respond(true, { ok: true, rules });
-    } catch (err) {
-      logger.warn(`lightrules.list failed: ${err?.message}`);
+    } catch (err2) {
+      logger.warn(`lightrules.list failed: ${err2?.message}`);
       respond(false, null, {
         code: "INTERNAL_ERROR",
-        message: err?.message ?? "Unknown error"
+        message: err2?.message ?? "Unknown error"
       });
     }
   });
@@ -6683,8 +6715,8 @@ function registerLightRulesGateway(api, registry, logger, rememberBroadcast) {
     try {
       repeatTimes = normalizeRepeatTimes({ repeat, repeat_times });
       assertAncsRepeatTimes(repeatTimes);
-    } catch (err) {
-      respond(false, null, { code: "VALIDATION_FAILED", message: err?.message ?? "Unknown error" });
+    } catch (err2) {
+      respond(false, null, { code: "VALIDATION_FAILED", message: err2?.message ?? "Unknown error" });
       return;
     }
     try {
@@ -6698,12 +6730,12 @@ function registerLightRulesGateway(api, registry, logger, rememberBroadcast) {
       });
       logger.info(`Light rule created: ${name}`);
       respond(true, { ok: true, name, cronHint: result.cronHint });
-    } catch (err) {
-      if (err instanceof LightRuleError) {
-        respond(false, null, { code: err.code, message: err.message });
+    } catch (err2) {
+      if (err2 instanceof LightRuleError) {
+        respond(false, null, { code: err2.code, message: err2.message });
       } else {
-        logger.warn(`lightrules.create failed: ${err?.message}`);
-        respond(false, null, { code: "INTERNAL_ERROR", message: err?.message ?? "Unknown error" });
+        logger.warn(`lightrules.create failed: ${err2?.message}`);
+        respond(false, null, { code: "INTERNAL_ERROR", message: err2?.message ?? "Unknown error" });
       }
     }
   });
@@ -6742,8 +6774,8 @@ function registerLightRulesGateway(api, registry, logger, rememberBroadcast) {
       try {
         repeatTimes = normalizeRepeatTimes({ repeat, repeat_times });
         assertAncsRepeatTimes(repeatTimes);
-      } catch (err) {
-        respond(false, null, { code: "VALIDATION_FAILED", message: err?.message ?? "Unknown error" });
+      } catch (err2) {
+        respond(false, null, { code: "VALIDATION_FAILED", message: err2?.message ?? "Unknown error" });
         return;
       }
     }
@@ -6766,12 +6798,12 @@ function registerLightRulesGateway(api, registry, logger, rememberBroadcast) {
         rule: result.meta,
         cronHint: result.cronHint
       });
-    } catch (err) {
-      if (err instanceof LightRuleError) {
-        respond(false, null, { code: err.code, message: err.message });
+    } catch (err2) {
+      if (err2 instanceof LightRuleError) {
+        respond(false, null, { code: err2.code, message: err2.message });
       } else {
-        logger.warn(`lightrules.update failed: ${err?.message}`);
-        respond(false, null, { code: "INTERNAL_ERROR", message: err?.message ?? "Unknown error" });
+        logger.warn(`lightrules.update failed: ${err2?.message}`);
+        respond(false, null, { code: "INTERNAL_ERROR", message: err2?.message ?? "Unknown error" });
       }
     }
   });
@@ -6794,273 +6826,17 @@ function registerLightRulesGateway(api, registry, logger, rememberBroadcast) {
         deleted: true,
         cronHint: result.cronHint
       });
-    } catch (err) {
-      if (err instanceof LightRuleError) {
-        respond(false, null, { code: err.code, message: err.message });
+    } catch (err2) {
+      if (err2 instanceof LightRuleError) {
+        respond(false, null, { code: err2.code, message: err2.message });
       } else {
-        logger.warn(`lightrules.delete failed: ${err?.message}`);
-        respond(false, null, { code: "INTERNAL_ERROR", message: err?.message ?? "Unknown error" });
+        logger.warn(`lightrules.delete failed: ${err2?.message}`);
+        respond(false, null, { code: "INTERNAL_ERROR", message: err2?.message ?? "Unknown error" });
       }
     }
   });
 }
 
-// src/light-rules/evaluator-job.ts
-var EVALUATOR_JOB_ID = "light-rules-evaluator";
-var EVALUATOR_SUBAGENT_SESSION_KEY = EVALUATOR_JOB_ID;
-var FALLBACK_CRON_EXPR = "0 0 1 1 *";
-function buildEvaluatorJobMessage(notificationsDir) {
-  return `\u706F\u6548\u89C4\u5219\u8BC4\u4F30\u4EFB\u52A1\u3002
-
-\u6267\u884C\u6B65\u9AA4\uFF1A
-1. \u8BFB\u53D6 tasks/light-rules-evaluator/checkpoint.json\uFF08\u8BB0\u5F55\u4E0A\u6B21\u5904\u7406\u8FDB\u5EA6\uFF09
-2. \u626B\u63CF ${notificationsDir} \u76EE\u5F55\uFF0C\u83B7\u53D6 checkpoint \u4E4B\u540E\u7684\u65B0\u901A\u77E5
-3. \u626B\u63CF tasks/ \u76EE\u5F55\uFF0C\u8BFB\u53D6\u6240\u6709 type=light-rule \u4E14 enabled=true \u7684 meta.json
-4. \u5BF9\u6BCF\u6761\u65B0\u901A\u77E5\uFF0C\u9010\u4E00\u5224\u65AD\u662F\u5426\u547D\u4E2D\u6BCF\u6761\u89C4\u5219\u7684 description\uFF08\u8BED\u4E49\u5339\u914D\uFF09
-5. \u547D\u4E2D\u65F6\uFF1A\u4EE5\u8BE5\u89C4\u5219\u7684 segments \u548C repeat_times \u8C03\u7528 light_control \u5DE5\u5177
-6. \u66F4\u65B0 checkpoint.json\uFF0C\u8BB0\u5F55\u5DF2\u5904\u7406\u5230\u7684\u6700\u65B0\u901A\u77E5\u4F4D\u7F6E
-7. \u82E5\u65E0\u65B0\u901A\u77E5\u6216\u65E0 enabled \u89C4\u5219\uFF1A\u8F93\u51FA NO_CHANGE\uFF0C\u76F4\u63A5\u7ED3\u675F`;
-}
-var LightRulesEvaluatorJob = class {
-  logger;
-  registry;
-  subagentRunner;
-  getNotificationsDir;
-  /**
-   * 记录本进程生命周期内 job 是否已确认存在。
-   * 仅在 `ensureJobExists` 成功后置 true，避免每次 push 都做检查。
-   */
-  jobEnsured = false;
-  /**
-   * 首次创建 job 时的并发保护。
-   * 避免冷启动瞬间多条通知并发到达时重复调用 `cron.add`。
-   */
-  ensureJobPromise = null;
-  /**
-   * subagent fallback 路径的并发保护。
-   * 若评估 session 已在运行中，跳过本次触发（checkpoint 保证下次补处理）。
-   */
-  subagentInFlight = false;
-  constructor(deps) {
-    this.logger = deps.logger;
-    this.registry = deps.registry;
-    this.subagentRunner = deps.subagentRunner;
-    this.getNotificationsDir = deps.getNotificationsDir ?? (() => void 0);
-  }
-  /**
-   * 通知落盘后调用。若有新增通知且存在 enabled 规则，则触发评估。
-   *
-   * 两条路径：
-   *  - cron 不为 null：enqueueRun("force") 入队（gateway context 路径，正常路径）
-   *  - cron 为 null：通过 subagentRunner 直接运行（HTTP Relay 路径，fallback）
-   *
-   * @param cron          来自 gateway context 的 CronService；HTTP 路径下为 null
-   * @param insertedCount 本次 ingest 新落盘的通知条数（StoredNotification 去重后）
-   */
-  async triggerIfNeeded(cron, insertedCount) {
-    if (insertedCount === 0) return;
-    if (this.registry.getEnabled().length === 0) return;
-    if (!cron) {
-      await this.triggerViaSubagent();
-      return;
-    }
-    try {
-      await this.ensureJobExists(cron);
-    } catch (err) {
-      this.logger.warn(`light-rules-evaluator: job ensure failed: ${err?.message ?? err}`);
-      return;
-    }
-    try {
-      const result = await cron.enqueueRun(EVALUATOR_JOB_ID, "force");
-      if (!result.ok) {
-        this.logger.warn("light-rules-evaluator: enqueueRun returned ok=false");
-        return;
-      }
-      if ("enqueued" in result && result.enqueued) {
-        this.logger.info(`light-rules-evaluator: enqueued runId=${result.runId}`);
-      } else if ("reason" in result) {
-        this.logger.info(`light-rules-evaluator: enqueueRun skipped (${result.reason})`);
-      }
-    } catch (err) {
-      this.logger.warn(`light-rules-evaluator: enqueueRun failed: ${err?.message ?? err}`);
-    }
-  }
-  /**
-   * cron service 不可用时的 fallback：直接通过 subagentRunner 运行评估 session。
-   *
-   * 并发保护：若上一次 subagent 运行尚未完成，本次跳过。
-   * checkpoint 保证即使本次跳过，下次触发时会处理所有积压通知。
-   */
-  async triggerViaSubagent() {
-    if (!this.subagentRunner) {
-      this.logger.warn(
-        "light-rules-evaluator: cron service unavailable and no subagent fallback configured; notifications ingested via HTTP will not trigger light rules until an agent session is active"
-      );
-      return;
-    }
-    if (this.subagentInFlight) {
-      this.logger.info("light-rules-evaluator: subagent run in-flight, skipping this trigger");
-      return;
-    }
-    const notificationsDir = this.getNotificationsDir();
-    if (!notificationsDir) {
-      this.logger.warn("light-rules-evaluator: notifications dir not ready, skipping subagent trigger");
-      return;
-    }
-    this.subagentInFlight = true;
-    try {
-      const result = await this.subagentRunner.run({
-        sessionKey: EVALUATOR_SUBAGENT_SESSION_KEY,
-        message: buildEvaluatorJobMessage(notificationsDir),
-        deliver: false,
-        idempotencyKey: `${EVALUATOR_SUBAGENT_SESSION_KEY}-${Date.now()}`
-      });
-      this.logger.info(`light-rules-evaluator: subagent triggered runId=${result.runId}`);
-    } catch (err) {
-      this.logger.warn(`light-rules-evaluator: subagent trigger failed: ${err?.message ?? err}`);
-    } finally {
-      this.subagentInFlight = false;
-    }
-  }
-  /**
-   * 按需创建 `light-rules-evaluator` job。
-   * 若 job 已存在（内存缓存或 cron store），直接返回；否则调用 `cron.add`。
-   */
-  async ensureJobExists(cron) {
-    if (this.jobEnsured) return;
-    if (!this.ensureJobPromise) {
-      this.ensureJobPromise = this.createJobIfNeeded(cron).finally(() => {
-        this.ensureJobPromise = null;
-      });
-    }
-    await this.ensureJobPromise;
-  }
-  async createJobIfNeeded(cron) {
-    if (cron.getJob(EVALUATOR_JOB_ID)) {
-      this.jobEnsured = true;
-      return;
-    }
-    try {
-      await cron.add({
-        id: EVALUATOR_JOB_ID,
-        name: "\u706F\u6548\u89C4\u5219\u8BC4\u4F30",
-        description: "\u4E8B\u4EF6\u9A71\u52A8\uFF1A\u901A\u77E5\u5230\u8FBE\u65F6\u8BC4\u4F30\u6240\u6709 enabled \u706F\u6548\u89C4\u5219\uFF0C\u547D\u4E2D\u5219\u8C03\u7528 light_control \u89E6\u53D1\u706F\u6548",
-        enabled: true,
-        schedule: { kind: "cron", expr: FALLBACK_CRON_EXPR },
-        sessionTarget: "isolated",
-        wakeMode: "now",
-        payload: {
-          kind: "agentTurn",
-          message: buildEvaluatorJobMessage(this.getNotificationsDir() ?? "notifications")
-        }
-      });
-      this.logger.info("light-rules-evaluator: job created");
-    } catch (err) {
-      if (!cron.getJob(EVALUATOR_JOB_ID)) {
-        throw err;
-      }
-    }
-    this.jobEnsured = true;
-  }
-};
-
-// src/light-rules/migration.ts
-var import_node_fs6 = require("fs");
-var import_node_path5 = require("path");
-var NO_MATCH_FETCH_PY = `#!/usr/bin/env python3
-# \u6B64\u6587\u4EF6\u7531\u8FC1\u79FB\u5DE5\u5177\u751F\u6210\u3002
-# \u706F\u6548\u89C4\u5219\u5DF2\u8FC1\u79FB\u81F3\u4E8B\u4EF6\u9A71\u52A8\u67B6\u6784\uFF0C\u6B64 cron job \u4E0D\u518D\u6267\u884C\u5B9E\u9645\u5DE5\u4F5C\u3002
-print("NO_MATCH")
-`;
-function normalizeScriptText(text) {
-  return text.replace(/\r\n/g, "\n").trim();
-}
-function resolveTasksDir(ctx) {
-  if (ctx.workspaceDir) return (0, import_node_path5.join)(ctx.workspaceDir, "tasks");
-  if (ctx.stateDir) {
-    const inferredWorkspaceDir = (0, import_node_path5.join)(ctx.stateDir, "workspace");
-    if ((0, import_node_fs6.existsSync)(inferredWorkspaceDir)) return (0, import_node_path5.join)(inferredWorkspaceDir, "tasks");
-    return (0, import_node_path5.join)(ctx.stateDir, "tasks");
-  }
-  return null;
-}
-function migrateLegacyLightRuleTasks(ctx, logger) {
-  const tasksDir3 = resolveTasksDir(ctx);
-  if (!tasksDir3 || !(0, import_node_fs6.existsSync)(tasksDir3)) return;
-  try {
-    for (const entry of (0, import_node_fs6.readdirSync)(tasksDir3, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue;
-      migrateTaskDir((0, import_node_path5.join)(tasksDir3, String(entry.name)), logger);
-    }
-  } catch (err) {
-    logger.warn(`migration: failed to read tasks dir: ${err?.message}`);
-  }
-}
-function migrateTaskDir(taskDir, logger) {
-  const metaPath = (0, import_node_path5.join)(taskDir, "meta.json");
-  if (!(0, import_node_fs6.existsSync)(metaPath)) return;
-  let meta;
-  try {
-    meta = JSON.parse((0, import_node_fs6.readFileSync)(metaPath, "utf-8"));
-  } catch {
-    return;
-  }
-  if (meta.type !== "light-rule") return;
-  const name = typeof meta.name === "string" ? meta.name : taskDir;
-  mergeMatchRulesIntoDescription(meta, name, metaPath, logger);
-  replaceFetchPy(taskDir, name, logger);
-  for (const filename of ["README.md", "checkpoint.json"]) {
-    removeFile((0, import_node_path5.join)(taskDir, filename), name, filename, logger);
-  }
-}
-function mergeMatchRulesIntoDescription(meta, name, metaPath, logger) {
-  const matchRules = meta.matchRules;
-  if (!matchRules || typeof matchRules !== "object") return;
-  const rules = matchRules;
-  const parts = [];
-  if (rules.appName) parts.push(`app=${rules.appName}`);
-  if (rules.senderKeywords?.length) {
-    parts.push(`\u53D1\u4EF6\u4EBA\u5173\u952E\u8BCD=${rules.senderKeywords.join("\u3001")}`);
-  }
-  if (rules.contentKeywords?.length) {
-    parts.push(`\u5185\u5BB9\u5173\u952E\u8BCD=${rules.contentKeywords.join("\u3001")}`);
-  }
-  if (parts.length > 0) {
-    const existing = typeof meta.description === "string" ? meta.description.trim() : "";
-    meta.description = existing ? `${existing}\u3002\u5339\u914D\u89C4\u5219\uFF1A${parts.join("\uFF0C")}` : `\u5339\u914D\u89C4\u5219\uFF1A${parts.join("\uFF0C")}`;
-  }
-  delete meta.matchRules;
-  try {
-    (0, import_node_fs6.writeFileSync)(metaPath, JSON.stringify(meta, null, 2), "utf-8");
-    logger.info(`migration: merged matchRules into description for light rule: ${name}`);
-  } catch (err) {
-    logger.warn(`migration: failed to update meta.json for ${name}: ${err?.message}`);
-  }
-}
-function replaceFetchPy(taskDir, name, logger) {
-  const fetchPyPath = (0, import_node_path5.join)(taskDir, "fetch.py");
-  if (!(0, import_node_fs6.existsSync)(fetchPyPath)) return;
-  try {
-    const existing = (0, import_node_fs6.readFileSync)(fetchPyPath, "utf-8");
-    if (normalizeScriptText(existing) === normalizeScriptText(NO_MATCH_FETCH_PY)) {
-      return;
-    }
-    (0, import_node_fs6.writeFileSync)(fetchPyPath, NO_MATCH_FETCH_PY, "utf-8");
-    logger.info(`migration: replaced fetch.py with NO_MATCH placeholder for ${name}`);
-  } catch (err) {
-    logger.warn(`migration: failed to replace fetch.py for ${name}: ${err?.message}`);
-  }
-}
-function removeFile(filePath, ruleName, filename, logger) {
-  if (!(0, import_node_fs6.existsSync)(filePath)) return;
-  try {
-    (0, import_node_fs6.rmSync)(filePath);
-    logger.info(`migration: removed ${filename} for light rule: ${ruleName}`);
-  } catch (err) {
-    logger.warn(`migration: failed to remove ${filename} for ${ruleName}: ${err?.message}`);
-  }
-}
-
 // src/light-rules/registry.ts
 var LightRuleRegistry = class {
   ctx;
@@ -7181,1067 +6957,1542 @@ var LightRuleRegistry = class {
   }
 };
 
-// src/plugin/auto-update.ts
-init_env();
-
-// src/update/channel.ts
-function resolveUpdateChannel(params) {
-  if (params.configuredChannel) {
-    return params.configuredChannel;
-  }
-  if (params.currentVersion.includes("-")) {
-    return "beta";
+// src/light/protocol.ts
+var MAX_LIGHT_SEGMENTS = 12;
+var PROTOCOL_DIGITS = [
+  "\x80",
+  "\x81",
+  "\x82",
+  "\x83",
+  "\x84",
+  "\x91",
+  "\x92",
+  "\x93",
+  "\x94",
+  "\x95",
+  "\x96",
+  "\x97"
+];
+var LED_SEPARATOR_ONCE = "\x9A";
+var LED_SEPARATOR_LOOP = "\x9B";
+var DURATION_STEPS_S = [0.5, 1, 2, 3, 5, 6, 8, 16, 24, 32, 48];
+var INTERVAL_STEPS_MS = [50, 100, 200, 300, 500, 600, 800, 1600, 2400, 3200, 4800];
+var BREATH_STEPS_MS = [1040, 1560, 2080, 2600, 3100, 4160];
+var BRIGHTNESS_STEPS = [32, 64, 96, 128, 192, 255];
+var COLOR_STEPS = [0, 32, 64, 128, 192, 255];
+var BACKGROUND_BRIGHTNESS_STEPS = [0, 32, 64, 96, 128, 192, 255];
+var MULTI_CHANNEL_COLOR_COEFFICIENTS = { r: 1, g: 0.25, b: 0.25 };
+var PURE_WHITE_COLOR_COEFFICIENTS = { r: 1, g: 0.35, b: 0.35 };
+var MODE_TO_INDEX = {
+  wave: 0,
+  breath: 1,
+  strobe: 2,
+  steady: 3,
+  wave_rainbow: 4,
+  pixel_frame: 5
+};
+function buildLightEffectApnsBody(segments, repeatInput) {
+  assertSegmentCount(segments);
+  assertSegmentsValid(segments);
+  const repeatTimes = normalizeRepeatTimes(repeatInput);
+  assertAncsRepeatTimes(repeatTimes);
+  const visibleText = summarizeSegments(segments);
+  const separator = repeatTimes === 0 ? LED_SEPARATOR_LOOP : LED_SEPARATOR_ONCE;
+  const payload = segments.map((segment) => encodeSegment(segment)).join("");
+  return `${visibleText}${separator}${payload}`;
+}
+function assertSegmentCount(segments) {
+  if (segments.length < 1 || segments.length > MAX_LIGHT_SEGMENTS) {
+    throw new Error(`light_control supports 1-${MAX_LIGHT_SEGMENTS} segments`);
   }
-  return params.envName === "development" ? "beta" : "latest";
 }
-
-// src/update/index.ts
-var import_node_path9 = require("path");
-
-// src/update/checker.ts
-function parseSemver(v) {
-  const [main, pre = null] = v.split("-", 2);
-  const [major = 0, minor = 0, patch = 0] = main.split(".").map(Number);
-  return { major, minor, patch, pre: pre ?? null };
+function summarizeSegments(segments) {
+  const modeDesc = segments.map((segment) => segment.mode).join("+");
+  return `Effect: ${modeDesc} (${segments.length} segment${segments.length > 1 ? "s" : ""})`;
 }
-function comparePreRelease(a, b) {
-  const aParts = a.split(".");
-  const bParts = b.split(".");
-  for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
-    const ap = aParts[i] ?? "";
-    const bp = bParts[i] ?? "";
-    const an = Number(ap);
-    const bn = Number(bp);
-    let diff;
-    if (!Number.isNaN(an) && !Number.isNaN(bn)) {
-      diff = an - bn;
-    } else if (ap < bp) {
-      diff = -1;
-    } else if (ap > bp) {
-      diff = 1;
-    } else {
-      diff = 0;
-    }
-    if (diff !== 0) return diff;
+function assertSegmentsValid(segments) {
+  const validation = validateSegments(segments);
+  if (!validation.valid) {
+    throw new Error(
+      validation.errors.map((error) => `${error.field}: ${error.message}`).join("; ")
+    );
   }
-  return 0;
 }
-function isNewerVersion(candidate, current) {
-  const a = parseSemver(candidate);
-  const b = parseSemver(current);
-  if (a.major !== b.major) return a.major > b.major;
-  if (a.minor !== b.minor) return a.minor > b.minor;
-  if (a.patch !== b.patch) return a.patch > b.patch;
-  if (a.pre === null) return b.pre !== null;
-  if (b.pre === null) return false;
-  return comparePreRelease(a.pre, b.pre) > 0;
+function encodeSegment(segment) {
+  const common = [
+    MODE_TO_INDEX[segment.mode],
+    quantizeDuration(segment.duration_s)
+  ];
+  let values;
+  switch (segment.mode) {
+    case "wave":
+    case "wave_rainbow":
+      const color = normalizeProtocolColor(segment.color);
+      const background = normalizeProtocolColor(segment.background);
+      values = [
+        ...common,
+        quantize(segment.interval_ms ?? 200, INTERVAL_STEPS_MS),
+        quantizeBrightnessValue(segment.brightness ?? 0),
+        quantize(color.r, COLOR_STEPS),
+        quantize(color.g, COLOR_STEPS),
+        quantize(color.b, COLOR_STEPS),
+        segment.direction === "rtl" ? 1 : 0,
+        quantizeWindow(segment.window ?? 2),
+        quantize(background.r, COLOR_STEPS),
+        quantize(background.g, COLOR_STEPS),
+        quantize(background.b, COLOR_STEPS),
+        quantize(segment.background?.brightness ?? 0, BACKGROUND_BRIGHTNESS_STEPS)
+      ];
+      break;
+    case "breath":
+      const breathColor = normalizeProtocolColor(segment.color);
+      values = [
+        ...common,
+        quantizeBreathRiseFall(segment.breath_timing?.rise_ms),
+        quantizeBreathHoldOff(segment.breath_timing?.hold_ms),
+        quantizeBreathRiseFall(segment.breath_timing?.fall_ms),
+        quantizeBreathHoldOff(segment.breath_timing?.off_ms),
+        quantizeBrightnessValue(segment.brightness ?? 0),
+        quantize(breathColor.r, COLOR_STEPS),
+        quantize(breathColor.g, COLOR_STEPS),
+        quantize(breathColor.b, COLOR_STEPS)
+      ];
+      break;
+    case "strobe":
+      const strobeColor = normalizeProtocolColor(segment.color);
+      values = [
+        ...common,
+        quantize(segment.interval_ms ?? 200, INTERVAL_STEPS_MS),
+        quantizeBrightnessValue(segment.brightness ?? 0),
+        quantize(strobeColor.r, COLOR_STEPS),
+        quantize(strobeColor.g, COLOR_STEPS),
+        quantize(strobeColor.b, COLOR_STEPS)
+      ];
+      break;
+    case "steady":
+      const steadyColor = normalizeProtocolColor(segment.color);
+      values = [
+        ...common,
+        quantizeBrightnessValue(segment.brightness ?? 0),
+        quantize(steadyColor.r, COLOR_STEPS),
+        quantize(steadyColor.g, COLOR_STEPS),
+        quantize(steadyColor.b, COLOR_STEPS)
+      ];
+      break;
+    case "pixel_frame":
+      values = encodePixelFrameValues(common, segment);
+      break;
+  }
+  return values.map((value) => PROTOCOL_DIGITS[value]).join("");
 }
-var CDN_BASE_URL = "https://artifact.yoooclaw.com/plugin";
-var NPM_BASE_URL = "https://registry.npmjs.org/@yoooclaw/phone-notifications";
-var FETCH_TIMEOUT_MS = 5e3;
-var UpdateChecker = class {
-  constructor(logger, onUpdateFound, intervalMs, channel) {
-    this.logger = logger;
-    this.onUpdateFound = onUpdateFound;
-    this.intervalMs = intervalMs;
-    this.channel = channel;
+function encodePixelFrameValues(common, segment) {
+  const pixels = segment.pixels ?? [];
+  return [
+    ...common,
+    pixels.length - 1,
+    ...pixels.flatMap((pixel) => {
+      const color = normalizeProtocolColor(pixel.color);
+      return [
+        pixel.index,
+        quantize(color.r, COLOR_STEPS),
+        quantize(color.g, COLOR_STEPS),
+        quantize(color.b, COLOR_STEPS),
+        quantizeBrightnessValue(pixel.brightness)
+      ];
+    })
+  ];
+}
+function normalizeProtocolColor(color) {
+  const normalized = {
+    r: color?.r ?? 0,
+    g: color?.g ?? 0,
+    b: color?.b ?? 0
+  };
+  if (isPureWhiteProtocolColor(normalized)) {
+    return applyProtocolColorCoefficients(normalized, PURE_WHITE_COLOR_COEFFICIENTS);
   }
-  timer = null;
-  notifiedVersion = null;
-  start() {
-    this.timer = setTimeout(() => {
-      void this.check();
-      this.timer = setInterval(() => void this.check(), this.intervalMs);
-    }, 6e4);
+  if (countActiveProtocolColorChannels(normalized) <= 1) {
+    return normalized;
   }
-  stop() {
-    if (this.timer) {
-      clearInterval(this.timer);
-      this.timer = null;
+  return applyProtocolColorCoefficients(normalized, MULTI_CHANNEL_COLOR_COEFFICIENTS);
+}
+function countActiveProtocolColorChannels(color) {
+  return Number(color.r > 0) + Number(color.g > 0) + Number(color.b > 0);
+}
+function isPureWhiteProtocolColor(color) {
+  return color.r === 255 && color.g === 255 && color.b === 255;
+}
+function applyProtocolColorCoefficients(color, coefficients) {
+  return {
+    r: scaleProtocolColorChannel(color.r, coefficients.r),
+    g: scaleProtocolColorChannel(color.g, coefficients.g),
+    b: scaleProtocolColorChannel(color.b, coefficients.b)
+  };
+}
+function scaleProtocolColorChannel(value, coefficient) {
+  return Math.max(0, Math.min(255, Math.round(value * coefficient)));
+}
+function quantize(value, steps) {
+  let bestIndex = 0;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (const [index, step] of steps.entries()) {
+    const distance = Math.abs(value - step);
+    if (distance < bestDistance) {
+      bestIndex = index;
+      bestDistance = distance;
     }
   }
-  async check() {
-    const latest = await this.fetchLatestVersion();
-    if (!latest || latest === PLUGIN_VERSION) return;
-    if (latest === this.notifiedVersion) return;
-    if (PLUGIN_VERSION.includes("-") && this.channel !== "beta") return;
-    if (!isNewerVersion(latest, PLUGIN_VERSION)) return;
-    this.notifiedVersion = latest;
-    this.logger.info(`\u53D1\u73B0\u65B0\u7248\u672C: ${PLUGIN_VERSION} \u2192 ${latest}`);
-    this.onUpdateFound({ current: PLUGIN_VERSION, latest });
-  }
-  async fetchLatestVersion() {
-    const tag = this.channel === "beta" ? "beta" : "latest";
-    try {
-      const res = await fetch(`${CDN_BASE_URL}/${tag}`, {
-        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
-      });
-      if (res.ok) {
-        const text = (await res.text()).trim();
-        if (text) return text;
-      }
-    } catch {
-    }
-    try {
-      const res = await fetch(`${NPM_BASE_URL}/${tag}`, {
-        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
-      });
-      if (res.ok) {
-        const data = await res.json();
-        return data.version ?? null;
-      }
-    } catch {
-      this.logger.info("\u7248\u672C\u68C0\u67E5\u5931\u8D25\uFF08CDN + npm \u5747\u4E0D\u53EF\u8FBE\uFF09\uFF0C\u8DF3\u8FC7");
-    }
-    return null;
+  return bestIndex;
+}
+function quantizeDuration(duration_s) {
+  if (duration_s === 0) return 11;
+  return quantize(duration_s, DURATION_STEPS_S);
+}
+function quantizeBrightnessValue(brightness) {
+  if (brightness === 0) return 11;
+  return quantize(brightness, BRIGHTNESS_STEPS);
+}
+function quantizeBreathRiseFall(value) {
+  return quantize(value ?? 1040, BREATH_STEPS_MS);
+}
+function quantizeBreathHoldOff(value) {
+  if (value === 0) {
+    return 5;
   }
-};
+  return quantize(value ?? 1040, BREATH_STEPS_MS.slice(0, 5));
+}
+function quantizeWindow(value) {
+  return value - 1;
+}
 
-// src/update/executor.ts
-var import_node_fs9 = require("fs");
-var import_node_path8 = require("path");
-var import_node_os = require("os");
-var VERSION_PATTERN = /^\d+\.\d+\.\d+(-[\w.]+)?$/;
-var BASE_URL = "https://artifact.yoooclaw.com/plugin";
-async function executeUpdate(version, runCommand, logger, targetDir, updateConfigRecord2) {
-  if (!VERSION_PATTERN.test(version)) {
-    return { success: false, message: `\u975E\u6CD5\u7248\u672C\u53F7: ${version}` };
-  }
-  const tgzUrl = `${BASE_URL}/v${version}/yoooclaw-phone-notifications-${version}.tgz`;
-  logger.info(`\u6267\u884C\u66F4\u65B0: ${tgzUrl} \u2192 ${targetDir}`);
-  const workDir = (0, import_node_fs9.mkdtempSync)((0, import_node_path8.join)((0, import_node_os.tmpdir)(), ".openclaw-plugin-update-"));
-  const tgzPath = (0, import_node_path8.join)(workDir, "plugin.tgz");
-  const stagingDir = (0, import_node_path8.join)(workDir, "staged");
-  let backupDir = null;
-  try {
-    logger.info("\u4E0B\u8F7D\u63D2\u4EF6\u5305...");
-    const response = await fetch(tgzUrl, { signal: AbortSignal.timeout(6e4) });
-    if (!response.ok) {
-      return { success: false, message: `\u4E0B\u8F7D\u5931\u8D25 (HTTP ${response.status}): ${tgzUrl}` };
-    }
-    const buffer = Buffer.from(await response.arrayBuffer());
-    (0, import_node_fs9.writeFileSync)(tgzPath, buffer);
-    logger.info(`\u4E0B\u8F7D\u5B8C\u6210 (${buffer.length} bytes)`);
-    (0, import_node_fs9.mkdirSync)(stagingDir, { recursive: true });
-    const tarResult = await runCommand(
-      ["tar", "-xzf", tgzPath, "-C", stagingDir, "--strip-components=1"],
-      { timeoutMs: 3e4 }
-    );
-    if (tarResult.code !== 0) {
-      const err = tarResult.stderr || tarResult.stdout || "unknown error";
-      return { success: false, message: `\u89E3\u538B\u5931\u8D25: ${err}` };
-    }
-    (0, import_node_fs9.mkdirSync)((0, import_node_path8.dirname)(targetDir), { recursive: true });
-    try {
-      backupDir = `${targetDir}.bak.${Date.now()}`;
-      (0, import_node_fs9.renameSync)(targetDir, backupDir);
-    } catch {
-      backupDir = null;
-    }
-    (0, import_node_fs9.renameSync)(stagingDir, targetDir);
-    try {
-      await updateConfigRecord2(version, tgzUrl);
-    } catch (err) {
-      logger.warn(`\u914D\u7F6E\u8BB0\u5F55\u66F4\u65B0\u5931\u8D25\uFF08\u63D2\u4EF6\u6587\u4EF6\u5DF2\u5C31\u4F4D\uFF09: ${String(err)}`);
-    }
-    if (backupDir) {
-      try {
-        (0, import_node_fs9.rmSync)(backupDir, { force: true, recursive: true });
-      } catch {
+// src/plugin/light-rules-tools.ts
+var segmentItemSchema = {
+  type: "object",
+  required: ["mode", "duration_s"],
+  additionalProperties: false,
+  properties: {
+    mode: {
+      type: "string",
+      enum: ["wave", "breath", "strobe", "steady", "wave_rainbow", "pixel_frame"],
+      description: "\u706F\u6548\u6A21\u5F0F\uFF1Awave \u6CE2\u6D6A / breath \u547C\u5438 / strobe \u9891\u95EA / steady \u5E38\u4EAE / wave_rainbow \u6D41\u5149 / pixel_frame \u9010\u7EC4\u50CF\u7D20\u5E27"
+    },
+    duration_s: { type: "number", minimum: 0, description: "\u6301\u7EED\u65F6\u957F\uFF08\u79D2\uFF09\uFF0C0 \u8868\u793A\u65E0\u9650" },
+    brightness: { type: "number", minimum: 0, maximum: 255 },
+    color: {
+      type: "object",
+      required: ["r", "g", "b"],
+      additionalProperties: false,
+      properties: {
+        r: { type: "number", minimum: 0, maximum: 255 },
+        g: { type: "number", minimum: 0, maximum: 255 },
+        b: { type: "number", minimum: 0, maximum: 255 }
       }
-    }
-    const msg = `\u5DF2\u66F4\u65B0\u5230 ${version}\uFF0C\u8BF7\u91CD\u542F gateway \u751F\u6548`;
-    logger.info(msg);
-    return { success: true, message: msg };
-  } catch (err) {
-    if (backupDir) {
-      try {
-        (0, import_node_fs9.rmSync)(targetDir, { force: true, recursive: true });
-        (0, import_node_fs9.renameSync)(backupDir, targetDir);
-        logger.info("\u5DF2\u56DE\u6EDA\u5230\u4E4B\u524D\u7248\u672C");
-      } catch (rollbackErr) {
-        logger.error(`\u56DE\u6EDA\u5931\u8D25: ${String(rollbackErr)}`);
+    },
+    interval_ms: { type: "number", minimum: 0 },
+    direction: { type: "string", enum: ["ltr", "rtl"] },
+    window: { type: "number", enum: [1, 2, 3] },
+    breath_timing: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        rise_ms: { type: "number", minimum: 0 },
+        hold_ms: { type: "number", minimum: 0 },
+        fall_ms: { type: "number", minimum: 0 },
+        off_ms: { type: "number", minimum: 0 }
+      }
+    },
+    frames: { type: "array", items: { type: "array", items: { type: "number" } } },
+    frame_duration_ms: { type: "number", minimum: 0 },
+    background: {
+      type: "object",
+      required: ["r", "g", "b"],
+      additionalProperties: false,
+      properties: {
+        r: { type: "number", minimum: 0, maximum: 255 },
+        g: { type: "number", minimum: 0, maximum: 255 },
+        b: { type: "number", minimum: 0, maximum: 255 }
       }
     }
-    const errMsg = `\u66F4\u65B0\u6267\u884C\u5F02\u5E38: ${String(err)}`;
-    logger.error(errMsg);
-    return { success: false, message: errMsg };
-  } finally {
-    try {
-      (0, import_node_fs9.rmSync)(workDir, { force: true, recursive: true });
-    } catch {
-    }
-  }
-}
-
-// src/update/index.ts
-var PLUGIN_ID = "phone-notifications";
-function resolveTargetDir(api) {
-  try {
-    const cfg = api.runtime.config?.loadConfig?.();
-    const installPath = cfg?.plugins?.installs?.[PLUGIN_ID]?.installPath;
-    if (installPath) return installPath;
-  } catch {
   }
-  return (0, import_node_path9.join)(api.runtime.state.resolveStateDir(), "extensions", PLUGIN_ID);
+};
+var segmentsSchema = {
+  type: "array",
+  description: "\u706F\u6548\u6BB5\u5E8F\u5217\uFF0C1\u201312 \u6BB5\uFF0C\u6309\u987A\u5E8F\u64AD\u653E",
+  minItems: 1,
+  maxItems: MAX_LIGHT_SEGMENTS,
+  items: segmentItemSchema
+};
+function ok(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data) }], details: data };
 }
-async function updateConfigRecord(api, version, targetDir, tgzUrl) {
-  const configApi = api.runtime.config;
-  if (!configApi) return;
-  const cfg = configApi.loadConfig();
-  if (!cfg.plugins) cfg.plugins = {};
-  if (!cfg.plugins.installs) cfg.plugins.installs = {};
-  cfg.plugins.installs[PLUGIN_ID] = {
-    ...cfg.plugins.installs[PLUGIN_ID],
-    source: "archive",
-    sourcePath: tgzUrl,
-    installPath: targetDir,
-    version,
-    installedAt: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  await configApi.writeConfigFile(cfg);
+function err(code, message) {
+  const data = { ok: false, error: { code, message } };
+  return { content: [{ type: "text", text: JSON.stringify(data) }], details: data };
 }
-function registerAutoUpdate(api, logger, config, getBroadcast, rememberBroadcast, externalUpdateNotifier) {
-  if (config.enabled === false) {
-    logger.info("\u81EA\u52A8\u66F4\u65B0\u5DF2\u7981\u7528 (autoUpdate.enabled = false)");
-    return { start() {
-    }, stop() {
-    }, notifyBroadcastReady() {
-    } };
-  }
-  let pendingUpdate = null;
-  let pendingGatewayUpdate = null;
-  function tryBroadcastUpdate(update) {
-    const broadcast = getBroadcast();
-    if (!broadcast) return false;
-    broadcast("plugin.updateAvailable", {
-      pluginId: "phone-notifications",
-      current: update.current,
-      latest: update.latest
-    });
-    pendingGatewayUpdate = null;
-    return true;
-  }
-  api.on("before_prompt_build", () => {
-    if (!pendingUpdate) return;
-    return {
-      appendSystemContext: `[\u7CFB\u7EDF\u901A\u77E5] phone-notifications \u63D2\u4EF6\u6709\u65B0\u7248\u672C ${pendingUpdate.latest} \u53EF\u7528\uFF08\u5F53\u524D\u7248\u672C ${pendingUpdate.current}\uFF09\u3002
-\u8BF7\u7528\u81EA\u7136\u8BED\u8A00\u5728\u5408\u9002\u65F6\u673A\u544A\u77E5\u7528\u6237\uFF0C\u82E5\u7528\u6237\u540C\u610F\u66F4\u65B0\uFF0C\u8C03\u7528 plugin-update tool \u5E76\u4F20\u5165 version \u53C2\u6570\u3002\u82E5\u7528\u6237\u62D2\u7EDD\uFF0C\u4E0D\u518D\u91CD\u590D\u63D0\u9192\u3002`
-    };
+function registerLightRulesTools(api, registry, logger) {
+  api.registerTool({
+    name: "lightrules.list",
+    label: "List Light Rules",
+    description: '\u5217\u51FA\u6240\u6709\u706F\u6548\u89C4\u5219\uFF08\u5305\u542B enabled/disabled \u72B6\u6001\uFF09\u3002\u5F53\u7528\u6237\u8BF4"\u5217\u51FA\u706F\u6548\u89C4\u5219"\u3001"\u6709\u54EA\u4E9B\u706F\u6548\u89C4\u5219"\u3001"\u67E5\u770B\u89C4\u5219"\u7B49\u65F6\u8C03\u7528\u3002\u6CE8\u610F\uFF1A\u706F\u6548\u89C4\u5219\u7684\u6240\u6709 CRUD \u64CD\u4F5C\u5FC5\u987B\u901A\u8FC7 lightrules.* \u5DE5\u5177\u5B8C\u6210\uFF0C\u7981\u6B62\u76F4\u63A5\u7528 write/edit \u4FEE\u6539 tasks/*/meta.json\u3002',
+    parameters: { type: "object", properties: {}, additionalProperties: false },
+    async execute(_toolCallId, _params) {
+      try {
+        const rules = registry.list().map((rule) => ({ ...rule, id: rule.name }));
+        return ok({ ok: true, rules });
+      } catch (e) {
+        logger.warn(`lightrules.list tool failed: ${e?.message}`);
+        return err("INTERNAL_ERROR", e?.message ?? "Unknown error");
+      }
+    }
   });
   api.registerTool({
-    name: "plugin-update",
-    label: "Plugin Update",
-    description: "\u5C06 phone-notifications \u63D2\u4EF6\u66F4\u65B0\u5230\u6307\u5B9A\u7248\u672C\u3002\u4EC5\u5728\u7528\u6237\u660E\u786E\u540C\u610F\u66F4\u65B0\u540E\u8C03\u7528\u3002\u66F4\u65B0\u5B8C\u6210\u540E\u9700\u91CD\u542F gateway \u751F\u6548\u3002",
+    name: "lightrules.create",
+    label: "Create Light Rule",
+    description: '\u521B\u5EFA\u4E00\u6761\u706F\u6548\u89C4\u5219\uFF0C\u6307\u5B9A\u540D\u79F0\u3001\u81EA\u7136\u8BED\u8A00\u89E6\u53D1\u63CF\u8FF0\u548C\u706F\u6548\u53C2\u6570\u3002\u5F53\u7528\u6237\u8BF4"\u521B\u5EFA\u706F\u6548\u89C4\u5219"\u3001"\u65B0\u589E\u89C4\u5219"\u7B49\u65F6\u8C03\u7528\u3002',
     parameters: {
       type: "object",
-      required: ["version"],
+      required: ["name", "description", "segments"],
       additionalProperties: false,
       properties: {
-        version: {
+        name: { type: "string", description: "\u89C4\u5219\u7684\u552F\u4E00\u6807\u8BC6\u7B26\uFF08\u82F1\u6587 slug\uFF0C\u5982 red_light_on_wechat\uFF09" },
+        description: {
           type: "string",
-          description: "\u76EE\u6807\u7248\u672C\u53F7\uFF0C\u5982 1.11.0"
+          description: "\u81EA\u7136\u8BED\u8A00\u89E6\u53D1\u6761\u4EF6\uFF0C\u540C\u65F6\u4F5C\u4E3A\u89C4\u5219\u7528\u9014\u8BF4\u660E\u3002Agent \u6309\u6B64\u5B57\u6BB5\u5224\u65AD\u662F\u5426\u547D\u4E2D\uFF0C\u5FC5\u987B\u6E05\u6670\u63CF\u8FF0\u300C\u4F55\u65F6\u89E6\u53D1\u300D"
+        },
+        segments: segmentsSchema,
+        repeat_times: {
+          type: "number",
+          description: "\u6574\u6761\u706F\u6548\u5E8F\u5217\u91CD\u590D\u6B21\u6570\uFF0C0=\u65E0\u9650\u5FAA\u73AF\uFF0C1=\u64AD\u653E\u4E00\u6B21\uFF08\u9ED8\u8BA4\uFF09"
         }
       }
     },
     async execute(_toolCallId, params) {
-      const { version } = params;
-      const targetDir = resolveTargetDir(api);
-      const result = await executeUpdate(
-        version,
-        api.runtime.system.runCommandWithTimeout,
-        logger,
-        targetDir,
-        (v, url) => updateConfigRecord(api, v, targetDir, url)
-      );
-      if (result.success) {
-        pendingUpdate = null;
-        externalUpdateNotifier?.clearPendingUpdate();
+      const { name, description, segments, repeat_times } = params;
+      if (!name || typeof name !== "string")
+        return err("INVALID_PARAMS", "name is required");
+      if (!description || typeof description !== "string")
+        return err("INVALID_PARAMS", "description is required");
+      const validation = validateSegments(segments);
+      if (!validation.valid) return err("VALIDATION_FAILED", JSON.stringify(validation.errors));
+      let repeatTimes;
+      try {
+        repeatTimes = normalizeRepeatTimes({ repeat_times });
+        assertAncsRepeatTimes(repeatTimes);
+      } catch (e) {
+        return err("VALIDATION_FAILED", e?.message ?? "Unknown error");
+      }
+      try {
+        const result = await registry.create({
+          name,
+          description,
+          matchRules: {},
+          segments: validation.segments,
+          repeat_times: repeatTimes,
+          cronSchedule: "*/5 * * * *"
+        });
+        logger.info(`lightrules.create tool: created ${name}`);
+        return ok({ ok: true, name, cronHint: result.cronHint });
+      } catch (e) {
+        if (e instanceof LightRuleError) return err(e.code, e.message);
+        logger.warn(`lightrules.create tool failed: ${e?.message}`);
+        return err("INTERNAL_ERROR", e?.message ?? "Unknown error");
       }
-      return {
-        content: [{ type: "text", text: result.message }],
-        details: result
-      };
-    }
-  });
-  api.registerGatewayMethod("plugin.update", async ({ params, respond, context }) => {
-    rememberBroadcast?.(context?.broadcast);
-    const version = params.version;
-    if (!version) {
-      respond(false, void 0, {
-        code: "MISSING_VERSION",
-        message: "version is required"
-      });
-      return;
-    }
-    const targetDir = resolveTargetDir(api);
-    const result = await executeUpdate(
-      version,
-      api.runtime.system.runCommandWithTimeout,
-      logger,
-      targetDir,
-      (v, url) => updateConfigRecord(api, v, targetDir, url)
-    );
-    if (result.success) {
-      pendingUpdate = null;
-      externalUpdateNotifier?.clearPendingUpdate();
-    }
-    if (result.success) {
-      respond(true, { message: result.message });
-    } else {
-      respond(false, void 0, {
-        code: "UPDATE_FAILED",
-        message: result.message
-      });
     }
   });
-  const intervalMs = (config.checkIntervalHours ?? 4) * 36e5;
-  const channel = config.channel ?? "latest";
-  logger.info(
-    `\u81EA\u52A8\u66F4\u65B0\u5DF2\u542F\u7528: channel=${channel}, checkIntervalHours=${config.checkIntervalHours ?? 4}`
-  );
-  const checker = new UpdateChecker(
-    logger,
-    (update) => {
-      pendingUpdate = update;
-      const broadcasted = tryBroadcastUpdate(update);
-      if (!broadcasted) pendingGatewayUpdate = update;
-      if (!broadcasted) {
-        externalUpdateNotifier?.notifyUpdateAvailable(update);
+  api.registerTool({
+    name: "lightrules.update",
+    label: "Update Light Rule",
+    description: '\u4FEE\u6539\u706F\u6548\u89C4\u5219\uFF08\u542F\u7528/\u7981\u7528\u3001\u6539\u63CF\u8FF0\u3001\u6539\u706F\u6548\u53C2\u6570\uFF09\u3002\u5F53\u7528\u6237\u8BF4"\u7981\u7528\u67D0\u6761\u89C4\u5219"\u3001"\u542F\u7528\u89C4\u5219"\u3001"\u4FEE\u6539\u706F\u6548\u89C4\u5219"\u7B49\u65F6\u8C03\u7528\u3002',
+    parameters: {
+      type: "object",
+      required: ["name"],
+      additionalProperties: false,
+      properties: {
+        name: { type: "string", description: "\u8981\u4FEE\u6539\u7684\u89C4\u5219\u540D\u79F0\uFF08\u552F\u4E00\u6807\u8BC6\u7B26\uFF09" },
+        description: { type: "string", description: "\u65B0\u7684\u89E6\u53D1\u6761\u4EF6\u63CF\u8FF0\uFF08\u53EF\u9009\uFF09" },
+        enabled: { type: "boolean", description: "true=\u542F\u7528\uFF0Cfalse=\u7981\u7528" },
+        segments: { ...segmentsSchema, description: "\u65B0\u7684\u706F\u6548\u6BB5\u5E8F\u5217\uFF08\u53EF\u9009\uFF0C\u4E0D\u586B\u5219\u4FDD\u6301\u4E0D\u53D8\uFF09" },
+        repeat_times: { type: "number", description: "\u65B0\u7684\u91CD\u590D\u6B21\u6570\uFF08\u53EF\u9009\uFF09" }
       }
-      logger.info(
-        `\u5DF2\u901A\u77E5\u66F4\u65B0 ${update.current} \u2192 ${update.latest}` + (broadcasted ? "\uFF08\u5BF9\u8BDD + \u7F51\u5173\uFF09" : "\uFF08\u5BF9\u8BDD\u901A\u9053\u5DF2\u751F\u6548\uFF0C\u7B49\u5F85\u4E0B\u6B21 gateway \u8BF7\u6C42\u65F6\u8865\u53D1\u5BA2\u6237\u7AEF\u4E8B\u4EF6\uFF09")
-      );
     },
-    intervalMs,
-    channel
-  );
-  return {
-    start: () => checker.start(),
-    stop: () => checker.stop(),
-    notifyBroadcastReady() {
-      const update = pendingGatewayUpdate;
-      if (!update) return;
-      if (!tryBroadcastUpdate(update)) return;
-      logger.info(`\u5DF2\u8865\u53D1\u63D2\u4EF6\u66F4\u65B0\u4E8B\u4EF6 ${update.current} \u2192 ${update.latest}`);
+    async execute(_toolCallId, params) {
+      const { name, description, enabled, segments, repeat_times } = params;
+      if (!name || typeof name !== "string")
+        return err("INVALID_PARAMS", "name is required");
+      let validatedSegments;
+      if (segments !== void 0) {
+        const validation = validateSegments(segments);
+        if (!validation.valid) return err("VALIDATION_FAILED", JSON.stringify(validation.errors));
+        validatedSegments = validation.segments;
+      }
+      let repeatTimes;
+      if (repeat_times !== void 0) {
+        try {
+          repeatTimes = normalizeRepeatTimes({ repeat_times });
+          assertAncsRepeatTimes(repeatTimes);
+        } catch (e) {
+          return err("VALIDATION_FAILED", e?.message ?? "Unknown error");
+        }
+      }
+      try {
+        const result = await registry.update({
+          name,
+          description,
+          segments: validatedSegments,
+          repeat_times: repeatTimes,
+          enabled
+        });
+        logger.info(`lightrules.update tool: updated ${name}`);
+        return ok({
+          ok: true,
+          name: result.meta.name,
+          updated: true,
+          rule: result.meta,
+          cronHint: result.cronHint
+        });
+      } catch (e) {
+        if (e instanceof LightRuleError) return err(e.code, e.message);
+        logger.warn(`lightrules.update tool failed: ${e?.message}`);
+        return err("INTERNAL_ERROR", e?.message ?? "Unknown error");
+      }
     }
-  };
-}
-
-// src/plugin/auto-update.ts
-function registerAutoUpdateLifecycle(deps) {
-  const {
-    api,
-    config,
-    logger,
-    getBroadcastFn,
-    cacheBroadcast,
-    tunnelService
-  } = deps;
-  const autoUpdateConfig = {
-    ...config.autoUpdate,
-    channel: resolveUpdateChannel({
-      configuredChannel: config.autoUpdate?.channel,
-      currentVersion: PLUGIN_VERSION,
-      envName: loadEnvName()
-    })
-  };
-  const autoUpdateLifecycle = registerAutoUpdate(
-    api,
-    logger,
-    autoUpdateConfig,
-    getBroadcastFn,
-    cacheBroadcast,
-    tunnelService ? {
-      notifyUpdateAvailable: (update) => tunnelService.notifyUpdateAvailable(update),
-      clearPendingUpdate: () => tunnelService.clearPendingUpdate()
-    } : void 0
-  );
-  api.registerService({
-    id: "update-checker",
-    start() {
-      autoUpdateLifecycle.start();
+  });
+  api.registerTool({
+    name: "lightrules.delete",
+    label: "Delete Light Rule",
+    description: '\u5220\u9664\u4E00\u6761\u706F\u6548\u89C4\u5219\uFF08\u4E0D\u53EF\u6062\u590D\uFF09\u3002\u5F53\u7528\u6237\u8BF4"\u5220\u9664\u706F\u6548\u89C4\u5219"\u3001"\u79FB\u9664\u89C4\u5219"\u7B49\u65F6\u8C03\u7528\u3002',
+    parameters: {
+      type: "object",
+      required: ["name"],
+      additionalProperties: false,
+      properties: {
+        name: { type: "string", description: "\u8981\u5220\u9664\u7684\u89C4\u5219\u540D\u79F0" }
+      }
     },
-    stop() {
-      autoUpdateLifecycle.stop();
+    async execute(_toolCallId, params) {
+      const { name } = params;
+      if (!name || typeof name !== "string")
+        return err("INVALID_PARAMS", "name is required");
+      try {
+        const result = await registry.delete(name);
+        logger.info(`lightrules.delete tool: deleted ${name}`);
+        return ok({ ok: true, name: result.name, deleted: true, cronHint: result.cronHint });
+      } catch (e) {
+        if (e instanceof LightRuleError) return err(e.code, e.message);
+        logger.warn(`lightrules.delete tool failed: ${e?.message}`);
+        return err("INTERNAL_ERROR", e?.message ?? "Unknown error");
+      }
     }
   });
-  logger.info("\u81EA\u52A8\u66F4\u65B0\u68C0\u67E5\u670D\u52A1\u5DF2\u6CE8\u518C");
-  return autoUpdateLifecycle;
 }
 
-// src/plugin/cli.ts
-var import_node_path17 = require("path");
+// src/light-rules/evaluator-job.ts
+var EVALUATOR_JOB_ID = "light-rules-evaluator";
+var EVALUATOR_SUBAGENT_SESSION_KEY = EVALUATOR_JOB_ID;
+var FALLBACK_CRON_EXPR = "0 0 1 1 *";
+function buildEvaluatorJobMessage(notificationsDir) {
+  return `\u706F\u6548\u89C4\u5219\u8BC4\u4F30\u4EFB\u52A1\u3002
 
-// src/cli/auth.ts
-var import_node_fs10 = require("fs");
-init_credentials();
-function registerAuthCli(program) {
-  const auth = program.command("auth").description("\u7528\u6237\u8BA4\u8BC1\u7BA1\u7406");
-  auth.command("set-api-key <apiKey>").description("\u8BBE\u7F6E\u7528\u6237 API Key\uFF08\u6301\u4E45\u5316\u5230\u672C\u5730\u914D\u7F6E\uFF09").action((apiKey) => {
-    writeCredentials({ ...readCredentials(), apiKey, token: void 0 });
-    output({
-      ok: true,
-      apiKey: apiKey.slice(0, 8) + "\u2026",
-      storedAt: credentialsPath()
-    });
-  });
-  auth.command("set-token <token>").description("\uFF08\u517C\u5BB9\uFF09\u8BBE\u7F6E\u7528\u6237 API Key\uFF08\u65E7\u547D\u4EE4\u540D\uFF09").action((token) => {
-    writeCredentials({ ...readCredentials(), apiKey: token, token: void 0 });
-    output({
-      ok: true,
-      apiKey: token.slice(0, 8) + "\u2026",
-      storedAt: credentialsPath()
-    });
-  });
-  auth.command("show").description("\u67E5\u770B\u5F53\u524D\u8BA4\u8BC1\u72B6\u6001").action(() => {
-    const creds = readCredentials();
-    const apiKey = creds.apiKey ?? creds.token;
-    if (apiKey) {
-      output({
-        ok: true,
-        hasApiKey: true,
-        apiKey: apiKey.slice(0, 8) + "\u2026",
-        storedAt: credentialsPath()
-      });
-    } else {
-      output({ ok: true, hasApiKey: false });
-    }
-  });
-  auth.command("clear").description("\u6E05\u9664\u5DF2\u4FDD\u5B58\u7684\u8BA4\u8BC1\u4FE1\u606F").action(() => {
-    const path2 = credentialsPath();
-    if ((0, import_node_fs10.existsSync)(path2)) {
-      const creds = readCredentials();
-      delete creds.apiKey;
-      delete creds.token;
-      if (Object.keys(creds).length === 0) {
-        (0, import_node_fs10.rmSync)(path2, { force: true });
-      } else {
-        writeCredentials(creds);
-      }
-    }
-    output({ ok: true, cleared: true });
-  });
+\u6267\u884C\u6B65\u9AA4\uFF1A
+1. \u8BFB\u53D6 tasks/light-rules-evaluator/checkpoint.json\uFF08\u8BB0\u5F55\u4E0A\u6B21\u5904\u7406\u8FDB\u5EA6\uFF09
+2. \u626B\u63CF ${notificationsDir} \u76EE\u5F55\uFF0C\u83B7\u53D6 checkpoint \u4E4B\u540E\u7684\u65B0\u901A\u77E5
+3. \u626B\u63CF tasks/ \u76EE\u5F55\uFF0C\u8BFB\u53D6\u6240\u6709 type=light-rule \u4E14 enabled=true \u7684 meta.json
+4. \u5BF9\u6BCF\u6761\u65B0\u901A\u77E5\uFF0C\u9010\u4E00\u5224\u65AD\u662F\u5426\u547D\u4E2D\u6BCF\u6761\u89C4\u5219\u7684 description\uFF08\u8BED\u4E49\u5339\u914D\uFF09
+5. \u547D\u4E2D\u65F6\uFF1A\u4EE5\u8BE5\u89C4\u5219\u7684 segments \u548C repeat_times \u8C03\u7528 light_control \u5DE5\u5177
+6. \u66F4\u65B0 checkpoint.json\uFF0C\u8BB0\u5F55\u5DF2\u5904\u7406\u5230\u7684\u6700\u65B0\u901A\u77E5\u4F4D\u7F6E
+7. \u82E5\u65E0\u65B0\u901A\u77E5\u6216\u65E0 enabled \u89C4\u5219\uFF1A\u8F93\u51FA NO_CHANGE\uFF0C\u76F4\u63A5\u7ED3\u675F`;
 }
-
-// src/cli/ntf-search.ts
-function filterItem(item, opts) {
-  if (opts.app && item.appName !== opts.app) return false;
-  if (opts.sender && !item.title.includes(opts.sender)) return false;
-  if (opts.keyword && !item.title.includes(opts.keyword) && !item.content.includes(opts.keyword)) {
-    return false;
+var LightRulesEvaluatorJob = class {
+  logger;
+  registry;
+  subagentRunner;
+  getNotificationsDir;
+  /**
+   * 记录本进程生命周期内 job 是否已确认存在。
+   * 仅在 `ensureJobExists` 成功后置 true，避免每次 push 都做检查。
+   */
+  jobEnsured = false;
+  /**
+   * 首次创建 job 时的并发保护。
+   * 避免冷启动瞬间多条通知并发到达时重复调用 `cron.add`。
+   */
+  ensureJobPromise = null;
+  /**
+   * subagent fallback 路径的并发保护。
+   * 若评估 session 已在运行中，跳过本次触发（checkpoint 保证下次补处理）。
+   */
+  subagentInFlight = false;
+  constructor(deps) {
+    this.logger = deps.logger;
+    this.registry = deps.registry;
+    this.subagentRunner = deps.subagentRunner;
+    this.getNotificationsDir = deps.getNotificationsDir ?? (() => void 0);
   }
-  return true;
-}
-function registerNtfSearch(ntf, ctx) {
-  ntf.command("search").description("\u67E5\u8BE2\u901A\u77E5\uFF08\u6309\u65F6\u95F4/\u5E94\u7528/\u53D1\u9001\u4EBA/\u5173\u952E\u8BCD\u7B5B\u9009\uFF09").option("--from <time>", "\u5F00\u59CB\u65F6\u95F4 ISO 8601\uFF0C\u4F8B\u5982 2026-03-01T09:00:00+08:00").option("--to <time>", "\u7ED3\u675F\u65F6\u95F4 ISO 8601\uFF0C\u4F8B\u5982 2026-03-01T18:00:00+08:00").option("--app <name>", "\u6309\u5E94\u7528\u540D\u8FC7\u6EE4").option("--sender <name>", "\u6309\u53D1\u9001\u4EBA\u8FC7\u6EE4").option("--keyword <text>", "\u5728\u6807\u9898\u548C\u5185\u5BB9\u4E2D\u641C\u7D22\u5173\u952E\u8BCD").option("--limit <n>", "\u6700\u5927\u8FD4\u56DE\u6761\u6570", "100").action(
-    async (opts) => {
-      const dir = resolveNotificationsDir(ctx);
-      if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
-      progress("\u6B63\u5728\u641C\u7D22\u901A\u77E5...");
-      const limit = parseInt(opts.limit, 10) || 100;
-      if (limit <= 0) {
-        exitError("INVALID_LIMIT", "--limit \u5FC5\u987B\u662F\u5927\u4E8E 0 \u7684\u6574\u6570");
-      }
-      const hasFrom = typeof opts.from === "string" && opts.from.length > 0;
-      const hasTo = typeof opts.to === "string" && opts.to.length > 0;
-      const fromTs = hasFrom ? parseIsoTime(opts.from, "--from") : null;
-      const toTs = hasTo ? parseIsoTime(opts.to, "--to") : null;
-      if (fromTs !== null && toTs !== null && fromTs > toTs) {
-        exitError("INVALID_TIME_RANGE", "--from \u4E0D\u80FD\u665A\u4E8E --to");
+  /**
+   * 通知落盘后调用。若有新增通知且存在 enabled 规则，则触发评估。
+   *
+   * 两条路径：
+   *  - cron 不为 null：enqueueRun("force") 入队（gateway context 路径，正常路径）
+   *  - cron 为 null：通过 subagentRunner 直接运行（HTTP Relay 路径，fallback）
+   *
+   * @param cron          来自 gateway context 的 CronService；HTTP 路径下为 null
+   * @param insertedCount 本次 ingest 新落盘的通知条数（StoredNotification 去重后）
+   */
+  async triggerIfNeeded(cron, insertedCount) {
+    if (insertedCount === 0) return;
+    if (this.registry.getEnabled().length === 0) return;
+    if (!cron) {
+      await this.triggerViaSubagent();
+      return;
+    }
+    try {
+      await this.ensureJobExists(cron);
+    } catch (err2) {
+      this.logger.warn(`light-rules-evaluator: job ensure failed: ${err2?.message ?? err2}`);
+      return;
+    }
+    try {
+      const result = await cron.enqueueRun(EVALUATOR_JOB_ID, "force");
+      if (!result.ok) {
+        this.logger.warn("light-rules-evaluator: enqueueRun returned ok=false");
+        return;
       }
-      const keys = await listDateKeysAsync(dir);
-      const results = [];
-      if (fromTs !== null || toTs !== null) {
-        const fromDateKey = hasFrom ? opts.from.slice(0, 10) : null;
-        const toDateKey = hasTo ? opts.to.slice(0, 10) : null;
-        for (const dateKey of keys) {
-          if (fromDateKey && dateKey < fromDateKey) continue;
-          if (toDateKey && dateKey > toDateKey) continue;
-          const items = await readDateFileAsync(dir, dateKey);
-          for (const item of items) {
-            if (!filterItem(item, opts)) continue;
-            const itemTs = Date.parse(item.timestamp);
-            if (Number.isNaN(itemTs)) continue;
-            if (fromTs !== null && itemTs < fromTs) continue;
-            if (toTs !== null && itemTs > toTs) continue;
-            results.push(item);
-          }
-        }
-      } else {
-        for (const dateKey of keys) {
-          const items = await readDateFileAsync(dir, dateKey);
-          for (const item of items) {
-            if (!filterItem(item, opts)) continue;
-            if (Number.isNaN(Date.parse(item.timestamp))) continue;
-            results.push(item);
-          }
-        }
+      if ("enqueued" in result && result.enqueued) {
+        this.logger.info(`light-rules-evaluator: enqueued runId=${result.runId}`);
+      } else if ("reason" in result) {
+        this.logger.info(`light-rules-evaluator: enqueueRun skipped (${result.reason})`);
       }
-      const notifications = sortNotificationsByTimestampDesc(results).slice(
-        0,
-        limit
-      );
-      output({
-        ok: true,
-        total: notifications.length,
-        notifications
-      });
+    } catch (err2) {
+      this.logger.warn(`light-rules-evaluator: enqueueRun failed: ${err2?.message ?? err2}`);
     }
-  );
-}
-
-// src/cli/ntf-stats.ts
-function registerNtfStats(ntf, ctx) {
-  ntf.command("stats").description("\u901A\u77E5\u7EDF\u8BA1\u5206\u6790\uFF08\u6309\u65E5\u671F/\u5E94\u7528/\u53D1\u9001\u4EBA/\u65F6\u6BB5\u805A\u5408\uFF09").option("--from <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD", daysAgo(7)).option("--to <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD", today()).option("--app <name>", "\u53EA\u7EDF\u8BA1\u6307\u5B9A\u5E94\u7528").option("--dim <dimension>", "\u7EDF\u8BA1\u7EF4\u5EA6\uFF1Adate/app/sender/hour/all", "all").action(
-    (opts) => {
-      const dir = resolveNotificationsDir(ctx);
-      if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
-      const dim = opts.dim;
-      const keys = filterDateRange(listDateKeys(dir), opts.from, opts.to);
-      const byDate = {};
-      const byApp = {};
-      const bySender = {};
-      const byHour = {};
-      let total = 0;
-      for (const dateKey of keys) {
-        const items = readDateFile(dir, dateKey);
-        let dateCount = 0;
-        for (const item of items) {
-          if (opts.app && item.appName !== opts.app) continue;
-          total++;
-          dateCount++;
-          byApp[item.appName] = (byApp[item.appName] || 0) + 1;
-          if (item.title) {
-            bySender[item.title] = (bySender[item.title] || 0) + 1;
-          }
-          const hourMatch = /T(\d{2}):/.exec(item.timestamp);
-          if (hourMatch) {
-            const h = hourMatch[1];
-            byHour[h] = (byHour[h] || 0) + 1;
-          }
-        }
-        byDate[dateKey] = dateCount;
-      }
-      const result = {
-        ok: true,
-        range: { from: opts.from, to: opts.to },
-        total
-      };
-      if (dim === "date" || dim === "all") {
-        result.byDate = byDate;
-      }
-      if (dim === "app" || dim === "all") {
-        result.byApp = byApp;
-      }
-      if (dim === "sender" || dim === "all") {
-        const sorted = Object.entries(bySender).sort((a, b) => b[1] - a[1]).slice(0, 20).map(([sender, count]) => ({ sender, count }));
-        result.bySender = sorted;
-      }
-      if (dim === "hour" || dim === "all") {
-        result.byHour = byHour;
-      }
-      output(result);
-    }
-  );
-}
-
-// src/cli/ntf-sync.ts
-var import_node_fs11 = require("fs");
-var import_node_path10 = require("path");
-var SYNC_FETCH_LIMIT = 300;
-function checkpointPath(dir) {
-  return (0, import_node_path10.join)(dir, ".checkpoint.json");
-}
-function readCheckpoint(dir) {
-  const p = checkpointPath(dir);
-  if (!(0, import_node_fs11.existsSync)(p)) return {};
-  try {
-    return JSON.parse((0, import_node_fs11.readFileSync)(p, "utf-8"));
-  } catch {
-    return {};
   }
-}
-function writeCheckpoint(dir, data) {
-  (0, import_node_fs11.writeFileSync)(checkpointPath(dir), JSON.stringify(data, null, 2), "utf-8");
-}
-function registerNtfSync(ntf, ctx) {
-  const sync = ntf.command("sync").description("\u540C\u6B65\u901A\u77E5\u5230\u8BB0\u5FC6\u7CFB\u7EDF");
-  sync.command("scan").description("\u626B\u63CF\u672A\u5904\u7406\u7684\u901A\u77E5\uFF0C\u8FD4\u56DE\u5F85\u540C\u6B65\u6458\u8981").action(() => {
-    const dir = resolveNotificationsDir(ctx);
-    if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
-    const checkpoint = readCheckpoint(dir);
-    const keys = listDateKeys(dir);
-    const pending = [];
-    let totalPending = 0;
-    for (const dateKey of keys) {
-      const items = readDateFile(dir, dateKey);
-      const lastIndex = checkpoint[dateKey]?.lastIndex ?? -1;
-      const unprocessed = items.length - (lastIndex + 1);
-      if (unprocessed > 0) {
-        pending.push({
-          date: dateKey,
-          count: unprocessed,
-          startIndex: lastIndex + 1
-        });
-        totalPending += unprocessed;
-      }
+  /**
+   * cron service 不可用时的 fallback：直接通过 subagentRunner 运行评估 session。
+   *
+   * 并发保护：若上一次 subagent 运行尚未完成，本次跳过。
+   * checkpoint 保证即使本次跳过，下次触发时会处理所有积压通知。
+   */
+  async triggerViaSubagent() {
+    if (!this.subagentRunner) {
+      this.logger.warn(
+        "light-rules-evaluator: cron service unavailable and no subagent fallback configured; notifications ingested via HTTP will not trigger light rules until an agent session is active"
+      );
+      return;
     }
-    output({ ok: true, pending, totalPending });
-  });
-  sync.command("fetch").description("\u83B7\u53D6\u6307\u5B9A\u65E5\u671F\u7684\u672A\u5904\u7406\u901A\u77E5\u8BE6\u60C5").requiredOption("--date <date>", "\u76EE\u6807\u65E5\u671F YYYY-MM-DD").action((opts) => {
-    const dir = resolveNotificationsDir(ctx);
-    if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
-    const items = readDateFile(dir, opts.date);
-    if (items.length === 0) {
-      exitError("NO_DATA", `\u65E5\u671F ${opts.date} \u65E0\u901A\u77E5\u6570\u636E`);
+    if (this.subagentInFlight) {
+      this.logger.info("light-rules-evaluator: subagent run in-flight, skipping this trigger");
+      return;
     }
-    const checkpoint = readCheckpoint(dir);
-    const lastIndex = checkpoint[opts.date]?.lastIndex ?? -1;
-    const startIndex = lastIndex + 1;
-    const unprocessed = items.slice(startIndex);
-    const notifications = unprocessed.slice(0, SYNC_FETCH_LIMIT);
-    const endIndex = notifications.length > 0 ? startIndex + notifications.length - 1 : lastIndex;
-    const hasMore = unprocessed.length > notifications.length;
-    if (unprocessed.length === 0) {
-      output({
-        ok: true,
-        date: opts.date,
-        startIndex,
-        endIndex,
-        nextStartIndex: null,
-        limit: SYNC_FETCH_LIMIT,
-        returned: 0,
-        totalUnprocessed: 0,
-        hasMore: false,
-        notifications: []
+    const notificationsDir = this.getNotificationsDir();
+    if (!notificationsDir) {
+      this.logger.warn("light-rules-evaluator: notifications dir not ready, skipping subagent trigger");
+      return;
+    }
+    this.subagentInFlight = true;
+    try {
+      const result = await this.subagentRunner.run({
+        sessionKey: EVALUATOR_SUBAGENT_SESSION_KEY,
+        message: buildEvaluatorJobMessage(notificationsDir),
+        deliver: false,
+        idempotencyKey: `${EVALUATOR_SUBAGENT_SESSION_KEY}-${Date.now()}`
+      });
+      this.logger.info(`light-rules-evaluator: subagent triggered runId=${result.runId}`);
+    } catch (err2) {
+      this.logger.warn(`light-rules-evaluator: subagent trigger failed: ${err2?.message ?? err2}`);
+    } finally {
+      this.subagentInFlight = false;
+    }
+  }
+  /**
+   * 按需创建 `light-rules-evaluator` job。
+   * 若 job 已存在（内存缓存或 cron store），直接返回；否则调用 `cron.add`。
+   */
+  async ensureJobExists(cron) {
+    if (this.jobEnsured) return;
+    if (!this.ensureJobPromise) {
+      this.ensureJobPromise = this.createJobIfNeeded(cron).finally(() => {
+        this.ensureJobPromise = null;
       });
+    }
+    await this.ensureJobPromise;
+  }
+  async createJobIfNeeded(cron) {
+    if (cron.getJob(EVALUATOR_JOB_ID)) {
+      this.jobEnsured = true;
       return;
     }
-    output({
-      ok: true,
-      date: opts.date,
-      startIndex,
-      endIndex,
-      nextStartIndex: hasMore ? endIndex + 1 : null,
-      limit: SYNC_FETCH_LIMIT,
-      returned: notifications.length,
-      totalUnprocessed: unprocessed.length,
-      hasMore,
-      notifications
-    });
-  });
-  sync.command("commit").description("\u6807\u8BB0\u6307\u5B9A\u65E5\u671F\u5F53\u524D\u6279\u6B21\u5904\u7406\u5B8C\u6210\uFF0C\u66F4\u65B0 checkpoint").requiredOption("--date <date>", "\u76EE\u6807\u65E5\u671F YYYY-MM-DD").action((opts) => {
-    const dir = resolveNotificationsDir(ctx);
-    if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
-    const items = readDateFile(dir, opts.date);
-    if (items.length === 0) {
-      exitError("NO_DATA", `\u65E5\u671F ${opts.date} \u65E0\u901A\u77E5\u6570\u636E`);
+    try {
+      await cron.add({
+        id: EVALUATOR_JOB_ID,
+        name: "\u706F\u6548\u89C4\u5219\u8BC4\u4F30",
+        description: "\u4E8B\u4EF6\u9A71\u52A8\uFF1A\u901A\u77E5\u5230\u8FBE\u65F6\u8BC4\u4F30\u6240\u6709 enabled \u706F\u6548\u89C4\u5219\uFF0C\u547D\u4E2D\u5219\u8C03\u7528 light_control \u89E6\u53D1\u706F\u6548",
+        enabled: true,
+        schedule: { kind: "cron", expr: FALLBACK_CRON_EXPR },
+        sessionTarget: "isolated",
+        wakeMode: "now",
+        payload: {
+          kind: "agentTurn",
+          message: buildEvaluatorJobMessage(this.getNotificationsDir() ?? "notifications")
+        }
+      });
+      this.logger.info("light-rules-evaluator: job created");
+    } catch (err2) {
+      if (!cron.getJob(EVALUATOR_JOB_ID)) {
+        throw err2;
+      }
     }
-    const checkpoint = readCheckpoint(dir);
-    const lastIndex = checkpoint[opts.date]?.lastIndex ?? -1;
-    const committedIndex = Math.min(items.length - 1, lastIndex + SYNC_FETCH_LIMIT);
-    const hasMore = committedIndex < items.length - 1;
-    checkpoint[opts.date] = { lastIndex: committedIndex };
-    writeCheckpoint(dir, checkpoint);
-    output({
-      ok: true,
-      date: opts.date,
-      committedIndex,
-      limit: SYNC_FETCH_LIMIT,
-      hasMore,
-      nextStartIndex: hasMore ? committedIndex + 1 : null
-    });
-  });
-}
+    this.jobEnsured = true;
+  }
+};
 
-// src/cli/ntf-monitor.ts
-var import_node_fs12 = require("fs");
-var import_node_path11 = require("path");
-function tasksDir2(ctx) {
-  const base = ctx.workspaceDir || ctx.stateDir;
-  if (!base) throw new Error("workspaceDir and stateDir both unavailable");
-  return (0, import_node_path11.join)(base, "tasks");
+// src/light-rules/migration.ts
+var import_node_fs6 = require("fs");
+var import_node_path5 = require("path");
+var NO_MATCH_FETCH_PY = `#!/usr/bin/env python3
+# \u6B64\u6587\u4EF6\u7531\u8FC1\u79FB\u5DE5\u5177\u751F\u6210\u3002
+# \u706F\u6548\u89C4\u5219\u5DF2\u8FC1\u79FB\u81F3\u4E8B\u4EF6\u9A71\u52A8\u67B6\u6784\uFF0C\u6B64 cron job \u4E0D\u518D\u6267\u884C\u5B9E\u9645\u5DE5\u4F5C\u3002
+print("NO_MATCH")
+`;
+function normalizeScriptText(text) {
+  return text.replace(/\r\n/g, "\n").trim();
 }
-function readMeta2(taskDir) {
-  const metaPath = (0, import_node_path11.join)(taskDir, "meta.json");
-  if (!(0, import_node_fs12.existsSync)(metaPath)) return null;
-  try {
-    return JSON.parse((0, import_node_fs12.readFileSync)(metaPath, "utf-8"));
-  } catch {
-    return null;
+function resolveTasksDir(ctx) {
+  if (ctx.workspaceDir) return (0, import_node_path5.join)(ctx.workspaceDir, "tasks");
+  if (ctx.stateDir) {
+    const inferredWorkspaceDir = (0, import_node_path5.join)(ctx.stateDir, "workspace");
+    if ((0, import_node_fs6.existsSync)(inferredWorkspaceDir)) return (0, import_node_path5.join)(inferredWorkspaceDir, "tasks");
+    return (0, import_node_path5.join)(ctx.stateDir, "tasks");
   }
+  return null;
 }
-function writeMeta2(taskDir, meta) {
-  (0, import_node_fs12.writeFileSync)((0, import_node_path11.join)(taskDir, "meta.json"), JSON.stringify(meta, null, 2), "utf-8");
+function migrateLegacyLightRuleTasks(ctx, logger) {
+  const tasksDir3 = resolveTasksDir(ctx);
+  if (!tasksDir3 || !(0, import_node_fs6.existsSync)(tasksDir3)) return;
+  try {
+    for (const entry of (0, import_node_fs6.readdirSync)(tasksDir3, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      migrateTaskDir((0, import_node_path5.join)(tasksDir3, String(entry.name)), logger);
+    }
+  } catch (err2) {
+    logger.warn(`migration: failed to read tasks dir: ${err2?.message}`);
+  }
 }
-function generateReadme(name, description) {
-  return `# Monitor Task: ${name}
-
-## \u63CF\u8FF0
-${description}
-
-## \u5904\u7406\u6307\u5357
-\u5F53 fetch.py \u8F93\u51FA\u5339\u914D\u7684\u901A\u77E5\u65F6\uFF0C\u8BF7\uFF1A
-1. \u9605\u8BFB\u5339\u914D\u5230\u7684\u901A\u77E5\u5185\u5BB9
-2. \u6839\u636E\u4EFB\u52A1\u63CF\u8FF0\u5224\u65AD\u662F\u5426\u9700\u8981\u901A\u77E5\u7528\u6237
-3. \u5982\u9700\u901A\u77E5\u7528\u6237\uFF0C\u4F7F\u7528 message \u5DE5\u5177\u53D1\u9001\u6458\u8981
-`;
+function migrateTaskDir(taskDir, logger) {
+  const metaPath = (0, import_node_path5.join)(taskDir, "meta.json");
+  if (!(0, import_node_fs6.existsSync)(metaPath)) return;
+  let meta;
+  try {
+    meta = JSON.parse((0, import_node_fs6.readFileSync)(metaPath, "utf-8"));
+  } catch {
+    return;
+  }
+  if (meta.type !== "light-rule") return;
+  const name = typeof meta.name === "string" ? meta.name : taskDir;
+  mergeMatchRulesIntoDescription(meta, name, metaPath, logger);
+  replaceFetchPy(taskDir, name, logger);
+  for (const filename of ["README.md", "checkpoint.json"]) {
+    removeFile((0, import_node_path5.join)(taskDir, filename), name, filename, logger);
+  }
 }
-function registerNtfMonitor(ntf, ctx) {
-  const monitor = ntf.command("monitor").description("\u901A\u77E5\u76D1\u63A7\u4EFB\u52A1\u7BA1\u7406");
-  monitor.command("list").description("\u5217\u51FA\u6240\u6709\u76D1\u63A7\u4EFB\u52A1").action(() => {
-    const dir = tasksDir2(ctx);
-    if (!(0, import_node_fs12.existsSync)(dir)) {
-      output({ ok: true, tasks: [] });
+function mergeMatchRulesIntoDescription(meta, name, metaPath, logger) {
+  const matchRules = meta.matchRules;
+  if (!matchRules || typeof matchRules !== "object") return;
+  const rules = matchRules;
+  const parts = [];
+  if (rules.appName) parts.push(`app=${rules.appName}`);
+  if (rules.senderKeywords?.length) {
+    parts.push(`\u53D1\u4EF6\u4EBA\u5173\u952E\u8BCD=${rules.senderKeywords.join("\u3001")}`);
+  }
+  if (rules.contentKeywords?.length) {
+    parts.push(`\u5185\u5BB9\u5173\u952E\u8BCD=${rules.contentKeywords.join("\u3001")}`);
+  }
+  if (parts.length > 0) {
+    const existing = typeof meta.description === "string" ? meta.description.trim() : "";
+    meta.description = existing ? `${existing}\u3002\u5339\u914D\u89C4\u5219\uFF1A${parts.join("\uFF0C")}` : `\u5339\u914D\u89C4\u5219\uFF1A${parts.join("\uFF0C")}`;
+  }
+  delete meta.matchRules;
+  try {
+    (0, import_node_fs6.writeFileSync)(metaPath, JSON.stringify(meta, null, 2), "utf-8");
+    logger.info(`migration: merged matchRules into description for light rule: ${name}`);
+  } catch (err2) {
+    logger.warn(`migration: failed to update meta.json for ${name}: ${err2?.message}`);
+  }
+}
+function replaceFetchPy(taskDir, name, logger) {
+  const fetchPyPath = (0, import_node_path5.join)(taskDir, "fetch.py");
+  if (!(0, import_node_fs6.existsSync)(fetchPyPath)) return;
+  try {
+    const existing = (0, import_node_fs6.readFileSync)(fetchPyPath, "utf-8");
+    if (normalizeScriptText(existing) === normalizeScriptText(NO_MATCH_FETCH_PY)) {
       return;
     }
-    const tasks = [];
-    for (const entry of (0, import_node_fs12.readdirSync)(dir, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue;
-      const meta = readMeta2((0, import_node_path11.join)(dir, entry.name));
-      if (meta) tasks.push(meta);
+    (0, import_node_fs6.writeFileSync)(fetchPyPath, NO_MATCH_FETCH_PY, "utf-8");
+    logger.info(`migration: replaced fetch.py with NO_MATCH placeholder for ${name}`);
+  } catch (err2) {
+    logger.warn(`migration: failed to replace fetch.py for ${name}: ${err2?.message}`);
+  }
+}
+function removeFile(filePath, ruleName, filename, logger) {
+  if (!(0, import_node_fs6.existsSync)(filePath)) return;
+  try {
+    (0, import_node_fs6.rmSync)(filePath);
+    logger.info(`migration: removed ${filename} for light rule: ${ruleName}`);
+  } catch (err2) {
+    logger.warn(`migration: failed to remove ${filename} for ${ruleName}: ${err2?.message}`);
+  }
+}
+
+// src/plugin/auto-update.ts
+init_env();
+
+// src/update/channel.ts
+function resolveUpdateChannel(params) {
+  if (params.configuredChannel) {
+    return params.configuredChannel;
+  }
+  if (params.currentVersion.includes("-")) {
+    return "beta";
+  }
+  return params.envName === "development" ? "beta" : "latest";
+}
+
+// src/update/index.ts
+var import_node_path10 = require("path");
+
+// src/update/checker.ts
+function parseSemver(v) {
+  const [main, pre = null] = v.split("-", 2);
+  const [major = 0, minor = 0, patch = 0] = main.split(".").map(Number);
+  return { major, minor, patch, pre: pre ?? null };
+}
+function comparePreRelease(a, b) {
+  const aParts = a.split(".");
+  const bParts = b.split(".");
+  for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+    const ap = aParts[i] ?? "";
+    const bp = bParts[i] ?? "";
+    const an = Number(ap);
+    const bn = Number(bp);
+    let diff;
+    if (!Number.isNaN(an) && !Number.isNaN(bn)) {
+      diff = an - bn;
+    } else if (ap < bp) {
+      diff = -1;
+    } else if (ap > bp) {
+      diff = 1;
+    } else {
+      diff = 0;
     }
-    output({ ok: true, tasks });
-  });
-  monitor.command("show <name>").description("\u67E5\u770B\u76D1\u63A7\u4EFB\u52A1\u8BE6\u60C5").action((name) => {
-    const taskDir = (0, import_node_path11.join)(tasksDir2(ctx), name);
-    const meta = readMeta2(taskDir);
-    if (!meta) exitError("NOT_FOUND", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u4E0D\u5B58\u5728`);
-    const checkpointPath2 = (0, import_node_path11.join)(taskDir, "checkpoint.json");
-    let checkpoint = {};
-    if ((0, import_node_fs12.existsSync)(checkpointPath2)) {
-      try {
-        checkpoint = JSON.parse((0, import_node_fs12.readFileSync)(checkpointPath2, "utf-8"));
-      } catch {
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+function isNewerVersion(candidate, current) {
+  const a = parseSemver(candidate);
+  const b = parseSemver(current);
+  if (a.major !== b.major) return a.major > b.major;
+  if (a.minor !== b.minor) return a.minor > b.minor;
+  if (a.patch !== b.patch) return a.patch > b.patch;
+  if (a.pre === null) return b.pre !== null;
+  if (b.pre === null) return false;
+  return comparePreRelease(a.pre, b.pre) > 0;
+}
+var CDN_BASE_URL = "https://artifact.yoooclaw.com/plugin";
+var NPM_BASE_URL = "https://registry.npmjs.org/@yoooclaw/phone-notifications";
+var FETCH_TIMEOUT_MS = 5e3;
+var UpdateChecker = class {
+  constructor(logger, onUpdateFound, intervalMs, channel) {
+    this.logger = logger;
+    this.onUpdateFound = onUpdateFound;
+    this.intervalMs = intervalMs;
+    this.channel = channel;
+  }
+  timer = null;
+  notifiedVersion = null;
+  start() {
+    this.timer = setTimeout(() => {
+      void this.check();
+      this.timer = setInterval(() => void this.check(), this.intervalMs);
+    }, 6e4);
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+  }
+  async check() {
+    const latest = await this.fetchLatestVersion();
+    if (!latest || latest === PLUGIN_VERSION) return;
+    if (latest === this.notifiedVersion) return;
+    if (PLUGIN_VERSION.includes("-") && this.channel !== "beta") return;
+    if (!isNewerVersion(latest, PLUGIN_VERSION)) return;
+    this.notifiedVersion = latest;
+    this.logger.info(`\u53D1\u73B0\u65B0\u7248\u672C: ${PLUGIN_VERSION} \u2192 ${latest}`);
+    this.onUpdateFound({ current: PLUGIN_VERSION, latest });
+  }
+  async fetchLatestVersion() {
+    const tag = this.channel === "beta" ? "beta" : "latest";
+    try {
+      const res = await fetch(`${CDN_BASE_URL}/${tag}`, {
+        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+      });
+      if (res.ok) {
+        const text = (await res.text()).trim();
+        if (text) return text;
       }
+    } catch {
     }
-    output({
-      ok: true,
-      ...meta,
-      matchScript: `tasks/${name}/fetch.py`,
-      readme: `tasks/${name}/README.md`,
-      checkpoint
-    });
-  });
-  monitor.command("create <name>").description("\u521B\u5EFA\u76D1\u63A7\u4EFB\u52A1").requiredOption("--description <text>", "\u4EFB\u52A1\u63CF\u8FF0").requiredOption("--match-rules <json>", "\u5339\u914D\u89C4\u5219 JSON").requiredOption("--schedule <cron>", "cron \u8868\u8FBE\u5F0F").action(
-    (name, opts) => {
-      const dir = tasksDir2(ctx);
-      const taskDir = (0, import_node_path11.join)(dir, name);
-      if ((0, import_node_fs12.existsSync)(taskDir)) {
-        exitError("ALREADY_EXISTS", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u5DF2\u5B58\u5728`);
+    try {
+      const res = await fetch(`${NPM_BASE_URL}/${tag}`, {
+        signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+      });
+      if (res.ok) {
+        const data = await res.json();
+        return data.version ?? null;
       }
-      let matchRules;
+    } catch {
+      this.logger.info("\u7248\u672C\u68C0\u67E5\u5931\u8D25\uFF08CDN + npm \u5747\u4E0D\u53EF\u8FBE\uFF09\uFF0C\u8DF3\u8FC7");
+    }
+    return null;
+  }
+};
+
+// src/update/executor.ts
+var import_node_fs10 = require("fs");
+var import_node_path9 = require("path");
+var import_node_os = require("os");
+var VERSION_PATTERN = /^\d+\.\d+\.\d+(-[\w.]+)?$/;
+var BASE_URL = "https://artifact.yoooclaw.com/plugin";
+async function executeUpdate(version, runCommand, logger, targetDir, updateConfigRecord2) {
+  if (!VERSION_PATTERN.test(version)) {
+    return { success: false, message: `\u975E\u6CD5\u7248\u672C\u53F7: ${version}` };
+  }
+  const tgzUrl = `${BASE_URL}/v${version}/yoooclaw-phone-notifications-${version}.tgz`;
+  logger.info(`\u6267\u884C\u66F4\u65B0: ${tgzUrl} \u2192 ${targetDir}`);
+  const workDir = (0, import_node_fs10.mkdtempSync)((0, import_node_path9.join)((0, import_node_os.tmpdir)(), ".openclaw-plugin-update-"));
+  const tgzPath = (0, import_node_path9.join)(workDir, "plugin.tgz");
+  const stagingDir = (0, import_node_path9.join)(workDir, "staged");
+  let backupDir = null;
+  try {
+    logger.info("\u4E0B\u8F7D\u63D2\u4EF6\u5305...");
+    const response = await fetch(tgzUrl, { signal: AbortSignal.timeout(6e4) });
+    if (!response.ok) {
+      return { success: false, message: `\u4E0B\u8F7D\u5931\u8D25 (HTTP ${response.status}): ${tgzUrl}` };
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    (0, import_node_fs10.writeFileSync)(tgzPath, buffer);
+    logger.info(`\u4E0B\u8F7D\u5B8C\u6210 (${buffer.length} bytes)`);
+    (0, import_node_fs10.mkdirSync)(stagingDir, { recursive: true });
+    const tarResult = await runCommand(
+      ["tar", "-xzf", tgzPath, "-C", stagingDir, "--strip-components=1"],
+      { timeoutMs: 3e4 }
+    );
+    if (tarResult.code !== 0) {
+      const err2 = tarResult.stderr || tarResult.stdout || "unknown error";
+      return { success: false, message: `\u89E3\u538B\u5931\u8D25: ${err2}` };
+    }
+    (0, import_node_fs10.mkdirSync)((0, import_node_path9.dirname)(targetDir), { recursive: true });
+    try {
+      backupDir = `${targetDir}.bak.${Date.now()}`;
+      (0, import_node_fs10.renameSync)(targetDir, backupDir);
+    } catch {
+      backupDir = null;
+    }
+    (0, import_node_fs10.renameSync)(stagingDir, targetDir);
+    try {
+      await updateConfigRecord2(version, tgzUrl);
+    } catch (err2) {
+      logger.warn(`\u914D\u7F6E\u8BB0\u5F55\u66F4\u65B0\u5931\u8D25\uFF08\u63D2\u4EF6\u6587\u4EF6\u5DF2\u5C31\u4F4D\uFF09: ${String(err2)}`);
+    }
+    if (backupDir) {
       try {
-        matchRules = JSON.parse(opts.matchRules);
+        (0, import_node_fs10.rmSync)(backupDir, { force: true, recursive: true });
       } catch {
-        exitError(
-          "VALIDATION_FAILED",
-          "match-rules \u5FC5\u987B\u662F\u5408\u6CD5\u7684 JSON"
-        );
       }
-      (0, import_node_fs12.mkdirSync)(taskDir, { recursive: true });
-      const meta = {
-        name,
-        description: opts.description,
-        matchRules,
-        cronSchedule: opts.schedule,
-        enabled: true,
-        createdAt: (/* @__PURE__ */ new Date()).toISOString()
-      };
-      writeMeta2(taskDir, meta);
-      (0, import_node_fs12.writeFileSync)(
-        (0, import_node_path11.join)(taskDir, "fetch.py"),
-        generateFetchPy(name, matchRules),
-        "utf-8"
-      );
-      (0, import_node_fs12.writeFileSync)(
-        (0, import_node_path11.join)(taskDir, "README.md"),
-        generateReadme(name, opts.description),
-        "utf-8"
-      );
-      output({
-        ok: true,
-        name,
-        created: {
-          script: `tasks/${name}/fetch.py`,
-          readme: `tasks/${name}/README.md`,
-          cronJob: `notif-${name}`
-        },
-        cronHint: {
-          action: "add",
-          job: {
-            name: `notif-${name}`,
-            schedule: opts.schedule,
-            sessionTarget: "isolated",
-            message: `\u624B\u673A\u901A\u77E5\u5DF2\u7531\u72EC\u7ACB\u670D\u52A1\u5B9E\u65F6\u6355\u83B7\u5230 notifications/ \u76EE\u5F55\u7684 JSON \u6587\u4EF6\u4E2D\u3002
-\u6267\u884C\uFF1Apython3 tasks/${name}/fetch.py --notifications-dir notifications
-- NO_CHANGE \u6216 NO_MATCH \u2192 \u4E0D\u56DE\u590D\uFF0C\u76F4\u63A5\u7ED3\u675F\u3002
-- \u6709\u8F93\u51FA \u2192 \u8BFB tasks/${name}/README.md \u4E86\u89E3\u5982\u4F55\u5904\u7406\u6570\u636E\u5E76\u901A\u77E5\u7528\u6237\u3002`
-          }
-        }
-      });
     }
-  );
-  monitor.command("delete <name>").description("\u5220\u9664\u76D1\u63A7\u4EFB\u52A1").option("--yes", "\u8DF3\u8FC7\u786E\u8BA4").action((name, opts) => {
-    const taskDir = (0, import_node_path11.join)(tasksDir2(ctx), name);
-    if (!(0, import_node_fs12.existsSync)(taskDir)) {
-      exitError("NOT_FOUND", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u4E0D\u5B58\u5728`);
+    const msg = `\u5DF2\u66F4\u65B0\u5230 ${version}\uFF0C\u8BF7\u91CD\u542F gateway \u751F\u6548`;
+    logger.info(msg);
+    return { success: true, message: msg };
+  } catch (err2) {
+    if (backupDir) {
+      try {
+        (0, import_node_fs10.rmSync)(targetDir, { force: true, recursive: true });
+        (0, import_node_fs10.renameSync)(backupDir, targetDir);
+        logger.info("\u5DF2\u56DE\u6EDA\u5230\u4E4B\u524D\u7248\u672C");
+      } catch (rollbackErr) {
+        logger.error(`\u56DE\u6EDA\u5931\u8D25: ${String(rollbackErr)}`);
+      }
     }
-    if (!opts.yes) {
-      output({
-        ok: false,
-        error: {
-          code: "CONFIRMATION_REQUIRED",
-          message: `\u786E\u8BA4\u5220\u9664\u76D1\u63A7\u4EFB\u52A1 '${name}'\uFF1F\u6DFB\u52A0 --yes \u8DF3\u8FC7\u786E\u8BA4`
-        }
-      });
-      process.exit(1);
+    const errMsg = `\u66F4\u65B0\u6267\u884C\u5F02\u5E38: ${String(err2)}`;
+    logger.error(errMsg);
+    return { success: false, message: errMsg };
+  } finally {
+    try {
+      (0, import_node_fs10.rmSync)(workDir, { force: true, recursive: true });
+    } catch {
     }
-    (0, import_node_fs12.rmSync)(taskDir, { recursive: true, force: true });
-    output({
-      ok: true,
-      name,
-      deleted: true,
-      cronHint: {
-        action: "remove",
-        name: `notif-${name}`
-      }
-    });
-  });
-  monitor.command("enable <name>").description("\u542F\u7528\u76D1\u63A7\u4EFB\u52A1").action((name) => {
-    const taskDir = (0, import_node_path11.join)(tasksDir2(ctx), name);
-    const meta = readMeta2(taskDir);
-    if (!meta) exitError("NOT_FOUND", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u4E0D\u5B58\u5728`);
-    meta.enabled = true;
-    writeMeta2(taskDir, meta);
-    output({ ok: true, name, enabled: true });
-  });
-  monitor.command("disable <name>").description("\u6682\u505C\u76D1\u63A7\u4EFB\u52A1").action((name) => {
-    const taskDir = (0, import_node_path11.join)(tasksDir2(ctx), name);
-    const meta = readMeta2(taskDir);
-    if (!meta) exitError("NOT_FOUND", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u4E0D\u5B58\u5728`);
-    meta.enabled = false;
-    writeMeta2(taskDir, meta);
-    output({ ok: true, name, enabled: false });
-  });
+  }
 }
 
-// src/cli/light-send.ts
-init_credentials();
-
-// src/light/sender.ts
-var import_node_crypto2 = require("crypto");
-
-// src/light/protocol.ts
-var MAX_LIGHT_SEGMENTS = 12;
-var PROTOCOL_DIGITS = [
-  "\x80",
-  "\x81",
-  "\x82",
-  "\x83",
-  "\x84",
-  "\x91",
-  "\x92",
-  "\x93",
-  "\x94",
-  "\x95",
-  "\x96",
-  "\x97"
-];
-var LED_SEPARATOR_ONCE = "\x9A";
-var LED_SEPARATOR_LOOP = "\x9B";
-var DURATION_STEPS_S = [0.5, 1, 2, 3, 5, 6, 8, 16, 24, 32, 48];
-var INTERVAL_STEPS_MS = [50, 100, 200, 300, 500, 600, 800, 1600, 2400, 3200, 4800];
-var BREATH_STEPS_MS = [1040, 1560, 2080, 2600, 3100, 4160];
-var BRIGHTNESS_STEPS = [32, 64, 96, 128, 192, 255];
-var COLOR_STEPS = [0, 32, 64, 128, 192, 255];
-var BACKGROUND_BRIGHTNESS_STEPS = [0, 32, 64, 96, 128, 192, 255];
-var MULTI_CHANNEL_COLOR_COEFFICIENTS = { r: 1, g: 0.25, b: 0.25 };
-var PURE_WHITE_COLOR_COEFFICIENTS = { r: 1, g: 0.35, b: 0.35 };
-var MODE_TO_INDEX = {
-  wave: 0,
-  breath: 1,
-  strobe: 2,
-  steady: 3,
-  wave_rainbow: 4,
-  pixel_frame: 5
-};
-function buildLightEffectApnsBody(segments, repeatInput) {
-  assertSegmentCount(segments);
-  assertSegmentsValid(segments);
-  const repeatTimes = normalizeRepeatTimes(repeatInput);
-  assertAncsRepeatTimes(repeatTimes);
-  const visibleText = summarizeSegments(segments);
-  const separator = repeatTimes === 0 ? LED_SEPARATOR_LOOP : LED_SEPARATOR_ONCE;
-  const payload = segments.map((segment) => encodeSegment(segment)).join("");
-  return `${visibleText}${separator}${payload}`;
-}
-function assertSegmentCount(segments) {
-  if (segments.length < 1 || segments.length > MAX_LIGHT_SEGMENTS) {
-    throw new Error(`light_control supports 1-${MAX_LIGHT_SEGMENTS} segments`);
+// src/update/index.ts
+var PLUGIN_ID = "phone-notifications";
+function resolveTargetDir(api) {
+  try {
+    const cfg = api.runtime.config?.loadConfig?.();
+    const installPath = cfg?.plugins?.installs?.[PLUGIN_ID]?.installPath;
+    if (installPath) return installPath;
+  } catch {
   }
+  return (0, import_node_path10.join)(api.runtime.state.resolveStateDir(), "extensions", PLUGIN_ID);
 }
-function summarizeSegments(segments) {
-  const modeDesc = segments.map((segment) => segment.mode).join("+");
-  return `Effect: ${modeDesc} (${segments.length} segment${segments.length > 1 ? "s" : ""})`;
+async function updateConfigRecord(api, version, targetDir, tgzUrl) {
+  const configApi = api.runtime.config;
+  if (!configApi) return;
+  const cfg = configApi.loadConfig();
+  if (!cfg.plugins) cfg.plugins = {};
+  if (!cfg.plugins.installs) cfg.plugins.installs = {};
+  cfg.plugins.installs[PLUGIN_ID] = {
+    ...cfg.plugins.installs[PLUGIN_ID],
+    source: "archive",
+    sourcePath: tgzUrl,
+    installPath: targetDir,
+    version,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  await configApi.writeConfigFile(cfg);
 }
-function assertSegmentsValid(segments) {
-  const validation = validateSegments(segments);
-  if (!validation.valid) {
-    throw new Error(
-      validation.errors.map((error) => `${error.field}: ${error.message}`).join("; ")
-    );
+function registerAutoUpdate(api, logger, config, getBroadcast, rememberBroadcast, externalUpdateNotifier) {
+  if (config.enabled === false) {
+    logger.info("\u81EA\u52A8\u66F4\u65B0\u5DF2\u7981\u7528 (autoUpdate.enabled = false)");
+    return { start() {
+    }, stop() {
+    }, notifyBroadcastReady() {
+    } };
   }
-}
-function encodeSegment(segment) {
-  const common = [
-    MODE_TO_INDEX[segment.mode],
-    quantizeDuration(segment.duration_s)
-  ];
-  let values;
-  switch (segment.mode) {
-    case "wave":
-    case "wave_rainbow":
-      const color = normalizeProtocolColor(segment.color);
-      const background = normalizeProtocolColor(segment.background);
-      values = [
-        ...common,
-        quantize(segment.interval_ms ?? 200, INTERVAL_STEPS_MS),
-        quantizeBrightnessValue(segment.brightness ?? 0),
-        quantize(color.r, COLOR_STEPS),
-        quantize(color.g, COLOR_STEPS),
-        quantize(color.b, COLOR_STEPS),
-        segment.direction === "rtl" ? 1 : 0,
-        quantizeWindow(segment.window ?? 2),
-        quantize(background.r, COLOR_STEPS),
-        quantize(background.g, COLOR_STEPS),
-        quantize(background.b, COLOR_STEPS),
-        quantize(segment.background?.brightness ?? 0, BACKGROUND_BRIGHTNESS_STEPS)
-      ];
-      break;
-    case "breath":
-      const breathColor = normalizeProtocolColor(segment.color);
-      values = [
-        ...common,
-        quantizeBreathRiseFall(segment.breath_timing?.rise_ms),
-        quantizeBreathHoldOff(segment.breath_timing?.hold_ms),
-        quantizeBreathRiseFall(segment.breath_timing?.fall_ms),
-        quantizeBreathHoldOff(segment.breath_timing?.off_ms),
-        quantizeBrightnessValue(segment.brightness ?? 0),
-        quantize(breathColor.r, COLOR_STEPS),
-        quantize(breathColor.g, COLOR_STEPS),
-        quantize(breathColor.b, COLOR_STEPS)
-      ];
-      break;
-    case "strobe":
-      const strobeColor = normalizeProtocolColor(segment.color);
-      values = [
-        ...common,
-        quantize(segment.interval_ms ?? 200, INTERVAL_STEPS_MS),
-        quantizeBrightnessValue(segment.brightness ?? 0),
-        quantize(strobeColor.r, COLOR_STEPS),
-        quantize(strobeColor.g, COLOR_STEPS),
-        quantize(strobeColor.b, COLOR_STEPS)
-      ];
-      break;
-    case "steady":
-      const steadyColor = normalizeProtocolColor(segment.color);
-      values = [
-        ...common,
-        quantizeBrightnessValue(segment.brightness ?? 0),
-        quantize(steadyColor.r, COLOR_STEPS),
-        quantize(steadyColor.g, COLOR_STEPS),
-        quantize(steadyColor.b, COLOR_STEPS)
-      ];
-      break;
-    case "pixel_frame":
-      values = encodePixelFrameValues(common, segment);
-      break;
+  let pendingUpdate = null;
+  let pendingGatewayUpdate = null;
+  function tryBroadcastUpdate(update) {
+    const broadcast = getBroadcast();
+    if (!broadcast) return false;
+    broadcast("plugin.updateAvailable", {
+      pluginId: "phone-notifications",
+      current: update.current,
+      latest: update.latest
+    });
+    pendingGatewayUpdate = null;
+    return true;
   }
-  return values.map((value) => PROTOCOL_DIGITS[value]).join("");
-}
-function encodePixelFrameValues(common, segment) {
-  const pixels = segment.pixels ?? [];
-  return [
-    ...common,
-    pixels.length - 1,
-    ...pixels.flatMap((pixel) => {
-      const color = normalizeProtocolColor(pixel.color);
-      return [
-        pixel.index,
-        quantize(color.r, COLOR_STEPS),
-        quantize(color.g, COLOR_STEPS),
-        quantize(color.b, COLOR_STEPS),
-        quantizeBrightnessValue(pixel.brightness)
-      ];
-    })
-  ];
+  api.on("before_prompt_build", () => {
+    if (!pendingUpdate) return;
+    return {
+      appendSystemContext: `[\u7CFB\u7EDF\u901A\u77E5] phone-notifications \u63D2\u4EF6\u6709\u65B0\u7248\u672C ${pendingUpdate.latest} \u53EF\u7528\uFF08\u5F53\u524D\u7248\u672C ${pendingUpdate.current}\uFF09\u3002
+\u8BF7\u7528\u81EA\u7136\u8BED\u8A00\u5728\u5408\u9002\u65F6\u673A\u544A\u77E5\u7528\u6237\uFF0C\u82E5\u7528\u6237\u540C\u610F\u66F4\u65B0\uFF0C\u8C03\u7528 plugin-update tool \u5E76\u4F20\u5165 version \u53C2\u6570\u3002\u82E5\u7528\u6237\u62D2\u7EDD\uFF0C\u4E0D\u518D\u91CD\u590D\u63D0\u9192\u3002`
+    };
+  });
+  api.registerTool({
+    name: "plugin-update",
+    label: "Plugin Update",
+    description: "\u5C06 phone-notifications \u63D2\u4EF6\u66F4\u65B0\u5230\u6307\u5B9A\u7248\u672C\u3002\u4EC5\u5728\u7528\u6237\u660E\u786E\u540C\u610F\u66F4\u65B0\u540E\u8C03\u7528\u3002\u66F4\u65B0\u5B8C\u6210\u540E\u9700\u91CD\u542F gateway \u751F\u6548\u3002",
+    parameters: {
+      type: "object",
+      required: ["version"],
+      additionalProperties: false,
+      properties: {
+        version: {
+          type: "string",
+          description: "\u76EE\u6807\u7248\u672C\u53F7\uFF0C\u5982 1.11.0"
+        }
+      }
+    },
+    async execute(_toolCallId, params) {
+      const { version } = params;
+      const targetDir = resolveTargetDir(api);
+      const result = await executeUpdate(
+        version,
+        api.runtime.system.runCommandWithTimeout,
+        logger,
+        targetDir,
+        (v, url) => updateConfigRecord(api, v, targetDir, url)
+      );
+      if (result.success) {
+        pendingUpdate = null;
+        externalUpdateNotifier?.clearPendingUpdate();
+      }
+      return {
+        content: [{ type: "text", text: result.message }],
+        details: result
+      };
+    }
+  });
+  api.registerGatewayMethod("plugin.update", async ({ params, respond, context }) => {
+    rememberBroadcast?.(context?.broadcast);
+    const version = params.version;
+    if (!version) {
+      respond(false, void 0, {
+        code: "MISSING_VERSION",
+        message: "version is required"
+      });
+      return;
+    }
+    const targetDir = resolveTargetDir(api);
+    const result = await executeUpdate(
+      version,
+      api.runtime.system.runCommandWithTimeout,
+      logger,
+      targetDir,
+      (v, url) => updateConfigRecord(api, v, targetDir, url)
+    );
+    if (result.success) {
+      pendingUpdate = null;
+      externalUpdateNotifier?.clearPendingUpdate();
+    }
+    if (result.success) {
+      respond(true, { message: result.message });
+    } else {
+      respond(false, void 0, {
+        code: "UPDATE_FAILED",
+        message: result.message
+      });
+    }
+  });
+  const intervalMs = (config.checkIntervalHours ?? 4) * 36e5;
+  const channel = config.channel ?? "latest";
+  logger.info(
+    `\u81EA\u52A8\u66F4\u65B0\u5DF2\u542F\u7528: channel=${channel}, checkIntervalHours=${config.checkIntervalHours ?? 4}`
+  );
+  const checker = new UpdateChecker(
+    logger,
+    (update) => {
+      pendingUpdate = update;
+      const broadcasted = tryBroadcastUpdate(update);
+      if (!broadcasted) pendingGatewayUpdate = update;
+      if (!broadcasted) {
+        externalUpdateNotifier?.notifyUpdateAvailable(update);
+      }
+      logger.info(
+        `\u5DF2\u901A\u77E5\u66F4\u65B0 ${update.current} \u2192 ${update.latest}` + (broadcasted ? "\uFF08\u5BF9\u8BDD + \u7F51\u5173\uFF09" : "\uFF08\u5BF9\u8BDD\u901A\u9053\u5DF2\u751F\u6548\uFF0C\u7B49\u5F85\u4E0B\u6B21 gateway \u8BF7\u6C42\u65F6\u8865\u53D1\u5BA2\u6237\u7AEF\u4E8B\u4EF6\uFF09")
+      );
+    },
+    intervalMs,
+    channel
+  );
+  return {
+    start: () => checker.start(),
+    stop: () => checker.stop(),
+    notifyBroadcastReady() {
+      const update = pendingGatewayUpdate;
+      if (!update) return;
+      if (!tryBroadcastUpdate(update)) return;
+      logger.info(`\u5DF2\u8865\u53D1\u63D2\u4EF6\u66F4\u65B0\u4E8B\u4EF6 ${update.current} \u2192 ${update.latest}`);
+    }
+  };
 }
-function normalizeProtocolColor(color) {
-  const normalized = {
-    r: color?.r ?? 0,
-    g: color?.g ?? 0,
-    b: color?.b ?? 0
+
+// src/plugin/auto-update.ts
+function registerAutoUpdateLifecycle(deps) {
+  const {
+    api,
+    config,
+    logger,
+    getBroadcastFn,
+    cacheBroadcast,
+    tunnelService
+  } = deps;
+  const autoUpdateConfig = {
+    ...config.autoUpdate,
+    channel: resolveUpdateChannel({
+      configuredChannel: config.autoUpdate?.channel,
+      currentVersion: PLUGIN_VERSION,
+      envName: loadEnvName()
+    })
   };
-  if (isPureWhiteProtocolColor(normalized)) {
-    return applyProtocolColorCoefficients(normalized, PURE_WHITE_COLOR_COEFFICIENTS);
-  }
-  if (countActiveProtocolColorChannels(normalized) <= 1) {
-    return normalized;
+  const autoUpdateLifecycle = registerAutoUpdate(
+    api,
+    logger,
+    autoUpdateConfig,
+    getBroadcastFn,
+    cacheBroadcast,
+    tunnelService ? {
+      notifyUpdateAvailable: (update) => tunnelService.notifyUpdateAvailable(update),
+      clearPendingUpdate: () => tunnelService.clearPendingUpdate()
+    } : void 0
+  );
+  api.registerService({
+    id: "update-checker",
+    start() {
+      autoUpdateLifecycle.start();
+    },
+    stop() {
+      autoUpdateLifecycle.stop();
+    }
+  });
+  logger.info("\u81EA\u52A8\u66F4\u65B0\u68C0\u67E5\u670D\u52A1\u5DF2\u6CE8\u518C");
+  return autoUpdateLifecycle;
+}
+
+// src/plugin/cli.ts
+var import_node_path18 = require("path");
+
+// src/cli/auth.ts
+var import_node_fs11 = require("fs");
+init_credentials();
+function registerAuthCli(program) {
+  const auth = program.command("auth").description("\u7528\u6237\u8BA4\u8BC1\u7BA1\u7406");
+  auth.command("set-api-key <apiKey>").description("\u8BBE\u7F6E\u7528\u6237 API Key\uFF08\u6301\u4E45\u5316\u5230\u672C\u5730\u914D\u7F6E\uFF09").action((apiKey) => {
+    writeCredentials({ ...readCredentials(), apiKey, token: void 0 });
+    output({
+      ok: true,
+      apiKey: apiKey.slice(0, 8) + "\u2026",
+      storedAt: credentialsPath()
+    });
+  });
+  auth.command("set-token <token>").description("\uFF08\u517C\u5BB9\uFF09\u8BBE\u7F6E\u7528\u6237 API Key\uFF08\u65E7\u547D\u4EE4\u540D\uFF09").action((token) => {
+    writeCredentials({ ...readCredentials(), apiKey: token, token: void 0 });
+    output({
+      ok: true,
+      apiKey: token.slice(0, 8) + "\u2026",
+      storedAt: credentialsPath()
+    });
+  });
+  auth.command("show").description("\u67E5\u770B\u5F53\u524D\u8BA4\u8BC1\u72B6\u6001").action(() => {
+    const creds = readCredentials();
+    const apiKey = creds.apiKey ?? creds.token;
+    if (apiKey) {
+      output({
+        ok: true,
+        hasApiKey: true,
+        apiKey: apiKey.slice(0, 8) + "\u2026",
+        storedAt: credentialsPath()
+      });
+    } else {
+      output({ ok: true, hasApiKey: false });
+    }
+  });
+  auth.command("clear").description("\u6E05\u9664\u5DF2\u4FDD\u5B58\u7684\u8BA4\u8BC1\u4FE1\u606F").action(() => {
+    const path2 = credentialsPath();
+    if ((0, import_node_fs11.existsSync)(path2)) {
+      const creds = readCredentials();
+      delete creds.apiKey;
+      delete creds.token;
+      if (Object.keys(creds).length === 0) {
+        (0, import_node_fs11.rmSync)(path2, { force: true });
+      } else {
+        writeCredentials(creds);
+      }
+    }
+    output({ ok: true, cleared: true });
+  });
+}
+
+// src/cli/ntf-search.ts
+function filterItem(item, opts) {
+  if (opts.app && item.appName !== opts.app) return false;
+  if (opts.sender && !item.title.includes(opts.sender)) return false;
+  if (opts.keyword && !item.title.includes(opts.keyword) && !item.content.includes(opts.keyword)) {
+    return false;
   }
-  return applyProtocolColorCoefficients(normalized, MULTI_CHANNEL_COLOR_COEFFICIENTS);
+  return true;
 }
-function countActiveProtocolColorChannels(color) {
-  return Number(color.r > 0) + Number(color.g > 0) + Number(color.b > 0);
+function registerNtfSearch(ntf, ctx) {
+  ntf.command("search").description("\u67E5\u8BE2\u901A\u77E5\uFF08\u6309\u65F6\u95F4/\u5E94\u7528/\u53D1\u9001\u4EBA/\u5173\u952E\u8BCD\u7B5B\u9009\uFF09").option("--from <time>", "\u5F00\u59CB\u65F6\u95F4 ISO 8601\uFF0C\u4F8B\u5982 2026-03-01T09:00:00+08:00").option("--to <time>", "\u7ED3\u675F\u65F6\u95F4 ISO 8601\uFF0C\u4F8B\u5982 2026-03-01T18:00:00+08:00").option("--app <name>", "\u6309\u5E94\u7528\u540D\u8FC7\u6EE4").option("--sender <name>", "\u6309\u53D1\u9001\u4EBA\u8FC7\u6EE4").option("--keyword <text>", "\u5728\u6807\u9898\u548C\u5185\u5BB9\u4E2D\u641C\u7D22\u5173\u952E\u8BCD").option("--limit <n>", "\u6700\u5927\u8FD4\u56DE\u6761\u6570", "100").action(
+    async (opts) => {
+      const dir = resolveNotificationsDir(ctx);
+      if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
+      progress("\u6B63\u5728\u641C\u7D22\u901A\u77E5...");
+      const limit = parseInt(opts.limit, 10) || 100;
+      if (limit <= 0) {
+        exitError("INVALID_LIMIT", "--limit \u5FC5\u987B\u662F\u5927\u4E8E 0 \u7684\u6574\u6570");
+      }
+      const hasFrom = typeof opts.from === "string" && opts.from.length > 0;
+      const hasTo = typeof opts.to === "string" && opts.to.length > 0;
+      const fromTs = hasFrom ? parseIsoTime(opts.from, "--from") : null;
+      const toTs = hasTo ? parseIsoTime(opts.to, "--to") : null;
+      if (fromTs !== null && toTs !== null && fromTs > toTs) {
+        exitError("INVALID_TIME_RANGE", "--from \u4E0D\u80FD\u665A\u4E8E --to");
+      }
+      const keys = await listDateKeysAsync(dir);
+      const results = [];
+      if (fromTs !== null || toTs !== null) {
+        const fromDateKey = hasFrom ? opts.from.slice(0, 10) : null;
+        const toDateKey = hasTo ? opts.to.slice(0, 10) : null;
+        for (const dateKey of keys) {
+          if (fromDateKey && dateKey < fromDateKey) continue;
+          if (toDateKey && dateKey > toDateKey) continue;
+          const items = await readDateFileAsync(dir, dateKey);
+          for (const item of items) {
+            if (!filterItem(item, opts)) continue;
+            const itemTs = Date.parse(item.timestamp);
+            if (Number.isNaN(itemTs)) continue;
+            if (fromTs !== null && itemTs < fromTs) continue;
+            if (toTs !== null && itemTs > toTs) continue;
+            results.push(item);
+          }
+        }
+      } else {
+        for (const dateKey of keys) {
+          const items = await readDateFileAsync(dir, dateKey);
+          for (const item of items) {
+            if (!filterItem(item, opts)) continue;
+            if (Number.isNaN(Date.parse(item.timestamp))) continue;
+            results.push(item);
+          }
+        }
+      }
+      const notifications = sortNotificationsByTimestampDesc(results).slice(
+        0,
+        limit
+      );
+      output({
+        ok: true,
+        total: notifications.length,
+        notifications
+      });
+    }
+  );
 }
-function isPureWhiteProtocolColor(color) {
-  return color.r === 255 && color.g === 255 && color.b === 255;
+
+// src/cli/ntf-stats.ts
+function registerNtfStats(ntf, ctx) {
+  ntf.command("stats").description("\u901A\u77E5\u7EDF\u8BA1\u5206\u6790\uFF08\u6309\u65E5\u671F/\u5E94\u7528/\u53D1\u9001\u4EBA/\u65F6\u6BB5\u805A\u5408\uFF09").option("--from <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD", daysAgo(7)).option("--to <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD", today()).option("--app <name>", "\u53EA\u7EDF\u8BA1\u6307\u5B9A\u5E94\u7528").option("--dim <dimension>", "\u7EDF\u8BA1\u7EF4\u5EA6\uFF1Adate/app/sender/hour/all", "all").action(
+    (opts) => {
+      const dir = resolveNotificationsDir(ctx);
+      if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
+      const dim = opts.dim;
+      const keys = filterDateRange(listDateKeys(dir), opts.from, opts.to);
+      const byDate = {};
+      const byApp = {};
+      const bySender = {};
+      const byHour = {};
+      let total = 0;
+      for (const dateKey of keys) {
+        const items = readDateFile(dir, dateKey);
+        let dateCount = 0;
+        for (const item of items) {
+          if (opts.app && item.appName !== opts.app) continue;
+          total++;
+          dateCount++;
+          byApp[item.appName] = (byApp[item.appName] || 0) + 1;
+          if (item.title) {
+            bySender[item.title] = (bySender[item.title] || 0) + 1;
+          }
+          const hourMatch = /T(\d{2}):/.exec(item.timestamp);
+          if (hourMatch) {
+            const h = hourMatch[1];
+            byHour[h] = (byHour[h] || 0) + 1;
+          }
+        }
+        byDate[dateKey] = dateCount;
+      }
+      const result = {
+        ok: true,
+        range: { from: opts.from, to: opts.to },
+        total
+      };
+      if (dim === "date" || dim === "all") {
+        result.byDate = byDate;
+      }
+      if (dim === "app" || dim === "all") {
+        result.byApp = byApp;
+      }
+      if (dim === "sender" || dim === "all") {
+        const sorted = Object.entries(bySender).sort((a, b) => b[1] - a[1]).slice(0, 20).map(([sender, count]) => ({ sender, count }));
+        result.bySender = sorted;
+      }
+      if (dim === "hour" || dim === "all") {
+        result.byHour = byHour;
+      }
+      output(result);
+    }
+  );
 }
-function applyProtocolColorCoefficients(color, coefficients) {
-  return {
-    r: scaleProtocolColorChannel(color.r, coefficients.r),
-    g: scaleProtocolColorChannel(color.g, coefficients.g),
-    b: scaleProtocolColorChannel(color.b, coefficients.b)
-  };
+
+// src/cli/ntf-sync.ts
+var import_node_fs12 = require("fs");
+var import_node_path11 = require("path");
+var SYNC_FETCH_LIMIT = 300;
+function checkpointPath(dir) {
+  return (0, import_node_path11.join)(dir, ".checkpoint.json");
 }
-function scaleProtocolColorChannel(value, coefficient) {
-  return Math.max(0, Math.min(255, Math.round(value * coefficient)));
+function readCheckpoint(dir) {
+  const p = checkpointPath(dir);
+  if (!(0, import_node_fs12.existsSync)(p)) return {};
+  try {
+    return JSON.parse((0, import_node_fs12.readFileSync)(p, "utf-8"));
+  } catch {
+    return {};
+  }
 }
-function quantize(value, steps) {
-  let bestIndex = 0;
-  let bestDistance = Number.POSITIVE_INFINITY;
-  for (const [index, step] of steps.entries()) {
-    const distance = Math.abs(value - step);
-    if (distance < bestDistance) {
-      bestIndex = index;
-      bestDistance = distance;
+function writeCheckpoint(dir, data) {
+  (0, import_node_fs12.writeFileSync)(checkpointPath(dir), JSON.stringify(data, null, 2), "utf-8");
+}
+function registerNtfSync(ntf, ctx) {
+  const sync = ntf.command("sync").description("\u540C\u6B65\u901A\u77E5\u5230\u8BB0\u5FC6\u7CFB\u7EDF");
+  sync.command("scan").description("\u626B\u63CF\u672A\u5904\u7406\u7684\u901A\u77E5\uFF0C\u8FD4\u56DE\u5F85\u540C\u6B65\u6458\u8981").action(() => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
+    const checkpoint = readCheckpoint(dir);
+    const keys = listDateKeys(dir);
+    const pending = [];
+    let totalPending = 0;
+    for (const dateKey of keys) {
+      const items = readDateFile(dir, dateKey);
+      const lastIndex = checkpoint[dateKey]?.lastIndex ?? -1;
+      const unprocessed = items.length - (lastIndex + 1);
+      if (unprocessed > 0) {
+        pending.push({
+          date: dateKey,
+          count: unprocessed,
+          startIndex: lastIndex + 1
+        });
+        totalPending += unprocessed;
+      }
+    }
+    output({ ok: true, pending, totalPending });
+  });
+  sync.command("fetch").description("\u83B7\u53D6\u6307\u5B9A\u65E5\u671F\u7684\u672A\u5904\u7406\u901A\u77E5\u8BE6\u60C5").requiredOption("--date <date>", "\u76EE\u6807\u65E5\u671F YYYY-MM-DD").action((opts) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
+    const items = readDateFile(dir, opts.date);
+    if (items.length === 0) {
+      exitError("NO_DATA", `\u65E5\u671F ${opts.date} \u65E0\u901A\u77E5\u6570\u636E`);
+    }
+    const checkpoint = readCheckpoint(dir);
+    const lastIndex = checkpoint[opts.date]?.lastIndex ?? -1;
+    const startIndex = lastIndex + 1;
+    const unprocessed = items.slice(startIndex);
+    const notifications = unprocessed.slice(0, SYNC_FETCH_LIMIT);
+    const endIndex = notifications.length > 0 ? startIndex + notifications.length - 1 : lastIndex;
+    const hasMore = unprocessed.length > notifications.length;
+    if (unprocessed.length === 0) {
+      output({
+        ok: true,
+        date: opts.date,
+        startIndex,
+        endIndex,
+        nextStartIndex: null,
+        limit: SYNC_FETCH_LIMIT,
+        returned: 0,
+        totalUnprocessed: 0,
+        hasMore: false,
+        notifications: []
+      });
+      return;
     }
-  }
-  return bestIndex;
+    output({
+      ok: true,
+      date: opts.date,
+      startIndex,
+      endIndex,
+      nextStartIndex: hasMore ? endIndex + 1 : null,
+      limit: SYNC_FETCH_LIMIT,
+      returned: notifications.length,
+      totalUnprocessed: unprocessed.length,
+      hasMore,
+      notifications
+    });
+  });
+  sync.command("commit").description("\u6807\u8BB0\u6307\u5B9A\u65E5\u671F\u5F53\u524D\u6279\u6B21\u5904\u7406\u5B8C\u6210\uFF0C\u66F4\u65B0 checkpoint").requiredOption("--date <date>", "\u76EE\u6807\u65E5\u671F YYYY-MM-DD").action((opts) => {
+    const dir = resolveNotificationsDir(ctx);
+    if (!dir) exitError("STORAGE_UNAVAILABLE", "\u901A\u77E5\u5B58\u50A8\u76EE\u5F55\u4E0D\u53EF\u7528");
+    const items = readDateFile(dir, opts.date);
+    if (items.length === 0) {
+      exitError("NO_DATA", `\u65E5\u671F ${opts.date} \u65E0\u901A\u77E5\u6570\u636E`);
+    }
+    const checkpoint = readCheckpoint(dir);
+    const lastIndex = checkpoint[opts.date]?.lastIndex ?? -1;
+    const committedIndex = Math.min(items.length - 1, lastIndex + SYNC_FETCH_LIMIT);
+    const hasMore = committedIndex < items.length - 1;
+    checkpoint[opts.date] = { lastIndex: committedIndex };
+    writeCheckpoint(dir, checkpoint);
+    output({
+      ok: true,
+      date: opts.date,
+      committedIndex,
+      limit: SYNC_FETCH_LIMIT,
+      hasMore,
+      nextStartIndex: hasMore ? committedIndex + 1 : null
+    });
+  });
 }
-function quantizeDuration(duration_s) {
-  if (duration_s === 0) return 11;
-  return quantize(duration_s, DURATION_STEPS_S);
+
+// src/cli/ntf-monitor.ts
+var import_node_fs13 = require("fs");
+var import_node_path12 = require("path");
+function tasksDir2(ctx) {
+  const base = ctx.workspaceDir || ctx.stateDir;
+  if (!base) throw new Error("workspaceDir and stateDir both unavailable");
+  return (0, import_node_path12.join)(base, "tasks");
 }
-function quantizeBrightnessValue(brightness) {
-  if (brightness === 0) return 11;
-  return quantize(brightness, BRIGHTNESS_STEPS);
+function readMeta2(taskDir) {
+  const metaPath = (0, import_node_path12.join)(taskDir, "meta.json");
+  if (!(0, import_node_fs13.existsSync)(metaPath)) return null;
+  try {
+    return JSON.parse((0, import_node_fs13.readFileSync)(metaPath, "utf-8"));
+  } catch {
+    return null;
+  }
 }
-function quantizeBreathRiseFall(value) {
-  return quantize(value ?? 1040, BREATH_STEPS_MS);
+function writeMeta2(taskDir, meta) {
+  (0, import_node_fs13.writeFileSync)((0, import_node_path12.join)(taskDir, "meta.json"), JSON.stringify(meta, null, 2), "utf-8");
 }
-function quantizeBreathHoldOff(value) {
-  if (value === 0) {
-    return 5;
-  }
-  return quantize(value ?? 1040, BREATH_STEPS_MS.slice(0, 5));
+function generateReadme(name, description) {
+  return `# Monitor Task: ${name}
+
+## \u63CF\u8FF0
+${description}
+
+## \u5904\u7406\u6307\u5357
+\u5F53 fetch.py \u8F93\u51FA\u5339\u914D\u7684\u901A\u77E5\u65F6\uFF0C\u8BF7\uFF1A
+1. \u9605\u8BFB\u5339\u914D\u5230\u7684\u901A\u77E5\u5185\u5BB9
+2. \u6839\u636E\u4EFB\u52A1\u63CF\u8FF0\u5224\u65AD\u662F\u5426\u9700\u8981\u901A\u77E5\u7528\u6237
+3. \u5982\u9700\u901A\u77E5\u7528\u6237\uFF0C\u4F7F\u7528 message \u5DE5\u5177\u53D1\u9001\u6458\u8981
+`;
 }
-function quantizeWindow(value) {
-  return value - 1;
+function registerNtfMonitor(ntf, ctx) {
+  const monitor = ntf.command("monitor").description("\u901A\u77E5\u76D1\u63A7\u4EFB\u52A1\u7BA1\u7406");
+  monitor.command("list").description("\u5217\u51FA\u6240\u6709\u76D1\u63A7\u4EFB\u52A1").action(() => {
+    const dir = tasksDir2(ctx);
+    if (!(0, import_node_fs13.existsSync)(dir)) {
+      output({ ok: true, tasks: [] });
+      return;
+    }
+    const tasks = [];
+    for (const entry of (0, import_node_fs13.readdirSync)(dir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const meta = readMeta2((0, import_node_path12.join)(dir, entry.name));
+      if (meta) tasks.push(meta);
+    }
+    output({ ok: true, tasks });
+  });
+  monitor.command("show <name>").description("\u67E5\u770B\u76D1\u63A7\u4EFB\u52A1\u8BE6\u60C5").action((name) => {
+    const taskDir = (0, import_node_path12.join)(tasksDir2(ctx), name);
+    const meta = readMeta2(taskDir);
+    if (!meta) exitError("NOT_FOUND", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u4E0D\u5B58\u5728`);
+    const checkpointPath2 = (0, import_node_path12.join)(taskDir, "checkpoint.json");
+    let checkpoint = {};
+    if ((0, import_node_fs13.existsSync)(checkpointPath2)) {
+      try {
+        checkpoint = JSON.parse((0, import_node_fs13.readFileSync)(checkpointPath2, "utf-8"));
+      } catch {
+      }
+    }
+    output({
+      ok: true,
+      ...meta,
+      matchScript: `tasks/${name}/fetch.py`,
+      readme: `tasks/${name}/README.md`,
+      checkpoint
+    });
+  });
+  monitor.command("create <name>").description("\u521B\u5EFA\u76D1\u63A7\u4EFB\u52A1").requiredOption("--description <text>", "\u4EFB\u52A1\u63CF\u8FF0").requiredOption("--match-rules <json>", "\u5339\u914D\u89C4\u5219 JSON").requiredOption("--schedule <cron>", "cron \u8868\u8FBE\u5F0F").action(
+    (name, opts) => {
+      const dir = tasksDir2(ctx);
+      const taskDir = (0, import_node_path12.join)(dir, name);
+      if ((0, import_node_fs13.existsSync)(taskDir)) {
+        exitError("ALREADY_EXISTS", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u5DF2\u5B58\u5728`);
+      }
+      let matchRules;
+      try {
+        matchRules = JSON.parse(opts.matchRules);
+      } catch {
+        exitError(
+          "VALIDATION_FAILED",
+          "match-rules \u5FC5\u987B\u662F\u5408\u6CD5\u7684 JSON"
+        );
+      }
+      (0, import_node_fs13.mkdirSync)(taskDir, { recursive: true });
+      const meta = {
+        name,
+        description: opts.description,
+        matchRules,
+        cronSchedule: opts.schedule,
+        enabled: true,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      writeMeta2(taskDir, meta);
+      (0, import_node_fs13.writeFileSync)(
+        (0, import_node_path12.join)(taskDir, "fetch.py"),
+        generateFetchPy(name, matchRules),
+        "utf-8"
+      );
+      (0, import_node_fs13.writeFileSync)(
+        (0, import_node_path12.join)(taskDir, "README.md"),
+        generateReadme(name, opts.description),
+        "utf-8"
+      );
+      output({
+        ok: true,
+        name,
+        created: {
+          script: `tasks/${name}/fetch.py`,
+          readme: `tasks/${name}/README.md`,
+          cronJob: `notif-${name}`
+        },
+        cronHint: {
+          action: "add",
+          job: {
+            name: `notif-${name}`,
+            schedule: opts.schedule,
+            sessionTarget: "isolated",
+            message: `\u624B\u673A\u901A\u77E5\u5DF2\u7531\u72EC\u7ACB\u670D\u52A1\u5B9E\u65F6\u6355\u83B7\u5230 notifications/ \u76EE\u5F55\u7684 JSON \u6587\u4EF6\u4E2D\u3002
+\u6267\u884C\uFF1Apython3 tasks/${name}/fetch.py --notifications-dir notifications
+- NO_CHANGE \u6216 NO_MATCH \u2192 \u4E0D\u56DE\u590D\uFF0C\u76F4\u63A5\u7ED3\u675F\u3002
+- \u6709\u8F93\u51FA \u2192 \u8BFB tasks/${name}/README.md \u4E86\u89E3\u5982\u4F55\u5904\u7406\u6570\u636E\u5E76\u901A\u77E5\u7528\u6237\u3002`
+          }
+        }
+      });
+    }
+  );
+  monitor.command("delete <name>").description("\u5220\u9664\u76D1\u63A7\u4EFB\u52A1").option("--yes", "\u8DF3\u8FC7\u786E\u8BA4").action((name, opts) => {
+    const taskDir = (0, import_node_path12.join)(tasksDir2(ctx), name);
+    if (!(0, import_node_fs13.existsSync)(taskDir)) {
+      exitError("NOT_FOUND", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u4E0D\u5B58\u5728`);
+    }
+    if (!opts.yes) {
+      output({
+        ok: false,
+        error: {
+          code: "CONFIRMATION_REQUIRED",
+          message: `\u786E\u8BA4\u5220\u9664\u76D1\u63A7\u4EFB\u52A1 '${name}'\uFF1F\u6DFB\u52A0 --yes \u8DF3\u8FC7\u786E\u8BA4`
+        }
+      });
+      process.exit(1);
+    }
+    (0, import_node_fs13.rmSync)(taskDir, { recursive: true, force: true });
+    output({
+      ok: true,
+      name,
+      deleted: true,
+      cronHint: {
+        action: "remove",
+        name: `notif-${name}`
+      }
+    });
+  });
+  monitor.command("enable <name>").description("\u542F\u7528\u76D1\u63A7\u4EFB\u52A1").action((name) => {
+    const taskDir = (0, import_node_path12.join)(tasksDir2(ctx), name);
+    const meta = readMeta2(taskDir);
+    if (!meta) exitError("NOT_FOUND", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u4E0D\u5B58\u5728`);
+    meta.enabled = true;
+    writeMeta2(taskDir, meta);
+    output({ ok: true, name, enabled: true });
+  });
+  monitor.command("disable <name>").description("\u6682\u505C\u76D1\u63A7\u4EFB\u52A1").action((name) => {
+    const taskDir = (0, import_node_path12.join)(tasksDir2(ctx), name);
+    const meta = readMeta2(taskDir);
+    if (!meta) exitError("NOT_FOUND", `\u76D1\u63A7\u4EFB\u52A1 '${name}' \u4E0D\u5B58\u5728`);
+    meta.enabled = false;
+    writeMeta2(taskDir, meta);
+    output({ ok: true, name, enabled: false });
+  });
 }
 
+// src/cli/light-send.ts
+init_credentials();
+
 // src/light/sender.ts
+var import_node_crypto2 = require("crypto");
 init_env();
 async function sendLightEffect(apiKey, segments, logger, repeatInput, reason) {
   const apiUrl = getEnvUrls().lightApiUrl;
@@ -8327,9 +8578,9 @@ function registerLightSend(light) {
 }
 
 // src/cli/light-setup-tools.ts
-var import_node_fs13 = require("fs");
+var import_node_fs14 = require("fs");
 var import_node_os2 = require("os");
-var import_node_path12 = require("path");
+var import_node_path13 = require("path");
 function isObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -8343,13 +8594,25 @@ function ensureArray(obj, key) {
 function resolveConfigPath2() {
   const fromEnv = process.env.OPENCLAW_CONFIG_PATH?.trim();
   if (fromEnv) return fromEnv;
-  return (0, import_node_path12.join)((0, import_node_os2.homedir)(), ".openclaw", "openclaw.json");
-}
+  return (0, import_node_path13.join)((0, import_node_os2.homedir)(), ".openclaw", "openclaw.json");
+}
+var LIGHT_TOOLS = [
+  "light_control",
+  "lightrules.list",
+  "lightrules.create",
+  "lightrules.update",
+  "lightrules.delete"
+];
 function upsertLightControlAlsoAllow(cfg) {
   if (!isObject(cfg.tools)) cfg.tools = {};
   const toolsAlsoAllow = ensureArray(cfg.tools, "alsoAllow");
-  const hasGlobal = toolsAlsoAllow.includes("light_control");
-  if (!hasGlobal) toolsAlsoAllow.push("light_control");
+  let globalChanged = false;
+  for (const tool of LIGHT_TOOLS) {
+    if (!toolsAlsoAllow.includes(tool)) {
+      toolsAlsoAllow.push(tool);
+      globalChanged = true;
+    }
+  }
   if (!isObject(cfg.agents)) cfg.agents = {};
   const agents = cfg.agents;
   const list = ensureArray(agents, "list");
@@ -8362,33 +8625,35 @@ function upsertLightControlAlsoAllow(cfg) {
   }
   if (!isObject(mainAgent.tools)) mainAgent.tools = {};
   const mainAlsoAllow = ensureArray(mainAgent.tools, "alsoAllow");
-  const hasMain = mainAlsoAllow.includes("light_control");
-  if (!hasMain) mainAlsoAllow.push("light_control");
-  return {
-    globalChanged: !hasGlobal,
-    mainAgentChanged: !hasMain
-  };
+  let mainAgentChanged = false;
+  for (const tool of LIGHT_TOOLS) {
+    if (!mainAlsoAllow.includes(tool)) {
+      mainAlsoAllow.push(tool);
+      mainAgentChanged = true;
+    }
+  }
+  return { globalChanged, mainAgentChanged };
 }
 function registerLightSetupTools(light) {
   light.command("setup").description("\u81EA\u52A8\u653E\u884C light_control\uFF08\u5199\u5165 tools.alsoAllow \u4E0E agents.main.tools.alsoAllow\uFF09").action(() => {
     const configPath = resolveConfigPath2();
-    if (!(0, import_node_fs13.existsSync)(configPath)) {
+    if (!(0, import_node_fs14.existsSync)(configPath)) {
       exitError("CONFIG_NOT_FOUND", `\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6: ${configPath}`);
     }
     let cfg = {};
     try {
-      const raw = (0, import_node_fs13.readFileSync)(configPath, "utf-8");
+      const raw = (0, import_node_fs14.readFileSync)(configPath, "utf-8");
       const parsed = JSON.parse(raw);
       if (isObject(parsed)) cfg = parsed;
-    } catch (err) {
-      exitError("CONFIG_INVALID", `\u8BFB\u53D6/\u89E3\u6790\u914D\u7F6E\u5931\u8D25: ${err?.message ?? String(err)}`);
+    } catch (err2) {
+      exitError("CONFIG_INVALID", `\u8BFB\u53D6/\u89E3\u6790\u914D\u7F6E\u5931\u8D25: ${err2?.message ?? String(err2)}`);
     }
     const result = upsertLightControlAlsoAllow(cfg);
     try {
-      (0, import_node_fs13.mkdirSync)((0, import_node_path12.dirname)(configPath), { recursive: true });
-      (0, import_node_fs13.writeFileSync)(configPath, JSON.stringify(cfg, null, 2) + "\n", "utf-8");
-    } catch (err) {
-      exitError("WRITE_FAILED", `\u5199\u5165\u914D\u7F6E\u5931\u8D25: ${err?.message ?? String(err)}`);
+      (0, import_node_fs14.mkdirSync)((0, import_node_path13.dirname)(configPath), { recursive: true });
+      (0, import_node_fs14.writeFileSync)(configPath, JSON.stringify(cfg, null, 2) + "\n", "utf-8");
+    } catch (err2) {
+      exitError("WRITE_FAILED", `\u5199\u5165\u914D\u7F6E\u5931\u8D25: ${err2?.message ?? String(err2)}`);
     }
     output({
       ok: true,
@@ -8404,17 +8669,17 @@ function registerLightSetupTools(light) {
 }
 
 // src/cli/tunnel-status.ts
-var import_node_fs14 = require("fs");
-var import_node_path13 = require("path");
+var import_node_fs15 = require("fs");
+var import_node_path14 = require("path");
 init_credentials();
 init_env();
-var STATUS_REL_PATH = (0, import_node_path13.join)("plugins", "phone-notifications", "tunnel-status.json");
+var STATUS_REL_PATH = (0, import_node_path14.join)("plugins", "phone-notifications", "tunnel-status.json");
 function readTunnelStatus(ctx) {
   if (!ctx.stateDir) return null;
-  const filePath = (0, import_node_path13.join)(ctx.stateDir, STATUS_REL_PATH);
-  if (!(0, import_node_fs14.existsSync)(filePath)) return null;
+  const filePath = (0, import_node_path14.join)(ctx.stateDir, STATUS_REL_PATH);
+  if (!(0, import_node_fs15.existsSync)(filePath)) return null;
   try {
-    return JSON.parse((0, import_node_fs14.readFileSync)(filePath, "utf-8"));
+    return JSON.parse((0, import_node_fs15.readFileSync)(filePath, "utf-8"));
   } catch {
     return null;
   }
@@ -8456,9 +8721,9 @@ function registerTunnelStatus(ntf, ctx) {
         "\u672A\u627E\u5230\u96A7\u9053\u72B6\u6001\u6587\u4EF6\uFF0C\u96A7\u9053\u670D\u52A1\u53EF\u80FD\u5C1A\u672A\u542F\u52A8\u8FC7\u3002\u8BF7\u786E\u8BA4 openclaw \u4E3B\u8FDB\u7A0B\u6B63\u5728\u8FD0\u884C\u3002"
       );
     }
-    const ok = status.state === "connected";
+    const ok2 = status.state === "connected";
     output({
-      ok,
+      ok: ok2,
       tunnelUrl,
       connection: {
         state: status.state,
@@ -8468,7 +8733,7 @@ function registerTunnelStatus(ntf, ctx) {
       },
       message: formatMessage(status)
     });
-    if (!ok) process.exit(1);
+    if (!ok2) process.exit(1);
   });
 }
 
@@ -8482,24 +8747,24 @@ function registerNtfStoragePath(ntf, ctx) {
 }
 
 // src/cli/log-search.ts
-var import_node_fs15 = require("fs");
-var import_node_path14 = require("path");
+var import_node_fs16 = require("fs");
+var import_node_path15 = require("path");
 function resolveLogsDir(ctx) {
   if (ctx.stateDir) {
-    const dir = (0, import_node_path14.join)(
+    const dir = (0, import_node_path15.join)(
       ctx.stateDir,
       "plugins",
       "phone-notifications",
       "logs"
     );
-    if ((0, import_node_fs15.existsSync)(dir)) return dir;
+    if ((0, import_node_fs16.existsSync)(dir)) return dir;
   }
   return null;
 }
 function listLogDateKeys(dir) {
   const pattern = /^(\d{4}-\d{2}-\d{2})\.log$/;
   const keys = [];
-  for (const entry of (0, import_node_fs15.readdirSync)(dir, { withFileTypes: true })) {
+  for (const entry of (0, import_node_fs16.readdirSync)(dir, { withFileTypes: true })) {
     if (!entry.isFile()) continue;
     const m = pattern.exec(entry.name);
     if (m) keys.push(m[1]);
@@ -8507,9 +8772,9 @@ function listLogDateKeys(dir) {
   return keys.sort().reverse();
 }
 function collectLogLines(dir, dateKey, keyword, limit, collected) {
-  const filePath = (0, import_node_path14.join)(dir, `${dateKey}.log`);
-  if (!(0, import_node_fs15.existsSync)(filePath)) return;
-  const content = (0, import_node_fs15.readFileSync)(filePath, "utf-8");
+  const filePath = (0, import_node_path15.join)(dir, `${dateKey}.log`);
+  if (!(0, import_node_fs16.existsSync)(filePath)) return;
+  const content = (0, import_node_fs16.readFileSync)(filePath, "utf-8");
   const lowerKeyword = keyword?.toLowerCase();
   for (const line of content.split("\n")) {
     if (collected.length >= limit) return;
@@ -8576,12 +8841,12 @@ function registerEnvCli(ntf) {
 }
 
 // src/cli/doctor.ts
-var import_node_fs19 = require("fs");
+var import_node_fs20 = require("fs");
 var import_node_readline = require("readline");
 init_host();
 
 // src/cli/doctor/check-dangerous-flags.ts
-var import_node_fs16 = require("fs");
+var import_node_fs17 = require("fs");
 function isObject2(v) {
   return !!v && typeof v === "object" && !Array.isArray(v);
 }
@@ -8598,13 +8863,13 @@ var checkDangerousFlags = ({ cfg, configPath }) => {
     detail: "\u8FD9\u4F1A\u5173\u95ED Control UI \u7684\u8BBE\u5907\u8EAB\u4EFD\u9A8C\u8BC1\uFF0C\u4EFB\u4F55\u4EBA\u90FD\u53EF\u4EE5\u8BBF\u95EE\u63A7\u5236\u9762\u677F\u3002",
     fixDescription: "\u8BBE\u4E3A false",
     fix: () => {
-      const raw = (0, import_node_fs16.readFileSync)(configPath, "utf-8");
+      const raw = (0, import_node_fs17.readFileSync)(configPath, "utf-8");
       const config = JSON.parse(raw);
       const gw = config.gateway;
       const cui = gw.controlUi;
       cui.dangerouslyDisableDeviceAuth = false;
-      (0, import_node_fs16.copyFileSync)(configPath, configPath + ".bak");
-      (0, import_node_fs16.writeFileSync)(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+      (0, import_node_fs17.copyFileSync)(configPath, configPath + ".bak");
+      (0, import_node_fs17.writeFileSync)(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
     }
   };
 };
@@ -8652,11 +8917,11 @@ function warnEmpty() {
 }
 
 // src/cli/doctor/check-state-dir-perms.ts
-var import_node_fs17 = require("fs");
+var import_node_fs18 = require("fs");
 var checkStateDirPerms = ({ stateDir }) => {
   let mode;
   try {
-    mode = (0, import_node_fs17.statSync)(stateDir).mode;
+    mode = (0, import_node_fs18.statSync)(stateDir).mode;
   } catch {
     return null;
   }
@@ -8670,7 +8935,7 @@ var checkStateDirPerms = ({ stateDir }) => {
     detail: "\u5176\u4ED6\u7528\u6237\u53EF\u4EE5\u8BFB\u53D6\u8BE5\u76EE\u5F55\u4E0B\u7684\u51ED\u8BC1\u548C\u914D\u7F6E\u6587\u4EF6\u3002",
     fixDescription: "chmod 700 " + stateDir,
     fix: () => {
-      (0, import_node_fs17.chmodSync)(stateDir, 448);
+      (0, import_node_fs18.chmodSync)(stateDir, 448);
     }
   };
 };
@@ -8725,16 +8990,16 @@ var checkCredentials = () => {
 };
 
 // src/cli/doctor/check-tunnel.ts
-var import_node_fs18 = require("fs");
-var import_node_path15 = require("path");
-var STATUS_REL_PATH2 = (0, import_node_path15.join)(
+var import_node_fs19 = require("fs");
+var import_node_path16 = require("path");
+var STATUS_REL_PATH2 = (0, import_node_path16.join)(
   "plugins",
   "phone-notifications",
   "tunnel-status.json"
 );
 var checkTunnel = ({ stateDir }) => {
-  const filePath = (0, import_node_path15.join)(stateDir, STATUS_REL_PATH2);
-  if (!(0, import_node_fs18.existsSync)(filePath)) {
+  const filePath = (0, import_node_path16.join)(stateDir, STATUS_REL_PATH2);
+  if (!(0, import_node_fs19.existsSync)(filePath)) {
     return {
       id: "tunnel",
       severity: "warn",
@@ -8746,7 +9011,7 @@ var checkTunnel = ({ stateDir }) => {
   }
   let status;
   try {
-    status = JSON.parse((0, import_node_fs18.readFileSync)(filePath, "utf-8"));
+    status = JSON.parse((0, import_node_fs19.readFileSync)(filePath, "utf-8"));
   } catch {
     return {
       id: "tunnel",
@@ -8839,9 +9104,9 @@ function isObject5(v) {
   return !!v && typeof v === "object" && !Array.isArray(v);
 }
 function readConfig(configPath) {
-  if (!(0, import_node_fs19.existsSync)(configPath)) return {};
+  if (!(0, import_node_fs20.existsSync)(configPath)) return {};
   try {
-    const parsed = JSON.parse((0, import_node_fs19.readFileSync)(configPath, "utf-8"));
+    const parsed = JSON.parse((0, import_node_fs20.readFileSync)(configPath, "utf-8"));
     return isObject5(parsed) ? parsed : {};
   } catch {
     return {};
@@ -8950,9 +9215,9 @@ async function runDoctor(ctx, json, fix) {
       await issue.fix();
       log(`\x1B[32m\u2705\x1B[0m ${issue.title} \u2192 ${issue.fixDescription}`);
       fixed++;
-    } catch (err) {
+    } catch (err2) {
       log(
-        `\x1B[31m\u274C\x1B[0m ${issue.title} \u4FEE\u590D\u5931\u8D25: ${err?.message ?? String(err)}`
+        `\x1B[31m\u274C\x1B[0m ${issue.title} \u4FEE\u590D\u5931\u8D25: ${err2?.message ?? String(err2)}`
       );
     }
   }
@@ -9042,7 +9307,7 @@ function registerRecStoragePath(rec, ctx) {
 
 // src/cli/rec-setup.ts
 var import_node_readline2 = require("readline");
-var import_node_fs20 = require("fs");
+var import_node_fs21 = require("fs");
 function ask(rl, question) {
   return new Promise((resolve) => rl.question(question, resolve));
 }
@@ -9128,9 +9393,9 @@ async function setupLocal(rl) {
 function registerRecSetup(rec, ctx) {
   rec.command("setup").description("\u4EA4\u4E92\u5F0F\u914D\u7F6E ASR \u8F6C\u5199\u53C2\u6570\uFF0C\u4FDD\u5B58\u5230\u672C\u5730\u914D\u7F6E\u6587\u4EF6").action(async () => {
     const configPath = resolveAsrConfigPath(ctx);
-    if ((0, import_node_fs20.existsSync)(configPath)) {
+    if ((0, import_node_fs21.existsSync)(configPath)) {
       try {
-        const existing = JSON.parse((0, import_node_fs20.readFileSync)(configPath, "utf-8"));
+        const existing = JSON.parse((0, import_node_fs21.readFileSync)(configPath, "utf-8"));
         process.stderr.write(`\u5F53\u524D\u5DF2\u6709\u914D\u7F6E\uFF1Amode = ${existing.mode}`);
         if (existing.updatedAt) process.stderr.write(`\uFF0C\u66F4\u65B0\u4E8E ${existing.updatedAt}`);
         process.stderr.write("\n");
@@ -9143,7 +9408,7 @@ function registerRecSetup(rec, ctx) {
       const modeIdx = await askChoice(rl, "\u9009\u62E9\u6A21\u5F0F", ["api\uFF08\u4E91\u7AEF model-proxy \u957F\u5F55\u97F3\uFF09", "local\uFF08\u672C\u5730 Whisper\uFF09"]);
       const config = modeIdx === 0 ? await setupApi(rl) : await setupLocal(rl);
       const stored = { ...config, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
-      (0, import_node_fs20.writeFileSync)(configPath, JSON.stringify(stored, null, 2), "utf-8");
+      (0, import_node_fs21.writeFileSync)(configPath, JSON.stringify(stored, null, 2), "utf-8");
       process.stderr.write(`
 \u2713 \u914D\u7F6E\u5DF2\u4FDD\u5B58\u5230 ${configPath}
 
@@ -9157,8 +9422,8 @@ function registerRecSetup(rec, ctx) {
 
 // src/cli/update.ts
 var import_node_child_process = require("child_process");
-var import_node_fs21 = require("fs");
-var import_node_path16 = require("path");
+var import_node_fs22 = require("fs");
+var import_node_path17 = require("path");
 var import_node_os3 = __toESM(require("os"), 1);
 init_host();
 var BASE_URL2 = "https://artifact.yoooclaw.com/plugin";
@@ -9182,8 +9447,8 @@ async function runUpdate(ctx, opts) {
   let latest;
   try {
     latest = (await fetchText(`${BASE_URL2}/${channel}`)).trim();
-  } catch (err) {
-    const msg = `\u65E0\u6CD5\u83B7\u53D6\u6700\u65B0\u7248\u672C: ${err?.message ?? String(err)}`;
+  } catch (err2) {
+    const msg = `\u65E0\u6CD5\u83B7\u53D6\u6700\u65B0\u7248\u672C: ${err2?.message ?? String(err2)}`;
     if (json) {
       output({ ok: false, error: { code: "FETCH_FAILED", message: msg } });
       process.exit(1);
@@ -9207,8 +9472,8 @@ async function runUpdate(ctx, opts) {
   let installScript;
   try {
     installScript = await fetchText(`${BASE_URL2}/install-core.mjs`);
-  } catch (err) {
-    const msg = `\u4E0B\u8F7D\u5B89\u88C5\u811A\u672C\u5931\u8D25: ${err?.message ?? String(err)}`;
+  } catch (err2) {
+    const msg = `\u4E0B\u8F7D\u5B89\u88C5\u811A\u672C\u5931\u8D25: ${err2?.message ?? String(err2)}`;
     if (json) {
       output({ ok: false, error: { code: "DOWNLOAD_FAILED", message: msg } });
       process.exit(1);
@@ -9217,11 +9482,11 @@ async function runUpdate(ctx, opts) {
 `);
     process.exit(1);
   }
-  const tmpScript = (0, import_node_path16.join)(import_node_os3.default.tmpdir(), `openclaw-install-${Date.now()}.mjs`);
+  const tmpScript = (0, import_node_path17.join)(import_node_os3.default.tmpdir(), `openclaw-install-${Date.now()}.mjs`);
   try {
-    (0, import_node_fs21.writeFileSync)(tmpScript, installScript, "utf-8");
-  } catch (err) {
-    const msg = `\u5199\u5165\u4E34\u65F6\u6587\u4EF6\u5931\u8D25: ${err?.message ?? String(err)}`;
+    (0, import_node_fs22.writeFileSync)(tmpScript, installScript, "utf-8");
+  } catch (err2) {
+    const msg = `\u5199\u5165\u4E34\u65F6\u6587\u4EF6\u5931\u8D25: ${err2?.message ?? String(err2)}`;
     if (json) {
       output({ ok: false, error: { code: "WRITE_FAILED", message: msg } });
       process.exit(1);
@@ -9237,7 +9502,7 @@ async function runUpdate(ctx, opts) {
     { stdio: "inherit" }
   );
   try {
-    (0, import_node_fs21.unlinkSync)(tmpScript);
+    (0, import_node_fs22.unlinkSync)(tmpScript);
   } catch {
   }
   if (result.error) {
@@ -9301,10 +9566,10 @@ function inferOpenClawRootDir(workspaceDir) {
   if (!workspaceDir) {
     return void 0;
   }
-  if ((0, import_node_path17.basename)(workspaceDir) !== "workspace") {
+  if ((0, import_node_path18.basename)(workspaceDir) !== "workspace") {
     return void 0;
   }
-  return (0, import_node_path17.dirname)(workspaceDir);
+  return (0, import_node_path18.dirname)(workspaceDir);
 }
 function registerPluginCli(api, params) {
   const { logger, openclawDir } = params;
@@ -9550,12 +9815,12 @@ function registerLightControlTool(api, logger) {
 }
 
 // src/plugin/lifecycle.ts
-var import_node_fs30 = require("fs");
+var import_node_fs31 = require("fs");
 init_host();
 
 // src/notification/app-name-map.ts
-var import_node_fs22 = require("fs");
-var import_node_path18 = require("path");
+var import_node_fs23 = require("fs");
+var import_node_path19 = require("path");
 init_credentials();
 init_env();
 var PLUGIN_STATE_DIR = "phone-notifications";
@@ -9576,7 +9841,7 @@ function isAppNameMapApiResponse(v) {
   );
 }
 function getCachePath(stateDir) {
-  return (0, import_node_path18.join)(stateDir, "plugins", PLUGIN_STATE_DIR, CACHE_FILE);
+  return (0, import_node_path19.join)(stateDir, "plugins", PLUGIN_STATE_DIR, CACHE_FILE);
 }
 function createAppNameMapProvider(opts) {
   const { stateDir, logger } = opts;
@@ -9588,9 +9853,9 @@ function createAppNameMapProvider(opts) {
   let inFlightFetch = null;
   function loadFromDisk() {
     const path2 = getCachePath(stateDir);
-    if (!(0, import_node_fs22.existsSync)(path2)) return;
+    if (!(0, import_node_fs23.existsSync)(path2)) return;
     try {
-      const raw = JSON.parse((0, import_node_fs22.readFileSync)(path2, "utf-8"));
+      const raw = JSON.parse((0, import_node_fs23.readFileSync)(path2, "utf-8"));
       if (!isRecordOfStrings(raw)) return;
       map.clear();
       for (const [k, v] of Object.entries(raw)) map.set(k, v);
@@ -9634,10 +9899,10 @@ function createAppNameMapProvider(opts) {
         logger.warn("[app-name-map] refresh succeeded but got 0 entries");
         return;
       }
-      const dir = (0, import_node_path18.join)(stateDir, "plugins", PLUGIN_STATE_DIR);
-      (0, import_node_fs22.mkdirSync)(dir, { recursive: true });
+      const dir = (0, import_node_path19.join)(stateDir, "plugins", PLUGIN_STATE_DIR);
+      (0, import_node_fs23.mkdirSync)(dir, { recursive: true });
       const cachePath = getCachePath(stateDir);
-      (0, import_node_fs22.writeFileSync)(cachePath, JSON.stringify(Object.fromEntries(map), null, 2), "utf-8");
+      (0, import_node_fs23.writeFileSync)(cachePath, JSON.stringify(Object.fromEntries(map), null, 2), "utf-8");
       logger.info(`[app-name-map] refreshed ${map.size} entries from server and saved: ${cachePath}`);
     } catch (e) {
       const message = e instanceof Error ? e.message : String(e);
@@ -9681,8 +9946,8 @@ function createAppNameMapProvider(opts) {
 }
 
 // src/recording/storage.ts
-var import_node_fs23 = require("fs");
-var import_node_path19 = require("path");
+var import_node_fs24 = require("fs");
+var import_node_path20 = require("path");
 
 // src/recording/state-machine.ts
 var VALID_TRANSITIONS = /* @__PURE__ */ new Map([
@@ -9743,7 +10008,7 @@ function stripMarkdownFence(markdown) {
 }
 function deriveTitleFromTranscriptPath(transcriptFile, recordingId) {
   if (!transcriptFile) return void 0;
-  const name = (0, import_node_path19.basename)(transcriptFile, ".md");
+  const name = (0, import_node_path20.basename)(transcriptFile, ".md");
   const prefix = `${recordingId}_`;
   if (name.startsWith(prefix)) {
     const derived = name.slice(prefix.length).trim();
@@ -9771,22 +10036,22 @@ function extractTranscriptContent(markdown) {
   return lines.join("\n").replace(/\n{3,}/g, "\n\n").trim();
 }
 function resolveRecordingStorageDir(ctx, logger) {
-  const stateRecDir = (0, import_node_path19.join)(
+  const stateRecDir = (0, import_node_path20.join)(
     ctx.stateDir,
     "plugins",
     "phone-notifications",
     RECORDINGS_DIR
   );
   try {
-    (0, import_node_fs23.mkdirSync)(stateRecDir, { recursive: true });
+    (0, import_node_fs24.mkdirSync)(stateRecDir, { recursive: true });
     logger.info(`\u5F55\u97F3\u5C06\u5199\u5165 stateDir \u8DEF\u5F84: ${stateRecDir}`);
     return stateRecDir;
   } catch {
   }
   if (ctx.workspaceDir) {
-    const wsRecDir = (0, import_node_path19.join)(ctx.workspaceDir, RECORDINGS_DIR);
+    const wsRecDir = (0, import_node_path20.join)(ctx.workspaceDir, RECORDINGS_DIR);
     try {
-      (0, import_node_fs23.mkdirSync)(wsRecDir, { recursive: true });
+      (0, import_node_fs24.mkdirSync)(wsRecDir, { recursive: true });
       logger.warn(`stateDir \u4E0D\u53EF\u7528\uFF0C\u5F55\u97F3\u5DF2\u56DE\u9000\u5230 workspace \u8DEF\u5F84: ${wsRecDir}`);
       return wsRecDir;
     } catch {
@@ -9798,11 +10063,11 @@ var RecordingStorage = class {
   constructor(dir, logger) {
     this.logger = logger;
     this.dir = dir;
-    this.audioDir = (0, import_node_path19.join)(dir, AUDIO_DIR);
-    this.transcriptDataDir = (0, import_node_path19.join)(dir, TRANSCRIPT_DATA_DIR);
-    this.transcriptsDir = (0, import_node_path19.join)(dir, TRANSCRIPTS_DIR);
-    this.summariesDir = (0, import_node_path19.join)(dir, SUMMARIES_DIR);
-    this.indexPath = (0, import_node_path19.join)(dir, INDEX_FILE);
+    this.audioDir = (0, import_node_path20.join)(dir, AUDIO_DIR);
+    this.transcriptDataDir = (0, import_node_path20.join)(dir, TRANSCRIPT_DATA_DIR);
+    this.transcriptsDir = (0, import_node_path20.join)(dir, TRANSCRIPTS_DIR);
+    this.summariesDir = (0, import_node_path20.join)(dir, SUMMARIES_DIR);
+    this.indexPath = (0, import_node_path20.join)(dir, INDEX_FILE);
   }
   dir;
   audioDir;
@@ -9813,10 +10078,10 @@ var RecordingStorage = class {
   index = { recordings: [] };
   /** 初始化目录结构并加载索引 */
   async init() {
-    (0, import_node_fs23.mkdirSync)(this.audioDir, { recursive: true });
-    (0, import_node_fs23.mkdirSync)(this.transcriptDataDir, { recursive: true });
-    (0, import_node_fs23.mkdirSync)(this.transcriptsDir, { recursive: true });
-    (0, import_node_fs23.mkdirSync)(this.summariesDir, { recursive: true });
+    (0, import_node_fs24.mkdirSync)(this.audioDir, { recursive: true });
+    (0, import_node_fs24.mkdirSync)(this.transcriptDataDir, { recursive: true });
+    (0, import_node_fs24.mkdirSync)(this.transcriptsDir, { recursive: true });
+    (0, import_node_fs24.mkdirSync)(this.summariesDir, { recursive: true });
     this.loadIndex();
     this.logger.info(
       `\u5F55\u97F3\u5B58\u50A8\u5DF2\u521D\u59CB\u5316: ${this.dir}\uFF08\u5171 ${this.index.recordings.length} \u6761\u8BB0\u5F55\uFF09`
@@ -9860,13 +10125,13 @@ var RecordingStorage = class {
         return id;
       }
       if (existing.transcriptDataFile) {
-        (0, import_node_fs23.rmSync)((0, import_node_path19.join)(this.dir, existing.transcriptDataFile), { force: true });
+        (0, import_node_fs24.rmSync)((0, import_node_path20.join)(this.dir, existing.transcriptDataFile), { force: true });
       }
       if (existing.transcriptFile) {
-        (0, import_node_fs23.rmSync)((0, import_node_path19.join)(this.dir, existing.transcriptFile), { force: true });
+        (0, import_node_fs24.rmSync)((0, import_node_path20.join)(this.dir, existing.transcriptFile), { force: true });
       }
       if (existing.summaryFile) {
-        (0, import_node_fs23.rmSync)((0, import_node_path19.join)(this.dir, existing.summaryFile), { force: true });
+        (0, import_node_fs24.rmSync)((0, import_node_path20.join)(this.dir, existing.summaryFile), { force: true });
       }
       existing.metadata = metadata;
       existing.status = "syncing_openclaw";
@@ -9934,7 +10199,7 @@ var RecordingStorage = class {
     if (!entry) return;
     const nextTranscriptDataFile = `${TRANSCRIPT_DATA_DIR}/${filename}`;
     if (entry.transcriptDataFile && entry.transcriptDataFile !== nextTranscriptDataFile) {
-      (0, import_node_fs23.rmSync)((0, import_node_path19.join)(this.dir, entry.transcriptDataFile), { force: true });
+      (0, import_node_fs24.rmSync)((0, import_node_path20.join)(this.dir, entry.transcriptDataFile), { force: true });
     }
     entry.transcriptDataFile = nextTranscriptDataFile;
     entry.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -9948,7 +10213,7 @@ var RecordingStorage = class {
     if (!entry) return;
     const nextTranscriptFile = `${TRANSCRIPTS_DIR}/${filename}`;
     if (entry.transcriptFile && entry.transcriptFile !== nextTranscriptFile) {
-      (0, import_node_fs23.rmSync)((0, import_node_path19.join)(this.dir, entry.transcriptFile), { force: true });
+      (0, import_node_fs24.rmSync)((0, import_node_path20.join)(this.dir, entry.transcriptFile), { force: true });
     }
     entry.transcriptFile = nextTranscriptFile;
     entry.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -9962,7 +10227,7 @@ var RecordingStorage = class {
     if (!entry) return;
     const nextSummaryFile = `${SUMMARIES_DIR}/${filename}`;
     if (entry.summaryFile && entry.summaryFile !== nextSummaryFile) {
-      (0, import_node_fs23.rmSync)((0, import_node_path19.join)(this.dir, entry.summaryFile), { force: true });
+      (0, import_node_fs24.rmSync)((0, import_node_path20.join)(this.dir, entry.summaryFile), { force: true });
     }
     entry.summaryFile = nextSummaryFile;
     entry.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -10060,24 +10325,24 @@ var RecordingStorage = class {
     const entry = this.findById(recordingId);
     if (!entry) return false;
     if (entry.audioFile) {
-      const audioPath = (0, import_node_path19.join)(this.dir, entry.audioFile);
-      (0, import_node_fs23.rmSync)(audioPath, { force: true });
+      const audioPath = (0, import_node_path20.join)(this.dir, entry.audioFile);
+      (0, import_node_fs24.rmSync)(audioPath, { force: true });
     }
     if (entry.srtFile) {
-      const srtPath = (0, import_node_path19.join)(this.dir, entry.srtFile);
-      (0, import_node_fs23.rmSync)(srtPath, { force: true });
+      const srtPath = (0, import_node_path20.join)(this.dir, entry.srtFile);
+      (0, import_node_fs24.rmSync)(srtPath, { force: true });
     }
     if (entry.transcriptDataFile) {
-      const transcriptDataPath = (0, import_node_path19.join)(this.dir, entry.transcriptDataFile);
-      (0, import_node_fs23.rmSync)(transcriptDataPath, { force: true });
+      const transcriptDataPath = (0, import_node_path20.join)(this.dir, entry.transcriptDataFile);
+      (0, import_node_fs24.rmSync)(transcriptDataPath, { force: true });
     }
     if (entry.transcriptFile) {
-      const transcriptPath = (0, import_node_path19.join)(this.dir, entry.transcriptFile);
-      (0, import_node_fs23.rmSync)(transcriptPath, { force: true });
+      const transcriptPath = (0, import_node_path20.join)(this.dir, entry.transcriptFile);
+      (0, import_node_fs24.rmSync)(transcriptPath, { force: true });
     }
     if (entry.summaryFile) {
-      const summaryPath = (0, import_node_path19.join)(this.dir, entry.summaryFile);
-      (0, import_node_fs23.rmSync)(summaryPath, { force: true });
+      const summaryPath = (0, import_node_path20.join)(this.dir, entry.summaryFile);
+      (0, import_node_fs24.rmSync)(summaryPath, { force: true });
     }
     if (opts?.localOnly) {
       entry.audioFile = void 0;
@@ -10135,34 +10400,34 @@ var RecordingStorage = class {
    * 获取音频文件的绝对路径。ossUrl 用于推断文件扩展名
    */
   getAudioFilePath(recordingId, ossUrl) {
-    return (0, import_node_path19.join)(this.audioDir, this.buildAudioFilename(recordingId, ossUrl));
+    return (0, import_node_path20.join)(this.audioDir, this.buildAudioFilename(recordingId, ossUrl));
   }
   /**
    * 获取打点文件的绝对路径
    */
   getSrtFilePath(recordingId) {
-    return (0, import_node_path19.join)(this.audioDir, this.buildSrtFilename(recordingId));
+    return (0, import_node_path20.join)(this.audioDir, this.buildSrtFilename(recordingId));
   }
   /**
    * 获取转写 JSON 文件的绝对路径
    */
   getTranscriptDataFilePath(recordingId) {
-    return (0, import_node_path19.join)(this.transcriptDataDir, this.buildTranscriptDataFilename(recordingId));
+    return (0, import_node_path20.join)(this.transcriptDataDir, this.buildTranscriptDataFilename(recordingId));
   }
   /**
    * 获取摘要文件的绝对路径
    */
   getSummaryFilePath(recordingId) {
-    return (0, import_node_path19.join)(this.summariesDir, this.buildSummaryFilename(recordingId));
+    return (0, import_node_path20.join)(this.summariesDir, this.buildSummaryFilename(recordingId));
   }
   // ─── Persistence ───
   loadIndex() {
-    if (!(0, import_node_fs23.existsSync)(this.indexPath)) {
+    if (!(0, import_node_fs24.existsSync)(this.indexPath)) {
       this.index = { recordings: [] };
       return;
     }
     try {
-      const raw = JSON.parse((0, import_node_fs23.readFileSync)(this.indexPath, "utf-8"));
+      const raw = JSON.parse((0, import_node_fs24.readFileSync)(this.indexPath, "utf-8"));
       if (raw && Array.isArray(raw.recordings)) {
         let needsRewrite = false;
         const normalized = raw.recordings.filter((entry) => entry && typeof entry === "object").map((entry) => {
@@ -10200,8 +10465,8 @@ var RecordingStorage = class {
                 segments: []
               });
               const transcriptDataFilename = this.buildTranscriptDataFilename(compacted.id);
-              (0, import_node_fs23.writeFileSync)(
-                (0, import_node_path19.join)(this.transcriptDataDir, transcriptDataFilename),
+              (0, import_node_fs24.writeFileSync)(
+                (0, import_node_path20.join)(this.transcriptDataDir, transcriptDataFilename),
                 JSON.stringify(transcriptDoc, null, 2),
                 "utf-8"
               );
@@ -10213,8 +10478,8 @@ var RecordingStorage = class {
             compacted.summaryFile = entry.summaryFile;
           } else if (typeof entry.summary === "string" && entry.summary.trim()) {
             const summaryFilename = this.buildSummaryFilename(entry.id);
-            (0, import_node_fs23.writeFileSync)(
-              (0, import_node_path19.join)(this.summariesDir, summaryFilename),
+            (0, import_node_fs24.writeFileSync)(
+              (0, import_node_path20.join)(this.summariesDir, summaryFilename),
               entry.summary.trim(),
               "utf-8"
             );
@@ -10224,8 +10489,8 @@ var RecordingStorage = class {
             const summaryFromDocument = extractTranscriptSummaryFromDocument(transcriptDoc);
             if (summaryFromDocument) {
               const summaryFilename = this.buildSummaryFilename(entry.id);
-              (0, import_node_fs23.writeFileSync)(
-                (0, import_node_path19.join)(this.summariesDir, summaryFilename),
+              (0, import_node_fs24.writeFileSync)(
+                (0, import_node_path20.join)(this.summariesDir, summaryFilename),
                 summaryFromDocument,
                 "utf-8"
               );
@@ -10265,7 +10530,7 @@ var RecordingStorage = class {
   }
   readRelativeTextFile(relativePath) {
     try {
-      return (0, import_node_fs23.readFileSync)((0, import_node_path19.join)(this.dir, relativePath), "utf-8");
+      return (0, import_node_fs24.readFileSync)((0, import_node_path20.join)(this.dir, relativePath), "utf-8");
     } catch {
       return void 0;
     }
@@ -10278,7 +10543,7 @@ var RecordingStorage = class {
     return parseTranscriptDocument(raw);
   }
   saveIndex() {
-    (0, import_node_fs23.writeFileSync)(
+    (0, import_node_fs24.writeFileSync)(
       this.indexPath,
       JSON.stringify(this.index, null, 2),
       "utf-8"
@@ -10292,8 +10557,8 @@ var RecordingStorage = class {
 init_transcript_document();
 
 // src/recording/downloader.ts
-var import_node_fs24 = require("fs");
-var import_node_path20 = require("path");
+var import_node_fs25 = require("fs");
+var import_node_path21 = require("path");
 var import_promises2 = require("stream/promises");
 var import_node_stream = require("stream");
 var DEFAULT_TIMEOUT_MS = 5 * 60 * 1e3;
@@ -10303,7 +10568,7 @@ async function downloadFile(url, destPath, logger, options) {
   const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   const maxRetries = options?.maxRetries ?? DEFAULT_MAX_RETRIES;
   const retryBackoffMs = options?.retryBackoffMs ?? DEFAULT_RETRY_BACKOFF_MS;
-  (0, import_node_fs24.mkdirSync)((0, import_node_path20.dirname)(destPath), { recursive: true });
+  (0, import_node_fs25.mkdirSync)((0, import_node_path21.dirname)(destPath), { recursive: true });
   let lastError;
   for (let attempt = 1; attempt <= maxRetries; attempt++) {
     const startMs = Date.now();
@@ -10321,11 +10586,11 @@ async function downloadFile(url, destPath, logger, options) {
         if (!res.body) {
           throw new Error("\u54CD\u5E94\u4F53\u4E3A\u7A7A");
         }
-        const writeStream = (0, import_node_fs24.createWriteStream)(destPath);
+        const writeStream = (0, import_node_fs25.createWriteStream)(destPath);
         const readable = import_node_stream.Readable.fromWeb(res.body);
         await (0, import_promises2.pipeline)(readable, writeStream);
         const elapsed = Date.now() - startMs;
-        const fileSize = (0, import_node_fs24.existsSync)(destPath) ? (0, import_node_fs24.statSync)(destPath).size : 0;
+        const fileSize = (0, import_node_fs25.existsSync)(destPath) ? (0, import_node_fs25.statSync)(destPath).size : 0;
         logger.info(
           `[downloader] \u4E0B\u8F7D\u5B8C\u6210: ${destPath} (${formatBytes(fileSize)}, ${elapsed}ms)`
         );
@@ -10333,13 +10598,13 @@ async function downloadFile(url, destPath, logger, options) {
       } finally {
         clearTimeout(timer);
       }
-    } catch (err) {
-      lastError = err?.message ?? String(err);
+    } catch (err2) {
+      lastError = err2?.message ?? String(err2);
       try {
-        if ((0, import_node_fs24.existsSync)(destPath)) (0, import_node_fs24.unlinkSync)(destPath);
+        if ((0, import_node_fs25.existsSync)(destPath)) (0, import_node_fs25.unlinkSync)(destPath);
       } catch {
       }
-      const isAbort = err?.name === "AbortError";
+      const isAbort = err2?.name === "AbortError";
       logger.warn(
         `[downloader] \u4E0B\u8F7D\u5931\u8D25 (attempt ${attempt}/${maxRetries}): ${isAbort ? "\u8D85\u65F6" : lastError}`
       );
@@ -10401,9 +10666,9 @@ function emitRecordingStatus(recordingId, storage, logger, notifyStatus, error,
       updatedAt: entry.updatedAt,
       error
     });
-  } catch (err) {
+  } catch (err2) {
     logger.error(
-      `[recording-status] \u72B6\u6001\u4E8B\u4EF6\u53D1\u9001\u5931\u8D25: ${recordingId}, ${err?.message ?? err}`
+      `[recording-status] \u72B6\u6001\u4E8B\u4EF6\u53D1\u9001\u5931\u8D25: ${recordingId}, ${err2?.message ?? err2}`
     );
   }
 }
@@ -10467,8 +10732,8 @@ async function handleRecordingSync(recordingId, metadata, storage, asrConfig, lo
       asrConfig,
       logger,
       options
-    ).catch((err) => {
-      const error = `\u5F55\u97F3\u540C\u6B65\u5931\u8D25: ${err?.message ?? err}`;
+    ).catch((err2) => {
+      const error = `\u5F55\u97F3\u540C\u6B65\u5931\u8D25: ${err2?.message ?? err2}`;
       logger.error(`[recording-sync] ${error}: ${recordingId}`);
       emitRecordingStatus(
         recordingId,
@@ -10491,9 +10756,9 @@ async function handleRecordingSync(recordingId, metadata, storage, asrConfig, lo
         asrConfig,
         logger,
         options
-      ).catch((err) => {
+      ).catch((err2) => {
         logger.error(
-          `[asr-trigger] \u8F6C\u5199\u89E6\u53D1\u5931\u8D25: ${recordingId}, ${err?.message ?? err}`
+          `[asr-trigger] \u8F6C\u5199\u89E6\u53D1\u5931\u8D25: ${recordingId}, ${err2?.message ?? err2}`
         );
       });
     }
@@ -10574,13 +10839,13 @@ async function triggerTranscription(recordingId, storage, asrConfig, logger, opt
 }
 
 // src/tunnel/service.ts
-var import_node_fs29 = require("fs");
-var import_node_path25 = require("path");
+var import_node_fs30 = require("fs");
+var import_node_path26 = require("path");
 init_credentials();
 
 // src/tunnel/relay-client.ts
-var import_node_fs27 = require("fs");
-var import_node_path23 = require("path");
+var import_node_fs28 = require("fs");
+var import_node_path24 = require("path");
 
 // node_modules/.pnpm/ws@8.19.0/node_modules/ws/wrapper.mjs
 var import_stream = __toESM(require_stream(), 1);
@@ -10624,8 +10889,8 @@ var RelayClient = class {
       lastDisconnectReason
     };
     try {
-      (0, import_node_fs27.mkdirSync)((0, import_node_path23.dirname)(this.opts.statusFilePath), { recursive: true });
-      (0, import_node_fs27.writeFileSync)(this.opts.statusFilePath, JSON.stringify(info, null, 2));
+      (0, import_node_fs28.mkdirSync)((0, import_node_path24.dirname)(this.opts.statusFilePath), { recursive: true });
+      (0, import_node_fs28.writeFileSync)(this.opts.statusFilePath, JSON.stringify(info, null, 2));
     } catch {
     }
   }
@@ -10829,9 +11094,9 @@ var RelayClient = class {
         }
         settle();
       });
-      ws.on("error", (err) => {
+      ws.on("error", (err2) => {
         this.opts.logger.error(
-          `Relay tunnel: WebSocket error: ${err.message} (readyState=${ws.readyState}, reconnectAttempt=${this.reconnectAttempt}, url=${wsUrl.toString()})`
+          `Relay tunnel: WebSocket error: ${err2.message} (readyState=${ws.readyState}, reconnectAttempt=${this.reconnectAttempt}, url=${wsUrl.toString()})`
         );
         settle();
       });
@@ -10839,9 +11104,9 @@ var RelayClient = class {
   }
   emitConnected() {
     for (const handler of this.connectedHandlers) {
-      Promise.resolve(handler()).catch((err) => {
+      Promise.resolve(handler()).catch((err2) => {
         this.opts.logger.warn(
-          `Relay tunnel: onConnected handler failed: ${err instanceof Error ? err.message : String(err)}`
+          `Relay tunnel: onConnected handler failed: ${err2 instanceof Error ? err2.message : String(err2)}`
         );
       });
     }
@@ -10869,12 +11134,12 @@ var RelayClient = class {
       try {
         const result = handler(frame);
         if (result instanceof Promise) {
-          result.catch((err) => {
-            this.opts.logger.error(`Relay tunnel: handler error: ${err}`);
+          result.catch((err2) => {
+            this.opts.logger.error(`Relay tunnel: handler error: ${err2}`);
           });
         }
-      } catch (err) {
-        this.opts.logger.error(`Relay tunnel: handler error: ${err}`);
+      } catch (err2) {
+        this.opts.logger.error(`Relay tunnel: handler error: ${err2}`);
       }
     }
   }
@@ -10963,8 +11228,8 @@ var RelayClient = class {
     this.reconnectTimer = setTimeout(() => {
       this.reconnectTimer = null;
       if (!this.aborted) {
-        this.connect().catch((err) => {
-          this.opts.logger.error(`Relay tunnel: reconnect failed: ${err}`);
+        this.connect().catch((err2) => {
+          this.opts.logger.error(`Relay tunnel: reconnect failed: ${err2}`);
         });
       }
     }, delayMs);
@@ -11007,8 +11272,8 @@ init_host();
 
 // src/tunnel/device-identity.ts
 var import_node_crypto3 = __toESM(require("crypto"), 1);
-var import_node_fs28 = __toESM(require("fs"), 1);
-var import_node_path24 = __toESM(require("path"), 1);
+var import_node_fs29 = __toESM(require("fs"), 1);
+var import_node_path25 = __toESM(require("path"), 1);
 init_host();
 var ED25519_SPKI_PREFIX = Buffer.from("302a300506032b6570032100", "hex");
 function base64UrlEncode(buf) {
@@ -11053,10 +11318,10 @@ function resolveClientStateDir(stateDir) {
   return stateDir ?? resolveStateDir();
 }
 function ensureDir(filePath) {
-  import_node_fs28.default.mkdirSync(import_node_path24.default.dirname(filePath), { recursive: true });
+  import_node_fs29.default.mkdirSync(import_node_path25.default.dirname(filePath), { recursive: true });
 }
 function resolveIdentityPath(stateDir) {
-  return import_node_path24.default.join(stateDir, "identity", "device.json");
+  return import_node_path25.default.join(stateDir, "identity", "device.json");
 }
 function normalizeDeviceAuthRole(role) {
   return role.trim();
@@ -11072,12 +11337,12 @@ function normalizeDeviceAuthScopes(scopes) {
   return [...out].sort();
 }
 function resolveDeviceAuthPath(stateDir) {
-  return import_node_path24.default.join(stateDir, "identity", "device-auth.json");
+  return import_node_path25.default.join(stateDir, "identity", "device-auth.json");
 }
 function readDeviceAuthStore(filePath) {
   try {
-    if (!import_node_fs28.default.existsSync(filePath)) return null;
-    const raw = import_node_fs28.default.readFileSync(filePath, "utf8");
+    if (!import_node_fs29.default.existsSync(filePath)) return null;
+    const raw = import_node_fs29.default.readFileSync(filePath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed?.version !== 1 || typeof parsed.deviceId !== "string") return null;
     if (!parsed.tokens || typeof parsed.tokens !== "object") return null;
@@ -11088,12 +11353,12 @@ function readDeviceAuthStore(filePath) {
 }
 function writeDeviceAuthStore(filePath, store) {
   ensureDir(filePath);
-  import_node_fs28.default.writeFileSync(filePath, `${JSON.stringify(store, null, 2)}
+  import_node_fs29.default.writeFileSync(filePath, `${JSON.stringify(store, null, 2)}
 `, {
     mode: 384
   });
   try {
-    import_node_fs28.default.chmodSync(filePath, 384);
+    import_node_fs29.default.chmodSync(filePath, 384);
   } catch {
   }
 }
@@ -11140,8 +11405,8 @@ function clearDeviceAuthToken(params) {
 function loadOrCreateDeviceIdentity(stateDir) {
   const filePath = resolveIdentityPath(stateDir);
   try {
-    if (import_node_fs28.default.existsSync(filePath)) {
-      const raw = import_node_fs28.default.readFileSync(filePath, "utf8");
+    if (import_node_fs29.default.existsSync(filePath)) {
+      const raw = import_node_fs29.default.readFileSync(filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed?.version === 1 && typeof parsed.deviceId === "string" && typeof parsed.publicKeyPem === "string" && typeof parsed.privateKeyPem === "string") {
         const derivedId = fingerprintPublicKey(parsed.publicKeyPem);
@@ -11162,14 +11427,14 @@ function loadOrCreateDeviceIdentity(stateDir) {
     publicKeyPem,
     privateKeyPem
   };
-  import_node_fs28.default.mkdirSync(import_node_path24.default.dirname(filePath), { recursive: true });
+  import_node_fs29.default.mkdirSync(import_node_path25.default.dirname(filePath), { recursive: true });
   const stored = {
     version: 1,
     ...identity,
     createdAtMs: Date.now()
   };
   ensureDir(filePath);
-  import_node_fs28.default.writeFileSync(filePath, `${JSON.stringify(stored, null, 2)}
+  import_node_fs29.default.writeFileSync(filePath, `${JSON.stringify(stored, null, 2)}
 `, {
     mode: 384
   });
@@ -11272,8 +11537,8 @@ async function handleHttpRequest(opts, frame) {
       });
       return;
     }
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
+  } catch (err2) {
+    const message = err2 instanceof Error ? err2.message : String(err2);
     opts.logger.error(
       `TunnelProxy: HTTP id=${frame.id} ${frame.method} ${mappedPath} failed after ${Date.now() - startedAtMs}ms: ${message}`
     );
@@ -11343,15 +11608,15 @@ async function streamResponse(opts, requestId, res, startedAtMs) {
       state: "end",
       data: ""
     });
-  } catch (err) {
+  } catch (err2) {
     opts.logger.error(
-      `TunnelProxy: stream error id=${requestId} after ${chunkCount} chunks and ${Date.now() - startedAtMs}ms: ${err instanceof Error ? err.message : String(err)}`
+      `TunnelProxy: stream error id=${requestId} after ${chunkCount} chunks and ${Date.now() - startedAtMs}ms: ${err2 instanceof Error ? err2.message : String(err2)}`
     );
     opts.client.send({
       type: "proxy_error",
       id: requestId,
       status: 502,
-      message: `stream error: ${err instanceof Error ? err.message : String(err)}`
+      message: `stream error: ${err2 instanceof Error ? err2.message : String(err2)}`
     });
   }
 }
@@ -11418,27 +11683,27 @@ var WsProxy = class {
           reason: reason.toString()
         });
       });
-      ws.on("error", (err) => {
+      ws.on("error", (err2) => {
         this.opts.logger.warn(
-          `TunnelProxy: WS id=${frame.id} error: ${err.message}, active=${this.connections.size}`
+          `TunnelProxy: WS id=${frame.id} error: ${err2.message}, active=${this.connections.size}`
         );
         this.connections.delete(frame.id);
         this.opts.client.send({
           type: "ws_close",
           id: frame.id,
           code: 1011,
-          reason: err.message
+          reason: err2.message
         });
       });
-    } catch (err) {
+    } catch (err2) {
       this.opts.logger.error(
-        `TunnelProxy: WS id=${frame.id} failed to connect: ${err instanceof Error ? err.message : String(err)}`
+        `TunnelProxy: WS id=${frame.id} failed to connect: ${err2 instanceof Error ? err2.message : String(err2)}`
       );
       this.opts.client.send({
         type: "ws_close",
         id: frame.id,
         code: 1011,
-        reason: `failed to connect: ${err instanceof Error ? err.message : String(err)}`
+        reason: `failed to connect: ${err2 instanceof Error ? err2.message : String(err2)}`
       });
     }
   }
@@ -11478,19 +11743,19 @@ var WsProxy = class {
 var MAX_AUTO_PAIRING_APPROVALS = 3;
 var approveDevicePairingPromise = null;
 var approveDevicePairingWarned = false;
-function formatErrorMessage(err) {
-  if (err instanceof Error && err.message) return err.message;
-  return String(err);
+function formatErrorMessage(err2) {
+  if (err2 instanceof Error && err2.message) return err2.message;
+  return String(err2);
 }
 async function loadApproveDevicePairing(logger) {
   if (!approveDevicePairingPromise) {
     approveDevicePairingPromise = import("openclaw/plugin-sdk/device-bootstrap").then(
       (mod) => typeof mod.approveDevicePairing === "function" ? mod.approveDevicePairing : null
-    ).catch((err) => {
+    ).catch((err2) => {
       if (!approveDevicePairingWarned) {
         approveDevicePairingWarned = true;
         logger.warn(
-          `TunnelProxy: local gateway auto-pairing disabled because current OpenClaw runtime does not expose device bootstrap SDK (${formatErrorMessage(err)})`
+          `TunnelProxy: local gateway auto-pairing disabled because current OpenClaw runtime does not expose device bootstrap SDK (${formatErrorMessage(err2)})`
         );
       }
       return null;
@@ -11715,9 +11980,9 @@ var TunnelProxy = class {
         `TunnelProxy: auto-approved local gateway pairing request ${requestId} (reason=${reason || "not-paired"}, hostStateDir=${this.hostStateDir}, approval=${this.gatewayWsAutoPairingApprovals}/${MAX_AUTO_PAIRING_APPROVALS})`
       );
       return true;
-    } catch (err) {
+    } catch (err2) {
       this.opts.logger.warn(
-        `TunnelProxy: failed to auto-approve gateway pairing request ${requestId}: ${err?.message ?? String(err)}`
+        `TunnelProxy: failed to auto-approve gateway pairing request ${requestId}: ${err2?.message ?? String(err2)}`
       );
       return false;
     }
@@ -11831,9 +12096,9 @@ var TunnelProxy = class {
         queueMicrotask(() => this.ensureGatewayWs());
       }
     });
-    ws.on("error", (err) => {
+    ws.on("error", (err2) => {
       this.opts.logger.warn(
-        `TunnelProxy: RPC WS error: ${err.message} (ready=${this.gatewayWsReady}, pending=${this.gatewayWsPending.length}, activeWs=${this.wsProxy.activeCount})`
+        `TunnelProxy: RPC WS error: ${err2.message} (ready=${this.gatewayWsReady}, pending=${this.gatewayWsPending.length}, activeWs=${this.wsProxy.activeCount})`
       );
       this.gatewayWsConnecting = false;
       if (this.gatewayWs === ws) {
@@ -11933,13 +12198,13 @@ function createTunnelService(opts) {
     try {
       process.kill(pid, 0);
       return true;
-    } catch (err) {
-      return err?.code === "EPERM";
+    } catch (err2) {
+      return err2?.code === "EPERM";
     }
   }
   function readLockOwner(filePath) {
     try {
-      const parsed = JSON.parse((0, import_node_fs29.readFileSync)(filePath, "utf-8"));
+      const parsed = JSON.parse((0, import_node_fs30.readFileSync)(filePath, "utf-8"));
       return typeof parsed.pid === "number" ? parsed.pid : null;
     } catch {
       return null;
@@ -11952,23 +12217,23 @@ function createTunnelService(opts) {
     lockFd = null;
     if (fd !== null) {
       try {
-        (0, import_node_fs29.closeSync)(fd);
+        (0, import_node_fs30.closeSync)(fd);
       } catch {
       }
     }
     if (filePath) {
       try {
-        (0, import_node_fs29.unlinkSync)(filePath);
+        (0, import_node_fs30.unlinkSync)(filePath);
       } catch {
       }
     }
   }
   function acquireLock(filePath) {
-    (0, import_node_fs29.mkdirSync)((0, import_node_path25.dirname)(filePath), { recursive: true });
+    (0, import_node_fs30.mkdirSync)((0, import_node_path26.dirname)(filePath), { recursive: true });
     for (let attempt = 0; attempt < 2; attempt++) {
       try {
-        const fd = (0, import_node_fs29.openSync)(filePath, "wx", 384);
-        (0, import_node_fs29.writeFileSync)(
+        const fd = (0, import_node_fs30.openSync)(filePath, "wx", 384);
+        (0, import_node_fs30.writeFileSync)(
           fd,
           JSON.stringify({
             pid: process.pid,
@@ -11979,10 +12244,10 @@ function createTunnelService(opts) {
         lockFilePath = filePath;
         lockFd = fd;
         return true;
-      } catch (err) {
-        if (err?.code !== "EEXIST") {
+      } catch (err2) {
+        if (err2?.code !== "EEXIST") {
           opts.logger.error(
-            `Relay tunnel: failed to acquire local lock ${filePath}: ${String(err)}`
+            `Relay tunnel: failed to acquire local lock ${filePath}: ${String(err2)}`
           );
           return false;
         }
@@ -11992,7 +12257,7 @@ function createTunnelService(opts) {
             `Relay tunnel: removing stale local lock owned by dead pid=${ownerPid}`
           );
           try {
-            (0, import_node_fs29.unlinkSync)(filePath);
+            (0, import_node_fs30.unlinkSync)(filePath);
           } catch {
           }
           continue;
@@ -12037,12 +12302,12 @@ function createTunnelService(opts) {
         return;
       }
       const { logger } = opts;
-      const baseStateDir = (0, import_node_path25.join)(ctx.stateDir, "plugins", "phone-notifications");
+      const baseStateDir = (0, import_node_path26.join)(ctx.stateDir, "plugins", "phone-notifications");
       logger.info(
         `Relay tunnel: starting (pid=${process.pid}, url=${opts.tunnelUrl}, heartbeat=${opts.heartbeatSec ?? DEFAULT_HEARTBEAT_SEC}s, backoff=${opts.reconnectBackoffMs ?? DEFAULT_RECONNECT_BACKOFF_MS}ms, gateway=${opts.gatewayBaseUrl}, hasGatewayToken=${!!opts.gatewayToken}, hasGatewayPwd=${!!opts.gatewayPassword})`
       );
-      const statusFilePath = (0, import_node_path25.join)(baseStateDir, "tunnel-status.json");
-      const lockPath = (0, import_node_path25.join)(baseStateDir, "relay-tunnel.lock");
+      const statusFilePath = (0, import_node_path26.join)(baseStateDir, "tunnel-status.json");
+      const lockPath = (0, import_node_path26.join)(baseStateDir, "relay-tunnel.lock");
       if (!acquireLock(lockPath)) {
         return;
       }
@@ -12070,14 +12335,14 @@ function createTunnelService(opts) {
           emitPendingPluginUpdate("relay connected");
         });
         abortController = new AbortController();
-        client.connectWithAutoReconnect(abortController.signal).catch((err) => {
+        client.connectWithAutoReconnect(abortController.signal).catch((err2) => {
           releaseLock();
-          logger.error(`Relay tunnel: unexpected error: ${err}`);
+          logger.error(`Relay tunnel: unexpected error: ${err2}`);
         });
         logger.info("Relay tunnel \u670D\u52A1\u5DF2\u542F\u52A8");
-      } catch (err) {
+      } catch (err2) {
         releaseLock();
-        throw err;
+        throw err2;
       }
     },
     async stop() {
@@ -12182,9 +12447,9 @@ function readHostGatewayConfig(params) {
   let configData;
   if (configPath) {
     try {
-      configData = JSON.parse((0, import_node_fs30.readFileSync)(configPath, "utf-8"));
-    } catch (err) {
-      if (err?.code !== "ENOENT") {
+      configData = JSON.parse((0, import_node_fs31.readFileSync)(configPath, "utf-8"));
+    } catch (err2) {
+      if (err2?.code !== "ENOENT") {
         params.logger.warn(
           `Relay tunnel: \u65E0\u6CD5\u8BFB\u53D6 gateway \u9274\u6743\u914D\u7F6E (${configPath})`
         );
@@ -12294,7 +12559,7 @@ function registerNotificationInterfaces(deps) {
   } = deps;
   function triggerAfterIngest(insertedCount, cron) {
     if (insertedCount <= 0 || !onAfterIngest) return;
-    void Promise.resolve().then(() => onAfterIngest(insertedCount, cron)).catch((err) => logger.warn(`onAfterIngest failed: ${err?.message ?? err}`));
+    void Promise.resolve().then(() => onAfterIngest(insertedCount, cron)).catch((err2) => logger.warn(`onAfterIngest failed: ${err2?.message ?? err2}`));
   }
   registerGatewayMethod(
     "notifications.push",
@@ -12687,9 +12952,9 @@ function registerRecordingInterfaces(deps) {
       }
       triggerTranscription(recordingId, recordingStorage, asr, logger, {
         notifyStatus: notifyRecordingStatus
-      }).catch((err) => {
+      }).catch((err2) => {
         logger.error(
-          `[recordings.retranscribe] \u91CD\u8BD5\u8F6C\u5199\u5931\u8D25: ${recordingId}, ${err?.message ?? err}`
+          `[recordings.retranscribe] \u91CD\u8BD5\u8F6C\u5199\u5931\u8D25: ${recordingId}, ${err2?.message ?? err2}`
         );
       });
       respond(true, { ok: true, recordingId, message: "\u8F6C\u5199\u5DF2\u91CD\u65B0\u89E6\u53D1" });
@@ -12935,8 +13200,9 @@ var index_default = {
       tunnelService
     });
     registerLightRulesGateway(api, lightRuleRegistry, logger, cacheBroadcast);
+    registerLightRulesTools(api, lightRuleRegistry, logger);
     logger.info(
-      "Gateway \u706F\u6548\u89C4\u5219\u65B9\u6CD5\u5DF2\u6CE8\u518C: lightrules.list / lightrules.create / lightrules.update / lightrules.delete"
+      "\u706F\u6548\u89C4\u5219\u65B9\u6CD5\u5DF2\u6CE8\u518C: lightrules.list / lightrules.create / lightrules.update / lightrules.delete"
     );
     autoUpdateLifecycle = registerAutoUpdateLifecycle({
       api,