@agentvault/secure-channel 0.6.18 → 0.6.20

package/dist/channel.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "node:events";
-import type { SecureChannelConfig, ChannelState } from "./types.js";
+import type { SecureChannelConfig, ChannelState, SendOptions, DecisionRequest, DecisionResponse } from "./types.js";
 export declare class SecureChannel extends EventEmitter {
     private config;
     private _state;
@@ -44,9 +44,26 @@ export declare class SecureChannel extends EventEmitter {
      * Encrypt and send a message to ALL owner devices (fanout).
      * Each session gets the same plaintext encrypted independently.
      */
-    send(plaintext: string, options?: {
-        topicId?: string;
-    }): Promise<void>;
+    send(plaintext: string, options?: SendOptions): Promise<void>;
+    /**
+     * Send a typing indicator to all owner devices.
+     * 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>;
     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

@@ -45282,6 +45282,10 @@ var init_channel = __esm({
           throw new Error("No active sessions");
         }
         const topicId = options?.topicId ?? this._persisted?.defaultTopicId;
+        const messageType = options?.messageType ?? "text";
+        const priority = options?.priority ?? "normal";
+        const parentSpanId = options?.parentSpanId;
+        const envelopeMetadata = options?.metadata;
         this._appendHistory("agent", plaintext, topicId);
         const messageGroupId = randomUUID();
         for (const [convId, session] of this._sessions) {
@@ -45304,7 +45308,11 @@ var init_channel = __esm({
                   header_blob: msg.headerBlob,
                   ciphertext: msg.ciphertext,
                   message_group_id: msg.messageGroupId,
-                  topic_id: msg.topicId
+                  topic_id: msg.topicId,
+                  message_type: messageType,
+                  priority,
+                  parent_span_id: parentSpanId,
+                  metadata: envelopeMetadata
                 }
               })
             );
@@ -45322,6 +45330,86 @@ var init_channel = __esm({
         }
         await this._persistState();
       }
+      /**
+       * Send a typing indicator to all owner devices.
+       * Ephemeral (unencrypted metadata), no ratchet advancement.
+       */
+      sendTyping() {
+        if (!this._ws || this._ws.readyState !== WebSocket.OPEN) return;
+        for (const convId of this._sessions.keys()) {
+          this._ws.send(
+            JSON.stringify({
+              event: "typing",
+              data: { conversation_id: convId }
+            })
+          );
+        }
+      }
+      /**
+       * 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);
+          }
+        });
+      }
       async stop() {
         this._stopped = true;
         this._flushAcks();
@@ -45804,7 +45892,12 @@ ${messageText}`;
             conversationId: convId,
             timestamp: msgData.created_at,
             topicId,
-            attachment: attachData
+            attachment: attachData,
+            spanId: msgData.span_id,
+            parentSpanId: msgData.parent_span_id,
+            messageType: msgData.message_type ?? "text",
+            priority: msgData.priority ?? "normal",
+            envelopeVersion: msgData.envelope_version ?? "1.0.0"
           };
           this.emit("message", emitText, metadata);
           this.config.onMessage?.(emitText, metadata);
@@ -46490,7 +46583,7 @@ async function runSetupCommand(options) {
 }
 function installPlugin(env) {
   try {
-    const info = execSync("openclaw plugins info secure-channel", {
+    const info = execSync("openclaw plugins info agentvault", {
       stdio: "pipe",
       env
     });
@@ -46499,7 +46592,7 @@ function installPlugin(env) {
     const installedVersion = versionMatch?.[1];
     if (installedVersion && installedVersion !== VERSION) {
       console.log(`  Updating plugin ${installedVersion} \u2192 ${VERSION}...`);
-      spawnSync("openclaw", ["plugins", "uninstall", "secure-channel"], {
+      spawnSync("openclaw", ["plugins", "uninstall", "agentvault"], {
         stdio: "pipe",
         input: "y\n",
         env