@agentvault/secure-channel 0.6.19 → 0.6.21

package/dist/channel.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import type { SecureChannelConfig, ChannelState, SendOptions } from "./types.js";
+import type { SecureChannelConfig, ChannelState, SendOptions, DecisionRequest, DecisionResponse, HeartbeatStatus, StatusAlert } from "./types.js";
 export declare class SecureChannel extends EventEmitter {
     private config;
     private _state;
@@ -20,6 +20,9 @@ export declare class SecureChannel extends EventEmitter {
     private _persisted;
     private _httpServer;
     private _pollFallbackTimer;
+    private _heartbeatTimer;
+    private _heartbeatCallback;
+    private _heartbeatIntervalSeconds;
     private _syncMessageIds;
     private static readonly PING_INTERVAL_MS;
     private static readonly SILENCE_TIMEOUT_MS;
@@ -50,6 +53,24 @@ export declare class SecureChannel extends EventEmitter {
      * Ephemeral (unencrypted metadata), no ratchet advancement.
      */
     sendTyping(): void;
+    /**
+     * 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.
+     */
+    sendDecisionRequest(request: DecisionRequest): Promise<string>;
+    /**
+     * 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: string, timeoutMs?: number): Promise<DecisionResponse>;
+    startHeartbeat(intervalSeconds: number, statusCallback: () => HeartbeatStatus): void;
+    stopHeartbeat(): Promise<void>;
+    sendStatusAlert(alert: StatusAlert): Promise<void>;
+    private _sendHeartbeat;
     stop(): Promise<void>;
     startHttpServer(port: number): void;
     private _stopHttpServer;

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -45189,6 +45189,9 @@ var init_channel = __esm({
       _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.
@@ -45345,8 +45348,139 @@ var init_channel = __esm({
           );
         }
       }
+      /**
+       * 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((resolve3, 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);
+                resolve3({
+                  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();