hiloop-sdk 0.5.5 → 0.7.0

package/dist/client.d.ts

@@ -268,7 +268,9 @@ export declare class HiloopClient {
      * Send a message in a conv session. Accepts plaintext — encrypts automatically
      * using the session message key (`{agentPub}:{AES-GCM ciphertext}` format).
      */
-    sendConvSessionMessage(sessionId: string, content: string): Promise<ConvSessionMessage>;
+    sendConvSessionMessage(sessionId: string, content: string, opts?: {
+        agentName?: string;
+    }): Promise<ConvSessionMessage>;
     /** Send a typing indicator to a conv session (HU-034). */
     sendConvSessionTyping(sessionId: string, typing: boolean): Promise<void>;
     /** Edit a previously sent conv session message. */
@@ -840,6 +842,17 @@ export declare class HiloopClient {
     }>;
     /** Decrypt an encrypted session message (e.g., from a webhook payload). */
     decryptSessionMessage(encryptedContent: string): Promise<string | null>;
+    /**
+     * Decrypt an interaction webhook payload in place.
+     * Decrypts encryptedTitle, encryptedResponse, encryptedComment using contentWrappings.
+     * Returns the payload with added `title`, `response`, `comment` fields.
+     */
+    decryptWebhookPayload<T extends Record<string, unknown>>(payload: T): Promise<T & {
+        title?: string;
+        response?: string;
+        comment?: string;
+        content?: string;
+    }>;
     static generateKeyPair(): KeyPair;
     /** Encrypt plaintext with AES-256-GCM for session messages. */
     static encryptAes(plaintext: string, keyBase64: string): Promise<string>;

package/dist/client.js

@@ -87,13 +87,14 @@ export class HiloopClient {
         this.initialized = true;
     }
     /** Raw HTTP request without triggering auto-init (used during init itself). */
-    buildHeaders() {
+    buildHeaders(agentName) {
         const h = {
             "Content-Type": "application/json",
             "X-API-Key": this.apiKey,
         };
-        if (this.options.agentName)
-            h["X-Agent"] = this.options.agentName;
+        const agent = agentName ?? this.options.agentName;
+        if (agent)
+            h["X-Agent"] = agent;
         return h;
     }
     async rawRequest(method, path, options) {
@@ -164,7 +165,7 @@ export class HiloopClient {
         try {
             const res = await fetch(url, {
                 method,
-                headers: this.buildHeaders(),
+                headers: this.buildHeaders(options?.agentName),
                 body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,
                 signal: controller.signal,
             });
@@ -551,10 +552,10 @@ export class HiloopClient {
      * Send a message in a conv session. Accepts plaintext — encrypts automatically
      * using the session message key (`{agentPub}:{AES-GCM ciphertext}` format).
      */
-    async sendConvSessionMessage(sessionId, content) {
+    async sendConvSessionMessage(sessionId, content, opts) {
         await this.ensureInitialized();
         const encryptedContent = await this.crypto.encryptSessionMessage(content);
-        const data = await this.request("POST", `/agent/sessions/${sessionId}/messages`, { body: { encryptedContent } });
+        const data = await this.request("POST", `/agent/sessions/${sessionId}/messages`, { body: { encryptedContent }, agentName: opts?.agentName });
         return parseConvSessionMessage(data);
     }
     /** Send a typing indicator to a conv session (HU-034). */
@@ -1236,6 +1237,33 @@ export class HiloopClient {
         await this.ensureInitialized();
         return this.crypto.decryptSessionMessage(encryptedContent);
     }
+    /**
+     * Decrypt an interaction webhook payload in place.
+     * Decrypts encryptedTitle, encryptedResponse, encryptedComment using contentWrappings.
+     * Returns the payload with added `title`, `response`, `comment` fields.
+     */
+    async decryptWebhookPayload(payload) {
+        await this.ensureInitialized();
+        const result = { ...payload };
+        const wrappings = payload.contentWrappings;
+        // Session message
+        if (typeof payload.encryptedContent === "string") {
+            const plain = await this.crypto.decryptSessionMessage(payload.encryptedContent);
+            if (plain !== null)
+                result.content = plain;
+        }
+        // Interaction fields (need content wrappings)
+        if (wrappings?.length) {
+            for (const [encrypted, decrypted] of [["encryptedTitle", "title"], ["encryptedResponse", "response"], ["encryptedComment", "comment"]]) {
+                if (typeof payload[encrypted] === "string") {
+                    const plain = await this.crypto.decryptWrappedContent(payload[encrypted], wrappings);
+                    if (plain !== null)
+                        result[decrypted] = plain;
+                }
+            }
+        }
+        return result;
+    }
     // -- Crypto -----------------------------------------------------------------
     static generateKeyPair() {
         return generateKeyPair();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiloop-sdk",
-  "version": "0.5.5",
+  "version": "0.7.0",
   "description": "TypeScript SDK for Hiloop — zero-trust human-AI agent interaction platform",
   "type": "module",
   "main": "dist/index.js",