@essentialai/cogent-server 2.0.0

package/dist/services/stats-service.d.ts

@@ -0,0 +1,48 @@
+import type { SessionStore } from "./session-store.js";
+import type { ConnectionManager } from "./connection-manager.js";
+/**
+ * Aggregated server statistics returned by StatsService.
+ */
+export interface ServerStats {
+    activeSessions: number;
+    connectedAgents: number;
+    totalMessagesRelayed: number;
+    /** Server uptime in seconds. */
+    uptime: number;
+}
+/**
+ * Cached stats aggregation service.
+ *
+ * Periodically refreshes aggregated counts from SessionStore (disk) and
+ * ConnectionManager (in-memory) so that SSE endpoints and UI pages can
+ * read stats without per-request disk I/O.
+ */
+export declare class StatsService {
+    private cachedStats;
+    private readonly sessionStore;
+    private readonly connectionManager;
+    private readonly startTime;
+    private refreshHandle;
+    constructor(sessionStore: SessionStore, connectionManager: ConnectionManager, startTime: number);
+    /**
+     * Refresh cached stats from disk (sessions, messages) and memory (connections).
+     * Called periodically by start() and can be called manually.
+     */
+    refresh(): Promise<void>;
+    /**
+     * Get cached stats with live uptime calculation.
+     * Returns a shallow copy so callers cannot mutate the cache.
+     */
+    getStats(): ServerStats;
+    /**
+     * Start periodic stats refresh.
+     * Calls refresh() immediately, then sets up an interval.
+     * The interval handle is unref'd so it does not block process exit.
+     */
+    start(intervalMs?: number): void;
+    /**
+     * Stop periodic stats refresh.
+     */
+    stop(): void;
+}
+//# sourceMappingURL=stats-service.d.ts.map

package/dist/services/stats-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-service.d.ts","sourceRoot":"","sources":["../../src/services/stats-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,aAAa,CAA+C;gBAGlE,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,iBAAiB,EACpC,SAAS,EAAE,MAAM;IAanB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;;OAGG;IACH,QAAQ,IAAI,WAAW;IAOvB;;;;OAIG;IACH,KAAK,CAAC,UAAU,GAAE,MAAa,GAAG,IAAI;IAUtC;;OAEG;IACH,IAAI,IAAI,IAAI;CAMb"}

package/dist/services/stats-service.js

@@ -0,0 +1,77 @@
+/**
+ * Cached stats aggregation service.
+ *
+ * Periodically refreshes aggregated counts from SessionStore (disk) and
+ * ConnectionManager (in-memory) so that SSE endpoints and UI pages can
+ * read stats without per-request disk I/O.
+ */
+export class StatsService {
+    cachedStats;
+    sessionStore;
+    connectionManager;
+    startTime;
+    refreshHandle = null;
+    constructor(sessionStore, connectionManager, startTime) {
+        this.sessionStore = sessionStore;
+        this.connectionManager = connectionManager;
+        this.startTime = startTime;
+        this.cachedStats = {
+            activeSessions: 0,
+            connectedAgents: 0,
+            totalMessagesRelayed: 0,
+            uptime: 0,
+        };
+    }
+    /**
+     * Refresh cached stats from disk (sessions, messages) and memory (connections).
+     * Called periodically by start() and can be called manually.
+     */
+    async refresh() {
+        const sessionIds = await this.sessionStore.listSessions();
+        let totalMessages = 0;
+        for (const id of sessionIds) {
+            const session = await this.sessionStore.getSession(id);
+            if (session)
+                totalMessages += session.messages.length;
+        }
+        this.cachedStats = {
+            activeSessions: sessionIds.length,
+            connectedAgents: this.connectionManager.getTotalConnectedPeers(),
+            totalMessagesRelayed: totalMessages,
+            uptime: (Date.now() - this.startTime) / 1000,
+        };
+    }
+    /**
+     * Get cached stats with live uptime calculation.
+     * Returns a shallow copy so callers cannot mutate the cache.
+     */
+    getStats() {
+        return {
+            ...this.cachedStats,
+            uptime: (Date.now() - this.startTime) / 1000,
+        };
+    }
+    /**
+     * Start periodic stats refresh.
+     * Calls refresh() immediately, then sets up an interval.
+     * The interval handle is unref'd so it does not block process exit.
+     */
+    start(intervalMs = 5000) {
+        // Initial refresh (fire and forget -- errors logged to stderr)
+        this.refresh().catch(console.error);
+        this.refreshHandle = setInterval(() => {
+            this.refresh().catch(console.error);
+        }, intervalMs);
+        this.refreshHandle.unref();
+    }
+    /**
+     * Stop periodic stats refresh.
+     */
+    stop() {
+        if (this.refreshHandle) {
+            clearInterval(this.refreshHandle);
+            this.refreshHandle = null;
+        }
+    }
+}
+//# sourceMappingURL=stats-service.js.map

package/dist/services/stats-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-service.js","sourceRoot":"","sources":["../../src/services/stats-service.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACf,WAAW,CAAc;IAChB,YAAY,CAAe;IAC3B,iBAAiB,CAAoB;IACrC,SAAS,CAAS;IAC3B,aAAa,GAA0C,IAAI,CAAC;IAEpE,YACE,YAA0B,EAC1B,iBAAoC,EACpC,SAAiB;QAEjB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG;YACjB,cAAc,EAAE,CAAC;YACjB,eAAe,EAAE,CAAC;YAClB,oBAAoB,EAAE,CAAC;YACvB,MAAM,EAAE,CAAC;SACV,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;QAC1D,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACvD,IAAI,OAAO;gBAAE,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,WAAW,GAAG;YACjB,cAAc,EAAE,UAAU,CAAC,MAAM;YACjC,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,EAAE;YAChE,oBAAoB,EAAE,aAAa;YACnC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI;SAC7C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO;YACL,GAAG,IAAI,CAAC,WAAW;YACnB,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI;SAC7C,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAqB,IAAI;QAC7B,+DAA+D;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEpC,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;YACpC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+import type { PeerInfo, MessageRecord, PeerEvent } from "@essentialai/cogent";
+/**
+ * An active bearer token entry stored in a session file.
+ * Tokens are stored as SHA-256 hashes (never plaintext).
+ */
+export interface TokenEntry {
+    tokenHash: string;
+    createdAt: string;
+    peerId?: string;
+}
+/**
+ * A message queued for offline delivery to a peer.
+ * Stored in the session file and flushed when the peer reconnects via WebSocket.
+ */
+export interface QueuedMessage {
+    /** References MessageRecord.id -- the message this queue entry wraps. */
+    messageId: string;
+    /** ISO 8601 timestamp when the message was enqueued -- used for 7-day TTL calculation. */
+    enqueuedAt: string;
+    /** Full message payload for delivery on reconnect. */
+    message: MessageRecord;
+}
+/**
+ * The full state of a single session, persisted as a JSON file on disk.
+ * Each session has its own file: `{sessionId}.json` in the state directory.
+ */
+export interface SessionFileState {
+    sessionId: string;
+    label?: string;
+    /** bcrypt hash of the plaintext secret -- never stored in plaintext. */
+    secretHash: string;
+    /** Active bearer tokens for this session. */
+    tokens: TokenEntry[];
+    createdAt: string;
+    /** IP address of the client that created this session (from X-Forwarded-For or direct). */
+    creatorIp?: string;
+    /** Registered peers, keyed by peerId. */
+    peers: Record<string, PeerInfo>;
+    /** Message history for this session. */
+    messages: MessageRecord[];
+    /** Peer lifecycle events for the poll endpoint. */
+    peerEvents: PeerEvent[];
+    /**
+     * Per-peer offline message queue, keyed by peerId.
+     * Optional so existing session files (from Phase 2A) still parse correctly.
+     * Default to `{}` on read when absent.
+     */
+    messageQueue?: Record<string, QueuedMessage[]>;
+}
+/**
+ * Hono environment type for server routes.
+ * Variables are set by auth middleware and accessible in handlers via c.var.
+ */
+export interface ServerEnv {
+    Variables: {
+        sessionId: string;
+        session: SessionFileState;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,wCAAwC;IACxC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,mDAAmD;IACnD,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,gBAAgB,CAAC;KAC3B,CAAC;CACH"}

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/ui/components/Footer.d.ts

@@ -0,0 +1,7 @@
+import type { FC } from "hono/jsx";
+/**
+ * Simple footer with branding text.
+ * Reusable across admin and public pages.
+ */
+export declare const Footer: FC;
+//# sourceMappingURL=Footer.d.ts.map

package/dist/ui/components/Footer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Footer.d.ts","sourceRoot":"","sources":["../../../src/ui/components/Footer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAanC;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,EAEpB,CAAC"}

package/dist/ui/components/Footer.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
+import { css } from "hono/css";
+import { colors } from "../styles/theme.js";
+const footerStyle = css `
+  text-align: center;
+  padding: 2rem 0;
+  color: ${colors.textMuted};
+  font-size: 0.8rem;
+  border-top: 1px solid ${colors.border};
+  margin-top: 2rem;
+`;
+/**
+ * Simple footer with branding text.
+ * Reusable across admin and public pages.
+ */
+export const Footer = () => (_jsxs("div", { class: footerStyle, children: ["COGENT \u2014 Powered by ", _jsx("a", { href: "https://essentialai.uk", style: "color: inherit;", children: "Essential AI Solutions Ltd." }), " \u2014 ", _jsx("a", { href: "/", style: "color: inherit;", children: "cogent.tools" })] }));
+//# sourceMappingURL=Footer.js.map

package/dist/ui/components/Footer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Footer.js","sourceRoot":"","sources":["../../../src/ui/components/Footer.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,WAAW,GAA2B,GAAG,CAAA;;;WAGpC,MAAM,CAAC,SAAS;;0BAED,MAAM,CAAC,MAAM;;CAEtC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAO,GAAG,EAAE,CAAC,CAC9B,eAAK,KAAK,EAAE,WAAW,0CAA4B,YAAG,IAAI,EAAC,wBAAwB,EAAC,KAAK,EAAC,iBAAiB,4CAAgC,cAAS,YAAG,IAAI,EAAC,GAAG,EAAC,KAAK,EAAC,iBAAiB,6BAAiB,IAAM,CAC/M,CAAC"}

package/dist/ui/components/Layout.d.ts

@@ -0,0 +1,13 @@
+import type { FC } from "hono/jsx";
+/** Props for the Layout component. */
+interface LayoutProps {
+    title: string;
+    children: any;
+}
+/**
+ * Base HTML shell with head, meta tags, Google Fonts, and global styles.
+ * Wraps every page with consistent document structure.
+ */
+export declare const Layout: FC<LayoutProps>;
+export {};
+//# sourceMappingURL=Layout.d.ts.map

package/dist/ui/components/Layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../src/ui/components/Layout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAInC,sCAAsC;AACtC,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,GAAG,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,EAAE,CAAC,WAAW,CAsBlC,CAAC"}

package/dist/ui/components/Layout.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
+import { Style } from "hono/css";
+import { globalStyles } from "../styles/theme.js";
+/**
+ * Base HTML shell with head, meta tags, Google Fonts, and global styles.
+ * Wraps every page with consistent document structure.
+ */
+export const Layout = ({ title, children }) => (_jsxs("html", { lang: "en", children: [_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsxs("title", { children: [title, " | COGENT"] }), _jsx(Style, {}), _jsx("link", { rel: "stylesheet", href: "https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&display=swap" }), _jsx("link", { rel: "icon", href: "data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'><rect width='16' height='16' rx='2' fill='%230d1117'/><path d='M12 3H5a2 2 0 00-2 2v6a2 2 0 002 2h7v-2H5V5h7V3z' fill='%2300ff41'/></svg>" }), _jsx("script", { async: true, src: "https://www.googletagmanager.com/gtag/js?id=G-6DKTK06CZT" }), _jsx("script", { dangerouslySetInnerHTML: {
+                        __html: `window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','G-6DKTK06CZT');`
+                    } })] }), _jsx("body", { class: globalStyles, children: children })] }));
+//# sourceMappingURL=Layout.js.map

package/dist/ui/components/Layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layout.js","sourceRoot":"","sources":["../../../src/ui/components/Layout.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAC9D,gBAAM,IAAI,EAAC,IAAI,aACb,2BACE,eAAM,OAAO,EAAC,OAAO,GAAG,EACxB,eAAM,IAAI,EAAC,UAAU,EAAC,OAAO,EAAC,qCAAqC,GAAG,EACtE,4BAAQ,KAAK,iBAAkB,EAC/B,KAAC,KAAK,KAAG,EACT,eACE,GAAG,EAAC,YAAY,EAChB,IAAI,EAAC,mFAAmF,GACxF,EACF,eACE,GAAG,EAAC,MAAM,EACV,IAAI,EAAC,0NAA0N,GAC/N,EACF,iBAAQ,KAAK,QAAC,GAAG,EAAC,0DAA0D,GAAG,EAC/E,iBAAQ,uBAAuB,EAAE;wBAC/B,MAAM,EAAE,uIAAuI;qBAChJ,GAAI,IACA,EACP,eAAM,KAAK,EAAE,YAAY,YAAG,QAAQ,GAAQ,IACvC,CACR,CAAC"}

package/dist/ui/components/NavBar.d.ts

@@ -0,0 +1,12 @@
+import type { FC } from "hono/jsx";
+/** Props for the NavBar component. */
+interface NavBarProps {
+    active?: "dashboard" | "sessions" | "messages";
+}
+/**
+ * Admin navigation bar with links to dashboard, sessions, and messages.
+ * Highlights the active page via the `active` prop.
+ */
+export declare const NavBar: FC<NavBarProps>;
+export {};
+//# sourceMappingURL=NavBar.d.ts.map

package/dist/ui/components/NavBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavBar.d.ts","sourceRoot":"","sources":["../../../src/ui/components/NavBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAInC,sCAAsC;AACtC,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;CAChD;AA0DD;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,EAAE,CAAC,WAAW,CAyBlC,CAAC"}

package/dist/ui/components/NavBar.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
+import { css } from "hono/css";
+import { colors } from "../styles/theme.js";
+const navStyle = css `
+  background: #010409;
+  padding: 0.75rem 1.5rem;
+  display: flex;
+  align-items: center;
+  gap: 1.5rem;
+  border-bottom: 1px solid ${colors.border};
+  margin-bottom: 2rem;
+`;
+const linkStyle = css `
+  color: ${colors.textMuted};
+  text-decoration: none;
+  font-size: 0.85rem;
+  padding: 0.35rem 0.75rem;
+  border-radius: 4px;
+  transition: color 0.15s;
+
+  &:hover {
+    color: ${colors.text};
+    text-decoration: none;
+  }
+`;
+const activeLinkStyle = css `
+  color: ${colors.green};
+  text-decoration: none;
+  font-size: 0.85rem;
+  padding: 0.35rem 0.75rem;
+  border-radius: 4px;
+  border-bottom: 2px solid ${colors.green};
+
+  &:hover {
+    text-decoration: none;
+  }
+`;
+const backLink = css `
+  margin-left: auto;
+  color: ${colors.textMuted};
+  text-decoration: none;
+  font-size: 0.8rem;
+
+  &:hover {
+    color: ${colors.cyan};
+    text-decoration: none;
+  }
+`;
+const brandText = css `
+  color: ${colors.green};
+  font-size: 0.85rem;
+  font-weight: 700;
+  margin-right: 0.5rem;
+`;
+/**
+ * Admin navigation bar with links to dashboard, sessions, and messages.
+ * Highlights the active page via the `active` prop.
+ */
+export const NavBar = ({ active }) => (_jsxs("nav", { class: navStyle, children: [_jsx("span", { class: brandText, children: "COGENT Admin" }), _jsx("a", { href: "/admin", class: active === "dashboard" ? activeLinkStyle : linkStyle, children: "Dashboard" }), _jsx("a", { href: "/admin/sessions", class: active === "sessions" ? activeLinkStyle : linkStyle, children: "Sessions" }), _jsx("a", { href: "/admin/messages", class: active === "messages" ? activeLinkStyle : linkStyle, children: "Messages" }), _jsx("a", { href: "/", class: backLink, children: "\u2190 Back to Site" })] }));
+//# sourceMappingURL=NavBar.js.map

package/dist/ui/components/NavBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavBar.js","sourceRoot":"","sources":["../../../src/ui/components/NavBar.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAO5C,MAAM,QAAQ,GAA2B,GAAG,CAAA;;;;;;6BAMf,MAAM,CAAC,MAAM;;CAEzC,CAAC;AAEF,MAAM,SAAS,GAA2B,GAAG,CAAA;WAClC,MAAM,CAAC,SAAS;;;;;;;;aAQd,MAAM,CAAC,IAAI;;;CAGvB,CAAC;AAEF,MAAM,eAAe,GAA2B,GAAG,CAAA;WACxC,MAAM,CAAC,KAAK;;;;;6BAKM,MAAM,CAAC,KAAK;;;;;CAKxC,CAAC;AAEF,MAAM,QAAQ,GAA2B,GAAG,CAAA;;WAEjC,MAAM,CAAC,SAAS;;;;;aAKd,MAAM,CAAC,IAAI;;;CAGvB,CAAC;AAEF,MAAM,SAAS,GAA2B,GAAG,CAAA;WAClC,MAAM,CAAC,KAAK;;;;CAItB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAoB,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CACrD,eAAK,KAAK,EAAE,QAAQ,aAClB,eAAM,KAAK,EAAE,SAAS,6BAAqB,EAC3C,YACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,0BAGzD,EACJ,YACE,IAAI,EAAC,iBAAiB,EACtB,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,yBAGxD,EACJ,YACE,IAAI,EAAC,iBAAiB,EACtB,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,yBAGxD,EACJ,YAAG,IAAI,EAAC,GAAG,EAAC,KAAK,EAAE,QAAQ,oCAEvB,IACA,CACP,CAAC"}

package/dist/ui/components/StatCard.d.ts

@@ -0,0 +1,14 @@
+import type { FC } from "hono/jsx";
+/** Props for the StatCard component. */
+interface StatCardProps {
+    id: string;
+    value: number;
+    label: string;
+}
+/**
+ * Stat display card with a large numeric value and descriptive label.
+ * The value element uses the `id` attribute for SSE live updates.
+ */
+export declare const StatCard: FC<StatCardProps>;
+export {};
+//# sourceMappingURL=StatCard.d.ts.map

package/dist/ui/components/StatCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatCard.d.ts","sourceRoot":"","sources":["../../../src/ui/components/StatCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAInC,wCAAwC;AACxC,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AA4BD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CAOtC,CAAC"}

package/dist/ui/components/StatCard.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
+import { css } from "hono/css";
+import { colors, fonts } from "../styles/theme.js";
+const cardStyle = css `
+  background: ${colors.bgCard};
+  border: 1px solid ${colors.border};
+  border-radius: 6px;
+  padding: 1.5rem;
+  text-align: center;
+  min-width: 180px;
+  flex: 1;
+`;
+const valueStyle = css `
+  font-family: ${fonts.mono};
+  font-size: 2.5rem;
+  font-weight: 700;
+  color: ${colors.green};
+  margin: 0 0 0.5rem 0;
+`;
+const labelStyle = css `
+  font-family: ${fonts.mono};
+  font-size: 0.75rem;
+  color: ${colors.textMuted};
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+`;
+/**
+ * Stat display card with a large numeric value and descriptive label.
+ * The value element uses the `id` attribute for SSE live updates.
+ */
+export const StatCard = ({ id, value, label }) => (_jsxs("div", { class: cardStyle, children: [_jsx("div", { id: id, class: valueStyle, children: value }), _jsx("div", { class: labelStyle, children: label })] }));
+//# sourceMappingURL=StatCard.js.map

package/dist/ui/components/StatCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatCard.js","sourceRoot":"","sources":["../../../src/ui/components/StatCard.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AASnD,MAAM,SAAS,GAA2B,GAAG,CAAA;gBAC7B,MAAM,CAAC,MAAM;sBACP,MAAM,CAAC,MAAM;;;;;;CAMlC,CAAC;AAEF,MAAM,UAAU,GAA2B,GAAG,CAAA;iBAC7B,KAAK,CAAC,IAAI;;;WAGhB,MAAM,CAAC,KAAK;;CAEtB,CAAC;AAEF,MAAM,UAAU,GAA2B,GAAG,CAAA;iBAC7B,KAAK,CAAC,IAAI;;WAEhB,MAAM,CAAC,SAAS;;;CAG1B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAsB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CACnE,eAAK,KAAK,EAAE,SAAS,aACnB,cAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,YAC3B,KAAK,GACF,EACN,cAAK,KAAK,EAAE,UAAU,YAAG,KAAK,GAAO,IACjC,CACP,CAAC"}

package/dist/ui/components/Terminal.d.ts

@@ -0,0 +1,13 @@
+import type { FC } from "hono/jsx";
+/** Props for the Terminal component. */
+interface TerminalProps {
+    title?: string;
+    children: any;
+}
+/**
+ * Terminal-styled container with optional header bar (colored dots + title)
+ * and padded content area. Used to wrap code blocks and guide sections.
+ */
+export declare const Terminal: FC<TerminalProps>;
+export {};
+//# sourceMappingURL=Terminal.d.ts.map

package/dist/ui/components/Terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.d.ts","sourceRoot":"","sources":["../../../src/ui/components/Terminal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAInC,wCAAwC;AACxC,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;CACf;AAmCD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CAYtC,CAAC"}

package/dist/ui/components/Terminal.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
+import { css } from "hono/css";
+import { colors } from "../styles/theme.js";
+const terminalWrapper = css `
+  background: ${colors.bgTerminal};
+  border: 1px solid ${colors.border};
+  border-radius: 8px;
+  overflow: hidden;
+`;
+const headerBar = css `
+  background: #010409;
+  padding: 0.75rem 1rem;
+  border-bottom: 1px solid ${colors.border};
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+`;
+const dot = css `
+  width: 12px;
+  height: 12px;
+  border-radius: 50%;
+  display: inline-block;
+`;
+const titleText = css `
+  color: ${colors.textMuted};
+  font-size: 0.8rem;
+  margin-left: 0.5rem;
+`;
+const contentArea = css `
+  padding: 1.5rem;
+`;
+/**
+ * Terminal-styled container with optional header bar (colored dots + title)
+ * and padded content area. Used to wrap code blocks and guide sections.
+ */
+export const Terminal = ({ title, children }) => (_jsxs("div", { class: terminalWrapper, children: [title && (_jsxs("div", { class: headerBar, children: [_jsx("span", { class: dot, style: "background: #f85149;" }), _jsx("span", { class: dot, style: "background: #e3b341;" }), _jsx("span", { class: dot, style: "background: #00ff41;" }), _jsx("span", { class: titleText, children: title })] })), _jsx("div", { class: contentArea, children: children })] }));
+//# sourceMappingURL=Terminal.js.map

package/dist/ui/components/Terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Terminal.js","sourceRoot":"","sources":["../../../src/ui/components/Terminal.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C,MAAM,eAAe,GAA2B,GAAG,CAAA;gBACnC,MAAM,CAAC,UAAU;sBACX,MAAM,CAAC,MAAM;;;CAGlC,CAAC;AAEF,MAAM,SAAS,GAA2B,GAAG,CAAA;;;6BAGhB,MAAM,CAAC,MAAM;;;;CAIzC,CAAC;AAEF,MAAM,GAAG,GAA2B,GAAG,CAAA;;;;;CAKtC,CAAC;AAEF,MAAM,SAAS,GAA2B,GAAG,CAAA;WAClC,MAAM,CAAC,SAAS;;;CAG1B,CAAC;AAEF,MAAM,WAAW,GAA2B,GAAG,CAAA;;CAE9C,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAsB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAClE,eAAK,KAAK,EAAE,eAAe,aACxB,KAAK,IAAI,CACR,eAAK,KAAK,EAAE,SAAS,aACnB,eAAM,KAAK,EAAE,GAAG,EAAE,KAAK,EAAC,sBAAsB,GAAG,EACjD,eAAM,KAAK,EAAE,GAAG,EAAE,KAAK,EAAC,sBAAsB,GAAG,EACjD,eAAM,KAAK,EAAE,GAAG,EAAE,KAAK,EAAC,sBAAsB,GAAG,EACjD,eAAM,KAAK,EAAE,SAAS,YAAG,KAAK,GAAQ,IAClC,CACP,EACD,cAAK,KAAK,EAAE,WAAW,YAAG,QAAQ,GAAO,IACrC,CACP,CAAC"}

package/dist/ui/pages/AdminDashboard.d.ts

@@ -0,0 +1,13 @@
+import type { FC } from "hono/jsx";
+import type { ServerStats } from "../../services/stats-service.js";
+/** Props for the AdminDashboard page. */
+interface AdminDashboardProps {
+    stats: ServerStats;
+}
+/**
+ * Admin overview page with summary stats and quick-action links.
+ * Renders Layout with NavBar, three stat cards, and navigation buttons.
+ */
+export declare const AdminDashboard: FC<AdminDashboardProps>;
+export {};
+//# sourceMappingURL=AdminDashboard.d.ts.map

package/dist/ui/pages/AdminDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminDashboard.d.ts","sourceRoot":"","sources":["../../../src/ui/pages/AdminDashboard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAOnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,yCAAyC;AACzC,UAAU,mBAAmB;IAC3B,KAAK,EAAE,WAAW,CAAC;CACpB;AAuDD;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAuClD,CAAC"}

package/dist/ui/pages/AdminDashboard.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
+import { css } from "hono/css";
+import { Layout } from "../components/Layout.js";
+import { NavBar } from "../components/NavBar.js";
+import { StatCard } from "../components/StatCard.js";
+import { Footer } from "../components/Footer.js";
+import { colors } from "../styles/theme.js";
+const container = css `
+  max-width: 960px;
+  margin: 0 auto;
+  padding: 0 1.5rem 2rem;
+`;
+const pageTitle = css `
+  font-size: 1.5rem;
+  font-weight: 700;
+  color: ${colors.text};
+  margin: 0 0 2rem 0;
+`;
+const statsRow = css `
+  display: flex;
+  gap: 1.5rem;
+  flex-wrap: wrap;
+  margin-bottom: 3rem;
+`;
+const quickLinksSection = css `
+  margin-top: 1rem;
+`;
+const quickLinksTitle = css `
+  font-size: 1rem;
+  font-weight: 700;
+  color: ${colors.text};
+  margin: 0 0 1rem 0;
+`;
+const linkRow = css `
+  display: flex;
+  gap: 1rem;
+  flex-wrap: wrap;
+`;
+const actionLink = css `
+  display: inline-block;
+  padding: 0.6rem 1.2rem;
+  background: ${colors.bgCard};
+  border: 1px solid ${colors.border};
+  border-radius: 4px;
+  color: ${colors.cyan};
+  text-decoration: none;
+  font-size: 0.85rem;
+
+  &:hover {
+    border-color: ${colors.cyan};
+    text-decoration: none;
+  }
+`;
+/**
+ * Admin overview page with summary stats and quick-action links.
+ * Renders Layout with NavBar, three stat cards, and navigation buttons.
+ */
+export const AdminDashboard = ({ stats }) => (_jsxs(Layout, { title: "Admin Dashboard", children: [_jsx(NavBar, { active: "dashboard" }), _jsxs("div", { class: container, children: [_jsx("h1", { class: pageTitle, children: "Dashboard" }), _jsxs("div", { class: statsRow, children: [_jsx(StatCard, { id: "admin-sessions", value: stats.activeSessions, label: "Active Sessions" }), _jsx(StatCard, { id: "admin-agents", value: stats.connectedAgents, label: "Connected Agents" }), _jsx(StatCard, { id: "admin-messages", value: stats.totalMessagesRelayed, label: "Total Messages" })] }), _jsxs("div", { class: quickLinksSection, children: [_jsx("h2", { class: quickLinksTitle, children: "Quick Actions" }), _jsxs("div", { class: linkRow, children: [_jsx("a", { href: "/admin/sessions", class: actionLink, children: "Manage Sessions" }), _jsx("a", { href: "/admin/messages", class: actionLink, children: "View Messages" })] })] }), _jsx(Footer, {})] })] }));
+//# sourceMappingURL=AdminDashboard.js.map

package/dist/ui/pages/AdminDashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminDashboard.js","sourceRoot":"","sources":["../../../src/ui/pages/AdminDashboard.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C,MAAM,SAAS,GAA2B,GAAG,CAAA;;;;CAI5C,CAAC;AAEF,MAAM,SAAS,GAA2B,GAAG,CAAA;;;WAGlC,MAAM,CAAC,IAAI;;CAErB,CAAC;AAEF,MAAM,QAAQ,GAA2B,GAAG,CAAA;;;;;CAK3C,CAAC;AAEF,MAAM,iBAAiB,GAA2B,GAAG,CAAA;;CAEpD,CAAC;AAEF,MAAM,eAAe,GAA2B,GAAG,CAAA;;;WAGxC,MAAM,CAAC,IAAI;;CAErB,CAAC;AAEF,MAAM,OAAO,GAA2B,GAAG,CAAA;;;;CAI1C,CAAC;AAEF,MAAM,UAAU,GAA2B,GAAG,CAAA;;;gBAG9B,MAAM,CAAC,MAAM;sBACP,MAAM,CAAC,MAAM;;WAExB,MAAM,CAAC,IAAI;;;;;oBAKF,MAAM,CAAC,IAAI;;;CAG9B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CACpE,MAAC,MAAM,IAAC,KAAK,EAAC,iBAAiB,aAC7B,KAAC,MAAM,IAAC,MAAM,EAAC,WAAW,GAAG,EAC7B,eAAK,KAAK,EAAE,SAAS,aACnB,aAAI,KAAK,EAAE,SAAS,0BAAgB,EAEpC,eAAK,KAAK,EAAE,QAAQ,aAClB,KAAC,QAAQ,IACP,EAAE,EAAC,gBAAgB,EACnB,KAAK,EAAE,KAAK,CAAC,cAAc,EAC3B,KAAK,EAAC,iBAAiB,GACvB,EACF,KAAC,QAAQ,IACP,EAAE,EAAC,cAAc,EACjB,KAAK,EAAE,KAAK,CAAC,eAAe,EAC5B,KAAK,EAAC,kBAAkB,GACxB,EACF,KAAC,QAAQ,IACP,EAAE,EAAC,gBAAgB,EACnB,KAAK,EAAE,KAAK,CAAC,oBAAoB,EACjC,KAAK,EAAC,gBAAgB,GACtB,IACE,EAEN,eAAK,KAAK,EAAE,iBAAiB,aAC3B,aAAI,KAAK,EAAE,eAAe,8BAAoB,EAC9C,eAAK,KAAK,EAAE,OAAO,aACjB,YAAG,IAAI,EAAC,iBAAiB,EAAC,KAAK,EAAE,UAAU,gCAEvC,EACJ,YAAG,IAAI,EAAC,iBAAiB,EAAC,KAAK,EAAE,UAAU,8BAEvC,IACA,IACF,EAEN,KAAC,MAAM,KAAG,IACN,IACC,CACV,CAAC"}

package/dist/ui/pages/HowToPage.d.ts

@@ -0,0 +1,8 @@
+import type { FC } from "hono/jsx";
+/**
+ * Comprehensive "How-To" guide page covering real-world use cases
+ * for Cogent Bridge from the perspective of business owners,
+ * product owners, and project managers.
+ */
+export declare const HowToPage: FC;
+//# sourceMappingURL=HowToPage.d.ts.map

package/dist/ui/pages/HowToPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HowToPage.d.ts","sourceRoot":"","sources":["../../../src/ui/pages/HowToPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAmTnC;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,EAi0BvB,CAAC"}