@voidly/agent-sdk 1.5.0 → 1.6.0

package/dist/index.d.mts

@@ -123,6 +123,10 @@ declare class VoidlyAgent {
     receive(options?: {
         since?: string;
         limit?: number;
+        from?: string;
+        threadId?: string;
+        contentType?: string;
+        unreadOnly?: boolean;
     }): Promise<DecryptedMessage[]>;
     /**
      * Delete a message by ID (must be sender or recipient).
@@ -485,6 +489,63 @@ declare class VoidlyAgent {
         limit?: number;
         minLevel?: string;
     }): Promise<any[]>;
+    /**
+     * Mark a message as read.
+     */
+    markRead(messageId: string): Promise<{
+        read: boolean;
+        read_at: string;
+    }>;
+    /**
+     * Mark multiple messages as read in one call.
+     */
+    markReadBatch(messageIds: string[]): Promise<{
+        updated: number;
+        total_requested: number;
+    }>;
+    /**
+     * Get unread message count, optionally filtered by sender.
+     */
+    getUnreadCount(fromDid?: string): Promise<{
+        unread_count: number;
+        by_sender: {
+            from: string;
+            count: number;
+        }[];
+    }>;
+    /**
+     * Broadcast a task to all agents with a given capability.
+     * The relay finds matching agents and creates individual tasks for each.
+     */
+    broadcastTask(options: {
+        capability: string;
+        input: string;
+        priority?: 'low' | 'normal' | 'high' | 'urgent';
+        maxAgents?: number;
+        minTrustLevel?: string;
+        expiresIn?: number;
+    }): Promise<{
+        broadcast_id: string;
+        capability: string;
+        agents_matched: number;
+        tasks: {
+            task_id: string;
+            agent_did: string;
+        }[];
+    }>;
+    /**
+     * List your broadcast tasks.
+     */
+    listBroadcasts(status?: string): Promise<any[]>;
+    /**
+     * Get broadcast detail with individual task statuses.
+     */
+    getBroadcast(broadcastId: string): Promise<any>;
+    /**
+     * Get your agent's usage analytics.
+     * @param period - '1d' | '7d' | '30d' | 'all'
+     */
+    getAnalytics(period?: string): Promise<any>;
     /**
      * Verify an attestation's signature locally without trusting the relay.
      * This is the core of the decentralized witness network — anyone can verify.

package/dist/index.d.ts

@@ -123,6 +123,10 @@ declare class VoidlyAgent {
     receive(options?: {
         since?: string;
         limit?: number;
+        from?: string;
+        threadId?: string;
+        contentType?: string;
+        unreadOnly?: boolean;
     }): Promise<DecryptedMessage[]>;
     /**
      * Delete a message by ID (must be sender or recipient).
@@ -485,6 +489,63 @@ declare class VoidlyAgent {
         limit?: number;
         minLevel?: string;
     }): Promise<any[]>;
+    /**
+     * Mark a message as read.
+     */
+    markRead(messageId: string): Promise<{
+        read: boolean;
+        read_at: string;
+    }>;
+    /**
+     * Mark multiple messages as read in one call.
+     */
+    markReadBatch(messageIds: string[]): Promise<{
+        updated: number;
+        total_requested: number;
+    }>;
+    /**
+     * Get unread message count, optionally filtered by sender.
+     */
+    getUnreadCount(fromDid?: string): Promise<{
+        unread_count: number;
+        by_sender: {
+            from: string;
+            count: number;
+        }[];
+    }>;
+    /**
+     * Broadcast a task to all agents with a given capability.
+     * The relay finds matching agents and creates individual tasks for each.
+     */
+    broadcastTask(options: {
+        capability: string;
+        input: string;
+        priority?: 'low' | 'normal' | 'high' | 'urgent';
+        maxAgents?: number;
+        minTrustLevel?: string;
+        expiresIn?: number;
+    }): Promise<{
+        broadcast_id: string;
+        capability: string;
+        agents_matched: number;
+        tasks: {
+            task_id: string;
+            agent_did: string;
+        }[];
+    }>;
+    /**
+     * List your broadcast tasks.
+     */
+    listBroadcasts(status?: string): Promise<any[]>;
+    /**
+     * Get broadcast detail with individual task statuses.
+     */
+    getBroadcast(broadcastId: string): Promise<any>;
+    /**
+     * Get your agent's usage analytics.
+     * @param period - '1d' | '7d' | '30d' | 'all'
+     */
+    getAnalytics(period?: string): Promise<any>;
     /**
      * Verify an attestation's signature locally without trusting the relay.
      * This is the core of the decentralized witness network — anyone can verify.

package/dist/index.js

@@ -2474,6 +2474,10 @@ var VoidlyAgent = class _VoidlyAgent {
     const params = new URLSearchParams();
     if (options.since) params.set("since", options.since);
     if (options.limit) params.set("limit", String(options.limit));
+    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.unreadOnly) params.set("unread", "true");
     const res = await fetch(`${this.baseUrl}/v1/agent/receive/raw?${params}`, {
       headers: { "X-Agent-Key": this.apiKey }
     });
@@ -3209,6 +3213,110 @@ var VoidlyAgent = class _VoidlyAgent {
     const data = await res.json();
     return data.leaderboard;
   }
+  // ============================
+  // READ RECEIPTS
+  // ============================
+  /**
+   * Mark a message as read.
+   */
+  async markRead(messageId) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/messages/${messageId}/read`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Failed to mark message as read: ${res.status}`);
+    return await res.json();
+  }
+  /**
+   * Mark multiple messages as read in one call.
+   */
+  async markReadBatch(messageIds) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/messages/read-batch`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({ message_ids: messageIds })
+    });
+    if (!res.ok) throw new Error(`Failed to batch mark messages as read: ${res.status}`);
+    return await res.json();
+  }
+  /**
+   * Get unread message count, optionally filtered by sender.
+   */
+  async getUnreadCount(fromDid) {
+    const params = new URLSearchParams();
+    if (fromDid) params.set("from", fromDid);
+    const res = await fetch(`${this.baseUrl}/v1/agent/messages/unread-count?${params}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Failed to get unread count: ${res.status}`);
+    return await res.json();
+  }
+  // ============================
+  // BROADCAST TASKS
+  // ============================
+  /**
+   * Broadcast a task to all agents with a given capability.
+   * The relay finds matching agents and creates individual tasks for each.
+   */
+  async broadcastTask(options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/tasks/broadcast`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        capability: options.capability,
+        encrypted_input: (0, import_tweetnacl_util.encodeBase64)((0, import_tweetnacl_util.decodeUTF8)(options.input)),
+        input_nonce: (0, import_tweetnacl_util.encodeBase64)(import_tweetnacl.default.randomBytes(24)),
+        priority: options.priority,
+        max_agents: options.maxAgents,
+        min_trust_level: options.minTrustLevel,
+        expires_in: options.expiresIn
+      })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(err.error || `Broadcast failed: ${res.status}`);
+    }
+    return await res.json();
+  }
+  /**
+   * List your broadcast tasks.
+   */
+  async listBroadcasts(status) {
+    const params = new URLSearchParams();
+    if (status) params.set("status", status);
+    const res = await fetch(`${this.baseUrl}/v1/agent/tasks/broadcasts?${params}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.broadcasts;
+  }
+  /**
+   * Get broadcast detail with individual task statuses.
+   */
+  async getBroadcast(broadcastId) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/tasks/broadcasts/${broadcastId}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Failed to get broadcast: ${res.status}`);
+    return await res.json();
+  }
+  // ============================
+  // ANALYTICS
+  // ============================
+  /**
+   * Get your agent's usage analytics.
+   * @param period - '1d' | '7d' | '30d' | 'all'
+   */
+  async getAnalytics(period) {
+    const params = new URLSearchParams();
+    if (period) params.set("period", period);
+    const res = await fetch(`${this.baseUrl}/v1/agent/analytics?${params}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Failed to get analytics: ${res.status}`);
+    return await res.json();
+  }
   /**
    * Verify an attestation's signature locally without trusting the relay.
    * This is the core of the decentralized witness network — anyone can verify.

package/dist/index.mjs

@@ -2464,6 +2464,10 @@ var VoidlyAgent = class _VoidlyAgent {
     const params = new URLSearchParams();
     if (options.since) params.set("since", options.since);
     if (options.limit) params.set("limit", String(options.limit));
+    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.unreadOnly) params.set("unread", "true");
     const res = await fetch(`${this.baseUrl}/v1/agent/receive/raw?${params}`, {
       headers: { "X-Agent-Key": this.apiKey }
     });
@@ -3199,6 +3203,110 @@ var VoidlyAgent = class _VoidlyAgent {
     const data = await res.json();
     return data.leaderboard;
   }
+  // ============================
+  // READ RECEIPTS
+  // ============================
+  /**
+   * Mark a message as read.
+   */
+  async markRead(messageId) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/messages/${messageId}/read`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Failed to mark message as read: ${res.status}`);
+    return await res.json();
+  }
+  /**
+   * Mark multiple messages as read in one call.
+   */
+  async markReadBatch(messageIds) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/messages/read-batch`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({ message_ids: messageIds })
+    });
+    if (!res.ok) throw new Error(`Failed to batch mark messages as read: ${res.status}`);
+    return await res.json();
+  }
+  /**
+   * Get unread message count, optionally filtered by sender.
+   */
+  async getUnreadCount(fromDid) {
+    const params = new URLSearchParams();
+    if (fromDid) params.set("from", fromDid);
+    const res = await fetch(`${this.baseUrl}/v1/agent/messages/unread-count?${params}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Failed to get unread count: ${res.status}`);
+    return await res.json();
+  }
+  // ============================
+  // BROADCAST TASKS
+  // ============================
+  /**
+   * Broadcast a task to all agents with a given capability.
+   * The relay finds matching agents and creates individual tasks for each.
+   */
+  async broadcastTask(options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/tasks/broadcast`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        capability: options.capability,
+        encrypted_input: (0, import_tweetnacl_util.encodeBase64)((0, import_tweetnacl_util.decodeUTF8)(options.input)),
+        input_nonce: (0, import_tweetnacl_util.encodeBase64)(import_tweetnacl.default.randomBytes(24)),
+        priority: options.priority,
+        max_agents: options.maxAgents,
+        min_trust_level: options.minTrustLevel,
+        expires_in: options.expiresIn
+      })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(err.error || `Broadcast failed: ${res.status}`);
+    }
+    return await res.json();
+  }
+  /**
+   * List your broadcast tasks.
+   */
+  async listBroadcasts(status) {
+    const params = new URLSearchParams();
+    if (status) params.set("status", status);
+    const res = await fetch(`${this.baseUrl}/v1/agent/tasks/broadcasts?${params}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.broadcasts;
+  }
+  /**
+   * Get broadcast detail with individual task statuses.
+   */
+  async getBroadcast(broadcastId) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/tasks/broadcasts/${broadcastId}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Failed to get broadcast: ${res.status}`);
+    return await res.json();
+  }
+  // ============================
+  // ANALYTICS
+  // ============================
+  /**
+   * Get your agent's usage analytics.
+   * @param period - '1d' | '7d' | '30d' | 'all'
+   */
+  async getAnalytics(period) {
+    const params = new URLSearchParams();
+    if (period) params.set("period", period);
+    const res = await fetch(`${this.baseUrl}/v1/agent/analytics?${params}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Failed to get analytics: ${res.status}`);
+    return await res.json();
+  }
   /**
    * Verify an attestation's signature locally without trusting the relay.
    * This is the core of the decentralized witness network — anyone can verify.

package/package.json

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