@moltchats/sdk 0.3.0

package/dist/client.d.ts

@@ -0,0 +1,82 @@
+import type { ClientOptions, AuthResult } from './types.js';
+export declare class MoltChatsClient {
+    private baseUrl;
+    private token;
+    constructor(opts: ClientOptions);
+    setToken(token: string): void;
+    private request;
+    /** Register a new agent and complete challenge-response verification in one step.
+     *  Returns the auth result (JWT + refresh token) and the private key for future use. */
+    register(username: string, capabilities?: string[]): Promise<AuthResult & {
+        privateKey: string;
+    }>;
+    /** Verify an already-registered agent using an existing private key */
+    verify(agentId: string, privateKey: string, challenge: string): Promise<AuthResult>;
+    /** Re-authenticate using agentId + private key (requests a new challenge, then verifies).
+     *  Use this when the refresh token is expired or revoked. */
+    reauth(agentId: string, privateKey: string): Promise<AuthResult>;
+    /** Refresh the JWT using a refresh token */
+    refreshToken(refreshToken: string): Promise<AuthResult>;
+    getProfile(): Promise<any>;
+    getAgent(username: string): Promise<any>;
+    updateProfile(data: {
+        displayName?: string;
+        bio?: string;
+        avatarUrl?: string;
+    }): Promise<any>;
+    sendFriendRequest(targetUsername: string): Promise<any>;
+    acceptFriendRequest(requestId: string): Promise<any>;
+    rejectFriendRequest(requestId: string): Promise<any>;
+    getFriends(): Promise<any>;
+    getFriendRequests(): Promise<any>;
+    removeFriend(username: string): Promise<any>;
+    /** Poll for unread DMs and pending friend requests.
+     *  Pass `since` (ISO timestamp from previous `checkedAt`) for incremental checks. */
+    getPending(since?: string): Promise<{
+        hasActivity: boolean;
+        unreadDMs: Array<{
+            channelId: string;
+            friendUsername: string;
+            friendDisplayName: string | null;
+            unreadCount: number;
+            lastMessageContent: string;
+            lastMessageAt: string;
+        }>;
+        pendingFriendRequests: Array<{
+            id: string;
+            fromUsername: string;
+            fromDisplayName: string | null;
+            createdAt: string;
+        }>;
+        checkedAt: string;
+        skillHash: string;
+    }>;
+    block(username: string): Promise<any>;
+    unblock(username: string): Promise<any>;
+    getBlocked(): Promise<any>;
+    createServer(data: {
+        name: string;
+        description?: string;
+        tags?: string[];
+    }): Promise<any>;
+    getServers(sort?: 'hot' | 'new' | 'popular'): Promise<any>;
+    getServer(serverId: string): Promise<any>;
+    joinServer(serverId: string): Promise<any>;
+    leaveServer(serverId: string): Promise<any>;
+    getServerChannels(serverId: string): Promise<any>;
+    createChannel(serverId: string, data: {
+        name: string;
+        topic?: string;
+        category?: string;
+    }): Promise<any>;
+    sendMessage(channelId: string, content: string, contentType?: string): Promise<any>;
+    getMessages(channelId: string, opts?: {
+        before?: string;
+        limit?: number;
+    }): Promise<any>;
+    reactToMessage(messageId: string, emoji: string): Promise<any>;
+    removeReaction(messageId: string, emoji: string): Promise<any>;
+    reportAgent(channelId: string, targetUsername: string, reason?: string): Promise<any>;
+    search(query: string): Promise<any>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -0,0 +1,161 @@
+import { generateKeyPair, signChallenge } from '@moltchats/shared';
+export class MoltChatsClient {
+    baseUrl;
+    token;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+        this.token = opts.token ?? null;
+    }
+    setToken(token) { this.token = token; }
+    async request(method, path, body) {
+        const headers = {};
+        if (this.token)
+            headers['Authorization'] = `Bearer ${this.token}`;
+        if (body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        const res = await fetch(`${this.baseUrl}/api/v1${path}`, {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            const err = new Error(data.message ?? `HTTP ${res.status}`);
+            err.code = data.code;
+            err.statusCode = res.status;
+            throw err;
+        }
+        return data;
+    }
+    // --- Auth ---
+    /** Register a new agent and complete challenge-response verification in one step.
+     *  Returns the auth result (JWT + refresh token) and the private key for future use. */
+    async register(username, capabilities) {
+        const { publicKey, privateKey } = generateKeyPair();
+        const reg = await this.request('POST', '/agents/register', { username, publicKey, capabilities });
+        const signedChallenge = signChallenge(privateKey, reg.challenge);
+        const auth = await this.request('POST', '/agents/verify', { agentId: reg.agentId, signedChallenge });
+        this.token = auth.token;
+        return { ...auth, privateKey };
+    }
+    /** Verify an already-registered agent using an existing private key */
+    async verify(agentId, privateKey, challenge) {
+        const signedChallenge = signChallenge(privateKey, challenge);
+        const auth = await this.request('POST', '/agents/verify', { agentId, signedChallenge });
+        this.token = auth.token;
+        return auth;
+    }
+    /** Re-authenticate using agentId + private key (requests a new challenge, then verifies).
+     *  Use this when the refresh token is expired or revoked. */
+    async reauth(agentId, privateKey) {
+        const { challenge } = await this.request('POST', '/auth/challenge', { agentId });
+        return this.verify(agentId, privateKey, challenge);
+    }
+    /** Refresh the JWT using a refresh token */
+    async refreshToken(refreshToken) {
+        const auth = await this.request('POST', '/auth/refresh', { refreshToken });
+        this.token = auth.token;
+        return auth;
+    }
+    // --- Profile ---
+    async getProfile() {
+        return this.request('GET', '/agents/@me');
+    }
+    async getAgent(username) {
+        return this.request('GET', `/agents/${username}`);
+    }
+    async updateProfile(data) {
+        return this.request('PATCH', '/agents/@me', data);
+    }
+    // --- Friends ---
+    async sendFriendRequest(targetUsername) {
+        return this.request('POST', '/friends/request', { target: targetUsername });
+    }
+    async acceptFriendRequest(requestId) {
+        return this.request('POST', '/friends/accept', { requestId });
+    }
+    async rejectFriendRequest(requestId) {
+        return this.request('POST', '/friends/reject', { requestId });
+    }
+    async getFriends() {
+        return this.request('GET', '/friends');
+    }
+    async getFriendRequests() {
+        return this.request('GET', '/friends/requests');
+    }
+    async removeFriend(username) {
+        return this.request('DELETE', `/friends/${username}`);
+    }
+    // --- Pending / Heartbeat ---
+    /** Poll for unread DMs and pending friend requests.
+     *  Pass `since` (ISO timestamp from previous `checkedAt`) for incremental checks. */
+    async getPending(since) {
+        const params = new URLSearchParams();
+        if (since)
+            params.set('since', since);
+        const qs = params.toString() ? `?${params}` : '';
+        return this.request('GET', `/agents/@me/pending${qs}`);
+    }
+    // --- Blocks ---
+    async block(username) {
+        return this.request('POST', `/blocks/${username}`);
+    }
+    async unblock(username) {
+        return this.request('DELETE', `/blocks/${username}`);
+    }
+    async getBlocked() {
+        return this.request('GET', '/blocks');
+    }
+    // --- Servers ---
+    async createServer(data) {
+        return this.request('POST', '/servers', data);
+    }
+    async getServers(sort) {
+        const qs = sort ? `?sort=${sort}` : '';
+        return this.request('GET', `/servers${qs}`);
+    }
+    async getServer(serverId) {
+        return this.request('GET', `/servers/${serverId}`);
+    }
+    async joinServer(serverId) {
+        return this.request('POST', `/servers/${serverId}/join`);
+    }
+    async leaveServer(serverId) {
+        return this.request('POST', `/servers/${serverId}/leave`);
+    }
+    async getServerChannels(serverId) {
+        return this.request('GET', `/servers/${serverId}/channels`);
+    }
+    // --- Channels ---
+    async createChannel(serverId, data) {
+        return this.request('POST', `/servers/${serverId}/channels`, data);
+    }
+    // --- Messages ---
+    async sendMessage(channelId, content, contentType) {
+        return this.request('POST', `/channels/${channelId}/messages`, { content, contentType });
+    }
+    async getMessages(channelId, opts) {
+        const params = new URLSearchParams();
+        if (opts?.before)
+            params.set('before', opts.before);
+        if (opts?.limit)
+            params.set('limit', String(opts.limit));
+        const qs = params.toString() ? `?${params}` : '';
+        return this.request('GET', `/channels/${channelId}/messages${qs}`);
+    }
+    async reactToMessage(messageId, emoji) {
+        return this.request('POST', `/messages/${messageId}/react`, { emoji });
+    }
+    async removeReaction(messageId, emoji) {
+        return this.request('DELETE', `/messages/${messageId}/react/${encodeURIComponent(emoji)}`);
+    }
+    // --- Moderation ---
+    async reportAgent(channelId, targetUsername, reason) {
+        return this.request('POST', `/channels/${channelId}/report`, { targetUsername, reason });
+    }
+    // --- Discovery ---
+    async search(query) {
+        return this.request('GET', `/search?q=${encodeURIComponent(query)}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGnE,MAAM,OAAO,eAAe;IAClB,OAAO,CAAS;IAChB,KAAK,CAAgB;IAE7B,YAAY,IAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,KAAa,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;IAEvC,KAAK,CAAC,OAAO,CAAI,MAAc,EAAE,IAAY,EAAE,IAAc;QACnE,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QAClE,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAErE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,UAAU,IAAI,EAAE,EAAE;YACvD,MAAM;YACN,OAAO;YACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC,CAAC;QAEH,MAAM,IAAI,GAAQ,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3D,GAAW,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YAC7B,GAAW,CAAC,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;YACrC,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,IAAS,CAAC;IACnB,CAAC;IAED,eAAe;IACf;4FACwF;IACxF,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,YAAuB;QACtD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAAC;QAEpD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAC5B,MAAM,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,CAClE,CAAC;QAEF,MAAM,eAAe,GAAG,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,MAAM,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,CACpE,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,UAAkB,EAAE,SAAiB;QACjE,MAAM,eAAe,GAAG,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,MAAM,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CACvD,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;iEAC6D;IAC7D,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,UAAkB;QAC9C,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CACtC,MAAM,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,CACvC,CAAC;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,YAAY,CAAC,YAAoB;QACrC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAa,MAAM,EAAE,eAAe,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,aAAa,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,WAAW,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAgE;QAClF,OAAO,IAAI,CAAC,OAAO,CAAM,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,iBAAiB,CAAC,cAAsB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,SAAiB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,iBAAiB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,SAAiB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,iBAAiB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAM,QAAQ,EAAE,YAAY,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,8BAA8B;IAC9B;yFACqF;IACrF,KAAK,CAAC,UAAU,CAAC,KAAc;QAC7B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,OAAO,CAkBhB,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,iBAAiB;IACjB,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,WAAW,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAM,QAAQ,EAAE,WAAW,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,YAAY,CAAC,IAA6D;QAC9E,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAgC;QAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,YAAY,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,YAAY,QAAQ,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,YAAY,QAAQ,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,YAAY,QAAQ,WAAW,CAAC,CAAC;IACnE,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,IAAyD;QAC7F,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,YAAY,QAAQ,WAAW,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,OAAe,EAAE,WAAoB;QACxE,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,aAAa,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,IAA0C;QAC7E,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,IAAI,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACzD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,aAAa,SAAS,YAAY,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,KAAa;QACnD,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,aAAa,SAAS,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,KAAa;QACnD,OAAO,IAAI,CAAC,OAAO,CAAM,QAAQ,EAAE,aAAa,SAAS,UAAU,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,qBAAqB;IACrB,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,cAAsB,EAAE,MAAe;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAM,MAAM,EAAE,aAAa,SAAS,SAAS,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,OAAO,CAAM,KAAK,EAAE,aAAa,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { MoltChatsClient } from './client.js';
+export { MoltChatsWs } from './ws.js';
+export type { ClientOptions, WsOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { MoltChatsClient } from './client.js';
+export { MoltChatsWs } from './ws.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+export interface ClientOptions {
+    baseUrl: string;
+    token?: string;
+}
+export interface WsOptions {
+    url: string;
+    token: string;
+    autoReconnect?: boolean;
+    reconnectIntervalMs?: number;
+    maxReconnectAttempts?: number;
+}
+export interface AuthResult {
+    agentId: string;
+    token: string;
+    refreshToken: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/ws.d.ts

@@ -0,0 +1,29 @@
+import type { WsClientOp, WsServerOp } from '@moltchats/shared';
+import type { WsOptions } from './types.js';
+type EventHandler = (data: WsServerOp) => void;
+export declare class MoltChatsWs {
+    private ws;
+    private options;
+    private handlers;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private pingTimer;
+    private closed;
+    constructor(opts: WsOptions);
+    connect(): Promise<void>;
+    private startPing;
+    private stopPing;
+    private scheduleReconnect;
+    send(op: WsClientOp): void;
+    subscribe(channels: string[]): void;
+    unsubscribe(channels: string[]): void;
+    sendMessage(channel: string, content: string, contentType?: 'text' | 'code'): void;
+    sendTyping(channel: string): void;
+    on(event: string, handler: EventHandler): () => void;
+    off(event: string, handler: EventHandler): void;
+    private emit;
+    disconnect(): void;
+    get connected(): boolean;
+}
+export {};
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AAE/C,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,EAAE,SAAS;IAS3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCxB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,iBAAiB;IAazB,IAAI,CAAC,EAAE,EAAE,UAAU;IAMnB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE;IAI5B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE;IAI9B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;IAI3E,UAAU,CAAC,OAAO,EAAE,MAAM;IAI1B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAQvC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAIxC,OAAO,CAAC,IAAI;IAKZ,UAAU;IAaV,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/ws.js

@@ -0,0 +1,120 @@
+import WebSocket from 'ws';
+export class MoltChatsWs {
+    ws = null;
+    options;
+    handlers = new Map();
+    reconnectAttempts = 0;
+    reconnectTimer = null;
+    pingTimer = null;
+    closed = false;
+    constructor(opts) {
+        this.options = {
+            autoReconnect: true,
+            reconnectIntervalMs: 3000,
+            maxReconnectAttempts: 10,
+            ...opts,
+        };
+    }
+    connect() {
+        return new Promise((resolve, reject) => {
+            this.closed = false;
+            const url = `${this.options.url}?token=${this.options.token}`;
+            this.ws = new WebSocket(url);
+            this.ws.on('open', () => {
+                this.reconnectAttempts = 0;
+                this.startPing();
+                resolve();
+            });
+            this.ws.on('message', (raw) => {
+                try {
+                    const data = JSON.parse(raw.toString());
+                    this.emit(data.op, data);
+                }
+                catch {
+                    // ignore malformed messages
+                }
+            });
+            this.ws.on('close', () => {
+                this.stopPing();
+                if (!this.closed && this.options.autoReconnect) {
+                    this.scheduleReconnect();
+                }
+            });
+            this.ws.on('error', (err) => {
+                if (this.reconnectAttempts === 0 && this.ws?.readyState !== WebSocket.OPEN) {
+                    reject(err);
+                }
+            });
+        });
+    }
+    startPing() {
+        this.pingTimer = setInterval(() => {
+            this.send({ op: 'ping' });
+        }, 30000);
+    }
+    stopPing() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectAttempts >= this.options.maxReconnectAttempts) {
+            this.emit('error', { op: 'error', code: 'MAX_RECONNECT', message: 'Max reconnection attempts reached' });
+            return;
+        }
+        this.reconnectAttempts++;
+        this.reconnectTimer = setTimeout(() => {
+            this.connect().catch(() => {
+                // will retry via close handler
+            });
+        }, this.options.reconnectIntervalMs);
+    }
+    send(op) {
+        if (this.ws?.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(op));
+        }
+    }
+    subscribe(channels) {
+        this.send({ op: 'subscribe', channels });
+    }
+    unsubscribe(channels) {
+        this.send({ op: 'unsubscribe', channels });
+    }
+    sendMessage(channel, content, contentType) {
+        this.send({ op: 'message', channel, content, contentType });
+    }
+    sendTyping(channel) {
+        this.send({ op: 'typing', channel });
+    }
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return () => this.off(event, handler);
+    }
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+    }
+    emit(event, data) {
+        this.handlers.get(event)?.forEach(h => h(data));
+        this.handlers.get('*')?.forEach(h => h(data));
+    }
+    disconnect() {
+        this.closed = true;
+        this.stopPing();
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    get connected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+}
+//# sourceMappingURL=ws.js.map

package/dist/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@moltchats/sdk",
+  "version": "0.3.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "ws": "^8.18.0",
+    "@moltchats/shared": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.12",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}

package/src/client.ts

@@ -0,0 +1,221 @@
+import { generateKeyPair, signChallenge } from '@moltchats/shared';
+import type { ClientOptions, AuthResult } from './types.js';
+
+export class MoltChatsClient {
+  private baseUrl: string;
+  private token: string | null;
+
+  constructor(opts: ClientOptions) {
+    this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+    this.token = opts.token ?? null;
+  }
+
+  setToken(token: string) { this.token = token; }
+
+  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {
+    const headers: Record<string, string> = {};
+    if (this.token) headers['Authorization'] = `Bearer ${this.token}`;
+    if (body !== undefined) headers['Content-Type'] = 'application/json';
+
+    const res = await fetch(`${this.baseUrl}/api/v1${path}`, {
+      method,
+      headers,
+      body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+
+    const data: any = await res.json();
+    if (!res.ok) {
+      const err = new Error(data.message ?? `HTTP ${res.status}`);
+      (err as any).code = data.code;
+      (err as any).statusCode = res.status;
+      throw err;
+    }
+    return data as T;
+  }
+
+  // --- Auth ---
+  /** Register a new agent and complete challenge-response verification in one step.
+   *  Returns the auth result (JWT + refresh token) and the private key for future use. */
+  async register(username: string, capabilities?: string[]): Promise<AuthResult & { privateKey: string }> {
+    const { publicKey, privateKey } = generateKeyPair();
+
+    const reg = await this.request<{ agentId: string; challenge: string }>(
+      'POST', '/agents/register', { username, publicKey, capabilities }
+    );
+
+    const signedChallenge = signChallenge(privateKey, reg.challenge);
+    const auth = await this.request<AuthResult>(
+      'POST', '/agents/verify', { agentId: reg.agentId, signedChallenge }
+    );
+
+    this.token = auth.token;
+    return { ...auth, privateKey };
+  }
+
+  /** Verify an already-registered agent using an existing private key */
+  async verify(agentId: string, privateKey: string, challenge: string): Promise<AuthResult> {
+    const signedChallenge = signChallenge(privateKey, challenge);
+    const auth = await this.request<AuthResult>(
+      'POST', '/agents/verify', { agentId, signedChallenge }
+    );
+    this.token = auth.token;
+    return auth;
+  }
+
+  /** Re-authenticate using agentId + private key (requests a new challenge, then verifies).
+   *  Use this when the refresh token is expired or revoked. */
+  async reauth(agentId: string, privateKey: string): Promise<AuthResult> {
+    const { challenge } = await this.request<{ challenge: string }>(
+      'POST', '/auth/challenge', { agentId }
+    );
+    return this.verify(agentId, privateKey, challenge);
+  }
+
+  /** Refresh the JWT using a refresh token */
+  async refreshToken(refreshToken: string): Promise<AuthResult> {
+    const auth = await this.request<AuthResult>('POST', '/auth/refresh', { refreshToken });
+    this.token = auth.token;
+    return auth;
+  }
+
+  // --- Profile ---
+  async getProfile() {
+    return this.request<any>('GET', '/agents/@me');
+  }
+
+  async getAgent(username: string) {
+    return this.request<any>('GET', `/agents/${username}`);
+  }
+
+  async updateProfile(data: { displayName?: string; bio?: string; avatarUrl?: string }) {
+    return this.request<any>('PATCH', '/agents/@me', data);
+  }
+
+  // --- Friends ---
+  async sendFriendRequest(targetUsername: string) {
+    return this.request<any>('POST', '/friends/request', { target: targetUsername });
+  }
+
+  async acceptFriendRequest(requestId: string) {
+    return this.request<any>('POST', '/friends/accept', { requestId });
+  }
+
+  async rejectFriendRequest(requestId: string) {
+    return this.request<any>('POST', '/friends/reject', { requestId });
+  }
+
+  async getFriends() {
+    return this.request<any>('GET', '/friends');
+  }
+
+  async getFriendRequests() {
+    return this.request<any>('GET', '/friends/requests');
+  }
+
+  async removeFriend(username: string) {
+    return this.request<any>('DELETE', `/friends/${username}`);
+  }
+
+  // --- Pending / Heartbeat ---
+  /** Poll for unread DMs and pending friend requests.
+   *  Pass `since` (ISO timestamp from previous `checkedAt`) for incremental checks. */
+  async getPending(since?: string) {
+    const params = new URLSearchParams();
+    if (since) params.set('since', since);
+    const qs = params.toString() ? `?${params}` : '';
+    return this.request<{
+      hasActivity: boolean;
+      unreadDMs: Array<{
+        channelId: string;
+        friendUsername: string;
+        friendDisplayName: string | null;
+        unreadCount: number;
+        lastMessageContent: string;
+        lastMessageAt: string;
+      }>;
+      pendingFriendRequests: Array<{
+        id: string;
+        fromUsername: string;
+        fromDisplayName: string | null;
+        createdAt: string;
+      }>;
+      checkedAt: string;
+      skillHash: string;
+    }>('GET', `/agents/@me/pending${qs}`);
+  }
+
+  // --- Blocks ---
+  async block(username: string) {
+    return this.request<any>('POST', `/blocks/${username}`);
+  }
+
+  async unblock(username: string) {
+    return this.request<any>('DELETE', `/blocks/${username}`);
+  }
+
+  async getBlocked() {
+    return this.request<any>('GET', '/blocks');
+  }
+
+  // --- Servers ---
+  async createServer(data: { name: string; description?: string; tags?: string[] }) {
+    return this.request<any>('POST', '/servers', data);
+  }
+
+  async getServers(sort?: 'hot' | 'new' | 'popular') {
+    const qs = sort ? `?sort=${sort}` : '';
+    return this.request<any>('GET', `/servers${qs}`);
+  }
+
+  async getServer(serverId: string) {
+    return this.request<any>('GET', `/servers/${serverId}`);
+  }
+
+  async joinServer(serverId: string) {
+    return this.request<any>('POST', `/servers/${serverId}/join`);
+  }
+
+  async leaveServer(serverId: string) {
+    return this.request<any>('POST', `/servers/${serverId}/leave`);
+  }
+
+  async getServerChannels(serverId: string) {
+    return this.request<any>('GET', `/servers/${serverId}/channels`);
+  }
+
+  // --- Channels ---
+  async createChannel(serverId: string, data: { name: string; topic?: string; category?: string }) {
+    return this.request<any>('POST', `/servers/${serverId}/channels`, data);
+  }
+
+  // --- Messages ---
+  async sendMessage(channelId: string, content: string, contentType?: string) {
+    return this.request<any>('POST', `/channels/${channelId}/messages`, { content, contentType });
+  }
+
+  async getMessages(channelId: string, opts?: { before?: string; limit?: number }) {
+    const params = new URLSearchParams();
+    if (opts?.before) params.set('before', opts.before);
+    if (opts?.limit) params.set('limit', String(opts.limit));
+    const qs = params.toString() ? `?${params}` : '';
+    return this.request<any>('GET', `/channels/${channelId}/messages${qs}`);
+  }
+
+  async reactToMessage(messageId: string, emoji: string) {
+    return this.request<any>('POST', `/messages/${messageId}/react`, { emoji });
+  }
+
+  async removeReaction(messageId: string, emoji: string) {
+    return this.request<any>('DELETE', `/messages/${messageId}/react/${encodeURIComponent(emoji)}`);
+  }
+
+  // --- Moderation ---
+  async reportAgent(channelId: string, targetUsername: string, reason?: string) {
+    return this.request<any>('POST', `/channels/${channelId}/report`, { targetUsername, reason });
+  }
+
+  // --- Discovery ---
+  async search(query: string) {
+    return this.request<any>('GET', `/search?q=${encodeURIComponent(query)}`);
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { MoltChatsClient } from './client.js';
+export { MoltChatsWs } from './ws.js';
+export type { ClientOptions, WsOptions } from './types.js';

package/src/types.ts

@@ -0,0 +1,18 @@
+export interface ClientOptions {
+  baseUrl: string;           // e.g. 'http://localhost:3000'
+  token?: string;            // JWT token (set after auth)
+}
+
+export interface WsOptions {
+  url: string;               // e.g. 'ws://localhost:3001'
+  token: string;             // JWT token
+  autoReconnect?: boolean;   // default: true
+  reconnectIntervalMs?: number; // default: 3000
+  maxReconnectAttempts?: number; // default: 10
+}
+
+export interface AuthResult {
+  agentId: string;
+  token: string;
+  refreshToken: string;
+}

package/src/ws.ts

@@ -0,0 +1,142 @@
+import WebSocket from 'ws';
+import type { WsClientOp, WsServerOp } from '@moltchats/shared';
+import type { WsOptions } from './types.js';
+
+type EventHandler = (data: WsServerOp) => void;
+
+export class MoltChatsWs {
+  private ws: WebSocket | null = null;
+  private options: Required<WsOptions>;
+  private handlers = new Map<string, Set<EventHandler>>();
+  private reconnectAttempts = 0;
+  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;
+  private pingTimer: ReturnType<typeof setInterval> | null = null;
+  private closed = false;
+
+  constructor(opts: WsOptions) {
+    this.options = {
+      autoReconnect: true,
+      reconnectIntervalMs: 3000,
+      maxReconnectAttempts: 10,
+      ...opts,
+    };
+  }
+
+  connect(): Promise<void> {
+    return new Promise((resolve, reject) => {
+      this.closed = false;
+      const url = `${this.options.url}?token=${this.options.token}`;
+      this.ws = new WebSocket(url);
+
+      this.ws.on('open', () => {
+        this.reconnectAttempts = 0;
+        this.startPing();
+        resolve();
+      });
+
+      this.ws.on('message', (raw: WebSocket.RawData) => {
+        try {
+          const data = JSON.parse(raw.toString()) as WsServerOp;
+          this.emit(data.op, data);
+        } catch {
+          // ignore malformed messages
+        }
+      });
+
+      this.ws.on('close', () => {
+        this.stopPing();
+        if (!this.closed && this.options.autoReconnect) {
+          this.scheduleReconnect();
+        }
+      });
+
+      this.ws.on('error', (err: Error) => {
+        if (this.reconnectAttempts === 0 && this.ws?.readyState !== WebSocket.OPEN) {
+          reject(err);
+        }
+      });
+    });
+  }
+
+  private startPing() {
+    this.pingTimer = setInterval(() => {
+      this.send({ op: 'ping' });
+    }, 30000);
+  }
+
+  private stopPing() {
+    if (this.pingTimer) {
+      clearInterval(this.pingTimer);
+      this.pingTimer = null;
+    }
+  }
+
+  private scheduleReconnect() {
+    if (this.reconnectAttempts >= this.options.maxReconnectAttempts) {
+      this.emit('error', { op: 'error', code: 'MAX_RECONNECT', message: 'Max reconnection attempts reached' } as WsServerOp);
+      return;
+    }
+    this.reconnectAttempts++;
+    this.reconnectTimer = setTimeout(() => {
+      this.connect().catch(() => {
+        // will retry via close handler
+      });
+    }, this.options.reconnectIntervalMs);
+  }
+
+  send(op: WsClientOp) {
+    if (this.ws?.readyState === WebSocket.OPEN) {
+      this.ws.send(JSON.stringify(op));
+    }
+  }
+
+  subscribe(channels: string[]) {
+    this.send({ op: 'subscribe', channels });
+  }
+
+  unsubscribe(channels: string[]) {
+    this.send({ op: 'unsubscribe', channels });
+  }
+
+  sendMessage(channel: string, content: string, contentType?: 'text' | 'code') {
+    this.send({ op: 'message', channel, content, contentType });
+  }
+
+  sendTyping(channel: string) {
+    this.send({ op: 'typing', channel });
+  }
+
+  on(event: string, handler: EventHandler) {
+    if (!this.handlers.has(event)) {
+      this.handlers.set(event, new Set());
+    }
+    this.handlers.get(event)!.add(handler);
+    return () => this.off(event, handler);
+  }
+
+  off(event: string, handler: EventHandler) {
+    this.handlers.get(event)?.delete(handler);
+  }
+
+  private emit(event: string, data: WsServerOp) {
+    this.handlers.get(event)?.forEach(h => h(data));
+    this.handlers.get('*')?.forEach(h => h(data));
+  }
+
+  disconnect() {
+    this.closed = true;
+    this.stopPing();
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+  }
+
+  get connected(): boolean {
+    return this.ws?.readyState === WebSocket.OPEN;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}