@voidly/agent-sdk 1.7.0 → 1.8.1

package/dist/index.d.mts

@@ -32,6 +32,7 @@ interface DecryptedMessage {
     to: string;
     content: string;
     contentType: string;
+    messageType: string;
     threadId: string | null;
     replyTo: string | null;
     signatureValid: boolean;
@@ -115,6 +116,7 @@ declare class VoidlyAgent {
         threadId?: string;
         replyTo?: string;
         ttl?: number;
+        messageType?: string;
     }): Promise<SendResult>;
     /**
      * Receive and decrypt messages. Decryption happens locally.
@@ -126,6 +128,7 @@ declare class VoidlyAgent {
         from?: string;
         threadId?: string;
         contentType?: string;
+        messageType?: string;
         unreadOnly?: boolean;
     }): Promise<DecryptedMessage[]>;
     /**
@@ -664,6 +667,45 @@ declare class VoidlyAgent {
         routed: boolean;
         destination: string;
     }>;
+    /** Send heartbeat — signals agent is alive, updates last_seen */
+    ping(): Promise<{
+        pong: boolean;
+        did: string;
+        status: string;
+        uptime: {
+            days: number;
+            hours: number;
+        };
+    }>;
+    /** Check if another agent is online (public) */
+    checkOnline(did: string): Promise<{
+        did: string;
+        online_status: 'online' | 'idle' | 'offline';
+        last_seen: string;
+        minutes_since_seen: number | null;
+    }>;
+    /** Pin another agent's public keys (Trust On First Use). Returns warning if keys changed since last pin. */
+    pinKeys(did: string): Promise<{
+        pinned: boolean;
+        key_changed: boolean;
+        status: string;
+        warning?: string;
+    }>;
+    /** List all pinned keys */
+    listPinnedKeys(options?: {
+        status?: string;
+    }): Promise<{
+        pins: any[];
+        total: number;
+    }>;
+    /** Verify an agent's keys against your pinned copy. Detects key changes (potential MitM). */
+    verifyKeys(did: string): Promise<{
+        did: string;
+        pinned: boolean;
+        verified?: boolean;
+        status: string;
+        warning?: string;
+    }>;
 }
 
 export { type AgentIdentity, type AgentProfile, type DecryptedMessage, type SendResult, VoidlyAgent, type VoidlyAgentConfig };

package/dist/index.d.ts

@@ -32,6 +32,7 @@ interface DecryptedMessage {
     to: string;
     content: string;
     contentType: string;
+    messageType: string;
     threadId: string | null;
     replyTo: string | null;
     signatureValid: boolean;
@@ -115,6 +116,7 @@ declare class VoidlyAgent {
         threadId?: string;
         replyTo?: string;
         ttl?: number;
+        messageType?: string;
     }): Promise<SendResult>;
     /**
      * Receive and decrypt messages. Decryption happens locally.
@@ -126,6 +128,7 @@ declare class VoidlyAgent {
         from?: string;
         threadId?: string;
         contentType?: string;
+        messageType?: string;
         unreadOnly?: boolean;
     }): Promise<DecryptedMessage[]>;
     /**
@@ -664,6 +667,45 @@ declare class VoidlyAgent {
         routed: boolean;
         destination: string;
     }>;
+    /** Send heartbeat — signals agent is alive, updates last_seen */
+    ping(): Promise<{
+        pong: boolean;
+        did: string;
+        status: string;
+        uptime: {
+            days: number;
+            hours: number;
+        };
+    }>;
+    /** Check if another agent is online (public) */
+    checkOnline(did: string): Promise<{
+        did: string;
+        online_status: 'online' | 'idle' | 'offline';
+        last_seen: string;
+        minutes_since_seen: number | null;
+    }>;
+    /** Pin another agent's public keys (Trust On First Use). Returns warning if keys changed since last pin. */
+    pinKeys(did: string): Promise<{
+        pinned: boolean;
+        key_changed: boolean;
+        status: string;
+        warning?: string;
+    }>;
+    /** List all pinned keys */
+    listPinnedKeys(options?: {
+        status?: string;
+    }): Promise<{
+        pins: any[];
+        total: number;
+    }>;
+    /** Verify an agent's keys against your pinned copy. Detects key changes (potential MitM). */
+    verifyKeys(did: string): Promise<{
+        did: string;
+        pinned: boolean;
+        verified?: boolean;
+        status: string;
+        warning?: string;
+    }>;
 }
 
 export { type AgentIdentity, type AgentProfile, type DecryptedMessage, type SendResult, VoidlyAgent, type VoidlyAgentConfig };

package/dist/index.js

@@ -2455,6 +2455,7 @@ var VoidlyAgent = class _VoidlyAgent {
         envelope: envelopeData,
         // Pass signed envelope so receiver can verify
         content_type: options.contentType || "text/plain",
+        message_type: options.messageType || "text",
         thread_id: options.threadId,
         reply_to: options.replyTo,
         ttl: options.ttl
@@ -2477,6 +2478,7 @@ var VoidlyAgent = class _VoidlyAgent {
     if (options.from) params.set("from", options.from);
     if (options.threadId) params.set("thread_id", options.threadId);
     if (options.contentType) params.set("content_type", options.contentType);
+    if (options.messageType) params.set("message_type", options.messageType);
     if (options.unreadOnly) params.set("unread", "true");
     const res = await fetch(`${this.baseUrl}/v1/agent/receive/raw?${params}`, {
       headers: { "X-Agent-Key": this.apiKey }
@@ -2519,6 +2521,7 @@ var VoidlyAgent = class _VoidlyAgent {
           to: msg.to,
           content: (0, import_tweetnacl_util.encodeUTF8)(plaintext),
           contentType: msg.content_type,
+          messageType: msg.message_type || "text",
           threadId: msg.thread_id,
           replyTo: msg.reply_to,
           signatureValid,
@@ -3481,6 +3484,52 @@ var VoidlyAgent = class _VoidlyAgent {
     if (!res.ok) throw new Error(`Route failed: ${res.status} ${await res.text()}`);
     return res.json();
   }
+  // ── Heartbeat ──────────────────────────────────────────────────────────────
+  /** Send heartbeat — signals agent is alive, updates last_seen */
+  async ping() {
+    const res = await fetch(`${this.baseUrl}/v1/agent/ping`, {
+      method: "POST",
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Ping failed: ${res.status}`);
+    return res.json();
+  }
+  /** Check if another agent is online (public) */
+  async checkOnline(did) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/ping/${encodeURIComponent(did)}`);
+    if (!res.ok) throw new Error(`Ping check failed: ${res.status}`);
+    return res.json();
+  }
+  // ── Key Pinning (TOFU) ────────────────────────────────────────────────────
+  /** Pin another agent's public keys (Trust On First Use). Returns warning if keys changed since last pin. */
+  async pinKeys(did) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/keys/pin`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({ did })
+    });
+    if (!res.ok) throw new Error(`Key pin failed: ${res.status}`);
+    return res.json();
+  }
+  /** List all pinned keys */
+  async listPinnedKeys(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    const res = await fetch(`${this.baseUrl}/v1/agent/keys/pins${qs}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`List pins failed: ${res.status}`);
+    return res.json();
+  }
+  /** Verify an agent's keys against your pinned copy. Detects key changes (potential MitM). */
+  async verifyKeys(did) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/keys/verify/${encodeURIComponent(did)}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Key verify failed: ${res.status}`);
+    return res.json();
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -2445,6 +2445,7 @@ var VoidlyAgent = class _VoidlyAgent {
         envelope: envelopeData,
         // Pass signed envelope so receiver can verify
         content_type: options.contentType || "text/plain",
+        message_type: options.messageType || "text",
         thread_id: options.threadId,
         reply_to: options.replyTo,
         ttl: options.ttl
@@ -2467,6 +2468,7 @@ var VoidlyAgent = class _VoidlyAgent {
     if (options.from) params.set("from", options.from);
     if (options.threadId) params.set("thread_id", options.threadId);
     if (options.contentType) params.set("content_type", options.contentType);
+    if (options.messageType) params.set("message_type", options.messageType);
     if (options.unreadOnly) params.set("unread", "true");
     const res = await fetch(`${this.baseUrl}/v1/agent/receive/raw?${params}`, {
       headers: { "X-Agent-Key": this.apiKey }
@@ -2509,6 +2511,7 @@ var VoidlyAgent = class _VoidlyAgent {
           to: msg.to,
           content: (0, import_tweetnacl_util.encodeUTF8)(plaintext),
           contentType: msg.content_type,
+          messageType: msg.message_type || "text",
           threadId: msg.thread_id,
           replyTo: msg.reply_to,
           signatureValid,
@@ -3471,6 +3474,52 @@ var VoidlyAgent = class _VoidlyAgent {
     if (!res.ok) throw new Error(`Route failed: ${res.status} ${await res.text()}`);
     return res.json();
   }
+  // ── Heartbeat ──────────────────────────────────────────────────────────────
+  /** Send heartbeat — signals agent is alive, updates last_seen */
+  async ping() {
+    const res = await fetch(`${this.baseUrl}/v1/agent/ping`, {
+      method: "POST",
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Ping failed: ${res.status}`);
+    return res.json();
+  }
+  /** Check if another agent is online (public) */
+  async checkOnline(did) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/ping/${encodeURIComponent(did)}`);
+    if (!res.ok) throw new Error(`Ping check failed: ${res.status}`);
+    return res.json();
+  }
+  // ── Key Pinning (TOFU) ────────────────────────────────────────────────────
+  /** Pin another agent's public keys (Trust On First Use). Returns warning if keys changed since last pin. */
+  async pinKeys(did) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/keys/pin`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({ did })
+    });
+    if (!res.ok) throw new Error(`Key pin failed: ${res.status}`);
+    return res.json();
+  }
+  /** List all pinned keys */
+  async listPinnedKeys(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    const res = await fetch(`${this.baseUrl}/v1/agent/keys/pins${qs}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`List pins failed: ${res.status}`);
+    return res.json();
+  }
+  /** Verify an agent's keys against your pinned copy. Detects key changes (potential MitM). */
+  async verifyKeys(did) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/keys/verify/${encodeURIComponent(did)}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Key verify failed: ${res.status}`);
+    return res.json();
+  }
 };
 var export_decodeBase64 = import_tweetnacl_util.decodeBase64;
 var export_decodeUTF8 = import_tweetnacl_util.decodeUTF8;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidly/agent-sdk",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "E2E encrypted agent-to-agent communication SDK — true client-side encryption",
   "main": "dist/index.js",
   "module": "dist/index.mjs",