larkway 0.3.55 → 0.3.57

package/README.md

@@ -8,7 +8,7 @@
 
 You @ the bot in a Feishu thread. It runs on your machine — reading your real codebase, executing commands, opening MRs — and posts the result back. You define what the agent knows and what it can do. Larkway just carries the messages.
 
-**Current release: v0.3.55**
+**Current release: v0.3.57**
 
 ---
 

package/README.zh.md

@@ -8,7 +8,7 @@
 
 你在飞书话题里 @ bot，它在你的机器上运行——读真实代码库、执行命令、开 MR——把结果贴回飞书。你定义 agent 知道什么、能做什么。Larkway 只负责传递消息。
 
-**当前版本：v0.3.55**
+**当前版本：v0.3.57**
 
 ---
 

package/dist/cli/index.js

@@ -10515,12 +10515,12 @@ var require_form_data = __commonJS({
         if (value.end != void 0 && value.end != Infinity && value.start != void 0) {
           callback(null, value.end + 1 - (value.start ? value.start : 0));
         } else {
-          fs8.stat(value.path, function(err2, stat6) {
+          fs8.stat(value.path, function(err2, stat7) {
             if (err2) {
               callback(err2);
               return;
             }
-            var fileSize = stat6.size - (value.start ? value.start : 0);
+            var fileSize = stat7.size - (value.start ? value.start : 0);
             callback(null, fileSize);
           });
         }
@@ -108202,6 +108202,7 @@ __export(channelClient_exports, {
   ChannelClient: () => ChannelClient,
   DEFAULT_OPEN_CHAT_DISCOVERY_MS: () => DEFAULT_OPEN_CHAT_DISCOVERY_MS,
   channelMsgToLarkEvent: () => channelMsgToLarkEvent,
+  isBotSentMessage: () => isBotSentMessage,
   resolveOpenChatDiscoveryMs: () => resolveOpenChatDiscoveryMs,
   resolveRecoveredThreadId: () => resolveRecoveredThreadId,
   synthesizeCardActionEvent: () => synthesizeCardActionEvent
@@ -108210,6 +108211,17 @@ import { execFile as execFileCallback } from "node:child_process";
 import { mkdir as mkdir3, readFile as readFile5, writeFile as writeFile4, rename as rename3, unlink as unlink4 } from "node:fs/promises";
 import path9 from "node:path";
 import { promisify as promisify4 } from "node:util";
+function isChatAccessGoneError(e) {
+  const parts = [];
+  if (e instanceof Error) parts.push(e.message);
+  if (e && typeof e === "object") {
+    for (const key of ["stderr", "stdout"]) {
+      const v = e[key];
+      if (typeof v === "string") parts.push(v);
+    }
+  }
+  return parts.some((s) => s.includes("230002"));
+}
 function stripAtMarkup(s) {
   return s.replace(/<at\b[^>]*>.*?<\/at>/gi, "").replace(/<at\b[^>]*\/>/gi, "").trim();
 }
@@ -108297,6 +108309,16 @@ function resolveRecoveredThreadId(m) {
   }
   return null;
 }
+function isBotSentMessage(m, botOpenId) {
+  const sender = m["sender"];
+  if (typeof sender === "string") return sender === botOpenId;
+  if (sender && typeof sender === "object") {
+    const s = sender;
+    if (s["sender_type"] === "app") return true;
+    if (typeof s["id"] === "string" && s["id"] === botOpenId) return true;
+  }
+  return false;
+}
 function cardActionChoice(value) {
   if (value && typeof value === "object") {
     const choice = value["larkway_choice"];
@@ -108348,7 +108370,7 @@ function channelMsgToLarkEvent(msg, fallbackChatType) {
     create_time: m?.["create_time"] ?? String(msg.createTime ?? Date.now())
   };
 }
-var import_node_sdk, execFile4, LEARNED_CHATS_LIMIT, SEEN_MESSAGES_LIMIT, MAX_MESSAGE_ATTEMPTS, OPEN_CHAT_DISCOVERY_LOOKBACK_BUFFER_MS, OPEN_CHAT_DISCOVERY_BOOTSTRAP_LOOKBACK_MS, PROCESSING_REACTION_EMOJI, DEFAULT_OPEN_CHAT_DISCOVERY_MS, OPEN_CHAT_DISCOVERY_JITTER_CAP_MS, OPEN_CHAT_DISCOVERY_MAX_BACKOFF_CYCLES, GAP_FILL_MAX_ATTEMPTS, GAP_FILL_BACKOFF_BASE_MS, UNRESOLVED_WINDOW_MAX_CHATS, UNRESOLVED_WINDOW_MAX_AGE_MS, DEFAULT_CONNECT_GRACE_MS, ChannelClient;
+var import_node_sdk, execFile4, LEARNED_CHATS_LIMIT, SEEN_MESSAGES_LIMIT, MAX_MESSAGE_ATTEMPTS, OPEN_CHAT_DISCOVERY_LOOKBACK_BUFFER_MS, OPEN_CHAT_DISCOVERY_BOOTSTRAP_LOOKBACK_MS, PROCESSING_REACTION_EMOJI, DEFAULT_OPEN_CHAT_DISCOVERY_MS, OPEN_CHAT_DISCOVERY_JITTER_CAP_MS, OPEN_CHAT_DISCOVERY_MAX_BACKOFF_CYCLES, GAP_FILL_MAX_ATTEMPTS, GAP_FILL_BACKOFF_BASE_MS, UNRESOLVED_WINDOW_MAX_CHATS, UNRESOLVED_WINDOW_MAX_AGE_MS, CHAT_ACCESS_GONE_UNTRACK_AFTER, DEFAULT_CONNECT_GRACE_MS, ChannelClient;
 var init_channelClient = __esm({
   "src/lark/channelClient.ts"() {
     "use strict";
@@ -108373,6 +108395,7 @@ var init_channelClient = __esm({
     GAP_FILL_BACKOFF_BASE_MS = 1e3;
     UNRESOLVED_WINDOW_MAX_CHATS = 50;
     UNRESOLVED_WINDOW_MAX_AGE_MS = 30 * 60 * 1e3;
+    CHAT_ACCESS_GONE_UNTRACK_AFTER = 3;
     DEFAULT_CONNECT_GRACE_MS = 3e3;
     ChannelClient = class {
       opts;
@@ -108471,6 +108494,16 @@ var init_channelClient = __esm({
        * capped at UNRESOLVED_WINDOW_MAX_CHATS tracked chats.
        */
       unresolvedGapWindowByChat = /* @__PURE__ */ new Map();
+      /**
+       * chatId → count of CONSECUTIVE gap-fill cycles whose pull failed with
+       * 230002 (bot removed from the chat). At {@link CHAT_ACCESS_GONE_UNTRACK_AFTER}
+       * the chat is dropped from gap-fill tracking entirely (see
+       * {@link noteChatAccessGone}) — the fix for the 2026-07-17 amplifier where a
+       * stale chat's unresolved window was replayed (3 retries each) every cycle,
+       * forever, burning quota against a deterministic error. Reset by any
+       * successful pull of the chat or any live sighting (noteSeenChat).
+       */
+      chatAccessGoneCountByChat = /* @__PURE__ */ new Map();
       /**
        * Backoff sleep used by the per-chat history-pull retry. Indirected through a
        * field purely so tests can observe/await the backoff deterministically; in
@@ -108558,6 +108591,44 @@ var init_channelClient = __esm({
       unresolvedGapWindowsForTest() {
         return new Map(this.unresolvedGapWindowByChat);
       }
+      /** TEST-ONLY read of the tracked (gap-fillable) chat id set. */
+      trackedChatIdsForTest() {
+        return new Set(this.recentlySeenChatIds);
+      }
+      /**
+       * Seed gap-fill's tracked-chat set from durable session history
+       * (sessions.json), BEFORE connect. Fix for the 2026-07-17 p2p message-loss
+       * incident: p2p chats are invisible to bot-side chat-list discovery (the API
+       * returns groups only), so once the in-memory tracking state was gone —
+       * restart plus a missing/stale runtime cache — a p2p chat could never
+       * re-enter the gap-fill list and its messages dropped during a WS outage
+       * were lost forever. sessions.json persists the chatId (and, going forward,
+       * chatType) of every thread the bot has served, so seeding from it makes a
+       * p2p chat permanently gap-fillable once it has ever been seen.
+       *
+       * Deliberately does NOT persist to the runtime channel-seen-chats cache:
+       * this runs before {@link loadRecentlySeenChatIds} merges the cache in, and
+       * persisting the (possibly smaller) seed set here would overwrite cached
+       * chats learned in previous runs. The union is persisted by the next
+       * ordinary noteSeenChat.
+       */
+      seedTrackedChats(entries) {
+        let added = 0;
+        for (const { chatId, chatType } of entries) {
+          if (!chatId.startsWith("oc_")) continue;
+          const before = this.recentlySeenChatIds.size;
+          this.recentlySeenChatIds.add(chatId);
+          if (this.recentlySeenChatIds.size > before) added++;
+          if (chatType && !this.chatTypesById.has(chatId)) {
+            this.chatTypesById.set(chatId, chatType);
+          }
+        }
+        if (added > 0) {
+          console.log(
+            `[channel.client] seeded ${added} chat(s) from session history for gap-fill`
+          );
+        }
+      }
       /**
        * TEST-ONLY: run exactly ONE open-chat discovery cycle (same code path the
        * interval timer invokes), awaited to completion. Lets tests assert the
@@ -108693,10 +108764,10 @@ var init_channelClient = __esm({
             log(`dropped (unmappable raw): ${JSON.stringify(msg.messageId ?? "?")}`);
             return;
           }
-          this.noteSeenChat(ev.chat_id);
-          if (typeof ev.chat_type === "string" && ev.chat_type.length > 0) {
-            this.chatTypesById.set(ev.chat_id, ev.chat_type);
-          }
+          this.noteSeenChat(
+            ev.chat_id,
+            typeof ev.chat_type === "string" && ev.chat_type.length > 0 ? ev.chat_type : void 0
+          );
           if (this.seenMessageIds.has(ev.message_id) || this.inFlightMessageIds.has(ev.message_id)) {
             return;
           }
@@ -108769,10 +108840,10 @@ var init_channelClient = __esm({
       ingestLocalEvent(ev, sourceTag) {
         if (this.closed) return false;
         const log = (s) => console.log(`[channel.client] ${s}`);
-        this.noteSeenChat(ev.chat_id);
-        if (typeof ev.chat_type === "string" && ev.chat_type.length > 0) {
-          this.chatTypesById.set(ev.chat_id, ev.chat_type);
-        }
+        this.noteSeenChat(
+          ev.chat_id,
+          typeof ev.chat_type === "string" && ev.chat_type.length > 0 ? ev.chat_type : void 0
+        );
         if (this.seenMessageIds.has(ev.message_id) || this.inFlightMessageIds.has(ev.message_id)) {
           log(`local-dispatch deduped (${sourceTag}): message_id=${ev.message_id}`);
           return false;
@@ -108979,14 +109050,19 @@ var init_channelClient = __esm({
               const messageId = m["message_id"];
               if (!messageId) continue;
               if (this.seenMessageIds.has(messageId) || this.inFlightMessageIds.has(messageId)) continue;
-              const mentions = m["mentions"];
-              const mentionsBot = Array.isArray(mentions) && mentions.some(
-                (mn) => {
-                  if (typeof mn?.id === "string") return mn.id === botOpenId;
-                  return mn?.id?.open_id === botOpenId;
-                }
-              );
-              if (!mentionsBot) continue;
+              const isP2pChat = this.chatTypesById.get(chatId) === "p2p";
+              if (isP2pChat) {
+                if (isBotSentMessage(m, botOpenId)) continue;
+              } else {
+                const mentions = m["mentions"];
+                const mentionsBot = Array.isArray(mentions) && mentions.some(
+                  (mn) => {
+                    if (typeof mn?.id === "string") return mn.id === botOpenId;
+                    return mn?.id?.open_id === botOpenId;
+                  }
+                );
+                if (!mentionsBot) continue;
+              }
               const recoveredThread = resolveRecoveredThreadId(m);
               const isThreadReply = recoveredThread !== null && recoveredThread !== messageId;
               if (isThreadReply && !nonEmptyStringField(m, "root_id")) {
@@ -109040,7 +109116,12 @@ var init_channelClient = __esm({
               totalDispatched++;
             }
             this.resolveUnresolvedGapWindow(chatId, windowStart);
+            this.chatAccessGoneCountByChat.delete(chatId);
           } catch (e) {
+            if (isChatAccessGoneError(e)) {
+              this.noteChatAccessGone(chatId, log);
+              continue;
+            }
             anyChatFailed = true;
             this.recordUnresolvedGapWindow(chatId, windowStart, log);
             log(
@@ -109068,6 +109149,7 @@ var init_channelClient = __esm({
             return await execFile4(larkCli, args);
           } catch (e) {
             lastErr = e;
+            if (isChatAccessGoneError(e)) throw e;
             if (attempt < GAP_FILL_MAX_ATTEMPTS) {
               const backoffMs = GAP_FILL_BACKOFF_BASE_MS * 2 ** (attempt - 1);
               log(
@@ -109124,6 +109206,33 @@ var init_channelClient = __esm({
         if (tracked === void 0) return;
         if (coveredFrom <= tracked) this.unresolvedGapWindowByChat.delete(chatId);
       }
+      /**
+       * A gap-fill cycle hit 230002 for this chat (bot removed from it). Drop any
+       * queued unresolved window IMMEDIATELY — replaying it burns quota against a
+       * deterministic error (the 2026-07-17 amplifier) — and count a strike; at
+       * {@link CHAT_ACCESS_GONE_UNTRACK_AFTER} consecutive strikes, untrack the
+       * chat entirely so no future cycle pulls it. Self-healing: if the bot is
+       * re-invited, the next live message (or discovery listing) re-tracks the
+       * chat via {@link noteSeenChat}, which also resets the strikes.
+       */
+      noteChatAccessGone(chatId, log) {
+        this.unresolvedGapWindowByChat.delete(chatId);
+        const strikes = (this.chatAccessGoneCountByChat.get(chatId) ?? 0) + 1;
+        if (strikes < CHAT_ACCESS_GONE_UNTRACK_AFTER) {
+          this.chatAccessGoneCountByChat.set(chatId, strikes);
+          log(
+            `gap-fill: chat ${chatId} inaccessible (230002 \u2014 bot not in chat), strike ${strikes}/${CHAT_ACCESS_GONE_UNTRACK_AFTER}`
+          );
+          return;
+        }
+        this.chatAccessGoneCountByChat.delete(chatId);
+        const wasTracked = this.recentlySeenChatIds.delete(chatId);
+        this.chatTypesById.delete(chatId);
+        if (wasTracked) void this.persistRecentlySeenChatIds();
+        log(
+          `gap-fill: chat ${chatId} untracked after ${CHAT_ACCESS_GONE_UNTRACK_AFTER} consecutive inaccessible cycles (bot removed from chat?) \u2014 re-tracks automatically on the next live message`
+        );
+      }
       /**
        * Chats-mode replay loop (see {@link unresolvedReplayTimer}): every discovery
        * interval, IF any unresolved gap window is pending, gapFill exactly those
@@ -109284,24 +109393,35 @@ var init_channelClient = __esm({
         try {
           const raw = await readFile5(file, "utf8");
           const parsed = JSON.parse(raw);
-          if (!Array.isArray(parsed)) return;
+          const ids = Array.isArray(parsed) ? parsed : arrayField(parsed, "chats") ?? [];
           let count = 0;
-          for (const chatId of parsed) {
+          for (const chatId of ids) {
             if (typeof chatId !== "string" || !chatId.startsWith("oc_")) continue;
             this.recentlySeenChatIds.add(chatId);
             count++;
           }
+          const types2 = !Array.isArray(parsed) && parsed && typeof parsed === "object" ? parsed["chatTypes"] : void 0;
+          if (types2 && typeof types2 === "object") {
+            for (const [chatId, t] of Object.entries(types2)) {
+              if (typeof t !== "string" || t.length === 0) continue;
+              if (!this.recentlySeenChatIds.has(chatId)) continue;
+              this.chatTypesById.set(chatId, t);
+            }
+          }
           if (count > 0) log(`loaded ${count} learned chat(s) for gap-fill`);
         } catch (err2) {
           if (err2.code === "ENOENT") return;
           log(`learned chats load failed: ${err2.message}`);
         }
       }
-      noteSeenChat(chatId) {
+      noteSeenChat(chatId, chatType) {
+        const typeChanged = chatType !== void 0 && this.chatTypesById.get(chatId) !== chatType;
+        if (typeChanged) this.chatTypesById.set(chatId, chatType);
         if (!chatId.startsWith("oc_")) return;
+        this.chatAccessGoneCountByChat.delete(chatId);
         const before = this.recentlySeenChatIds.size;
         this.recentlySeenChatIds.add(chatId);
-        if (this.recentlySeenChatIds.size === before) return;
+        if (this.recentlySeenChatIds.size === before && !typeChanged) return;
         void this.persistRecentlySeenChatIds();
       }
       async loadSeenMessageIds(log) {
@@ -109366,7 +109486,12 @@ var init_channelClient = __esm({
         const file = this.learnedChatsPath();
         if (!file) return;
         const chats = [...this.recentlySeenChatIds].sort().slice(-LEARNED_CHATS_LIMIT);
-        await this.atomicWriteJson(file, chats);
+        const chatTypes = {};
+        for (const chatId of chats) {
+          const t = this.chatTypesById.get(chatId);
+          if (t) chatTypes[chatId] = t;
+        }
+        await this.atomicWriteJson(file, { chats, chatTypes });
       }
       async addProcessingReaction(messageId) {
         if (this.processingReactions.has(messageId)) return;
@@ -121335,7 +121460,7 @@ var jsYaml = {
 };
 
 // src/config/botLoader.ts
-import { readdir, readFile } from "node:fs/promises";
+import { readdir, readFile, stat } from "node:fs/promises";
 import path from "node:path";
 
 // src/responseSurface.ts
@@ -122026,6 +122151,10 @@ ${issues}`);
 async function loadBots(botsDir) {
   return (await loadBotsDetailed(botsDir)).bots;
 }
+var ScheduleSliceSchema = BotConfigSchema.pick({
+  schedules: true,
+  schedule_chat_id: true
+}).strip();
 
 // src/cli/botsStore.ts
 init_paths();
@@ -122183,7 +122312,7 @@ __export(hostConfig_exports, {
   writeHostConfig: () => writeHostConfig,
   writeSecret: () => writeSecret
 });
-import { mkdir as mkdir2, readFile as readFile4, writeFile as writeFile2, rename as rename2, chmod, access as access2, stat, unlink as unlink2 } from "node:fs/promises";
+import { mkdir as mkdir2, readFile as readFile4, writeFile as writeFile2, rename as rename2, chmod, access as access2, stat as stat2, unlink as unlink2 } from "node:fs/promises";
 import path4 from "node:path";
 
 // src/config.ts
@@ -122360,7 +122489,7 @@ async function removeSecret(envName) {
   const body = [...map2.entries()].map(([k, v]) => `${k}=${quoteIfNeeded(v)}`).join("\n") + "\n";
   await atomicWrite2(file, body);
   try {
-    const s = await stat(file);
+    const s = await stat2(file);
     if ((s.mode & 511) !== 384) await chmod(file, 384);
   } catch {
     await chmod(file, 384);
@@ -122376,7 +122505,7 @@ async function envFileExists() {
 }
 
 // src/cli/commands/init.ts
-import { access as access5, stat as stat2 } from "node:fs/promises";
+import { access as access5, stat as stat3 } from "node:fs/promises";
 import { execFile as execFile3 } from "node:child_process";
 import path8 from "node:path";
 import "node:os";
@@ -122555,8 +122684,8 @@ async function writeAlways(filePath, content) {
 }
 async function ensureRelativeSymlink(linkPath, target) {
   try {
-    const stat6 = await fs.lstat(linkPath);
-    if (stat6.isSymbolicLink()) {
+    const stat7 = await fs.lstat(linkPath);
+    if (stat7.isSymbolicLink()) {
       const currentTarget = await fs.readlink(linkPath);
       if (currentTarget === target) return;
     }
@@ -123170,7 +123299,7 @@ async function detectLocalRepos(cwd) {
     for (const name of siblings.slice(0, 20)) {
       const p = path8.join(parent, name);
       try {
-        const s = await stat2(p);
+        const s = await stat3(p);
         if (s.isDirectory()) candidates.push(p);
       } catch {
       }
@@ -123930,8 +124059,8 @@ async function checkWorktrees(ctx) {
       const gitPath = path10.join(worktreeDir, ".git");
       let gitContent = null;
       try {
-        const stat6 = await readFile7(gitPath, "utf-8").catch(() => null);
-        gitContent = stat6;
+        const stat7 = await readFile7(gitPath, "utf-8").catch(() => null);
+        gitContent = stat7;
       } catch {
       }
       if (gitContent === null) {
@@ -125759,7 +125888,7 @@ import { readFile as readFile10, writeFile as writeFile8, unlink as unlink5, mkd
 import { promisify as promisify6 } from "node:util";
 import path15 from "node:path";
 import process3 from "node:process";
-import { stat as stat3 } from "node:fs/promises";
+import { stat as stat4 } from "node:fs/promises";
 
 // src/bridge/statusFile.ts
 init_paths();
@@ -126087,7 +126216,7 @@ async function tailBridgeLog(larkwayDir, n = 80) {
   const logPath = bridgeLogPath(larkwayDir);
   let content;
   try {
-    const s = await stat3(logPath);
+    const s = await stat4(logPath);
     const MAX_READ = 256 * 1024;
     if (s.size > MAX_READ) {
       const { open } = await import("node:fs/promises");
@@ -126681,12 +126810,12 @@ async function run7(ctx, args) {
 import http from "node:http";
 import { randomBytes } from "node:crypto";
 import { existsSync } from "node:fs";
-import { readFile as readFile14, stat as stat5 } from "node:fs/promises";
+import { readFile as readFile14, stat as stat6 } from "node:fs/promises";
 import path25 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/web/api.ts
-import { readdir as readdir6, readFile as readFile13, stat as stat4 } from "node:fs/promises";
+import { readdir as readdir6, readFile as readFile13, stat as stat5 } from "node:fs/promises";
 import { execFile as execFileCallback2 } from "node:child_process";
 import path24 from "node:path";
 import { promisify as promisify8 } from "node:util";
@@ -128282,7 +128411,7 @@ var getStatus = async (req) => {
   let logExists = false;
   let logSizeKb = 0;
   try {
-    const s = await stat4(logPath);
+    const s = await stat5(logPath);
     logExists = true;
     logSizeKb = Math.round(s.size / 1024);
   } catch {
@@ -128744,7 +128873,7 @@ async function handleStatic(res, pathname, token) {
   let target = resolved;
   let isIndexFallback = false;
   try {
-    const s = await stat5(target);
+    const s = await stat6(target);
     if (s.isDirectory()) {
       target = path25.join(target, "index.html");
     }

package/dist/main.js

@@ -10067,12 +10067,12 @@ var require_form_data = __commonJS({
         if (value.end != void 0 && value.end != Infinity && value.start != void 0) {
           callback(null, value.end + 1 - (value.start ? value.start : 0));
         } else {
-          fs17.stat(value.path, function(err, stat4) {
+          fs17.stat(value.path, function(err, stat5) {
             if (err) {
               callback(err);
               return;
             }
-            var fileSize = stat4.size - (value.start ? value.start : 0);
+            var fileSize = stat5.size - (value.start ? value.start : 0);
             callback(null, fileSize);
           });
         }
@@ -112365,6 +112365,18 @@ var GAP_FILL_MAX_ATTEMPTS = 3;
 var GAP_FILL_BACKOFF_BASE_MS = 1e3;
 var UNRESOLVED_WINDOW_MAX_CHATS = 50;
 var UNRESOLVED_WINDOW_MAX_AGE_MS = 30 * 60 * 1e3;
+var CHAT_ACCESS_GONE_UNTRACK_AFTER = 3;
+function isChatAccessGoneError(e) {
+  const parts = [];
+  if (e instanceof Error) parts.push(e.message);
+  if (e && typeof e === "object") {
+    for (const key of ["stderr", "stdout"]) {
+      const v = e[key];
+      if (typeof v === "string") parts.push(v);
+    }
+  }
+  return parts.some((s) => s.includes("230002"));
+}
 function stripAtMarkup(s) {
   return s.replace(/<at\b[^>]*>.*?<\/at>/gi, "").replace(/<at\b[^>]*\/>/gi, "").trim();
 }
@@ -112453,6 +112465,16 @@ function resolveRecoveredThreadId(m) {
   }
   return null;
 }
+function isBotSentMessage(m, botOpenId) {
+  const sender = m["sender"];
+  if (typeof sender === "string") return sender === botOpenId;
+  if (sender && typeof sender === "object") {
+    const s = sender;
+    if (s["sender_type"] === "app") return true;
+    if (typeof s["id"] === "string" && s["id"] === botOpenId) return true;
+  }
+  return false;
+}
 function cardActionChoice(value) {
   if (value && typeof value === "object") {
     const choice = value["larkway_choice"];
@@ -112601,6 +112623,16 @@ var ChannelClient = class {
    * capped at UNRESOLVED_WINDOW_MAX_CHATS tracked chats.
    */
   unresolvedGapWindowByChat = /* @__PURE__ */ new Map();
+  /**
+   * chatId → count of CONSECUTIVE gap-fill cycles whose pull failed with
+   * 230002 (bot removed from the chat). At {@link CHAT_ACCESS_GONE_UNTRACK_AFTER}
+   * the chat is dropped from gap-fill tracking entirely (see
+   * {@link noteChatAccessGone}) — the fix for the 2026-07-17 amplifier where a
+   * stale chat's unresolved window was replayed (3 retries each) every cycle,
+   * forever, burning quota against a deterministic error. Reset by any
+   * successful pull of the chat or any live sighting (noteSeenChat).
+   */
+  chatAccessGoneCountByChat = /* @__PURE__ */ new Map();
   /**
    * Backoff sleep used by the per-chat history-pull retry. Indirected through a
    * field purely so tests can observe/await the backoff deterministically; in
@@ -112688,6 +112720,44 @@ var ChannelClient = class {
   unresolvedGapWindowsForTest() {
     return new Map(this.unresolvedGapWindowByChat);
   }
+  /** TEST-ONLY read of the tracked (gap-fillable) chat id set. */
+  trackedChatIdsForTest() {
+    return new Set(this.recentlySeenChatIds);
+  }
+  /**
+   * Seed gap-fill's tracked-chat set from durable session history
+   * (sessions.json), BEFORE connect. Fix for the 2026-07-17 p2p message-loss
+   * incident: p2p chats are invisible to bot-side chat-list discovery (the API
+   * returns groups only), so once the in-memory tracking state was gone —
+   * restart plus a missing/stale runtime cache — a p2p chat could never
+   * re-enter the gap-fill list and its messages dropped during a WS outage
+   * were lost forever. sessions.json persists the chatId (and, going forward,
+   * chatType) of every thread the bot has served, so seeding from it makes a
+   * p2p chat permanently gap-fillable once it has ever been seen.
+   *
+   * Deliberately does NOT persist to the runtime channel-seen-chats cache:
+   * this runs before {@link loadRecentlySeenChatIds} merges the cache in, and
+   * persisting the (possibly smaller) seed set here would overwrite cached
+   * chats learned in previous runs. The union is persisted by the next
+   * ordinary noteSeenChat.
+   */
+  seedTrackedChats(entries) {
+    let added = 0;
+    for (const { chatId, chatType } of entries) {
+      if (!chatId.startsWith("oc_")) continue;
+      const before = this.recentlySeenChatIds.size;
+      this.recentlySeenChatIds.add(chatId);
+      if (this.recentlySeenChatIds.size > before) added++;
+      if (chatType && !this.chatTypesById.has(chatId)) {
+        this.chatTypesById.set(chatId, chatType);
+      }
+    }
+    if (added > 0) {
+      console.log(
+        `[channel.client] seeded ${added} chat(s) from session history for gap-fill`
+      );
+    }
+  }
   /**
    * TEST-ONLY: run exactly ONE open-chat discovery cycle (same code path the
    * interval timer invokes), awaited to completion. Lets tests assert the
@@ -112823,10 +112893,10 @@ var ChannelClient = class {
         log(`dropped (unmappable raw): ${JSON.stringify(msg.messageId ?? "?")}`);
         return;
       }
-      this.noteSeenChat(ev.chat_id);
-      if (typeof ev.chat_type === "string" && ev.chat_type.length > 0) {
-        this.chatTypesById.set(ev.chat_id, ev.chat_type);
-      }
+      this.noteSeenChat(
+        ev.chat_id,
+        typeof ev.chat_type === "string" && ev.chat_type.length > 0 ? ev.chat_type : void 0
+      );
       if (this.seenMessageIds.has(ev.message_id) || this.inFlightMessageIds.has(ev.message_id)) {
         return;
       }
@@ -112899,10 +112969,10 @@ var ChannelClient = class {
   ingestLocalEvent(ev, sourceTag) {
     if (this.closed) return false;
     const log = (s) => console.log(`[channel.client] ${s}`);
-    this.noteSeenChat(ev.chat_id);
-    if (typeof ev.chat_type === "string" && ev.chat_type.length > 0) {
-      this.chatTypesById.set(ev.chat_id, ev.chat_type);
-    }
+    this.noteSeenChat(
+      ev.chat_id,
+      typeof ev.chat_type === "string" && ev.chat_type.length > 0 ? ev.chat_type : void 0
+    );
     if (this.seenMessageIds.has(ev.message_id) || this.inFlightMessageIds.has(ev.message_id)) {
       log(`local-dispatch deduped (${sourceTag}): message_id=${ev.message_id}`);
       return false;
@@ -113109,14 +113179,19 @@ var ChannelClient = class {
           const messageId = m["message_id"];
           if (!messageId) continue;
           if (this.seenMessageIds.has(messageId) || this.inFlightMessageIds.has(messageId)) continue;
-          const mentions = m["mentions"];
-          const mentionsBot = Array.isArray(mentions) && mentions.some(
-            (mn) => {
-              if (typeof mn?.id === "string") return mn.id === botOpenId;
-              return mn?.id?.open_id === botOpenId;
-            }
-          );
-          if (!mentionsBot) continue;
+          const isP2pChat = this.chatTypesById.get(chatId) === "p2p";
+          if (isP2pChat) {
+            if (isBotSentMessage(m, botOpenId)) continue;
+          } else {
+            const mentions = m["mentions"];
+            const mentionsBot = Array.isArray(mentions) && mentions.some(
+              (mn) => {
+                if (typeof mn?.id === "string") return mn.id === botOpenId;
+                return mn?.id?.open_id === botOpenId;
+              }
+            );
+            if (!mentionsBot) continue;
+          }
           const recoveredThread = resolveRecoveredThreadId(m);
           const isThreadReply = recoveredThread !== null && recoveredThread !== messageId;
           if (isThreadReply && !nonEmptyStringField(m, "root_id")) {
@@ -113170,7 +113245,12 @@ var ChannelClient = class {
           totalDispatched++;
         }
         this.resolveUnresolvedGapWindow(chatId, windowStart);
+        this.chatAccessGoneCountByChat.delete(chatId);
       } catch (e) {
+        if (isChatAccessGoneError(e)) {
+          this.noteChatAccessGone(chatId, log);
+          continue;
+        }
         anyChatFailed = true;
         this.recordUnresolvedGapWindow(chatId, windowStart, log);
         log(
@@ -113198,6 +113278,7 @@ var ChannelClient = class {
         return await execFile(larkCli, args);
       } catch (e) {
         lastErr = e;
+        if (isChatAccessGoneError(e)) throw e;
         if (attempt < GAP_FILL_MAX_ATTEMPTS) {
           const backoffMs = GAP_FILL_BACKOFF_BASE_MS * 2 ** (attempt - 1);
           log(
@@ -113254,6 +113335,33 @@ var ChannelClient = class {
     if (tracked === void 0) return;
     if (coveredFrom <= tracked) this.unresolvedGapWindowByChat.delete(chatId);
   }
+  /**
+   * A gap-fill cycle hit 230002 for this chat (bot removed from it). Drop any
+   * queued unresolved window IMMEDIATELY — replaying it burns quota against a
+   * deterministic error (the 2026-07-17 amplifier) — and count a strike; at
+   * {@link CHAT_ACCESS_GONE_UNTRACK_AFTER} consecutive strikes, untrack the
+   * chat entirely so no future cycle pulls it. Self-healing: if the bot is
+   * re-invited, the next live message (or discovery listing) re-tracks the
+   * chat via {@link noteSeenChat}, which also resets the strikes.
+   */
+  noteChatAccessGone(chatId, log) {
+    this.unresolvedGapWindowByChat.delete(chatId);
+    const strikes = (this.chatAccessGoneCountByChat.get(chatId) ?? 0) + 1;
+    if (strikes < CHAT_ACCESS_GONE_UNTRACK_AFTER) {
+      this.chatAccessGoneCountByChat.set(chatId, strikes);
+      log(
+        `gap-fill: chat ${chatId} inaccessible (230002 \u2014 bot not in chat), strike ${strikes}/${CHAT_ACCESS_GONE_UNTRACK_AFTER}`
+      );
+      return;
+    }
+    this.chatAccessGoneCountByChat.delete(chatId);
+    const wasTracked = this.recentlySeenChatIds.delete(chatId);
+    this.chatTypesById.delete(chatId);
+    if (wasTracked) void this.persistRecentlySeenChatIds();
+    log(
+      `gap-fill: chat ${chatId} untracked after ${CHAT_ACCESS_GONE_UNTRACK_AFTER} consecutive inaccessible cycles (bot removed from chat?) \u2014 re-tracks automatically on the next live message`
+    );
+  }
   /**
    * Chats-mode replay loop (see {@link unresolvedReplayTimer}): every discovery
    * interval, IF any unresolved gap window is pending, gapFill exactly those
@@ -113414,24 +113522,35 @@ var ChannelClient = class {
     try {
       const raw = await readFile2(file, "utf8");
       const parsed = JSON.parse(raw);
-      if (!Array.isArray(parsed)) return;
+      const ids = Array.isArray(parsed) ? parsed : arrayField(parsed, "chats") ?? [];
       let count = 0;
-      for (const chatId of parsed) {
+      for (const chatId of ids) {
         if (typeof chatId !== "string" || !chatId.startsWith("oc_")) continue;
         this.recentlySeenChatIds.add(chatId);
         count++;
       }
+      const types2 = !Array.isArray(parsed) && parsed && typeof parsed === "object" ? parsed["chatTypes"] : void 0;
+      if (types2 && typeof types2 === "object") {
+        for (const [chatId, t] of Object.entries(types2)) {
+          if (typeof t !== "string" || t.length === 0) continue;
+          if (!this.recentlySeenChatIds.has(chatId)) continue;
+          this.chatTypesById.set(chatId, t);
+        }
+      }
       if (count > 0) log(`loaded ${count} learned chat(s) for gap-fill`);
     } catch (err) {
       if (err.code === "ENOENT") return;
       log(`learned chats load failed: ${err.message}`);
     }
   }
-  noteSeenChat(chatId) {
+  noteSeenChat(chatId, chatType) {
+    const typeChanged = chatType !== void 0 && this.chatTypesById.get(chatId) !== chatType;
+    if (typeChanged) this.chatTypesById.set(chatId, chatType);
     if (!chatId.startsWith("oc_")) return;
+    this.chatAccessGoneCountByChat.delete(chatId);
     const before = this.recentlySeenChatIds.size;
     this.recentlySeenChatIds.add(chatId);
-    if (this.recentlySeenChatIds.size === before) return;
+    if (this.recentlySeenChatIds.size === before && !typeChanged) return;
     void this.persistRecentlySeenChatIds();
   }
   async loadSeenMessageIds(log) {
@@ -113496,7 +113615,12 @@ var ChannelClient = class {
     const file = this.learnedChatsPath();
     if (!file) return;
     const chats = [...this.recentlySeenChatIds].sort().slice(-LEARNED_CHATS_LIMIT);
-    await this.atomicWriteJson(file, chats);
+    const chatTypes = {};
+    for (const chatId of chats) {
+      const t = this.chatTypesById.get(chatId);
+      if (t) chatTypes[chatId] = t;
+    }
+    await this.atomicWriteJson(file, { chats, chatTypes });
   }
   async addProcessingReaction(messageId) {
     if (this.processingReactions.has(messageId)) return;
@@ -114300,6 +114424,7 @@ var SessionStore = class _SessionStore {
       ...record.senderOpenId !== void 0 ? { senderOpenId: record.senderOpenId } : {},
       ...record.rootText !== void 0 ? { rootText: record.rootText } : {},
       ...record.chatId !== void 0 ? { chatId: record.chatId } : {},
+      ...record.chatType !== void 0 ? { chatType: record.chatType } : {},
       // BL-38: only persist when > 0 — a 0/undefined counter is a clean thread,
       // so passing consecutiveStuckCount: 0 naturally clears the field on reset.
       ...record.consecutiveStuckCount ? { consecutiveStuckCount: record.consecutiveStuckCount } : {},
@@ -114439,7 +114564,7 @@ var SessionStore = class _SessionStore {
 function isStoredRecord(value) {
   if (typeof value !== "object" || value === null) return false;
   const v = value;
-  return typeof v["threadId"] === "string" && typeof v["sessionId"] === "string" && typeof v["botId"] === "string" && typeof v["createdTs"] === "number" && typeof v["lastActiveTs"] === "number" && (v["senderOpenId"] === void 0 || typeof v["senderOpenId"] === "string") && (v["rootText"] === void 0 || typeof v["rootText"] === "string") && (v["chatId"] === void 0 || typeof v["chatId"] === "string") && (v["turnCount"] === void 0 || typeof v["turnCount"] === "number") && (v["harvestedAt"] === void 0 || typeof v["harvestedAt"] === "number") && (v["approxChars"] === void 0 || typeof v["approxChars"] === "number") && (v["needsFreshStart"] === void 0 || isFreshStartMarker(v["needsFreshStart"]));
+  return typeof v["threadId"] === "string" && typeof v["sessionId"] === "string" && typeof v["botId"] === "string" && typeof v["createdTs"] === "number" && typeof v["lastActiveTs"] === "number" && (v["senderOpenId"] === void 0 || typeof v["senderOpenId"] === "string") && (v["rootText"] === void 0 || typeof v["rootText"] === "string") && (v["chatId"] === void 0 || typeof v["chatId"] === "string") && (v["chatType"] === void 0 || typeof v["chatType"] === "string") && (v["turnCount"] === void 0 || typeof v["turnCount"] === "number") && (v["harvestedAt"] === void 0 || typeof v["harvestedAt"] === "number") && (v["approxChars"] === void 0 || typeof v["approxChars"] === "number") && (v["needsFreshStart"] === void 0 || isFreshStartMarker(v["needsFreshStart"]));
 }
 function isFreshStartMarker(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -116052,8 +116177,8 @@ async function writeAlways(filePath, content) {
 }
 async function ensureRelativeSymlink(linkPath, target) {
   try {
-    const stat4 = await fs4.lstat(linkPath);
-    if (stat4.isSymbolicLink()) {
+    const stat5 = await fs4.lstat(linkPath);
+    if (stat5.isSymbolicLink()) {
       const currentTarget = await fs4.readlink(linkPath);
       if (currentTarget === target) return;
     }
@@ -120116,7 +120241,15 @@ var BridgeHandler = class {
                 turnCount: 1,
                 // 批H (H2): volume accounting starts with this turn's own contribution.
                 approxChars: turnToolResultChars + trustedAnswerText.length,
-                ...isTopLevel ? { rootText: parsed.text.slice(0, 200), chatId: parsed.chatId } : {}
+                ...isTopLevel ? {
+                  rootText: parsed.text.slice(0, 200),
+                  chatId: parsed.chatId,
+                  // 2026-07-17 p2p message-loss fix: persist the chat's type
+                  // alongside chatId so ChannelClient.seedTrackedChats can
+                  // mark a p2p chat gap-fillable across restarts (p2p is
+                  // invisible to bot chat-list discovery).
+                  ...typeof parsed.raw.chat_type === "string" && parsed.raw.chat_type ? { chatType: parsed.raw.chat_type } : {}
+                } : {}
               });
             } else if (sessionId !== void 0 && currentExisting !== void 0) {
               await this.deps.sessionStore.put({
@@ -120128,6 +120261,7 @@ var BridgeHandler = class {
                 senderOpenId,
                 rootText: currentExisting.rootText,
                 chatId: currentExisting.chatId,
+                chatType: currentExisting.chatType,
                 // BL-38: +1 on an idle-stuck turn, 0 (cleared) on any clean turn.
                 consecutiveStuckCount: nextStuckCount,
                 // 批F (F2): a reseed turn restarts the count at 1 (this turn ran
@@ -121175,7 +121309,7 @@ async function cleanupAgentSession(threadId, agentId, dryRun) {
 }
 
 // src/config/botLoader.ts
-import { readdir as readdir2, readFile as readFile5 } from "node:fs/promises";
+import { readdir as readdir2, readFile as readFile5, stat as stat2 } from "node:fs/promises";
 import path17 from "node:path";
 
 // node_modules/.pnpm/js-yaml@4.1.1/node_modules/js-yaml/dist/js-yaml.mjs
@@ -124363,9 +124497,56 @@ ${issues}`);
   }
   return { bots: deduped, skipped, strippedPeers };
 }
+var ScheduleSliceSchema = BotConfigSchema.pick({
+  schedules: true,
+  schedule_chat_id: true
+}).strip();
+function createScheduleConfigReloader(botsDir, botId) {
+  let filePath;
+  let lastMtimeMs;
+  return async () => {
+    try {
+      if (filePath === void 0) {
+        const entries = (await readdir2(botsDir)).filter(
+          (f) => f.endsWith(".yaml") || f.endsWith(".yml")
+        );
+        for (const f of entries.sort()) {
+          const p = path17.join(botsDir, f);
+          try {
+            const parsed2 = jsYaml.load(await readFile5(p, "utf-8"));
+            if (parsed2 && parsed2["id"] === botId) {
+              filePath = p;
+              break;
+            }
+          } catch {
+          }
+        }
+        if (filePath === void 0) return null;
+      }
+      const st = await stat2(filePath);
+      if (lastMtimeMs !== void 0 && st.mtimeMs === lastMtimeMs) return null;
+      const parsed = jsYaml.load(await readFile5(filePath, "utf-8"));
+      const result = ScheduleSliceSchema.safeParse(parsed);
+      if (!result.success) return null;
+      lastMtimeMs = st.mtimeMs;
+      return {
+        schedules: result.data.schedules,
+        schedule_chat_id: result.data.schedule_chat_id
+      };
+    } catch {
+      try {
+        if (filePath !== void 0) await stat2(filePath);
+      } catch {
+        filePath = void 0;
+        lastMtimeMs = void 0;
+      }
+      return null;
+    }
+  };
+}
 
 // src/bridge/reconcile.ts
-import { readdir as readdir3, stat as stat2 } from "node:fs/promises";
+import { readdir as readdir3, stat as stat3 } from "node:fs/promises";
 import { join as pathJoin2 } from "node:path";
 
 // src/bridge/postFile.ts
@@ -124989,7 +125170,7 @@ async function reconcileOrphanedCards(deps) {
       let ageMs = 0;
       try {
         const target = state ? stateFilePathOf(wtPath) : wtPath;
-        ageMs = now - (await stat2(target)).mtimeMs;
+        ageMs = now - (await stat3(target)).mtimeMs;
       } catch {
         ageMs = 0;
       }
@@ -125509,7 +125690,7 @@ var ClaudeRunner = class {
 
 // src/claude/pool.ts
 import { execFile as execFile4, spawn as spawn3 } from "node:child_process";
-import { mkdir as mkdir4, readFile as readFile6, rename as rename3, stat as stat3, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile6, rename as rename3, stat as stat4, unlink as unlink4, writeFile as writeFile4 } from "node:fs/promises";
 import path20 from "node:path";
 import { createInterface as createInterface2 } from "node:readline";
 import { randomUUID } from "node:crypto";
@@ -126282,7 +126463,7 @@ async function reapOrphanedWarmClaudeProcesses(pidListFilePath) {
     return;
   }
   try {
-    const st = await stat3(pidListFilePath);
+    const st = await stat4(pidListFilePath);
     const ageMs = Date.now() - st.mtimeMs;
     if (ageMs < REAP_FRESHNESS_GUARD_MS) {
       console.warn(
@@ -129534,6 +129715,9 @@ function decideCronDue(nextFireAt, now, graceMinutes) {
   if (overdueMinutes > graceMinutes) return { kind: "misfire_skip", overdueMinutes };
   return { kind: "fire" };
 }
+function fingerprintConfig(schedules, defaultChatId) {
+  return JSON.stringify([schedules, defaultChatId ?? null]);
+}
 function decideOneShotDue(wake, now) {
   const at = Date.parse(wake.at);
   if (Number.isNaN(at)) return { kind: "expired" };
@@ -129550,6 +129734,9 @@ var BotScheduler = class {
   #statePath;
   #wakesDir;
   #cron = [];
+  #defaultChatId;
+  /** Fingerprint of the applied config — reload no-ops (and stays silent) when unchanged. */
+  #configFingerprint;
   #timer;
   #running = false;
   /** Awaitable current cycle — same M1 shutdown-drain shape as CommentPoller. */
@@ -129559,14 +129746,22 @@ var BotScheduler = class {
     this.#tickMs = opts?.tickMs ?? DEFAULT_TICK_MS;
     this.#statePath = path23.join(deps.botDir, "schedule-state.json");
     this.#wakesDir = path23.join(deps.botDir, "wakes");
-    for (const [i, entry] of deps.schedules.entries()) {
+    this.#defaultChatId = deps.defaultChatId;
+    this.#configFingerprint = fingerprintConfig(deps.schedules, deps.defaultChatId);
+    this.#applyCronConfig(deps.schedules);
+  }
+  /** (Re)build the parsed cron entry list from a config slice. */
+  #applyCronConfig(schedules) {
+    const next = [];
+    for (const [i, entry] of schedules.entries()) {
       if (entry.enabled === false) continue;
       try {
-        this.#cron.push({ key: cronEntryKey(i, entry), entry, spec: parseCron(entry.cron) });
+        next.push({ key: cronEntryKey(i, entry), entry, spec: parseCron(entry.cron) });
       } catch (err) {
         this.#log(`schedule entry ${i} skipped (bad cron "${entry.cron}"): ${String(err)}`);
       }
     }
+    this.#cron = next;
   }
   #log(line) {
     (this.#deps.log ?? ((s) => console.log(`[schedule] ${s}`)))(
@@ -129631,6 +129826,11 @@ var BotScheduler = class {
   // -- tick ------------------------------------------------------------------
   async #tick() {
     if (!this.#running) return;
+    try {
+      await this.#maybeReloadConfig();
+    } catch (err) {
+      this.#log(`config reload failed (keeping current schedules): ${String(err)}`);
+    }
     try {
       await this.#tickCron();
     } catch (err) {
@@ -129642,6 +129842,20 @@ var BotScheduler = class {
       this.#log(`one-shot tick failed (next tick retries): ${String(err)}`);
     }
   }
+  /** Hot-reload: apply a changed yaml schedules slice mid-flight (docs/schedule.md). */
+  async #maybeReloadConfig() {
+    if (!this.#deps.reloadConfig) return;
+    const next = await this.#deps.reloadConfig();
+    if (!next) return;
+    const fingerprint = fingerprintConfig(next.schedules, next.schedule_chat_id);
+    if (fingerprint === this.#configFingerprint) return;
+    this.#configFingerprint = fingerprint;
+    this.#defaultChatId = next.schedule_chat_id;
+    this.#applyCronConfig(next.schedules);
+    this.#log(
+      `schedules hot-reloaded from yaml: ${this.#cron.length} active cron entr${this.#cron.length === 1 ? "y" : "ies"} (no restart needed)`
+    );
+  }
   async #tickCron() {
     if (this.#cron.length === 0) return;
     const now = this.#now();
@@ -129669,7 +129883,7 @@ var BotScheduler = class {
           `cron "${entry.cron}" missed by ${decision.overdueMinutes.toFixed(1)}min (> grace ${grace}min) \u2014 skipped, next at ${advance?.toISOString() ?? "never"}`
         );
       } else {
-        const chatId = entry.chat_id ?? this.#deps.defaultChatId;
+        const chatId = entry.chat_id ?? this.#defaultChatId;
         if (!chatId) {
           this.#log(`cron "${entry.cron}" due but no chat_id/schedule_chat_id \u2014 skipped`);
         } else {
@@ -129733,7 +129947,7 @@ var BotScheduler = class {
         await unlink6(full).catch(() => void 0);
         continue;
       }
-      const chatId = wake.chat_id ?? this.#deps.defaultChatId;
+      const chatId = wake.chat_id ?? this.#defaultChatId;
       if (!chatId) {
         this.#log(`wake ${file} due but no chat_id/schedule_chat_id \u2014 dropped`);
         await unlink6(full).catch(() => void 0);
@@ -129886,6 +130100,11 @@ async function runV2Mode({
       larkCliProfile,
       larkwayDir: larkwayHome()
     });
+    client.seedTrackedChats(
+      sessionStore.list().flatMap(
+        (r) => r.chatId ? [{ chatId: r.chatId, ...r.chatType ? { chatType: r.chatType } : {} }] : []
+      )
+    );
     console.log(`[larkway] bot "${bot.id}" inbound transport = Channel SDK (WS in-process)`);
     localHandoffRegistry.register(
       { botId: bot.id, name: bot.name, botOpenId: bot.bot_open_id },
@@ -130255,6 +130474,13 @@ async function runV2Mode({
       botDir,
       schedules: bot.schedules,
       defaultChatId: bot.schedule_chat_id,
+      // Hot-reload: edits to the bot yaml's schedules:/schedule_chat_id go
+      // live within one tick (≤30s) — no bridge restart. Every other yaml
+      // field still needs a restart (loaded once at boot).
+      reloadConfig: createScheduleConfigReloader(
+        process.env["LARKWAY_BOTS_DIR"] ? path24.resolve(process.env["LARKWAY_BOTS_DIR"]) : path24.join(larkwayHome(), "bots"),
+        bot.id
+      ),
       log: (line) => console.log(`[schedule] ${line}`),
       fire: async ({ prompt, note, chatId, source, id, occurrence }) => {
         let mirrorId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkway",
-  "version": "0.3.55",
+  "version": "0.3.57",
   "description": "Thin bridge: Feishu thread to local Claude Code CLI",
   "license": "MIT",
   "author": "Chuck Wu (chuckwu0)",