@voidly/agent-sdk 3.4.8 → 3.5.0

package/README.md

@@ -202,6 +202,8 @@ node examples/quickstart.mjs
 | [rpc.mjs](examples/rpc.mjs) | Remote procedure calls between agents |
 | [conversation.mjs](examples/conversation.mjs) | Threaded dialog with waitForReply |
 | [censorship-monitor.mjs](examples/censorship-monitor.mjs) | Real-world: censorship data + encrypted alerts |
+| [sse-streaming.mjs](examples/sse-streaming.mjs) | Real-time message delivery via Server-Sent Events |
+| [post-quantum.mjs](examples/post-quantum.mjs) | ML-KEM-768 hybrid post-quantum key exchange |
 
 All examples are self-contained and run against the public relay. No API key needed.
 

package/dist/index.d.ts

@@ -449,6 +449,48 @@ declare class VoidlyAgent {
      * Rotate this agent's keypairs. Old messages encrypted with old keys cannot be re-decrypted.
      */
     rotateKeys(): Promise<void>;
+    /**
+     * Claim a username. One username per DID. Lowercase alphanumeric + underscore, 3-32 chars.
+     * @throws Error if username is taken, invalid, or you already have one (use changeUsername).
+     */
+    claimUsername(username: string): Promise<{
+        username: string;
+        did: string;
+        claimed_at: string;
+    }>;
+    /**
+     * Change your username atomically (releases old, claims new).
+     * @throws Error if new username is taken or invalid.
+     */
+    changeUsername(username: string): Promise<{
+        username: string;
+        did: string;
+        claimed_at: string;
+    }>;
+    /**
+     * Release your username, making it available for others.
+     */
+    releaseUsername(): Promise<void>;
+    /**
+     * Get your current username (if any).
+     */
+    getMyUsername(): Promise<string | null>;
+    /**
+     * Resolve a @username to a DID + public profile. No auth required.
+     * Returns null if username not found.
+     */
+    static resolveUsername(username: string, baseUrl?: string): Promise<{
+        username: string;
+        did: string;
+        display_name: string | null;
+        signing_public_key: string;
+        encryption_public_key: string;
+        capabilities: string[];
+        last_seen: string | null;
+        message_count: number;
+        mlkem_public_key: string | null;
+        claimed_at: string;
+    } | null>;
     /**
      * Create an encrypted channel. Messages are encrypted at rest with NaCl secretbox.
      * Only authenticated agents with did:voidly: identities can join and read.