sidekick-shared 0.27.6 → 0.28.0

package/dist/node.d.ts

@@ -10,7 +10,7 @@ export type { HydrateOptions, HydrateResult } from './pricingCatalog';
 export { loadObservedContextWindows, recordObservedContextWindow, getObservedContextWindowPath, } from './observedContextWindows';
 export type { ObservedContextWindowOptions, ObservedContextWindowStore, } from './observedContextWindows';
 export { listRecentSessions, readSessionTranscript } from './sessionTranscripts';
-export { collectPromptHistory } from './promptHistory';
+export { collectPromptHistory, isPromptHistorySessionSettled, parsePromptHistoryCursor, } from './promptHistory';
 export type { CollectPromptHistoryOptions, PromptHistoryAnswerState, PromptHistoryBound, PromptHistoryBounds, PromptHistoryCursor, PromptHistoryCursorSession, PromptHistoryEntry, PromptHistoryExclusion, PromptHistoryMetadataStatus, PromptHistoryPendingPrompt, PromptHistoryProvider, PromptHistoryResult, PromptHistoryResumeState, PromptHistoryStats, PromptHistoryUsage, } from './promptHistory';
 export { collectSessionPromptHistory } from './sessionPromptHistory';
 export type { CollectSessionPromptHistoryOptions, PromptHistorySession, PromptHistorySessionPrompt, PromptHistorySessionRef, SessionPromptHistoryBound, SessionPromptHistoryBounds, SessionPromptHistoryInclude, SessionPromptHistoryResult, SessionPromptHistoryStats, } from './sessionPromptHistory';
@@ -53,5 +53,17 @@ export type { ListSessionFilesOptions, ProviderId, SessionEnumerationCounters, S
 export { createSessionProviders } from './providers/factory';
 export type { CreateSessionProvidersOptions, CreateSessionProvidersResult, } from './providers/factory';
 export { SYNTHETIC_MODEL } from './usage/claudeUsageDedupe';
+export { CONFIG_DIR_ENV_VAR, getConfigDir, getConfigDirOverride, getDefaultConfigDir, } from './paths';
+export { encodeWorkspacePath as encodeClaudeWorkspacePath, getSessionDirectory as getClaudeSessionDirectory, } from './parsers/sessionPathResolver';
+export { getLiveClaudeHome, getDefaultClaudeHome, isDefaultClaudeHome, getClaudeProjectsDir, } from './claudePaths';
+export { getSystemCodexHome, getCodexMonitoringHomes, resolveSidekickCodexHome, getCodexExecutionEnv, getCodexSessionsDirs, CODEX_SESSIONS_SUBDIR, CODEX_ARCHIVED_SESSIONS_SUBDIR, } from './codexPaths';
+export type { CodexSessionsDirsOptions } from './codexPaths';
 export type { ProviderServiceSeverity, ProviderServiceComponent, ProviderServiceIncident, ProviderServiceStatusFailureReason, ObservedProviderServiceStatus, UnavailableProviderServiceStatus, ProviderServiceStatus, FetchProviderServiceStatusOptions, } from './providerServiceStatusTypes';
 export { fetchProviderServiceStatus } from './providerServiceStatus';
+export { classifyTool, TOOL_CATEGORIES } from './toolCategory';
+export type { ClassifyToolOptions, ToolCategory } from './toolCategory';
+export { resolveWorkspaceRoots } from './workspaceRoots';
+export type { ResolveWorkspaceRootsOptions, ResolvedWorkspaceRoots } from './workspaceRoots';
+export { discoverWorktreeSiblings, resolveWorktreeMainRepo } from './parsers/sessionPathResolver';
+export { createJsonlTail, DEFAULT_JSONL_TAIL_MAX_LINE_BYTES, DEFAULT_JSONL_TAIL_READ_BYTES, } from './watchers/jsonlTail';
+export type { JsonlTail, JsonlTailBatch, JsonlTailLine, JsonlTailOptions, JsonlTailReset, JsonlTailResetReason, } from './watchers/jsonlTail';

package/dist/node.js

@@ -7,8 +7,8 @@
  * for browser bundles — use `sidekick-shared/browser` there.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bucketUsage = exports.importSessionHistory = exports.ACTIVE_SESSION_MTIME_THRESHOLD_MS = exports.sessionSummaryFromStats = exports.removeSessionSummary = exports.markFileImported = exports.isFileImported = exports.applySessionSummary = exports.subagentTokenTotals = exports.scanSessionSubagents = exports.readMainThreadTokenTotals = exports.combineSessionTokenTotals = exports.collectSessionTokenTotals = exports.pruneUsageCache = exports.getUsageCacheDir = exports.collectUsageEvents = exports.USAGE_CACHE_VERSION = exports.MAX_USAGE_CACHE_FILES = exports.findActiveBillingBlock = exports.computeBillingBlocks = exports.BILLING_BLOCK_DURATION_MS = exports.writeStateFile = exports.readStateFile = exports.quotaToStateFile = exports.getStateFilePath = exports.billingBlockToStateFile = exports.STATE_FILE_SCHEMA_VERSION = exports.STATE_FILE_NAME = exports.sessionFingerprintParts = exports.fingerprintString = exports.readSessionReportInputs = exports.readSessionFileStats = exports.providerContextSizeFn = exports.firstUserPrompt = exports.computeSessionFileStats = exports.isHumanPrompt = exports.humanPromptText = exports.HUMAN_CODEX_SOURCES = exports.HUMAN_CLAUDE_ENTRYPOINTS = exports.collectSessionPromptHistory = exports.collectPromptHistory = exports.readSessionTranscript = exports.listRecentSessions = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = void 0;
-exports.fetchProviderServiceStatus = exports.SYNTHETIC_MODEL = exports.createSessionProviders = exports.splitWatchedPath = exports.DirectoryListingCache = exports.fileFingerprintParts = exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionPreviewAsync = exports.readSessionPreview = exports.listSessionPreviewsAsync = exports.listSessionPreviews = exports.readCodexHistory = exports.walkRolloutFilesAsync = exports.walkRolloutFiles = exports.findCodexRolloutFile = exports.weekKey = exports.usageBucketKey = exports.summarizeUsageRows = void 0;
+exports.ACTIVE_SESSION_MTIME_THRESHOLD_MS = exports.sessionSummaryFromStats = exports.removeSessionSummary = exports.markFileImported = exports.isFileImported = exports.applySessionSummary = exports.subagentTokenTotals = exports.scanSessionSubagents = exports.readMainThreadTokenTotals = exports.combineSessionTokenTotals = exports.collectSessionTokenTotals = exports.pruneUsageCache = exports.getUsageCacheDir = exports.collectUsageEvents = exports.USAGE_CACHE_VERSION = exports.MAX_USAGE_CACHE_FILES = exports.findActiveBillingBlock = exports.computeBillingBlocks = exports.BILLING_BLOCK_DURATION_MS = exports.writeStateFile = exports.readStateFile = exports.quotaToStateFile = exports.getStateFilePath = exports.billingBlockToStateFile = exports.STATE_FILE_SCHEMA_VERSION = exports.STATE_FILE_NAME = exports.sessionFingerprintParts = exports.fingerprintString = exports.readSessionReportInputs = exports.readSessionFileStats = exports.providerContextSizeFn = exports.firstUserPrompt = exports.computeSessionFileStats = exports.isHumanPrompt = exports.humanPromptText = exports.HUMAN_CODEX_SOURCES = exports.HUMAN_CLAUDE_ENTRYPOINTS = exports.collectSessionPromptHistory = exports.parsePromptHistoryCursor = exports.isPromptHistorySessionSettled = exports.collectPromptHistory = exports.readSessionTranscript = exports.listRecentSessions = exports.getObservedContextWindowPath = exports.recordObservedContextWindow = exports.loadObservedContextWindows = exports.LITELLM_CATALOG_URL = exports.normalizeLiteLlmContextWindows = exports.normalizeLiteLlmCatalog = exports.hydratePricingCatalog = void 0;
+exports.DEFAULT_JSONL_TAIL_READ_BYTES = exports.DEFAULT_JSONL_TAIL_MAX_LINE_BYTES = exports.createJsonlTail = exports.resolveWorktreeMainRepo = exports.discoverWorktreeSiblings = exports.resolveWorkspaceRoots = exports.TOOL_CATEGORIES = exports.classifyTool = exports.fetchProviderServiceStatus = exports.CODEX_ARCHIVED_SESSIONS_SUBDIR = exports.CODEX_SESSIONS_SUBDIR = exports.getCodexSessionsDirs = exports.getCodexExecutionEnv = exports.resolveSidekickCodexHome = exports.getCodexMonitoringHomes = exports.getSystemCodexHome = exports.getClaudeProjectsDir = exports.isDefaultClaudeHome = exports.getDefaultClaudeHome = exports.getLiveClaudeHome = exports.getClaudeSessionDirectory = exports.encodeClaudeWorkspacePath = exports.getDefaultConfigDir = exports.getConfigDirOverride = exports.getConfigDir = exports.CONFIG_DIR_ENV_VAR = exports.SYNTHETIC_MODEL = exports.createSessionProviders = exports.splitWatchedPath = exports.DirectoryListingCache = exports.fileFingerprintParts = exports.fileFingerprint = exports.observedSessionSourceFromProvider = exports.ObservedSessionCollector = exports.readSessionPreviewAsync = exports.readSessionPreview = exports.listSessionPreviewsAsync = exports.listSessionPreviews = exports.readCodexHistory = exports.walkRolloutFilesAsync = exports.walkRolloutFiles = exports.findCodexRolloutFile = exports.weekKey = exports.usageBucketKey = exports.summarizeUsageRows = exports.bucketUsage = exports.importSessionHistory = void 0;
 var pricingCatalog_1 = require("./pricingCatalog");
 Object.defineProperty(exports, "hydratePricingCatalog", { enumerable: true, get: function () { return pricingCatalog_1.hydratePricingCatalog; } });
 Object.defineProperty(exports, "normalizeLiteLlmCatalog", { enumerable: true, get: function () { return pricingCatalog_1.normalizeLiteLlmCatalog; } });
@@ -23,6 +23,8 @@ Object.defineProperty(exports, "listRecentSessions", { enumerable: true, get: fu
 Object.defineProperty(exports, "readSessionTranscript", { enumerable: true, get: function () { return sessionTranscripts_1.readSessionTranscript; } });
 var promptHistory_1 = require("./promptHistory");
 Object.defineProperty(exports, "collectPromptHistory", { enumerable: true, get: function () { return promptHistory_1.collectPromptHistory; } });
+Object.defineProperty(exports, "isPromptHistorySessionSettled", { enumerable: true, get: function () { return promptHistory_1.isPromptHistorySessionSettled; } });
+Object.defineProperty(exports, "parsePromptHistoryCursor", { enumerable: true, get: function () { return promptHistory_1.parsePromptHistoryCursor; } });
 var sessionPromptHistory_1 = require("./sessionPromptHistory");
 Object.defineProperty(exports, "collectSessionPromptHistory", { enumerable: true, get: function () { return sessionPromptHistory_1.collectSessionPromptHistory; } });
 var humanPrompt_1 = require("./humanPrompt");
@@ -102,5 +104,44 @@ var factory_1 = require("./providers/factory");
 Object.defineProperty(exports, "createSessionProviders", { enumerable: true, get: function () { return factory_1.createSessionProviders; } });
 var claudeUsageDedupe_1 = require("./usage/claudeUsageDedupe");
 Object.defineProperty(exports, "SYNTHETIC_MODEL", { enumerable: true, get: function () { return claudeUsageDedupe_1.SYNTHETIC_MODEL; } });
+// Sidekick's config root
+var paths_1 = require("./paths");
+Object.defineProperty(exports, "CONFIG_DIR_ENV_VAR", { enumerable: true, get: function () { return paths_1.CONFIG_DIR_ENV_VAR; } });
+Object.defineProperty(exports, "getConfigDir", { enumerable: true, get: function () { return paths_1.getConfigDir; } });
+Object.defineProperty(exports, "getConfigDirOverride", { enumerable: true, get: function () { return paths_1.getConfigDirOverride; } });
+Object.defineProperty(exports, "getDefaultConfigDir", { enumerable: true, get: function () { return paths_1.getDefaultConfigDir; } });
+// Claude Code session directories (Claude's own path encoding)
+var sessionPathResolver_1 = require("./parsers/sessionPathResolver");
+Object.defineProperty(exports, "encodeClaudeWorkspacePath", { enumerable: true, get: function () { return sessionPathResolver_1.encodeWorkspacePath; } });
+Object.defineProperty(exports, "getClaudeSessionDirectory", { enumerable: true, get: function () { return sessionPathResolver_1.getSessionDirectory; } });
+// Provider homes the CLIs read for this process
+var claudePaths_1 = require("./claudePaths");
+Object.defineProperty(exports, "getLiveClaudeHome", { enumerable: true, get: function () { return claudePaths_1.getLiveClaudeHome; } });
+Object.defineProperty(exports, "getDefaultClaudeHome", { enumerable: true, get: function () { return claudePaths_1.getDefaultClaudeHome; } });
+Object.defineProperty(exports, "isDefaultClaudeHome", { enumerable: true, get: function () { return claudePaths_1.isDefaultClaudeHome; } });
+Object.defineProperty(exports, "getClaudeProjectsDir", { enumerable: true, get: function () { return claudePaths_1.getClaudeProjectsDir; } });
+var codexPaths_1 = require("./codexPaths");
+Object.defineProperty(exports, "getSystemCodexHome", { enumerable: true, get: function () { return codexPaths_1.getSystemCodexHome; } });
+Object.defineProperty(exports, "getCodexMonitoringHomes", { enumerable: true, get: function () { return codexPaths_1.getCodexMonitoringHomes; } });
+Object.defineProperty(exports, "resolveSidekickCodexHome", { enumerable: true, get: function () { return codexPaths_1.resolveSidekickCodexHome; } });
+Object.defineProperty(exports, "getCodexExecutionEnv", { enumerable: true, get: function () { return codexPaths_1.getCodexExecutionEnv; } });
+Object.defineProperty(exports, "getCodexSessionsDirs", { enumerable: true, get: function () { return codexPaths_1.getCodexSessionsDirs; } });
+Object.defineProperty(exports, "CODEX_SESSIONS_SUBDIR", { enumerable: true, get: function () { return codexPaths_1.CODEX_SESSIONS_SUBDIR; } });
+Object.defineProperty(exports, "CODEX_ARCHIVED_SESSIONS_SUBDIR", { enumerable: true, get: function () { return codexPaths_1.CODEX_ARCHIVED_SESSIONS_SUBDIR; } });
 var providerServiceStatus_1 = require("./providerServiceStatus");
 Object.defineProperty(exports, "fetchProviderServiceStatus", { enumerable: true, get: function () { return providerServiceStatus_1.fetchProviderServiceStatus; } });
+// Tool categories across providers
+var toolCategory_1 = require("./toolCategory");
+Object.defineProperty(exports, "classifyTool", { enumerable: true, get: function () { return toolCategory_1.classifyTool; } });
+Object.defineProperty(exports, "TOOL_CATEGORIES", { enumerable: true, get: function () { return toolCategory_1.TOOL_CATEGORIES; } });
+// Workspace roots and git worktrees
+var workspaceRoots_1 = require("./workspaceRoots");
+Object.defineProperty(exports, "resolveWorkspaceRoots", { enumerable: true, get: function () { return workspaceRoots_1.resolveWorkspaceRoots; } });
+var sessionPathResolver_2 = require("./parsers/sessionPathResolver");
+Object.defineProperty(exports, "discoverWorktreeSiblings", { enumerable: true, get: function () { return sessionPathResolver_2.discoverWorktreeSiblings; } });
+Object.defineProperty(exports, "resolveWorktreeMainRepo", { enumerable: true, get: function () { return sessionPathResolver_2.resolveWorktreeMainRepo; } });
+// Bounded JSONL tail reader
+var jsonlTail_1 = require("./watchers/jsonlTail");
+Object.defineProperty(exports, "createJsonlTail", { enumerable: true, get: function () { return jsonlTail_1.createJsonlTail; } });
+Object.defineProperty(exports, "DEFAULT_JSONL_TAIL_MAX_LINE_BYTES", { enumerable: true, get: function () { return jsonlTail_1.DEFAULT_JSONL_TAIL_MAX_LINE_BYTES; } });
+Object.defineProperty(exports, "DEFAULT_JSONL_TAIL_READ_BYTES", { enumerable: true, get: function () { return jsonlTail_1.DEFAULT_JSONL_TAIL_READ_BYTES; } });

package/dist/parsers/codexHistory.js

@@ -47,7 +47,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.readCodexHistory = readCodexHistory;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const codexProfiles_1 = require("../codexProfiles");
+const codexPaths_1 = require("../codexPaths");
 const DEFAULT_LIMIT = 100;
 const DEFAULT_TAIL_BYTES = 512 * 1024;
 /**
@@ -59,7 +59,7 @@ function readCodexHistory(options = {}) {
     if (limit === 0)
         return [];
     const maxTailBytes = Math.max(1, options.maxTailBytes ?? Math.max(DEFAULT_TAIL_BYTES, limit * 4096));
-    const historyPath = path.join(options.codexHome ?? (0, codexProfiles_1.getSystemCodexHome)(), 'history.jsonl');
+    const historyPath = path.join(options.codexHome ?? (0, codexPaths_1.getSystemCodexHome)(), 'history.jsonl');
     let descriptor;
     try {
         descriptor = fs.openSync(historyPath, 'r');

package/dist/parsers/codexParser.d.ts

@@ -44,6 +44,16 @@ export declare function normalizeCodexToolInput(canonicalToolName: string, rawTo
  * Matches lines like: `*** Add File: src/math.ts` or `*** Update File: src/index.ts`
  */
 export declare function extractPatchFilePaths(input: string): string[];
+/** Default cap on each piece of per-call correlation state the parser keeps. */
+export declare const DEFAULT_MAX_TRACKED_TOOL_CALLS = 4096;
+export interface CodexRolloutParserOptions {
+    /**
+     * How many call ids each correlation table (emitted tool uses, expanded
+     * patches, pending exec and MCP calls) remembers before forgetting the
+     * oldest. Bounds memory on long-running rollouts; default 4096.
+     */
+    maxTrackedToolCalls?: number;
+}
 /**
  * Stateful parser for Codex JSONL rollout lines.
  *
@@ -67,6 +77,8 @@ export declare class CodexRolloutParser {
     private inPlanMode;
     private emittedToolUseIds;
     private patchExpandedToolUseIds;
+    private readonly maxTrackedToolCalls;
+    constructor(options?: CodexRolloutParserOptions);
     /** Get stored session metadata. */
     getSessionMeta(): CodexSessionMeta | null;
     /** Get current model from turn_context. */

package/dist/parsers/codexParser.js

@@ -13,7 +13,7 @@
  * @module parsers/codexParser
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CodexRolloutParser = void 0;
+exports.CodexRolloutParser = exports.DEFAULT_MAX_TRACKED_TOOL_CALLS = void 0;
 exports.resolveCodexCallUsage = resolveCodexCallUsage;
 exports.normalizeCodexToolName = normalizeCodexToolName;
 exports.normalizeCodexToolInput = normalizeCodexToolInput;
@@ -176,6 +176,22 @@ function extractPatchFilePaths(input) {
     }
     return paths;
 }
+/** Default cap on each piece of per-call correlation state the parser keeps. */
+exports.DEFAULT_MAX_TRACKED_TOOL_CALLS = 4096;
+/** Adds `key`, refreshing its position, and evicts the oldest past `max`. */
+function rememberBounded(set, key, max) {
+    set.delete(key);
+    set.add(key);
+    while (set.size > max)
+        set.delete(set.values().next().value);
+}
+/** Sets `key`, refreshing its position, and evicts the oldest past `max`. */
+function setBounded(map, key, value, max) {
+    map.delete(key);
+    map.set(key, value);
+    while (map.size > max)
+        map.delete(map.keys().next().value);
+}
 /**
  * Stateful parser for Codex JSONL rollout lines.
  *
@@ -199,6 +215,12 @@ class CodexRolloutParser {
     inPlanMode = false;
     emittedToolUseIds = new Set();
     patchExpandedToolUseIds = new Map();
+    maxTrackedToolCalls;
+    constructor(options = {}) {
+        const max = options.maxTrackedToolCalls;
+        this.maxTrackedToolCalls =
+            typeof max === 'number' && max >= 1 ? Math.floor(max) : exports.DEFAULT_MAX_TRACKED_TOOL_CALLS;
+    }
     /** Get stored session metadata. */
     getSessionMeta() {
         return this.sessionMeta;
@@ -374,7 +396,7 @@ class CodexRolloutParser {
         }
         const canonicalName = normalizeCodexToolName(item.name);
         const normalizedInput = normalizeCodexToolInput(canonicalName, item.name, parsedArgs);
-        this.emittedToolUseIds.add(item.call_id);
+        rememberBounded(this.emittedToolUseIds, item.call_id, this.maxTrackedToolCalls);
         return [
             {
                 type: 'assistant',
@@ -418,7 +440,7 @@ class CodexRolloutParser {
     }
     handleLocalShellCall(timestamp, item) {
         const command = item.action?.command?.join(' ') || '';
-        this.emittedToolUseIds.add(item.call_id);
+        rememberBounded(this.emittedToolUseIds, item.call_id, this.maxTrackedToolCalls);
         return [
             {
                 type: 'assistant',
@@ -449,9 +471,9 @@ class CodexRolloutParser {
             if (filePaths.length === 0)
                 return [];
             const toolUseIds = filePaths.map((fp) => `${item.call_id}-${fp}`);
-            this.patchExpandedToolUseIds.set(item.call_id, toolUseIds);
+            setBounded(this.patchExpandedToolUseIds, item.call_id, toolUseIds, this.maxTrackedToolCalls);
             for (const id of toolUseIds) {
-                this.emittedToolUseIds.add(id);
+                rememberBounded(this.emittedToolUseIds, id, this.maxTrackedToolCalls);
             }
             return filePaths.map((fp) => ({
                 type: 'assistant',
@@ -484,7 +506,7 @@ class CodexRolloutParser {
         }
         const canonicalName = normalizeCodexToolName(item.name);
         const normalizedInput = normalizeCodexToolInput(canonicalName, item.name, parsedInput);
-        this.emittedToolUseIds.add(item.call_id);
+        rememberBounded(this.emittedToolUseIds, item.call_id, this.maxTrackedToolCalls);
         return [
             {
                 type: 'assistant',
@@ -593,12 +615,12 @@ class CodexRolloutParser {
             // response_item/message events which carry richer metadata (id, content parts, role).
             case 'exec_command_begin': {
                 const e = event;
-                this.pendingExecCommands.set(e.call_id, {
+                setBounded(this.pendingExecCommands, e.call_id, {
                     call_id: e.call_id,
                     command: e.command,
                     workdir: e.workdir,
                     timestamp,
-                });
+                }, this.maxTrackedToolCalls);
                 return [];
             }
             case 'exec_command_end': {
@@ -608,7 +630,7 @@ class CodexRolloutParser {
                 const command = pending?.command?.join(' ') || '';
                 const events = [];
                 if (!this.emittedToolUseIds.has(e.call_id)) {
-                    this.emittedToolUseIds.add(e.call_id);
+                    rememberBounded(this.emittedToolUseIds, e.call_id, this.maxTrackedToolCalls);
                     events.push({
                         type: 'assistant',
                         message: {
@@ -653,13 +675,13 @@ class CodexRolloutParser {
             }
             case 'mcp_tool_call_begin': {
                 const e = event;
-                this.pendingMcpToolCalls.set(e.call_id, {
+                setBounded(this.pendingMcpToolCalls, e.call_id, {
                     call_id: e.call_id,
                     server_name: e.server_name,
                     tool_name: e.tool_name,
                     arguments: e.arguments,
                     timestamp,
-                });
+                }, this.maxTrackedToolCalls);
                 return [];
             }
             case 'mcp_tool_call_end': {
@@ -669,7 +691,7 @@ class CodexRolloutParser {
                 const toolName = pendingMcp?.tool_name || 'McpTool';
                 const events = [];
                 if (!this.emittedToolUseIds.has(e.call_id)) {
-                    this.emittedToolUseIds.add(e.call_id);
+                    rememberBounded(this.emittedToolUseIds, e.call_id, this.maxTrackedToolCalls);
                     events.push({
                         type: 'assistant',
                         message: {

package/dist/parsers/debugLogParser.js

@@ -47,7 +47,7 @@ exports.collapseDuplicates = collapseDuplicates;
 exports.discoverDebugLogs = discoverDebugLogs;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const os = __importStar(require("os"));
+const claudePaths_1 = require("../claudePaths");
 // ── Constants ──
 const LOG_LINE_PATTERN = /^(\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}[.\d]*Z?)\s+(DEBUG|INFO|WARN|ERROR)\s+(.*)$/;
 const LEVEL_ORDER = {
@@ -134,7 +134,7 @@ function collapseDuplicates(entries) {
  * @returns Array of debug log file info, sorted by mtime (most recent first)
  */
 function discoverDebugLogs() {
-    const debugDir = path.join(os.homedir(), '.claude', 'debug');
+    const debugDir = path.join((0, claudePaths_1.getLiveClaudeHome)(), 'debug');
     try {
         if (!fs.existsSync(debugDir))
             return [];

package/dist/parsers/sessionPathResolver.js

@@ -61,6 +61,7 @@ exports.findAllSessionsWithWorktrees = findAllSessionsWithWorktrees;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
+const claudePaths_1 = require("../claudePaths");
 /**
  * Encodes a workspace path to Claude Code's on-disk directory naming scheme
  * under `~/.claude/projects/` — every non-ASCII-alphanumeric character
@@ -110,7 +111,7 @@ function encodeWorkspacePath(workspacePath) {
  */
 function getSessionDirectory(workspacePath) {
     const encoded = encodeWorkspacePath(workspacePath);
-    return path.join(os.homedir(), '.claude', 'projects', encoded);
+    return path.join((0, claudePaths_1.getClaudeProjectsDir)(), encoded);
 }
 /** How recently a file must be modified to be considered "active" (5 minutes) */
 const ACTIVE_SESSION_THRESHOLD_MS = 5 * 60 * 1000;
@@ -134,7 +135,7 @@ const ACTIVE_SESSION_THRESHOLD_MS = 5 * 60 * 1000;
  * ```
  */
 function findSubdirectorySessionDirs(workspacePath) {
-    const projectsDir = path.join(os.homedir(), '.claude', 'projects');
+    const projectsDir = (0, claudePaths_1.getClaudeProjectsDir)();
     try {
         if (!fs.existsSync(projectsDir)) {
             return [];
@@ -225,7 +226,7 @@ function getMostRecentlyActiveSessionDir(sessionDirs) {
  * @returns Absolute path to session directory, or null if not found
  */
 function discoverSessionDirectory(workspacePath) {
-    const projectsDir = path.join(os.homedir(), '.claude', 'projects');
+    const projectsDir = (0, claudePaths_1.getClaudeProjectsDir)();
     // Strategy 1: Try computed encoded path (exact match)
     const computedDir = getSessionDirectory(workspacePath);
     if (fs.existsSync(computedDir)) {
@@ -498,7 +499,7 @@ function decodeEncodedPath(encoded) {
  * ```
  */
 function getAllProjectFolders(workspacePath) {
-    const projectsDir = path.join(os.homedir(), '.claude', 'projects');
+    const projectsDir = (0, claudePaths_1.getClaudeProjectsDir)();
     const folders = [];
     try {
         if (!fs.existsSync(projectsDir)) {

package/dist/promptHistory.d.ts

@@ -154,6 +154,18 @@ export interface PromptHistoryEntry {
      * and text, by a later call once its metadata or status changes.
      */
     metadataStatus: PromptHistoryMetadataStatus;
+    /**
+     * Opaque key of the session file this entry came from, the same as its
+     * cursor key. It tells apart two files that carry the same session id.
+     */
+    sessionKey?: string;
+}
+/** A session by provider and id, optionally pinned to one file by `sessionKey`. */
+export interface PromptHistorySessionRef {
+    provider: PromptHistoryProvider;
+    sessionId: string;
+    /** Opaque key of one session file; see `PromptHistoryEntry.sessionKey`. */
+    sessionKey?: string;
 }
 /**
  * A log record permanently left out. Records over `maxRecordBytes` and lines
@@ -213,6 +225,15 @@ export interface PromptHistoryResult {
     exclusions: PromptHistoryExclusion[];
     /** A bound left bytes or files unread; call again with the cursor to continue. */
     hasMore: boolean;
+    /**
+     * Sessions whose cursor entry this call added, advanced, moved, or dropped
+     * after a rewrite. Fetch them whole with `collectSessionPromptHistory({ sessionRefs })`.
+     */
+    changed?: PromptHistorySessionRef[];
+    /** Whether this call read past where the cursor stood for any session. */
+    progressed?: boolean;
+    /** Realpaths of the roots scanned, after worktree expansion. */
+    roots?: string[];
 }
 /** @internal */
 export declare const DEFAULT_BOUNDS: Required<PromptHistoryBounds>;
@@ -274,6 +295,17 @@ export interface FileOutcome {
 export declare function collectPromptHistory(options: CollectPromptHistoryOptions): Promise<PromptHistoryResult>;
 /** @internal */
 export declare function emptyStats(): PromptHistoryStats;
+/**
+ * True when a cursor entry's last pass reached the end of its file with no
+ * prompt still waiting for its answer: an unchanged file needs no read.
+ */
+export declare function isPromptHistorySessionSettled(session: PromptHistoryCursorSession): boolean;
+/**
+ * Validates a stored cursor (versions 1 to 3). Returns it as a version-3
+ * cursor with malformed session entries dropped, or undefined when it is
+ * not a cursor at all.
+ */
+export declare function parsePromptHistoryCursor(value: unknown): PromptHistoryCursor | undefined;
 /** @internal */
 export declare function compareStrings(left: string, right: string): number;
 /** @internal */