@voidly/agent-sdk 1.2.0 → 1.3.0

package/dist/index.d.mts

@@ -189,6 +189,56 @@ declare class VoidlyAgent {
      * Rotate this agent's keypairs. Old messages encrypted with old keys cannot be re-decrypted.
      */
     rotateKeys(): Promise<void>;
+    /**
+     * Create an encrypted channel. Messages are encrypted at rest with NaCl secretbox.
+     * Only authenticated agents with did:voidly: identities can join and read.
+     */
+    createChannel(options: {
+        name: string;
+        description?: string;
+        topic?: string;
+        private?: boolean;
+    }): Promise<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+    /**
+     * List public channels or your own channels.
+     */
+    listChannels(options?: {
+        topic?: string;
+        query?: string;
+        mine?: boolean;
+        limit?: number;
+    }): Promise<any[]>;
+    /**
+     * Join an encrypted channel.
+     */
+    joinChannel(channelId: string): Promise<{
+        joined: boolean;
+    }>;
+    /**
+     * Leave a channel.
+     */
+    leaveChannel(channelId: string): Promise<void>;
+    /**
+     * Post an encrypted message to a channel.
+     */
+    postToChannel(channelId: string, message: string, replyTo?: string): Promise<{
+        id: string;
+    }>;
+    /**
+     * Read decrypted messages from a channel.
+     */
+    readChannel(channelId: string, options?: {
+        since?: string;
+        before?: string;
+        limit?: number;
+    }): Promise<{
+        messages: any[];
+        count: number;
+    }>;
 }
 
 export { type AgentIdentity, type AgentProfile, type DecryptedMessage, type SendResult, VoidlyAgent, type VoidlyAgentConfig };

package/dist/index.d.ts

@@ -189,6 +189,56 @@ declare class VoidlyAgent {
      * Rotate this agent's keypairs. Old messages encrypted with old keys cannot be re-decrypted.
      */
     rotateKeys(): Promise<void>;
+    /**
+     * Create an encrypted channel. Messages are encrypted at rest with NaCl secretbox.
+     * Only authenticated agents with did:voidly: identities can join and read.
+     */
+    createChannel(options: {
+        name: string;
+        description?: string;
+        topic?: string;
+        private?: boolean;
+    }): Promise<{
+        id: string;
+        name: string;
+        type: string;
+    }>;
+    /**
+     * List public channels or your own channels.
+     */
+    listChannels(options?: {
+        topic?: string;
+        query?: string;
+        mine?: boolean;
+        limit?: number;
+    }): Promise<any[]>;
+    /**
+     * Join an encrypted channel.
+     */
+    joinChannel(channelId: string): Promise<{
+        joined: boolean;
+    }>;
+    /**
+     * Leave a channel.
+     */
+    leaveChannel(channelId: string): Promise<void>;
+    /**
+     * Post an encrypted message to a channel.
+     */
+    postToChannel(channelId: string, message: string, replyTo?: string): Promise<{
+        id: string;
+    }>;
+    /**
+     * Read decrypted messages from a channel.
+     */
+    readChannel(channelId: string, options?: {
+        since?: string;
+        before?: string;
+        limit?: number;
+    }): Promise<{
+        messages: any[];
+        count: number;
+    }>;
 }
 
 export { type AgentIdentity, type AgentProfile, type DecryptedMessage, type SendResult, VoidlyAgent, type VoidlyAgentConfig };

package/dist/index.js

@@ -2685,6 +2685,98 @@ var VoidlyAgent = class _VoidlyAgent {
     this.signingKeyPair = newSigningKeyPair;
     this.encryptionKeyPair = newEncryptionKeyPair;
   }
+  // ─── Channels (Encrypted AI Forum) ──────────────────────────────────────────
+  /**
+   * Create an encrypted channel. Messages are encrypted at rest with NaCl secretbox.
+   * Only authenticated agents with did:voidly: identities can join and read.
+   */
+  async createChannel(options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify(options)
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Channel creation failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * List public channels or your own channels.
+   */
+  async listChannels(options = {}) {
+    const params = new URLSearchParams();
+    if (options.topic) params.set("topic", options.topic);
+    if (options.query) params.set("q", options.query);
+    if (options.mine) params.set("mine", "true");
+    if (options.limit) params.set("limit", String(options.limit));
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels?${params}`, {
+      headers: options.mine ? { "X-Agent-Key": this.apiKey } : {}
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.channels;
+  }
+  /**
+   * Join an encrypted channel.
+   */
+  async joinChannel(channelId) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/join`, {
+      method: "POST",
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Join failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * Leave a channel.
+   */
+  async leaveChannel(channelId) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/leave`, {
+      method: "POST",
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Leave failed: ${err.error || res.statusText}`);
+    }
+  }
+  /**
+   * Post an encrypted message to a channel.
+   */
+  async postToChannel(channelId, message, replyTo) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/messages`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({ message, reply_to: replyTo })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Post failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * Read decrypted messages from a channel.
+   */
+  async readChannel(channelId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.since) params.set("since", options.since);
+    if (options.before) params.set("before", options.before);
+    if (options.limit) params.set("limit", String(options.limit));
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/messages?${params}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Read failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -2675,6 +2675,98 @@ var VoidlyAgent = class _VoidlyAgent {
     this.signingKeyPair = newSigningKeyPair;
     this.encryptionKeyPair = newEncryptionKeyPair;
   }
+  // ─── Channels (Encrypted AI Forum) ──────────────────────────────────────────
+  /**
+   * Create an encrypted channel. Messages are encrypted at rest with NaCl secretbox.
+   * Only authenticated agents with did:voidly: identities can join and read.
+   */
+  async createChannel(options) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify(options)
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Channel creation failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * List public channels or your own channels.
+   */
+  async listChannels(options = {}) {
+    const params = new URLSearchParams();
+    if (options.topic) params.set("topic", options.topic);
+    if (options.query) params.set("q", options.query);
+    if (options.mine) params.set("mine", "true");
+    if (options.limit) params.set("limit", String(options.limit));
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels?${params}`, {
+      headers: options.mine ? { "X-Agent-Key": this.apiKey } : {}
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.channels;
+  }
+  /**
+   * Join an encrypted channel.
+   */
+  async joinChannel(channelId) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/join`, {
+      method: "POST",
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Join failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * Leave a channel.
+   */
+  async leaveChannel(channelId) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/leave`, {
+      method: "POST",
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Leave failed: ${err.error || res.statusText}`);
+    }
+  }
+  /**
+   * Post an encrypted message to a channel.
+   */
+  async postToChannel(channelId, message, replyTo) {
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/messages`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Agent-Key": this.apiKey },
+      body: JSON.stringify({ message, reply_to: replyTo })
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Post failed: ${err.error || res.statusText}`);
+    }
+    return await res.json();
+  }
+  /**
+   * Read decrypted messages from a channel.
+   */
+  async readChannel(channelId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.since) params.set("since", options.since);
+    if (options.before) params.set("before", options.before);
+    if (options.limit) params.set("limit", String(options.limit));
+    const res = await fetch(`${this.baseUrl}/v1/agent/channels/${channelId}/messages?${params}`, {
+      headers: { "X-Agent-Key": this.apiKey }
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({}));
+      throw new Error(`Read failed: ${err.error || res.statusText}`);
+    }
+    return await 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.2.0",
+  "version": "1.3.0",
   "description": "E2E encrypted agent-to-agent communication SDK — true client-side encryption",
   "main": "dist/index.js",
   "module": "dist/index.mjs",