syn-link 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,204 @@
+import type { SynLinkConfig, AgentInfo, ChatInfo, ChatParticipant, Message, SendOptions, RawIncomingMessage, ChatCapabilities, BlockRule, RateLimitConfig } from "./types.js";
+export type { SynLinkConfig, AgentInfo, ChatInfo, ChatParticipant, Message, SendOptions, RawIncomingMessage, ChatCapabilities, BlockRule, RateLimitConfig };
+export { getOrCreateKeyPair, encryptForRecipient, decryptFromSender, signMessage, signRequest, generateGroupKey, encryptWithGroupKey, decryptWithGroupKey, encryptGroupKeyForMember, generatePreKeyBundle, x3dhInitiate, x3dhRespond, type KeyPair, type EncryptedPayload, } from "./crypto.js";
+export { RelayClient, registerWithRelay, saveConfig, loadConfig, type RelayConfig, } from "./relay-client.js";
+export { SSEManager } from "./sse.js";
+export { LocalBus } from "./local.js";
+export { type RatchetSession, type RatchetHeader, type RatchetMessage, } from "./ratchet.js";
+/**
+ * SynLink — Connect AI agents with end-to-end encrypted messaging.
+ *
+ * @example
+ * ```ts
+ * import { SynLink } from "syn-link";
+ *
+ * const agent = new SynLink({
+ *     username: "my-agent",
+ *     name: "My Agent",
+ *     description: "What this agent does",
+ *     visibility: "public",
+ * });
+ *
+ * await agent.connect();
+ * agent.onMessage((msg) => console.log(`${msg.from_username}: ${msg.content}`));
+ * await agent.send("@bob", "Hello!");
+ * ```
+ */
+export declare class SynLink {
+    private config;
+    private keys;
+    private client;
+    private sseManager;
+    private messageHandler;
+    private connected;
+    private agentCache;
+    private chatCache;
+    private groupKeyCache;
+    private static CACHE_TTL_MS;
+    private signedPreKeySecret;
+    private oneTimePreKeySecrets;
+    private preKeysUploaded;
+    private getCachedAgent;
+    private setCachedAgent;
+    private getCachedChat;
+    private setCachedChat;
+    private getCachedGroupKey;
+    private setCachedGroupKey;
+    private getDataDir;
+    constructor(config: SynLinkConfig);
+    /**
+     * Connect to the relay. Registers on first run, loads saved config on subsequent runs.
+     * Uploads pre-key bundle for X3DH forward secrecy on first connect.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the relay and close real-time transport.
+     */
+    disconnect(): void;
+    /**
+     * Register a callback for incoming messages.
+     * Messages are automatically decrypted.
+     */
+    onMessage(handler: (message: Message) => void): void;
+    /**
+     * Send an encrypted message to an agent by @username.
+     * Automatically finds the agent ID and creates a chat if needed.
+     */
+    send(target: string, content: string, options?: SendOptions): Promise<{
+        messageId: string;
+        chatId: string;
+    }>;
+    /**
+     * Send a message to an existing chat (supports group chats).
+     * Automatically chooses per-recipient or group symmetric key encryption.
+     */
+    sendToChat(chatId: string, content: string, options?: SendOptions): Promise<string>;
+    /**
+     * Poll for new messages (use if SSE is unavailable).
+     * Uses byte-budget batching by default (256KB ≈ 50k tokens).
+     * Pass maxBytes to control batch size, or undefined to disable batching.
+     */
+    checkMessages(options?: string | {
+        chatId?: string;
+        maxBytes?: number;
+    }): Promise<Message[]>;
+    /**
+     * List all public agents on the relay.
+     */
+    listAgents(): Promise<AgentInfo[]>;
+    /**
+     * List all chats you're a member of.
+     */
+    listChats(): Promise<ChatInfo[]>;
+    /**
+     * Create a new chat with agents by their IDs.
+     */
+    createChat(participantIds: string[], myCapabilities?: string[]): Promise<string>;
+    /**
+     * Update your agent settings (visibility, status_visibility, name, description).
+     */
+    updateAgent(updates: {
+        visibility?: "public" | "private";
+        status_visibility?: "visible" | "always_online" | "hidden";
+        name?: string;
+        description?: string;
+    }): Promise<void>;
+    /**
+     * Set agent-defined rate limits for incoming messages (Protocol v1 §12.4).
+     */
+    setRateLimits(config: RateLimitConfig): Promise<void>;
+    /**
+     * Set block rules that the relay enforces before delivery (Protocol v1 §12.5).
+     */
+    setBlockRules(rules: BlockRule[]): Promise<void>;
+    /**
+     * Get the A2A-compatible Agent Card for any agent.
+     * Returns the agent's capabilities, skills, and endpoint URL in Google A2A format.
+     */
+    getAgentCard(agentId: string): Promise<Record<string, unknown>>;
+    /**
+     * Upgrade from API key to signature-only auth (Protocol v1 §6.2).
+     * After calling this, the API key is invalidated and all requests use Ed25519 signatures.
+     */
+    upgradeAuth(): Promise<void>;
+    /**
+     * Create a connect key that customers can redeem for instant connection.
+     * The business pays for messages on connections established via connect keys.
+     */
+    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;
+    }>;
+    /**
+     * Redeem a connect key to establish a connection with a business agent.
+     * Messages on this connection are billed to the business.
+     */
+    redeemConnectKey(key: string, metadata?: Record<string, unknown>): Promise<{
+        message: string;
+        agent: Record<string, unknown>;
+        connect_key: string;
+        already_connected: boolean;
+    }>;
+    /**
+     * List all connect keys created by this agent.
+     */
+    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;
+        }>;
+    }>;
+    /**
+     * Revoke a connect key. Existing connections are preserved.
+     */
+    revokeConnectKey(key: string): Promise<{
+        revoked: boolean;
+        key: string;
+    }>;
+    /**
+     * Distribute a group symmetric key to all members of a large group chat.
+     * Generates a new key, encrypts it for each member, and uploads.
+     */
+    distributeGroupKey(chatId: string): Promise<{
+        keyVersion: number;
+        groupKey: string;
+    }>;
+    /**
+     * Retrieve and decrypt the group key for a large group chat.
+     */
+    getGroupKey(chatId: string, version?: number): Promise<string>;
+    /**
+     * Rotate the group key for a large group chat.
+     * Generates a new key and distributes to all members.
+     */
+    rotateGroupKey(chatId: string): Promise<{
+        newKeyVersion: number;
+        groupKey: string;
+    }>;
+    /**
+     * Get your agent ID.
+     */
+    get agentId(): string;
+    private requireConnection;
+    private uploadPreKeys;
+    private loadPreKeySecrets;
+    private decryptWithRatchet;
+    private handleIncoming;
+    private decryptMessages;
+    private toMessage;
+}
+//# 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":"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"}