yepanywhere 0.1.0

package/dist/projects/gemini-scanner.js

@@ -0,0 +1,210 @@
+/**
+ * GeminiSessionScanner - Scans Gemini sessions and groups them by project.
+ *
+ * Gemini stores sessions at ~/.gemini/tmp/<projectHash>/chats/session-*.json
+ * where projectHash is a SHA-256 hash of the working directory.
+ *
+ * We use GeminiProjectMap to resolve project hashes to their original CWDs.
+ */
+import { readFile, readdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { parseGeminiSessionFile, } from "@yep-anywhere/shared";
+import { GEMINI_DIR, GEMINI_TMP_DIR, geminiProjectMap, hashProjectPath, } from "./gemini-project-map.js";
+import { encodeProjectId } from "./paths.js";
+// Re-export constants for compatibility
+export { GEMINI_DIR, GEMINI_TMP_DIR, hashProjectPath };
+export class GeminiSessionScanner {
+    sessionsDir;
+    constructor(options = {}) {
+        this.sessionsDir = options.sessionsDir ?? GEMINI_TMP_DIR;
+    }
+    /**
+     * Register known project paths for hash resolution.
+     * Call this with paths from Claude/Codex projects to enable cwd lookup.
+     */
+    async registerKnownPaths(paths) {
+        for (const path of paths) {
+            await geminiProjectMap.register(path);
+        }
+    }
+    /**
+     * Get the hash-to-cwd mapping for use by readers.
+     * Note: This is now async as it loads from disk.
+     */
+    async getHashToCwd() {
+        return geminiProjectMap.getAll();
+    }
+    /**
+     * Scan all Gemini sessions and group them by project (cwd or hash).
+     * Returns projects sorted by last activity (most recent first).
+     */
+    async listProjects() {
+        const sessions = await this.scanAllSessions();
+        await geminiProjectMap.load();
+        // Group sessions by cwd (if known) or projectHash
+        const projectMap = new Map();
+        for (const session of sessions) {
+            const cwd = await geminiProjectMap.get(session.projectHash);
+            const key = cwd ?? session.projectHash;
+            const existing = projectMap.get(key);
+            if (existing) {
+                existing.sessions.push(session);
+                if (session.mtime > existing.lastActivity) {
+                    existing.lastActivity = session.mtime;
+                }
+            }
+            else {
+                projectMap.set(key, {
+                    sessions: [session],
+                    lastActivity: session.mtime,
+                    cwd: cwd ?? null,
+                    projectHash: session.projectHash,
+                });
+            }
+        }
+        // Convert to Project[]
+        const projects = [];
+        for (const [key, data] of projectMap) {
+            const path = data.cwd ?? `gemini:${data.projectHash.slice(0, 8)}`;
+            const name = data.cwd
+                ? basename(data.cwd)
+                : `Gemini ${data.projectHash.slice(0, 8)}`;
+            projects.push({
+                id: encodeProjectId(path),
+                path,
+                name,
+                sessionCount: data.sessions.length,
+                sessionDir: join(this.sessionsDir, data.projectHash, "chats"),
+                activeOwnedCount: 0,
+                activeExternalCount: 0,
+                lastActivity: new Date(data.lastActivity).toISOString(),
+                provider: "gemini",
+            });
+        }
+        // Sort by last activity descending
+        projects.sort((a, b) => {
+            if (!a.lastActivity)
+                return 1;
+            if (!b.lastActivity)
+                return -1;
+            return (new Date(b.lastActivity).getTime() - new Date(a.lastActivity).getTime());
+        });
+        return projects;
+    }
+    /**
+     * Get sessions for a specific project (by cwd or projectHash).
+     */
+    async getSessionsForProject(projectPath) {
+        const sessions = await this.scanAllSessions();
+        await geminiProjectMap.load();
+        // Check if projectPath is a hash prefix (gemini:xxxxxxxx format)
+        if (projectPath.startsWith("gemini:")) {
+            const hashPrefix = projectPath.slice(7);
+            return sessions
+                .filter((s) => s.projectHash.startsWith(hashPrefix))
+                .sort((a, b) => b.mtime - a.mtime);
+        }
+        // Otherwise, hash the path and look for matching sessions
+        const targetHash = hashProjectPath(projectPath);
+        // Ensure we have this path registered
+        await geminiProjectMap.set(targetHash, projectPath);
+        return sessions
+            .filter((s) => s.projectHash === targetHash)
+            .sort((a, b) => b.mtime - a.mtime);
+    }
+    /**
+     * Scan all session files and extract metadata.
+     */
+    async scanAllSessions() {
+        const sessions = [];
+        try {
+            await stat(this.sessionsDir);
+        }
+        catch {
+            return [];
+        }
+        // Find all project hash directories
+        let projectHashDirs;
+        try {
+            const entries = await readdir(this.sessionsDir, { withFileTypes: true });
+            projectHashDirs = entries
+                .filter((e) => e.isDirectory())
+                .map((e) => e.name);
+        }
+        catch {
+            return [];
+        }
+        // Scan each project hash directory in parallel
+        const BATCH_SIZE = 20;
+        for (let i = 0; i < projectHashDirs.length; i += BATCH_SIZE) {
+            const batch = projectHashDirs.slice(i, i + BATCH_SIZE);
+            const results = await Promise.all(batch.map((hash) => this.scanProjectHash(hash)));
+            for (const result of results) {
+                sessions.push(...result);
+            }
+        }
+        return sessions;
+    }
+    /**
+     * Scan sessions for a specific project hash directory.
+     */
+    async scanProjectHash(projectHash) {
+        const sessions = [];
+        const chatsDir = join(this.sessionsDir, projectHash, "chats");
+        try {
+            await stat(chatsDir);
+        }
+        catch {
+            return [];
+        }
+        let files;
+        try {
+            const entries = await readdir(chatsDir, { withFileTypes: true });
+            files = entries
+                .filter((e) => e.isFile() &&
+                e.name.startsWith("session-") &&
+                e.name.endsWith(".json"))
+                .map((e) => e.name);
+        }
+        catch {
+            return [];
+        }
+        // Read session files in parallel
+        const results = await Promise.all(files.map((f) => this.readSessionMeta(join(chatsDir, f), projectHash)));
+        for (const result of results) {
+            if (result) {
+                sessions.push(result);
+            }
+        }
+        return sessions;
+    }
+    /**
+     * Read session metadata from a JSON file.
+     */
+    async readSessionMeta(filePath, projectHash) {
+        try {
+            const stats = await stat(filePath);
+            const content = await readFile(filePath, "utf-8");
+            const session = parseGeminiSessionFile(content);
+            if (!session)
+                return null;
+            // Note: Inference from tool calls is no longer needed here as we use the
+            // explicit project map. We could revive it as a fallback if needed,
+            // but simpler is better.
+            return {
+                id: session.sessionId,
+                projectHash,
+                filePath,
+                startTime: session.startTime,
+                mtime: stats.mtimeMs,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// Singleton for convenience
+export const geminiSessionScanner = new GeminiSessionScanner();
+//# sourceMappingURL=gemini-scanner.js.map

package/dist/projects/gemini-scanner.js.map

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

package/dist/projects/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Project management utilities
+ *
+ * This module provides tools for working with Claude's project and session
+ * storage in ~/.claude/projects/.
+ *
+ * Key exports:
+ * - Path encoding/decoding utilities (see paths.ts for detailed docs)
+ * - ProjectScanner for discovering projects
+ */
+export { CLAUDE_DIR, CLAUDE_PROJECTS_DIR, decodeProjectId, encodeProjectId, getFileTypeFromRelativePath, getProjectName, getSessionFilePath, getSessionIdFromPath, readCwdFromSessionFile, } from "./paths.js";
+export { ProjectScanner, projectScanner } from "./scanner.js";
+export type { ScannerOptions } from "./scanner.js";
+export { CODEX_DIR, CODEX_SESSIONS_DIR, CodexSessionScanner, codexSessionScanner, } from "./codex-scanner.js";
+export type { CodexScannerOptions } from "./codex-scanner.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/projects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projects/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,2BAA2B,EAC3B,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/projects/index.js

@@ -0,0 +1,17 @@
+/**
+ * Project management utilities
+ *
+ * This module provides tools for working with Claude's project and session
+ * storage in ~/.claude/projects/.
+ *
+ * Key exports:
+ * - Path encoding/decoding utilities (see paths.ts for detailed docs)
+ * - ProjectScanner for discovering projects
+ */
+// Path utilities - see paths.ts for comprehensive documentation on encoding schemes
+export { CLAUDE_DIR, CLAUDE_PROJECTS_DIR, decodeProjectId, encodeProjectId, getFileTypeFromRelativePath, getProjectName, getSessionFilePath, getSessionIdFromPath, readCwdFromSessionFile, } from "./paths.js";
+// Project scanning
+export { ProjectScanner, projectScanner } from "./scanner.js";
+// Codex session scanning
+export { CODEX_DIR, CODEX_SESSIONS_DIR, CodexSessionScanner, codexSessionScanner, } from "./codex-scanner.js";
+//# sourceMappingURL=index.js.map

package/dist/projects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/projects/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oFAAoF;AACpF,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,2BAA2B,EAC3B,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9D,yBAAyB;AACzB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/projects/paths.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Project Path Utilities
+ *
+ * This module handles the different path encoding schemes used in Claude's
+ * session storage. There are TWO different encodings to be aware of:
+ *
+ * ## 1. Project ID (used in URLs/API)
+ *
+ * The `projectId` is a **base64url** encoding of the absolute project path.
+ * Example: `/home/user/my-project` → `L2hvbWUvdXNlci9teS1wcm9qZWN0`
+ *
+ * This encoding is:
+ * - Reversible via `decodeProjectId()`
+ * - URL-safe (no special characters)
+ * - Used in API routes and client URLs
+ *
+ * ## 2. Directory Names (in ~/.claude/projects/)
+ *
+ * Session files are stored in directories with **slash-to-hyphen** encoding.
+ * Example: `/home/user/my-project` → `-home-user-my-project`
+ *
+ * The directory structure is:
+ * ```
+ * ~/.claude/projects/
+ *   ├── -home-user-project/              # Direct encoding (no hostname)
+ *   │   └── session-123.jsonl
+ *   └── hostname/                        # With hostname prefix
+ *       └── -home-user-project/
+ *           └── session-456.jsonl
+ * ```
+ *
+ * ## Why Two Encodings?
+ *
+ * The slash-to-hyphen encoding is **LOSSY** - you cannot reliably decode it
+ * back to the original path because hyphens in the original path create
+ * ambiguity:
+ *
+ * Directory: `-home-user-name-my-project`
+ * Could be:  `/home/user-name/my-project`
+ *       or:  `/home/user/name-my-project`
+ *       or:  `/home/user/name/my-project`
+ *
+ * ## The Solution: Read CWD from Session Files
+ *
+ * Instead of decoding directory names, we read the actual project path from
+ * the `cwd` field in session JSONL files. This is reliable because the Claude
+ * SDK writes the working directory to session files when they're created.
+ *
+ * See `ProjectScanner.getProjectPathFromSessions()` for the implementation.
+ *
+ * ## Best Practices
+ *
+ * 1. Always use `Project.path` for the absolute path - never try to decode
+ *    directory names.
+ * 2. Use `projectId` (base64url) for API calls and URLs.
+ * 3. Use `Project.sessionDir` to access the session files directory.
+ * 4. Use `getSessionFilePath()` to construct paths to specific session files.
+ */
+import type { UrlProjectId } from "@yep-anywhere/shared";
+/** The root directory where Claude stores project sessions */
+export declare const CLAUDE_DIR: string;
+export declare const CLAUDE_PROJECTS_DIR: string;
+/**
+ * Encode an absolute project path to a projectId (base64url).
+ * This is reversible via `decodeProjectId()`.
+ *
+ * @example
+ * encodeProjectId("/home/user/my-project")
+ * // => "L2hvbWUvdXNlci9teS1wcm9qZWN0"
+ */
+export declare function encodeProjectId(path: string): UrlProjectId;
+/**
+ * Decode a projectId back to an absolute project path.
+ *
+ * @example
+ * decodeProjectId("L2hvbWUvdXNlci9teS1wcm9qZWN0")
+ * // => "/home/user/my-project"
+ */
+export declare function decodeProjectId(id: UrlProjectId): string;
+/**
+ * Get the name (basename) of a project from its path.
+ *
+ * @example
+ * getProjectName("/home/user/my-project")
+ * // => "my-project"
+ */
+export declare function getProjectName(projectPath: string): string;
+/**
+ * Get the full path to a session file.
+ *
+ * @param sessionDir - The project's session directory (Project.sessionDir)
+ * @param sessionId - The session ID (filename without .jsonl)
+ *
+ * @example
+ * getSessionFilePath("/home/user/.claude/projects/-home-user-proj", "abc123")
+ * // => "/home/user/.claude/projects/-home-user-proj/abc123.jsonl"
+ */
+export declare function getSessionFilePath(sessionDir: string, sessionId: string): string;
+/**
+ * Extract the session ID from a file path.
+ * Works with both absolute paths and relative paths.
+ *
+ * @example
+ * getSessionIdFromPath("/path/to/projects/xxx/my-session.jsonl")
+ * // => "my-session"
+ *
+ * getSessionIdFromPath("projects/xxx/my-session.jsonl")
+ * // => "my-session"
+ */
+export declare function getSessionIdFromPath(filePath: string): string | null;
+/**
+ * Read the working directory (cwd) from a session file.
+ * This is the most reliable way to get the actual project path.
+ *
+ * The cwd is stored in the first few lines of the JSONL file by the Claude SDK.
+ *
+ * @param sessionFilePath - Absolute path to the session .jsonl file
+ * @returns The cwd field value, or null if not found
+ */
+export declare function readCwdFromSessionFile(sessionFilePath: string): Promise<string | null>;
+/**
+ * Determine the file type from a relative path within ~/.claude.
+ *
+ * @param relativePath - Path relative to ~/.claude (e.g., "projects/xxx/session.jsonl")
+ */
+export declare function getFileTypeFromRelativePath(relativePath: string): "session" | "agent-session" | "settings" | "credentials" | "telemetry" | "other";
+//# sourceMappingURL=paths.d.ts.map

package/dist/projects/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/projects/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,8DAA8D;AAC9D,eAAO,MAAM,UAAU,QAA6B,CAAC;AACrD,eAAO,MAAM,mBAAmB,QAA+B,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpE;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBxB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,GAElB,SAAS,GACT,eAAe,GACf,UAAU,GACV,aAAa,GACb,WAAW,GACX,OAAO,CA6BV"}

package/dist/projects/paths.js

@@ -0,0 +1,185 @@
+/**
+ * Project Path Utilities
+ *
+ * This module handles the different path encoding schemes used in Claude's
+ * session storage. There are TWO different encodings to be aware of:
+ *
+ * ## 1. Project ID (used in URLs/API)
+ *
+ * The `projectId` is a **base64url** encoding of the absolute project path.
+ * Example: `/home/user/my-project` → `L2hvbWUvdXNlci9teS1wcm9qZWN0`
+ *
+ * This encoding is:
+ * - Reversible via `decodeProjectId()`
+ * - URL-safe (no special characters)
+ * - Used in API routes and client URLs
+ *
+ * ## 2. Directory Names (in ~/.claude/projects/)
+ *
+ * Session files are stored in directories with **slash-to-hyphen** encoding.
+ * Example: `/home/user/my-project` → `-home-user-my-project`
+ *
+ * The directory structure is:
+ * ```
+ * ~/.claude/projects/
+ *   ├── -home-user-project/              # Direct encoding (no hostname)
+ *   │   └── session-123.jsonl
+ *   └── hostname/                        # With hostname prefix
+ *       └── -home-user-project/
+ *           └── session-456.jsonl
+ * ```
+ *
+ * ## Why Two Encodings?
+ *
+ * The slash-to-hyphen encoding is **LOSSY** - you cannot reliably decode it
+ * back to the original path because hyphens in the original path create
+ * ambiguity:
+ *
+ * Directory: `-home-user-name-my-project`
+ * Could be:  `/home/user-name/my-project`
+ *       or:  `/home/user/name-my-project`
+ *       or:  `/home/user/name/my-project`
+ *
+ * ## The Solution: Read CWD from Session Files
+ *
+ * Instead of decoding directory names, we read the actual project path from
+ * the `cwd` field in session JSONL files. This is reliable because the Claude
+ * SDK writes the working directory to session files when they're created.
+ *
+ * See `ProjectScanner.getProjectPathFromSessions()` for the implementation.
+ *
+ * ## Best Practices
+ *
+ * 1. Always use `Project.path` for the absolute path - never try to decode
+ *    directory names.
+ * 2. Use `projectId` (base64url) for API calls and URLs.
+ * 3. Use `Project.sessionDir` to access the session files directory.
+ * 4. Use `getSessionFilePath()` to construct paths to specific session files.
+ */
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+/** The root directory where Claude stores project sessions */
+export const CLAUDE_DIR = join(homedir(), ".claude");
+export const CLAUDE_PROJECTS_DIR = join(CLAUDE_DIR, "projects");
+/**
+ * Encode an absolute project path to a projectId (base64url).
+ * This is reversible via `decodeProjectId()`.
+ *
+ * @example
+ * encodeProjectId("/home/user/my-project")
+ * // => "L2hvbWUvdXNlci9teS1wcm9qZWN0"
+ */
+export function encodeProjectId(path) {
+    return Buffer.from(path).toString("base64url");
+}
+/**
+ * Decode a projectId back to an absolute project path.
+ *
+ * @example
+ * decodeProjectId("L2hvbWUvdXNlci9teS1wcm9qZWN0")
+ * // => "/home/user/my-project"
+ */
+export function decodeProjectId(id) {
+    return Buffer.from(id, "base64url").toString("utf-8");
+}
+/**
+ * Get the name (basename) of a project from its path.
+ *
+ * @example
+ * getProjectName("/home/user/my-project")
+ * // => "my-project"
+ */
+export function getProjectName(projectPath) {
+    return basename(projectPath);
+}
+/**
+ * Get the full path to a session file.
+ *
+ * @param sessionDir - The project's session directory (Project.sessionDir)
+ * @param sessionId - The session ID (filename without .jsonl)
+ *
+ * @example
+ * getSessionFilePath("/home/user/.claude/projects/-home-user-proj", "abc123")
+ * // => "/home/user/.claude/projects/-home-user-proj/abc123.jsonl"
+ */
+export function getSessionFilePath(sessionDir, sessionId) {
+    return join(sessionDir, `${sessionId}.jsonl`);
+}
+/**
+ * Extract the session ID from a file path.
+ * Works with both absolute paths and relative paths.
+ *
+ * @example
+ * getSessionIdFromPath("/path/to/projects/xxx/my-session.jsonl")
+ * // => "my-session"
+ *
+ * getSessionIdFromPath("projects/xxx/my-session.jsonl")
+ * // => "my-session"
+ */
+export function getSessionIdFromPath(filePath) {
+    const match = filePath.match(/([^/\\]+)\.jsonl$/);
+    return match?.[1] ?? null;
+}
+/**
+ * Read the working directory (cwd) from a session file.
+ * This is the most reliable way to get the actual project path.
+ *
+ * The cwd is stored in the first few lines of the JSONL file by the Claude SDK.
+ *
+ * @param sessionFilePath - Absolute path to the session .jsonl file
+ * @returns The cwd field value, or null if not found
+ */
+export async function readCwdFromSessionFile(sessionFilePath) {
+    try {
+        const content = await readFile(sessionFilePath, { encoding: "utf-8" });
+        const lines = content.split("\n").slice(0, 20); // Check first 20 lines
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const data = JSON.parse(line);
+                if (data.cwd && typeof data.cwd === "string") {
+                    return data.cwd;
+                }
+            }
+            catch {
+                // Skip invalid JSON lines
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Determine the file type from a relative path within ~/.claude.
+ *
+ * @param relativePath - Path relative to ~/.claude (e.g., "projects/xxx/session.jsonl")
+ */
+export function getFileTypeFromRelativePath(relativePath) {
+    // Session files: projects/<encoded-path>/<session-id>.jsonl
+    if (relativePath.includes("projects/") && relativePath.endsWith(".jsonl")) {
+        const filename = basename(relativePath);
+        if (filename.startsWith("agent-")) {
+            return "agent-session";
+        }
+        return "session";
+    }
+    // Settings file
+    if (relativePath === "settings.json") {
+        return "settings";
+    }
+    // Credentials
+    if (relativePath === "credentials.json" ||
+        relativePath.includes("credentials")) {
+        return "credentials";
+    }
+    // Telemetry (statsig, analytics)
+    if (relativePath.startsWith("statsig/")) {
+        return "telemetry";
+    }
+    return "other";
+}
+//# sourceMappingURL=paths.js.map

package/dist/projects/paths.js.map

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

package/dist/projects/scanner.d.ts

@@ -0,0 +1,45 @@
+import type { Project } from "../supervisor/types.js";
+export interface ScannerOptions {
+    projectsDir?: string;
+    codexSessionsDir?: string;
+    geminiSessionsDir?: string;
+    enableCodex?: boolean;
+    enableGemini?: boolean;
+}
+export declare class ProjectScanner {
+    private projectsDir;
+    private codexScanner;
+    private geminiScanner;
+    private enableCodex;
+    private enableGemini;
+    constructor(options?: ScannerOptions);
+    listProjects(): Promise<Project[]>;
+    getProject(projectId: string): Promise<Project | null>;
+    /**
+     * Get a project by ID, or create a virtual project entry if the path exists on disk
+     * but hasn't been used with Claude yet.
+     *
+     * This allows starting sessions in new directories without requiring prior Claude usage.
+     */
+    getOrCreateProject(projectId: string, preferredProvider?: "claude" | "codex" | "gemini"): Promise<Project | null>;
+    /**
+     * Find a project by matching the session directory suffix.
+     *
+     * This is used by ExternalSessionTracker which extracts the directory-based
+     * project identifier from file paths (e.g., "-home-user-project" or
+     * "hostname/-home-user-project") rather than the base64url-encoded projectId.
+     */
+    getProjectBySessionDirSuffix(dirSuffix: string): Promise<Project | null>;
+    /**
+     * Get the actual project path by reading the cwd from a session file.
+     *
+     * NOTE: This is necessary because the directory names use a lossy
+     * slash-to-hyphen encoding that cannot be reversed reliably.
+     * See packages/server/src/projects/paths.ts for full documentation.
+     */
+    private getProjectPathFromSessions;
+    private countSessions;
+    private getLastActivity;
+}
+export declare const projectScanner: ProjectScanner;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/projects/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/projects/scanner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAUtD,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,YAAY,CAAU;gBAElB,OAAO,GAAE,cAAmB;IAgBlC,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAiHlC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAK5D;;;;;OAKG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAChD,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA6E1B;;;;;;OAMG;IACG,4BAA4B,CAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQ1B;;;;;;OAMG;YACW,0BAA0B;YA0B1B,aAAa;YAYb,eAAe;CAwB9B;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}