dsh-lark-bot 0.7.0 → 0.8.0

package/dist/plugin.d.ts

@@ -113,6 +113,23 @@ interface RuntimeEnv {
     archiveMaxAgeDays: number;
     accessDefaultDeny: boolean;
     eventFreshnessMs: number;
+    /** Bridge engine heartbeat interval (guardian liveness signal), default 5000. */
+    heartbeatMs: number;
+    /** Guardian disabled switch (DSH_LARK_GUARDIAN_DISABLED=1 keeps it stopped). */
+    guardianDisabled: boolean;
+    /** dsh profile the guardian watches / relaunches (default `dsh-lark`). */
+    guardianProfile: string;
+    /** Bridge state profile providing Feishu credentials (default `default`). */
+    guardianBridgeProfile: string;
+    /** Guardian watchdog poll interval, default 2000. */
+    guardianPollMs: number;
+    /** Heartbeat staleness threshold before takeover, default 15000. */
+    guardianStaleMs: number;
+    /**
+     * When a dsh process is alive but the bridge heartbeat has been stale for
+     * longer than this, treat the engine as dead and take over (default 120000).
+     */
+    guardianEngineDeadMs: number;
 }
 
 interface ActiveRunHandle {

package/dist/plugin.js

@@ -64,7 +64,7 @@ var init_dsh_compat = __esm({
       sdkServer: "0.1.0-rc.6",
       acp: "0.1.0-rc.6",
       node: ">=22.19.0",
-      verifiedAt: "2026-08-14"
+      verifiedAt: "2026-08-15"
     };
   }
 });
@@ -4449,7 +4449,13 @@ var DEFAULTS = {
   scopeConcurrency: 2,
   retentionMsgs: 40,
   archiveMax: 50,
-  archiveMaxAgeDays: 90
+  archiveMaxAgeDays: 90,
+  heartbeatMs: 5e3,
+  guardianPollMs: 2e3,
+  guardianStaleMs: 15e3,
+  guardianEngineDeadMs: 12e4,
+  guardianProfile: "dsh-lark",
+  guardianBridgeProfile: "default"
 };
 function nonEmpty(value) {
   const trimmed = value?.trim();
@@ -4535,6 +4541,15 @@ function parseMinOneInt(value, fallback, name2) {
   }
   return parsed;
 }
+function parsePositiveIntMin(value, fallback, name2) {
+  const raw = value?.trim();
+  if (!raw) return fallback;
+  const parsed = Number(raw);
+  if (!Number.isInteger(parsed) || parsed < 1) {
+    throw new Error(`${name2} must be a positive integer, got "${raw}"`);
+  }
+  return parsed;
+}
 function loadRuntimeEnv(source = process.env) {
   const homeOverride = nonEmpty(source.DSH_LARK_HOME);
   const workspace = nonEmpty(source.DSH_LARK_WORKSPACE);
@@ -4585,7 +4600,30 @@ function loadRuntimeEnv(source = process.env) {
       "DSH_LARK_ARCHIVE_MAX_AGE_DAYS"
     ),
     accessDefaultDeny: parseBoolean(source.DSH_LARK_ACCESS_DEFAULT_DENY, false),
-    eventFreshnessMs: parseFreshness(source.DSH_LARK_EVENT_FRESHNESS_MS)
+    eventFreshnessMs: parseFreshness(source.DSH_LARK_EVENT_FRESHNESS_MS),
+    heartbeatMs: parsePositiveIntMin(
+      source.DSH_LARK_HEARTBEAT_MS,
+      DEFAULTS.heartbeatMs,
+      "DSH_LARK_HEARTBEAT_MS"
+    ),
+    guardianDisabled: parseBoolean(source.DSH_LARK_GUARDIAN_DISABLED, false),
+    guardianProfile: nonEmpty(source.DSH_LARK_GUARDIAN_PROFILE) ?? DEFAULTS.guardianProfile,
+    guardianBridgeProfile: nonEmpty(source.DSH_LARK_GUARDIAN_BRIDGE_PROFILE) ?? DEFAULTS.guardianBridgeProfile,
+    guardianPollMs: parsePositiveIntMin(
+      source.DSH_LARK_GUARDIAN_POLL_MS,
+      DEFAULTS.guardianPollMs,
+      "DSH_LARK_GUARDIAN_POLL_MS"
+    ),
+    guardianStaleMs: parsePositiveIntMin(
+      source.DSH_LARK_GUARDIAN_STALE_MS,
+      DEFAULTS.guardianStaleMs,
+      "DSH_LARK_GUARDIAN_STALE_MS"
+    ),
+    guardianEngineDeadMs: parsePositiveIntMin(
+      source.DSH_LARK_GUARDIAN_ENGINE_DEAD_MS,
+      DEFAULTS.guardianEngineDeadMs,
+      "DSH_LARK_GUARDIAN_ENGINE_DEAD_MS"
+    )
   };
 }
 
@@ -5315,6 +5353,36 @@ var WorkspaceStore = class {
   }
 };
 
+// src/guardian/heartbeat.ts
+import { readFile as readFile9 } from "fs/promises";
+var DEFAULT_HEARTBEAT_INTERVAL_MS = 5e3;
+function startHeartbeat(file, pid, intervalMs = DEFAULT_HEARTBEAT_INTERVAL_MS) {
+  const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+  let stopped = false;
+  const beat = async () => {
+    if (stopped) return;
+    const payload = { pid, startedAt, ts: Date.now() };
+    try {
+      await writeFileAtomic(file, `${JSON.stringify(payload)}
+`, {
+        mode: 384
+      });
+    } catch {
+    }
+  };
+  void beat();
+  const timer = setInterval(() => {
+    void beat();
+  }, intervalMs);
+  timer.unref?.();
+  return {
+    stop() {
+      stopped = true;
+      clearInterval(timer);
+    }
+  };
+}
+
 // src/cli/commands/run.ts
 var DEBOUNCE_MS = 600;
 async function ensureBotProfile(store, options) {
@@ -5520,6 +5588,11 @@ async function startBridgeEngine(options) {
   larkChannel = bridge.channel;
   await notifyServer.start();
   process.env.DSH_LARK_NOTIFY_URL = notifyServer.url ?? "";
+  const heartbeat = startHeartbeat(
+    paths.profilePath(profileName, "guardian", "heartbeat.json"),
+    process.pid,
+    env.heartbeatMs
+  );
   const startedAt = (/* @__PURE__ */ new Date()).toISOString();
   log.info("cli", "started", {
     profile: profileName,
@@ -5544,6 +5617,7 @@ async function startBridgeEngine(options) {
     stop: async () => {
       if (stopped) return;
       stopped = true;
+      heartbeat.stop();
       await notifyServer.stop();
       await bridge.disconnect();
       await adapter.dispose?.();