@agentick/core 0.0.1

package/dist/channels/transports/streamable-http.js

@@ -0,0 +1,353 @@
+/**
+ * StreamableHTTPTransport implements bidirectional HTTP communication.
+ *
+ * Architecture:
+ * - Client -> Server: HTTP POST requests (with event.target for room routing)
+ * - Server -> Client: Server-Sent Events (SSE) stream
+ *
+ * Room management:
+ * - Client sends join-room/leave-room requests
+ * - Server tracks room membership
+ * - Events with target.rooms are routed by server
+ *
+ * This follows the MCP Streamable HTTP pattern but adapted for channels.
+ */
+export class StreamableHTTPTransport {
+    name = "streamable-http";
+    config;
+    currentConnectionId;
+    connectionMetadata;
+    eventSource;
+    receiveHandler;
+    reconnectAttempts = 0;
+    reconnectTimer;
+    isConnected = false;
+    channelFilter;
+    joinedRooms = new Set();
+    constructor(config) {
+        this.config = {
+            ...config,
+            headers: config.headers || {},
+            timeout: config.timeout || 30000,
+            reconnectDelay: config.reconnectDelay || 1000,
+            maxReconnectAttempts: config.maxReconnectAttempts || 10,
+        };
+        // Add auth header if token provided
+        if (this.config.token) {
+            this.config.headers["Authorization"] = `Bearer ${this.config.token}`;
+        }
+        // Set content type for POST requests
+        this.config.headers["Content-Type"] = "application/json";
+    }
+    /**
+     * Connect to the transport with optional metadata.
+     * Opens SSE connection for receiving events.
+     */
+    async connect(connectionId, metadata) {
+        this.currentConnectionId = connectionId;
+        this.connectionMetadata = metadata;
+        this.channelFilter = metadata?.channels;
+        this.reconnectAttempts = 0;
+        await this.connectSSE();
+    }
+    /**
+     * Connect to Server-Sent Events stream
+     */
+    async connectSSE() {
+        if (!this.currentConnectionId) {
+            throw new Error("Connection ID required for connection");
+        }
+        // Close existing connection if any
+        this.disconnect().catch(() => { });
+        try {
+            // Build SSE URL with connection ID and metadata
+            const url = new URL(`${this.config.url}/sse`);
+            url.searchParams.set("connectionId", this.currentConnectionId);
+            if (this.channelFilter && this.channelFilter.length > 0) {
+                url.searchParams.set("channels", this.channelFilter.join(","));
+            }
+            if (this.connectionMetadata?.userId) {
+                url.searchParams.set("userId", this.connectionMetadata.userId);
+            }
+            const sseUrl = url.toString();
+            // Create EventSource for SSE (browser) or use fetch with streaming (Node.js)
+            if (typeof EventSource !== "undefined") {
+                // Browser environment
+                this.eventSource = new EventSource(sseUrl, {
+                    withCredentials: false,
+                });
+                this.eventSource.onmessage = (event) => {
+                    try {
+                        const channelEvent = JSON.parse(event.data);
+                        // Apply excludeSender filtering
+                        const sourceConnectionId = channelEvent.metadata?.["sourceConnectionId"];
+                        if (channelEvent.target?.excludeSender &&
+                            sourceConnectionId === this.currentConnectionId) {
+                            return; // Skip - we're the sender
+                        }
+                        if (this.receiveHandler) {
+                            this.receiveHandler(channelEvent);
+                        }
+                    }
+                    catch (error) {
+                        console.error("Failed to parse SSE event:", error);
+                    }
+                };
+                this.eventSource.onerror = (error) => {
+                    console.error("SSE connection error:", error);
+                    this.handleReconnect();
+                };
+                this.eventSource.onopen = () => {
+                    this.isConnected = true;
+                    this.reconnectAttempts = 0;
+                    // Auto-join rooms after connection
+                    if (this.config.autoJoinRooms && this.connectionMetadata) {
+                        const autoRooms = this.config.autoJoinRooms(this.connectionMetadata);
+                        for (const room of autoRooms) {
+                            if (room) {
+                                this.join(this.currentConnectionId, room);
+                            }
+                        }
+                    }
+                };
+            }
+            else {
+                // Node.js environment - use fetch with streaming
+                await this.connectSSENode();
+            }
+        }
+        catch (error) {
+            console.error("Failed to connect SSE:", error);
+            this.handleReconnect();
+            throw error;
+        }
+    }
+    /**
+     * Connect to SSE stream in Node.js environment using fetch
+     */
+    async connectSSENode() {
+        if (!this.currentConnectionId) {
+            throw new Error("Connection ID required for connection");
+        }
+        // Build SSE URL with connection ID and metadata
+        const url = new URL(`${this.config.url}/sse`);
+        url.searchParams.set("connectionId", this.currentConnectionId);
+        if (this.channelFilter && this.channelFilter.length > 0) {
+            url.searchParams.set("channels", this.channelFilter.join(","));
+        }
+        if (this.connectionMetadata?.userId) {
+            url.searchParams.set("userId", this.connectionMetadata.userId);
+        }
+        const sseUrl = url.toString();
+        try {
+            const response = await fetch(sseUrl, {
+                method: "GET",
+                headers: {
+                    ...this.config.headers,
+                    Accept: "text/event-stream",
+                },
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!response.ok) {
+                throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);
+            }
+            if (!response.body) {
+                throw new Error("SSE stream body is null");
+            }
+            this.isConnected = true;
+            this.reconnectAttempts = 0;
+            // Auto-join rooms after connection
+            if (this.config.autoJoinRooms && this.connectionMetadata) {
+                const autoRooms = this.config.autoJoinRooms(this.connectionMetadata);
+                for (const room of autoRooms) {
+                    if (room) {
+                        this.join(this.currentConnectionId, room);
+                    }
+                }
+            }
+            // Read SSE stream
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = "";
+            const readStream = async () => {
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done) {
+                            this.isConnected = false;
+                            this.handleReconnect();
+                            break;
+                        }
+                        buffer += decoder.decode(value, { stream: true });
+                        const lines = buffer.split("\n");
+                        buffer = lines.pop() || "";
+                        for (const line of lines) {
+                            if (line.startsWith("data: ")) {
+                                try {
+                                    const data = line.slice(6);
+                                    const channelEvent = JSON.parse(data);
+                                    // Apply excludeSender filtering
+                                    const sourceConnectionId = channelEvent.metadata?.["sourceConnectionId"];
+                                    if (channelEvent.target?.excludeSender &&
+                                        sourceConnectionId === this.currentConnectionId) {
+                                        continue;
+                                    }
+                                    if (this.receiveHandler) {
+                                        this.receiveHandler(channelEvent);
+                                    }
+                                }
+                                catch (error) {
+                                    console.error("Failed to parse SSE event:", error);
+                                }
+                            }
+                        }
+                    }
+                }
+                catch (error) {
+                    console.error("Error reading SSE stream:", error);
+                    this.isConnected = false;
+                    this.handleReconnect();
+                }
+            };
+            readStream();
+        }
+        catch (error) {
+            this.isConnected = false;
+            throw error;
+        }
+    }
+    /**
+     * Handle reconnection logic
+     */
+    handleReconnect() {
+        if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {
+            console.error("Max reconnection attempts reached");
+            return;
+        }
+        this.reconnectAttempts++;
+        const delay = this.config.reconnectDelay * this.reconnectAttempts;
+        this.reconnectTimer = setTimeout(() => {
+            if (this.currentConnectionId) {
+                this.connectSSE().catch((error) => {
+                    console.error("Reconnection failed:", error);
+                });
+            }
+        }, delay);
+    }
+    /**
+     * Join a room (sends HTTP request to server).
+     */
+    async join(connectionId, room) {
+        try {
+            const response = await fetch(`${this.config.url}/rooms/join`, {
+                method: "POST",
+                headers: this.config.headers,
+                body: JSON.stringify({
+                    connectionId: this.currentConnectionId,
+                    room,
+                }),
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to join room: ${response.status}`);
+            }
+            this.joinedRooms.add(room);
+            console.log(`StreamableHTTP: joined room ${room}`);
+        }
+        catch (error) {
+            console.error(`Failed to join room ${room}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Leave a room (sends HTTP request to server).
+     */
+    async leave(connectionId, room) {
+        try {
+            const response = await fetch(`${this.config.url}/rooms/leave`, {
+                method: "POST",
+                headers: this.config.headers,
+                body: JSON.stringify({
+                    connectionId: this.currentConnectionId,
+                    room,
+                }),
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to leave room: ${response.status}`);
+            }
+            this.joinedRooms.delete(room);
+            console.log(`StreamableHTTP: left room ${room}`);
+        }
+        catch (error) {
+            console.error(`Failed to leave room ${room}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Get rooms this connection has joined.
+     */
+    getConnectionRooms(_connectionId) {
+        return Array.from(this.joinedRooms);
+    }
+    /**
+     * Disconnect from transport
+     */
+    async disconnect(_connectionId) {
+        this.isConnected = false;
+        this.joinedRooms.clear();
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        if (this.eventSource) {
+            this.eventSource.close();
+            this.eventSource = undefined;
+        }
+        this.currentConnectionId = undefined;
+        this.connectionMetadata = undefined;
+    }
+    /**
+     * Send an event through HTTP POST.
+     * Server handles room routing based on event.target.
+     */
+    async send(event) {
+        if (!this.currentConnectionId) {
+            throw new Error("Not connected. Call connect() first.");
+        }
+        try {
+            const response = await fetch(`${this.config.url}/events`, {
+                method: "POST",
+                headers: this.config.headers,
+                body: JSON.stringify({
+                    ...event,
+                    metadata: {
+                        ...event.metadata,
+                        sourceConnectionId: this.currentConnectionId,
+                    },
+                }),
+                signal: AbortSignal.timeout(this.config.timeout),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to send event: ${response.status} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            console.error("Failed to send event:", error);
+            throw error;
+        }
+    }
+    /**
+     * Close all connections.
+     */
+    closeAll() {
+        this.disconnect();
+    }
+    /**
+     * Register handler for events received from transport
+     */
+    onReceive(handler) {
+        this.receiveHandler = handler;
+    }
+}
+//# sourceMappingURL=streamable-http.js.map

package/dist/channels/transports/streamable-http.js.map

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

package/dist/channels/transports/websocket.d.ts

@@ -0,0 +1,117 @@
+import type { ChannelTransport, ChannelEvent, ConnectionMetadata, ChannelTransportConfig } from "../service";
+/**
+ * Configuration for WebSocketTransport
+ */
+export interface WebSocketTransportConfig extends ChannelTransportConfig {
+    /**
+     * WebSocket URL (e.g., 'ws://localhost:3000' or 'wss://api.example.com')
+     * Required if socket is not provided.
+     */
+    url?: string;
+    /**
+     * Existing WebSocket connection to reuse.
+     * If provided, url and other connection options are ignored.
+     * The socket should already be connected or will be connected externally.
+     */
+    socket?: WebSocket | any;
+    /**
+     * Optional headers to include in WebSocket handshake
+     */
+    headers?: Record<string, string>;
+    /**
+     * Optional authentication token (sent as query param or header)
+     */
+    token?: string;
+    /**
+     * Reconnect delay in milliseconds (default: 1000)
+     * Ignored if socket is provided.
+     */
+    reconnectDelay?: number;
+    /**
+     * Maximum number of reconnection attempts (default: 10)
+     * Ignored if socket is provided.
+     */
+    maxReconnectAttempts?: number;
+    /**
+     * WebSocket protocols (default: [])
+     */
+    protocols?: string[];
+}
+/**
+ * WebSocketTransport implements bidirectional WebSocket communication.
+ *
+ * Room management is handled server-side. Client:
+ * - Sends join-room/leave-room messages
+ * - Includes event.target in sends for server to route
+ * - Server filters based on room membership
+ *
+ * Uses native WebSocket API in browser or 'ws' package in Node.js.
+ */
+export declare class WebSocketTransport implements ChannelTransport {
+    readonly name = "websocket";
+    private config;
+    private currentConnectionId?;
+    private connectionMetadata?;
+    private ws?;
+    private receiveHandler?;
+    private reconnectAttempts;
+    private reconnectTimer?;
+    private isConnected;
+    private wsModule?;
+    private channelFilter?;
+    private joinedRooms;
+    constructor(config: WebSocketTransportConfig);
+    /**
+     * Connect to the transport with optional metadata.
+     */
+    connect(connectionId: string, metadata?: ConnectionMetadata & {
+        channels?: string[];
+    }): Promise<void>;
+    /**
+     * Setup event handlers on existing socket
+     */
+    private setupSocketHandlers;
+    /**
+     * Connect to WebSocket
+     */
+    private connectWebSocket;
+    private setupBrowserWebSocket;
+    /**
+     * Connect to WebSocket in Node.js environment using 'ws' package
+     */
+    private connectWebSocketNode;
+    /**
+     * Handle reconnection logic
+     */
+    private handleReconnect;
+    /**
+     * Join a room (sends message to server).
+     */
+    join(connectionId: string, room: string): Promise<void>;
+    /**
+     * Leave a room (sends message to server).
+     */
+    leave(connectionId: string, room: string): Promise<void>;
+    /**
+     * Get rooms this connection has joined.
+     */
+    getConnectionRooms(_connectionId: string): string[];
+    /**
+     * Disconnect from transport.
+     */
+    disconnect(_connectionId?: string): Promise<void>;
+    /**
+     * Send an event through WebSocket.
+     * Server handles room routing based on event.target.
+     */
+    send(event: ChannelEvent): Promise<void>;
+    /**
+     * Close all connections.
+     */
+    closeAll(): void;
+    /**
+     * Register handler for events received from transport
+     */
+    onReceive(handler: (event: ChannelEvent) => void): void;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/channels/transports/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/channels/transports/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,SAAgB,IAAI,eAAe;IAEnC,OAAO,CAAC,MAAM,CAGZ;IACF,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAChD,OAAO,CAAC,EAAE,CAAC,CAAkB;IAC7B,OAAO,CAAC,cAAc,CAAC,CAAgC;IACvD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAM;IACvB,OAAO,CAAC,aAAa,CAAC,CAAW;IACjC,OAAO,CAAC,WAAW,CAAqB;gBAE5B,MAAM,EAAE,wBAAwB;IAoB5C;;OAEG;IACG,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,kBAAkB,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACtD,OAAO,CAAC,IAAI,CAAC;IA0BhB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiE3B;;OAEG;YACW,gBAAgB;IAyC9B,OAAO,CAAC,qBAAqB;IAkD7B;;OAEG;YACW,oBAAoB;IA6ElC;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACG,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7D;;OAEG;IACG,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9D;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE;IAInD;;OAEG;IACG,UAAU,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCvD;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B9C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;CAGxD"}