echoclaw-relay-agent 0.27.0 → 0.28.0

package/dist/RelayAgent.d.ts

@@ -48,6 +48,14 @@ export declare class RelayAgent extends EventEmitter {
      * Returns an unsubscribe function.
      */
     subscribe(event: string, cb: (payload: unknown) => void): () => void;
+    /**
+     * Send a raw (unencrypted) message through the transport.
+     * Used by MobileDispatcher to send MOBILE_DATA replies to relay-server.
+     * Does NOT go through E2E encryption — only for mobile companion protocol.
+     */
+    sendRaw(msg: object): void;
+    /** Get current session ID (pairingId). Used by MobileDispatcher. */
+    getSessionId(): string;
     /** Manual restart of OpenClaw process. Bypasses watchdog rate limit. */
     manualRestart(): Promise<{
         success: boolean;

package/dist/chat/ChatHandler.d.ts

@@ -30,6 +30,8 @@
  *   - chat_user_echo: user message from external port (Feishu/WeChat/Web)
  */
 import { OpenClawWsClient } from '../gateway/OpenClawWsClient.js';
+import { StatusInferenceEngine } from '@echoclaw/claw-engine';
+import { HeartbeatScheduler } from './HeartbeatScheduler.js';
 export interface ChatMessage {
     type: string;
     [key: string]: unknown;
@@ -108,6 +110,10 @@ export declare class ChatHandler {
     private _workspaceReader;
     /** RunIds for which task_ack has already been sent (prevents duplicate sends on accumulated deltas). */
     private _taskAckSentRuns;
+    /** Status inference engine — produces activity states and heartbeats for Desktop. */
+    private readonly _statusEngine;
+    /** Heartbeat scheduler — manages periodic heartbeat emission per run. */
+    private readonly _heartbeatScheduler;
     constructor(config?: ChatHandlerConfig);
     /** Expose the underlying WS client for event listening. */
     get client(): OpenClawWsClient;
@@ -245,4 +251,8 @@ export declare class ChatHandler {
      * won't null it between the check and the call.
      */
     private _sendVia;
+    /** Expose the status engine so InstallHandler can share it. */
+    get statusEngine(): StatusInferenceEngine;
+    /** Expose the heartbeat scheduler so InstallHandler can share it. */
+    get heartbeatScheduler(): HeartbeatScheduler;
 }

package/dist/chat/HeartbeatScheduler.d.ts

@@ -0,0 +1,37 @@
+/**
+ * HeartbeatScheduler — Manages periodic heartbeat emission for a run.
+ *
+ * Shared between ChatHandler and InstallHandler to avoid duplicated
+ * timer logic. Handles:
+ *   - Initial delay before first heartbeat
+ *   - Periodic interval emission
+ *   - Safety valve (max duration)
+ *   - Clean cancellation (no orphan timers on early stop)
+ *
+ * @since v0.28.0
+ */
+import { StatusInferenceEngine } from '@echoclaw/claw-engine';
+import type { TaskHeartbeat } from '@echoclaw/claw-engine';
+type EmitFn = (heartbeat: TaskHeartbeat) => void;
+export declare class HeartbeatScheduler {
+    private readonly _engine;
+    private readonly _emit;
+    private readonly _runs;
+    constructor(engine: StatusInferenceEngine, emit: EmitFn);
+    /**
+     * Start heartbeat tracking for a run.
+     * @param runId — OpenClaw run ID
+     * @param key — Map key for the timer (runId for chat, requestId for install)
+     * @param scope — 'chat' or 'install'
+     */
+    start(runId: string, key: string, scope: 'chat' | 'install'): void;
+    /** Stop heartbeat for a run and clean up engine state. */
+    stop(key: string): void;
+    /** Emit a final heartbeat and then stop. */
+    emitAndStop(runId: string, key: string, scope: 'chat' | 'install'): void;
+    /** Stop all active heartbeat timers. */
+    stopAll(): void;
+    /** Emit a single heartbeat for an entry. */
+    private _emitOne;
+}
+export {};