@coffeexdev/openclaw-sentinel 0.5.0 → 0.5.1

package/README.md

@@ -146,7 +146,7 @@ Use `sentinel_control`:
 1. Sentinel evaluates conditions.
 2. On match, it dispatches a generic callback envelope (`type: "sentinel.callback"`) to `localDispatchBase + webhookPath`.
 3. The envelope includes stable keys (`intent`, `context`, `watcher`, `trigger`, bounded `payload`, `deliveryTargets`, `deliveryContext`, `source`) so downstream agent behavior is workflow-agnostic.
-4. For `/hooks/sentinel`, Sentinel enqueues an instruction-prefixed system event plus structured JSON envelope and requests heartbeat wake.
+4. For `/hooks/sentinel`, Sentinel enqueues an instruction-prefixed system event plus structured JSON envelope with a cron-tagged callback context, then requests an immediate `cron:sentinel-callback` wake (avoids heartbeat-poll prompting).
 5. The hook route creates a **response-delivery contract** keyed by callback dedupe key, preserving original chat/session context (`deliveryContext`) and intended relay targets.
 6. OpenClaw processes each callback in an isolated hook session: per-watcher by default, or grouped when `hookSessionGroup` / `fire.sessionGroup` is set. Shared global hook-session mode is intentionally not supported.
 7. When hook-session LLM output arrives, Sentinel relays assistant-authored text to the original chat context. If no assistant output arrives before `hookResponseTimeoutMs`, optional fallback relay behavior is applied (`hookResponseFallbackMode`).

package/dist/index.js

@@ -11,6 +11,9 @@ const DEFAULT_HOOK_RESPONSE_FALLBACK_MODE = "concise";
 const MAX_SENTINEL_WEBHOOK_BODY_BYTES = 64 * 1024;
 const MAX_SENTINEL_WEBHOOK_TEXT_CHARS = 8000;
 const MAX_SENTINEL_PAYLOAD_JSON_CHARS = 2500;
+const SENTINEL_CALLBACK_WAKE_REASON = "cron:sentinel-callback";
+const SENTINEL_CALLBACK_CONTEXT_KEY = "cron:sentinel-callback";
+const HEARTBEAT_ACK_TOKEN_PATTERN = /\bHEARTBEAT_OK\b/gi;
 const SENTINEL_EVENT_INSTRUCTION_PREFIX = "SENTINEL_TRIGGER: This system event came from /hooks/sentinel. Evaluate action policy, decide whether to notify configured deliveryTargets, and execute safe follow-up actions.";
 const SUPPORTED_DELIVERY_CHANNELS = new Set([
     "telegram",
@@ -303,12 +306,16 @@ function buildRelayMessage(envelope) {
     if (contextSummary)
         lines.push(contextSummary);
     const text = lines.join("\n").trim();
-    return text.length > 0 ? text : "Sentinel callback received.";
+    return text.length > 0
+        ? text
+        : "Sentinel callback received, but no assistant detail was generated.";
 }
 function normalizeAssistantRelayText(assistantTexts) {
     if (!Array.isArray(assistantTexts) || assistantTexts.length === 0)
         return undefined;
-    const parts = assistantTexts.map((value) => value.trim()).filter(Boolean);
+    const parts = assistantTexts
+        .map((value) => value.replace(HEARTBEAT_ACK_TOKEN_PATTERN, "").trim())
+        .filter(Boolean);
     if (parts.length === 0)
         return undefined;
     return trimText(parts.join("\n\n"), MAX_SENTINEL_WEBHOOK_TEXT_CHARS);
@@ -658,9 +665,12 @@ export function createSentinelPlugin(overrides) {
                             const envelope = buildSentinelEventEnvelope(payload);
                             const sessionKey = buildIsolatedHookSessionKey(envelope, config);
                             const text = buildSentinelSystemEvent(envelope);
-                            const enqueued = api.runtime.system.enqueueSystemEvent(text, { sessionKey });
+                            const enqueued = api.runtime.system.enqueueSystemEvent(text, {
+                                sessionKey,
+                                contextKey: SENTINEL_CALLBACK_CONTEXT_KEY,
+                            });
                             api.runtime.system.requestHeartbeatNow({
-                                reason: "hook:sentinel",
+                                reason: SENTINEL_CALLBACK_WAKE_REASON,
                                 sessionKey,
                             });
                             const relayTargets = inferRelayTargets(payload, envelope);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffeexdev/openclaw-sentinel",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Secure declarative gateway-native watcher plugin for OpenClaw",
   "keywords": [
     "openclaw",