@better_openclaw/betterclaw 2.0.1 → 2.0.3

package/openclaw.plugin.json

@@ -42,6 +42,16 @@
         "minimum": 0,
         "maximum": 23,
         "description": "Hour (system timezone) for daily analysis run"
+      },
+      "deduplicationCooldowns": {
+        "type": "object",
+        "additionalProperties": { "type": "number" },
+        "description": "Per-subscription dedup cooldowns in seconds (e.g. {\"default.geofence\": 300})"
+      },
+      "defaultCooldown": {
+        "type": "number",
+        "default": 1800,
+        "description": "Default dedup cooldown in seconds for subscriptions not in deduplicationCooldowns"
       }
     },
     "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better_openclaw/betterclaw",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Intelligent event filtering, context tracking, and proactive triggers for BetterClaw",
   "license": "AGPL-3.0-only",
   "repository": {

package/src/filter.ts

@@ -1,21 +1,15 @@
 import type { DeviceContext, DeviceEvent, FilterDecision } from "./types.js";
 
-// Cooldowns in seconds
-const DEDUP_COOLDOWN: Record<string, number> = {
-  "default.battery-low": 3600,
-  "default.battery-critical": 1800,
-  "default.daily-health": 82800, // 23 hours
-  "default.geofence": 300,
-};
-
-const DEFAULT_COOLDOWN = 1800; // 30 minutes
-
 export class RulesEngine {
   private lastFired: Map<string, number> = new Map();
   private pushBudget: number;
+  private cooldowns: Record<string, number>;
+  private defaultCooldown: number;
 
-  constructor(pushBudget: number = 10) {
+  constructor(pushBudget: number = 10, cooldowns: Record<string, number> = {}, defaultCooldown: number = 1800) {
     this.pushBudget = pushBudget;
+    this.cooldowns = cooldowns;
+    this.defaultCooldown = defaultCooldown;
   }
 
   evaluate(event: DeviceEvent, context: DeviceContext, budgetOverride?: number): FilterDecision {
@@ -26,7 +20,7 @@ export class RulesEngine {
 
     // Dedup check
     const lastFiredAt = this.lastFired.get(event.subscriptionId);
-    const cooldown = DEDUP_COOLDOWN[event.subscriptionId] ?? DEFAULT_COOLDOWN;
+    const cooldown = this.cooldowns[event.subscriptionId] ?? this.defaultCooldown;
     if (lastFiredAt && event.firedAt - lastFiredAt < cooldown) {
       return {
         action: "drop",

package/src/index.ts

@@ -16,6 +16,13 @@ import * as path from "node:path";
 
 export type { PluginConfig } from "./types.js";
 
+const DEFAULT_COOLDOWNS: Record<string, number> = {
+  "default.battery-low": 3600,
+  "default.battery-critical": 1800,
+  "default.daily-health": 82800,
+  "default.geofence": 300,
+};
+
 const DEFAULT_CONFIG: PluginConfig = {
   triageModel: "openai/gpt-4o-mini",
   triageApiBase: undefined,
@@ -23,6 +30,8 @@ const DEFAULT_CONFIG: PluginConfig = {
   patternWindowDays: 14,
   proactiveEnabled: true,
   analysisHour: 5,
+  deduplicationCooldowns: DEFAULT_COOLDOWNS,
+  defaultCooldown: 1800,
 };
 
 function resolveConfig(raw: Record<string, unknown> | undefined): PluginConfig {
@@ -34,6 +43,13 @@ function resolveConfig(raw: Record<string, unknown> | undefined): PluginConfig {
     patternWindowDays: typeof cfg.patternWindowDays === "number" && cfg.patternWindowDays > 0 ? cfg.patternWindowDays : 14,
     proactiveEnabled: typeof cfg.proactiveEnabled === "boolean" ? cfg.proactiveEnabled : true,
     analysisHour: typeof cfg.analysisHour === "number" ? Math.max(0, Math.min(23, cfg.analysisHour)) : 5,
+    deduplicationCooldowns: {
+      ...DEFAULT_COOLDOWNS,
+      ...(typeof cfg.deduplicationCooldowns === "object" && cfg.deduplicationCooldowns !== null
+        ? cfg.deduplicationCooldowns as Record<string, number>
+        : {}),
+    },
+    defaultCooldown: typeof cfg.defaultCooldown === "number" && cfg.defaultCooldown > 0 ? cfg.defaultCooldown : 1800,
   };
 }
 
@@ -52,7 +68,7 @@ export default {
 
     // Event log, rules engine, reaction tracker
     const eventLog = new EventLog(stateDir);
-    const rules = new RulesEngine(config.pushBudgetPerDay);
+    const rules = new RulesEngine(config.pushBudgetPerDay, config.deduplicationCooldowns, config.defaultCooldown);
     const reactionTracker = new ReactionTracker(stateDir);
 
     // Pipeline dependencies

package/src/types.ts

@@ -127,6 +127,8 @@ export interface PluginConfig {
   patternWindowDays: number;
   proactiveEnabled: boolean;
   analysisHour: number;
+  deduplicationCooldowns: Record<string, number>;
+  defaultCooldown: number;
 }
 
 // Triage profile produced by daily learning agent