@agent-relay/dashboard-server 2.0.82 → 2.0.84

package/dist/lib/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Shared types for the dashboard server.
+ */
+import type { Express } from 'express';
+import type { Server } from 'http';
+import type { WebSocketServer } from 'ws';
+import type { AgentStatus, Message, RelaycastConfig } from '../relaycast-provider.js';
+export type DashboardMode = 'proxy' | 'standalone' | 'mock';
+export interface DashboardSnapshot {
+    agents: AgentStatus[];
+    users: AgentStatus[];
+    messages: Message[];
+    activity: Message[];
+    sessions: Array<Record<string, unknown>>;
+    summaries: Array<Record<string, unknown>>;
+}
+export interface DashboardChannel {
+    id: string;
+    name: string;
+    description?: string;
+    topic?: string;
+    visibility: 'public' | 'private';
+    status: 'active' | 'archived';
+    createdAt: string;
+    createdBy: string;
+    memberCount: number;
+    unreadCount: number;
+    hasMentions: boolean;
+    isDm: boolean;
+}
+export interface FileSearchResult {
+    path: string;
+    name: string;
+    isDirectory: boolean;
+}
+export interface SpawnedAgentSummary {
+    name: string;
+    cli: string;
+    model?: string;
+    cwd?: string;
+    pid?: number;
+}
+export interface SpawnedAgentNamesResult {
+    names: Set<string>;
+    agents: SpawnedAgentSummary[];
+    hasSpawnedList: boolean;
+}
+export interface LocalStateAgentSummary {
+    name: string;
+    cli: string;
+    startedAt: string;
+    online: boolean;
+    pid?: number;
+    cwd?: string;
+}
+export declare const EMPTY_DASHBOARD_SNAPSHOT: DashboardSnapshot;
+export interface DashboardServerOptions {
+    /** Port to listen on (default: 3888) */
+    port?: number;
+    /** Relay broker URL for proxy mode */
+    relayUrl?: string;
+    /** Path to static files directory (default: ../out) */
+    staticDir?: string;
+    /** Data directory containing relaycast.json credentials */
+    dataDir?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Run in mock mode (no relay broker required) */
+    mock?: boolean;
+    /** CORS allowed origins (comma-separated, or '*' for all) */
+    corsOrigins?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    requestTimeout?: number;
+}
+export interface DashboardServer {
+    app: Express;
+    server: Server;
+    wss: WebSocketServer;
+    close: () => Promise<void>;
+    mode: DashboardMode;
+}
+/**
+ * Shared context passed to route registration functions.
+ */
+export interface RouteContext {
+    mode: DashboardMode;
+    dataDir: string;
+    staticDir: string;
+    verbose: boolean;
+    relayUrl: string | undefined;
+    brokerProxyEnabled: boolean;
+    resolveRelaycastConfig: () => RelaycastConfig | null;
+    getRelaycastSnapshot: () => Promise<DashboardSnapshot>;
+    getRelaycastChannels: () => Promise<{
+        channels: DashboardChannel[];
+        archivedChannels: DashboardChannel[];
+    }>;
+    sendRelaycastMessage: (params: {
+        to: string;
+        message: string;
+        from?: string;
+    }) => Promise<{
+        success: true;
+        messageId: string;
+    } | {
+        success: false;
+        status: number;
+        error: string;
+    }>;
+    getSpawnedAgents: () => Promise<{
+        names: Set<string> | null;
+        agents: SpawnedAgentSummary[] | null;
+    }>;
+    getLocalAgentNames: () => Set<string> | null;
+    filterPhantomAgents: (agents: AgentStatus[], spawnedAgentNames: Set<string> | null, localAgentNames: Set<string> | null) => AgentStatus[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,wBAAwB,EAAE,iBAOtC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,eAAe,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sBAAsB,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IACrD,oBAAoB,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvD,oBAAoB,EAAE,MAAM,OAAO,CAAC;QAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QAAC,gBAAgB,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC,CAAC;IAC5G,oBAAoB,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CACvF;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CACzF,CAAC;IACF,gBAAgB,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACrG,kBAAkB,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7C,mBAAmB,EAAE,CACnB,MAAM,EAAE,WAAW,EAAE,EACrB,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EACrC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,KAChC,WAAW,EAAE,CAAC;CACpB"}

package/dist/lib/types.js

@@ -0,0 +1,12 @@
+/**
+ * Shared types for the dashboard server.
+ */
+export const EMPTY_DASHBOARD_SNAPSHOT = {
+    agents: [],
+    users: [],
+    messages: [],
+    activity: [],
+    sessions: [],
+    summaries: [],
+};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8DH,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;CACd,CAAC"}

package/dist/lib/utils.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Pure utility functions and constants extracted from proxy-server.ts.
+ */
+import type { Response } from 'express';
+import type { DashboardChannel } from './types.js';
+export declare const PHANTOM_OFFLINE_MAX_AGE_MS: number;
+export declare const SPAWNED_CACHE_TTL_MS = 3000;
+export declare const STANDALONE_WS_POLL_MS = 3000;
+export declare const WORKFLOW_BOOTSTRAP_TASK = "You are connected to Agent Relay. Wait for relay messages and respond using Relaycast MCP tools.";
+export declare const WORKFLOW_CONVENTIONS: string;
+export declare function normalizeRelayUrl(relayUrl: string | undefined): string | undefined;
+export declare function withWorkflowConventions(task: string | undefined, includeWorkflowConventions: boolean): string | undefined;
+export declare function parseTimestamp(value: string | undefined): number | null;
+export declare function countOnlineAgents(agents: Array<{
+    status?: string;
+}>): number;
+export { normalizeName } from './identity.js';
+export declare function isDirectRecipient(target: string): boolean;
+export declare function parseCommandDescriptor(rawCli: string | undefined, rawArgs?: unknown, rawModel?: string): {
+    cli: string;
+    args: string[];
+    model?: string;
+};
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function normalizeChannelTarget(channel: string): string;
+export declare function normalizeChannelName(channel: string): string;
+export declare function parseInviteMembers(invites: unknown): Array<{
+    id: string;
+    type: 'user' | 'agent';
+}>;
+export declare function mapChannelForDashboard(channel: {
+    id: string;
+    name: string;
+    topic: string | null;
+    member_count?: number;
+    created_at: string;
+    is_archived: boolean;
+}): DashboardChannel;
+export declare function sendHtmlFileOrFallback(res: Response, filePath: string, fallbackHtml?: string, statusIfMissing?: number): void;
+/**
+ * Get the host to bind to.
+ * In cloud environments, bind to '::' (IPv6 any) which also accepts IPv4 on dual-stack.
+ */
+export declare function getBindHost(): string | undefined;
+export declare function isPidAlive(pid: number): boolean;
+export declare function toIsoTimestamp(epochSeconds: unknown): string;
+export interface TeamWorkerLike {
+    name: string;
+    team?: string;
+}
+export interface TeamSpawnReaderLike {
+    getActiveWorkers(): TeamWorkerLike[];
+}
+export interface UserBridgeLike {
+    isUserRegistered(username: string): boolean;
+}
+/**
+ * Check if an agent has heartbeated recently in agents.json.
+ */
+export declare function isAgentOnline(teamDir: string, agentName: string): boolean;
+export declare function isRemoteAgent(teamDir: string, agentName: string): boolean;
+export declare function isRemoteUser(teamDir: string, username: string): boolean;
+export declare function isUserOnline(teamDir: string, username: string, onlineUsers: Map<string, unknown>, userBridge?: UserBridgeLike): boolean;
+export declare function isRecipientOnline(teamDir: string, name: string, onlineUsers: Map<string, unknown>, userBridge?: UserBridgeLike): boolean;
+/**
+ * Resolve team members from teams config, active workers, and agents.json.
+ */
+export declare function getTeamMembers(teamName: string, projectRoot: string | undefined, dataDir: string, teamDir: string, spawnReader?: TeamSpawnReaderLike): string[];
+export declare function isValidUsername(username: unknown): username is string;
+export declare function isValidAvatarUrl(url: unknown): url is string | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

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

package/dist/lib/utils.js

@@ -0,0 +1,332 @@
+/**
+ * Pure utility functions and constants extracted from proxy-server.ts.
+ */
+import fs from 'fs';
+import path from 'path';
+import { loadTeamsConfig } from '@agent-relay/config';
+export const PHANTOM_OFFLINE_MAX_AGE_MS = 5 * 60 * 1000;
+export const SPAWNED_CACHE_TTL_MS = 3000;
+export const STANDALONE_WS_POLL_MS = 3000;
+export const WORKFLOW_BOOTSTRAP_TASK = 'You are connected to Agent Relay. Wait for relay messages and respond using Relaycast MCP tools.';
+export const WORKFLOW_CONVENTIONS = [
+    'Messaging requirements:',
+    '- When you receive `Relay message from <sender> ...`, reply using `relay_send(to: "<sender>", message: "...")`.',
+    '- Send `ACK: ...` when you receive a task.',
+    '- Send `DONE: ...` when the task is complete.',
+    '- Do not reply only in terminal text; send the response via relay_send.',
+    '- Use relay_inbox() and relay_who() when context is missing.',
+].join('\n');
+export function normalizeRelayUrl(relayUrl) {
+    if (!relayUrl)
+        return undefined;
+    const trimmed = relayUrl.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.replace(/\/+$/, '');
+}
+export function withWorkflowConventions(task, includeWorkflowConventions) {
+    const normalized = typeof task === 'string' ? task.trim() : '';
+    if (!includeWorkflowConventions) {
+        return normalized.length > 0 ? normalized : undefined;
+    }
+    if (normalized.length === 0) {
+        return `${WORKFLOW_BOOTSTRAP_TASK}\n\n${WORKFLOW_CONVENTIONS}`;
+    }
+    const lower = normalized.toLowerCase();
+    const alreadyConfigured = lower.includes('relay_send(') || (lower.includes('ack:') && lower.includes('done:'));
+    return alreadyConfigured ? normalized : `${normalized}\n\n${WORKFLOW_CONVENTIONS}`;
+}
+export function parseTimestamp(value) {
+    if (!value)
+        return null;
+    const timestamp = new Date(value).getTime();
+    return Number.isNaN(timestamp) ? null : timestamp;
+}
+export function countOnlineAgents(agents) {
+    return agents.reduce((count, agent) => {
+        return (agent.status ?? '').toLowerCase() === 'online' ? count + 1 : count;
+    }, 0);
+}
+export { normalizeName } from './identity.js';
+export function isDirectRecipient(target) {
+    const trimmed = target.trim();
+    if (!trimmed)
+        return false;
+    return !trimmed.startsWith('#') && !trimmed.startsWith('dm:');
+}
+export function parseCommandDescriptor(rawCli, rawArgs, rawModel) {
+    const cliSource = typeof rawCli === 'string' ? rawCli.trim() : '';
+    const cliTokens = cliSource ? cliSource.split(/\s+/) : [];
+    const cli = cliTokens[0] ?? 'unknown';
+    const inlineArgs = cliTokens.slice(1);
+    const extraArgs = Array.isArray(rawArgs)
+        ? rawArgs.filter((arg) => typeof arg === 'string' && arg.trim().length > 0)
+        : [];
+    const combinedArgs = [...inlineArgs, ...extraArgs];
+    const filteredArgs = [];
+    let model = typeof rawModel === 'string' && rawModel.trim() ? rawModel.trim() : undefined;
+    for (let index = 0; index < combinedArgs.length; index += 1) {
+        const arg = combinedArgs[index];
+        if (arg === '--model') {
+            const next = combinedArgs[index + 1];
+            if (!model && typeof next === 'string' && next.trim()) {
+                model = next.trim();
+            }
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--model=')) {
+            if (!model) {
+                const value = arg.slice('--model='.length).trim();
+                if (value) {
+                    model = value;
+                }
+            }
+            continue;
+        }
+        filteredArgs.push(arg);
+    }
+    return { cli, args: filteredArgs, model };
+}
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+export function normalizeChannelTarget(channel) {
+    const trimmed = channel.trim();
+    if (!trimmed)
+        return '';
+    if (trimmed.startsWith('#') || trimmed.startsWith('dm:')) {
+        return trimmed;
+    }
+    return `#${trimmed}`;
+}
+export function normalizeChannelName(channel) {
+    const target = normalizeChannelTarget(channel);
+    if (target.startsWith('#')) {
+        return target.slice(1);
+    }
+    return target;
+}
+export function parseInviteMembers(invites) {
+    if (typeof invites === 'string') {
+        return invites
+            .split(',')
+            .map((value) => value.trim())
+            .filter(Boolean)
+            .map((id) => ({ id, type: 'agent' }));
+    }
+    if (Array.isArray(invites)) {
+        return invites
+            .map((item) => {
+            if (typeof item === 'string') {
+                const id = item.trim();
+                return id ? { id, type: 'agent' } : null;
+            }
+            if (!isRecord(item) || typeof item.id !== 'string') {
+                return null;
+            }
+            const id = item.id.trim();
+            if (!id) {
+                return null;
+            }
+            const type = item.type === 'user' ? 'user' : 'agent';
+            return { id, type };
+        })
+            .filter((item) => item !== null);
+    }
+    return [];
+}
+export function mapChannelForDashboard(channel) {
+    const channelId = channel.name.startsWith('#') ? channel.name : `#${channel.name}`;
+    return {
+        id: channelId,
+        name: channel.name,
+        description: channel.topic ?? undefined,
+        topic: channel.topic ?? undefined,
+        visibility: 'public',
+        status: channel.is_archived ? 'archived' : 'active',
+        createdAt: channel.created_at,
+        createdBy: 'system',
+        memberCount: channel.member_count ?? 0,
+        unreadCount: 0,
+        hasMentions: false,
+        isDm: channel.name.startsWith('dm:'),
+    };
+}
+export function sendHtmlFileOrFallback(res, filePath, fallbackHtml, statusIfMissing = 404) {
+    if (fs.existsSync(filePath)) {
+        res.sendFile(path.resolve(filePath));
+        return;
+    }
+    if (fallbackHtml) {
+        res.type('html').send(fallbackHtml);
+        return;
+    }
+    res.status(statusIfMissing).json({ error: 'Not found' });
+}
+/**
+ * Get the host to bind to.
+ * In cloud environments, bind to '::' (IPv6 any) which also accepts IPv4 on dual-stack.
+ */
+export function getBindHost() {
+    if (process.env.BIND_HOST) {
+        return process.env.BIND_HOST;
+    }
+    const isCloudEnvironment = process.env.FLY_APP_NAME ||
+        process.env.WORKSPACE_ID ||
+        process.env.RELAY_WORKSPACE_ID ||
+        process.env.RUNNING_IN_DOCKER === 'true';
+    return isCloudEnvironment ? '::' : undefined;
+}
+export function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function toIsoTimestamp(epochSeconds) {
+    if (typeof epochSeconds !== 'number' || !Number.isFinite(epochSeconds) || epochSeconds <= 0) {
+        return new Date(0).toISOString();
+    }
+    return new Date(epochSeconds * 1000).toISOString();
+}
+/**
+ * Check if an agent has heartbeated recently in agents.json.
+ */
+export function isAgentOnline(teamDir, agentName) {
+    if (agentName === '*')
+        return true;
+    const agentsPath = path.join(teamDir, 'agents.json');
+    if (!fs.existsSync(agentsPath))
+        return false;
+    try {
+        const data = JSON.parse(fs.readFileSync(agentsPath, 'utf-8'));
+        const agent = data.agents?.find((a) => a.name === agentName);
+        if (!agent || !agent.lastSeen)
+            return false;
+        const thirtySecondsAgo = Date.now() - 30 * 1000;
+        return new Date(agent.lastSeen).getTime() > thirtySecondsAgo;
+    }
+    catch {
+        return false;
+    }
+}
+export function isRemoteAgent(teamDir, agentName) {
+    const remoteAgentsPath = path.join(teamDir, 'remote-agents.json');
+    if (!fs.existsSync(remoteAgentsPath))
+        return false;
+    try {
+        const data = JSON.parse(fs.readFileSync(remoteAgentsPath, 'utf-8'));
+        if (data.updatedAt && Date.now() - data.updatedAt > 60 * 1000) {
+            return false;
+        }
+        return data.agents?.some((a) => a.name === agentName) ?? false;
+    }
+    catch {
+        return false;
+    }
+}
+export function isRemoteUser(teamDir, username) {
+    const remoteUsersPath = path.join(teamDir, 'remote-users.json');
+    if (!fs.existsSync(remoteUsersPath))
+        return false;
+    try {
+        const data = JSON.parse(fs.readFileSync(remoteUsersPath, 'utf-8'));
+        if (data.updatedAt && Date.now() - data.updatedAt > 60 * 1000) {
+            return false;
+        }
+        return data.users?.some((u) => u.name === username) ?? false;
+    }
+    catch {
+        return false;
+    }
+}
+export function isUserOnline(teamDir, username, onlineUsers, userBridge) {
+    if (username === '*')
+        return true;
+    return onlineUsers.has(username) || userBridge?.isUserRegistered(username) === true || isRemoteUser(teamDir, username);
+}
+export function isRecipientOnline(teamDir, name, onlineUsers, userBridge) {
+    return (isAgentOnline(teamDir, name) ||
+        isRemoteAgent(teamDir, name) ||
+        isUserOnline(teamDir, name, onlineUsers, userBridge));
+}
+/**
+ * Resolve team members from teams config, active workers, and agents.json.
+ */
+export function getTeamMembers(teamName, projectRoot, dataDir, teamDir, spawnReader) {
+    const members = new Set();
+    const teamsConfig = loadTeamsConfig(projectRoot || dataDir);
+    if (teamsConfig && teamsConfig.team === teamName) {
+        for (const agent of teamsConfig.agents) {
+            members.add(agent.name);
+        }
+    }
+    if (spawnReader) {
+        const activeWorkers = spawnReader.getActiveWorkers();
+        for (const worker of activeWorkers) {
+            if (worker.team === teamName) {
+                members.add(worker.name);
+            }
+        }
+    }
+    const agentsPath = path.join(teamDir, 'agents.json');
+    if (fs.existsSync(agentsPath)) {
+        try {
+            const data = JSON.parse(fs.readFileSync(agentsPath, 'utf-8'));
+            for (const agent of (data.agents || [])) {
+                if (agent.team === teamName) {
+                    members.add(agent.name);
+                }
+            }
+        }
+        catch {
+            // Ignore parse errors.
+        }
+    }
+    return Array.from(members);
+}
+export function isValidUsername(username) {
+    if (typeof username !== 'string')
+        return false;
+    if (username.length === 0 || username.length > 50)
+        return false;
+    if (!/^[a-zA-Z0-9]/.test(username) || !/[a-zA-Z0-9]$/.test(username))
+        return false;
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9 _.-]*[a-zA-Z0-9]$/.test(username) && username.length > 1)
+        return false;
+    if (username.length === 1 && !/^[a-zA-Z0-9]$/.test(username))
+        return false;
+    if (/  /.test(username))
+        return false;
+    return true;
+}
+export function isValidAvatarUrl(url) {
+    if (url === undefined || url === null)
+        return true;
+    if (typeof url !== 'string')
+        return false;
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== 'https:')
+            return false;
+        if (parsed.hostname === 'avatars.githubusercontent.com' ||
+            parsed.hostname === 'github.com' ||
+            parsed.hostname.endsWith('.githubusercontent.com'))
+            return true;
+        if (parsed.hostname === 'www.gravatar.com' ||
+            parsed.hostname === 'gravatar.com' ||
+            parsed.hostname === 'secure.gravatar.com')
+            return true;
+        if (parsed.hostname === 'ui-avatars.com')
+            return true;
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

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

package/dist/lib/websocket-runtime.d.ts

@@ -0,0 +1,17 @@
+import type { Server } from 'http';
+import type { WebSocket, WebSocketServer } from 'ws';
+export interface WebSocketRuntimeDeps {
+    server: Server;
+    wss: WebSocketServer;
+    wssBridge: WebSocketServer;
+    wssLogs: WebSocketServer;
+    wssPresence: WebSocketServer;
+    mainClientAlive: WeakMap<WebSocket, boolean>;
+    bridgeClientAlive: WeakMap<WebSocket, boolean>;
+    debug: (message: string) => void;
+}
+/**
+ * Configure ping/pong health checks, HTTP upgrade routing, and server-level WS error handlers.
+ */
+export declare function setupWebSocketRuntime(deps: WebSocketRuntimeDeps): void;
+//# sourceMappingURL=websocket-runtime.d.ts.map

package/dist/lib/websocket-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-runtime.d.ts","sourceRoot":"","sources":["../../src/lib/websocket-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,eAAe,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,eAAe,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,iBAAiB,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CA4FtE"}