@voidly/agent-sdk 1.5.0 → 1.7.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.
@@ -495,6 +556,114 @@ declare class VoidlyAgent {
         signature: string;
         timestamp: string;
     }, signingPublicKey: string): boolean;
+    /**
+     * Store an encrypted key-value pair in persistent memory.
+     * Values are encrypted with a key derived from your API key — only you can read them.
+     */
+    memorySet(namespace: string, key: string, value: unknown, options?: {
+        valueType?: string;
+        ttl?: number;
+    }): Promise<{
+        stored: boolean;
+        id: string;
+        size_bytes: number;
+        expires_at: string | null;
+    }>;
+    /**
+     * Retrieve a value from persistent memory.
+     * Decrypted server-side using your API key derivation.
+     */
+    memoryGet(namespace: string, key: string): Promise<{
+        namespace: string;
+        key: string;
+        value: unknown;
+        value_type: string;
+        size_bytes: number;
+        created_at: string;
+        updated_at: string;
+        expires_at: string | null;
+    } | null>;
+    /**
+     * Delete a key from persistent memory.
+     */
+    memoryDelete(namespace: string, key: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * List all keys in a memory namespace.
+     */
+    memoryList(namespace?: string, options?: {
+        prefix?: string;
+        limit?: number;
+    }): Promise<{
+        namespace: string;
+        keys: Array<{
+            key: string;
+            value_type: string;
+            size_bytes: number;
+            updated_at: string;
+        }>;
+        total_keys: number;
+        total_bytes: number;
+    }>;
+    /**
+     * List all memory namespaces and quota usage.
+     */
+    memoryNamespaces(): Promise<{
+        namespaces: Array<{
+            namespace: string;
+            key_count: number;
+            total_bytes: number;
+            last_updated: string;
+        }>;
+        quota: {
+            used_bytes: number;
+            quota_bytes: number;
+            remaining_bytes: number;
+        };
+    }>;
+    /**
+     * Export all agent data as a portable JSON bundle.
+     * Includes identity, messages, channels, tasks, attestations, memory, and trust.
+     * Memory values remain encrypted — portable to another relay.
+     */
+    exportData(options?: {
+        includeMessages?: boolean;
+        includeChannels?: boolean;
+        includeTasks?: boolean;
+        includeAttestations?: boolean;
+        includeMemory?: boolean;
+        includeTrust?: boolean;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * List past data export records.
+     */
+    listExports(): Promise<{
+        exports: Array<Record<string, unknown>>;
+    }>;
+    /**
+     * Get information about the relay this agent is connected to.
+     * Includes federation capabilities and known peers.
+     */
+    getRelayInfo(): Promise<Record<string, unknown>>;
+    /**
+     * List known federated relay peers.
+     */
+    getRelayPeers(): Promise<{
+        peers: Array<Record<string, unknown>>;
+        total: number;
+    }>;
+    /**
+     * Route a message through federation to an agent on a different relay.
+     * The relay will forward it to the recipient's home relay.
+     */
+    routeMessage(toDid: string, message: string, options?: {
+        contentType?: string;
+        threadId?: string;
+    }): Promise<{
+        routed: boolean;
+        destination: string;
+    }>;
 }
 
 export { type AgentIdentity, type AgentProfile, type DecryptedMessage, type SendResult, VoidlyAgent, type VoidlyAgentConfig };

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.
@@ -495,6 +556,114 @@ declare class VoidlyAgent {
         signature: string;
         timestamp: string;
     }, signingPublicKey: string): boolean;
+    /**
+     * Store an encrypted key-value pair in persistent memory.
+     * Values are encrypted with a key derived from your API key — only you can read them.
+     */
+    memorySet(namespace: string, key: string, value: unknown, options?: {
+        valueType?: string;
+        ttl?: number;
+    }): Promise<{
+        stored: boolean;
+        id: string;
+        size_bytes: number;
+        expires_at: string | null;
+    }>;
+    /**
+     * Retrieve a value from persistent memory.
+     * Decrypted server-side using your API key derivation.
+     */
+    memoryGet(namespace: string, key: string): Promise<{
+        namespace: string;
+        key: string;
+        value: unknown;
+        value_type: string;
+        size_bytes: number;
+        created_at: string;
+        updated_at: string;
+        expires_at: string | null;
+    } | null>;
+    /**
+     * Delete a key from persistent memory.
+     */
+    memoryDelete(namespace: string, key: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * List all keys in a memory namespace.
+     */
+    memoryList(namespace?: string, options?: {
+        prefix?: string;
+        limit?: number;
+    }): Promise<{
+        namespace: string;
+        keys: Array<{
+            key: string;
+            value_type: string;
+            size_bytes: number;
+            updated_at: string;
+        }>;
+        total_keys: number;
+        total_bytes: number;
+    }>;
+    /**
+     * List all memory namespaces and quota usage.
+     */
+    memoryNamespaces(): Promise<{
+        namespaces: Array<{
+            namespace: string;
+            key_count: number;
+            total_bytes: number;
+            last_updated: string;
+        }>;
+        quota: {
+            used_bytes: number;
+            quota_bytes: number;
+            remaining_bytes: number;
+        };
+    }>;
+    /**
+     * Export all agent data as a portable JSON bundle.
+     * Includes identity, messages, channels, tasks, attestations, memory, and trust.
+     * Memory values remain encrypted — portable to another relay.
+     */
+    exportData(options?: {
+        includeMessages?: boolean;
+        includeChannels?: boolean;
+        includeTasks?: boolean;
+        includeAttestations?: boolean;
+        includeMemory?: boolean;
+        includeTrust?: boolean;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * List past data export records.
+     */
+    listExports(): Promise<{
+        exports: Array<Record<string, unknown>>;
+    }>;
+    /**
+     * Get information about the relay this agent is connected to.
+     * Includes federation capabilities and known peers.
+     */
+    getRelayInfo(): Promise<Record<string, unknown>>;
+    /**
+     * List known federated relay peers.
+     */
+    getRelayPeers(): Promise<{
+        peers: Array<Record<string, unknown>>;
+        total: number;
+    }>;
+    /**
+     * Route a message through federation to an agent on a different relay.
+     * The relay will forward it to the recipient's home relay.
+     */
+    routeMessage(toDid: string, message: string, options?: {
+        contentType?: string;
+        threadId?: string;
+    }): Promise<{
+        routed: boolean;
+        destination: string;
+    }>;
 }
 
 export { type AgentIdentity, type AgentProfile, type DecryptedMessage, type SendResult, VoidlyAgent, type VoidlyAgentConfig };

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.
@@ -3224,6 +3332,155 @@ var VoidlyAgent = class _VoidlyAgent {
       return false;
     }
   }
+  // ─── Memory Store ──────────────────────────────────────────────────────────
+  /**
+   * Store an encrypted key-value pair in persistent memory.
+   * Values are encrypted with a key derived from your API key — only you can read them.
+   */
+  async memorySet(namespace, key, value, options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory/${encodeURIComponent(namespace)}/${encodeURIComponent(key)}`, {
+      method: "PUT",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        value,
+        value_type: options?.valueType || (typeof value === "object" ? "json" : typeof value),
+        ttl: options?.ttl
+      })
+    });
+    if (!res.ok) throw new Error(`Memory set failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * Retrieve a value from persistent memory.
+   * Decrypted server-side using your API key derivation.
+   */
+  async memoryGet(namespace, key) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory/${encodeURIComponent(namespace)}/${encodeURIComponent(key)}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (res.status === 404) return null;
+    if (!res.ok) throw new Error(`Memory get failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * Delete a key from persistent memory.
+   */
+  async memoryDelete(namespace, key) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory/${encodeURIComponent(namespace)}/${encodeURIComponent(key)}`, {
+      method: "DELETE",
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Memory delete failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * List all keys in a memory namespace.
+   */
+  async memoryList(namespace, options) {
+    const ns = namespace || "default";
+    const params = new URLSearchParams();
+    if (options?.prefix) params.set("prefix", options.prefix);
+    if (options?.limit) params.set("limit", String(options.limit));
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory/${encodeURIComponent(ns)}${qs}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Memory list failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * List all memory namespaces and quota usage.
+   */
+  async memoryNamespaces() {
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Memory namespaces failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  // ─── Data Export ───────────────────────────────────────────────────────────
+  /**
+   * Export all agent data as a portable JSON bundle.
+   * Includes identity, messages, channels, tasks, attestations, memory, and trust.
+   * Memory values remain encrypted — portable to another relay.
+   */
+  async exportData(options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/export`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        include_messages: options?.includeMessages,
+        include_channels: options?.includeChannels,
+        include_tasks: options?.includeTasks,
+        include_attestations: options?.includeAttestations,
+        include_memory: options?.includeMemory,
+        include_trust: options?.includeTrust
+      })
+    });
+    if (!res.ok) throw new Error(`Export failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * List past data export records.
+   */
+  async listExports() {
+    const res = await fetch(`${this.baseUrl}/v1/agent/exports`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`List exports failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  // ─── Relay Federation ─────────────────────────────────────────────────────
+  /**
+   * Get information about the relay this agent is connected to.
+   * Includes federation capabilities and known peers.
+   */
+  async getRelayInfo() {
+    const res = await fetch(`${this.baseUrl}/v1/relay/info`);
+    if (!res.ok) throw new Error(`Relay info failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * List known federated relay peers.
+   */
+  async getRelayPeers() {
+    const res = await fetch(`${this.baseUrl}/v1/relay/peers`);
+    if (!res.ok) throw new Error(`Relay peers failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * Route a message through federation to an agent on a different relay.
+   * The relay will forward it to the recipient's home relay.
+   */
+  async routeMessage(toDid, message, options) {
+    const profile = await this.getIdentity(toDid);
+    if (!profile) throw new Error(`Recipient ${toDid} not found`);
+    const recipientPub = (0, import_tweetnacl_util.decodeBase64)(profile.encryption_public_key);
+    const nonce = import_tweetnacl.default.randomBytes(import_tweetnacl.default.box.nonceLength);
+    const encrypted = import_tweetnacl.default.box((0, import_tweetnacl_util.decodeUTF8)(message), nonce, recipientPub, this.encryptionKeyPair.secretKey);
+    if (!encrypted) throw new Error("Encryption failed");
+    const signaturePayload = (0, import_tweetnacl_util.decodeUTF8)(JSON.stringify({
+      from: this.did,
+      to: toDid,
+      nonce: (0, import_tweetnacl_util.encodeBase64)(nonce),
+      ciphertext_hash: await sha256((0, import_tweetnacl_util.encodeBase64)(encrypted))
+    }));
+    const signature = import_tweetnacl.default.sign.detached(signaturePayload, this.signingKeyPair.secretKey);
+    const res = await fetch(`${this.baseUrl}/v1/relay/route`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        to: toDid,
+        ciphertext: (0, import_tweetnacl_util.encodeBase64)(encrypted),
+        nonce: (0, import_tweetnacl_util.encodeBase64)(nonce),
+        signature: (0, import_tweetnacl_util.encodeBase64)(signature),
+        content_type: options?.contentType || "text/plain",
+        thread_id: options?.threadId
+      })
+    });
+    if (!res.ok) throw new Error(`Route failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

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.
@@ -3214,6 +3322,155 @@ var VoidlyAgent = class _VoidlyAgent {
       return false;
     }
   }
+  // ─── Memory Store ──────────────────────────────────────────────────────────
+  /**
+   * Store an encrypted key-value pair in persistent memory.
+   * Values are encrypted with a key derived from your API key — only you can read them.
+   */
+  async memorySet(namespace, key, value, options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory/${encodeURIComponent(namespace)}/${encodeURIComponent(key)}`, {
+      method: "PUT",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        value,
+        value_type: options?.valueType || (typeof value === "object" ? "json" : typeof value),
+        ttl: options?.ttl
+      })
+    });
+    if (!res.ok) throw new Error(`Memory set failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * Retrieve a value from persistent memory.
+   * Decrypted server-side using your API key derivation.
+   */
+  async memoryGet(namespace, key) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory/${encodeURIComponent(namespace)}/${encodeURIComponent(key)}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (res.status === 404) return null;
+    if (!res.ok) throw new Error(`Memory get failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * Delete a key from persistent memory.
+   */
+  async memoryDelete(namespace, key) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory/${encodeURIComponent(namespace)}/${encodeURIComponent(key)}`, {
+      method: "DELETE",
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Memory delete failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * List all keys in a memory namespace.
+   */
+  async memoryList(namespace, options) {
+    const ns = namespace || "default";
+    const params = new URLSearchParams();
+    if (options?.prefix) params.set("prefix", options.prefix);
+    if (options?.limit) params.set("limit", String(options.limit));
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory/${encodeURIComponent(ns)}${qs}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Memory list failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * List all memory namespaces and quota usage.
+   */
+  async memoryNamespaces() {
+    const res = await fetch(`${this.baseUrl}/v1/agent/memory`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`Memory namespaces failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  // ─── Data Export ───────────────────────────────────────────────────────────
+  /**
+   * Export all agent data as a portable JSON bundle.
+   * Includes identity, messages, channels, tasks, attestations, memory, and trust.
+   * Memory values remain encrypted — portable to another relay.
+   */
+  async exportData(options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/export`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        include_messages: options?.includeMessages,
+        include_channels: options?.includeChannels,
+        include_tasks: options?.includeTasks,
+        include_attestations: options?.includeAttestations,
+        include_memory: options?.includeMemory,
+        include_trust: options?.includeTrust
+      })
+    });
+    if (!res.ok) throw new Error(`Export failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * List past data export records.
+   */
+  async listExports() {
+    const res = await fetch(`${this.baseUrl}/v1/agent/exports`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) throw new Error(`List exports failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  // ─── Relay Federation ─────────────────────────────────────────────────────
+  /**
+   * Get information about the relay this agent is connected to.
+   * Includes federation capabilities and known peers.
+   */
+  async getRelayInfo() {
+    const res = await fetch(`${this.baseUrl}/v1/relay/info`);
+    if (!res.ok) throw new Error(`Relay info failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * List known federated relay peers.
+   */
+  async getRelayPeers() {
+    const res = await fetch(`${this.baseUrl}/v1/relay/peers`);
+    if (!res.ok) throw new Error(`Relay peers failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  /**
+   * Route a message through federation to an agent on a different relay.
+   * The relay will forward it to the recipient's home relay.
+   */
+  async routeMessage(toDid, message, options) {
+    const profile = await this.getIdentity(toDid);
+    if (!profile) throw new Error(`Recipient ${toDid} not found`);
+    const recipientPub = (0, import_tweetnacl_util.decodeBase64)(profile.encryption_public_key);
+    const nonce = import_tweetnacl.default.randomBytes(import_tweetnacl.default.box.nonceLength);
+    const encrypted = import_tweetnacl.default.box((0, import_tweetnacl_util.decodeUTF8)(message), nonce, recipientPub, this.encryptionKeyPair.secretKey);
+    if (!encrypted) throw new Error("Encryption failed");
+    const signaturePayload = (0, import_tweetnacl_util.decodeUTF8)(JSON.stringify({
+      from: this.did,
+      to: toDid,
+      nonce: (0, import_tweetnacl_util.encodeBase64)(nonce),
+      ciphertext_hash: await sha256((0, import_tweetnacl_util.encodeBase64)(encrypted))
+    }));
+    const signature = import_tweetnacl.default.sign.detached(signaturePayload, this.signingKeyPair.secretKey);
+    const res = await fetch(`${this.baseUrl}/v1/relay/route`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({
+        to: toDid,
+        ciphertext: (0, import_tweetnacl_util.encodeBase64)(encrypted),
+        nonce: (0, import_tweetnacl_util.encodeBase64)(nonce),
+        signature: (0, import_tweetnacl_util.encodeBase64)(signature),
+        content_type: options?.contentType || "text/plain",
+        thread_id: options?.threadId
+      })
+    });
+    if (!res.ok) throw new Error(`Route failed: ${res.status} ${await res.text()}`);
+    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.5.0",
+  "version": "1.7.0",
   "description": "E2E encrypted agent-to-agent communication SDK — true client-side encryption",
   "main": "dist/index.js",
   "module": "dist/index.mjs",