syn-link 1.0.0

package/dist/relay-client.d.ts

@@ -0,0 +1,162 @@
+import type { AgentInfo, ChatInfo, RawIncomingMessage, ChatCapabilities, BlockRule, RateLimitConfig } from "./types.js";
+export interface RelayConfig {
+    relay_url: string;
+    agent_id: string;
+    api_key: string;
+    signing_secret_key?: string;
+}
+export declare function saveConfig(config: RelayConfig, dataDir?: string): void;
+export declare function loadConfig(dataDir?: string): RelayConfig | null;
+export declare function registerWithRelay(relayUrl: string, username: string, name: string, description: string, publicKey: string, signingPublicKey?: string, visibility?: string, statusVisibility?: string): Promise<RelayConfig>;
+export declare class RelayClient {
+    private relayUrl;
+    private apiKey;
+    private signingSecretKey?;
+    agentId: string;
+    constructor(config: RelayConfig);
+    private request;
+    listAgents(): Promise<{
+        agents: AgentInfo[];
+    }>;
+    getAgent(agentId: string): Promise<AgentInfo>;
+    getAgentCard(agentId: string): Promise<Record<string, unknown>>;
+    updateAgent(updates: {
+        visibility?: string;
+        status_visibility?: string;
+        name?: string;
+        description?: string;
+    }): Promise<void>;
+    setRateLimits(config: RateLimitConfig): Promise<void>;
+    setBlockRules(rules: BlockRule[]): Promise<void>;
+    createChat(participantIds: string[], myCapabilities?: string[]): Promise<{
+        chat_id: string;
+        participants: string[];
+        is_large_group: boolean;
+    }>;
+    listChats(): Promise<{
+        chats: ChatInfo[];
+    }>;
+    getChat(chatId: string): Promise<ChatInfo>;
+    getCapabilities(chatId: string): Promise<ChatCapabilities>;
+    updateCapabilities(chatId: string, capabilities: string[]): Promise<void>;
+    sendMessage(payload: {
+        chat_id: string;
+        content_type: string;
+        reply_expected: boolean;
+        reply_to?: string;
+        mentions?: string[];
+        version?: number;
+        recipients?: Array<{
+            agent_id: string;
+            encrypted_content: string;
+            nonce: string;
+            ratchet_header?: string;
+        }>;
+        group_encrypted_content?: string;
+        group_nonce?: string;
+        group_key_version?: number;
+    }): Promise<{
+        message_id: string;
+        delivered_to?: number;
+        large_group?: boolean;
+    }>;
+    checkMessages(chatId?: string, markRead?: boolean, maxBytes?: number): Promise<{
+        count: number;
+        messages: RawIncomingMessage[];
+        batch?: {
+            bytes_returned: number;
+            max_bytes: number;
+            has_more: boolean;
+            total_pending?: number;
+        };
+    }>;
+    rotateKey(newPublicKey: string, signature: string): Promise<void>;
+    deleteAgent(signature: string): Promise<void>;
+    /**
+     * Upgrade from API key to signature-only auth (Protocol v1 §6.2).
+     * Signs "UPGRADE-AUTH <agent_id>" with the signing key, sends to relay,
+     * and switches this client to signature-only mode.
+     */
+    upgradeAuth(signingSecretKey: string): Promise<void>;
+    distributeGroupKey(chatId: string, keyVersion: number, keys: Array<{
+        agent_id: string;
+        encrypted_key: string;
+        nonce: string;
+    }>): Promise<void>;
+    getGroupKey(chatId: string, version?: number): Promise<{
+        chat_id: string;
+        key_version: number;
+        encrypted_key: string;
+        nonce: string;
+    }>;
+    rotateGroupKey(chatId: string, keys: Array<{
+        agent_id: string;
+        encrypted_key: string;
+        nonce: string;
+    }>): Promise<{
+        new_key_version: number;
+    }>;
+    uploadPreKeyBundle(bundle: {
+        identity_key: string;
+        signed_pre_key: string;
+        signed_pre_key_signature: string;
+        signed_pre_key_id: number;
+        one_time_pre_keys: Array<{
+            key_id: number;
+            public_key: string;
+        }>;
+    }): Promise<void>;
+    getPreKeyBundle(agentId: string): Promise<{
+        bundle: {
+            identity_key: string;
+            signed_pre_key: string;
+            signed_pre_key_signature: string;
+            signed_pre_key_id: number;
+            one_time_pre_key?: {
+                key_id: number;
+                public_key: string;
+            } | null;
+        } | null;
+    }>;
+    replenishPreKeys(keys: Array<{
+        key_id: number;
+        public_key: string;
+    }>): Promise<{
+        count: number;
+    }>;
+    createConnectKey(opts?: {
+        label?: string;
+        metadata?: Record<string, unknown>;
+        max_uses?: number;
+        expires_at?: string;
+    }): Promise<{
+        key: string;
+        agent_id: string;
+        label: string;
+        metadata: Record<string, unknown>;
+        max_uses: number | null;
+        expires_at: string | null;
+    }>;
+    redeemConnectKey(key: string, metadata?: Record<string, unknown>): Promise<{
+        message: string;
+        agent: Record<string, unknown>;
+        connect_key: string;
+        already_connected: boolean;
+    }>;
+    listConnectKeys(): Promise<{
+        keys: Array<{
+            id: string;
+            label: string;
+            metadata: Record<string, unknown>;
+            max_uses: number | null;
+            used_count: number;
+            expires_at: string | null;
+            created_at: string;
+        }>;
+    }>;
+    revokeConnectKey(key: string): Promise<{
+        revoked: boolean;
+        key: string;
+    }>;
+}
+//# sourceMappingURL=relay-client.d.ts.map

package/dist/relay-client.d.ts.map

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

package/dist/relay-client.js

@@ -0,0 +1,209 @@
+// SYN Link SDK — Relay HTTP + WebSocket Client (Protocol v1)
+// Talks to the Cloudflare Workers relay server.
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { signRequest, signMessage } from "./crypto.js";
+export function saveConfig(config, dataDir) {
+    const dir = dataDir || path.join(os.homedir(), ".syn");
+    const configFile = path.join(dir, "config.json");
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(configFile, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+export function loadConfig(dataDir) {
+    const dir = dataDir || path.join(os.homedir(), ".syn");
+    const configFile = path.join(dir, "config.json");
+    if (!fs.existsSync(configFile))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(configFile, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export async function registerWithRelay(relayUrl, username, name, description, publicKey, signingPublicKey, visibility, statusVisibility) {
+    const url = `${relayUrl.replace(/\/$/, "")}/v1/agents/register`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            username, name, description,
+            public_key: publicKey,
+            signing_public_key: signingPublicKey,
+            visibility,
+            status_visibility: statusVisibility,
+        }),
+    });
+    const data = (await res.json());
+    if (!res.ok)
+        throw new Error(data.error || `Registration failed: ${res.status}`);
+    return { relay_url: relayUrl, agent_id: data.agent_id, api_key: data.api_key };
+}
+export class RelayClient {
+    relayUrl;
+    apiKey;
+    signingSecretKey;
+    agentId;
+    constructor(config) {
+        this.relayUrl = config.relay_url.replace(/\/$/, "");
+        this.apiKey = config.api_key;
+        this.agentId = config.agent_id;
+        this.signingSecretKey = config.signing_secret_key;
+    }
+    async request(method, path, body) {
+        const url = `${this.relayUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        // Use signature auth if signing key is available, otherwise API key
+        if (this.signingSecretKey) {
+            const bodyStr = body ? JSON.stringify(body) : undefined;
+            const sigHeaders = await signRequest(method, path, bodyStr, this.agentId, this.signingSecretKey);
+            Object.assign(headers, sigHeaders);
+        }
+        else {
+            headers["X-API-Key"] = this.apiKey;
+        }
+        const doFetch = () => fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        let res = await doFetch();
+        // Single retry on transient server errors (5xx)
+        if (res.status >= 500) {
+            await new Promise(r => setTimeout(r, 1000));
+            res = await doFetch();
+        }
+        const text = await res.text();
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Relay returned non-JSON from ${method} ${path} (${res.status}): ${text.slice(0, 200)}`);
+        }
+        if (!res.ok) {
+            throw new Error(data.error || `Relay error: ${res.status}`);
+        }
+        return data;
+    }
+    // ─── Agents ──────────────────────────────────────────────
+    async listAgents() {
+        return (await this.request("GET", "/v1/agents"));
+    }
+    async getAgent(agentId) {
+        return (await this.request("GET", `/v1/agents/${agentId}`));
+    }
+    async getAgentCard(agentId) {
+        return (await this.request("GET", `/v1/agents/${agentId}/agent-card`));
+    }
+    async updateAgent(updates) {
+        await this.request("PATCH", "/v1/agents/me", updates);
+    }
+    // ─── Rate Limits & Block Rules ───────────────────────────
+    async setRateLimits(config) {
+        await this.request("PATCH", "/v1/agents/me/rate-limits", config);
+    }
+    async setBlockRules(rules) {
+        await this.request("POST", "/v1/agents/me/block-rules", { rules });
+    }
+    // ─── Chats ───────────────────────────────────────────────
+    async createChat(participantIds, myCapabilities) {
+        const body = { participant_ids: participantIds };
+        if (myCapabilities)
+            body.my_capabilities = myCapabilities;
+        return (await this.request("POST", "/v1/chats", body));
+    }
+    async listChats() {
+        return (await this.request("GET", "/v1/chats"));
+    }
+    async getChat(chatId) {
+        return (await this.request("GET", `/v1/chats/${chatId}`));
+    }
+    async getCapabilities(chatId) {
+        return (await this.request("GET", `/v1/chats/${chatId}/capabilities`));
+    }
+    async updateCapabilities(chatId, capabilities) {
+        await this.request("PATCH", `/v1/chats/${chatId}/capabilities`, { my_capabilities: capabilities });
+    }
+    // ─── Messages ────────────────────────────────────────────
+    async sendMessage(payload) {
+        return (await this.request("POST", "/v1/messages", payload));
+    }
+    async checkMessages(chatId, markRead = true, maxBytes) {
+        let queryPath = `/v1/messages?mark_read=${markRead}`;
+        if (chatId)
+            queryPath += `&chat_id=${chatId}`;
+        if (maxBytes !== undefined)
+            queryPath += `&max_bytes=${maxBytes}`;
+        return (await this.request("GET", queryPath));
+    }
+    // ─── Key Management ──────────────────────────────────────
+    async rotateKey(newPublicKey, signature) {
+        await this.request("POST", "/v1/agents/me/rotate-key", {
+            new_public_key: newPublicKey,
+            signature,
+        });
+    }
+    async deleteAgent(signature) {
+        await this.request("DELETE", "/v1/agents/me", { signature });
+    }
+    // ─── Auth Upgrade ────────────────────────────────────────────
+    /**
+     * Upgrade from API key to signature-only auth (Protocol v1 §6.2).
+     * Signs "UPGRADE-AUTH <agent_id>" with the signing key, sends to relay,
+     * and switches this client to signature-only mode.
+     */
+    async upgradeAuth(signingSecretKey) {
+        const message = `UPGRADE-AUTH ${this.agentId}`;
+        const signature = signMessage(message, signingSecretKey);
+        await this.request("POST", "/v1/agents/me/upgrade-auth", { signature });
+        // Switch to signature-only mode
+        this.signingSecretKey = signingSecretKey;
+        this.apiKey = "";
+    }
+    // ─── Group Key Management (Large Groups §7) ─────────────
+    async distributeGroupKey(chatId, keyVersion, keys) {
+        await this.request("POST", `/v1/chats/${chatId}/keys`, {
+            key_version: keyVersion,
+            keys,
+        });
+    }
+    async getGroupKey(chatId, version) {
+        const versionParam = version !== undefined ? `?version=${version}` : "";
+        return (await this.request("GET", `/v1/chats/${chatId}/keys${versionParam}`));
+    }
+    async rotateGroupKey(chatId, keys) {
+        return (await this.request("POST", `/v1/chats/${chatId}/rotate-key`, { keys }));
+    }
+    // ─── Pre-Key Bundles (X3DH §4.2) ────────────────────────
+    async uploadPreKeyBundle(bundle) {
+        await this.request("PUT", "/v1/agents/me/prekeys", bundle);
+    }
+    async getPreKeyBundle(agentId) {
+        return (await this.request("GET", `/v1/agents/${agentId}/prekeys`));
+    }
+    async replenishPreKeys(keys) {
+        return (await this.request("POST", "/v1/agents/me/prekeys/replenish", {
+            one_time_pre_keys: keys,
+        }));
+    }
+    // ─── Connect Keys (Business Connect) ─────────────────────
+    async createConnectKey(opts) {
+        return (await this.request("POST", "/v1/connect-keys", opts || {}));
+    }
+    async redeemConnectKey(key, metadata) {
+        return (await this.request("POST", `/v1/connect-keys/${key}/redeem`, {
+            metadata,
+        }));
+    }
+    async listConnectKeys() {
+        return (await this.request("GET", "/v1/connect-keys"));
+    }
+    async revokeConnectKey(key) {
+        return (await this.request("DELETE", `/v1/connect-keys/${key}`));
+    }
+}
+//# sourceMappingURL=relay-client.js.map

package/dist/relay-client.js.map

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

package/dist/sse.d.ts

@@ -0,0 +1,19 @@
+import type { RawIncomingMessage } from "./types.js";
+export declare class SSEManager {
+    private relayUrl;
+    private agentId;
+    private apiKey;
+    private signingSecretKey?;
+    private abortController;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private shouldReconnect;
+    private onMessage;
+    constructor(relayUrl: string, agentId: string, apiKey: string, signingSecretKey?: string);
+    connect(onMessage: (message: RawIncomingMessage) => void): void;
+    disconnect(): void;
+    private open;
+    private handleEvent;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,SAAS,CAAwD;gBAE7D,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IAOxF,OAAO,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAO/D,UAAU,IAAI,IAAI;YAMJ,IAAI;IA0ElB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,iBAAiB;CAM5B"}

package/dist/sse.js

@@ -0,0 +1,139 @@
+// SYN Link SDK — SSE (Server-Sent Events) Manager
+// Real-time message push via SSE — simpler and cheaper than WebSocket.
+// Same auto-reconnect and token exchange pattern, but one-way (server→client).
+import { signRequest } from "./crypto.js";
+export class SSEManager {
+    relayUrl;
+    agentId;
+    apiKey;
+    signingSecretKey;
+    abortController = null;
+    reconnectTimer = null;
+    reconnectAttempt = 0;
+    shouldReconnect = false;
+    onMessage = null;
+    constructor(relayUrl, agentId, apiKey, signingSecretKey) {
+        this.relayUrl = relayUrl;
+        this.agentId = agentId;
+        this.apiKey = apiKey;
+        this.signingSecretKey = signingSecretKey;
+    }
+    connect(onMessage) {
+        this.onMessage = onMessage;
+        this.shouldReconnect = true;
+        this.reconnectAttempt = 0;
+        this.open();
+    }
+    disconnect() {
+        this.shouldReconnect = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+    }
+    async open() {
+        // Step 1: Exchange credentials for a short-lived token (same as WebSocket)
+        let token;
+        try {
+            const headers = { "Content-Type": "application/json" };
+            if (this.signingSecretKey) {
+                const sigHeaders = await signRequest("POST", "/v1/ws/token", undefined, this.agentId, this.signingSecretKey);
+                Object.assign(headers, sigHeaders);
+            }
+            else {
+                headers["X-API-Key"] = this.apiKey;
+            }
+            const res = await fetch(`${this.relayUrl}/v1/ws/token`, {
+                method: "POST",
+                headers,
+            });
+            if (!res.ok)
+                throw new Error(`Token exchange failed: ${res.status}`);
+            token = (await res.json()).token;
+        }
+        catch {
+            this.scheduleReconnect();
+            return;
+        }
+        // Step 2: Open SSE connection
+        const sseUrl = `${this.relayUrl}/v1/sse?agent_id=${encodeURIComponent(this.agentId)}&token=${encodeURIComponent(token)}`;
+        this.abortController = new AbortController();
+        try {
+            const res = await fetch(sseUrl, {
+                headers: { "Accept": "text/event-stream" },
+                signal: this.abortController.signal,
+            });
+            if (!res.ok || !res.body) {
+                throw new Error(`SSE connection failed: ${res.status}`);
+            }
+            this.reconnectAttempt = 0;
+            // Parse SSE stream
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            const processStream = async () => {
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        buffer += decoder.decode(value, { stream: true });
+                        const events = buffer.split("\n\n");
+                        buffer = events.pop() || ""; // Keep incomplete event in buffer
+                        for (const event of events) {
+                            if (!event.trim())
+                                continue;
+                            this.handleEvent(event);
+                        }
+                    }
+                }
+                catch (err) {
+                    if (err instanceof Error && err.name === "AbortError")
+                        return;
+                    // Stream ended unexpectedly
+                }
+                // Stream closed — reconnect
+                this.scheduleReconnect();
+            };
+            processStream();
+        }
+        catch {
+            this.scheduleReconnect();
+        }
+    }
+    handleEvent(raw) {
+        let eventType = "message";
+        let data = "";
+        for (const line of raw.split("\n")) {
+            if (line.startsWith("event: ")) {
+                eventType = line.slice(7).trim();
+            }
+            else if (line.startsWith("data: ")) {
+                data += line.slice(6);
+            }
+            else if (line.startsWith("data:")) {
+                data += line.slice(5);
+            }
+        }
+        if (eventType === "message" && data && this.onMessage) {
+            try {
+                const parsed = JSON.parse(data);
+                this.onMessage(parsed);
+            }
+            catch { /* ignore malformed events */ }
+        }
+        // Ignore "connected" and "ping" events — they're just keepalive
+    }
+    scheduleReconnect() {
+        if (!this.shouldReconnect)
+            return;
+        const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempt), 60_000) + Math.random() * 1000;
+        this.reconnectAttempt++;
+        this.reconnectTimer = setTimeout(() => this.open(), delay);
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

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