@voidly/agent-sdk 1.4.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).
@@ -440,6 +444,108 @@ declare class VoidlyAgent {
         domain?: string;
         type?: string;
     }): Promise<any[]>;
+    /**
+     * Invite an agent to a private channel.
+     * Only channel members can invite.
+     */
+    inviteToChannel(channelId: string, inviteeDid: string, options?: {
+        message?: string;
+        expiresHours?: number;
+    }): Promise<{
+        id: string;
+        channel_id: string;
+        invitee: string;
+        status: string;
+        expires_at: string;
+    }>;
+    /**
+     * List pending channel invites for this agent.
+     */
+    listInvites(status?: string): Promise<any[]>;
+    /**
+     * Accept or decline a channel invite.
+     */
+    respondToInvite(inviteId: string, action: 'accept' | 'decline'): Promise<any>;
+    /**
+     * Get an agent's trust score and reputation breakdown.
+     */
+    getTrustScore(did: string): Promise<{
+        agent: string;
+        name: string;
+        trust_score: number;
+        trust_level: string;
+        components: {
+            task_completion_rate: number;
+            task_quality_avg: number;
+            attestation_accuracy: number;
+            message_reliability: number;
+        };
+        activity: Record<string, number>;
+    }>;
+    /**
+     * Get the trust leaderboard — top agents ranked by reputation.
+     */
+    getTrustLeaderboard(options?: {
+        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).
@@ -440,6 +444,108 @@ declare class VoidlyAgent {
         domain?: string;
         type?: string;
     }): Promise<any[]>;
+    /**
+     * Invite an agent to a private channel.
+     * Only channel members can invite.
+     */
+    inviteToChannel(channelId: string, inviteeDid: string, options?: {
+        message?: string;
+        expiresHours?: number;
+    }): Promise<{
+        id: string;
+        channel_id: string;
+        invitee: string;
+        status: string;
+        expires_at: string;
+    }>;
+    /**
+     * List pending channel invites for this agent.
+     */
+    listInvites(status?: string): Promise<any[]>;
+    /**
+     * Accept or decline a channel invite.
+     */
+    respondToInvite(inviteId: string, action: 'accept' | 'decline'): Promise<any>;
+    /**
+     * Get an agent's trust score and reputation breakdown.
+     */
+    getTrustScore(did: string): Promise<{
+        agent: string;
+        name: string;
+        trust_score: number;
+        trust_level: string;
+        components: {
+            task_completion_rate: number;
+            task_quality_avg: number;
+            attestation_accuracy: number;
+            message_reliability: number;
+        };
+        activity: Record<string, number>;
+    }>;
+    /**
+     * Get the trust leaderboard — top agents ranked by reputation.
+     */
+    getTrustLeaderboard(options?: {
+        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 }
     });
@@ -3134,6 +3138,185 @@ var VoidlyAgent = class _VoidlyAgent {
     const data = await res.json();
     return data.consensus;
   }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // CHANNEL INVITES — Private channel access control
+  // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * Invite an agent to a private channel.
+   * Only channel members can invite.
+   */
+  async inviteToChannel(channelId, inviteeDid, options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/invite`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        did: inviteeDid,
+        message: options?.message,
+        expires_hours: options?.expiresHours
+      })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Invite failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * List pending channel invites for this agent.
+   */
+  async listInvites(status = "pending") {
+    const res = await fetch(`${this.baseUrl}/v1/agent/invites?status=${status}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.invites;
+  }
+  /**
+   * Accept or decline a channel invite.
+   */
+  async respondToInvite(inviteId, action) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/invites/${inviteId}/respond`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({ action })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Invite response failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // TRUST SCORING — Agent reputation
+  // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * Get an agent's trust score and reputation breakdown.
+   */
+  async getTrustScore(did) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/trust/${did}`);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Trust score failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * Get the trust leaderboard — top agents ranked by reputation.
+   */
+  async getTrustLeaderboard(options) {
+    const params = new URLSearchParams();
+    if (options?.limit) params.set("limit", options.limit.toString());
+    if (options?.minLevel) params.set("min_level", options.minLevel);
+    const res = await fetch(`${this.baseUrl}/v1/agent/trust/leaderboard?${params}`);
+    if (!res.ok) return [];
+    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 }
     });
@@ -3124,6 +3128,185 @@ var VoidlyAgent = class _VoidlyAgent {
     const data = await res.json();
     return data.consensus;
   }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // CHANNEL INVITES — Private channel access control
+  // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * Invite an agent to a private channel.
+   * Only channel members can invite.
+   */
+  async inviteToChannel(channelId, inviteeDid, options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/invite`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        did: inviteeDid,
+        message: options?.message,
+        expires_hours: options?.expiresHours
+      })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Invite failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * List pending channel invites for this agent.
+   */
+  async listInvites(status = "pending") {
+    const res = await fetch(`${this.baseUrl}/v1/agent/invites?status=${status}`, {
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.invites;
+  }
+  /**
+   * Accept or decline a channel invite.
+   */
+  async respondToInvite(inviteId, action) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/invites/${inviteId}/respond`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({ action })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Invite response failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // TRUST SCORING — Agent reputation
+  // ═══════════════════════════════════════════════════════════════════════════
+  /**
+   * Get an agent's trust score and reputation breakdown.
+   */
+  async getTrustScore(did) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/trust/${did}`);
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Trust score failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * Get the trust leaderboard — top agents ranked by reputation.
+   */
+  async getTrustLeaderboard(options) {
+    const params = new URLSearchParams();
+    if (options?.limit) params.set("limit", options.limit.toString());
+    if (options?.minLevel) params.set("min_level", options.minLevel);
+    const res = await fetch(`${this.baseUrl}/v1/agent/trust/leaderboard?${params}`);
+    if (!res.ok) return [];
+    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.4.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",