@agentvault/secure-channel 0.6.19 → 0.6.21

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { SecureChannel } from "./channel.js";
-export type { SecureChannelConfig, ChannelState, MessageMetadata, AttachmentData, PersistedState, LegacyPersistedState, DeviceSession, HistoryEntry, SendOptions, } from "./types.js";
+export type { SecureChannelConfig, ChannelState, MessageMetadata, AttachmentData, PersistedState, LegacyPersistedState, DeviceSession, HistoryEntry, SendOptions, DecisionOption, DecisionRequest, DecisionResponse, ContextRef, HeartbeatStatus, StatusAlert, } from "./types.js";
 export { agentVaultPlugin, setOcRuntime, getActiveChannel } from "./openclaw-plugin.js";
 export declare const VERSION = "0.6.13";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExF,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExF,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/dist/index.js

@@ -45120,6 +45120,9 @@ var SecureChannel = class _SecureChannel extends EventEmitter {
   _persisted = null;
   _httpServer = null;
   _pollFallbackTimer = null;
+  _heartbeatTimer = null;
+  _heartbeatCallback = null;
+  _heartbeatIntervalSeconds = 0;
   _syncMessageIds = null;
   // Liveness detection: server sends app-level {"event":"ping"} every 30s.
   // We check every 30s; if no data received in 90s (3 missed pings), connection is dead.
@@ -45276,8 +45279,139 @@ var SecureChannel = class _SecureChannel extends EventEmitter {
       );
     }
   }
+  /**
+   * Send a decision request to the owner.
+   * Builds a structured envelope with decision metadata and sends it
+   * as a high-priority message. Returns the generated decision_id.
+   */
+  async sendDecisionRequest(request) {
+    const decision_id = `dec_${randomUUID().replace(/-/g, "").slice(0, 16)}`;
+    const payload = JSON.stringify({
+      type: "message",
+      text: `\u{1F4CB} ${request.title}`,
+      decision: {
+        decision_id,
+        ...request
+      }
+    });
+    await this.send(payload, {
+      messageType: "decision_request",
+      priority: "high",
+      metadata: {
+        decision_id,
+        title: request.title,
+        description: request.description,
+        options: request.options,
+        context_refs: request.context_refs,
+        deadline: request.deadline,
+        auto_action: request.auto_action
+      }
+    });
+    return decision_id;
+  }
+  /**
+   * Wait for a decision response matching the given decisionId.
+   * Listens on the "message" event for messages where
+   * metadata.messageType === "decision_response" and the parsed plaintext
+   * contains a matching decision.decision_id.
+   * Optional timeout rejects with an Error.
+   */
+  waitForDecision(decisionId, timeoutMs) {
+    return new Promise((resolve2, reject) => {
+      let timer = null;
+      const handler = (plaintext, metadata) => {
+        if (metadata.messageType !== "decision_response") return;
+        try {
+          const parsed = JSON.parse(plaintext);
+          if (parsed.decision?.decision_id === decisionId) {
+            if (timer) clearTimeout(timer);
+            this.removeListener("message", handler);
+            resolve2({
+              decision_id: parsed.decision.decision_id,
+              selected_option_id: parsed.decision.selected_option_id,
+              resolved_at: parsed.decision.resolved_at
+            });
+          }
+        } catch {
+        }
+      };
+      this.on("message", handler);
+      if (timeoutMs !== void 0) {
+        timer = setTimeout(() => {
+          this.removeListener("message", handler);
+          reject(new Error(`Decision ${decisionId} timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+      }
+    });
+  }
+  startHeartbeat(intervalSeconds, statusCallback) {
+    this.stopHeartbeat();
+    this._heartbeatCallback = statusCallback;
+    this._heartbeatIntervalSeconds = intervalSeconds;
+    this._sendHeartbeat();
+    this._heartbeatTimer = setInterval(() => {
+      this._sendHeartbeat();
+    }, intervalSeconds * 1e3);
+  }
+  async stopHeartbeat() {
+    if (this._heartbeatTimer) {
+      clearInterval(this._heartbeatTimer);
+      this._heartbeatTimer = null;
+    }
+    if (this._heartbeatCallback && this._state === "ready") {
+      try {
+        await this.send(
+          JSON.stringify({
+            agent_status: "shutting_down",
+            current_task: "",
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          }),
+          {
+            messageType: "heartbeat",
+            metadata: { next_heartbeat_seconds: this._heartbeatIntervalSeconds }
+          }
+        );
+      } catch {
+      }
+    }
+    this._heartbeatCallback = null;
+  }
+  async sendStatusAlert(alert) {
+    const priority = alert.severity === "error" || alert.severity === "critical" ? "high" : "normal";
+    await this.send(
+      JSON.stringify({
+        title: alert.title,
+        message: alert.message,
+        severity: alert.severity,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      }),
+      {
+        messageType: "status_alert",
+        priority,
+        metadata: { severity: alert.severity }
+      }
+    );
+  }
+  _sendHeartbeat() {
+    if (this._state !== "ready" || !this._heartbeatCallback) return;
+    const status = this._heartbeatCallback();
+    this.send(
+      JSON.stringify({
+        agent_status: status.agent_status,
+        current_task: status.current_task,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      }),
+      {
+        messageType: "heartbeat",
+        metadata: { next_heartbeat_seconds: this._heartbeatIntervalSeconds }
+      }
+    ).catch((err) => {
+      this.emit("error", new Error(`Heartbeat send failed: ${err}`));
+    });
+  }
   async stop() {
     this._stopped = true;
+    await this.stopHeartbeat();
     this._flushAcks();
     this._stopPing();
     this._stopPollFallback();