agent-relay 2.0.21 → 2.0.23

package/packages/dashboard/dist/start.d.ts

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-/**
- * Standalone dashboard starter for local development
- */
-export {};
-//# sourceMappingURL=start.d.ts.map

package/packages/dashboard/dist/start.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-/**
- * Standalone dashboard starter for local development
- */
-import { startDashboard } from './server.js';
-import { getProjectPaths } from '@agent-relay/config';
-const port = parseInt(process.env.DASHBOARD_PORT || '3888', 10);
-const paths = getProjectPaths();
-console.log(`Starting dashboard for project: ${paths.projectRoot}`);
-console.log(`Data dir: ${paths.dataDir}`);
-console.log(`Database: ${paths.dbPath}`);
-startDashboard(port, paths.dataDir, paths.teamDir, paths.dbPath).catch(console.error);
-//# sourceMappingURL=start.js.map

package/packages/dashboard/dist/types/threading.d.ts

@@ -1,8 +0,0 @@
-export interface ThreadMetadata {
-    threadId: string;
-    replyCount: number;
-    participants: string[];
-    lastReplyAt: number;
-    lastReplyPreview?: string;
-}
-//# sourceMappingURL=threading.d.ts.map

package/packages/dashboard/dist/types/threading.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=threading.js.map

package/packages/dashboard/dist/user-bridge.d.ts

@@ -1,154 +0,0 @@
-/**
- * User Bridge - Bridges dashboard WebSocket users to the relay daemon.
- *
- * This module allows human users connected via WebSocket to:
- * - Register as "user" entities in the relay daemon
- * - Join/leave channels
- * - Send/receive messages through the relay daemon
- * - Communicate with agents and other users
- */
-import type { WebSocket } from 'ws';
-/**
- * Relay client interface (subset of RelayClient for dependency injection)
- */
-export interface IRelayClient {
-    connect(): Promise<void>;
-    disconnect(): void;
-    state: string;
-    sendMessage(to: string, body: string, kind?: string, data?: unknown, thread?: string): boolean;
-    joinChannel(channel: string, displayName?: string): boolean;
-    leaveChannel(channel: string, reason?: string): boolean;
-    sendChannelMessage(channel: string, body: string, options?: {
-        thread?: string;
-        mentions?: string[];
-        attachments?: unknown[];
-        data?: Record<string, unknown>;
-    }): boolean;
-    adminJoinChannel?(channel: string, member: string): boolean;
-    adminRemoveMember?(channel: string, member: string): boolean;
-    onMessage?: (from: string, payload: any, messageId: string, meta?: any, originalTo?: string) => void;
-    onChannelMessage?: (from: string, channel: string, body: string, envelope: any) => void;
-}
-/**
- * Factory function type for creating relay clients
- */
-export type RelayClientFactory = (options: {
-    socketPath: string;
-    agentName: string;
-    entityType: 'user';
-    displayName?: string;
-    avatarUrl?: string;
-}) => Promise<IRelayClient>;
-/**
- * User info for avatar lookups
- */
-export interface UserInfo {
-    avatarUrl?: string;
-}
-/**
- * Options for creating a UserBridge
- */
-export interface UserBridgeOptions {
-    socketPath: string;
-    createRelayClient: RelayClientFactory;
-    loadPersistedChannels?: (username: string) => Promise<string[]>;
-    /** Optional callback to look up user info (avatar URL) by username */
-    lookupUserInfo?: (username: string) => UserInfo | undefined;
-}
-/**
- * Message options for sending
- */
-export interface SendMessageOptions {
-    thread?: string;
-    data?: Record<string, unknown>;
-    attachments?: unknown[];
-}
-/**
- * UserBridge manages the connection between dashboard WebSocket users
- * and the relay daemon.
- */
-export declare class UserBridge {
-    private readonly socketPath;
-    private readonly createRelayClient;
-    private readonly loadPersistedChannels?;
-    private readonly lookupUserInfo?;
-    private readonly users;
-    constructor(options: UserBridgeOptions);
-    /**
-     * Get the relay client for a user if they are registered.
-     * This allows external code to reuse the userBridge's relay client
-     * instead of creating a duplicate connection.
-     */
-    getRelayClient(username: string): IRelayClient | undefined;
-    /**
-     * Register a user with the relay daemon.
-     * Creates a relay client connection for the user.
-     */
-    registerUser(username: string, webSocket: WebSocket, options?: {
-        avatarUrl?: string;
-        displayName?: string;
-    }): Promise<void>;
-    /**
-     * Unregister a user and disconnect their relay client.
-     */
-    unregisterUser(username: string): void;
-    /**
-     * Check if a user is registered.
-     */
-    isUserRegistered(username: string): boolean;
-    /**
-     * Update the WebSocket for an existing user session.
-     * This is needed when a user reconnects or opens a new tab,
-     * so messages are forwarded to the active WebSocket.
-     */
-    updateWebSocket(username: string, newWebSocket: WebSocket): boolean;
-    /**
-     * Get list of all registered users.
-     */
-    getRegisteredUsers(): string[];
-    /**
-     * Join a channel.
-     */
-    joinChannel(username: string, channel: string): Promise<boolean>;
-    /**
-     * Leave a channel.
-     */
-    leaveChannel(username: string, channel: string): Promise<boolean>;
-    /**
-     * Get channels a user has joined.
-     */
-    getUserChannels(username: string): string[];
-    /**
-     * Send a message to a channel.
-     */
-    sendChannelMessage(username: string, channel: string, body: string, options?: SendMessageOptions): Promise<boolean>;
-    /**
-     * Send a direct message to another user or agent.
-     */
-    sendDirectMessage(fromUsername: string, toName: string, body: string, options?: SendMessageOptions): Promise<boolean>;
-    /**
-     * Handle incoming direct message from relay daemon.
-     */
-    private handleIncomingDirectMessage;
-    /**
-     * Handle incoming channel message from relay daemon.
-     */
-    private handleIncomingChannelMessage;
-    /**
-     * Admin: Add a member to a channel (does not require member to be connected).
-     * Used to sync channel memberships from database.
-     * Uses the first available user session or creates a temporary one.
-     */
-    adminJoinChannel(channel: string, member: string): Promise<boolean>;
-    /**
-     * Admin: Remove a member from a channel (does not require member to be connected).
-     * Used to remove channel members from dashboard.
-     * Uses the first available user session or creates a temporary one.
-     */
-    adminRemoveMember(channel: string, member: string): Promise<boolean>;
-    /**
-     * Dispose of all user sessions.
-     */
-    dispose(): void;
-}
-//# sourceMappingURL=user-bridge.d.ts.map

package/packages/dashboard/dist/user-bridge.js

@@ -1,372 +0,0 @@
-/**
- * User Bridge - Bridges dashboard WebSocket users to the relay daemon.
- *
- * This module allows human users connected via WebSocket to:
- * - Register as "user" entities in the relay daemon
- * - Join/leave channels
- * - Send/receive messages through the relay daemon
- * - Communicate with agents and other users
- */
-/**
- * UserBridge manages the connection between dashboard WebSocket users
- * and the relay daemon.
- */
-export class UserBridge {
-    socketPath;
-    createRelayClient;
-    loadPersistedChannels;
-    lookupUserInfo;
-    users = new Map();
-    constructor(options) {
-        this.socketPath = options.socketPath;
-        this.createRelayClient = options.createRelayClient;
-        this.loadPersistedChannels = options.loadPersistedChannels;
-        this.lookupUserInfo = options.lookupUserInfo;
-    }
-    /**
-     * Get the relay client for a user if they are registered.
-     * This allows external code to reuse the userBridge's relay client
-     * instead of creating a duplicate connection.
-     */
-    getRelayClient(username) {
-        return this.users.get(username)?.relayClient;
-    }
-    /**
-     * Register a user with the relay daemon.
-     * Creates a relay client connection for the user.
-     */
-    async registerUser(username, webSocket, options) {
-        // If user already registered, unregister first
-        if (this.users.has(username)) {
-            this.unregisterUser(username);
-        }
-        // Create relay client for this user
-        const relayClient = await this.createRelayClient({
-            socketPath: this.socketPath,
-            agentName: username,
-            entityType: 'user',
-            displayName: options?.displayName,
-            avatarUrl: options?.avatarUrl,
-        });
-        // Connect to daemon
-        await relayClient.connect();
-        // Set up message handler to forward direct messages to WebSocket
-        relayClient.onMessage = (from, payload, _messageId, _meta, _originalTo) => {
-            const body = typeof payload === 'object' && payload !== null && 'body' in payload
-                ? payload.body
-                : String(payload);
-            this.handleIncomingDirectMessage(username, from, body, payload);
-        };
-        // Set up channel message handler to forward channel messages to WebSocket
-        relayClient.onChannelMessage = (from, channel, body, envelope) => {
-            this.handleIncomingChannelMessage(username, from, channel, body, envelope);
-        };
-        // Create session
-        const session = {
-            username,
-            relayClient,
-            webSocket,
-            channels: new Set(),
-            avatarUrl: options?.avatarUrl,
-        };
-        this.users.set(username, session);
-        console.log(`[user-bridge] User registered: ${username} (total: ${this.users.size})`);
-        // Auto-join user to #general channel
-        // Note: The daemon auto-joins on connect, but we need to track locally too
-        session.channels.add('#general');
-        if (this.loadPersistedChannels) {
-            try {
-                const persistedChannels = await this.loadPersistedChannels(username);
-                for (const channel of persistedChannels) {
-                    if (channel === '#general')
-                        continue;
-                    if (session.channels.has(channel))
-                        continue;
-                    session.relayClient.joinChannel(channel, username);
-                    session.channels.add(channel);
-                }
-            }
-            catch (err) {
-                console.error(`[user-bridge] Failed to restore persisted channels for ${username}:`, err);
-            }
-        }
-        // Set up WebSocket close handler
-        webSocket.on('close', () => {
-            this.unregisterUser(username);
-        });
-        console.log(`[user-bridge] User ${username} registered with relay daemon`);
-    }
-    /**
-     * Unregister a user and disconnect their relay client.
-     */
-    unregisterUser(username) {
-        const session = this.users.get(username);
-        if (!session)
-            return;
-        session.relayClient.disconnect();
-        this.users.delete(username);
-        console.log(`[user-bridge] User ${username} unregistered from relay daemon`);
-    }
-    /**
-     * Check if a user is registered.
-     */
-    isUserRegistered(username) {
-        return this.users.has(username);
-    }
-    /**
-     * Update the WebSocket for an existing user session.
-     * This is needed when a user reconnects or opens a new tab,
-     * so messages are forwarded to the active WebSocket.
-     */
-    updateWebSocket(username, newWebSocket) {
-        const session = this.users.get(username);
-        if (!session) {
-            console.log(`[user-bridge] Cannot update WebSocket - user ${username} not registered`);
-            return false;
-        }
-        // Remove the close handler from old WebSocket to prevent auto-unregister
-        session.webSocket.removeAllListeners('close');
-        // Update to new WebSocket
-        session.webSocket = newWebSocket;
-        // Set up close handler on new WebSocket
-        newWebSocket.on('close', () => {
-            // Note: The server manages multi-tab connections and will call
-            // unregisterUser when all connections are closed
-        });
-        console.log(`[user-bridge] Updated WebSocket for user ${username}`);
-        return true;
-    }
-    /**
-     * Get list of all registered users.
-     */
-    getRegisteredUsers() {
-        return Array.from(this.users.keys());
-    }
-    /**
-     * Join a channel.
-     */
-    async joinChannel(username, channel) {
-        const session = this.users.get(username);
-        if (!session) {
-            console.warn(`[user-bridge] Cannot join channel - user ${username} not registered`);
-            return false;
-        }
-        // Send CHANNEL_JOIN via relay client
-        const success = session.relayClient.joinChannel(channel, username);
-        if (success) {
-            // Track membership
-            session.channels.add(channel);
-        }
-        return success;
-    }
-    /**
-     * Leave a channel.
-     */
-    async leaveChannel(username, channel) {
-        const session = this.users.get(username);
-        if (!session) {
-            console.warn(`[user-bridge] Cannot leave channel - user ${username} not registered`);
-            return false;
-        }
-        // Send CHANNEL_LEAVE via relay client
-        const success = session.relayClient.leaveChannel(channel);
-        if (success) {
-            // Update membership
-            session.channels.delete(channel);
-            console.log(`[user-bridge] User ${username} left channel ${channel}`);
-        }
-        return success;
-    }
-    /**
-     * Get channels a user has joined.
-     */
-    getUserChannels(username) {
-        const session = this.users.get(username);
-        return session ? Array.from(session.channels) : [];
-    }
-    /**
-     * Send a message to a channel.
-     */
-    async sendChannelMessage(username, channel, body, options) {
-        const session = this.users.get(username);
-        if (!session) {
-            console.warn(`[user-bridge] Cannot send - user ${username} not registered`);
-            return false;
-        }
-        return session.relayClient.sendChannelMessage(channel, body, {
-            thread: options?.thread,
-            data: options?.data,
-            attachments: options?.attachments,
-        });
-    }
-    /**
-     * Send a direct message to another user or agent.
-     */
-    async sendDirectMessage(fromUsername, toName, body, options) {
-        const session = this.users.get(fromUsername);
-        if (!session) {
-            console.warn(`[user-bridge] Cannot send DM - user ${fromUsername} not registered`);
-            return false;
-        }
-        return session.relayClient.sendMessage(toName, body, 'message', options?.data, options?.thread);
-    }
-    /**
-     * Handle incoming direct message from relay daemon.
-     */
-    handleIncomingDirectMessage(username, from, body, payload) {
-        // Skip channel messages - they are handled by handleIncomingChannelMessage
-        // The relay client calls both onMessage and onChannelMessage for channel messages,
-        // with _isChannelMessage flag set in the data for onMessage calls
-        const payloadObj = payload;
-        if (payloadObj?.data?._isChannelMessage) {
-            return; // Skip - will be handled by onChannelMessage callback
-        }
-        const session = this.users.get(username);
-        if (!session)
-            return;
-        const ws = session.webSocket;
-        if (ws.readyState !== 1)
-            return; // Not OPEN
-        // Look up sender's avatar if lookup function is available
-        const senderInfo = this.lookupUserInfo?.(from);
-        const fromAvatarUrl = senderInfo?.avatarUrl;
-        // Determine entity type: user if they have info, agent otherwise
-        const fromEntityType = senderInfo ? 'user' : 'agent';
-        // Direct message (DELIVER)
-        ws.send(JSON.stringify({
-            type: 'direct_message',
-            from,
-            fromAvatarUrl,
-            fromEntityType,
-            body: payloadObj?.body || body,
-            timestamp: new Date().toISOString(),
-        }));
-    }
-    /**
-     * Handle incoming channel message from relay daemon.
-     */
-    handleIncomingChannelMessage(username, from, channel, body, envelope) {
-        const session = this.users.get(username);
-        if (!session)
-            return;
-        const ws = session.webSocket;
-        if (ws.readyState !== 1)
-            return; // Not OPEN
-        // Look up sender's avatar if lookup function is available
-        const senderInfo = this.lookupUserInfo?.(from);
-        const fromAvatarUrl = senderInfo?.avatarUrl;
-        // Determine entity type: user if they have info, agent otherwise
-        const fromEntityType = senderInfo ? 'user' : 'agent';
-        // Channel message
-        const env = envelope;
-        ws.send(JSON.stringify({
-            type: 'channel_message',
-            channel,
-            from,
-            fromAvatarUrl,
-            fromEntityType,
-            body,
-            thread: env?.payload?.thread,
-            mentions: env?.payload?.mentions,
-            timestamp: new Date().toISOString(),
-        }));
-    }
-    /**
-     * Admin: Add a member to a channel (does not require member to be connected).
-     * Used to sync channel memberships from database.
-     * Uses the first available user session or creates a temporary one.
-     */
-    async adminJoinChannel(channel, member) {
-        // Try to use an existing session
-        const sessions = Array.from(this.users.values());
-        if (sessions.length > 0) {
-            const session = sessions[0];
-            if (session.relayClient.adminJoinChannel) {
-                console.log(`[user-bridge] Admin join: ${member} -> ${channel} (via ${session.username})`);
-                return session.relayClient.adminJoinChannel(channel, member);
-            }
-        }
-        // No sessions available - create a temporary system client
-        try {
-            console.log(`[user-bridge] Admin join: ${member} -> ${channel} (creating temp client)`);
-            const tempClient = await this.createRelayClient({
-                socketPath: this.socketPath,
-                agentName: '__system__',
-                entityType: 'user',
-            });
-            await tempClient.connect();
-            // Give daemon time to complete handshake before sending admin commands.
-            // 100ms is sufficient for local Unix socket handshake (typically <10ms),
-            // but provides margin for the daemon to process the HELLO message and
-            // set up internal state. This is a temporary client created just for
-            // the admin operation, not a long-lived session.
-            await new Promise(resolve => setTimeout(resolve, 100));
-            if (tempClient.adminJoinChannel) {
-                const result = tempClient.adminJoinChannel(channel, member);
-                // Disconnect after a short delay to allow message to be sent
-                setTimeout(() => tempClient.disconnect(), 200);
-                return result;
-            }
-            tempClient.disconnect();
-            return false;
-        }
-        catch (err) {
-            console.error('[user-bridge] Failed to create temp client for admin join:', err);
-            return false;
-        }
-    }
-    /**
-     * Admin: Remove a member from a channel (does not require member to be connected).
-     * Used to remove channel members from dashboard.
-     * Uses the first available user session or creates a temporary one.
-     */
-    async adminRemoveMember(channel, member) {
-        // Try to use an existing session
-        const sessions = Array.from(this.users.values());
-        if (sessions.length > 0) {
-            const session = sessions[0];
-            if (session.relayClient.adminRemoveMember) {
-                console.log(`[user-bridge] Admin remove: ${member} <- ${channel} (via ${session.username})`);
-                return session.relayClient.adminRemoveMember(channel, member);
-            }
-        }
-        // No sessions available - create a temporary system client
-        try {
-            console.log(`[user-bridge] Admin remove: ${member} <- ${channel} (creating temp client)`);
-            const tempClient = await this.createRelayClient({
-                socketPath: this.socketPath,
-                agentName: '__system__',
-                entityType: 'user',
-            });
-            await tempClient.connect();
-            // Give daemon time to complete handshake before sending admin commands.
-            // 100ms is sufficient for local Unix socket handshake (typically <10ms),
-            // but provides margin for the daemon to process the HELLO message and
-            // set up internal state. This is a temporary client created just for
-            // the admin operation, not a long-lived session.
-            await new Promise(resolve => setTimeout(resolve, 100));
-            if (tempClient.adminRemoveMember) {
-                const result = tempClient.adminRemoveMember(channel, member);
-                // Disconnect after a short delay to allow message to be sent
-                setTimeout(() => tempClient.disconnect(), 200);
-                return result;
-            }
-            tempClient.disconnect();
-            return false;
-        }
-        catch (err) {
-            console.error('[user-bridge] Failed to create temp client for admin remove:', err);
-            return false;
-        }
-    }
-    /**
-     * Dispose of all user sessions.
-     */
-    dispose() {
-        for (const [username] of this.users) {
-            this.unregisterUser(username);
-        }
-        console.log('[user-bridge] Disposed all user sessions');
-    }
-}
-//# sourceMappingURL=user-bridge.js.map

package/packages/dashboard/package.json

@@ -1,65 +0,0 @@
-{
-  "name": "@agent-relay/dashboard",
-  "version": "2.0.21",
-  "description": "Web dashboard for Agent Relay - optional package for visual agent coordination",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "ui-dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "npm run build:server && npm run build:ui",
-    "build:server": "tsc",
-    "build:ui": "cd ui && npm ci && npm run build && rm -rf ../ui-dist && mv out ../ui-dist",
-    "clean": "rm -rf dist ui-dist",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "dependencies": {
-    "@agent-relay/protocol": "2.0.21",
-    "@agent-relay/config": "2.0.21",
-    "@agent-relay/storage": "2.0.21",
-    "@agent-relay/bridge": "2.0.21",
-    "@agent-relay/utils": "2.0.21",
-    "@agent-relay/resiliency": "2.0.21",
-    "@agent-relay/trajectory": "2.0.21",
-    "@agent-relay/cloud": "2.0.21",
-    "@agent-relay/daemon": "2.0.21",
-    "@agent-relay/user-directory": "2.0.21",
-    "@agent-relay/wrapper": "2.0.21",
-    "@agent-relay/sdk": "2.0.21",
-    "express": "^5.2.1",
-    "ws": "^8.18.3"
-  },
-  "devDependencies": {
-    "@types/express": "^5.0.6",
-    "@types/node": "^22.19.3",
-    "@types/ws": "^8.18.1",
-    "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/AgentWorkforce/relay.git",
-    "directory": "packages/dashboard"
-  },
-  "keywords": [
-    "agent-relay",
-    "dashboard",
-    "web-ui",
-    "agent-coordination"
-  ],
-  "license": "Apache-2.0"
-}