@privateclaw/privateclaw-relay 0.1.7 → 0.1.9

package/.env.example

@@ -5,6 +5,8 @@ PRIVATECLAW_FRAME_CACHE_SIZE=25
 # PRIVATECLAW_MAX_MESSAGE_BYTES=25165824
 # PRIVATECLAW_APP_MESSAGES_PER_MINUTE=120
 # PRIVATECLAW_PROVIDER_MESSAGES_PER_MINUTE=600
+# Optional: enable the built-in relay admin UI/API at /admin and /api/admin/*
+# PRIVATECLAW_ADMIN_TOKEN=replace-with-a-long-random-token
 # Optional: enable background wake through Firebase Cloud Messaging.
 # Use either the full service-account JSON...
 # PRIVATECLAW_FCM_SERVICE_ACCOUNT_JSON={"type":"service_account","project_id":"your-project","client_email":"...","private_key":"-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"}

package/README.md

@@ -44,6 +44,25 @@ privateclaw-relay --host 0.0.0.0 --port 8787
 privateclaw-relay --redis-url redis://127.0.0.1:6379
 ```
 
+Enable the built-in relay admin UI/API with a fixed bearer token:
+
+```bash
+export PRIVATECLAW_ADMIN_TOKEN=replace-with-a-long-random-token
+privateclaw-relay --redis-url redis://127.0.0.1:6379
+```
+
+When `PRIVATECLAW_ADMIN_TOKEN` is configured, the relay serves a simple admin dashboard at `/admin/` and protects the JSON APIs under `/api/admin/*` with `Authorization: Bearer <token>`.
+
+The admin dashboard shows:
+
+- current active sessions and participants
+- session history and per-session details
+- participant online time and message counts
+- relay request/error statistics
+- live relay instance heartbeats
+
+For multi-instance deployments, point every relay instance at the same Redis so the admin view can aggregate shared session history and instance status.
+
 Expose the local relay to the internet through Tailscale Funnel:
 
 ```bash
@@ -94,6 +113,7 @@ The relay still reads its runtime config from the process environment:
 - `PRIVATECLAW_RELAY_INSTANCE_ID`
 - `PRIVATECLAW_REDIS_URL`
 - `REDIS_URL`
+- `PRIVATECLAW_ADMIN_TOKEN`
 - `PRIVATECLAW_FCM_SERVICE_ACCOUNT_JSON`
 - `PRIVATECLAW_FCM_PROJECT_ID`
 - `PRIVATECLAW_FCM_CLIENT_EMAIL`

package/dist/admin-api.d.ts

@@ -0,0 +1,11 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { RelayAdminMetricsStore } from "./admin-metrics-store.js";
+export interface HandleRelayAdminRequestOptions {
+    request: IncomingMessage;
+    response: ServerResponse;
+    url: URL;
+    adminToken?: string;
+    metricsStore: RelayAdminMetricsStore;
+    now?: () => number;
+}
+export declare function handleRelayAdminRequest(options: HandleRelayAdminRequestOptions): Promise<boolean>;

package/dist/admin-api.js

@@ -0,0 +1,111 @@
+function writeJson(response, statusCode, payload) {
+    response.writeHead(statusCode, { "content-type": "application/json" });
+    response.end(JSON.stringify(payload));
+}
+function normalizeBearerToken(headerValue) {
+    if (!headerValue) {
+        return undefined;
+    }
+    const match = headerValue.match(/^Bearer\s+(.+)$/i);
+    if (!match) {
+        return undefined;
+    }
+    return match[1]?.trim() || undefined;
+}
+function isAuthorized(request, expectedToken) {
+    const headerValue = request.headers.authorization;
+    if (typeof headerValue !== "string") {
+        return false;
+    }
+    return normalizeBearerToken(headerValue) === expectedToken;
+}
+function parsePositiveInteger(rawValue, fallback) {
+    if (!rawValue) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(rawValue, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        return fallback;
+    }
+    return parsed;
+}
+function parseStatus(rawValue) {
+    if (!rawValue || rawValue === "all") {
+        return "all";
+    }
+    if (rawValue === "active" ||
+        rawValue === "closed" ||
+        rawValue === "expired") {
+        return rawValue;
+    }
+    return "all";
+}
+export async function handleRelayAdminRequest(options) {
+    if (!options.url.pathname.startsWith("/api/admin")) {
+        return false;
+    }
+    if (!options.adminToken) {
+        writeJson(options.response, 404, { error: "not_found" });
+        return true;
+    }
+    if (options.request.method !== "GET") {
+        options.response.writeHead(405, {
+            "content-type": "application/json",
+            allow: "GET",
+        });
+        options.response.end(JSON.stringify({ error: "method_not_allowed" }));
+        return true;
+    }
+    if (!isAuthorized(options.request, options.adminToken)) {
+        options.response.writeHead(401, {
+            "content-type": "application/json",
+            "www-authenticate": 'Bearer realm="PrivateClaw Relay Admin"',
+        });
+        options.response.end(JSON.stringify({ error: "unauthorized" }));
+        return true;
+    }
+    const now = options.now?.() ?? Date.now();
+    if (options.url.pathname === "/api/admin" ||
+        options.url.pathname === "/api/admin/overview") {
+        writeJson(options.response, 200, await options.metricsStore.getOverview(now));
+        return true;
+    }
+    if (options.url.pathname === "/api/admin/sessions") {
+        const page = parsePositiveInteger(options.url.searchParams.get("page"), 1);
+        const pageSize = parsePositiveInteger(options.url.searchParams.get("pageSize"), 50);
+        const query = options.url.searchParams.get("query") ?? undefined;
+        const status = parseStatus(options.url.searchParams.get("status"));
+        writeJson(options.response, 200, await options.metricsStore.listSessions({
+            page,
+            pageSize,
+            ...(query ? { query } : {}),
+            ...(status ? { status } : {}),
+            now,
+        }));
+        return true;
+    }
+    if (options.url.pathname.startsWith("/api/admin/sessions/")) {
+        const sessionId = decodeURIComponent(options.url.pathname.slice("/api/admin/sessions/".length));
+        if (!sessionId) {
+            writeJson(options.response, 404, { error: "not_found" });
+            return true;
+        }
+        const detail = await options.metricsStore.getSessionDetail(sessionId, now);
+        if (!detail) {
+            writeJson(options.response, 404, { error: "unknown_session" });
+            return true;
+        }
+        writeJson(options.response, 200, detail);
+        return true;
+    }
+    if (options.url.pathname === "/api/admin/instances") {
+        writeJson(options.response, 200, {
+            generatedAt: now,
+            instances: await options.metricsStore.listInstances(now),
+        });
+        return true;
+    }
+    writeJson(options.response, 404, { error: "not_found" });
+    return true;
+}
+//# sourceMappingURL=admin-api.js.map

package/dist/admin-api.js.map

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

package/dist/admin-metrics-store.d.ts

@@ -0,0 +1,245 @@
+import type { RelaySessionRecord } from "./session-store.js";
+export type RelayAdminSessionStatus = "active" | "closed" | "expired";
+export type RelayAdminRequestActor = "app" | "provider";
+export interface RelayAdminRequestTypeCount {
+    actor: RelayAdminRequestActor;
+    type: string;
+    ok: number;
+    error: number;
+}
+export interface RelayAdminErrorCodeCount {
+    code: string;
+    count: number;
+}
+export interface RelayAdminRequestStats {
+    appRequests: number;
+    providerRequests: number;
+    appSuccesses: number;
+    providerSuccesses: number;
+    appErrors: number;
+    providerErrors: number;
+    appFrames: number;
+    providerFrames: number;
+    errorCodes: RelayAdminErrorCodeCount[];
+    requestTypes: RelayAdminRequestTypeCount[];
+}
+export interface RelayAdminOverviewTotals {
+    sessions: number;
+    activeSessions: number;
+    closedSessions: number;
+    expiredSessions: number;
+    knownParticipants: number;
+    activeParticipants: number;
+    instances: number;
+}
+export interface RelayAdminOverview {
+    generatedAt: number;
+    totals: RelayAdminOverviewTotals;
+    requestStats: RelayAdminRequestStats;
+}
+export interface RelayAdminSessionSummary {
+    sessionId: string;
+    providerId: string;
+    groupMode: boolean;
+    createdAt: number;
+    updatedAt: number;
+    expiresAt: number;
+    closedAt?: number;
+    closeReason?: string;
+    status: RelayAdminSessionStatus;
+    appMessageCount: number;
+    providerMessageCount: number;
+    distinctParticipantCount: number;
+    activeParticipantCount: number;
+    providerOnline: boolean;
+    lastAppMessageAt?: number;
+    lastProviderMessageAt?: number;
+}
+export interface RelayAdminSessionParticipant {
+    appId: string;
+    firstSeenAt: number;
+    lastSeenAt: number;
+    lastConnectedAt?: number;
+    lastDisconnectedAt?: number;
+    lastDisconnectReason?: string;
+    connectionCount: number;
+    messageCount: number;
+    totalConnectedMs: number;
+    currentConnectedMs: number;
+    isOnline: boolean;
+}
+export interface RelayAdminSessionDetail {
+    session: RelayAdminSessionSummary;
+    participants: RelayAdminSessionParticipant[];
+}
+export interface RelayAdminSessionListOptions {
+    status?: RelayAdminSessionStatus | "all";
+    page?: number;
+    pageSize?: number;
+    query?: string;
+    now?: number;
+}
+export interface RelayAdminSessionListResult {
+    total: number;
+    page: number;
+    pageSize: number;
+    sessions: RelayAdminSessionSummary[];
+}
+export interface RelayAdminInstanceBinding {
+    sessionId: string;
+    appId: string;
+}
+export interface RelayAdminInstanceStatus {
+    instanceId: string;
+    startedAt: number;
+    lastSeenAt: number;
+    activeProviders: number;
+    activeApps: number;
+    localSessions: number;
+    providerIds: string[];
+    sessionIds: string[];
+    participantBindings: RelayAdminInstanceBinding[];
+    memoryUsage: {
+        rss: number;
+        heapTotal: number;
+        heapUsed: number;
+        external: number;
+        arrayBuffers: number;
+    };
+}
+export interface RelayAdminLocalSnapshot {
+    activeProviders: number;
+    activeApps: number;
+    localSessions: number;
+    providerIds: string[];
+    sessionIds: string[];
+    participantBindings: RelayAdminInstanceBinding[];
+    memoryUsage: NodeJS.MemoryUsage;
+}
+export interface RelayAdminInstanceHeartbeat {
+    instanceId: string;
+    startedAt: number;
+    recordedAt: number;
+    snapshot: RelayAdminLocalSnapshot;
+}
+export interface RelayAdminMetricsStore {
+    readonly persistent: boolean;
+    recordSessionCreated(session: RelaySessionRecord, recordedAt: number): Promise<void>;
+    recordSessionRenewed(session: RelaySessionRecord, recordedAt: number): Promise<void>;
+    recordSessionClosed(sessionId: string, reason: string, recordedAt: number): Promise<void>;
+    recordAppAttached(session: RelaySessionRecord, appId: string, recordedAt: number): Promise<void>;
+    recordAppDetached(sessionId: string, appId: string, recordedAt: number, reason: string): Promise<void>;
+    recordAppFrame(sessionId: string, appId: string, recordedAt: number): Promise<void>;
+    recordProviderFrame(sessionId: string, recordedAt: number): Promise<void>;
+    recordRequest(params: {
+        actor: RelayAdminRequestActor;
+        type: string;
+        ok: boolean;
+        errorCode?: string;
+    }): Promise<void>;
+    recordInstanceHeartbeat(heartbeat: RelayAdminInstanceHeartbeat): Promise<void>;
+    unregisterInstance(instanceId: string): Promise<void>;
+    listSessions(options?: RelayAdminSessionListOptions): Promise<RelayAdminSessionListResult>;
+    getSessionDetail(sessionId: string, now?: number): Promise<RelayAdminSessionDetail | undefined>;
+    getOverview(now?: number): Promise<RelayAdminOverview>;
+    listInstances(now?: number): Promise<RelayAdminInstanceStatus[]>;
+    close(): Promise<void>;
+}
+declare abstract class BaseRelayAdminMetricsStore implements RelayAdminMetricsStore {
+    abstract readonly persistent: boolean;
+    protected buildOverview(params: {
+        sessions: RelayAdminSessionSummary[];
+        instances: RelayAdminInstanceStatus[];
+        requestStats: RelayAdminRequestStats;
+        generatedAt: number;
+    }): RelayAdminOverview;
+    abstract recordSessionCreated(session: RelaySessionRecord, recordedAt: number): Promise<void>;
+    abstract recordSessionRenewed(session: RelaySessionRecord, recordedAt: number): Promise<void>;
+    abstract recordSessionClosed(sessionId: string, reason: string, recordedAt: number): Promise<void>;
+    abstract recordAppAttached(session: RelaySessionRecord, appId: string, recordedAt: number): Promise<void>;
+    abstract recordAppDetached(sessionId: string, appId: string, recordedAt: number, reason: string): Promise<void>;
+    abstract recordAppFrame(sessionId: string, appId: string, recordedAt: number): Promise<void>;
+    abstract recordProviderFrame(sessionId: string, recordedAt: number): Promise<void>;
+    abstract recordRequest(params: {
+        actor: RelayAdminRequestActor;
+        type: string;
+        ok: boolean;
+        errorCode?: string;
+    }): Promise<void>;
+    abstract recordInstanceHeartbeat(heartbeat: RelayAdminInstanceHeartbeat): Promise<void>;
+    abstract unregisterInstance(instanceId: string): Promise<void>;
+    abstract listSessions(options?: RelayAdminSessionListOptions): Promise<RelayAdminSessionListResult>;
+    abstract getSessionDetail(sessionId: string, now?: number): Promise<RelayAdminSessionDetail | undefined>;
+    abstract getOverview(now?: number): Promise<RelayAdminOverview>;
+    abstract listInstances(now?: number): Promise<RelayAdminInstanceStatus[]>;
+    abstract close(): Promise<void>;
+}
+export declare class InMemoryRelayAdminMetricsStore extends BaseRelayAdminMetricsStore {
+    readonly persistent = false;
+    private readonly sessions;
+    private readonly participants;
+    private readonly instances;
+    private readonly errorCodeCounts;
+    private readonly requestTypeCounts;
+    private readonly globalStats;
+    private ensureSession;
+    private ensureParticipant;
+    private activeInstances;
+    private liveState;
+    private requestStats;
+    recordSessionCreated(session: RelaySessionRecord, recordedAt: number): Promise<void>;
+    recordSessionRenewed(session: RelaySessionRecord, recordedAt: number): Promise<void>;
+    recordSessionClosed(sessionId: string, reason: string, recordedAt: number): Promise<void>;
+    recordAppAttached(session: RelaySessionRecord, appId: string, recordedAt: number): Promise<void>;
+    recordAppDetached(sessionId: string, appId: string, recordedAt: number, reason: string): Promise<void>;
+    recordAppFrame(sessionId: string, appId: string, recordedAt: number): Promise<void>;
+    recordProviderFrame(sessionId: string, recordedAt: number): Promise<void>;
+    recordRequest(params: {
+        actor: RelayAdminRequestActor;
+        type: string;
+        ok: boolean;
+        errorCode?: string;
+    }): Promise<void>;
+    recordInstanceHeartbeat(heartbeat: RelayAdminInstanceHeartbeat): Promise<void>;
+    unregisterInstance(instanceId: string): Promise<void>;
+    listSessions(options?: RelayAdminSessionListOptions): Promise<RelayAdminSessionListResult>;
+    getSessionDetail(sessionId: string, now?: number): Promise<RelayAdminSessionDetail | undefined>;
+    getOverview(now?: number): Promise<RelayAdminOverview>;
+    listInstances(now?: number): Promise<RelayAdminInstanceStatus[]>;
+    close(): Promise<void>;
+}
+export declare class RedisRelayAdminMetricsStore extends BaseRelayAdminMetricsStore {
+    readonly persistent = true;
+    private readonly redis;
+    constructor(redisUrl: string);
+    private ensureSession;
+    private loadSession;
+    private loadParticipant;
+    private pruneStaleInstances;
+    private loadLiveState;
+    private loadRequestStats;
+    recordSessionCreated(session: RelaySessionRecord, recordedAt: number): Promise<void>;
+    recordSessionRenewed(session: RelaySessionRecord, recordedAt: number): Promise<void>;
+    recordSessionClosed(sessionId: string, reason: string, recordedAt: number): Promise<void>;
+    recordAppAttached(session: RelaySessionRecord, appId: string, recordedAt: number): Promise<void>;
+    recordAppDetached(sessionId: string, appId: string, recordedAt: number, reason: string): Promise<void>;
+    recordAppFrame(sessionId: string, appId: string, recordedAt: number): Promise<void>;
+    recordProviderFrame(sessionId: string, recordedAt: number): Promise<void>;
+    recordRequest(params: {
+        actor: RelayAdminRequestActor;
+        type: string;
+        ok: boolean;
+        errorCode?: string;
+    }): Promise<void>;
+    recordInstanceHeartbeat(heartbeat: RelayAdminInstanceHeartbeat): Promise<void>;
+    unregisterInstance(instanceId: string): Promise<void>;
+    listSessions(options?: RelayAdminSessionListOptions): Promise<RelayAdminSessionListResult>;
+    getSessionDetail(sessionId: string, now?: number): Promise<RelayAdminSessionDetail | undefined>;
+    getOverview(now?: number): Promise<RelayAdminOverview>;
+    listInstances(now?: number): Promise<RelayAdminInstanceStatus[]>;
+    close(): Promise<void>;
+}
+export declare function createRelayAdminMetricsStore(params: {
+    redisUrl?: string;
+}): RelayAdminMetricsStore;
+export {};