yepanywhere 0.1.0

package/dist/maintenance/server.js

@@ -0,0 +1,419 @@
+/**
+ * Maintenance server - runs on a separate port for out-of-band diagnostics.
+ *
+ * Uses raw Node.js http module (no frameworks) to be as lightweight as possible
+ * and independent from the main server's event loop. This allows diagnostics
+ * even when the main server is unresponsive.
+ *
+ * Security: Rejects browser cross-origin requests (Origin header present) to
+ * prevent drive-by attacks from malicious websites. Only allows requests from
+ * curl, wget, or same-origin browser requests.
+ *
+ * Endpoints:
+ * - GET  /health         - Simple health check
+ * - GET  /status         - Server status (memory, uptime, connections)
+ * - GET  /log/level      - Get current log levels
+ * - PUT  /log/level      - Set log levels { console?: string, file?: string }
+ * - GET  /proxy/debug    - Get PROXY_DEBUG status
+ * - PUT  /proxy/debug    - Set PROXY_DEBUG { enabled: boolean }
+ * - GET  /inspector       - Get Chrome DevTools inspector status
+ * - POST /inspector/open  - Enable Chrome DevTools inspector
+ * - POST /inspector/close - Disable Chrome DevTools inspector
+ * - POST /reload         - Trigger graceful server restart
+ */
+import * as http from "node:http";
+import * as inspector from "node:inspector";
+import { LOG_LEVELS, getLogLevels, setLogLevels, } from "../logging/logger.js";
+import { handleDebugRequest } from "./debug-routes.js";
+/** Current PROXY_DEBUG state (can be toggled at runtime) */
+let proxyDebugEnabled = process.env.PROXY_DEBUG === "1" || process.env.PROXY_DEBUG === "true";
+/** Export for use by proxy module */
+export function isProxyDebugEnabled() {
+    return proxyDebugEnabled;
+}
+const connectionStats = {
+    activeHttpConnections: 0,
+    activeWsConnections: 0,
+    totalHttpRequests: 0,
+    totalWsUpgrades: 0,
+};
+/** Update connection stats (called from proxy/server code) */
+export function updateConnectionStats(update) {
+    Object.assign(connectionStats, update);
+}
+/** Increment a counter */
+export function incrementConnectionStat(key, delta = 1) {
+    connectionStats[key] += delta;
+}
+/**
+ * Start the maintenance server.
+ * Returns a function to stop the server.
+ */
+export function startMaintenanceServer(options) {
+    const { port, mainServerPort } = options;
+    const startTime = Date.now();
+    const server = http.createServer(async (req, res) => {
+        const url = new URL(req.url || "/", `http://localhost:${port}`);
+        const path = url.pathname;
+        const method = req.method || "GET";
+        // Security: Reject cross-origin browser requests to prevent drive-by attacks.
+        // Browsers send Origin header for cross-origin requests (including from malicious sites).
+        // We allow:
+        // - Requests without Origin (curl, wget, etc.)
+        // - Requests from same origin (localhost:PORT)
+        // - Requests with Sec-Fetch-Site: same-origin or none
+        const origin = req.headers.origin;
+        const secFetchSite = req.headers["sec-fetch-site"];
+        if (origin) {
+            // Check if it's a same-origin request
+            const isSameOrigin = origin === `http://localhost:${port}` ||
+                origin === `http://127.0.0.1:${port}`;
+            // Check Sec-Fetch-Site header (modern browsers)
+            const isAllowedSecFetch = secFetchSite === "same-origin" || secFetchSite === "none";
+            if (!isSameOrigin && !isAllowedSecFetch) {
+                res.writeHead(403, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({
+                    error: "Forbidden",
+                    message: "Cross-origin requests not allowed. Use curl or access directly.",
+                    hint: `curl http://localhost:${port}${path}`,
+                }));
+                return;
+            }
+        }
+        // No CORS headers - we don't want to enable cross-origin access
+        if (method === "OPTIONS") {
+            // Reject CORS preflight - we don't support cross-origin
+            res.writeHead(403);
+            res.end();
+            return;
+        }
+        // Route handling
+        try {
+            // Try debug routes first (async)
+            if (path.startsWith("/debug")) {
+                const handled = await handleDebugRequest(req, res, url);
+                if (handled)
+                    return;
+            }
+            if (path === "/health" && method === "GET") {
+                handleHealth(res);
+            }
+            else if (path === "/status" && method === "GET") {
+                handleStatus(res, startTime, mainServerPort);
+            }
+            else if (path === "/log/level" && method === "GET") {
+                handleGetLogLevel(res);
+            }
+            else if (path === "/log/level" && method === "PUT") {
+                await handleSetLogLevel(req, res);
+            }
+            else if (path === "/proxy/debug" && method === "GET") {
+                handleGetProxyDebug(res);
+            }
+            else if (path === "/proxy/debug" && method === "PUT") {
+                await handleSetProxyDebug(req, res);
+            }
+            else if (path === "/inspector" && method === "GET") {
+                handleGetInspector(res);
+            }
+            else if (path === "/inspector/open" && method === "POST") {
+                await handleOpenInspector(req, res);
+            }
+            else if (path === "/inspector/close" && method === "POST") {
+                handleCloseInspector(res);
+            }
+            else if (path === "/reload" && method === "POST") {
+                handleReload(res);
+            }
+            else {
+                sendJson(res, 404, {
+                    error: "Not found",
+                    availableEndpoints: [
+                        "GET  /health",
+                        "GET  /status",
+                        "GET  /log/level",
+                        "PUT  /log/level",
+                        "GET  /proxy/debug",
+                        "PUT  /proxy/debug",
+                        "GET  /inspector",
+                        "POST /inspector/open",
+                        "POST /inspector/close",
+                        "POST /reload",
+                    ],
+                });
+            }
+        }
+        catch (err) {
+            sendJson(res, 500, {
+                error: "Internal error",
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    server.listen(port, () => {
+        console.log(`[Maintenance] Server running at http://localhost:${port}`);
+    });
+    // Handle errors gracefully
+    server.on("error", (err) => {
+        console.error("[Maintenance] Server error:", err.message);
+    });
+    return {
+        server,
+        stop: () => {
+            server.close();
+        },
+    };
+}
+/** Send JSON response */
+function sendJson(res, status, data) {
+    res.writeHead(status, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(data, null, 2));
+}
+/** Read JSON body from request */
+async function readJsonBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => {
+            try {
+                const body = Buffer.concat(chunks).toString();
+                resolve(body ? JSON.parse(body) : {});
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+        req.on("error", reject);
+    });
+}
+/** GET /health */
+function handleHealth(res) {
+    sendJson(res, 200, {
+        status: "ok",
+        timestamp: new Date().toISOString(),
+    });
+}
+/** GET /status */
+function handleStatus(res, startTime, mainServerPort) {
+    const memUsage = process.memoryUsage();
+    sendJson(res, 200, {
+        uptime: {
+            seconds: Math.floor((Date.now() - startTime) / 1000),
+            human: formatUptime(Date.now() - startTime),
+        },
+        memory: {
+            rss: formatBytes(memUsage.rss),
+            heapUsed: formatBytes(memUsage.heapUsed),
+            heapTotal: formatBytes(memUsage.heapTotal),
+            external: formatBytes(memUsage.external),
+            raw: memUsage,
+        },
+        connections: connectionStats,
+        mainServerPort,
+        nodeVersion: process.version,
+        platform: process.platform,
+        pid: process.pid,
+        timestamp: new Date().toISOString(),
+    });
+}
+/** GET /log/level */
+function handleGetLogLevel(res) {
+    const levels = getLogLevels();
+    sendJson(res, 200, {
+        console: levels.console,
+        file: levels.file,
+        availableLevels: LOG_LEVELS,
+    });
+}
+/** PUT /log/level */
+async function handleSetLogLevel(req, res) {
+    try {
+        const body = (await readJsonBody(req));
+        const consoleLevel = body.console;
+        const fileLevel = body.file;
+        // Validate
+        if (consoleLevel && !LOG_LEVELS.includes(consoleLevel)) {
+            sendJson(res, 400, {
+                error: "Invalid console log level",
+                provided: consoleLevel,
+                availableLevels: LOG_LEVELS,
+            });
+            return;
+        }
+        if (fileLevel && !LOG_LEVELS.includes(fileLevel)) {
+            sendJson(res, 400, {
+                error: "Invalid file log level",
+                provided: fileLevel,
+                availableLevels: LOG_LEVELS,
+            });
+            return;
+        }
+        if (!consoleLevel && !fileLevel) {
+            sendJson(res, 400, {
+                error: "No log level provided",
+                hint: 'Provide { "console": "level" } and/or { "file": "level" }',
+                availableLevels: LOG_LEVELS,
+            });
+            return;
+        }
+        const previousLevels = getLogLevels();
+        setLogLevels({
+            console: consoleLevel,
+            file: fileLevel,
+        });
+        const newLevels = getLogLevels();
+        console.log(`[Maintenance] Log levels changed: console=${newLevels.console}, file=${newLevels.file}`);
+        sendJson(res, 200, {
+            console: newLevels.console,
+            file: newLevels.file,
+            previous: previousLevels,
+            message: "Log levels updated",
+        });
+    }
+    catch (err) {
+        sendJson(res, 400, {
+            error: "Invalid JSON body",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+/** GET /proxy/debug */
+function handleGetProxyDebug(res) {
+    sendJson(res, 200, {
+        enabled: proxyDebugEnabled,
+        hint: 'PUT { "enabled": true } to enable proxy debug logging',
+    });
+}
+/** PUT /proxy/debug */
+async function handleSetProxyDebug(req, res) {
+    try {
+        const body = (await readJsonBody(req));
+        if (typeof body.enabled !== "boolean") {
+            sendJson(res, 400, {
+                error: "Invalid body",
+                hint: 'Provide { "enabled": true } or { "enabled": false }',
+            });
+            return;
+        }
+        const previous = proxyDebugEnabled;
+        proxyDebugEnabled = body.enabled;
+        console.log(`[Maintenance] PROXY_DEBUG changed: ${previous} -> ${proxyDebugEnabled}`);
+        sendJson(res, 200, {
+            enabled: proxyDebugEnabled,
+            previous,
+            message: `Proxy debug logging ${proxyDebugEnabled ? "enabled" : "disabled"}`,
+        });
+    }
+    catch (err) {
+        sendJson(res, 400, {
+            error: "Invalid JSON body",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+/** POST /reload */
+function handleReload(res) {
+    console.log("[Maintenance] Reload requested, exiting...");
+    sendJson(res, 200, {
+        message: "Server restarting...",
+        timestamp: new Date().toISOString(),
+    });
+    // Exit after response is sent
+    setTimeout(() => {
+        process.exit(0);
+    }, 100);
+}
+/** Format bytes to human readable */
+function formatBytes(bytes) {
+    const units = ["B", "KB", "MB", "GB"];
+    let i = 0;
+    let value = bytes;
+    while (value >= 1024 && i < units.length - 1) {
+        value /= 1024;
+        i++;
+    }
+    return `${value.toFixed(1)} ${units[i]}`;
+}
+/** Format uptime to human readable */
+function formatUptime(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0) {
+        return `${days}d ${hours % 24}h ${minutes % 60}m`;
+    }
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+/** GET /inspector - Get inspector status */
+function handleGetInspector(res) {
+    const url = inspector.url();
+    sendJson(res, 200, {
+        enabled: url !== undefined,
+        url: url || null,
+        hint: url
+            ? `Open chrome://inspect in Chrome and click "inspect" on the remote target, or open ${url} directly`
+            : 'POST to /inspector/open to enable (optionally with { "port": 9229 })',
+    });
+}
+/** POST /inspector/open - Enable Chrome DevTools inspector */
+async function handleOpenInspector(req, res) {
+    try {
+        // Check if already open
+        const existingUrl = inspector.url();
+        if (existingUrl) {
+            sendJson(res, 200, {
+                message: "Inspector already open",
+                url: existingUrl,
+                hint: `Open chrome://inspect in Chrome, or open ${existingUrl} directly`,
+            });
+            return;
+        }
+        const body = (await readJsonBody(req));
+        const port = body.port || 9229;
+        const host = body.host || "127.0.0.1";
+        // Open the inspector
+        inspector.open(port, host, false);
+        // Wait a moment for it to start
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        const url = inspector.url();
+        console.log(`[Maintenance] Inspector opened at ${url}`);
+        sendJson(res, 200, {
+            message: "Inspector opened",
+            url,
+            port,
+            host,
+            hint: `Open chrome://inspect in Chrome and click "inspect", or open ${url} directly`,
+            warning: "Inspector exposes full process access. Only enable on trusted networks.",
+        });
+    }
+    catch (err) {
+        sendJson(res, 500, {
+            error: "Failed to open inspector",
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+/** POST /inspector/close - Disable Chrome DevTools inspector */
+function handleCloseInspector(res) {
+    const url = inspector.url();
+    if (!url) {
+        sendJson(res, 200, {
+            message: "Inspector was not open",
+        });
+        return;
+    }
+    inspector.close();
+    console.log("[Maintenance] Inspector closed");
+    sendJson(res, 200, {
+        message: "Inspector closed",
+        previousUrl: url,
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/maintenance/server.js.map

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

package/dist/metadata/SessionMetadataService.d.ts

@@ -0,0 +1,96 @@
+/**
+ * SessionMetadataService manages custom session metadata (titles, archive status).
+ * This enables renaming sessions and archiving them to hide from default view.
+ *
+ * State is persisted to a JSON file for durability across server restarts.
+ */
+import type { ProviderName } from "@yep-anywhere/shared";
+export interface SessionMetadata {
+    /** Custom title that overrides auto-generated title */
+    customTitle?: string;
+    /** Whether the session is archived (hidden from default list) */
+    isArchived?: boolean;
+    /** Whether the session is starred/favorited */
+    isStarred?: boolean;
+    /** Model used for this session (resolved, not "default") */
+    model?: string;
+    /** Provider used for this session (for backward compatibility with sessions that don't have provider in JSONL) */
+    provider?: ProviderName;
+}
+export interface SessionMetadataState {
+    /** Map of sessionId -> metadata */
+    sessions: Record<string, SessionMetadata>;
+    /** Schema version for future migrations */
+    version: number;
+}
+export interface SessionMetadataServiceOptions {
+    /** Directory to store metadata state (defaults to ~/.yep-anywhere) */
+    dataDir?: string;
+}
+export declare class SessionMetadataService {
+    private state;
+    private dataDir;
+    private filePath;
+    private savePromise;
+    private pendingSave;
+    constructor(options?: SessionMetadataServiceOptions);
+    /**
+     * Initialize the service by loading state from disk.
+     * Creates the data directory and file if they don't exist.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get metadata for a session.
+     */
+    getMetadata(sessionId: string): SessionMetadata | undefined;
+    /**
+     * Get all session metadata.
+     */
+    getAllMetadata(): Record<string, SessionMetadata>;
+    /**
+     * Set the custom title for a session.
+     * Pass undefined or empty string to clear the custom title.
+     */
+    setTitle(sessionId: string, title: string | undefined): Promise<void>;
+    /**
+     * Set the archived status for a session.
+     */
+    setArchived(sessionId: string, archived: boolean): Promise<void>;
+    /**
+     * Set the starred status for a session.
+     */
+    setStarred(sessionId: string, starred: boolean): Promise<void>;
+    /**
+     * Set the provider for a session.
+     * This stores the provider name for backward compatibility with sessions
+     * that don't have provider information in their JSONL files.
+     */
+    setProvider(sessionId: string, provider: ProviderName | undefined): Promise<void>;
+    /**
+     * Update metadata for a session (title, archived, starred).
+     */
+    updateMetadata(sessionId: string, updates: {
+        title?: string;
+        archived?: boolean;
+        starred?: boolean;
+    }): Promise<void>;
+    /**
+     * Helper to update session metadata and clean up empty entries.
+     */
+    private updateSessionMetadata;
+    /**
+     * Clear all metadata for a session.
+     * Useful when a session is deleted.
+     */
+    clearSession(sessionId: string): Promise<void>;
+    /**
+     * Save state to disk with debouncing to prevent excessive writes.
+     */
+    private save;
+    private doSave;
+    /**
+     * Get the file path for testing purposes.
+     */
+    getFilePath(): string;
+}
+//# sourceMappingURL=SessionMetadataService.d.ts.map

package/dist/metadata/SessionMetadataService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionMetadataService.d.ts","sourceRoot":"","sources":["../../src/metadata/SessionMetadataService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kHAAkH;IAClH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,6BAA6B;IAC5C,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,6BAAkC;IAWvD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCjC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI3D;;OAEG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAIjD;;;OAGG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3E;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtE;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpE;;;;OAIG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,YAAY,GAAG,SAAS,GACjC,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACjE,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;YACW,IAAI;YAkBJ,MAAM;IAUpB;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB"}