sidekick-shared 0.24.3 → 0.24.5

package/dist/parsers/mcpToolName.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Claude Code exposes MCP tools under composite identifiers of the form
+ * `mcp__<server>__<tool>`. Splitting them correctly is subtle enough that
+ * consumers keep re-implementing it by hand (usually with a plain
+ * `split('__')`, which mangles server names containing single underscores).
+ * This module is the canonical splitter. Browser-safe: no Node imports.
+ *
+ * @module mcpToolName
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMcpToolName = parseMcpToolName;
+const MCP_TOOL_NAME_PATTERN = /^mcp__([^_]+(?:_[^_]+)*)__(.+)$/;
+/**
+ * Splits a Claude Code MCP tool identifier `mcp__<server>__<tool>` into parts.
+ *
+ * The server name ends at the first double underscore after the prefix, so
+ * single underscores stay inside it (`mcp__plugin_context7_context7__query-docs`
+ * → server `plugin_context7_context7`) and the tool keeps any further double
+ * underscores (`mcp__a__b__c` → tool `b__c`).
+ *
+ * Returns `null` for anything that is not a well-formed MCP tool id: a
+ * non-`mcp__` name, a missing or empty server or tool part, or a
+ * case-mismatched prefix. No trimming is applied.
+ */
+function parseMcpToolName(name) {
+    const match = MCP_TOOL_NAME_PATTERN.exec(name);
+    if (!match)
+        return null;
+    return { serverName: match[1], toolName: match[2] };
+}

package/dist/parsers/sessionPathResolver.d.ts

@@ -11,10 +11,17 @@
  */
 import type { ProjectFolderInfo } from '../providers/types';
 /**
- * Encodes a workspace path to Claude Code's directory naming scheme.
- *
- * Claude Code replaces path separators, colons, and underscores with hyphens
- * to create a flat directory structure.
+ * Encodes a workspace path to Claude Code's on-disk directory naming scheme
+ * under `~/.claude/projects/` — every non-ASCII-alphanumeric character
+ * (separators, colons, underscores, dots, spaces) becomes a hyphen, and case
+ * is preserved. Exported from the package root as `encodeClaudeWorkspacePath`.
+ *
+ * Not to be confused with the top-level `encodeWorkspacePath` export from
+ * `paths.ts`: that one is Sidekick's own config-store slug (it keeps dots) and
+ * does NOT match Claude Code's scheme — using it to build a
+ * `~/.claude/projects/` path silently misses for any workspace containing a
+ * dot or space. For lookups, prefer `getClaudeSessionDirectory` or the
+ * mismatch-tolerant `discoverSessionDirectory` over raw string encoding.
  *
  * @param workspacePath - Absolute path to workspace directory
  * @returns Encoded path string (e.g., "-home-user-code-project")

package/dist/parsers/sessionPathResolver.js

@@ -61,10 +61,17 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 /**
- * Encodes a workspace path to Claude Code's directory naming scheme.
- *
- * Claude Code replaces path separators, colons, and underscores with hyphens
- * to create a flat directory structure.
+ * Encodes a workspace path to Claude Code's on-disk directory naming scheme
+ * under `~/.claude/projects/` — every non-ASCII-alphanumeric character
+ * (separators, colons, underscores, dots, spaces) becomes a hyphen, and case
+ * is preserved. Exported from the package root as `encodeClaudeWorkspacePath`.
+ *
+ * Not to be confused with the top-level `encodeWorkspacePath` export from
+ * `paths.ts`: that one is Sidekick's own config-store slug (it keeps dots) and
+ * does NOT match Claude Code's scheme — using it to build a
+ * `~/.claude/projects/` path silently misses for any workspace containing a
+ * dot or space. For lookups, prefer `getClaudeSessionDirectory` or the
+ * mismatch-tolerant `discoverSessionDirectory` over raw string encoding.
  *
  * @param workspacePath - Absolute path to workspace directory
  * @returns Encoded path string (e.g., "-home-user-code-project")

package/dist/paths.d.ts

@@ -3,9 +3,44 @@
  * Mirrors patterns from sidekick-vscode/src/services/SessionPathResolver.ts
  * and TaskPersistenceService.ts
  */
+/** Environment variable that redirects the Sidekick config root. */
+export declare const CONFIG_DIR_ENV_VAR = "SIDEKICK_CONFIG_DIR";
+/**
+ * The platform default config directory, ignoring both {@link setConfigDir}
+ * and `SIDEKICK_CONFIG_DIR`.
+ *
+ * `~/.config/sidekick` on Unix, `%APPDATA%/sidekick` on Windows.
+ */
+export declare function getDefaultConfigDir(): string;
+/**
+ * Redirect the Sidekick config root for this process.
+ *
+ * Takes precedence over `SIDEKICK_CONFIG_DIR`. Pass `null` (or an empty
+ * string) to clear it. Every reader and writer in the package resolves the
+ * root lazily through {@link getConfigDir}, so this takes effect immediately
+ * for all of them — including transitive callers of `getProjectDataPath`,
+ * `getGlobalDataPath`, and the account registry.
+ *
+ * Prefer `SIDEKICK_CONFIG_DIR` when the value is known before the process
+ * starts: it is read fresh on every call, so it stays correct even if a
+ * bundler ends up with more than one copy of this module.
+ *
+ * @example
+ * setConfigDir(path.join(os.tmpdir(), 'sidekick-fixture'));
+ * try {
+ *   await addTask(project, { subject: 'isolated' });
+ * } finally {
+ *   setConfigDir(null);
+ * }
+ */
+export declare function setConfigDir(dir: string | null | undefined): void;
+/** The active {@link setConfigDir} override, or `null` when unset. */
+export declare function getConfigDirOverride(): string | null;
 /**
  * Gets the Sidekick config directory.
- * ~/.config/sidekick on Unix, %APPDATA%/sidekick on Windows.
+ *
+ * Resolution order: {@link setConfigDir} override → `SIDEKICK_CONFIG_DIR`
+ * → {@link getDefaultConfigDir}.
  */
 export declare function getConfigDir(): string;
 /**
@@ -19,10 +54,14 @@ export declare function getProjectDataPath(slug: string, subdomain: string): str
  */
 export declare function getGlobalDataPath(filename: string): string;
 /**
- * Encodes a workspace path to Claude Code's directory naming scheme.
- * Replaces path separators, colons, and underscores with hyphens.
+ * Encodes a workspace path into Sidekick's own config-store slug — path
+ * separators, colons, and underscores become hyphens, dots are kept.
  *
- * From: sidekick-vscode/src/services/SessionPathResolver.ts:35-43
+ * This is NOT Claude Code's `~/.claude/projects/` naming scheme, despite the
+ * shared name: Claude Code also replaces dots, spaces, and every other
+ * non-alphanumeric character. To locate Claude Code session directories use
+ * `encodeClaudeWorkspacePath` / `getClaudeSessionDirectory` from
+ * `parsers/sessionPathResolver` instead.
  */
 export declare function encodeWorkspacePath(workspacePath: string): string;
 /**

package/dist/paths.js

@@ -38,6 +38,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_DIR_ENV_VAR = void 0;
+exports.getDefaultConfigDir = getDefaultConfigDir;
+exports.setConfigDir = setConfigDir;
+exports.getConfigDirOverride = getConfigDirOverride;
 exports.getConfigDir = getConfigDir;
 exports.getProjectDataPath = getProjectDataPath;
 exports.getGlobalDataPath = getGlobalDataPath;
@@ -48,16 +52,68 @@ exports.getProjectSlugRaw = getProjectSlugRaw;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
+/** Environment variable that redirects the Sidekick config root. */
+exports.CONFIG_DIR_ENV_VAR = 'SIDEKICK_CONFIG_DIR';
+let configDirOverride = null;
 /**
- * Gets the Sidekick config directory.
- * ~/.config/sidekick on Unix, %APPDATA%/sidekick on Windows.
+ * The platform default config directory, ignoring both {@link setConfigDir}
+ * and `SIDEKICK_CONFIG_DIR`.
+ *
+ * `~/.config/sidekick` on Unix, `%APPDATA%/sidekick` on Windows.
  */
-function getConfigDir() {
+function getDefaultConfigDir() {
     if (process.platform === 'win32') {
         return path.join(process.env.APPDATA || os.homedir(), 'sidekick');
     }
     return path.join(os.homedir(), '.config', 'sidekick');
 }
+/**
+ * Redirect the Sidekick config root for this process.
+ *
+ * Takes precedence over `SIDEKICK_CONFIG_DIR`. Pass `null` (or an empty
+ * string) to clear it. Every reader and writer in the package resolves the
+ * root lazily through {@link getConfigDir}, so this takes effect immediately
+ * for all of them — including transitive callers of `getProjectDataPath`,
+ * `getGlobalDataPath`, and the account registry.
+ *
+ * Prefer `SIDEKICK_CONFIG_DIR` when the value is known before the process
+ * starts: it is read fresh on every call, so it stays correct even if a
+ * bundler ends up with more than one copy of this module.
+ *
+ * @example
+ * setConfigDir(path.join(os.tmpdir(), 'sidekick-fixture'));
+ * try {
+ *   await addTask(project, { subject: 'isolated' });
+ * } finally {
+ *   setConfigDir(null);
+ * }
+ */
+function setConfigDir(dir) {
+    // Resolve the trimmed value, not the original: `path.resolve('  /tmp/x  ')`
+    // treats the leading spaces as a relative segment and lands under cwd. The
+    // `SIDEKICK_CONFIG_DIR` branch in getConfigDir() already trims, and the two
+    // routes are documented as interchangeable.
+    const trimmed = dir?.trim();
+    configDirOverride = trimmed ? path.resolve(trimmed) : null;
+}
+/** The active {@link setConfigDir} override, or `null` when unset. */
+function getConfigDirOverride() {
+    return configDirOverride;
+}
+/**
+ * Gets the Sidekick config directory.
+ *
+ * Resolution order: {@link setConfigDir} override → `SIDEKICK_CONFIG_DIR`
+ * → {@link getDefaultConfigDir}.
+ */
+function getConfigDir() {
+    if (configDirOverride)
+        return configDirOverride;
+    const fromEnv = process.env[exports.CONFIG_DIR_ENV_VAR]?.trim();
+    if (fromEnv)
+        return path.resolve(fromEnv);
+    return getDefaultConfigDir();
+}
 /**
  * Gets the path to a project-specific data file.
  * e.g., ~/.config/sidekick/tasks/my-project.json
@@ -73,10 +129,14 @@ function getGlobalDataPath(filename) {
     return path.join(getConfigDir(), filename);
 }
 /**
- * Encodes a workspace path to Claude Code's directory naming scheme.
- * Replaces path separators, colons, and underscores with hyphens.
+ * Encodes a workspace path into Sidekick's own config-store slug — path
+ * separators, colons, and underscores become hyphens, dots are kept.
  *
- * From: sidekick-vscode/src/services/SessionPathResolver.ts:35-43
+ * This is NOT Claude Code's `~/.claude/projects/` naming scheme, despite the
+ * shared name: Claude Code also replaces dots, spaces, and every other
+ * non-alphanumeric character. To locate Claude Code session directories use
+ * `encodeClaudeWorkspacePath` / `getClaudeSessionDirectory` from
+ * `parsers/sessionPathResolver` instead.
  */
 function encodeWorkspacePath(workspacePath) {
     const normalized = workspacePath.replace(/\\/g, '/');

package/dist/peakHours.d.ts

@@ -23,6 +23,16 @@ export interface PeakHoursState {
     unavailable: boolean;
     notApplicable?: boolean;
 }
+/** Default budget for the promoclock.co request, in milliseconds. */
+export declare const DEFAULT_PEAK_HOURS_TIMEOUT_MS = 10000;
+/** Options for {@link fetchPeakHoursStatus}. */
+export interface FetchPeakHoursOptions {
+    /**
+     * Abort the request after this many milliseconds.
+     * Defaults to {@link DEFAULT_PEAK_HOURS_TIMEOUT_MS}.
+     */
+    timeoutMs?: number;
+}
 export declare function isClaudeCodeSessionProvider(providerId: ProviderId): boolean;
 export declare function createPeakHoursNotApplicableState(providerId: ProviderId): PeakHoursState;
 export declare function scopePeakHoursToSessionProvider(providerId: ProviderId, status: PeakHoursState | null | undefined): PeakHoursState | null;
@@ -30,6 +40,10 @@ export declare function scopePeakHoursToSessionProvider(providerId: ProviderId,
  * Fetch current Claude peak-hours state from promoclock.co.
  *
  * Single-shot — caller wraps in polling loop, EventEmitter, or interval.
- * Returns `unavailable: true` on any network or parse error.
+ * Returns `unavailable: true` on any network, timeout, or parse error.
+ *
+ * promoclock.co is a third-party host, so the request is always bounded by
+ * an abort timeout. Without one a hung host would stall the caller — and
+ * this is polled, so the stall would repeat.
  */
-export declare function fetchPeakHoursStatus(): Promise<PeakHoursState>;
+export declare function fetchPeakHoursStatus(options?: FetchPeakHoursOptions): Promise<PeakHoursState>;

package/dist/peakHours.js

@@ -11,11 +11,14 @@
  * Polling / eventing is the caller's responsibility.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PEAK_HOURS_TIMEOUT_MS = void 0;
 exports.isClaudeCodeSessionProvider = isClaudeCodeSessionProvider;
 exports.createPeakHoursNotApplicableState = createPeakHoursNotApplicableState;
 exports.scopePeakHoursToSessionProvider = scopePeakHoursToSessionProvider;
 exports.fetchPeakHoursStatus = fetchPeakHoursStatus;
 const PROMOCLOCK_ENDPOINT = 'https://promoclock.co/api/status';
+/** Default budget for the promoclock.co request, in milliseconds. */
+exports.DEFAULT_PEAK_HOURS_TIMEOUT_MS = 10_000;
 function unavailableState() {
     return {
         status: 'unknown',
@@ -73,11 +76,19 @@ function normalizeSpeed(raw) {
  * Fetch current Claude peak-hours state from promoclock.co.
  *
  * Single-shot — caller wraps in polling loop, EventEmitter, or interval.
- * Returns `unavailable: true` on any network or parse error.
+ * Returns `unavailable: true` on any network, timeout, or parse error.
+ *
+ * promoclock.co is a third-party host, so the request is always bounded by
+ * an abort timeout. Without one a hung host would stall the caller — and
+ * this is polled, so the stall would repeat.
  */
-async function fetchPeakHoursStatus() {
+async function fetchPeakHoursStatus(options = {}) {
+    const timeoutMs = options.timeoutMs ?? exports.DEFAULT_PEAK_HOURS_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    timeout.unref();
     try {
-        const res = await fetch(PROMOCLOCK_ENDPOINT);
+        const res = await fetch(PROMOCLOCK_ENDPOINT, { signal: controller.signal });
         if (!res.ok)
             return unavailableState();
         const data = await res.json();
@@ -98,6 +109,10 @@ async function fetchPeakHoursStatus() {
         };
     }
     catch {
+        // Covers AbortError from the timeout above alongside network/parse failures.
         return unavailableState();
     }
+    finally {
+        clearTimeout(timeout);
+    }
 }

package/dist/pricingCatalog.d.ts

@@ -18,8 +18,12 @@
  */
 import { type ModelPricing } from './modelInfo';
 export interface HydrateOptions {
-    /** Directory for the on-disk cache (e.g. ~/.config/sidekick). */
-    cacheDir: string;
+    /**
+     * Directory for the on-disk cache. Defaults to the Sidekick config dir,
+     * which honors `SIDEKICK_CONFIG_DIR` and `setConfigDir()` — pass this only
+     * to place the cache somewhere outside the config root.
+     */
+    cacheDir?: string;
     /** Inject a fetch implementation (tests, custom agents). Defaults to `globalThis.fetch`. */
     fetchImpl?: typeof fetch;
     /** Cache TTL in ms. Default 24h. */
@@ -52,7 +56,7 @@ export declare const LITELLM_CATALOG_URL = "https://raw.githubusercontent.com/Be
  *
  * Always resolves — never throws. Offline-safe.
  */
-export declare function hydratePricingCatalog(options: HydrateOptions): Promise<HydrateResult>;
+export declare function hydratePricingCatalog(options?: HydrateOptions): Promise<HydrateResult>;
 /**
  * Convert a LiteLLM catalog payload to our `ModelPricing` override map.
  * Exported for tests; rarely called directly.

package/dist/pricingCatalog.js

@@ -59,6 +59,7 @@ const node_fs_1 = require("node:fs");
 const path = __importStar(require("node:path"));
 const modelContext_1 = require("./modelContext");
 const modelInfo_1 = require("./modelInfo");
+const paths_1 = require("./paths");
 // ── Constants ──
 exports.LITELLM_CATALOG_URL = 'https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json';
 const CACHE_FILE_NAME = 'pricing-catalog.json';
@@ -75,8 +76,8 @@ const DEFAULT_TIMEOUT_MS = 3_000;
  *
  * Always resolves — never throws. Offline-safe.
  */
-async function hydratePricingCatalog(options) {
-    const { cacheDir, fetchImpl = globalThis.fetch, ttlMs = DEFAULT_TTL_MS, timeoutMs = DEFAULT_TIMEOUT_MS, url = exports.LITELLM_CATALOG_URL, logger, } = options;
+async function hydratePricingCatalog(options = {}) {
+    const { cacheDir = (0, paths_1.getConfigDir)(), fetchImpl = globalThis.fetch, ttlMs = DEFAULT_TTL_MS, timeoutMs = DEFAULT_TIMEOUT_MS, url = exports.LITELLM_CATALOG_URL, logger, } = options;
     const cachePath = path.join(cacheDir, CACHE_FILE_NAME);
     const now = Date.now();
     // 1. Fresh cache?

package/dist/providers/claudeCode.d.ts

@@ -9,7 +9,7 @@
  */
 import type { ReadSessionContextSnapshotOptions, SessionContextSnapshot } from '../context/sessionContext';
 import type { SubagentStats, TokenUsage } from '../types/sessionEvent';
-import type { SessionProviderBase, SessionReader, SessionFileStats, SearchHit, ProjectFolderInfo, ProviderId } from './types';
+import type { SessionProviderBase, SessionReader, SessionFileInfo, SessionFileStats, SearchHit, ProjectFolderInfo, ProviderId } from './types';
 /**
  * Session provider for Claude Code CLI.
  *
@@ -30,6 +30,7 @@ export declare class ClaudeCodeProvider implements SessionProviderBase {
     findSessionFiles(workspacePath: string): string[];
     findSessionsInDirectory(dir: string): string[];
     getAllProjectFolders(workspacePath?: string): ProjectFolderInfo[];
+    listAllSessionFiles(): SessionFileInfo[];
     isSessionFile(filename: string): boolean;
     getSessionId(sessionPath: string): string;
     encodeWorkspacePath(workspacePath: string): string;

package/dist/providers/claudeCode.js

@@ -260,6 +260,24 @@ class ClaudeCodeProvider {
     getAllProjectFolders(workspacePath) {
         return (0, sessionPathResolver_1.getAllProjectFolders)(workspacePath);
     }
+    listAllSessionFiles() {
+        const results = [];
+        const seen = new Set();
+        for (const folder of this.getAllProjectFolders()) {
+            for (const sessionPath of this.findSessionsInDirectory(folder.dir)) {
+                if (seen.has(sessionPath))
+                    continue;
+                seen.add(sessionPath);
+                try {
+                    results.push({ path: sessionPath, mtime: fs.statSync(sessionPath).mtime });
+                }
+                catch {
+                    // Skip files that vanish between listing and stat.
+                }
+            }
+        }
+        return results;
+    }
     // --- File identification ---
     isSessionFile(filename) {
         return filename.endsWith('.jsonl');

package/dist/providers/codex.d.ts

@@ -9,9 +9,29 @@
  * Ported from sidekick-vscode/src/services/providers/CodexSessionProvider.ts
  */
 import type { ReadSessionContextSnapshotOptions, SessionContextSnapshot } from '../context/sessionContext';
-import type { SessionProviderBase, SessionReader, ProjectFolderInfo, SearchHit, SessionFileStats, ProviderId } from './types';
+import type { SessionProviderBase, SessionReader, ProjectFolderInfo, SearchHit, SessionFileInfo, SessionFileStats, ProviderId } from './types';
 import type { SubagentStats, TokenUsage } from '../types/sessionEvent';
 import type { CodexRateLimits } from '../types/codex';
+export interface FindCodexRolloutFileOptions {
+    /**
+     * Codex home whose `sessions/` subtree to search. Defaults to every
+     * monitored home: `$CODEX_HOME` if set, else `~/.codex`, plus managed
+     * profile homes that recorded sessions.
+     */
+    codexHome?: string;
+}
+/**
+ * Locates the rollout file for a Codex session id by walking
+ * `<home>/sessions/YYYY/MM/DD/rollout-<timestamp>-<id>.jsonl`.
+ *
+ * Filename-only match, case-insensitive on the id — no file contents are read
+ * and files are only stat'ed once their name matches, so the walk stays cheap
+ * even over a large history. When the same id exists in more than one home,
+ * the most recently modified copy wins. Returns `null` for an unknown, empty,
+ * or whitespace id. Consumers who want the database's answer instead can query
+ * the already-public `CodexDatabase` (requires the external `sqlite3` binary).
+ */
+export declare function findCodexRolloutFile(sessionId: string, options?: FindCodexRolloutFileOptions): string | null;
 /**
  * Session provider for Codex CLI.
  *
@@ -35,6 +55,7 @@ export declare class CodexProvider implements SessionProviderBase {
     /** Backward-compatible alias for findAllSessions. */
     findSessionFiles(workspacePath: string): string[];
     findSessionsInDirectory(dir: string): string[];
+    listAllSessionFiles(): SessionFileInfo[];
     getAllProjectFolders(workspacePath?: string): ProjectFolderInfo[];
     isSessionFile(filename: string): boolean;
     getSessionId(sessionPath: string): string;

package/dist/providers/codex.js

@@ -44,6 +44,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodexProvider = void 0;
+exports.findCodexRolloutFile = findCodexRolloutFile;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const string_decoder_1 = require("string_decoder");
@@ -164,6 +165,60 @@ function findRolloutFilesInConfiguredHomes() {
     }
     return results;
 }
+/**
+ * Locates the rollout file for a Codex session id by walking
+ * `<home>/sessions/YYYY/MM/DD/rollout-<timestamp>-<id>.jsonl`.
+ *
+ * Filename-only match, case-insensitive on the id — no file contents are read
+ * and files are only stat'ed once their name matches, so the walk stays cheap
+ * even over a large history. When the same id exists in more than one home,
+ * the most recently modified copy wins. Returns `null` for an unknown, empty,
+ * or whitespace id. Consumers who want the database's answer instead can query
+ * the already-public `CodexDatabase` (requires the external `sqlite3` binary).
+ */
+function findCodexRolloutFile(sessionId, options = {}) {
+    const normalizedId = sessionId.trim().toLowerCase();
+    if (!normalizedId)
+        return null;
+    const sessionsDirs = options.codexHome
+        ? [path.join(options.codexHome, 'sessions')]
+        : getSessionsDirs();
+    let best = null;
+    for (const dir of sessionsDirs) {
+        for (const candidate of findRolloutFilesById(dir, normalizedId)) {
+            if (!best || candidate.mtimeMs > best.mtimeMs)
+                best = candidate;
+        }
+    }
+    return best?.path ?? null;
+}
+function findRolloutFilesById(dir, normalizedId) {
+    const results = [];
+    try {
+        if (!fs.existsSync(dir))
+            return results;
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                results.push(...findRolloutFilesById(fullPath, normalizedId));
+            }
+            else if (entry.isFile() &&
+                isRolloutFile(entry.name) &&
+                extractSessionId(entry.name).toLowerCase() === normalizedId) {
+                try {
+                    results.push({ path: fullPath, mtimeMs: fs.statSync(fullPath).mtimeMs });
+                }
+                catch {
+                    // Skip files that vanish between readdir and stat.
+                }
+            }
+        }
+    }
+    catch {
+        // Skip inaccessible directories.
+    }
+    return results;
+}
 /** Pick the best sessions directory for UI/search entrypoints. */
 function getSessionsDir() {
     const dirs = getSessionsDirs();
@@ -711,6 +766,9 @@ class CodexProvider {
         files.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
         return files.map((f) => f.path);
     }
+    listAllSessionFiles() {
+        return findRolloutFilesInConfiguredHomes();
+    }
     getAllProjectFolders(workspacePath) {
         const folders = [];
         const seenCwds = new Map();

package/dist/providers/types.d.ts

@@ -143,6 +143,11 @@ export interface SessionProviderBase {
     readSessionContextSnapshot?(sessionPath: string, options?: ReadSessionContextSnapshotOptions): SessionContextSnapshot;
     /** Reports provider runtime readiness for DB-backed providers. */
     getRuntimeStatus?(): ProviderRuntimeStatus;
+    /**
+     * Lists every session file this provider knows about, across all workspaces.
+     * Stat-only — implementations must not read file contents.
+     */
+    listAllSessionFiles?(): SessionFileInfo[];
     /** Tests whether a provider can monitor a directory path, including synthetic DB-backed paths. */
     canMonitorDirectory?(dir: string): boolean;
     /** Release resources. */

package/dist/quotaHistory.d.ts

@@ -3,7 +3,7 @@
  *
  * Sibling to `quotaSnapshots.ts`. Where snapshots persist a single most-recent sample per
  * (provider, account), this module accumulates time-series samples so consumers (the VS Code
- * dashboard, the `sidekick quota history` CLI, contextful_desktop) can render heatmaps and
+ * dashboard, the `sidekick quota history` CLI, external consumers) can render heatmaps and
  * trend visualisations over a 13-week window.
  */
 export type QuotaHistoryRuntimeProvider = 'claude' | 'codex' | 'zai';

package/dist/quotaHistory.js

@@ -4,7 +4,7 @@
  *
  * Sibling to `quotaSnapshots.ts`. Where snapshots persist a single most-recent sample per
  * (provider, account), this module accumulates time-series samples so consumers (the VS Code
- * dashboard, the `sidekick quota history` CLI, contextful_desktop) can render heatmaps and
+ * dashboard, the `sidekick quota history` CLI, external consumers) can render heatmaps and
  * trend visualisations over a 13-week window.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -258,7 +258,7 @@ async function runAppend(sample, filePath, options) {
         // ignore
     }
     // Backwards-compat: keep the latest-snapshot store hot so existing callers (DashboardViewProvider,
-    // codex session provider, contextful_desktop) don't have to query history for "latest".
+    // codex session provider, external consumers) don't have to query history for "latest".
     try {
         const providerId = runtimeProviderToSnapshotProvider(sample.runtimeProvider);
         (0, quotaSnapshots_1.writeQuotaSnapshot)(providerId, sample.providerId, sampleToQuotaState(sample));