@agentick/core 0.0.1

package/dist/channels/transports/websocket.js

@@ -0,0 +1,416 @@
+/**
+ * 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 class WebSocketTransport {
+    name = "websocket";
+    config;
+    currentConnectionId;
+    connectionMetadata;
+    ws;
+    receiveHandler;
+    reconnectAttempts = 0;
+    reconnectTimer;
+    isConnected = false;
+    wsModule;
+    channelFilter;
+    joinedRooms = new Set();
+    constructor(config) {
+        if (!config.socket && !config.url) {
+            throw new Error("WebSocketTransport requires either url or socket");
+        }
+        this.config = {
+            ...config,
+            reconnectDelay: config.reconnectDelay || 1000,
+            maxReconnectAttempts: config.maxReconnectAttempts || 10,
+        };
+        // If existing socket provided, use it directly
+        if (config.socket) {
+            this.ws = config.socket;
+            this.isConnected =
+                config.socket.readyState === WebSocket.OPEN || config.socket.readyState === 1;
+            this.setupSocketHandlers();
+        }
+    }
+    /**
+     * Connect to the transport with optional metadata.
+     */
+    async connect(connectionId, metadata) {
+        this.currentConnectionId = connectionId;
+        this.connectionMetadata = metadata;
+        this.channelFilter = metadata?.channels;
+        // If socket was provided in constructor, just setup handlers
+        if (this.ws && this.isConnected) {
+            this.setupSocketHandlers();
+            // Auto-join rooms based on metadata
+            if (this.config.autoJoinRooms && metadata) {
+                const autoRooms = this.config.autoJoinRooms(metadata);
+                for (const room of autoRooms) {
+                    if (room) {
+                        await this.join(connectionId, room);
+                    }
+                }
+            }
+            return;
+        }
+        // Otherwise, create new connection
+        this.reconnectAttempts = 0;
+        await this.connectWebSocket();
+    }
+    /**
+     * Setup event handlers on existing socket
+     */
+    setupSocketHandlers() {
+        if (!this.ws)
+            return;
+        // Remove existing handlers to avoid duplicates
+        if (this.ws.removeAllListeners) {
+            this.ws.removeAllListeners("message");
+            this.ws.removeAllListeners("error");
+            this.ws.removeAllListeners("close");
+            this.ws.removeAllListeners("open");
+        }
+        // Setup message handler
+        const messageHandler = (data) => {
+            try {
+                let text;
+                if (data instanceof MessageEvent) {
+                    text = data.data;
+                }
+                else {
+                    text = typeof data === "string" ? data : data.toString("utf-8");
+                }
+                const event = JSON.parse(text);
+                // Apply excludeSender filtering
+                const sourceConnectionId = event.metadata?.["sourceConnectionId"];
+                if (event.target?.excludeSender && sourceConnectionId === this.currentConnectionId) {
+                    return; // Skip - we're the sender
+                }
+                if (this.receiveHandler) {
+                    this.receiveHandler(event);
+                }
+            }
+            catch (error) {
+                console.error("Failed to parse WebSocket message:", error);
+            }
+        };
+        if (typeof WebSocket !== "undefined" && this.ws instanceof WebSocket) {
+            // Browser WebSocket
+            this.ws.onmessage = messageHandler;
+            this.ws.onerror = (error) => {
+                console.error("WebSocket error:", error);
+                this.isConnected = false;
+            };
+            this.ws.onclose = () => {
+                this.isConnected = false;
+            };
+            this.ws.onopen = () => {
+                this.isConnected = true;
+            };
+        }
+        else {
+            // Node.js ws.WebSocket
+            this.ws.on("message", messageHandler);
+            this.ws.on("error", (error) => {
+                console.error("WebSocket error:", error);
+                this.isConnected = false;
+            });
+            this.ws.on("close", () => {
+                this.isConnected = false;
+            });
+            this.ws.on("open", () => {
+                this.isConnected = true;
+            });
+        }
+    }
+    /**
+     * Connect to WebSocket
+     */
+    async connectWebSocket() {
+        if (!this.currentConnectionId) {
+            throw new Error("Connection ID required for connection");
+        }
+        // Close existing connection if any
+        this.disconnect().catch(() => { });
+        if (!this.config.url) {
+            throw new Error("URL required when socket is not provided");
+        }
+        try {
+            // Build WebSocket URL with connection ID and metadata
+            const url = new URL(this.config.url);
+            url.searchParams.set("connectionId", this.currentConnectionId);
+            if (this.config.token) {
+                url.searchParams.set("token", this.config.token);
+            }
+            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);
+            }
+            if (typeof WebSocket !== "undefined") {
+                // Browser environment
+                this.ws = new WebSocket(url.toString(), this.config.protocols);
+                this.setupBrowserWebSocket();
+            }
+            else {
+                // Node.js environment - use 'ws' package
+                await this.connectWebSocketNode(url);
+            }
+        }
+        catch (error) {
+            console.error("Failed to connect WebSocket:", error);
+            this.handleReconnect();
+            throw error;
+        }
+    }
+    setupBrowserWebSocket() {
+        this.ws.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;
+                }
+                if (this.receiveHandler) {
+                    this.receiveHandler(channelEvent);
+                }
+            }
+            catch (error) {
+                console.error("Failed to parse WebSocket message:", error);
+            }
+        };
+        this.ws.onerror = (error) => {
+            console.error("WebSocket error:", error);
+            this.isConnected = false;
+            this.handleReconnect();
+        };
+        this.ws.onclose = () => {
+            this.isConnected = false;
+            if (this.reconnectAttempts < this.config.maxReconnectAttempts) {
+                this.handleReconnect();
+            }
+        };
+        this.ws.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);
+                    }
+                }
+            }
+        };
+    }
+    /**
+     * Connect to WebSocket in Node.js environment using 'ws' package
+     */
+    async connectWebSocketNode(url) {
+        try {
+            // Lazy-load 'ws' module
+            if (!this.wsModule) {
+                try {
+                    this.wsModule = require("ws");
+                }
+                catch (_error) {
+                    throw new Error("WebSocketTransport requires 'ws' package in Node.js. Install it with: npm install ws");
+                }
+            }
+            const WebSocket = this.wsModule.WebSocket || this.wsModule;
+            this.ws = new WebSocket(url.toString(), {
+                headers: this.config.headers,
+            });
+            this.setupSocketHandlers();
+            // Override error/close handlers to include reconnection logic
+            const originalOnError = this.ws.listeners("error")[0];
+            const originalOnClose = this.ws.listeners("close")[0];
+            this.ws.removeAllListeners("error");
+            this.ws.removeAllListeners("close");
+            this.ws.on("error", (error) => {
+                if (originalOnError)
+                    originalOnError(error);
+                this.handleReconnect();
+            });
+            this.ws.on("close", () => {
+                if (originalOnClose)
+                    originalOnClose();
+                if (this.reconnectAttempts < this.config.maxReconnectAttempts) {
+                    this.handleReconnect();
+                }
+            });
+            this.ws.on("open", () => {
+                this.isConnected = true;
+                this.reconnectAttempts = 0;
+                // Auto-join rooms
+                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);
+                        }
+                    }
+                }
+            });
+            // Wait for connection to open
+            await new Promise((resolve, reject) => {
+                const timeout = setTimeout(() => {
+                    reject(new Error("WebSocket connection timeout"));
+                }, 10000);
+                this.ws.on("open", () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+                this.ws.on("error", (error) => {
+                    clearTimeout(timeout);
+                    reject(error);
+                });
+            });
+        }
+        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.connectWebSocket().catch((error) => {
+                    console.error("Reconnection failed:", error);
+                });
+            }
+        }, delay);
+    }
+    /**
+     * Join a room (sends message to server).
+     */
+    async join(connectionId, room) {
+        if (this.ws && this.isConnected) {
+            const message = JSON.stringify({
+                type: "join-room",
+                room,
+                connectionId: this.currentConnectionId,
+            });
+            this.ws.send(message);
+            this.joinedRooms.add(room);
+            console.log(`WebSocket: joined room ${room}`);
+        }
+    }
+    /**
+     * Leave a room (sends message to server).
+     */
+    async leave(connectionId, room) {
+        if (this.ws && this.isConnected) {
+            const message = JSON.stringify({
+                type: "leave-room",
+                room,
+                connectionId: this.currentConnectionId,
+            });
+            this.ws.send(message);
+            this.joinedRooms.delete(room);
+            console.log(`WebSocket: left room ${room}`);
+        }
+    }
+    /**
+     * 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.ws) {
+            // Only close if we created the socket ourselves
+            const wasProvidedExternally = !this.config.url;
+            if (!wasProvidedExternally) {
+                if (this.ws.close) {
+                    this.ws.close();
+                }
+                else if (this.ws.terminate) {
+                    this.ws.terminate();
+                }
+            }
+            if (wasProvidedExternally) {
+                if (this.ws.removeAllListeners) {
+                    this.ws.removeAllListeners();
+                }
+            }
+            else {
+                this.ws = undefined;
+            }
+        }
+        this.currentConnectionId = undefined;
+        this.connectionMetadata = undefined;
+    }
+    /**
+     * Send an event through WebSocket.
+     * Server handles room routing based on event.target.
+     */
+    async send(event) {
+        if (!this.currentConnectionId) {
+            throw new Error("Not connected. Call connect() first.");
+        }
+        if (!this.isConnected || !this.ws) {
+            throw new Error("WebSocket not connected");
+        }
+        try {
+            // Add sourceConnectionId for excludeSender support
+            const message = JSON.stringify({
+                ...event,
+                metadata: {
+                    ...event.metadata,
+                    sourceConnectionId: this.currentConnectionId,
+                },
+            });
+            if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === 1) {
+                this.ws.send(message);
+            }
+            else {
+                throw new Error("WebSocket is not open");
+            }
+        }
+        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=websocket.js.map

package/dist/channels/transports/websocket.js.map

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

package/dist/com/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * # Agentick Context Object Model (COM)
+ *
+ * The Context Object Model is the intermediate representation between JSX components
+ * and model input. Components render to the COM, which is then compiled into the
+ * format expected by AI models.
+ *
+ * ## Features
+ *
+ * - **Sections** - Organize content into logical groups (system, user, assistant)
+ * - **Timeline** - Message history with role-based entries
+ * - **State Management** - Shared state across components via COM
+ * - **Tick Control** - Stop/continue execution based on conditions
+ *
+ * ## Architecture
+ *
+ * ```
+ * JSX Components → COM (Context Object Model) → Model Input
+ * ```
+ *
+ * @see {@link COM} - Main COM class
+ * @see {@link COMSection} - Section structure
+ * @see {@link COMTimelineEntry} - Timeline entry structure
+ *
+ * @module agentick/com
+ */
+export * from "./object-model";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/com/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/com/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}

package/dist/com/index.js

@@ -0,0 +1,29 @@
+/**
+ * # Agentick Context Object Model (COM)
+ *
+ * The Context Object Model is the intermediate representation between JSX components
+ * and model input. Components render to the COM, which is then compiled into the
+ * format expected by AI models.
+ *
+ * ## Features
+ *
+ * - **Sections** - Organize content into logical groups (system, user, assistant)
+ * - **Timeline** - Message history with role-based entries
+ * - **State Management** - Shared state across components via COM
+ * - **Tick Control** - Stop/continue execution based on conditions
+ *
+ * ## Architecture
+ *
+ * ```
+ * JSX Components → COM (Context Object Model) → Model Input
+ * ```
+ *
+ * @see {@link COM} - Main COM class
+ * @see {@link COMSection} - Section structure
+ * @see {@link COMTimelineEntry} - Timeline entry structure
+ *
+ * @module agentick/com
+ */
+export * from "./object-model";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/com/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/com/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}