@ai-devkit/agent-manager 0.35.0 → 0.37.0

package/dist/harnesses/codex/CodexSessionLocator.d.ts

@@ -0,0 +1,74 @@
+import type { ProcessInfo } from "../../adapters/AgentAdapter.js";
+import { type MatchResult } from "../../utils/matching.js";
+import { type SessionFile } from "../../utils/session.js";
+import { CodexSessionParser } from "./CodexSessionParser.js";
+export interface CodexDirectMatch {
+    process: ProcessInfo;
+    sessionFile: SessionFile;
+}
+export interface CodexProcessSessionMatches {
+    direct: CodexDirectMatch[];
+    legacyMatches: MatchResult[];
+    fallback: ProcessInfo[];
+}
+export interface CodexDiscoveredSessions {
+    sessions: SessionFile[];
+}
+export interface CodexSessionLocatorOptions {
+    sessionsDir?: string;
+    /** Clock used for negative-cache re-checks. Defaults to `Date.now`. */
+    now?: () => number;
+}
+/** Upper bound of bytes read from a session file to find its `session_meta` line. */
+export declare const SESSION_META_HEAD_MAX_BYTES: number;
+/** Unmatched processes are re-scanned at least this often, even when their date dirs are unchanged. */
+export declare const UNMATCHED_PROCESS_RECHECK_MS = 30000;
+export declare class CodexSessionLocator {
+    private readonly parser;
+    private readonly sessionsDir;
+    private readonly now;
+    /** `session_meta` is written once at the head of an append-only file, so it is cached by path + inode. */
+    private readonly sessionMetaCache;
+    /** `(pid, startTime)` of processes that matched no session, keyed to their date-dir mtimes. */
+    private readonly unmatchedProcesses;
+    constructor(options?: CodexSessionLocatorOptions, parser?: CodexSessionParser);
+    matchRunningProcesses(processes: ProcessInfo[]): CodexProcessSessionMatches;
+    tryResumeMatching(processes: ProcessInfo[]): {
+        direct: CodexDirectMatch[];
+        fallback: ProcessInfo[];
+    };
+    discoverLiveSessions(processes: ProcessInfo[]): CodexDiscoveredSessions;
+    discoverSessionFilesInDateDirs(dateDirs: string[]): CodexDiscoveredSessions;
+    discoverHistoricalSessionFiles(): string[];
+    findSessionFileById(sessionId: string): SessionFile | null;
+    collectAllSessionFiles(): string[];
+    private extractResumeSessionId;
+    private getCandidateSessionFiles;
+    /**
+     * Read `session_meta` from at most {@link SESSION_META_HEAD_MAX_BYTES} of the
+     * file head. Cached per path while the inode is unchanged and the file has
+     * not shrunk below the parsed head, so growing session files are not re-read.
+     */
+    private readSessionMeta;
+    private isSessionMetaCacheValid;
+    private parseSessionMetaHead;
+    /**
+     * Best-effort extraction for a `session_meta` line longer than the head limit
+     * (e.g. large embedded instructions). `id`, `timestamp` and `cwd` precede the
+     * bulky payload fields, so they are read from the payload prefix.
+     */
+    private parseTruncatedSessionMeta;
+    private pruneSessionMetaCache;
+    private isKnownUnmatched;
+    private updateUnmatchedProcesses;
+    private toProcessKey;
+    /** Day-window directories with their mtimes; changes when session files are added or removed. */
+    private getDateDirSignature;
+    private getProcessDayKeys;
+    private getDateDirs;
+    private getDateDirsAroundDate;
+    private toSessionDayKey;
+    private tryParseUuidV7Date;
+    private collectSessionFilesInDateDirs;
+}
+//# sourceMappingURL=CodexSessionLocator.d.ts.map

package/dist/harnesses/codex/CodexSessionLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodexSessionLocator.d.ts","sourceRoot":"","sources":["../../../src/harnesses/codex/CodexSessionLocator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAwB,MAAM,yBAAyB,CAAC;AAGnF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAGD,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,QAAY,CAAC;AAErD,uGAAuG;AACvG,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAiCnD,qBAAa,mBAAmB;IAU5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IATzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,0GAA0G;IAC1G,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4C;IAC7E,+FAA+F;IAC/F,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA4C;gBAG7E,OAAO,GAAE,0BAA+B,EACvB,MAAM,GAAE,kBAA6C;IAMxE,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,0BAA0B;IAqB3E,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG;QAC3C,MAAM,EAAE,gBAAgB,EAAE,CAAC;QAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;KACzB;IAuBD,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,uBAAuB;IAWvE,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,uBAAuB;IAiB3E,8BAA8B,IAAI,MAAM,EAAE;IAI1C,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAsB1D,sBAAsB,IAAI,MAAM,EAAE;IA0BlC,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,wBAAwB;IAShC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,oBAAoB;IAiB5B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAcjC,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,wBAAwB;IA0BhC,OAAO,CAAC,YAAY;IAIpB,iGAAiG;IACjG,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,6BAA6B;CAYtC"}

package/dist/harnesses/codex/CodexSessionLocator.js

@@ -0,0 +1,359 @@
+import * as fs from "fs";
+import * as path from "path";
+import { matchProcessesToSessions } from "../../utils/matching.js";
+import { batchGetSessionFileBirthtimes, isDirectory, safeReaddir, safeStat } from "../../utils/session.js";
+import { CodexSessionParser } from "./CodexSessionParser.js";
+import { homeDir } from "../shared.js";
+const PROCESS_START_DAY_WINDOW_DAYS = 1;
+/** Upper bound of bytes read from a session file to find its `session_meta` line. */ export const SESSION_META_HEAD_MAX_BYTES = 64 * 1024;
+const SESSION_META_HEAD_CHUNK_BYTES = 16 * 1024;
+/** Unmatched processes are re-scanned at least this often, even when their date dirs are unchanged. */ export const UNMATCHED_PROCESS_RECHECK_MS = 30_000;
+export class CodexSessionLocator {
+    parser;
+    sessionsDir;
+    now;
+    /** `session_meta` is written once at the head of an append-only file, so it is cached by path + inode. */ sessionMetaCache = new Map();
+    /** `(pid, startTime)` of processes that matched no session, keyed to their date-dir mtimes. */ unmatchedProcesses = new Map();
+    constructor(options = {}, parser = new CodexSessionParser()){
+        this.parser = parser;
+        this.sessionsDir = options.sessionsDir ?? path.join(homeDir(), ".codex", "sessions");
+        this.now = options.now ?? Date.now;
+    }
+    matchRunningProcesses(processes) {
+        const { direct, fallback } = this.tryResumeMatching(processes);
+        const nowMs = this.now();
+        const signatures = new Map(fallback.map((proc)=>[
+                proc,
+                this.getDateDirSignature(proc)
+            ]));
+        const candidates = fallback.filter((proc)=>!this.isKnownUnmatched(proc, signatures.get(proc) ?? "", nowMs));
+        const { sessions } = this.discoverLiveSessions(candidates);
+        const legacyMatches = candidates.length > 0 && sessions.length > 0 ? matchProcessesToSessions(candidates, sessions) : [];
+        this.updateUnmatchedProcesses(fallback, candidates, legacyMatches, signatures, nowMs);
+        return {
+            direct,
+            legacyMatches,
+            fallback
+        };
+    }
+    tryResumeMatching(processes) {
+        const direct = [];
+        const fallback = [];
+        for (const proc of processes){
+            const sessionId = this.extractResumeSessionId(proc.command);
+            if (!sessionId) {
+                fallback.push(proc);
+                continue;
+            }
+            const sessionFile = this.findSessionFileById(sessionId);
+            if (!sessionFile) {
+                fallback.push(proc);
+                continue;
+            }
+            direct.push({
+                process: proc,
+                sessionFile
+            });
+        }
+        return {
+            direct,
+            fallback
+        };
+    }
+    discoverLiveSessions(processes) {
+        const empty = {
+            sessions: []
+        };
+        if (processes.length === 0) return empty;
+        if (!fs.existsSync(this.sessionsDir)) return empty;
+        const dateDirs = this.getDateDirs(processes);
+        if (dateDirs.length === 0) return empty;
+        return this.discoverSessionFilesInDateDirs(dateDirs);
+    }
+    discoverSessionFilesInDateDirs(dateDirs) {
+        const files = batchGetSessionFileBirthtimes(dateDirs);
+        this.pruneSessionMetaCache(dateDirs, files);
+        for (const file of files){
+            const meta = this.readSessionMeta(file.filePath);
+            if (!meta) continue;
+            file.resolvedCwd = meta.cwd;
+            if (meta.timestampMs !== null) {
+                file.birthtimeMs = meta.timestampMs;
+            }
+        }
+        return {
+            sessions: files
+        };
+    }
+    discoverHistoricalSessionFiles() {
+        return this.collectAllSessionFiles();
+    }
+    findSessionFileById(sessionId) {
+        for (const filePath of this.getCandidateSessionFiles(sessionId)){
+            if (!path.basename(filePath).includes(sessionId)) continue;
+            const meta = this.readSessionMeta(filePath);
+            if (!meta || meta.id !== sessionId) continue;
+            const stat = safeStat(filePath);
+            if (!stat) continue;
+            return {
+                sessionId,
+                filePath,
+                projectDir: path.dirname(filePath),
+                birthtimeMs: meta.timestampMs ?? stat.birthtimeMs,
+                resolvedCwd: meta.cwd
+            };
+        }
+        return null;
+    }
+    collectAllSessionFiles() {
+        const out = [];
+        for (const yearEntry of safeReaddir(this.sessionsDir)){
+            const yearDir = path.join(this.sessionsDir, yearEntry);
+            if (!isDirectory(yearDir)) continue;
+            for (const monthEntry of safeReaddir(yearDir)){
+                const monthDir = path.join(yearDir, monthEntry);
+                if (!isDirectory(monthDir)) continue;
+                for (const dayEntry of safeReaddir(monthDir)){
+                    const dayDir = path.join(monthDir, dayEntry);
+                    if (!isDirectory(dayDir)) continue;
+                    for (const fileEntry of safeReaddir(dayDir)){
+                        if (!fileEntry.endsWith(".jsonl")) continue;
+                        out.push(path.join(dayDir, fileEntry));
+                    }
+                }
+            }
+        }
+        return out;
+    }
+    extractResumeSessionId(command) {
+        const match = command.match(/(?:^|\s)resume\s+([0-9a-f-]{36})(?:\s|$)/i);
+        return match?.[1] ?? null;
+    }
+    getCandidateSessionFiles(sessionId) {
+        const sessionDate = this.tryParseUuidV7Date(sessionId);
+        if (!sessionDate) return this.collectAllSessionFiles();
+        return this.collectSessionFilesInDateDirs(this.getDateDirsAroundDate(sessionDate, PROCESS_START_DAY_WINDOW_DAYS));
+    }
+    /**
+   * Read `session_meta` from at most {@link SESSION_META_HEAD_MAX_BYTES} of the
+   * file head. Cached per path while the inode is unchanged and the file has
+   * not shrunk below the parsed head, so growing session files are not re-read.
+   */ readSessionMeta(filePath) {
+        const stat = safeStat(filePath);
+        if (!stat) return null;
+        const cached = this.sessionMetaCache.get(filePath);
+        if (cached && this.isSessionMetaCacheValid(cached, stat)) return cached.meta;
+        const head = readFileHead(filePath, SESSION_META_HEAD_MAX_BYTES);
+        if (!head) {
+            this.sessionMetaCache.delete(filePath);
+            return null;
+        }
+        const meta = this.parseSessionMetaHead(head);
+        this.sessionMetaCache.set(filePath, {
+            dev: stat.dev,
+            ino: stat.ino,
+            headBytes: head.bytes,
+            headFinal: head.complete || head.truncated,
+            meta
+        });
+        return meta;
+    }
+    isSessionMetaCacheValid(entry, stat) {
+        if (entry.dev !== stat.dev || entry.ino !== stat.ino) return false;
+        return entry.headFinal ? stat.size >= entry.headBytes : stat.size === entry.headBytes;
+    }
+    parseSessionMetaHead(head) {
+        const line = head.text.trim();
+        if (!line) return null;
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed.type !== "session_meta") return null;
+            return {
+                id: parsed.payload?.id,
+                cwd: parsed.payload?.cwd || "",
+                timestampMs: this.parser.parseMetaTimestampMs(parsed.payload?.timestamp)
+            };
+        } catch  {
+            return head.truncated ? this.parseTruncatedSessionMeta(line) : null;
+        }
+    }
+    /**
+   * Best-effort extraction for a `session_meta` line longer than the head limit
+   * (e.g. large embedded instructions). `id`, `timestamp` and `cwd` precede the
+   * bulky payload fields, so they are read from the payload prefix.
+   */ parseTruncatedSessionMeta(line) {
+        if (!/"type"\s*:\s*"session_meta"/.test(line)) return null;
+        const payloadStart = line.search(/"payload"\s*:\s*\{/);
+        if (payloadStart < 0) return null;
+        const payload = line.slice(payloadStart);
+        return {
+            id: extractJsonStringField(payload, "id"),
+            cwd: extractJsonStringField(payload, "cwd") || "",
+            timestampMs: this.parser.parseMetaTimestampMs(extractJsonStringField(payload, "timestamp"))
+        };
+    }
+    pruneSessionMetaCache(dateDirs, files) {
+        const scannedDirs = new Set(dateDirs);
+        const present = new Set(files.map((file)=>file.filePath));
+        for (const filePath of this.sessionMetaCache.keys()){
+            if (scannedDirs.has(path.dirname(filePath)) && !present.has(filePath)) {
+                this.sessionMetaCache.delete(filePath);
+            }
+        }
+    }
+    isKnownUnmatched(proc, dateDirSignature, nowMs) {
+        const entry = this.unmatchedProcesses.get(this.toProcessKey(proc));
+        if (!entry) return false;
+        if (nowMs - entry.checkedAtMs >= UNMATCHED_PROCESS_RECHECK_MS) return false;
+        return entry.dateDirSignature === dateDirSignature;
+    }
+    updateUnmatchedProcesses(fallback, scanned, legacyMatches, signatures, nowMs) {
+        const liveKeys = new Set(fallback.map((proc)=>this.toProcessKey(proc)));
+        for (const key of this.unmatchedProcesses.keys()){
+            if (!liveKeys.has(key)) this.unmatchedProcesses.delete(key);
+        }
+        const matchedPids = new Set(legacyMatches.map((match)=>match.process.pid));
+        for (const proc of scanned){
+            const key = this.toProcessKey(proc);
+            if (matchedPids.has(proc.pid)) {
+                this.unmatchedProcesses.delete(key);
+            } else {
+                this.unmatchedProcesses.set(key, {
+                    checkedAtMs: nowMs,
+                    dateDirSignature: signatures.get(proc) ?? ""
+                });
+            }
+        }
+    }
+    toProcessKey(proc) {
+        return `${proc.pid}:${proc.startTime?.getTime() ?? "unknown"}`;
+    }
+    /** Day-window directories with their mtimes; changes when session files are added or removed. */ getDateDirSignature(proc) {
+        return this.getProcessDayKeys(proc).map((dayKey)=>{
+            const stat = safeStat(path.join(this.sessionsDir, dayKey));
+            return `${dayKey}=${stat?.isDirectory() ? stat.mtimeMs : "-"}`;
+        }).join("|");
+    }
+    getProcessDayKeys(proc) {
+        const startTime = proc.startTime || new Date();
+        const dayKeys = [];
+        for(let offset = -PROCESS_START_DAY_WINDOW_DAYS; offset <= PROCESS_START_DAY_WINDOW_DAYS; offset++){
+            const day = new Date(startTime.getTime());
+            day.setDate(day.getDate() + offset);
+            dayKeys.push(this.toSessionDayKey(day));
+        }
+        return dayKeys;
+    }
+    getDateDirs(processes) {
+        const dayKeys = new Set();
+        for (const proc of processes){
+            for (const dayKey of this.getProcessDayKeys(proc)){
+                dayKeys.add(dayKey);
+            }
+        }
+        const dirs = [];
+        for (const dayKey of dayKeys){
+            const dayDir = path.join(this.sessionsDir, dayKey);
+            try {
+                if (fs.statSync(dayDir).isDirectory()) {
+                    dirs.push(dayDir);
+                }
+            } catch  {
+                continue;
+            }
+        }
+        return dirs;
+    }
+    getDateDirsAroundDate(date, windowDays) {
+        const dirs = [];
+        for(let offset = -windowDays; offset <= windowDays; offset++){
+            const day = new Date(date.getTime());
+            day.setDate(day.getDate() + offset);
+            const dayDir = path.join(this.sessionsDir, this.toSessionDayKey(day));
+            if (isDirectory(dayDir)) {
+                dirs.push(dayDir);
+            }
+        }
+        return dirs;
+    }
+    toSessionDayKey(date) {
+        const yyyy = String(date.getFullYear()).padStart(4, "0");
+        const mm = String(date.getMonth() + 1).padStart(2, "0");
+        const dd = String(date.getDate()).padStart(2, "0");
+        return path.join(yyyy, mm, dd);
+    }
+    tryParseUuidV7Date(sessionId) {
+        const match = sessionId.match(/^([0-9a-f]{8})-([0-9a-f]{4})-7[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
+        if (!match) return null;
+        const timestampMs = Number.parseInt(`${match[1]}${match[2]}`, 16);
+        if (!Number.isSafeInteger(timestampMs) || timestampMs <= 0) return null;
+        const date = new Date(timestampMs);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    collectSessionFilesInDateDirs(dateDirs) {
+        const out = [];
+        for (const dayDir of dateDirs){
+            for (const fileEntry of safeReaddir(dayDir)){
+                if (!fileEntry.endsWith(".jsonl")) continue;
+                out.push(path.join(dayDir, fileEntry));
+            }
+        }
+        return out;
+    }
+}
+/**
+ * Read the first line of a file, consuming at most `maxBytes`.
+ * Returns `null` when the file cannot be opened or read.
+ */ function readFileHead(filePath, maxBytes) {
+    let fd;
+    try {
+        fd = fs.openSync(filePath, "r");
+    } catch  {
+        return null;
+    }
+    try {
+        const buffer = Buffer.alloc(maxBytes);
+        let total = 0;
+        while(total < maxBytes){
+            const length = Math.min(SESSION_META_HEAD_CHUNK_BYTES, maxBytes - total);
+            const read = fs.readSync(fd, buffer, total, length, total);
+            if (read <= 0) break;
+            const newlineIndex = buffer.indexOf(0x0a, total);
+            total += read;
+            if (newlineIndex >= 0 && newlineIndex < total) {
+                return {
+                    text: buffer.toString("utf-8", 0, newlineIndex),
+                    bytes: newlineIndex + 1,
+                    complete: true,
+                    truncated: false
+                };
+            }
+        }
+        return {
+            text: buffer.toString("utf-8", 0, total),
+            bytes: total,
+            complete: false,
+            truncated: total >= maxBytes
+        };
+    } catch  {
+        return null;
+    } finally{
+        try {
+            fs.closeSync(fd);
+        } catch  {
+        // Ignore close errors
+        }
+    }
+}
+/** Extract the first `"field": "<json string>"` value from a JSON fragment. */ function extractJsonStringField(fragment, field) {
+    const match = fragment.match(new RegExp(`"${field}"\\s*:\\s*("(?:[^"\\\\]|\\\\.)*")`));
+    if (!match) return undefined;
+    try {
+        const value = JSON.parse(match[1]);
+        return typeof value === "string" ? value : undefined;
+    } catch  {
+        return undefined;
+    }
+}
+
+//# sourceMappingURL=CodexSessionLocator.js.map

package/dist/harnesses/codex/CodexSessionLocator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/codex/CodexSessionLocator.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport type { ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { matchProcessesToSessions, type MatchResult } from \"../../utils/matching.js\";\nimport {\n  batchGetSessionFileBirthtimes,\n  isDirectory,\n  safeReaddir,\n  safeStat,\n  type SessionFile,\n} from \"../../utils/session.js\";\nimport { CodexSessionParser, type CodexEventEntry } from \"./CodexSessionParser.js\";\nimport { homeDir } from \"../shared.js\";\n\nexport interface CodexDirectMatch {\n  process: ProcessInfo;\n  sessionFile: SessionFile;\n}\n\nexport interface CodexProcessSessionMatches {\n  direct: CodexDirectMatch[];\n  legacyMatches: MatchResult[];\n  fallback: ProcessInfo[];\n}\n\nexport interface CodexDiscoveredSessions {\n  sessions: SessionFile[];\n}\n\nexport interface CodexSessionLocatorOptions {\n  sessionsDir?: string;\n  /** Clock used for negative-cache re-checks. Defaults to `Date.now`. */\n  now?: () => number;\n}\n\nconst PROCESS_START_DAY_WINDOW_DAYS = 1;\n/** Upper bound of bytes read from a session file to find its `session_meta` line. */\nexport const SESSION_META_HEAD_MAX_BYTES = 64 * 1024;\nconst SESSION_META_HEAD_CHUNK_BYTES = 16 * 1024;\n/** Unmatched processes are re-scanned at least this often, even when their date dirs are unchanged. */\nexport const UNMATCHED_PROCESS_RECHECK_MS = 30_000;\n\ninterface SessionMetaHead {\n  id?: string;\n  cwd: string;\n  timestampMs: number | null;\n}\n\ninterface SessionMetaCacheEntry {\n  dev: number;\n  ino: number;\n  /** Bytes of the file head the metadata was parsed from. */\n  headBytes: number;\n  /** True once the head can no longer change (newline seen or byte limit reached). */\n  headFinal: boolean;\n  meta: SessionMetaHead | null;\n}\n\ninterface UnmatchedProcessEntry {\n  checkedAtMs: number;\n  dateDirSignature: string;\n}\n\ninterface FileHead {\n  text: string;\n  /** Bytes consumed by the first line (including its newline), or all bytes read. */\n  bytes: number;\n  /** A newline terminated the first line. */\n  complete: boolean;\n  /** The byte limit was reached before a newline. */\n  truncated: boolean;\n}\n\nexport class CodexSessionLocator {\n  private readonly sessionsDir: string;\n  private readonly now: () => number;\n  /** `session_meta` is written once at the head of an append-only file, so it is cached by path + inode. */\n  private readonly sessionMetaCache = new Map<string, SessionMetaCacheEntry>();\n  /** `(pid, startTime)` of processes that matched no session, keyed to their date-dir mtimes. */\n  private readonly unmatchedProcesses = new Map<string, UnmatchedProcessEntry>();\n\n  constructor(\n    options: CodexSessionLocatorOptions = {},\n    private readonly parser: CodexSessionParser = new CodexSessionParser(),\n  ) {\n    this.sessionsDir = options.sessionsDir ?? path.join(homeDir(), \".codex\", \"sessions\");\n    this.now = options.now ?? Date.now;\n  }\n\n  matchRunningProcesses(processes: ProcessInfo[]): CodexProcessSessionMatches {\n    const { direct, fallback } = this.tryResumeMatching(processes);\n    const nowMs = this.now();\n    const signatures = new Map(\n      fallback.map((proc) => [proc, this.getDateDirSignature(proc)] as const),\n    );\n    const candidates = fallback.filter(\n      (proc) => !this.isKnownUnmatched(proc, signatures.get(proc) ?? \"\", nowMs),\n    );\n\n    const { sessions } = this.discoverLiveSessions(candidates);\n    const legacyMatches =\n      candidates.length > 0 && sessions.length > 0\n        ? matchProcessesToSessions(candidates, sessions)\n        : [];\n\n    this.updateUnmatchedProcesses(fallback, candidates, legacyMatches, signatures, nowMs);\n\n    return { direct, legacyMatches, fallback };\n  }\n\n  tryResumeMatching(processes: ProcessInfo[]): {\n    direct: CodexDirectMatch[];\n    fallback: ProcessInfo[];\n  } {\n    const direct: CodexDirectMatch[] = [];\n    const fallback: ProcessInfo[] = [];\n\n    for (const proc of processes) {\n      const sessionId = this.extractResumeSessionId(proc.command);\n      if (!sessionId) {\n        fallback.push(proc);\n        continue;\n      }\n\n      const sessionFile = this.findSessionFileById(sessionId);\n      if (!sessionFile) {\n        fallback.push(proc);\n        continue;\n      }\n\n      direct.push({ process: proc, sessionFile });\n    }\n\n    return { direct, fallback };\n  }\n\n  discoverLiveSessions(processes: ProcessInfo[]): CodexDiscoveredSessions {\n    const empty = { sessions: [] };\n    if (processes.length === 0) return empty;\n    if (!fs.existsSync(this.sessionsDir)) return empty;\n\n    const dateDirs = this.getDateDirs(processes);\n    if (dateDirs.length === 0) return empty;\n\n    return this.discoverSessionFilesInDateDirs(dateDirs);\n  }\n\n  discoverSessionFilesInDateDirs(dateDirs: string[]): CodexDiscoveredSessions {\n    const files = batchGetSessionFileBirthtimes(dateDirs);\n    this.pruneSessionMetaCache(dateDirs, files);\n\n    for (const file of files) {\n      const meta = this.readSessionMeta(file.filePath);\n      if (!meta) continue;\n\n      file.resolvedCwd = meta.cwd;\n      if (meta.timestampMs !== null) {\n        file.birthtimeMs = meta.timestampMs;\n      }\n    }\n\n    return { sessions: files };\n  }\n\n  discoverHistoricalSessionFiles(): string[] {\n    return this.collectAllSessionFiles();\n  }\n\n  findSessionFileById(sessionId: string): SessionFile | null {\n    for (const filePath of this.getCandidateSessionFiles(sessionId)) {\n      if (!path.basename(filePath).includes(sessionId)) continue;\n\n      const meta = this.readSessionMeta(filePath);\n      if (!meta || meta.id !== sessionId) continue;\n\n      const stat = safeStat(filePath);\n      if (!stat) continue;\n\n      return {\n        sessionId,\n        filePath,\n        projectDir: path.dirname(filePath),\n        birthtimeMs: meta.timestampMs ?? stat.birthtimeMs,\n        resolvedCwd: meta.cwd,\n      };\n    }\n\n    return null;\n  }\n\n  collectAllSessionFiles(): string[] {\n    const out: string[] = [];\n\n    for (const yearEntry of safeReaddir(this.sessionsDir)) {\n      const yearDir = path.join(this.sessionsDir, yearEntry);\n      if (!isDirectory(yearDir)) continue;\n\n      for (const monthEntry of safeReaddir(yearDir)) {\n        const monthDir = path.join(yearDir, monthEntry);\n        if (!isDirectory(monthDir)) continue;\n\n        for (const dayEntry of safeReaddir(monthDir)) {\n          const dayDir = path.join(monthDir, dayEntry);\n          if (!isDirectory(dayDir)) continue;\n\n          for (const fileEntry of safeReaddir(dayDir)) {\n            if (!fileEntry.endsWith(\".jsonl\")) continue;\n            out.push(path.join(dayDir, fileEntry));\n          }\n        }\n      }\n    }\n\n    return out;\n  }\n\n  private extractResumeSessionId(command: string): string | null {\n    const match = command.match(/(?:^|\\s)resume\\s+([0-9a-f-]{36})(?:\\s|$)/i);\n    return match?.[1] ?? null;\n  }\n\n  private getCandidateSessionFiles(sessionId: string): string[] {\n    const sessionDate = this.tryParseUuidV7Date(sessionId);\n    if (!sessionDate) return this.collectAllSessionFiles();\n\n    return this.collectSessionFilesInDateDirs(\n      this.getDateDirsAroundDate(sessionDate, PROCESS_START_DAY_WINDOW_DAYS),\n    );\n  }\n\n  /**\n   * Read `session_meta` from at most {@link SESSION_META_HEAD_MAX_BYTES} of the\n   * file head. Cached per path while the inode is unchanged and the file has\n   * not shrunk below the parsed head, so growing session files are not re-read.\n   */\n  private readSessionMeta(filePath: string): SessionMetaHead | null {\n    const stat = safeStat(filePath);\n    if (!stat) return null;\n\n    const cached = this.sessionMetaCache.get(filePath);\n    if (cached && this.isSessionMetaCacheValid(cached, stat)) return cached.meta;\n\n    const head = readFileHead(filePath, SESSION_META_HEAD_MAX_BYTES);\n    if (!head) {\n      this.sessionMetaCache.delete(filePath);\n      return null;\n    }\n\n    const meta = this.parseSessionMetaHead(head);\n    this.sessionMetaCache.set(filePath, {\n      dev: stat.dev,\n      ino: stat.ino,\n      headBytes: head.bytes,\n      headFinal: head.complete || head.truncated,\n      meta,\n    });\n    return meta;\n  }\n\n  private isSessionMetaCacheValid(entry: SessionMetaCacheEntry, stat: fs.Stats): boolean {\n    if (entry.dev !== stat.dev || entry.ino !== stat.ino) return false;\n    return entry.headFinal ? stat.size >= entry.headBytes : stat.size === entry.headBytes;\n  }\n\n  private parseSessionMetaHead(head: FileHead): SessionMetaHead | null {\n    const line = head.text.trim();\n    if (!line) return null;\n\n    try {\n      const parsed = JSON.parse(line) as CodexEventEntry;\n      if (parsed.type !== \"session_meta\") return null;\n      return {\n        id: parsed.payload?.id,\n        cwd: parsed.payload?.cwd || \"\",\n        timestampMs: this.parser.parseMetaTimestampMs(parsed.payload?.timestamp),\n      };\n    } catch {\n      return head.truncated ? this.parseTruncatedSessionMeta(line) : null;\n    }\n  }\n\n  /**\n   * Best-effort extraction for a `session_meta` line longer than the head limit\n   * (e.g. large embedded instructions). `id`, `timestamp` and `cwd` precede the\n   * bulky payload fields, so they are read from the payload prefix.\n   */\n  private parseTruncatedSessionMeta(line: string): SessionMetaHead | null {\n    if (!/\"type\"\\s*:\\s*\"session_meta\"/.test(line)) return null;\n\n    const payloadStart = line.search(/\"payload\"\\s*:\\s*\\{/);\n    if (payloadStart < 0) return null;\n    const payload = line.slice(payloadStart);\n\n    return {\n      id: extractJsonStringField(payload, \"id\"),\n      cwd: extractJsonStringField(payload, \"cwd\") || \"\",\n      timestampMs: this.parser.parseMetaTimestampMs(extractJsonStringField(payload, \"timestamp\")),\n    };\n  }\n\n  private pruneSessionMetaCache(dateDirs: string[], files: SessionFile[]): void {\n    const scannedDirs = new Set(dateDirs);\n    const present = new Set(files.map((file) => file.filePath));\n    for (const filePath of this.sessionMetaCache.keys()) {\n      if (scannedDirs.has(path.dirname(filePath)) && !present.has(filePath)) {\n        this.sessionMetaCache.delete(filePath);\n      }\n    }\n  }\n\n  private isKnownUnmatched(proc: ProcessInfo, dateDirSignature: string, nowMs: number): boolean {\n    const entry = this.unmatchedProcesses.get(this.toProcessKey(proc));\n    if (!entry) return false;\n    if (nowMs - entry.checkedAtMs >= UNMATCHED_PROCESS_RECHECK_MS) return false;\n    return entry.dateDirSignature === dateDirSignature;\n  }\n\n  private updateUnmatchedProcesses(\n    fallback: ProcessInfo[],\n    scanned: ProcessInfo[],\n    legacyMatches: MatchResult[],\n    signatures: Map<ProcessInfo, string>,\n    nowMs: number,\n  ): void {\n    const liveKeys = new Set(fallback.map((proc) => this.toProcessKey(proc)));\n    for (const key of this.unmatchedProcesses.keys()) {\n      if (!liveKeys.has(key)) this.unmatchedProcesses.delete(key);\n    }\n\n    const matchedPids = new Set(legacyMatches.map((match) => match.process.pid));\n    for (const proc of scanned) {\n      const key = this.toProcessKey(proc);\n      if (matchedPids.has(proc.pid)) {\n        this.unmatchedProcesses.delete(key);\n      } else {\n        this.unmatchedProcesses.set(key, {\n          checkedAtMs: nowMs,\n          dateDirSignature: signatures.get(proc) ?? \"\",\n        });\n      }\n    }\n  }\n\n  private toProcessKey(proc: ProcessInfo): string {\n    return `${proc.pid}:${proc.startTime?.getTime() ?? \"unknown\"}`;\n  }\n\n  /** Day-window directories with their mtimes; changes when session files are added or removed. */\n  private getDateDirSignature(proc: ProcessInfo): string {\n    return this.getProcessDayKeys(proc)\n      .map((dayKey) => {\n        const stat = safeStat(path.join(this.sessionsDir, dayKey));\n        return `${dayKey}=${stat?.isDirectory() ? stat.mtimeMs : \"-\"}`;\n      })\n      .join(\"|\");\n  }\n\n  private getProcessDayKeys(proc: ProcessInfo): string[] {\n    const startTime = proc.startTime || new Date();\n    const dayKeys: string[] = [];\n\n    for (\n      let offset = -PROCESS_START_DAY_WINDOW_DAYS;\n      offset <= PROCESS_START_DAY_WINDOW_DAYS;\n      offset++\n    ) {\n      const day = new Date(startTime.getTime());\n      day.setDate(day.getDate() + offset);\n      dayKeys.push(this.toSessionDayKey(day));\n    }\n\n    return dayKeys;\n  }\n\n  private getDateDirs(processes: ProcessInfo[]): string[] {\n    const dayKeys = new Set<string>();\n\n    for (const proc of processes) {\n      for (const dayKey of this.getProcessDayKeys(proc)) {\n        dayKeys.add(dayKey);\n      }\n    }\n\n    const dirs: string[] = [];\n    for (const dayKey of dayKeys) {\n      const dayDir = path.join(this.sessionsDir, dayKey);\n      try {\n        if (fs.statSync(dayDir).isDirectory()) {\n          dirs.push(dayDir);\n        }\n      } catch {\n        continue;\n      }\n    }\n\n    return dirs;\n  }\n\n  private getDateDirsAroundDate(date: Date, windowDays: number): string[] {\n    const dirs: string[] = [];\n\n    for (let offset = -windowDays; offset <= windowDays; offset++) {\n      const day = new Date(date.getTime());\n      day.setDate(day.getDate() + offset);\n      const dayDir = path.join(this.sessionsDir, this.toSessionDayKey(day));\n      if (isDirectory(dayDir)) {\n        dirs.push(dayDir);\n      }\n    }\n\n    return dirs;\n  }\n\n  private toSessionDayKey(date: Date): string {\n    const yyyy = String(date.getFullYear()).padStart(4, \"0\");\n    const mm = String(date.getMonth() + 1).padStart(2, \"0\");\n    const dd = String(date.getDate()).padStart(2, \"0\");\n    return path.join(yyyy, mm, dd);\n  }\n\n  private tryParseUuidV7Date(sessionId: string): Date | null {\n    const match = sessionId.match(\n      /^([0-9a-f]{8})-([0-9a-f]{4})-7[0-9a-f]{3}-[0-9a-f]{4}-[0-9a-f]{12}$/i,\n    );\n    if (!match) return null;\n\n    const timestampMs = Number.parseInt(`${match[1]}${match[2]}`, 16);\n    if (!Number.isSafeInteger(timestampMs) || timestampMs <= 0) return null;\n\n    const date = new Date(timestampMs);\n    return Number.isNaN(date.getTime()) ? null : date;\n  }\n\n  private collectSessionFilesInDateDirs(dateDirs: string[]): string[] {\n    const out: string[] = [];\n\n    for (const dayDir of dateDirs) {\n      for (const fileEntry of safeReaddir(dayDir)) {\n        if (!fileEntry.endsWith(\".jsonl\")) continue;\n        out.push(path.join(dayDir, fileEntry));\n      }\n    }\n\n    return out;\n  }\n}\n\n/**\n * Read the first line of a file, consuming at most `maxBytes`.\n * Returns `null` when the file cannot be opened or read.\n */\nfunction readFileHead(filePath: string, maxBytes: number): FileHead | null {\n  let fd: number;\n  try {\n    fd = fs.openSync(filePath, \"r\");\n  } catch {\n    return null;\n  }\n\n  try {\n    const buffer = Buffer.alloc(maxBytes);\n    let total = 0;\n\n    while (total < maxBytes) {\n      const length = Math.min(SESSION_META_HEAD_CHUNK_BYTES, maxBytes - total);\n      const read = fs.readSync(fd, buffer, total, length, total);\n      if (read <= 0) break;\n\n      const newlineIndex = buffer.indexOf(0x0a, total);\n      total += read;\n      if (newlineIndex >= 0 && newlineIndex < total) {\n        return {\n          text: buffer.toString(\"utf-8\", 0, newlineIndex),\n          bytes: newlineIndex + 1,\n          complete: true,\n          truncated: false,\n        };\n      }\n    }\n\n    return {\n      text: buffer.toString(\"utf-8\", 0, total),\n      bytes: total,\n      complete: false,\n      truncated: total >= maxBytes,\n    };\n  } catch {\n    return null;\n  } finally {\n    try {\n      fs.closeSync(fd);\n    } catch {\n      // Ignore close errors\n    }\n  }\n}\n\n/** Extract the first `\"field\": \"<json string>\"` value from a JSON fragment. */\nfunction extractJsonStringField(fragment: string, field: string): string | undefined {\n  const match = fragment.match(new RegExp(`\"${field}\"\\\\s*:\\\\s*(\"(?:[^\"\\\\\\\\]|\\\\\\\\.)*\")`));\n  if (!match) return undefined;\n\n  try {\n    const value = JSON.parse(match[1]) as unknown;\n    return typeof value === \"string\" ? value : undefined;\n  } catch {\n    return undefined;\n  }\n}\n"],"names":["fs","path","matchProcessesToSessions","batchGetSessionFileBirthtimes","isDirectory","safeReaddir","safeStat","CodexSessionParser","homeDir","PROCESS_START_DAY_WINDOW_DAYS","SESSION_META_HEAD_MAX_BYTES","SESSION_META_HEAD_CHUNK_BYTES","UNMATCHED_PROCESS_RECHECK_MS","CodexSessionLocator","sessionsDir","now","sessionMetaCache","Map","unmatchedProcesses","options","parser","join","Date","matchRunningProcesses","processes","direct","fallback","tryResumeMatching","nowMs","signatures","map","proc","getDateDirSignature","candidates","filter","isKnownUnmatched","get","sessions","discoverLiveSessions","legacyMatches","length","updateUnmatchedProcesses","sessionId","extractResumeSessionId","command","push","sessionFile","findSessionFileById","process","empty","existsSync","dateDirs","getDateDirs","discoverSessionFilesInDateDirs","files","pruneSessionMetaCache","file","meta","readSessionMeta","filePath","resolvedCwd","cwd","timestampMs","birthtimeMs","discoverHistoricalSessionFiles","collectAllSessionFiles","getCandidateSessionFiles","basename","includes","id","stat","projectDir","dirname","out","yearEntry","yearDir","monthEntry","monthDir","dayEntry","dayDir","fileEntry","endsWith","match","sessionDate","tryParseUuidV7Date","collectSessionFilesInDateDirs","getDateDirsAroundDate","cached","isSessionMetaCacheValid","head","readFileHead","delete","parseSessionMetaHead","set","dev","ino","headBytes","bytes","headFinal","complete","truncated","entry","size","line","text","trim","parsed","JSON","parse","type","payload","parseMetaTimestampMs","timestamp","parseTruncatedSessionMeta","test","payloadStart","search","slice","extractJsonStringField","scannedDirs","Set","present","keys","has","dateDirSignature","toProcessKey","checkedAtMs","scanned","liveKeys","key","matchedPids","pid","startTime","getTime","getProcessDayKeys","dayKey","mtimeMs","dayKeys","offset","day","setDate","getDate","toSessionDayKey","add","dirs","statSync","date","windowDays","yyyy","String","getFullYear","padStart","mm","getMonth","dd","Number","parseInt","isSafeInteger","isNaN","maxBytes","fd","openSync","buffer","Buffer","alloc","total","Math","min","read","readSync","newlineIndex","indexOf","toString","closeSync","fragment","field","RegExp","undefined","value"],"mappings":"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"}

package/dist/{providers → harnesses}/codex/CodexSessionMapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodexSessionMapping.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/CodexSessionMapping.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAGlE,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,0BAA+B;IAOpD,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,yBAAyB;IAoB1D,OAAO,CAAC,IAAI;IAwBZ,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,oBAAoB;CAK7B"}
+{"version":3,"file":"CodexSessionMapping.d.ts","sourceRoot":"","sources":["../../../src/harnesses/codex/CodexSessionMapping.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAIlE,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,0BAA+B;IAMpD,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,yBAAyB;IAoB1D,OAAO,CAAC,IAAI;IAwBZ,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,oBAAoB;CAK7B"}

package/dist/{providers → harnesses}/codex/CodexSessionMapping.js

@@ -1,13 +1,13 @@
 import * as fs from "fs";
 import * as path from "path";
 import { safeReadFile } from "../../utils/session.js";
+import { homeDir } from "../shared.js";
 export class CodexSessionMapping {
     mappingPath;
     sessionsDir;
     constructor(options = {}){
-        const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-        this.mappingPath = options.mappingPath ?? path.join(homeDir, ".codex", "ai-devkit", "sessions.json");
-        this.sessionsDir = options.sessionsDir ?? path.join(homeDir, ".codex", "sessions");
+        this.mappingPath = options.mappingPath ?? path.join(homeDir(), ".codex", "ai-devkit", "sessions.json");
+        this.sessionsDir = options.sessionsDir ?? path.join(homeDir(), ".codex", "sessions");
     }
     match(processes) {
         const mapping = this.read();

package/dist/harnesses/codex/CodexSessionMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/codex/CodexSessionMapping.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport type { ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { safeReadFile } from \"../../utils/session.js\";\nimport { homeDir } from \"../shared.js\";\n\nexport interface CodexSessionMappingOptions {\n  mappingPath?: string;\n  sessionsDir?: string;\n}\n\nexport interface CodexSessionMappingMatch {\n  process: ProcessInfo;\n  filePath: string;\n}\n\nexport interface CodexSessionMappingResult {\n  matches: CodexSessionMappingMatch[];\n  fallback: ProcessInfo[];\n}\n\nexport class CodexSessionMapping {\n  private readonly mappingPath: string;\n  private readonly sessionsDir: string;\n\n  constructor(options: CodexSessionMappingOptions = {}) {\n    this.mappingPath =\n      options.mappingPath ?? path.join(homeDir(), \".codex\", \"ai-devkit\", \"sessions.json\");\n    this.sessionsDir = options.sessionsDir ?? path.join(homeDir(), \".codex\", \"sessions\");\n  }\n\n  match(processes: ProcessInfo[]): CodexSessionMappingResult {\n    const mapping = this.read();\n    if (mapping.size === 0) return { matches: [], fallback: processes };\n\n    const matches: CodexSessionMappingMatch[] = [];\n    const fallback: ProcessInfo[] = [];\n\n    for (const processInfo of processes) {\n      const filePath = mapping.get(processInfo.pid);\n      if (!filePath || !this.isTrustedSessionPath(filePath) || !fs.existsSync(filePath)) {\n        fallback.push(processInfo);\n        continue;\n      }\n\n      matches.push({ process: processInfo, filePath });\n    }\n\n    return { matches, fallback };\n  }\n\n  private read(): Map<number, string> {\n    const content = safeReadFile(this.mappingPath);\n    if (content === undefined) return new Map();\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(content);\n    } catch {\n      return new Map();\n    }\n\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) return new Map();\n\n    const map = new Map<number, string>();\n    for (const [key, value] of Object.entries(parsed)) {\n      const pid = this.toPid(key);\n      if (pid !== null && typeof value === \"string\" && value) {\n        map.set(pid, value);\n      }\n    }\n\n    return map;\n  }\n\n  private toPid(value: unknown): number | null {\n    if (typeof value === \"number\" && Number.isInteger(value) && value > 0) return value;\n    if (typeof value !== \"string\" || !/^\\d+$/.test(value)) return null;\n\n    const parsed = Number(value);\n    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;\n  }\n\n  private isTrustedSessionPath(filePath: string): boolean {\n    const resolvedRoot = path.resolve(this.sessionsDir);\n    const resolvedPath = path.resolve(filePath);\n    return resolvedPath === resolvedRoot || resolvedPath.startsWith(`${resolvedRoot}${path.sep}`);\n  }\n}\n"],"names":["fs","path","safeReadFile","homeDir","CodexSessionMapping","mappingPath","sessionsDir","options","join","match","processes","mapping","read","size","matches","fallback","processInfo","filePath","get","pid","isTrustedSessionPath","existsSync","push","process","content","undefined","Map","parsed","JSON","parse","Array","isArray","map","key","value","Object","entries","toPid","set","Number","isInteger","test","isSafeInteger","resolvedRoot","resolve","resolvedPath","startsWith","sep"],"mappings":"AAAA,YAAYA,QAAQ,KAAK;AACzB,YAAYC,UAAU,OAAO;AAE7B,SAASC,YAAY,QAAQ,yBAAyB;AACtD,SAASC,OAAO,QAAQ,eAAe;AAiBvC,OAAO,MAAMC;IACMC,YAAoB;IACpBC,YAAoB;IAErC,YAAYC,UAAsC,CAAC,CAAC,CAAE;QACpD,IAAI,CAACF,WAAW,GACdE,QAAQF,WAAW,IAAIJ,KAAKO,IAAI,CAACL,WAAW,UAAU,aAAa;QACrE,IAAI,CAACG,WAAW,GAAGC,QAAQD,WAAW,IAAIL,KAAKO,IAAI,CAACL,WAAW,UAAU;IAC3E;IAEAM,MAAMC,SAAwB,EAA6B;QACzD,MAAMC,UAAU,IAAI,CAACC,IAAI;QACzB,IAAID,QAAQE,IAAI,KAAK,GAAG,OAAO;YAAEC,SAAS,EAAE;YAAEC,UAAUL;QAAU;QAElE,MAAMI,UAAsC,EAAE;QAC9C,MAAMC,WAA0B,EAAE;QAElC,KAAK,MAAMC,eAAeN,UAAW;YACnC,MAAMO,WAAWN,QAAQO,GAAG,CAACF,YAAYG,GAAG;YAC5C,IAAI,CAACF,YAAY,CAAC,IAAI,CAACG,oBAAoB,CAACH,aAAa,CAACjB,GAAGqB,UAAU,CAACJ,WAAW;gBACjFF,SAASO,IAAI,CAACN;gBACd;YACF;YAEAF,QAAQQ,IAAI,CAAC;gBAAEC,SAASP;gBAAaC;YAAS;QAChD;QAEA,OAAO;YAAEH;YAASC;QAAS;IAC7B;IAEQH,OAA4B;QAClC,MAAMY,UAAUtB,aAAa,IAAI,CAACG,WAAW;QAC7C,IAAImB,YAAYC,WAAW,OAAO,IAAIC;QAEtC,IAAIC;QACJ,IAAI;YACFA,SAASC,KAAKC,KAAK,CAACL;QACtB,EAAE,OAAM;YACN,OAAO,IAAIE;QACb;QAEA,IAAI,CAACC,UAAU,OAAOA,WAAW,YAAYG,MAAMC,OAAO,CAACJ,SAAS,OAAO,IAAID;QAE/E,MAAMM,MAAM,IAAIN;QAChB,KAAK,MAAM,CAACO,KAAKC,MAAM,IAAIC,OAAOC,OAAO,CAACT,QAAS;YACjD,MAAMR,MAAM,IAAI,CAACkB,KAAK,CAACJ;YACvB,IAAId,QAAQ,QAAQ,OAAOe,UAAU,YAAYA,OAAO;gBACtDF,IAAIM,GAAG,CAACnB,KAAKe;YACf;QACF;QAEA,OAAOF;IACT;IAEQK,MAAMH,KAAc,EAAiB;QAC3C,IAAI,OAAOA,UAAU,YAAYK,OAAOC,SAAS,CAACN,UAAUA,QAAQ,GAAG,OAAOA;QAC9E,IAAI,OAAOA,UAAU,YAAY,CAAC,QAAQO,IAAI,CAACP,QAAQ,OAAO;QAE9D,MAAMP,SAASY,OAAOL;QACtB,OAAOK,OAAOG,aAAa,CAACf,WAAWA,SAAS,IAAIA,SAAS;IAC/D;IAEQP,qBAAqBH,QAAgB,EAAW;QACtD,MAAM0B,eAAe1C,KAAK2C,OAAO,CAAC,IAAI,CAACtC,WAAW;QAClD,MAAMuC,eAAe5C,KAAK2C,OAAO,CAAC3B;QAClC,OAAO4B,iBAAiBF,gBAAgBE,aAAaC,UAAU,CAAC,GAAGH,eAAe1C,KAAK8C,GAAG,EAAE;IAC9F;AACF"}

package/dist/harnesses/codex/CodexSessionParser.d.ts

@@ -0,0 +1,89 @@
+import type { ConversationMessage, ConversationOptions, SessionSummary } from "../../adapters/AgentAdapter.js";
+import { AgentStatus } from "../../adapters/AgentAdapter.js";
+import { type JsonlSummaryBounds } from "../../utils/IncrementalJsonlSummary.js";
+export interface CodexEventEntry {
+    timestamp?: string;
+    type?: string;
+    payload?: {
+        type?: string;
+        message?: string;
+        id?: string;
+        cwd?: string;
+        timestamp?: string;
+        role?: string;
+        content?: CodexContent[];
+        item?: CodexItem;
+        turn_id?: string;
+        internal_chat_message_metadata_passthrough?: {
+            turn_id?: string;
+        };
+    };
+}
+export interface CodexContent {
+    type?: string;
+    text?: string;
+}
+export interface CodexItem {
+    type?: string;
+    content?: string | CodexContent[];
+}
+export interface CodexSession {
+    sessionId: string;
+    projectPath: string;
+    summary: string;
+    sessionStart: Date;
+    lastActive: Date;
+    lastPayloadType?: string;
+}
+export interface CodexSessionParserOptions {
+    /** Cold-start scan bounds for `readSessionIncremental` (see IncrementalJsonlSummary). */
+    summaryBounds?: JsonlSummaryBounds | false;
+}
+export declare class CodexSessionParser {
+    /** Incremental reader backing `getConversation({ tail })`. */
+    private readonly tailReader;
+    private readonly sessionCache;
+    constructor(options?: CodexSessionParserOptions);
+    readSession(filePath: string, cachedContent?: string): CodexSession | null;
+    /**
+     * Same result as `readSession`, but backed by a per-instance incremental
+     * cache so repeated refreshes only parse bytes appended since the last call.
+     * Call `pruneSessionCache()` once per refresh to evict files no longer read.
+     *
+     * The first read of a large transcript is a bounded head + tail scan (see
+     * `summaryReducer.skip`); fields whose entries lie only in the skipped
+     * middle fall back to their defaults instead of forcing a full parse.
+     */
+    readSessionIncremental(filePath: string): CodexSession | null;
+    /** Evict cached summaries for files not read since the previous prune. */
+    pruneSessionCache(): void;
+    /**
+     * Fold one JSONL entry into the O(1) session summary. The first line must
+     * be a `session_meta` entry; the rest track the last typed entry and the
+     * last entry with displayable text.
+     *
+     * `skip` (bounded cold start) keeps the head's `session_meta` and clears the
+     * "latest" fields, so those come from the tail only. Without a typed tail
+     * entry lastActive falls back to the meta timestamp, then the file mtime;
+     * without tail text the summary is the "Codex session active" default. A
+     * `session_meta` line longer than the head window yields no session (null).
+     */
+    private readonly summaryReducer;
+    private toSession;
+    determineStatus(session: CodexSession): AgentStatus;
+    getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
+    private lineToConversationItem;
+    /** Drop event_msg messages mirrored by a response_item with the same turn/role/content. */
+    private dedupeMirroredMessages;
+    fileToSessionSummary(filePath: string): SessionSummary | null;
+    parseMetaTimestampMs(value?: string): number | null;
+    private normalizedPayloadType;
+    private extractEntryText;
+    private toConversationMessage;
+    private mapCodexRole;
+    private mapCodexItemRole;
+    private mirroredMessageKey;
+    private extractContentText;
+    private isSyntheticUserMessage;
+}
+//# sourceMappingURL=CodexSessionParser.d.ts.map

package/dist/harnesses/codex/CodexSessionParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodexSessionParser.d.ts","sourceRoot":"","sources":["../../../src/harnesses/codex/CodexSessionParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAG7D,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,wCAAwC,CAAC;AAGhD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;QACzB,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,0CAA0C,CAAC,EAAE;YAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAsBD,MAAM,WAAW,yBAAyB;IACxC,yFAAyF;IACzF,aAAa,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAAC;CAC5C;AAED,qBAAa,kBAAkB;IAC7B,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IAEpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6C;gBAE9D,OAAO,GAAE,yBAA8B;IAMnD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAkB1E;;;;;;;;OAQG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK7D,0EAA0E;IAC1E,iBAAiB,IAAI,IAAI;IAIzB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CA6B7B;IAEF,OAAO,CAAC,SAAS;IAkBjB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW;IAgBnD,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IA0B9F,OAAO,CAAC,sBAAsB;IAc9B,2FAA2F;IAC3F,OAAO,CAAC,sBAAsB;IAsB9B,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAkE7D,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUnD,OAAO,CAAC,qBAAqB;IAmB7B,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,qBAAqB;IA2C7B,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,sBAAsB;CAK/B"}