@agentvault/secure-channel 0.6.25 → 0.7.0

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, DecisionOption, DecisionRequest, DecisionResponse, ContextRef, HeartbeatStatus, StatusAlert, RoomInfo, RoomMemberInfo, RoomConversationInfo, RoomState, } from "./types.js";
+export type { SecureChannelConfig, ChannelState, MessageMetadata, AttachmentData, PersistedState, LegacyPersistedState, DeviceSession, HistoryEntry, SendOptions, DecisionOption, DecisionRequest, DecisionResponse, ContextRef, HeartbeatStatus, StatusAlert, RoomInfo, RoomMemberInfo, RoomConversationInfo, RoomState, A2AChannel, A2AMessage, } 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,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,SAAS,GACV,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,EACX,QAAQ,EACR,cAAc,EACd,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,UAAU,GACX,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

@@ -45234,20 +45234,24 @@ var SecureChannel = class _SecureChannel extends EventEmitter {
         topicId
       };
       if (this._state === "ready" && this._ws) {
+        const payload = {
+          conversation_id: msg.convId,
+          header_blob: msg.headerBlob,
+          ciphertext: msg.ciphertext,
+          message_group_id: msg.messageGroupId,
+          topic_id: msg.topicId,
+          message_type: messageType,
+          priority,
+          parent_span_id: parentSpanId,
+          metadata: envelopeMetadata
+        };
+        if (this._persisted?.hubAddress) {
+          payload.hub_address = this._persisted.hubAddress;
+        }
         this._ws.send(
           JSON.stringify({
             event: "message",
-            data: {
-              conversation_id: msg.convId,
-              header_blob: msg.headerBlob,
-              ciphertext: msg.ciphertext,
-              message_group_id: msg.messageGroupId,
-              topic_id: msg.topicId,
-              message_type: messageType,
-              priority,
-              parent_span_id: parentSpanId,
-              metadata: envelopeMetadata
-            }
+            data: payload
           })
         );
       } else {
@@ -45777,6 +45781,130 @@ var SecureChannel = class _SecureChannel extends EventEmitter {
     await this._persistState();
     return topics;
   }
+  // --- A2A Channel methods (agent-to-agent communication) ---
+  /**
+   * Request a new A2A channel with another agent by their hub address.
+   * Returns the channel_id from the server response.
+   */
+  async requestA2AChannel(responderHubAddress) {
+    if (!this._persisted?.hubAddress) {
+      throw new Error("This agent does not have a hub address assigned");
+    }
+    if (!this._deviceJwt) {
+      throw new Error("Channel not authenticated");
+    }
+    const res = await fetch(`${this.config.apiUrl}/api/v1/a2a/channels/request`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this._deviceJwt}`
+      },
+      body: JSON.stringify({
+        initiator_hub_address: this._persisted.hubAddress,
+        responder_hub_address: responderHubAddress
+      })
+    });
+    if (!res.ok) {
+      const detail = await res.text();
+      throw new Error(`A2A channel request failed (${res.status}): ${detail}`);
+    }
+    const resp = await res.json();
+    const channelId = resp.channel_id || resp.id;
+    if (!this._persisted.a2aChannels) {
+      this._persisted.a2aChannels = {};
+    }
+    this._persisted.a2aChannels[channelId] = {
+      channelId,
+      hubAddress: responderHubAddress,
+      conversationId: resp.conversation_id || ""
+    };
+    await this._persistState();
+    return channelId;
+  }
+  /**
+   * Send a message to another agent via an active A2A channel.
+   * Looks up the A2A conversation by hub address and sends via WS.
+   *
+   * NOTE: Currently sends plaintext over the WS (server-side relay).
+   * Full E2E encryption (X3DH + Double Ratchet per A2A session) will be
+   * added when the A2A ratchet activation flow is implemented.
+   */
+  async sendToAgent(hubAddress, text, opts) {
+    if (!this._persisted?.a2aChannels) {
+      throw new Error("No A2A channels established");
+    }
+    const channelEntry = Object.values(this._persisted.a2aChannels).find(
+      (ch) => ch.hubAddress === hubAddress
+    );
+    if (!channelEntry) {
+      throw new Error(`No A2A channel found for hub address: ${hubAddress}`);
+    }
+    if (!channelEntry.conversationId) {
+      throw new Error(`A2A channel ${channelEntry.channelId} does not have a conversation yet (not activated)`);
+    }
+    if (this._state !== "ready" || !this._ws) {
+      throw new Error("Channel is not connected");
+    }
+    const payload = {
+      conversation_id: channelEntry.conversationId,
+      plaintext: text,
+      message_type: "a2a",
+      parent_span_id: opts?.parentSpanId
+    };
+    if (this._persisted.hubAddress) {
+      payload.hub_address = this._persisted.hubAddress;
+    }
+    this._ws.send(
+      JSON.stringify({
+        event: "a2a_message",
+        data: payload
+      })
+    );
+  }
+  /**
+   * List all A2A channels for this agent.
+   * Fetches from the server and updates local persisted state.
+   */
+  async listA2AChannels() {
+    if (!this._deviceJwt) {
+      throw new Error("Channel not authenticated");
+    }
+    const res = await fetch(`${this.config.apiUrl}/api/v1/a2a/channels`, {
+      headers: {
+        Authorization: `Bearer ${this._deviceJwt}`
+      }
+    });
+    if (!res.ok) {
+      const detail = await res.text();
+      throw new Error(`List A2A channels failed (${res.status}): ${detail}`);
+    }
+    const resp = await res.json();
+    const channels = resp.map((ch) => ({
+      channelId: ch.channel_id || ch.id,
+      initiatorHubAddress: ch.initiator_hub_address,
+      responderHubAddress: ch.responder_hub_address,
+      conversationId: ch.conversation_id,
+      status: ch.status,
+      createdAt: ch.created_at
+    }));
+    if (this._persisted) {
+      if (!this._persisted.a2aChannels) {
+        this._persisted.a2aChannels = {};
+      }
+      for (const ch of channels) {
+        if (ch.status === "active" || ch.status === "approved") {
+          const otherAddress = ch.initiatorHubAddress === this._persisted.hubAddress ? ch.responderHubAddress : ch.initiatorHubAddress;
+          this._persisted.a2aChannels[ch.channelId] = {
+            channelId: ch.channelId,
+            hubAddress: otherAddress,
+            conversationId: ch.conversationId || ""
+          };
+        }
+      }
+      await this._persistState();
+    }
+    return channels;
+  }
   // --- Internal lifecycle ---
   async _enroll() {
     this._setState("enrolling");
@@ -46029,6 +46157,62 @@ var SecureChannel = class _SecureChannel extends EventEmitter {
         if (data.event === "policy_rejected") {
           this.emit("policy_rejected", data.data);
         }
+        if (data.event === "hub_identity_assigned") {
+          if (this._persisted) {
+            this._persisted.hubAddress = data.data.hub_address;
+            this._persistState();
+          }
+          this.emit("hub_identity_assigned", data.data);
+        }
+        if (data.event === "hub_identity_removed") {
+          if (this._persisted) {
+            delete this._persisted.hubAddress;
+            this._persistState();
+          }
+          this.emit("hub_identity_removed", data.data);
+        }
+        if (data.event === "a2a_channel_approved") {
+          const channelData = data.data || data;
+          const channelId = channelData.channel_id;
+          const convId = channelData.conversation_id;
+          if (this._persisted && convId) {
+            if (!this._persisted.a2aChannels) this._persisted.a2aChannels = {};
+            this._persisted.a2aChannels[channelId] = {
+              channelId,
+              hubAddress: "",
+              conversationId: convId
+            };
+            await this._persistState();
+          }
+          this.emit("a2a_channel_approved", channelData);
+        }
+        if (data.event === "a2a_channel_rejected") {
+          this.emit("a2a_channel_rejected", data.data || data);
+        }
+        if (data.event === "a2a_channel_revoked") {
+          const channelData = data.data || data;
+          const channelId = channelData.channel_id;
+          if (this._persisted?.a2aChannels?.[channelId]) {
+            delete this._persisted.a2aChannels[channelId];
+            await this._persistState();
+          }
+          this.emit("a2a_channel_revoked", channelData);
+        }
+        if (data.event === "a2a_message") {
+          const msgData = data.data || data;
+          const a2aMsg = {
+            text: msgData.plaintext || msgData.text,
+            fromHubAddress: msgData.from_hub_address || msgData.hub_address || "",
+            channelId: msgData.channel_id || "",
+            conversationId: msgData.conversation_id || "",
+            parentSpanId: msgData.parent_span_id,
+            timestamp: msgData.timestamp || (/* @__PURE__ */ new Date()).toISOString()
+          };
+          this.emit("a2a_message", a2aMsg);
+          if (this.config.onA2AMessage) {
+            this.config.onA2AMessage(a2aMsg);
+          }
+        }
       } catch (err) {
         this.emit("error", err);
       }