@cjhyy/code-shell-core 0.7.1 → 0.8.0

package/dist/cc-orchestrator/external-agent-driver.js

@@ -1,284 +0,0 @@
-import { execFile, spawn } from "node:child_process";
-import { createInterface } from "node:readline";
-import { pathWithCommonBins } from "./cc-capability.js";
-import { killProcessGroup } from "../runtime/spawn-common.js";
-/** Pure: reduce collected output lines + exit code to a result. Unit-testable. */
-export function runWithLines(adapter, lines, exitCode) {
-    const parsed = adapter.parseResult(lines);
-    return { ...parsed, exitCode, lines };
-}
-const codexImageFlagCache = new Map();
-const CODEX_IMAGE_PROBE_TIMEOUT_MS = 5_000;
-const AGENT_TERMINATE_GRACE_MS = 500;
-function listPosixProcessTree(rootPid) {
-    return new Promise((resolve) => {
-        execFile("ps", ["-axo", "pid=,ppid="], { encoding: "utf8" }, (err, stdout) => {
-            if (err) {
-                resolve([rootPid]);
-                return;
-            }
-            const childrenByParent = new Map();
-            for (const line of stdout.split("\n")) {
-                const [pidText, parentText] = line.trim().split(/\s+/, 2);
-                const pid = Number(pidText);
-                const parentPid = Number(parentText);
-                if (!Number.isInteger(pid) || !Number.isInteger(parentPid))
-                    continue;
-                const children = childrenByParent.get(parentPid) ?? [];
-                children.push(pid);
-                childrenByParent.set(parentPid, children);
-            }
-            const pids = [];
-            const visit = (pid) => {
-                if (pids.includes(pid))
-                    return;
-                pids.push(pid);
-                for (const childPid of childrenByParent.get(pid) ?? [])
-                    visit(childPid);
-            };
-            visit(rootPid);
-            resolve(pids);
-        });
-    });
-}
-function isPidAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function waitForPidsToExit(pids, timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while ([...pids].some(isPidAlive)) {
-        if (Date.now() >= deadline)
-            return false;
-        await delay(25);
-    }
-    return true;
-}
-function signalPids(pids, killSignal) {
-    for (const pid of pids) {
-        try {
-            process.kill(pid, killSignal);
-        }
-        catch {
-            // already gone
-        }
-    }
-}
-async function terminateAttachedProcessTree(child) {
-    const pid = child.pid;
-    if (!pid) {
-        try {
-            child.kill("SIGKILL");
-        }
-        catch {
-            // already gone
-        }
-        return;
-    }
-    if (process.platform === "win32") {
-        // Windows has no POSIX SIGTERM semantics or negative-pid groups. Reap the
-        // tree via taskkill, then use positive-pid process.kill as the fallback the
-        // platform supports when taskkill is unavailable/races.
-        await killProcessGroup(pid, { graceMs: AGENT_TERMINATE_GRACE_MS });
-        if (isPidAlive(pid)) {
-            try {
-                process.kill(pid);
-            }
-            catch {
-                // already gone
-            }
-        }
-        return;
-    }
-    const trackedPids = new Set(await listPosixProcessTree(pid));
-    signalPids(trackedPids, "SIGTERM");
-    if (await waitForPidsToExit(trackedPids, AGENT_TERMINATE_GRACE_MS))
-        return;
-    // Capture descendants created during the grace window while the leader is
-    // still addressable, but retain the first snapshot so reparented stubborn
-    // descendants cannot disappear from the escalation set.
-    for (const treePid of await listPosixProcessTree(pid))
-        trackedPids.add(treePid);
-    signalPids(trackedPids, "SIGKILL");
-    await waitForPidsToExit(trackedPids, 1_000);
-}
-function abortError() {
-    const err = new Error("Agent run aborted");
-    err.name = "AbortError";
-    return err;
-}
-function throwIfAborted(signal) {
-    if (signal?.aborted)
-        throw abortError();
-}
-function createCodexImageProbe(command, cwd, signal) {
-    return new Promise((resolve, reject) => {
-        if (signal?.aborted) {
-            reject(abortError());
-            return;
-        }
-        const child = spawn(command, ["exec", "--help"], {
-            cwd,
-            env: { ...process.env, PATH: pathWithCommonBins() },
-            windowsHide: true,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        let out = "";
-        let settled = false;
-        let terminating = false;
-        const cleanup = () => {
-            clearTimeout(timer);
-            signal?.removeEventListener("abort", onAbort);
-        };
-        const done = (value) => {
-            if (settled)
-                return;
-            settled = true;
-            cleanup();
-            resolve(value);
-        };
-        const fail = (err) => {
-            if (settled)
-                return;
-            settled = true;
-            cleanup();
-            reject(err);
-        };
-        const onAbort = () => {
-            if (settled || terminating)
-                return;
-            terminating = true;
-            cleanup();
-            void terminateAttachedProcessTree(child).then(() => fail(abortError()));
-        };
-        const timer = setTimeout(() => {
-            if (settled || terminating)
-                return;
-            terminating = true;
-            cleanup();
-            void terminateAttachedProcessTree(child).then(() => done(false));
-        }, CODEX_IMAGE_PROBE_TIMEOUT_MS);
-        signal?.addEventListener("abort", onAbort, { once: true });
-        if (signal?.aborted)
-            onAbort();
-        child.stdout?.on("data", (chunk) => {
-            out += chunk.toString("utf8");
-        });
-        child.stderr?.on("data", (chunk) => {
-            out += chunk.toString("utf8");
-        });
-        child.on("error", () => {
-            if (!terminating)
-                done(false);
-        });
-        child.on("exit", () => {
-            if (!terminating)
-                done(/(?:^|\s)-i(?:,|\s)|--image\b/.test(out));
-        });
-    });
-}
-export function detectCodexImageInput(command, cwd, signal) {
-    if (signal)
-        return createCodexImageProbe(command, cwd, signal);
-    const cached = codexImageFlagCache.get(command);
-    if (cached)
-        return cached;
-    const probe = createCodexImageProbe(command, cwd);
-    codexImageFlagCache.set(command, probe);
-    return probe;
-}
-/** Spawn ONE headless agent run, collect stream-json to exit, return result.
- *  No time concept — a single turn. Honors AbortSignal (kills the child). */
-export function runAgentOnce(adapter, opts, signal) {
-    return new Promise((resolve, reject) => {
-        void (async () => {
-            throwIfAborted(signal);
-            const codexImageInputSupported = adapter.kind === "codex" && (opts.imagePaths?.length ?? 0) > 0
-                ? await detectCodexImageInput(opts.command, opts.cwd, signal).catch((err) => {
-                    if (signal?.aborted || err?.name === "AbortError")
-                        throw err;
-                    return false;
-                })
-                : false;
-            throwIfAborted(signal);
-            const args = adapter.buildArgs({
-                prompt: opts.prompt,
-                resumeSessionId: opts.resumeSessionId,
-                model: opts.model,
-                permissionMode: opts.permissionMode ?? "default",
-                cwd: opts.cwd,
-                imagePaths: opts.imagePaths,
-                codexImageInputSupported,
-            });
-            throwIfAborted(signal);
-            // claude takes the prompt in argv (`-p <prompt>`) and wants stdin closed
-            // (verified: avoids a 3s wait). codex `exec` reads the prompt from stdin
-            // (argv ends with `-`), so adapters that set promptViaStdin get a piped
-            // stdin we write the prompt to.
-            const viaStdin = adapter.promptViaStdin === true;
-            const child = spawn(opts.command, args, {
-                cwd: opts.cwd,
-                env: { ...process.env, PATH: pathWithCommonBins() },
-                // Keep the agent in the owning worker/app process group. If that owner
-                // is force-terminated, the CLI and its descendants must not escape into
-                // a detached group that can keep editing the workspace unseen.
-                detached: false,
-                stdio: [viaStdin ? "pipe" : "ignore", "pipe", "pipe"],
-            });
-            let settled = false;
-            let abortRequested = false;
-            let termination;
-            const cleanup = () => {
-                signal?.removeEventListener("abort", onAbort);
-            };
-            const onAbort = () => {
-                if (abortRequested)
-                    return;
-                abortRequested = true;
-                termination = terminateAttachedProcessTree(child);
-            };
-            signal?.addEventListener("abort", onAbort, { once: true });
-            if (signal?.aborted)
-                onAbort();
-            if (viaStdin && child.stdin) {
-                child.stdin.end(opts.prompt);
-            }
-            const lines = [];
-            if (child.stdout) {
-                const rl = createInterface({ input: child.stdout });
-                rl.on("line", (line) => lines.push(line));
-            }
-            child.on("error", (err) => {
-                if (settled)
-                    return;
-                settled = true;
-                cleanup();
-                // A missing binary is the most common failure (user hasn't installed the
-                // CLI, or GUI-launched Electron's PATH misses it). Turn the cryptic
-                // "spawn codex ENOENT" into something actionable that names the command.
-                if (err.code === "ENOENT") {
-                    reject(new Error(`未找到命令 "${opts.command}"。请先安装该 CLI 并确保它在 PATH 中（${adapter.kind === "codex" ? "Codex CLI" : "Claude Code CLI"}）。`));
-                    return;
-                }
-                reject(err);
-            });
-            child.on("exit", (code) => {
-                if (settled)
-                    return;
-                settled = true;
-                cleanup();
-                void (termination ?? Promise.resolve()).then(() => {
-                    resolve(runWithLines(adapter, lines, code));
-                });
-            });
-        })().catch(reject);
-    });
-}

package/dist/cc-orchestrator/external-agent-session-store.d.ts

@@ -1,23 +0,0 @@
-export type ExternalAgentCli = "claude" | "codex";
-export interface ExternalAgentSessionBinding {
-    cli: ExternalAgentCli;
-    sessionId: string;
-    cwd: string;
-    worktreePath?: string;
-    worktreeBranch?: string;
-    updatedAt: number;
-}
-export type ExternalAgentSessionRecord = Omit<ExternalAgentSessionBinding, "updatedAt"> & {
-    updatedAt?: number;
-};
-export declare function defaultExternalAgentSessionStorePath(): string;
-export declare class ExternalAgentSessionStore {
-    private readonly file;
-    constructor(file?: string);
-    get(cli: ExternalAgentCli, sessionId: string): ExternalAgentSessionBinding | undefined;
-    record(binding: ExternalAgentSessionRecord): void;
-    private load;
-    private save;
-    private withLock;
-}
-export declare const externalAgentSessionStore: ExternalAgentSessionStore;

package/dist/cc-orchestrator/external-agent-session-store.js

@@ -1,146 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
-import { dirname, join } from "node:path";
-import { codeShellHome } from "../session/session-manager.js";
-import { logger } from "../logging/logger.js";
-import { normalizeCwdPath } from "./cwd-normalize.js";
-const LOCK_WAIT_MS = 5_000;
-const LOCK_STALE_MS = 30_000;
-const LOCK_POLL_MS = 10;
-export function defaultExternalAgentSessionStorePath() {
-    return join(codeShellHome(), "external-agent-sessions.json");
-}
-export class ExternalAgentSessionStore {
-    file;
-    constructor(file = defaultExternalAgentSessionStorePath()) {
-        this.file = file;
-    }
-    get(cli, sessionId) {
-        if (!sessionId)
-            return undefined;
-        return this.load().find((s) => s.cli === cli && s.sessionId === sessionId);
-    }
-    record(binding) {
-        if (!binding.sessionId || !binding.cwd)
-            return;
-        const next = {
-            cli: binding.cli,
-            sessionId: binding.sessionId,
-            cwd: normalizeCwdPath(binding.cwd),
-            ...(binding.worktreePath ? { worktreePath: binding.worktreePath } : {}),
-            ...(binding.worktreeBranch ? { worktreeBranch: binding.worktreeBranch } : {}),
-            updatedAt: binding.updatedAt ?? Date.now(),
-        };
-        this.withLock(() => {
-            const sessions = this.load().filter((s) => !(s.cli === binding.cli && s.sessionId === binding.sessionId));
-            sessions.push(next);
-            this.save(sessions);
-        });
-    }
-    load() {
-        if (!existsSync(this.file))
-            return [];
-        try {
-            const raw = readFileSync(this.file, "utf-8");
-            const parsed = JSON.parse(raw);
-            if (!parsed || !Array.isArray(parsed.sessions))
-                return [];
-            return parsed.sessions.filter(isBinding).map(normalizeBinding);
-        }
-        catch (err) {
-            logger.warn("external_agent_session_store.load_failed", {
-                cat: "cc",
-                file: this.file,
-                error: err instanceof Error ? err.message : String(err),
-            });
-            return [];
-        }
-    }
-    save(sessions) {
-        const dir = dirname(this.file);
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
-        const snapshot = { version: 1, sessions };
-        const tmp = `${this.file}.${process.pid}.${Date.now()}.tmp`;
-        try {
-            writeFileSync(tmp, JSON.stringify(snapshot, null, 2) + "\n", "utf-8");
-            renameSync(tmp, this.file);
-        }
-        catch (err) {
-            rmSync(tmp, { force: true });
-            throw err;
-        }
-    }
-    withLock(fn) {
-        const dir = dirname(this.file);
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
-        // TODO: move this sync polling lock to an async write queue; callers can
-        // otherwise block the event loop for up to LOCK_WAIT_MS under contention.
-        const lockDir = `${this.file}.lock`;
-        const deadline = Date.now() + LOCK_WAIT_MS;
-        while (true) {
-            try {
-                mkdirSync(lockDir);
-                break;
-            }
-            catch (err) {
-                const code = err.code;
-                if (code !== "EEXIST")
-                    throw err;
-                if (removeStaleLock(lockDir))
-                    continue;
-                if (Date.now() >= deadline) {
-                    throw new Error(`timed out waiting for external agent session store lock: ${lockDir}`, {
-                        cause: err,
-                    });
-                }
-                sleepSync(LOCK_POLL_MS);
-            }
-        }
-        try {
-            return fn();
-        }
-        finally {
-            rmSync(lockDir, { recursive: true, force: true });
-        }
-    }
-}
-function normalizeBinding(binding) {
-    return { ...binding, cwd: normalizeCwdPath(binding.cwd) };
-}
-function removeStaleLock(lockDir) {
-    try {
-        if (Date.now() - statSync(lockDir).mtimeMs <= LOCK_STALE_MS)
-            return false;
-        rmSync(lockDir, { recursive: true, force: true });
-        return true;
-    }
-    catch (err) {
-        if (err.code === "ENOENT")
-            return true;
-        return false;
-    }
-}
-function sleepSync(ms) {
-    try {
-        const view = new Int32Array(new SharedArrayBuffer(4));
-        Atomics.wait(view, 0, 0, ms);
-    }
-    catch {
-        const until = Date.now() + ms;
-        while (Date.now() < until) {
-            // fallback for runtimes where Atomics.wait is unavailable
-        }
-    }
-}
-function isBinding(value) {
-    if (!value || typeof value !== "object")
-        return false;
-    const v = value;
-    return ((v.cli === "claude" || v.cli === "codex") &&
-        typeof v.sessionId === "string" &&
-        v.sessionId.length > 0 &&
-        typeof v.cwd === "string" &&
-        v.cwd.length > 0);
-}
-export const externalAgentSessionStore = new ExternalAgentSessionStore();

package/dist/cc-orchestrator/index.d.ts

@@ -1,8 +0,0 @@
-export * from "./cc-capability.js";
-export * from "./agent-adapter.js";
-export * from "./external-agent-driver.js";
-export * from "./session-discovery.js";
-export * from "./codex-session-discovery.js";
-export * from "./relevance-judge.js";
-export * from "./session-history.js";
-export * from "./codex-session-history.js";

package/dist/cc-orchestrator/index.js

@@ -1,8 +0,0 @@
-export * from "./cc-capability.js";
-export * from "./agent-adapter.js";
-export * from "./external-agent-driver.js";
-export * from "./session-discovery.js";
-export * from "./codex-session-discovery.js";
-export * from "./relevance-judge.js";
-export * from "./session-history.js";
-export * from "./codex-session-history.js";

package/dist/cc-orchestrator/relevance-judge.d.ts

@@ -1,15 +0,0 @@
-export interface JudgeDecision {
-    action: "continue-same" | "continue-fresh" | "stop";
-    handoffSummary?: string;
-    reason: string;
-}
-export interface JudgeInput {
-    goal?: string;
-    lastResult: string;
-    nextPrompt: string;
-}
-/** Injected aux-model call: takes a prompt, returns raw text. */
-export type AuxLlm = (prompt: string) => Promise<string>;
-export declare function buildJudgePrompt(input: JudgeInput): string;
-export declare function parseJudgeResponse(raw: string): JudgeDecision;
-export declare function judgeContinuation(input: JudgeInput, llm: AuxLlm): Promise<JudgeDecision>;

package/dist/cc-orchestrator/relevance-judge.js

@@ -1,29 +0,0 @@
-const SYSTEM = `You decide how a scheduled task loop should continue after one run.
-Reply with ONLY a JSON object: {"action": "continue-same"|"continue-fresh"|"stop", "handoffSummary"?: string, "reason": string}.
-- "stop": the goal is met; no more runs needed.
-- "continue-same": next run should resume the SAME session (work is related, keep context).
-- "continue-fresh": next run should start a FRESH session because the next step is unrelated to what was just done; put a short context summary in handoffSummary.`;
-export function buildJudgePrompt(input) {
-    return [
-        SYSTEM,
-        input.goal ? `\nOverall goal: ${input.goal}` : "",
-        `\nWhat the last run produced:\n${input.lastResult.slice(0, 4000)}`,
-        `\nThe next scheduled prompt:\n${input.nextPrompt}`,
-        `\nDecision JSON:`,
-    ].join("\n");
-}
-export function parseJudgeResponse(raw) {
-    try {
-        const m = raw.match(/\{[\s\S]*\}/);
-        const d = JSON.parse(m ? m[0] : raw);
-        if (d.action === "stop" || d.action === "continue-fresh" || d.action === "continue-same") {
-            return { action: d.action, handoffSummary: typeof d.handoffSummary === "string" ? d.handoffSummary : undefined, reason: typeof d.reason === "string" ? d.reason : "" };
-        }
-    }
-    catch { /* fall through */ }
-    return { action: "continue-same", reason: "unparseable judge output; defaulting to continue-same" };
-}
-export async function judgeContinuation(input, llm) {
-    const raw = await llm(buildJudgePrompt(input));
-    return parseJudgeResponse(raw);
-}

package/dist/cc-orchestrator/session-discovery.d.ts

@@ -1,46 +0,0 @@
-/** Encode a cwd to claude's project dir name: every non-[A-Za-z0-9] char → '-'.
- *  Mirrors `~/.claude/projects/<encoded>` (verified against real layout). */
-export declare function encodeCwd(cwd: string): string;
-export interface DiscoveredSession {
-    sessionId: string;
-    firstMessage: string;
-    lastModified: number;
-    messageCount: number;
-}
-/**
- * Bound how many sessions a discovery scan deep-reads + returns. Without this,
- * `discoverSessions` read EVERY `.jsonl` file fully (title + message count) on
- * every list open — O(all history) work that makes the CC/Codex room list slow
- * and unwieldy once a project accumulates sessions. The default surfaces only
- * the recent, useful slice; the UI fetches older ones on demand by passing a
- * larger `limit` (or `sinceMs: 0`).
- */
-export interface DiscoverOptions {
-    /** Max sessions to return (after the recency filter), newest first.
-     *  undefined or <= 0 = no cap. */
-    limit?: number;
-    /** Only include sessions modified within this many ms of `now`.
-     *  undefined or <= 0 = no window. */
-    sinceMs?: number;
-    /** Injectable clock for tests. Defaults to Date.now(). */
-    now?: number;
-}
-/** Default room-list window: last 2 weeks AND at most 20 — the intersection. */
-export declare const DEFAULT_DISCOVER_LIMIT = 20;
-export declare const DEFAULT_DISCOVER_SINCE_MS: number;
-/**
- * Apply the recency window + limit to mtime-sorted stats, returning the slice to
- * deep-read. Shared by the claude + codex discovery paths so they bound work
- * identically. `total` (caller-side) lets the UI show a "load more" affordance.
- */
-export declare function selectRecentStats<T extends {
-    mtimeMs: number;
-}>(stats: T[], opts?: DiscoverOptions): T[];
-/** List claude sessions for `cwd`. `claudeHome` defaults to ~/.claude (override
- *  for tests). Read-only, on-demand scan; no index. Stats every file cheaply,
- *  then deep-reads (title + count) ONLY the recent slice (opts) so an old,
- *  large history doesn't get fully read on every list open. */
-export declare function discoverSessions(cwd: string, claudeHome?: string, opts?: DiscoverOptions): DiscoveredSession[];
-/** Count of all session files for `cwd`, cheaply (stat only). Lets the UI know
- *  whether a bounded `discoverSessions` left older sessions unshown. */
-export declare function countSessions(cwd: string, claudeHome?: string): number;

package/dist/cc-orchestrator/session-discovery.js

@@ -1,125 +0,0 @@
-import { readdirSync, readFileSync, statSync, existsSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-/** Encode a cwd to claude's project dir name: every non-[A-Za-z0-9] char → '-'.
- *  Mirrors `~/.claude/projects/<encoded>` (verified against real layout). */
-export function encodeCwd(cwd) {
-    return cwd.replace(/[^A-Za-z0-9]/g, "-");
-}
-/** Default room-list window: last 2 weeks AND at most 20 — the intersection. */
-export const DEFAULT_DISCOVER_LIMIT = 20;
-export const DEFAULT_DISCOVER_SINCE_MS = 14 * 24 * 60 * 60 * 1000;
-function claudeProjectsDir(claudeHome) {
-    return join(claudeHome, "projects");
-}
-/** Extract first *real* user message text, skipping caveat/command noise. */
-function firstUserMessage(lines) {
-    for (const line of lines) {
-        if (!line.trim())
-            continue;
-        let d;
-        try {
-            d = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        if (d.type !== "user")
-            continue;
-        const c = d.message?.content;
-        const text = typeof c === "string"
-            ? c
-            : Array.isArray(c)
-                ? c.map((p) => (typeof p?.text === "string" ? p.text : "")).join("")
-                : "";
-        const t = text.trim();
-        if (!t)
-            continue;
-        if (t.startsWith("<local-command-caveat>") || t.startsWith("<command-name>"))
-            continue;
-        return t.slice(0, 200);
-    }
-    return "";
-}
-function countUserMessages(lines) {
-    let n = 0;
-    for (const line of lines) {
-        if (!line.trim())
-            continue;
-        try {
-            if (JSON.parse(line).type === "user")
-                n++;
-        }
-        catch { /* skip */ }
-    }
-    return n;
-}
-/** Cheap (sessionId, mtime) pairs for every session file — stat only, no read. */
-function listSessionStats(dir) {
-    const stats = [];
-    for (const name of readdirSync(dir)) {
-        if (!name.endsWith(".jsonl"))
-            continue;
-        const file = join(dir, name);
-        let st;
-        try {
-            st = statSync(file);
-        }
-        catch {
-            continue;
-        }
-        stats.push({ sessionId: name.replace(/\.jsonl$/, ""), file, mtimeMs: st.mtimeMs });
-    }
-    return stats;
-}
-/**
- * Apply the recency window + limit to mtime-sorted stats, returning the slice to
- * deep-read. Shared by the claude + codex discovery paths so they bound work
- * identically. `total` (caller-side) lets the UI show a "load more" affordance.
- */
-export function selectRecentStats(stats, opts = {}) {
-    const now = opts.now ?? Date.now();
-    let sel = stats.slice().sort((a, b) => b.mtimeMs - a.mtimeMs);
-    if (opts.sinceMs && opts.sinceMs > 0) {
-        const cutoff = now - opts.sinceMs;
-        sel = sel.filter((s) => s.mtimeMs >= cutoff);
-    }
-    if (opts.limit && opts.limit > 0)
-        sel = sel.slice(0, opts.limit);
-    return sel;
-}
-/** List claude sessions for `cwd`. `claudeHome` defaults to ~/.claude (override
- *  for tests). Read-only, on-demand scan; no index. Stats every file cheaply,
- *  then deep-reads (title + count) ONLY the recent slice (opts) so an old,
- *  large history doesn't get fully read on every list open. */
-export function discoverSessions(cwd, claudeHome = join(homedir(), ".claude"), opts = {}) {
-    const dir = join(claudeProjectsDir(claudeHome), encodeCwd(cwd));
-    if (!existsSync(dir))
-        return [];
-    const selected = selectRecentStats(listSessionStats(dir), opts);
-    const out = [];
-    for (const s of selected) {
-        let lines;
-        try {
-            lines = readFileSync(s.file, "utf-8").split("\n");
-        }
-        catch {
-            continue;
-        }
-        out.push({
-            sessionId: s.sessionId,
-            firstMessage: firstUserMessage(lines),
-            lastModified: s.mtimeMs,
-            messageCount: countUserMessages(lines),
-        });
-    }
-    return out;
-}
-/** Count of all session files for `cwd`, cheaply (stat only). Lets the UI know
- *  whether a bounded `discoverSessions` left older sessions unshown. */
-export function countSessions(cwd, claudeHome = join(homedir(), ".claude")) {
-    const dir = join(claudeProjectsDir(claudeHome), encodeCwd(cwd));
-    if (!existsSync(dir))
-        return 0;
-    return listSessionStats(dir).length;
-}