@manyoars/oars 0.2.0 → 0.4.0

package/dist/sessions/codex.d.ts

@@ -0,0 +1,53 @@
+/** The Codex home for an environment; a test passes its own so it never reads the real one. */
+export declare const codexRoot: (env: {
+    [name: string]: string | undefined;
+}, home?: string) => string;
+type Obj = {
+    [key: string]: unknown;
+};
+/** A rollout file found in the store, before its lines are read. */
+export interface CodexSession {
+    /** The rollout's key: the thread uuid in the file name (Codex's own session id), `<thread>_<rollout>` for a reverted thread's file when the thread itself is not in the store (else its file is folded into the thread's, `revisions`), else the file's stem. */
+    id: string;
+    /** `session_meta.cwd`; null when the first line names none. */
+    folder: string | null;
+    /** `session_meta.parent_thread_id`: set for a spawned agent's rollout, which is deposited as a subagent of that thread. */
+    parent: string | null;
+    /** `session_meta.agent_role` (protocol.rs:3486), when the spawned agent has one. */
+    agentRole: string | null;
+    /** `session_meta.forked_from_id`: the thread whose history a fork copied, to match its copied records against. */
+    forkedFrom: string | null;
+    /**
+     * The rollouts of the thread's reverts, folded into this one (thread-store/src/local/revert_thread.rs:15-18): each starts at `from`, the ordinal it
+     * takes from `history_base.end_ordinal_exclusive`, and supersedes the records at or after it in every earlier file. Empty for a thread never reverted.
+     */
+    revisions: {
+        file: string;
+        from: number;
+        at: number;
+    }[];
+    /** `session_meta.timestamp` in milliseconds (a fresh `started_at` for each new rollout, rollout/src/recorder.rs:953-966); 0 when absent. A fork is matched against the lineage as of this time. */
+    started: number;
+    file: string;
+    size: number;
+    mtimeMs: number;
+}
+export interface CodexStore {
+    sessions: CodexSession[];
+    /** The session as transcript text for `captureSession`; throws when the file cannot be read. */
+    transcript: (session: CodexSession) => Promise<string>;
+    /** Files skipped because their id is not a safe file name (it names a skeleton), counted so the skip is never silent. */
+    rejected: number;
+    /** Files that could not be inspected, reported once each and never fatal; the reason names no path, so a log line built from it leaks none. */
+    unreadable: {
+        file: string;
+        reason: string;
+    }[];
+}
+/** The non-blank lines of a rollout that are not JSON (a torn write), kept so `captureSession` counts them and the deposit line reports them. */
+export declare const rolloutBadLines: (text: string) => string[];
+/** One rollout as the lines `captureSession` reads. */
+export declare const rolloutLines: (text: string, fallbackId: string, parentText?: string) => Obj[];
+/** Opens the Codex store under `root`; undefined when it holds no `sessions` folder, so a machine without Codex is skipped silently. */
+export declare const openCodexStore: (root: string) => Promise<CodexStore | undefined>;
+export {};