@radzor/realtime-chat

Real-time chat messaging via WebSocket. Supports rooms, typing indicators, message history, and user presence. Works in both browser and Node.js environments.

Chat & Messagingv0.1.0typescriptBrowserwebsocketrealtimemessagingchatroomsby Radzor

Install

View source on GitHub →

$npx radzor@latest add realtime-chat

⚠ Constraints: Browser environment only. Uses native WebSocket API (not the ws npm package). Requires a WebSocket server. For production, use wss:// (TLS). The server component handles room state and message broadcasting.

Inputs

Name	Type	Default	Description
roomId*	string	—	Unique identifier for the chat room to join.
userId*	string	—	Unique identifier for the current user.
maxMessages	number	100	Maximum number of messages to keep in local buffer.
serverUrl*	string	—	WebSocket server URL to connect to.
authToken	string	—	Authentication token for authorized connections (e.g. from @radzor/auth-oauth session.accessToken).

roomId*string

{ "llm": { "constraints": "Browser environment only. Uses native WebSocket API (not the ws npm package). Requires a WebSocket server. For production, use wss:// (TLS). The server component handles room state and message broadcasting.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/realtime-chat", "tags": [ "websocket", "realtime", "messaging", "chat", "rooms" ], "events": [ { "name": "onMessage", "payload": { "id": "string", "userId": "string", "content": "string", "timestamp": "number" }, "description": "Fired when a new message is received in the room." }, { "name": "onUserJoin", "payload": { "userId": "string", "username": "string" }, "description": "Fired when a user joins the room." }, { "name": "onUserLeave", "payload": { "userId": "string" }, "description": "Fired when a user leaves the room." }, { "name": "onTyping", "payload": { "userId": "string", "isTyping": "boolean" }, "description": "Fired when a user starts or stops typing." }, { "name": "onError", "payload": { "code": "string", "message": "string" }, "description": "Fired on connection or messaging errors." } ], "inputs": [ { "name": "roomId", "type": "string", "required": true, "description": "Unique identifier for the chat room to join." }, { "name": "userId", "type": "string", "required": true, "description": "Unique identifier for the current user." }, { "name": "maxMessages", "type": "number", "default": 100, "required": false, "description": "Maximum number of messages to keep in local buffer." }, { "name": "serverUrl", "type": "string", "required": true, "description": "WebSocket server URL to connect to." }, { "name": "authToken", "type": "string", "required": false, "description": "Authentication token for authorized connections (e.g. from @radzor/auth-oauth session.accessToken)." } ], "radzor": "1.0.0", "actions": [ { "name": "sendMessage", "params": [ { "name": "content", "type": "string", "description": "The message text to send." } ], "returns": "Promise<ChatMessage>", "description": "Send a text message to the current room." }, { "name": "joinRoom", "params": [ { "name": "roomId", "type": "string", "description": "Room ID to join." } ], "returns": "Promise<void>", "description": "Join a chat room and start receiving messages." }, { "name": "leaveRoom", "params": [], "returns": "Promise<void>", "description": "Leave the current room and disconnect." }, { "name": "getHistory", "params": [ { "name": "limit", "type": "number", "default": 50, "required": false, "description": "Number of past messages to retrieve." } ], "returns": "Promise<ChatMessage[]>", "description": "Retrieve message history for the current room." }, { "name": "setTyping", "params": [ { "name": "isTyping", "type": "boolean", "description": "Whether the user is currently typing." } ], "returns": "void", "description": "Broadcast typing indicator to other users in the room." } ], "outputs": [ { "name": "connectionStatus", "type": "'connecting' | 'connected' | 'disconnected' | 'error'", "description": "Current WebSocket connection status." } ], "runtime": "browser", "version": "0.1.0", "category": "chat", "languages": [ "typescript" ], "description": "Real-time chat messaging via WebSocket. Supports rooms, typing indicators, message history, and user presence. Works in both browser and Node.js environments.", "dependencies": { "packages": {} }, "composability": { "connectsTo": [ { "event": "onMessage", "description": "Feed chat messages to LLM for AI chatbot or structured extraction.", "compatibleWith": [ "@radzor/llm-completion.action.complete.prompt", "@radzor/structured-output.action.extract.text" ] } ] } }

@radzor/realtime-chat

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Version History