yepanywhere 0.1.0

package/dist/highlighting/index.js

@@ -0,0 +1,224 @@
+/**
+ * Shiki-based syntax highlighting service.
+ *
+ * Uses CSS variables for theming so client can switch light/dark without
+ * re-rendering. Pre-loads common languages for fast highlighting.
+ */
+import { bundledLanguages, createHighlighter, } from "shiki";
+import { createCssVariablesTheme } from "shiki/core";
+/** Maximum lines to highlight (avoid blocking on huge files) */
+const MAX_LINES = 2000;
+/** Languages to pre-load on startup */
+const PRELOADED_LANGUAGES = [
+    "javascript",
+    "typescript",
+    "tsx",
+    "jsx",
+    "python",
+    "bash",
+    "shell",
+    "json",
+    "css",
+    "html",
+    "yaml",
+    "sql",
+    "go",
+    "rust",
+    "java",
+    "c",
+    "cpp",
+    "markdown",
+    "diff",
+];
+/** CSS variables theme - outputs `style="color: var(--shiki-...)"` */
+const cssVarsTheme = createCssVariablesTheme({
+    name: "css-variables",
+    variablePrefix: "--shiki-",
+    fontStyle: true,
+});
+/** Extension to Shiki language mapping */
+const EXTENSION_TO_LANG = {
+    ts: "typescript",
+    tsx: "tsx",
+    js: "javascript",
+    jsx: "jsx",
+    mjs: "javascript",
+    cjs: "javascript",
+    py: "python",
+    rb: "ruby",
+    go: "go",
+    rs: "rust",
+    java: "java",
+    kt: "kotlin",
+    scala: "scala",
+    c: "c",
+    h: "c",
+    cpp: "cpp",
+    hpp: "cpp",
+    cc: "cpp",
+    cs: "csharp",
+    swift: "swift",
+    m: "objective-c",
+    mm: "objective-c",
+    php: "php",
+    pl: "perl",
+    pm: "perl",
+    lua: "lua",
+    r: "r",
+    sql: "sql",
+    graphql: "graphql",
+    gql: "graphql",
+    vue: "vue",
+    svelte: "svelte",
+    astro: "astro",
+    elm: "elm",
+    ex: "elixir",
+    exs: "elixir",
+    erl: "erlang",
+    hrl: "erlang",
+    hs: "haskell",
+    clj: "clojure",
+    cljs: "clojure",
+    cljc: "clojure",
+    ml: "ocaml",
+    mli: "ocaml",
+    fs: "fsharp",
+    fsx: "fsharp",
+    dart: "dart",
+    nim: "nim",
+    zig: "zig",
+    sol: "solidity",
+    proto: "protobuf",
+    prisma: "prisma",
+    dockerfile: "dockerfile",
+    makefile: "makefile",
+    cmake: "cmake",
+    gradle: "groovy",
+    sh: "bash",
+    bash: "bash",
+    zsh: "bash",
+    fish: "fish",
+    ps1: "powershell",
+    json: "json",
+    jsonc: "jsonc",
+    yaml: "yaml",
+    yml: "yaml",
+    toml: "toml",
+    xml: "xml",
+    html: "html",
+    htm: "html",
+    css: "css",
+    scss: "scss",
+    sass: "sass",
+    less: "less",
+    md: "markdown",
+    markdown: "markdown",
+    diff: "diff",
+    patch: "diff",
+};
+let highlighterPromise = null;
+let loadedLanguages = new Set();
+/**
+ * Get or create the singleton highlighter instance.
+ */
+async function getHighlighter() {
+    if (!highlighterPromise) {
+        highlighterPromise = createHighlighter({
+            themes: [cssVarsTheme],
+            langs: PRELOADED_LANGUAGES,
+        }).then((h) => {
+            loadedLanguages = new Set(PRELOADED_LANGUAGES);
+            return h;
+        });
+    }
+    return highlighterPromise;
+}
+/**
+ * Get the Shiki language for a file path based on extension.
+ * Returns null if the extension is unknown.
+ */
+export function getLanguageForPath(filePath) {
+    const ext = filePath.split(".").pop()?.toLowerCase();
+    if (!ext)
+        return null;
+    const lang = EXTENSION_TO_LANG[ext];
+    if (lang && lang in bundledLanguages) {
+        return lang;
+    }
+    return null;
+}
+/**
+ * Highlight code with syntax highlighting.
+ *
+ * @param code - The code to highlight
+ * @param language - The language (Shiki language id or file extension)
+ * @returns Highlighted HTML or null if language is unsupported
+ */
+export async function highlightCode(code, language) {
+    const highlighter = await getHighlighter();
+    // Resolve language from extension if needed
+    let lang = null;
+    if (language in bundledLanguages) {
+        lang = language;
+    }
+    else {
+        lang = EXTENSION_TO_LANG[language.toLowerCase()] ?? null;
+    }
+    if (!lang) {
+        return null;
+    }
+    // Load language if not already loaded
+    if (!loadedLanguages.has(lang)) {
+        try {
+            await highlighter.loadLanguage(lang);
+            loadedLanguages.add(lang);
+        }
+        catch {
+            return null;
+        }
+    }
+    // Check line count and truncate if needed
+    const lines = code.split("\n");
+    const truncated = lines.length > MAX_LINES;
+    const codeToHighlight = truncated
+        ? lines.slice(0, MAX_LINES).join("\n")
+        : code;
+    try {
+        const html = highlighter.codeToHtml(codeToHighlight, {
+            lang,
+            theme: "css-variables",
+        });
+        return {
+            html,
+            language: lang,
+            lineCount: lines.length,
+            truncated,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Highlight a file's content.
+ *
+ * @param content - File content
+ * @param filePath - File path (used to determine language)
+ * @returns Highlighted HTML or null if language is unsupported
+ */
+export async function highlightFile(content, filePath) {
+    const lang = getLanguageForPath(filePath);
+    if (!lang) {
+        return null;
+    }
+    return highlightCode(content, lang);
+}
+/**
+ * @internal
+ * Exported for testing purposes only. Do not use in production code.
+ */
+export const __test__ = {
+    MAX_LINES,
+    EXTENSION_TO_LANG,
+};
+//# sourceMappingURL=index.js.map

package/dist/highlighting/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,259 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { serve } from "@hono/node-server";
+import { RESPONSE_ALREADY_SENT } from "@hono/node-server/utils/response";
+import { createNodeWebSocket } from "@hono/node-ws";
+import { createApp } from "./app.js";
+import { AuthService } from "./auth/AuthService.js";
+import { loadConfig } from "./config.js";
+import { attachUnifiedUpgradeHandler, createFrontendProxy, createStaticRoutes, } from "./frontend/index.js";
+import { SessionIndexService } from "./indexes/index.js";
+import { getLogFilePath, initLogger, interceptConsole, } from "./logging/index.js";
+import { setDebugContext, startMaintenanceServer, } from "./maintenance/index.js";
+import { SessionMetadataService } from "./metadata/index.js";
+import { NotificationService } from "./notifications/index.js";
+import { ProjectScanner } from "./projects/scanner.js";
+import { PushService, loadVapidKeys } from "./push/index.js";
+import { RecentsService } from "./recents/index.js";
+import { createUploadRoutes } from "./routes/upload.js";
+import { detectClaudeCli } from "./sdk/cli-detection.js";
+import { initMessageLogger } from "./sdk/messageLogger.js";
+import { RealClaudeSDK } from "./sdk/real.js";
+import { ClaudeSessionReader } from "./sessions/reader.js";
+import { EventBus, FileWatcher, SourceWatcher } from "./watcher/index.js";
+// Allow many concurrent Claude sessions without listener warnings.
+// Each SDK session registers an exit handler; default limit is 10.
+process.setMaxListeners(50);
+const config = loadConfig();
+// Initialize logging early to capture all output
+initLogger({
+    logDir: config.logDir,
+    logFile: config.logFile,
+    consoleLevel: config.logLevel,
+    fileLevel: config.logFileLevel,
+    logToFile: config.logToFile,
+    logToConsole: config.logToConsole,
+    prettyPrint: process.env.NODE_ENV !== "production",
+});
+interceptConsole();
+// Initialize SDK message logger (if LOG_SDK_MESSAGES=true)
+initMessageLogger();
+// Log configuration for discoverability
+console.log(`[Config] Data dir: ${config.dataDir}`);
+console.log(`[Config] Log file: ${getLogFilePath({ logDir: config.logDir, logFile: config.logFile })}`);
+// Check for Claude CLI (optional - warn if not found)
+const cliInfo = detectClaudeCli();
+if (cliInfo.found) {
+    console.log(`Claude CLI found: ${cliInfo.path} (${cliInfo.version})`);
+}
+else {
+    console.warn("Warning: Claude CLI not found.");
+    console.warn("Claude Code sessions will not be available.");
+    console.warn("Install: curl -fsSL https://claude.ai/install.sh | bash");
+}
+// Create the real SDK
+const realSdk = new RealClaudeSDK();
+// Create EventBus and FileWatchers for all provider directories
+const eventBus = new EventBus();
+const fileWatchers = [];
+// Helper to create watcher if directory exists
+function createWatcherIfExists(watchDir, provider) {
+    if (fs.existsSync(watchDir)) {
+        const watcher = new FileWatcher({
+            watchDir,
+            provider,
+            eventBus,
+            debounceMs: 200,
+        });
+        watcher.start();
+        fileWatchers.push(watcher);
+    }
+    else {
+        console.log(`[FileWatcher] Skipping ${provider} (${watchDir} not found)`);
+    }
+}
+// Create watchers for session directories only (not full provider dirs)
+// This reduces inotify pressure and memory usage
+createWatcherIfExists(config.claudeSessionsDir, "claude");
+createWatcherIfExists(config.geminiSessionsDir, "gemini");
+createWatcherIfExists(config.codexSessionsDir, "codex");
+// When running without tsx watch (NO_BACKEND_RELOAD=true), start source watcher
+// to notify the UI when server code changes and needs manual reload
+if (process.env.NO_BACKEND_RELOAD === "true") {
+    const sourceWatcher = new SourceWatcher({ eventBus });
+    sourceWatcher.start();
+}
+// Create and initialize services (all use config.dataDir for state)
+const notificationService = new NotificationService({
+    eventBus,
+    dataDir: config.dataDir,
+});
+const sessionMetadataService = new SessionMetadataService({
+    dataDir: config.dataDir,
+});
+const sessionIndexService = new SessionIndexService({
+    projectsDir: config.claudeProjectsDir,
+    dataDir: path.join(config.dataDir, "indexes"),
+});
+const pushService = new PushService({ dataDir: config.dataDir });
+const recentsService = new RecentsService({ dataDir: config.dataDir });
+const authService = new AuthService({
+    dataDir: config.dataDir,
+    sessionTtlMs: config.authSessionTtlMs,
+    cookieSecret: config.authCookieSecret,
+});
+async function startServer() {
+    // Initialize services (loads state from disk)
+    await notificationService.initialize();
+    await sessionMetadataService.initialize();
+    await sessionIndexService.initialize();
+    await pushService.initialize();
+    await recentsService.initialize();
+    await authService.initialize();
+    // Log auth status
+    if (config.authEnabled) {
+        if (authService.hasAccount()) {
+            console.log("[Auth] Cookie auth enabled (account configured)");
+        }
+        else {
+            console.log("[Auth] Cookie auth enabled (setup required - visit /settings)");
+        }
+    }
+    else {
+        console.log("[Auth] Cookie auth disabled (AUTH_ENABLED=false)");
+    }
+    // Load VAPID keys if available (run 'pnpm setup-vapid' to generate)
+    const vapidKeys = await loadVapidKeys();
+    if (vapidKeys) {
+        pushService.setVapidKeys(vapidKeys);
+        console.log("[Push] VAPID keys loaded, push notifications enabled");
+    }
+    else {
+        console.log("[Push] VAPID keys not found. Run 'pnpm setup-vapid' to enable push notifications.");
+    }
+    // Determine if we're in production mode (no Vite dev server)
+    const isProduction = process.env.NODE_ENV === "production";
+    const isDev = !isProduction;
+    // Frontend serving setup - create proxy before app so it can be passed in
+    let frontendProxy;
+    if (config.serveFrontend && isDev) {
+        // Development: proxy to Vite dev server
+        frontendProxy = createFrontendProxy({ vitePort: config.vitePort });
+        console.log(`[Frontend] Proxying to Vite at http://localhost:${config.vitePort}`);
+    }
+    // Create the app first (without WebSocket support initially)
+    // We'll add WebSocket routes after setting up WebSocket support
+    const { app, supervisor, scanner } = createApp({
+        realSdk,
+        projectsDir: config.claudeProjectsDir,
+        idleTimeoutMs: config.idleTimeoutMs,
+        defaultPermissionMode: config.defaultPermissionMode,
+        eventBus,
+        // Note: uploadeWebSocket not passed yet - will be added below
+        notificationService,
+        sessionMetadataService,
+        sessionIndexService,
+        maxWorkers: config.maxWorkers,
+        idlePreemptThresholdMs: config.idlePreemptThresholdMs,
+        pushService,
+        recentsService,
+        authService,
+        authEnabled: config.authEnabled,
+        // Note: frontendProxy not passed - will be added below
+    });
+    // Set up debug context for maintenance server
+    setDebugContext({
+        supervisor,
+        claudeSessionsDir: config.claudeSessionsDir,
+        getSessionReader: async (projectPath) => {
+            // Find the project by scanning - projectPath is the absolute path
+            const projects = await scanner.listProjects();
+            const project = projects.find((p) => p.path === projectPath);
+            if (!project || project.provider !== "claude")
+                return null;
+            return new ClaudeSessionReader({ sessionDir: project.sessionDir });
+        },
+    });
+    // Create WebSocket support with the main app
+    // This must use the same app instance that has the routes
+    // We get wss for the unified upgrade handler (instead of using injectWebSocket)
+    const { wss, upgradeWebSocket } = createNodeWebSocket({ app });
+    // Add upload routes with WebSocket support
+    // These must be added BEFORE the frontend proxy catch-all
+    const uploadScanner = new ProjectScanner({
+        projectsDir: config.claudeProjectsDir,
+    });
+    const uploadRoutes = createUploadRoutes({
+        scanner: uploadScanner,
+        upgradeWebSocket,
+        maxUploadSizeBytes: config.maxUploadSizeBytes,
+    });
+    app.route("/api", uploadRoutes);
+    // Serve stable (emergency) UI from /_stable/ path if available
+    // This bypasses HMR and serves pre-built assets directly
+    if (config.serveFrontend && fs.existsSync(config.stableDistPath)) {
+        const stableRoutes = createStaticRoutes({
+            distPath: config.stableDistPath,
+            basePath: "/_stable",
+        });
+        app.route("/_stable", stableRoutes);
+        console.log(`[Frontend] Stable UI available at /_stable/ from ${config.stableDistPath}`);
+    }
+    // Add frontend proxy as the final catch-all (AFTER all API routes including uploads)
+    if (frontendProxy) {
+        const proxy = frontendProxy;
+        app.all("*", (c) => {
+            const { incoming, outgoing } = c.env;
+            proxy.web(incoming, outgoing);
+            return RESPONSE_ALREADY_SENT;
+        });
+    }
+    // Production: serve static files (must be added after API routes)
+    if (config.serveFrontend && isProduction) {
+        const distExists = fs.existsSync(config.clientDistPath);
+        if (distExists) {
+            const staticRoutes = createStaticRoutes({
+                distPath: config.clientDistPath,
+            });
+            app.route("/", staticRoutes);
+            console.log(`[Frontend] Serving static files from ${config.clientDistPath}`);
+        }
+        else {
+            console.warn(`[Frontend] Warning: dist not found at ${config.clientDistPath}. Run 'pnpm build' first.`);
+        }
+    }
+    const server = serve({ fetch: app.fetch, port: config.port }, (info) => {
+        console.log(`Server running at http://localhost:${info.port}`);
+        console.log(`Projects dir: ${config.claudeProjectsDir}`);
+        console.log(`Permission mode: ${config.defaultPermissionMode}`);
+        // Notify all connected clients that the backend has restarted
+        // This allows other tabs to clear their "reload needed" banner
+        eventBus.emit({
+            type: "backend-reloaded",
+            timestamp: new Date().toISOString(),
+        });
+    });
+    // Attach unified WebSocket upgrade handler
+    // This replaces both attachFrontendProxyUpgrade and injectWebSocket to avoid
+    // conflicts where both would try to handle the same upgrade request
+    attachUnifiedUpgradeHandler(server, {
+        frontendProxy,
+        isApiPath: (urlPath) => urlPath.startsWith("/api"),
+        app,
+        wss,
+    });
+    // Start maintenance server on separate port (for out-of-band diagnostics)
+    // This runs independently from the main server and can be used to debug
+    // issues even when the main server is unresponsive
+    if (config.maintenancePort > 0) {
+        startMaintenanceServer({
+            port: config.maintenancePort,
+            mainServerPort: config.port,
+        });
+    }
+}
+startServer().catch((error) => {
+    console.error("Failed to start server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,cAAc,EACd,UAAU,EACV,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE1E,mEAAmE;AACnE,mEAAmE;AACnE,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AAE5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAE5B,iDAAiD;AACjD,UAAU,CAAC;IACT,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC,OAAO;IACvB,YAAY,EAAE,MAAM,CAAC,QAAQ;IAC7B,SAAS,EAAE,MAAM,CAAC,YAAY;IAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;IACjC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;CACnD,CAAC,CAAC;AACH,gBAAgB,EAAE,CAAC;AAEnB,2DAA2D;AAC3D,iBAAiB,EAAE,CAAC;AAEpB,wCAAwC;AACxC,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AACpD,OAAO,CAAC,GAAG,CACT,sBAAsB,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAC3F,CAAC;AAEF,sDAAsD;AACtD,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;AAClC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;AACxE,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;AAC1E,CAAC;AAED,sBAAsB;AACtB,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;AAEpC,gEAAgE;AAChE,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;AAChC,MAAM,YAAY,GAAkB,EAAE,CAAC;AAEvC,+CAA+C;AAC/C,SAAS,qBAAqB,CAC5B,QAAgB,EAChB,QAAuC;IAEvC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC9B,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,0BAA0B,QAAQ,KAAK,QAAQ,aAAa,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,iDAAiD;AACjD,qBAAqB,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAC1D,qBAAqB,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAC1D,qBAAqB,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAExD,gFAAgF;AAChF,oEAAoE;AACpE,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;IAC7C,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC;AAED,oEAAoE;AACpE,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,CAAC;IAClD,QAAQ;IACR,OAAO,EAAE,MAAM,CAAC,OAAO;CACxB,CAAC,CAAC;AACH,MAAM,sBAAsB,GAAG,IAAI,sBAAsB,CAAC;IACxD,OAAO,EAAE,MAAM,CAAC,OAAO;CACxB,CAAC,CAAC;AACH,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC,iBAAiB;IACrC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC;CAC9C,CAAC,CAAC;AACH,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AACjE,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AACvE,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,OAAO;IACvB,YAAY,EAAE,MAAM,CAAC,gBAAgB;IACrC,YAAY,EAAE,MAAM,CAAC,gBAAgB;CACtC,CAAC,CAAC;AAEH,KAAK,UAAU,WAAW;IACxB,8CAA8C;IAC9C,MAAM,mBAAmB,CAAC,UAAU,EAAE,CAAC;IACvC,MAAM,sBAAsB,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,mBAAmB,CAAC,UAAU,EAAE,CAAC;IACvC,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;IAC/B,MAAM,cAAc,CAAC,UAAU,EAAE,CAAC;IAClC,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;IAE/B,kBAAkB;IAClB,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CACT,+DAA+D,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;IAED,oEAAoE;IACpE,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;IACxC,IAAI,SAAS,EAAE,CAAC;QACd,WAAW,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CACT,mFAAmF,CACpF,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC3D,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC;IAE5B,0EAA0E;IAC1E,IAAI,aAAiE,CAAC;IAEtE,IAAI,MAAM,CAAC,aAAa,IAAI,KAAK,EAAE,CAAC;QAClC,wCAAwC;QACxC,aAAa,GAAG,mBAAmB,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CACT,mDAAmD,MAAM,CAAC,QAAQ,EAAE,CACrE,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,gEAAgE;IAChE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;QAC7C,OAAO;QACP,WAAW,EAAE,MAAM,CAAC,iBAAiB;QACrC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;QACnD,QAAQ;QACR,8DAA8D;QAC9D,mBAAmB;QACnB,sBAAsB;QACtB,mBAAmB;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;QACrD,WAAW;QACX,cAAc;QACd,WAAW;QACX,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,uDAAuD;KACxD,CAAC,CAAC;IAEH,8CAA8C;IAC9C,eAAe,CAAC;QACd,UAAU;QACV,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,gBAAgB,EAAE,KAAK,EAAE,WAAmB,EAAE,EAAE;YAC9C,kEAAkE;YAClE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;YAC7D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC3D,OAAO,IAAI,mBAAmB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,CAAC;KACF,CAAC,CAAC;IAEH,6CAA6C;IAC7C,0DAA0D;IAC1D,gFAAgF;IAChF,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAE/D,2CAA2C;IAC3C,0DAA0D;IAC1D,MAAM,aAAa,GAAG,IAAI,cAAc,CAAC;QACvC,WAAW,EAAE,MAAM,CAAC,iBAAiB;KACtC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,kBAAkB,CAAC;QACtC,OAAO,EAAE,aAAa;QACtB,gBAAgB;QAChB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;KAC9C,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEhC,+DAA+D;IAC/D,yDAAyD;IACzD,IAAI,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;QACjE,MAAM,YAAY,GAAG,kBAAkB,CAAC;YACtC,QAAQ,EAAE,MAAM,CAAC,cAAc;YAC/B,QAAQ,EAAE,UAAU;SACrB,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CACT,oDAAoD,MAAM,CAAC,cAAc,EAAE,CAC5E,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,aAAa,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;YACjB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC;YACrC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC9B,OAAO,qBAAqB,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kEAAkE;IAClE,IAAI,MAAM,CAAC,aAAa,IAAI,YAAY,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACxD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,kBAAkB,CAAC;gBACtC,QAAQ,EAAE,MAAM,CAAC,cAAc;aAChC,CAAC,CAAC;YACH,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAC7B,OAAO,CAAC,GAAG,CACT,wCAAwC,MAAM,CAAC,cAAc,EAAE,CAChE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CACV,yCAAyC,MAAM,CAAC,cAAc,2BAA2B,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;QACrE,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAEhE,8DAA8D;QAC9D,+DAA+D;QAC/D,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,6EAA6E;IAC7E,oEAAoE;IACpE,2BAA2B,CAAC,MAAM,EAAE;QAClC,aAAa;QACb,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAClD,GAAG;QACH,GAAG;KACJ,CAAC,CAAC;IAEH,0EAA0E;IAC1E,wEAAwE;IACxE,mDAAmD;IACnD,IAAI,MAAM,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAC/B,sBAAsB,CAAC;YACrB,IAAI,EAAE,MAAM,CAAC,eAAe;YAC5B,cAAc,EAAE,MAAM,CAAC,IAAI;SAC5B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/indexes/SessionIndexService.d.ts

@@ -0,0 +1,106 @@
+/**
+ * SessionIndexService caches session summaries to avoid re-parsing JSONL files.
+ * Uses mtime/size for cache invalidation - only re-parses when files change.
+ *
+ * State is persisted to JSON files for durability across server restarts.
+ * Each project's session directory gets its own index file.
+ */
+import { type ProviderName, type UrlProjectId } from "@yep-anywhere/shared";
+import type { ISessionReader } from "../sessions/types.js";
+import type { SessionSummary } from "../supervisor/types.js";
+import type { ISessionIndexService } from "./types.js";
+export interface CachedSessionSummary {
+    title: string | null;
+    fullTitle: string | null;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+    contextUsage?: {
+        inputTokens: number;
+        percentage: number;
+    };
+    /** File size in bytes at time of indexing */
+    indexedBytes: number;
+    /** File mtime in milliseconds since epoch at time of indexing */
+    fileMtime: number;
+    /** True if session has no user/assistant messages (metadata-only file) */
+    isEmpty?: boolean;
+    /** AI provider for this session */
+    provider: ProviderName;
+}
+export interface SessionIndexState {
+    version: 1;
+    projectId: string;
+    sessions: Record<string, CachedSessionSummary>;
+}
+export interface SessionIndexServiceOptions {
+    /** Directory to store index files (defaults to ~/.yep-anywhere/indexes) */
+    dataDir?: string;
+    /** Claude projects directory (defaults to ~/.claude/projects) */
+    projectsDir?: string;
+    /** Max number of projects to keep in memory cache (default: 100) */
+    maxCacheSize?: number;
+}
+/**
+ * Claude-specific session index service.
+ *
+ * Caches session summaries for Claude Code JSONL files to avoid
+ * re-parsing on every request. Currently works with Claude's
+ * ~/.claude/projects/ directory structure.
+ */
+export declare class SessionIndexService implements ISessionIndexService {
+    private dataDir;
+    private projectsDir;
+    private indexCache;
+    private savePromises;
+    private pendingSaves;
+    private maxCacheSize;
+    constructor(options?: SessionIndexServiceOptions);
+    /**
+     * Evict oldest entries if cache exceeds max size.
+     * Simple FIFO eviction since Map maintains insertion order.
+     */
+    private evictIfNeeded;
+    /**
+     * Initialize the service by ensuring the data directory exists.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the index file path for a session directory.
+     * Encodes the relative path from projectsDir with %2F for slashes.
+     */
+    getIndexPath(sessionDir: string): string;
+    /**
+     * Load index from disk or create a new one.
+     */
+    private loadIndex;
+    /**
+     * Save index to disk with debouncing to prevent excessive writes.
+     */
+    private saveIndex;
+    private doSaveIndex;
+    /**
+     * Get sessions using the cache, only re-parsing files that have changed.
+     * This is the main entry point for listing sessions with caching.
+     */
+    getSessionsWithCache(sessionDir: string, projectId: UrlProjectId, reader: ISessionReader): Promise<SessionSummary[]>;
+    /**
+     * Invalidate the cache for a specific session.
+     * Call this when you know a session file has been modified.
+     */
+    invalidateSession(sessionDir: string, sessionId: string): void;
+    /**
+     * Clear all cached data for a session directory.
+     */
+    clearCache(sessionDir: string): void;
+    /**
+     * Get the data directory for testing purposes.
+     */
+    getDataDir(): string;
+    /**
+     * Get just the title for a single session, using cache when possible.
+     * More efficient than getSessionsWithCache when you only need one session.
+     */
+    getSessionTitle(sessionDir: string, projectId: UrlProjectId, sessionId: string, reader: ISessionReader): Promise<string | null>;
+}
+//# sourceMappingURL=SessionIndexService.d.ts.map

package/dist/indexes/SessionIndexService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionIndexService.d.ts","sourceRoot":"","sources":["../../src/indexes/SessionIndexService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAChD;AAID,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,0BAA+B;IASpD;;;OAGG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAMxC;;OAEG;YACW,SAAS;IAiEvB;;OAEG;YACW,SAAS;YAyBT,WAAW;IAoBzB;;;OAGG;IACG,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC;IA8H5B;;;OAGG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAO9D;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;;OAGG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA4D1B"}