@voidly/agent-sdk 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,149 @@
+import nacl from 'tweetnacl';
+export { default as nacl } from 'tweetnacl';
+export { decodeBase64, decodeUTF8, encodeBase64, encodeUTF8 } from 'tweetnacl-util';
+
+/**
+ * @voidly/agent-sdk — True E2E Encrypted Agent Communication
+ *
+ * All encryption and decryption happens CLIENT-SIDE.
+ * The Voidly relay server NEVER sees private keys or plaintext.
+ *
+ * Crypto: X25519 key exchange + XSalsa20-Poly1305 + Ed25519 signatures
+ * Identity: did:voidly:{base58-encoded-ed25519-pubkey}
+ */
+
+interface AgentIdentity {
+    did: string;
+    apiKey: string;
+    signingKeyPair: nacl.SignKeyPair;
+    encryptionKeyPair: nacl.BoxKeyPair;
+}
+interface AgentProfile {
+    did: string;
+    name: string | null;
+    signing_public_key: string;
+    encryption_public_key: string;
+    capabilities: string[];
+    message_count: number;
+}
+interface DecryptedMessage {
+    id: string;
+    from: string;
+    to: string;
+    content: string;
+    contentType: string;
+    threadId: string | null;
+    replyTo: string | null;
+    signatureValid: boolean;
+    timestamp: string;
+    expiresAt: string;
+}
+interface SendResult {
+    id: string;
+    from: string;
+    to: string;
+    timestamp: string;
+    expiresAt: string;
+    encrypted: boolean;
+    clientSide: boolean;
+}
+interface VoidlyAgentConfig {
+    baseUrl?: string;
+}
+/**
+ * A Voidly Agent with client-side encryption.
+ * Private keys NEVER leave this process.
+ *
+ * @example
+ * ```ts
+ * import { VoidlyAgent } from '@voidly/agent-sdk';
+ *
+ * // Register a new agent
+ * const agent = await VoidlyAgent.register({ name: 'my-agent' });
+ * console.log(agent.did); // did:voidly:...
+ *
+ * // Send an encrypted message
+ * await agent.send('did:voidly:recipient', 'Hello, securely!');
+ *
+ * // Receive and decrypt messages
+ * const messages = await agent.receive();
+ * ```
+ */
+declare class VoidlyAgent {
+    readonly did: string;
+    readonly apiKey: string;
+    private signingKeyPair;
+    private encryptionKeyPair;
+    private baseUrl;
+    private constructor();
+    /**
+     * Register a new agent on the Voidly relay.
+     * Keys are generated locally — the server only receives public keys.
+     */
+    static register(options?: {
+        name?: string;
+        capabilities?: string[];
+    }, config?: VoidlyAgentConfig): Promise<VoidlyAgent>;
+    /**
+     * Restore an agent from saved credentials.
+     * Use this to resume an agent across sessions.
+     */
+    static fromCredentials(creds: {
+        did: string;
+        apiKey: string;
+        signingSecretKey: string;
+        encryptionSecretKey: string;
+    }, config?: VoidlyAgentConfig): VoidlyAgent;
+    /**
+     * Export credentials for persistence.
+     * Store these securely — they contain private keys.
+     */
+    exportCredentials(): {
+        did: string;
+        apiKey: string;
+        signingSecretKey: string;
+        encryptionSecretKey: string;
+        signingPublicKey: string;
+        encryptionPublicKey: string;
+    };
+    /**
+     * Send an E2E encrypted message. Encryption happens locally.
+     * The relay server NEVER sees the plaintext or private keys.
+     */
+    send(recipientDid: string, message: string, options?: {
+        contentType?: string;
+        threadId?: string;
+        replyTo?: string;
+        ttl?: number;
+    }): Promise<SendResult>;
+    /**
+     * Receive and decrypt messages. Decryption happens locally.
+     * The relay server returns raw ciphertext — never touches private keys.
+     */
+    receive(options?: {
+        since?: string;
+        limit?: number;
+    }): Promise<DecryptedMessage[]>;
+    /**
+     * Look up an agent's public profile and keys.
+     */
+    getIdentity(did: string): Promise<AgentProfile | null>;
+    /**
+     * Search for agents by name or capability.
+     */
+    discover(options?: {
+        query?: string;
+        capability?: string;
+        limit?: number;
+    }): Promise<AgentProfile[]>;
+    /**
+     * Get relay network statistics.
+     */
+    stats(): Promise<Record<string, unknown>>;
+    /**
+     * Rotate this agent's keypairs. Old messages encrypted with old keys cannot be re-decrypted.
+     */
+    rotateKeys(): Promise<void>;
+}
+
+export { type AgentIdentity, type AgentProfile, type DecryptedMessage, type SendResult, VoidlyAgent, type VoidlyAgentConfig };

package/dist/index.d.ts

@@ -0,0 +1,149 @@
+import nacl from 'tweetnacl';
+export { default as nacl } from 'tweetnacl';
+export { decodeBase64, decodeUTF8, encodeBase64, encodeUTF8 } from 'tweetnacl-util';
+
+/**
+ * @voidly/agent-sdk — True E2E Encrypted Agent Communication
+ *
+ * All encryption and decryption happens CLIENT-SIDE.
+ * The Voidly relay server NEVER sees private keys or plaintext.
+ *
+ * Crypto: X25519 key exchange + XSalsa20-Poly1305 + Ed25519 signatures
+ * Identity: did:voidly:{base58-encoded-ed25519-pubkey}
+ */
+
+interface AgentIdentity {
+    did: string;
+    apiKey: string;
+    signingKeyPair: nacl.SignKeyPair;
+    encryptionKeyPair: nacl.BoxKeyPair;
+}
+interface AgentProfile {
+    did: string;
+    name: string | null;
+    signing_public_key: string;
+    encryption_public_key: string;
+    capabilities: string[];
+    message_count: number;
+}
+interface DecryptedMessage {
+    id: string;
+    from: string;
+    to: string;
+    content: string;
+    contentType: string;
+    threadId: string | null;
+    replyTo: string | null;
+    signatureValid: boolean;
+    timestamp: string;
+    expiresAt: string;
+}
+interface SendResult {
+    id: string;
+    from: string;
+    to: string;
+    timestamp: string;
+    expiresAt: string;
+    encrypted: boolean;
+    clientSide: boolean;
+}
+interface VoidlyAgentConfig {
+    baseUrl?: string;
+}
+/**
+ * A Voidly Agent with client-side encryption.
+ * Private keys NEVER leave this process.
+ *
+ * @example
+ * ```ts
+ * import { VoidlyAgent } from '@voidly/agent-sdk';
+ *
+ * // Register a new agent
+ * const agent = await VoidlyAgent.register({ name: 'my-agent' });
+ * console.log(agent.did); // did:voidly:...
+ *
+ * // Send an encrypted message
+ * await agent.send('did:voidly:recipient', 'Hello, securely!');
+ *
+ * // Receive and decrypt messages
+ * const messages = await agent.receive();
+ * ```
+ */
+declare class VoidlyAgent {
+    readonly did: string;
+    readonly apiKey: string;
+    private signingKeyPair;
+    private encryptionKeyPair;
+    private baseUrl;
+    private constructor();
+    /**
+     * Register a new agent on the Voidly relay.
+     * Keys are generated locally — the server only receives public keys.
+     */
+    static register(options?: {
+        name?: string;
+        capabilities?: string[];
+    }, config?: VoidlyAgentConfig): Promise<VoidlyAgent>;
+    /**
+     * Restore an agent from saved credentials.
+     * Use this to resume an agent across sessions.
+     */
+    static fromCredentials(creds: {
+        did: string;
+        apiKey: string;
+        signingSecretKey: string;
+        encryptionSecretKey: string;
+    }, config?: VoidlyAgentConfig): VoidlyAgent;
+    /**
+     * Export credentials for persistence.
+     * Store these securely — they contain private keys.
+     */
+    exportCredentials(): {
+        did: string;
+        apiKey: string;
+        signingSecretKey: string;
+        encryptionSecretKey: string;
+        signingPublicKey: string;
+        encryptionPublicKey: string;
+    };
+    /**
+     * Send an E2E encrypted message. Encryption happens locally.
+     * The relay server NEVER sees the plaintext or private keys.
+     */
+    send(recipientDid: string, message: string, options?: {
+        contentType?: string;
+        threadId?: string;
+        replyTo?: string;
+        ttl?: number;
+    }): Promise<SendResult>;
+    /**
+     * Receive and decrypt messages. Decryption happens locally.
+     * The relay server returns raw ciphertext — never touches private keys.
+     */
+    receive(options?: {
+        since?: string;
+        limit?: number;
+    }): Promise<DecryptedMessage[]>;
+    /**
+     * Look up an agent's public profile and keys.
+     */
+    getIdentity(did: string): Promise<AgentProfile | null>;
+    /**
+     * Search for agents by name or capability.
+     */
+    discover(options?: {
+        query?: string;
+        capability?: string;
+        limit?: number;
+    }): Promise<AgentProfile[]>;
+    /**
+     * Get relay network statistics.
+     */
+    stats(): Promise<Record<string, unknown>>;
+    /**
+     * Rotate this agent's keypairs. Old messages encrypted with old keys cannot be re-decrypted.
+     */
+    rotateKeys(): Promise<void>;
+}
+
+export { type AgentIdentity, type AgentProfile, type DecryptedMessage, type SendResult, VoidlyAgent, type VoidlyAgentConfig };