yepanywhere 0.1.0

package/dist/sessions/reader.js

@@ -0,0 +1,444 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { SESSION_TITLE_MAX_LENGTH, isIdeMetadata, stripIdeMetadata, } from "@yep-anywhere/shared";
+// Claude model context window size (200K tokens)
+const CONTEXT_WINDOW_SIZE = 200_000;
+import { getMessageContent, isConversationEntry, } from "@yep-anywhere/shared";
+import { buildDag, findOrphanedToolUses } from "./dag.js";
+/**
+ * Claude-specific session reader for Claude Code JSONL files.
+ *
+ * Handles Claude's DAG-based conversation structure with parentUuid,
+ * agent sessions, orphaned tool detection, and context window tracking.
+ */
+export class ClaudeSessionReader {
+    sessionDir;
+    constructor(options) {
+        this.sessionDir = options.sessionDir;
+    }
+    async listSessions(projectId) {
+        const summaries = [];
+        try {
+            const files = await readdir(this.sessionDir);
+            // Filter out agent-* files (internal subagent warmup sessions)
+            const jsonlFiles = files.filter((f) => f.endsWith(".jsonl") && !f.startsWith("agent-"));
+            for (const file of jsonlFiles) {
+                const sessionId = file.replace(".jsonl", "");
+                const summary = await this.getSessionSummary(sessionId, projectId);
+                if (summary) {
+                    summaries.push(summary);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+            return [];
+        }
+        // Sort by updatedAt descending
+        summaries.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+        return summaries;
+    }
+    async getSessionSummary(sessionId, projectId) {
+        const filePath = join(this.sessionDir, `${sessionId}.jsonl`);
+        try {
+            const content = await readFile(filePath, "utf-8");
+            const trimmed = content.trim();
+            // Skip empty files
+            if (!trimmed) {
+                return null;
+            }
+            const lines = trimmed.split("\n");
+            const messages = lines
+                .map((line) => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch {
+                    return null;
+                }
+            })
+                .filter((m) => m !== null);
+            // Build DAG and get active branch (filters out dead branches from rewinds, etc.)
+            const { activeBranch } = buildDag(messages);
+            // Filter active branch to user/assistant messages only
+            const conversationMessages = activeBranch
+                .filter((node) => node.raw.type === "user" || node.raw.type === "assistant")
+                .map((node) => node.raw);
+            // Skip sessions with no actual conversation messages (metadata-only files).
+            // Note: Newly created sessions may not have user/assistant messages yet (SDK writes async).
+            // These are handled separately in the projects route by adding owned processes.
+            if (conversationMessages.length === 0) {
+                return null;
+            }
+            const stats = await stat(filePath);
+            const firstUserMessage = this.findFirstUserMessage(messages);
+            const fullTitle = firstUserMessage?.trim() || null;
+            const contextUsage = this.extractContextUsage(conversationMessages);
+            const model = this.extractModel(conversationMessages);
+            return {
+                id: sessionId,
+                projectId,
+                title: this.extractTitle(firstUserMessage),
+                fullTitle,
+                createdAt: stats.birthtime.toISOString(),
+                updatedAt: stats.mtime.toISOString(),
+                messageCount: conversationMessages.length,
+                status: { state: "idle" }, // Will be updated by Supervisor
+                contextUsage,
+                provider: "claude",
+                model,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async getSession(sessionId, projectId, afterMessageId, _options) {
+        const summary = await this.getSessionSummary(sessionId, projectId);
+        if (!summary)
+            return null;
+        const filePath = join(this.sessionDir, `${sessionId}.jsonl`);
+        const content = await readFile(filePath, "utf-8");
+        const lines = content.trim().split("\n");
+        const rawMessages = [];
+        for (const line of lines) {
+            try {
+                rawMessages.push(JSON.parse(line));
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        // Filter messages for incremental fetching if needed
+        // Note: Raw messages might not have UUIDs if they are old format or haven't been normalized.
+        // But typically they do.
+        let finalMessages = rawMessages;
+        if (afterMessageId) {
+            const afterIndex = rawMessages.findIndex((m) => "uuid" in m && m.uuid === afterMessageId);
+            if (afterIndex !== -1) {
+                finalMessages = rawMessages.slice(afterIndex + 1);
+            }
+        }
+        return {
+            summary,
+            data: {
+                provider: "claude",
+                session: {
+                    messages: finalMessages,
+                },
+            },
+        };
+    }
+    /**
+     * Get agent session content for lazy-loading completed Tasks.
+     *
+     * Agent JSONL files are stored at: {sessionDir}/agent-{agentId}.jsonl
+     * They have the same format as parent session JSONL files.
+     *
+     * @param agentId - The agent session ID (used as filename: agent-{agentId}.jsonl)
+     * @returns Agent session with messages and inferred status
+     */
+    async getAgentSession(agentId) {
+        const filePath = join(this.sessionDir, `agent-${agentId}.jsonl`);
+        try {
+            const content = await readFile(filePath, "utf-8");
+            const trimmed = content.trim();
+            if (!trimmed) {
+                return { messages: [], status: "pending" };
+            }
+            const lines = trimmed.split("\n");
+            const rawMessages = [];
+            for (const line of lines) {
+                try {
+                    rawMessages.push(JSON.parse(line));
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+            // Build DAG and get active branch (filters out dead branches)
+            const { activeBranch } = buildDag(rawMessages);
+            // Don't include orphan detection for agent sessions
+            // (agents are subprocesses, we don't know their lifecycle)
+            const orphanedToolUses = new Set();
+            // Convert to Message objects
+            const messages = activeBranch.map((node, index) => this.convertMessage(node.raw, index, orphanedToolUses));
+            // Infer status from messages
+            const status = this.inferAgentStatus(messages);
+            return { messages, status };
+        }
+        catch {
+            // File doesn't exist or not readable - agent is pending
+            return { messages: [], status: "pending" };
+        }
+    }
+    /**
+     * Get mappings of toolUseId → agentId for all agent files in the session directory.
+     *
+     * This is used to find agent sessions for pending Tasks on page reload.
+     * It scans all agent-*.jsonl files and extracts the parent_tool_use_id from
+     * the first message or system message.
+     *
+     * @returns Array of toolUseId → agentId mappings
+     */
+    async getAgentMappings() {
+        const mappings = [];
+        try {
+            const files = await readdir(this.sessionDir);
+            const agentFiles = files.filter((f) => f.startsWith("agent-") && f.endsWith(".jsonl"));
+            for (const file of agentFiles) {
+                // Extract agentId from filename: agent-{agentId}.jsonl
+                const agentId = file.slice(6, -6); // Remove "agent-" prefix and ".jsonl" suffix
+                const filePath = join(this.sessionDir, file);
+                try {
+                    const content = await readFile(filePath, "utf-8");
+                    const trimmed = content.trim();
+                    if (!trimmed)
+                        continue;
+                    // Check first few lines for parent_tool_use_id
+                    const lines = trimmed.split("\n").slice(0, 5);
+                    for (const line of lines) {
+                        try {
+                            const msg = JSON.parse(line);
+                            if (msg.parent_tool_use_id) {
+                                mappings.push({
+                                    toolUseId: msg.parent_tool_use_id,
+                                    agentId,
+                                });
+                                break;
+                            }
+                        }
+                        catch {
+                            // Skip malformed lines
+                        }
+                    }
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+        }
+        return mappings;
+    }
+    /**
+     * Infer agent status from its messages.
+     *
+     * Status inference:
+     * - pending: no messages
+     * - failed: last message has is_error or error type
+     * - completed: has a 'result' type message
+     * - running: has messages but no result (still in progress or interrupted)
+     */
+    inferAgentStatus(messages) {
+        if (messages.length === 0) {
+            return "pending";
+        }
+        // Look for result message
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            if (!msg)
+                continue;
+            // Check for result type message (SDK's final message)
+            if (msg.type === "result") {
+                // Check for error in result
+                if ("is_error" in msg && msg.is_error === true) {
+                    return "failed";
+                }
+                return "completed";
+            }
+        }
+        // No result message - still running or interrupted
+        return "running";
+    }
+    findFirstUserMessage(messages) {
+        for (const msg of messages) {
+            if (msg.type === "user") {
+                const content = msg.message.content;
+                if (content) {
+                    // Content can be string or array of content blocks
+                    if (typeof content === "string") {
+                        return this.extractTitleContent(content);
+                    }
+                    // Filter to object blocks only (skip string items), cast for compatibility
+                    const objectBlocks = content.filter((b) => typeof b !== "string");
+                    return this.extractTitleContent(objectBlocks);
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract context usage from the last assistant message.
+     * Usage data is stored in message.usage with input_tokens, cache_read_input_tokens, etc.
+     */
+    extractContextUsage(messages) {
+        // Find the last assistant message (iterate backwards)
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            if (msg && msg.type === "assistant") {
+                const usage = msg.message.usage;
+                if (usage) {
+                    // Total input = fresh tokens + cached tokens + new cache creation
+                    const inputTokens = (usage.input_tokens ?? 0) +
+                        (usage.cache_read_input_tokens ?? 0) +
+                        (usage.cache_creation_input_tokens ?? 0);
+                    // Skip messages with zero input tokens (incomplete streaming messages)
+                    if (inputTokens === 0) {
+                        continue;
+                    }
+                    const percentage = Math.round((inputTokens / CONTEXT_WINDOW_SIZE) * 100);
+                    const result = { inputTokens, percentage };
+                    // Add optional fields if available
+                    if (usage.output_tokens !== undefined && usage.output_tokens > 0) {
+                        result.outputTokens = usage.output_tokens;
+                    }
+                    if (usage.cache_read_input_tokens !== undefined &&
+                        usage.cache_read_input_tokens > 0) {
+                        result.cacheReadTokens = usage.cache_read_input_tokens;
+                    }
+                    if (usage.cache_creation_input_tokens !== undefined &&
+                        usage.cache_creation_input_tokens > 0) {
+                        result.cacheCreationTokens = usage.cache_creation_input_tokens;
+                    }
+                    return result;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extract the model from the first assistant message.
+     * The model is stored in message.model (e.g., "claude-opus-4-5-20251101").
+     */
+    extractModel(messages) {
+        // Find the first assistant message with a model field
+        for (const msg of messages) {
+            if (msg.type === "assistant") {
+                const model = msg.message.model;
+                if (model) {
+                    return model;
+                }
+            }
+        }
+        return undefined;
+    }
+    extractTitle(content) {
+        if (!content)
+            return null;
+        const trimmed = content.trim();
+        if (trimmed.length <= SESSION_TITLE_MAX_LENGTH)
+            return trimmed;
+        return `${trimmed.slice(0, SESSION_TITLE_MAX_LENGTH - 3)}...`;
+    }
+    extractContent(content) {
+        if (typeof content === "string")
+            return content;
+        return content
+            .filter((block) => block.type === "text" && typeof block.text === "string")
+            .map((block) => block.text)
+            .join("\n");
+    }
+    /**
+     * Extract content for title generation, skipping IDE metadata blocks.
+     * This ensures session titles show the actual user message, not IDE metadata
+     * like <ide_opened_file> or <ide_selection> tags.
+     */
+    extractTitleContent(content) {
+        if (typeof content === "string") {
+            return stripIdeMetadata(content);
+        }
+        return content
+            .filter((block) => block.type === "text" &&
+            typeof block.text === "string" &&
+            !isIdeMetadata(block.text))
+            .map((block) => block.text)
+            .join("\n");
+    }
+    /**
+     * Get session summary only if the file has changed since the cached values.
+     * Used by SessionIndexService for cache invalidation.
+     *
+     * @param sessionId - The session ID
+     * @param projectId - The project ID
+     * @param cachedMtime - The mtime (ms since epoch) from the cache
+     * @param cachedSize - The file size (bytes) from the cache
+     * @returns Summary with file stats if changed, null if unchanged
+     */
+    async getSessionSummaryIfChanged(sessionId, projectId, cachedMtime, cachedSize) {
+        const filePath = join(this.sessionDir, `${sessionId}.jsonl`);
+        try {
+            const stats = await stat(filePath);
+            const mtime = stats.mtimeMs;
+            const size = stats.size;
+            // If mtime and size match cached values, return null (no change)
+            if (mtime === cachedMtime && size === cachedSize) {
+                return null;
+            }
+            // Otherwise parse the file and return { summary, mtime, size }
+            const summary = await this.getSessionSummary(sessionId, projectId);
+            if (!summary)
+                return null;
+            return { summary, mtime, size };
+        }
+        catch {
+            return null; // File doesn't exist or error
+        }
+    }
+    /**
+     * Convert a raw JSONL message to our Message format.
+     *
+     * We pass through all fields from JSONL without stripping.
+     * This preserves debugging info, DAG structure, and metadata.
+     * The only transformation is:
+     * - Normalize content blocks (pass through all fields)
+     * - Add computed orphanedToolUseIds
+     */
+    convertMessage(raw, _index, orphanedToolUses = new Set()) {
+        // Normalize content blocks - pass through all fields
+        let content;
+        const rawContent = getMessageContent(raw);
+        if (typeof rawContent === "string") {
+            content = rawContent;
+        }
+        else if (Array.isArray(rawContent)) {
+            // Pass through all fields from each content block
+            // Filter out string items (which can appear in user message content)
+            content = rawContent
+                .filter((block) => typeof block !== "string")
+                .map((block) => ({ ...block }));
+        }
+        // Build message by spreading all raw fields, then override with normalized values
+        // Use type assertion since we're converting to a looser Message type
+        const rawAny = raw;
+        const message = {
+            ...rawAny,
+            // Include normalized content if message had content
+            ...(isConversationEntry(raw) && {
+                message: {
+                    ...raw.message,
+                    ...(content !== undefined && { content }),
+                },
+            }),
+            // Ensure type is set
+            type: raw.type,
+        };
+        // Identify orphaned tool_use IDs in this message's content
+        if (Array.isArray(content)) {
+            const orphanedIds = content
+                .filter((b) => b.type === "tool_use" &&
+                typeof b.id === "string" &&
+                orphanedToolUses.has(b.id))
+                .map((b) => b.id);
+            if (orphanedIds.length > 0) {
+                message.orphanedToolUseIds = orphanedIds;
+            }
+        }
+        return message;
+    }
+}
+/** @deprecated Use ClaudeSessionReader */
+export const SessionReader = ClaudeSessionReader;
+//# sourceMappingURL=reader.js.map

package/dist/sessions/reader.js.map

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

package/dist/sessions/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Session reader interface for provider-agnostic session reading.
+ *
+ * Each provider (Claude, Codex, Gemini) has different JSONL formats,
+ * but all readers implement this interface to provide a common API.
+ */
+import type { UnifiedSession, UrlProjectId } from "@yep-anywhere/shared";
+import type { Message, SessionSummary } from "../supervisor/types.js";
+/**
+ * Options for reading a session.
+ */
+export interface GetSessionOptions {
+    /** Include orphaned tool use detection (default: true, only applicable for Claude) */
+    includeOrphans?: boolean;
+}
+export interface LoadedSession {
+    summary: SessionSummary;
+    data: UnifiedSession;
+}
+/**
+ * Common interface for session readers across providers.
+ *
+ * Provider-specific readers may have additional methods beyond this interface.
+ * For example, ClaudeSessionReader has getAgentSession() for subagent support.
+ */
+export interface ISessionReader {
+    /**
+     * List all sessions in this reader's session directory.
+     */
+    listSessions(projectId: UrlProjectId): Promise<SessionSummary[]>;
+    /**
+     * Get summary metadata for a single session.
+     */
+    getSessionSummary(sessionId: string, projectId: UrlProjectId): Promise<SessionSummary | null>;
+    /**
+     * Get full session with messages.
+     * @param sessionId - The session ID
+     * @param projectId - The project ID
+     * @param afterMessageId - Only return messages after this ID (for incremental fetching)
+     * @param options - Additional options
+     */
+    getSession(sessionId: string, projectId: UrlProjectId, afterMessageId?: string, options?: GetSessionOptions): Promise<LoadedSession | null>;
+    /**
+     * Get session summary only if the file has changed since cached values.
+     * Used for cache invalidation.
+     *
+     * @param sessionId - The session ID
+     * @param projectId - The project ID
+     * @param cachedMtime - The mtime (ms since epoch) from the cache
+     * @param cachedSize - The file size (bytes) from the cache
+     * @returns Summary with file stats if changed, null if unchanged
+     */
+    getSessionSummaryIfChanged(sessionId: string, projectId: UrlProjectId, cachedMtime: number, cachedSize: number): Promise<{
+        summary: SessionSummary;
+        mtime: number;
+        size: number;
+    } | null>;
+    /**
+     * Get mappings from tool use IDs to agent session IDs.
+     * Used for Claude's Task tool to link tool_use to subagent sessions.
+     * Non-Claude providers should return an empty array.
+     */
+    getAgentMappings(): Promise<{
+        toolUseId: string;
+        agentId: string;
+    }[]>;
+    /**
+     * Get an agent (subagent) session by ID.
+     * Used for Claude's Task tool subagent sessions (agent-*.jsonl files).
+     * Non-Claude providers should return null.
+     */
+    getAgentSession(agentId: string): Promise<{
+        messages: Message[];
+        status: string;
+    } | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sessions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAW,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEjE;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEjC;;;;;;;;;OASG;IACH,0BAA0B,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE5E;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAEtE;;;;OAIG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CAC5D"}

package/dist/sessions/types.js

@@ -0,0 +1,8 @@
+/**
+ * Session reader interface for provider-agnostic session reading.
+ *
+ * Each provider (Claude, Codex, Gemini) has different JSONL formats,
+ * but all readers implement this interface to provide a common API.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sessions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/supervisor/ExternalSessionTracker.d.ts

@@ -0,0 +1,94 @@
+import { type DirProjectId, type UrlProjectId } from "@yep-anywhere/shared";
+import type { ProjectScanner } from "../projects/scanner.js";
+import type { EventBus } from "../watcher/EventBus.js";
+import type { Supervisor } from "./Supervisor.js";
+import type { SessionSummary } from "./types.js";
+export interface ExternalSessionTrackerOptions {
+    eventBus: EventBus;
+    supervisor: Supervisor;
+    scanner: ProjectScanner;
+    /** Time in ms before external status decays to idle (default: 30000) */
+    decayMs?: number;
+    /** Grace period in ms after abort before external detection resumes (default: 30000) */
+    abortGraceMs?: number;
+    /** Optional callback to get session summary for new external sessions */
+    getSessionSummary?: (sessionId: string, projectId: UrlProjectId) => Promise<SessionSummary | null>;
+}
+/**
+ * Tracks sessions that are being modified by external programs (not owned by this app).
+ *
+ * Uses file change events to detect when a session file is modified, then checks
+ * if we own that session via Supervisor. If not owned, marks as "external" until
+ * the decay timeout passes with no activity.
+ */
+export declare class ExternalSessionTracker {
+    private externalSessions;
+    /** Sessions recently aborted by this server - grace period before external detection */
+    private recentlyAborted;
+    private eventBus;
+    private supervisor;
+    private scanner;
+    private decayMs;
+    private abortGraceMs;
+    private unsubscribe;
+    private getSessionSummary?;
+    /** Batches session parsing to prevent OOM from concurrent file reads */
+    private sessionParser;
+    /** Tracks sessions that have already emitted session-created */
+    private createdSessions;
+    /** Cache of last known session state for change detection */
+    private sessionStateCache;
+    constructor(options: ExternalSessionTrackerOptions);
+    private handleSessionAborted;
+    /**
+     * Check if a session is currently marked as external.
+     */
+    isExternal(sessionId: string): boolean;
+    /**
+     * Get info about an external session, or null if not external.
+     * Returns the directory-format projectId (for internal use only).
+     */
+    getExternalSessionInfo(sessionId: string): {
+        lastActivity: Date;
+        dirProjectId: DirProjectId;
+    } | null;
+    /**
+     * Get info about an external session with URL-format projectId.
+     * Use this for API responses and events.
+     */
+    getExternalSessionInfoWithUrlId(sessionId: string): Promise<{
+        lastActivity: Date;
+        projectId: UrlProjectId;
+    } | null>;
+    /**
+     * Mark a session as recently aborted. During the grace period, file changes
+     * won't trigger external session detection (they're from our own cleanup).
+     * Called by Supervisor when a process is aborted.
+     */
+    markAborted(sessionId: string): void;
+    /**
+     * Check if a session is within the abort grace period.
+     */
+    private isInAbortGracePeriod;
+    /**
+     * Get all currently external session IDs.
+     */
+    getExternalSessions(): string[];
+    /**
+     * Clean up resources.
+     */
+    dispose(): void;
+    private handleFileChange;
+    private parseSessionPath;
+    private handleCodexFileChange;
+    private extractCodexSessionId;
+    private readCodexProjectIdFromFile;
+    private readCodexSessionMeta;
+    private ensureCodexSessionCreated;
+    private markExternal;
+    private removeExternal;
+    private createDecayTimeout;
+    private emitStatusChangeByInfo;
+    private resolveProjectForSession;
+}
+//# sourceMappingURL=ExternalSessionTracker.d.ts.map

package/dist/supervisor/ExternalSessionTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalSessionTracker.d.ts","sourceRoot":"","sources":["../../src/supervisor/ExternalSessionTracker.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EAElB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAEV,QAAQ,EAMT,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AAiBhE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,CAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,KACpB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,gBAAgB,CAA+C;IACvE,wFAAwF;IACxF,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,iBAAiB,CAAC,CAGU;IACpC,wEAAwE;IACxE,OAAO,CAAC,aAAa,CAAwC;IAC7D,gEAAgE;IAChE,OAAO,CAAC,eAAe,CAA0B;IACjD,6DAA6D;IAC7D,OAAO,CAAC,iBAAiB,CAGX;gBAEF,OAAO,EAAE,6BAA6B;IAwHlD,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;;OAGG;IACH,sBAAsB,CACpB,SAAS,EAAE,MAAM,GAChB;QAAE,YAAY,EAAE,IAAI,CAAC;QAAC,YAAY,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAO5D;;;OAGG;IACG,+BAA+B,CACnC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,YAAY,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI,CAAC;IAwBlE;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMpC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,OAAO,IAAI,IAAI;YAiBD,gBAAgB;IA4C9B,OAAO,CAAC,gBAAgB;YAqCV,qBAAqB;IA6BnC,OAAO,CAAC,qBAAqB;YAQf,0BAA0B;YAQ1B,oBAAoB;YAiCpB,yBAAyB;IAqCvC,OAAO,CAAC,YAAY;IAsDpB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,kBAAkB;YAWZ,sBAAsB;YA0CtB,wBAAwB;CAoBvC"}