@better_openclaw/betterclaw 3.0.2 → 3.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better_openclaw/betterclaw",
-  "version": "3.0.2",
+  "version": "3.0.4",
   "description": "Intelligent event filtering, context tracking, and proactive triggers for BetterClaw",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -9,12 +9,17 @@
   },
   "type": "module",
   "openclaw": {
-    "extensions": ["./src/index.ts"]
+    "extensions": [
+      "./src/index.ts"
+    ]
   },
   "dependencies": {
     "@sinclair/typebox": "^0.34.0"
   },
   "devDependencies": {
+    "@types/node": "^25.5.2",
+    "openclaw": "^2026.4.5",
+    "typescript": "^6.0.2",
     "vitest": "^3.0.0"
   }
 }

package/src/context.ts

@@ -9,7 +9,7 @@ export class ContextManager {
   private contextPath: string;
   private patternsPath: string;
   private context: DeviceContext;
-  private runtimeState: RuntimeState = { tier: "free", smartMode: false };
+  private runtimeState: RuntimeState = { tier: null, smartMode: false };
   private timestamps: Record<string, number> = {};
   private deviceConfig: DeviceConfig = {};
 
@@ -44,6 +44,11 @@ export class ContextManager {
       const parsed = JSON.parse(raw);
       this.timestamps = parsed._timestamps ?? {};
       delete parsed._timestamps;
+      const savedTier = parsed._tier;
+      delete parsed._tier;
+      if (savedTier === "free" || savedTier === "premium") {
+        this.runtimeState = { ...this.runtimeState, tier: savedTier };
+      }
       this.context = parsed as DeviceContext;
     } catch {
       this.context = ContextManager.empty();
@@ -78,7 +83,7 @@ export class ContextManager {
 
   async save(): Promise<void> {
     await fs.mkdir(path.dirname(this.contextPath), { recursive: true });
-    const data = { ...this.context, _timestamps: this.timestamps };
+    const data = { ...this.context, _timestamps: this.timestamps, _tier: this.runtimeState.tier };
     await fs.writeFile(this.contextPath, JSON.stringify(data, null, 2) + "\n", "utf8");
     const configPath = path.join(path.dirname(this.contextPath), "device-config.json");
     await fs.writeFile(configPath, JSON.stringify(this.deviceConfig, null, 2) + "\n", "utf8");

package/src/index.ts

@@ -70,7 +70,6 @@ export default {
 
     // Calibration state
     let calibrationStartedAt: number | null = null;
-    let pingReceived = false;
 
     const calibrationFile = path.join(stateDir, "calibration.json");
     (async () => {
@@ -142,9 +141,9 @@ export default {
 
     // Ping health check
     api.registerGatewayMethod("betterclaw.ping", async ({ params, respond, context }) => {
-      const validTiers: Array<"free" | "premium" | "premium+"> = ["free", "premium", "premium+"];
+      const validTiers: Array<"free" | "premium"> = ["free", "premium"];
       const rawTier = (params as Record<string, unknown>)?.tier as string;
-      const tier = validTiers.includes(rawTier as any) ? (rawTier as "free" | "premium" | "premium+") : "free";
+      const tier = validTiers.includes(rawTier as any) ? (rawTier as "free" | "premium") : "free";
       const smartMode = (params as Record<string, unknown>)?.smartMode === true;
 
       const jwt = (params as Record<string, unknown>)?.jwt as string | undefined;
@@ -159,10 +158,8 @@ export default {
 
       ctxManager.setRuntimeState({ tier, smartMode });
 
-      pingReceived = true;
-
       // Initialize calibration on first premium ping
-      if ((tier === "premium" || tier === "premium+") && calibrationStartedAt === null) {
+      if (tier === "premium" && calibrationStartedAt === null) {
         const existingProfile = await loadTriageProfile(stateDir);
         if (existingProfile?.computedAt) {
           calibrationStartedAt = existingProfile.computedAt - config.calibrationDays * 86400;
@@ -365,7 +362,6 @@ export default {
     // Agent tools
     api.registerTool(
       createCheckTierTool(ctxManager, () => ({
-        pingReceived,
         calibrating: isCalibrating(),
         calibrationEndsAt: calibrationStartedAt
           ? calibrationStartedAt + config.calibrationDays * 86400
@@ -454,7 +450,7 @@ export default {
           if (ctxManager.getRuntimeState().smartMode) {
             // Scan reactions first (feeds into learner)
             try {
-              await scanPendingReactions({ reactions: reactionTracker, api, config, stateDir });
+              await scanPendingReactions({ reactions: reactionTracker, api });
             } catch (err) {
               api.logger.error(`betterclaw: reaction scan failed: ${err}`);
             }

package/src/jwt.ts

@@ -54,7 +54,7 @@ export async function verifyJwt(
     const valid = await crypto.subtle.verify(
       { name: "ECDSA", hash: "SHA-256" },
       publicKey,
-      signature,
+      signature as Uint8Array<ArrayBuffer>,
       signingInput
     );
     if (!valid) return null;

package/src/learner.ts

@@ -165,7 +165,7 @@ export async function runLearner(deps: RunLearnerDeps): Promise<void> {
     });
 
     // 11. Parse last assistant message — handle both string and content-block formats
-    const lastAssistant = messages.filter((m: any) => m.role === "assistant").pop();
+    const lastAssistant = (messages as any[]).filter((m) => m.role === "assistant").pop();
     if (lastAssistant) {
       const content = typeof lastAssistant.content === "string"
         ? lastAssistant.content

package/src/reaction-scanner.ts

@@ -17,9 +17,6 @@ export interface ClassificationResult {
 export interface ScanDeps {
   api: OpenClawPluginApi;
   reactions: ReactionTracker;
-  classificationModel: string;
-  classificationApiBase?: string;
-  getApiKey: () => Promise<string | undefined>;
 }
 
 // --- Helpers ---
@@ -151,7 +148,7 @@ export async function scanPendingReactions(deps: ScanDeps): Promise<void> {
       sessionKey: "main",
       limit: 200,
     });
-    messages = fetched;
+    messages = fetched as typeof messages;
   } catch (err) {
     api.logger.error(
       `reaction-scanner: failed to fetch session messages: ${err instanceof Error ? err.message : String(err)}`,
@@ -198,7 +195,7 @@ export async function scanPendingReactions(deps: ScanDeps): Promise<void> {
           limit: 5,
         });
 
-        const lastAssistant = classifyMessages.filter((m: any) => m.role === "assistant").pop();
+        const lastAssistant = (classifyMessages as any[]).filter((m) => m.role === "assistant").pop();
         if (lastAssistant) {
           const content = extractText(lastAssistant.content);
           if (content) {

package/src/tools/check-tier.ts

@@ -2,7 +2,6 @@ import { Type } from "@sinclair/typebox";
 import type { ContextManager } from "../context.js";
 
 export interface CheckTierState {
-  pingReceived: boolean;
   calibrating: boolean;
   calibrationEndsAt?: number;
 }
@@ -16,8 +15,9 @@ export function createCheckTierTool(ctx: ContextManager, getState: () => CheckTi
     parameters: Type.Object({}),
     async execute(_id: string, _params: Record<string, unknown>) {
       const state = getState();
+      const runtime = ctx.getRuntimeState();
 
-      if (!state.pingReceived) {
+      if (runtime.tier === null) {
         return {
           content: [{
             type: "text" as const,
@@ -28,13 +28,12 @@ export function createCheckTierTool(ctx: ContextManager, getState: () => CheckTi
               cacheInstruction: "Re-check in about a minute.",
             }, null, 2),
           }],
+          details: undefined,
         };
       }
-
-      const runtime = ctx.getRuntimeState();
       const cacheUntil = Math.floor(Date.now() / 1000) + 86400;
 
-      const isPremium = runtime.tier === "premium" || runtime.tier === "premium+";
+      const isPremium = runtime.tier === "premium";
 
       const dataPath = isPremium
         ? "Use node commands for current device readings: location.get, device.battery, health.steps, health.heartrate, health.hrv, health.sleep, health.distance, health.restinghr, health.workouts, health.summary, geofence.list. Use get_context for patterns, trends, history, and broad situational awareness — its device snapshot may not be perfectly recent but is useful for the big picture."
@@ -57,6 +56,7 @@ export function createCheckTierTool(ctx: ContextManager, getState: () => CheckTi
 
       return {
         content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }],
+        details: undefined,
       };
     },
   };

package/src/tools/get-context.ts

@@ -1,12 +1,39 @@
 import type { ContextManager } from "../context.js";
 import { loadTriageProfile } from "../learner.js";
 
+const STALE_THRESHOLD_S = 600; // 10 minutes
+
+/** Format seconds into human-readable age string */
+function formatAge(seconds: number): string {
+  if (seconds < 60) return `${Math.round(seconds)}s ago`;
+  if (seconds < 3600) return `${Math.round(seconds / 60)}m ago`;
+  if (seconds < 86400) return `${Math.round(seconds / 3600)}h ago`;
+  return `${Math.round(seconds / 86400)}d ago`;
+}
+
+/**
+ * On premium, stale device data (>10 min) is replaced with a pointer
+ * to the fresh node command. The agent can't shortcut to stale values.
+ */
+function deviceFieldOrPointer(
+  data: Record<string, unknown> | null,
+  ageSeconds: number | null,
+  freshCommand: string,
+  isPremium: boolean,
+): Record<string, unknown> | null {
+  if (!data) return null;
+  if (isPremium && ageSeconds != null && ageSeconds > STALE_THRESHOLD_S) {
+    return { stale: true, ageHuman: formatAge(ageSeconds), freshCommand };
+  }
+  return { ...data, dataAgeSeconds: ageSeconds };
+}
+
 export function createGetContextTool(ctx: ContextManager, stateDir?: string) {
   return {
     name: "get_context",
     label: "Get Device Context",
     description:
-      "Get BetterClaw context — patterns, trends, activity zone, event history, and cached device snapshots with staleness indicators. On premium, node commands return fresher data for current readings. On free, this includes the latest device snapshot.",
+      "Get BetterClaw context — patterns, trends, activity zone, and event history. On premium, stale device readings (>10 min) are hidden — use node commands (location.get, device.battery, health.*) for current data. On free, this includes the full device snapshot.",
     parameters: {},
     async execute(_id: string, _params: Record<string, unknown>) {
       const state = ctx.get();
@@ -20,22 +47,31 @@ export function createGetContextTool(ctx: ContextManager, stateDir?: string) {
         tierHint: {
           tier: runtime.tier,
           note: isPremium
-            ? "Node commands available for fresh readings (location.get, device.battery, health.*)"
+            ? "Node commands available for fresh readings (location.get, device.battery, health.*). Stale device data is hidden — call the node command instead."
             : "This is the only data source on free tier — check dataAgeSeconds for freshness",
         },
         smartMode: runtime.smartMode,
       };
 
       result.device = {
-        battery: state.device.battery
-          ? { ...state.device.battery, updatedAt: ctx.getTimestamp("battery"), dataAgeSeconds: dataAge.battery }
-          : null,
-        location: state.device.location
-          ? { ...state.device.location, updatedAt: ctx.getTimestamp("location"), dataAgeSeconds: dataAge.location }
-          : null,
-        health: state.device.health
-          ? { ...state.device.health, updatedAt: ctx.getTimestamp("health"), dataAgeSeconds: dataAge.health }
-          : null,
+        battery: deviceFieldOrPointer(
+          state.device.battery as unknown as Record<string, unknown>,
+          dataAge.battery,
+          "device.battery",
+          isPremium,
+        ),
+        location: deviceFieldOrPointer(
+          state.device.location as unknown as Record<string, unknown>,
+          dataAge.location,
+          "location.get",
+          isPremium,
+        ),
+        health: deviceFieldOrPointer(
+          state.device.health as unknown as Record<string, unknown>,
+          dataAge.health,
+          "health.summary",
+          isPremium,
+        ),
       };
 
       result.activity = { ...state.activity, updatedAt: ctx.getTimestamp("activity") };
@@ -53,6 +89,7 @@ export function createGetContextTool(ctx: ContextManager, stateDir?: string) {
 
       return {
         content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }],
+        details: undefined,
       };
     },
   };

package/src/types.ts

@@ -157,8 +157,7 @@ export interface DeviceConfig {
   proactiveEnabled?: boolean;
 }
 
-// Runtime state (not persisted)
 export interface RuntimeState {
-  tier: "free" | "premium" | "premium+";
+  tier: "free" | "premium" | null;
   smartMode: boolean;
 }