pi-harness-runtime 1.1.136 → 1.1.138

package/packages/codex-watcher/dist/src/index.js

@@ -0,0 +1,198 @@
+/**
+ * Codex Session Watcher — Main API
+ *
+ * Watches the active Codex CLI session and emits visible messages (user + assistant)
+ * so the harness PING-PONG middleware can feed them to pi.dev.
+ *
+ * Usage:
+ *   import { startWatcher, getLatestSession, getVisibleMessages } from "@pi-harness/codex-watcher";
+ *
+ *   // One-shot: get latest messages from the current session
+ *   const session = getLatestSession();
+ *   const messages = await getVisibleMessages(session.rolloutPath, { fromOrdinal: 0 });
+ *
+ *   // Continuous: poll the active session and emit messages
+ *   const handle = startWatcher({
+ *     onMessages: (msgs) => console.log(msgs),
+ *   });
+ *   // later: handle.stop();
+ */
+import { existsSync, openSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { classifyMessage, parseNewMessages } from "./parser.js";
+import { getAllSessions, getLatestSession } from "./session.js";
+export { classifyMessage, getAllSessions, getLatestSession };
+// ---------------------------------------------------------------------------
+// One-shot API
+// ---------------------------------------------------------------------------
+/** Read all visible messages from a rollout file, starting from a given ordinal. */
+export async function getVisibleMessages(rolloutPath, options = {}) {
+    const { fromOrdinal = 0, limit } = options;
+    if (!existsSync(rolloutPath))
+        return [];
+    const content = readFileSync(rolloutPath, "utf8");
+    const lines = content.split("\n").filter((l) => l.trim());
+    let messages = parseNewMessages(lines, fromOrdinal);
+    if (limit)
+        messages = messages.slice(-limit);
+    if (messages.length > 0) {
+        messages[messages.length - 1] = {
+            ...messages[messages.length - 1],
+            isLatest: true,
+        };
+    }
+    return messages;
+}
+// ---------------------------------------------------------------------------
+// Streaming watcher API
+// ---------------------------------------------------------------------------
+/**
+ * Start watching the active Codex session and call `onMessages` whenever
+ * new visible messages appear in the rollout file.
+ *
+ * @returns WatcherHandle — call handle.stop() to stop watching
+ *
+ * The watcher:
+ * 1. Polls session_index.jsonl to detect active session changes
+ * 2. Tracks file position so it only reads new lines (no re-read of full file)
+ * 3. Calls onMessages with incremental messages each poll cycle
+ */
+export function startWatcher(options = {}) {
+    const { pollIntervalMs = 2000, codexDir, onMessages, onSessionChange, } = options;
+    const home = codexDir ?? join(homedir(), ".codex");
+    let stopped = false;
+    let currentFd = null;
+    let currentPath = null;
+    let currentOrdinal = 0;
+    let pollCount = 0;
+    const maxIdlePolls = options.maxIdlePolls ?? Infinity;
+    // Track last known session to detect changes
+    let lastSessionId = null;
+    function stop() {
+        stopped = true;
+        if (currentFd !== null) {
+            try {
+                const { closeSync } = require("node:fs");
+                closeSync(currentFd);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    function isRunning() {
+        return !stopped;
+    }
+    function latestSession() {
+        return getLatestSession(home);
+    }
+    function latestOrdinal() {
+        return currentOrdinal;
+    }
+    function openRollout(path) {
+        if (currentFd !== null && currentPath !== path) {
+            try {
+                const { closeSync } = require("node:fs");
+                closeSync(currentFd);
+            }
+            catch {
+                // ignore
+            }
+        }
+        // stat to get current size
+        const stat = statSync(path);
+        currentFd = openSync(path, "r");
+        currentPath = path;
+        currentOrdinal = 0;
+        return { fd: currentFd, size: stat.size };
+    }
+    function readNewLines(fd, knownSize) {
+        const { readSync, fstatSync } = require("node:fs");
+        const stat = fstatSync(fd);
+        const newSize = stat.size;
+        if (newSize <= knownSize) {
+            return { lines: [], newSize: knownSize };
+        }
+        const buf = Buffer.alloc(newSize - knownSize);
+        const bytesRead = readSync(fd, buf, 0, buf.length, knownSize);
+        const text = buf.subarray(0, bytesRead).toString("utf8");
+        const lines = text.split("\n").filter((l) => l.trim());
+        return { lines, newSize };
+    }
+    async function poll() {
+        if (stopped)
+            return;
+        try {
+            // Check for session change
+            const session = getLatestSession(home);
+            const sessionId = session?.id ?? null;
+            if (sessionId !== lastSessionId) {
+                // New session or session ended
+                if (session) {
+                    // Open new rollout
+                    openRollout(session.rolloutPath);
+                    currentOrdinal = 0;
+                    // Read all existing lines as "historical"
+                    const existing = await getVisibleMessages(session.rolloutPath, {
+                        fromOrdinal: 0,
+                    });
+                    if (existing.length > 0) {
+                        currentOrdinal = existing[existing.length - 1].ordinal;
+                    }
+                    onSessionChange?.(session);
+                }
+                else {
+                    onSessionChange?.(null);
+                }
+                lastSessionId = sessionId;
+                pollCount = 0;
+            }
+            if (!session || !currentFd || currentPath !== session.rolloutPath) {
+                if (!stopped) {
+                    await sleep(pollIntervalMs);
+                    poll();
+                }
+                return;
+            }
+            const stat = statSync(session.rolloutPath);
+            const { lines } = readNewLines(currentFd, stat.size);
+            if (lines.length > 0) {
+                pollCount = 0;
+                const messages = parseNewMessages(lines, currentOrdinal);
+                if (messages.length > 0) {
+                    currentOrdinal = messages[messages.length - 1].ordinal;
+                    messages[messages.length - 1] = {
+                        ...messages[messages.length - 1],
+                        isLatest: true,
+                    };
+                    onMessages?.(messages);
+                }
+            }
+            else {
+                pollCount++;
+                if (pollCount > maxIdlePolls) {
+                    stop();
+                    return;
+                }
+            }
+        }
+        catch (_err) {
+            // Session file may not exist yet; just wait
+        }
+        if (!stopped) {
+            await sleep(pollIntervalMs);
+            poll();
+        }
+    }
+    // Start polling
+    poll();
+    return { stop, isRunning, latestSession, latestOrdinal };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=index.js.map

package/packages/codex-watcher/dist/src/index.js.map

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

package/packages/codex-watcher/dist/src/parser.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Parser — extracts visible messages from Codex JSONL rollout lines.
+ *
+ * Safe subset (no developer/reasoning):
+ *   type == "response_item" && payload.role == "user"  → input_text content
+ *   type == "event_msg" && payload.type == "item_completed"
+ *     && payload.item.type == "AgentMessage"
+ *     && payload.item.content[].type == "Text"         → visible assistant text
+ */
+import type { CodexMessage } from "./types.js";
+/**
+ * Parse a single JSONL line from a Codex rollout file.
+ * Returns null if the line is not a visible message or is malformed.
+ */
+export declare function parseRolloutLine(line: string): CodexMessage | null;
+/**
+ * Parse all visible messages from a JSONL file.
+ * Reads from a given byte offset so callers can do incremental reads.
+ *
+ * @param lines    Lines to parse (typically newly read lines)
+ * @param latestOrdinal  The last ordinal already known (messages with ordinal ≤ this are skipped)
+ * @returns Messages with ordinal > latestOrdinal
+ */
+export declare function parseNewMessages(lines: string[], latestOrdinal?: number): CodexMessage[];
+/**
+ * Extract code blocks from assistant message text.
+ * Useful for detecting "plan" vs "code" in the Codex output.
+ */
+export declare function extractCodeBlocks(text: string): string[];
+/**
+ * Detect whether the message is a plan (markdown outline) vs code output.
+ * Returns "plan" if it looks like a planning document, "code" if mostly code,
+ * "mixed" if both, "unknown" otherwise.
+ */
+export declare function classifyMessage(text: string): "plan" | "code" | "mixed" | "unknown";
+//# sourceMappingURL=parser.d.ts.map

package/packages/codex-watcher/dist/src/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiD/C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAuBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,aAAa,SAAI,GACf,YAAY,EAAE,CAWhB;AAqED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMxD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,GACV,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAWvC"}

package/packages/codex-watcher/dist/src/parser.js

@@ -0,0 +1,151 @@
+/**
+ * Parser — extracts visible messages from Codex JSONL rollout lines.
+ *
+ * Safe subset (no developer/reasoning):
+ *   type == "response_item" && payload.role == "user"  → input_text content
+ *   type == "event_msg" && payload.type == "item_completed"
+ *     && payload.item.type == "AgentMessage"
+ *     && payload.item.content[].type == "Text"         → visible assistant text
+ */
+// ---------------------------------------------------------------------------
+// Parse a single JSONL line into a CodexMessage
+// ---------------------------------------------------------------------------
+/**
+ * Parse a single JSONL line from a Codex rollout file.
+ * Returns null if the line is not a visible message or is malformed.
+ */
+export function parseRolloutLine(line) {
+    if (!line.trim())
+        return null;
+    let raw;
+    try {
+        raw = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    // Assistant: visible text from AgentMessage item_completed events
+    if (isEventMsg(raw)) {
+        const msg = parseAssistantMessage(raw);
+        if (msg)
+            return msg;
+    }
+    // User: input_text from response_item events
+    if (isResponseItem(raw)) {
+        const msg = parseUserMessage(raw);
+        if (msg)
+            return msg;
+    }
+    return null;
+}
+/**
+ * Parse all visible messages from a JSONL file.
+ * Reads from a given byte offset so callers can do incremental reads.
+ *
+ * @param lines    Lines to parse (typically newly read lines)
+ * @param latestOrdinal  The last ordinal already known (messages with ordinal ≤ this are skipped)
+ * @returns Messages with ordinal > latestOrdinal
+ */
+export function parseNewMessages(lines, latestOrdinal = 0) {
+    const messages = [];
+    for (const line of lines) {
+        const msg = parseRolloutLine(line);
+        if (msg && msg.ordinal > latestOrdinal) {
+            messages.push(msg);
+        }
+    }
+    // Sort by ordinal (ascending) to preserve order
+    messages.sort((a, b) => a.ordinal - b.ordinal);
+    return messages;
+}
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+function isEventMsg(raw) {
+    return raw.type === "event_msg";
+}
+function isResponseItem(raw) {
+    return raw.type === "response_item";
+}
+// ---------------------------------------------------------------------------
+// Parse specific message types
+// ---------------------------------------------------------------------------
+function parseAssistantMessage(raw) {
+    const p = raw.payload;
+    if (p.type !== "item_completed")
+        return null;
+    if (p.item?.type !== "AgentMessage")
+        return null;
+    // Collect all Text content blocks
+    const texts = [];
+    for (const content of p.item.content ?? []) {
+        if (content.type === "Text" && content.text) {
+            texts.push(content.text);
+        }
+    }
+    if (texts.length === 0)
+        return null;
+    return {
+        ordinal: raw.ordinal,
+        timestamp: raw.timestamp,
+        role: "assistant",
+        text: texts.join("\n"),
+        isLatest: false,
+    };
+}
+function parseUserMessage(raw) {
+    const p = raw.payload;
+    if (p.type !== "message")
+        return null;
+    if (p.role !== "user")
+        return null;
+    const texts = [];
+    for (const content of p.content ?? []) {
+        if (content.type === "input_text" && content.text) {
+            texts.push(content.text);
+        }
+    }
+    if (texts.length === 0)
+        return null;
+    return {
+        ordinal: raw.ordinal,
+        timestamp: raw.timestamp,
+        role: "user",
+        text: texts.join("\n"),
+        isLatest: false,
+    };
+}
+// ---------------------------------------------------------------------------
+// Text extraction utilities
+// ---------------------------------------------------------------------------
+/**
+ * Extract code blocks from assistant message text.
+ * Useful for detecting "plan" vs "code" in the Codex output.
+ */
+export function extractCodeBlocks(text) {
+    const blocks = [];
+    for (const match of text.matchAll(/```[\w]*\n?([\s\S]*?)```/g)) {
+        blocks.push(match[1]?.trim() ?? "");
+    }
+    return blocks;
+}
+/**
+ * Detect whether the message is a plan (markdown outline) vs code output.
+ * Returns "plan" if it looks like a planning document, "code" if mostly code,
+ * "mixed" if both, "unknown" otherwise.
+ */
+export function classifyMessage(text) {
+    const codeBlocks = extractCodeBlocks(text);
+    const codeCharCount = codeBlocks.join("").replace(/\s/g, "").length;
+    const nonCodeCharCount = text
+        .replace(/```[\s\S]*?```/g, "")
+        .replace(/\s/g, "").length;
+    if (codeCharCount === 0 && nonCodeCharCount > 0)
+        return "plan";
+    if (nonCodeCharCount === 0 && codeCharCount > 0)
+        return "code";
+    if (codeCharCount > 0 && nonCodeCharCount > 0)
+        return "mixed";
+    return "unknown";
+}
+//# sourceMappingURL=parser.js.map

package/packages/codex-watcher/dist/src/parser.js.map

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

package/packages/codex-watcher/dist/src/session.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Session discovery — reads ~/.codex/session_index.jsonl to find active sessions.
+ */
+import type { CodexSession } from "./types.js";
+/** Find the most recently active Codex session. */
+export declare function getLatestSession(codexDir?: string): CodexSession | null;
+/** Get all sessions sorted by most recent first. */
+export declare function getAllSessions(codexDir?: string): CodexSession[];
+//# sourceMappingURL=session.d.ts.map

package/packages/codex-watcher/dist/src/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAsBvE;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAkBhE"}

package/packages/codex-watcher/dist/src/session.js

@@ -0,0 +1,131 @@
+/**
+ * Session discovery — reads ~/.codex/session_index.jsonl to find active sessions.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Find the most recently active Codex session. */
+export function getLatestSession(codexDir) {
+    const indexPath = getSessionIndexPath(codexDir);
+    if (!existsSync(indexPath))
+        return null;
+    let latest = null;
+    for (const line of readLines(indexPath)) {
+        const entry = parseSessionIndexLine(line);
+        if (!entry)
+            continue;
+        if (!latest || entry.updated_at > latest.updated_at) {
+            latest = entry;
+        }
+    }
+    if (!latest)
+        return null;
+    return {
+        id: latest.id,
+        threadName: latest.thread_name,
+        updatedAt: latest.updated_at,
+        rolloutPath: findRolloutPath(latest.id, codexDir),
+    };
+}
+/** Get all sessions sorted by most recent first. */
+export function getAllSessions(codexDir) {
+    const indexPath = getSessionIndexPath(codexDir);
+    if (!existsSync(indexPath))
+        return [];
+    const sessions = [];
+    for (const line of readLines(indexPath)) {
+        const entry = parseSessionIndexLine(line);
+        if (entry)
+            sessions.push(entry);
+    }
+    return sessions
+        .sort((a, b) => b.updated_at.localeCompare(a.updated_at))
+        .map((e) => ({
+        id: e.id,
+        threadName: e.thread_name,
+        updatedAt: e.updated_at,
+        rolloutPath: findRolloutPath(e.id, codexDir),
+    }));
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function getSessionIndexPath(codexDir) {
+    const home = codexDir ?? join(homedir(), ".codex");
+    return join(home, "session_index.jsonl");
+}
+function findRolloutPath(sessionId, codexDir) {
+    const home = codexDir ?? join(homedir(), ".codex");
+    const sessionsDir = join(home, "sessions");
+    // The rollout path follows: sessions/YYYY/MM/DD/rollout-YYYY-MM-DDTHH-MM-SS-<sessionId>.jsonl
+    // We need to find the file whose name ends with <sessionId>.jsonl
+    // Since there can be multiple sessions per day, iterate all files.
+    try {
+        const { readdirSync } = require("node:fs");
+        for (const dirPath of walkDirs(sessionsDir)) {
+            for (const file of readdirSync(dirPath)) {
+                if (file.endsWith(`${sessionId}.jsonl`)) {
+                    return join(dirPath, file);
+                }
+            }
+        }
+    }
+    catch {
+        // walkSync may not be available on all Node versions; fall back to find
+    }
+    return findRolloutPathFallback(sessionId, sessionsDir);
+}
+function findRolloutPathFallback(sessionId, sessionsDir) {
+    const found = walkForSession(sessionsDir, sessionId);
+    return found ?? join(sessionsDir, "unknown", `${sessionId}.jsonl`);
+}
+/** Recursively walk all subdirectories, yielding each directory path. */
+function* walkDirs(dir) {
+    const { readdirSync, statSync } = require("node:fs");
+    for (const entry of readdirSync(dir)) {
+        const full = join(dir, entry);
+        const stat = statSync(full);
+        if (stat.isDirectory()) {
+            yield full;
+            yield* walkDirs(full);
+        }
+    }
+}
+/** Find the rollout file for a given session ID by walking directories. */
+function walkForSession(sessionsDir, sessionId) {
+    const { readdirSync } = require("node:fs");
+    for (const dirPath of walkDirs(sessionsDir)) {
+        for (const file of readdirSync(dirPath)) {
+            if (file.startsWith("rollout-") && file.endsWith(`${sessionId}.jsonl`)) {
+                return join(dirPath, file);
+            }
+        }
+    }
+    return null;
+}
+function parseSessionIndexLine(line) {
+    try {
+        const obj = JSON.parse(line);
+        if (typeof obj.id !== "string" || typeof obj.thread_name !== "string") {
+            return null;
+        }
+        return {
+            id: obj.id,
+            thread_name: obj.thread_name,
+            updated_at: String(obj.updated_at ?? ""),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function readLines(filePath) {
+    try {
+        const content = readFileSync(filePath, "utf8");
+        return content.split("\n").filter((l) => l.trim().length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=session.js.map

package/packages/codex-watcher/dist/src/session.js.map

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

package/packages/codex-watcher/dist/src/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Codex Session Watcher — types
+ *
+ * Watches ~/.codex/ for active Codex CLI sessions and parses visible
+ * communication between the user and Codex (Planner role in PING-PONG).
+ *
+ * Key file locations:
+ *   ~/.codex/session_index.jsonl          — session registry
+ *   ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl  — session transcripts
+ *
+ * Visible message schema (safe subset — no developer/reasoning):
+ *   type == "event_msg" && payload.type == "item_completed"
+ *   && payload.item.type == "AgentMessage"
+ *   && payload.item.content[].type == "Text"
+ */
+export interface CodexSession {
+    /** Codex session ID (UUID) */
+    id: string;
+    /** Human-readable session name */
+    threadName: string;
+    /** ISO-8601 when session was last active */
+    updatedAt: string;
+    /** Absolute path to the rollout transcript file */
+    rolloutPath: string;
+}
+export interface CodexMessage {
+    /** Unique ordinal within the session (monotonically increasing) */
+    ordinal: number;
+    /** ISO-8601 timestamp */
+    timestamp: string;
+    /** Role: "user" (human) or "assistant" (Codex) */
+    role: "user" | "assistant";
+    /** Raw text content (markdown, code blocks, etc.) */
+    text: string;
+    /** Whether this message is the latest known message */
+    isLatest: boolean;
+}
+export interface CodexEvent {
+    /** Monotonically increasing ordinal within the session */
+    ordinal: number;
+    timestamp: string;
+    /** Raw JSON payload from the JSONL line */
+    raw: unknown;
+}
+export interface WatcherOptions {
+    /** How often to poll session_index.jsonl and active rollout file (ms). Default: 2000 */
+    pollIntervalMs?: number;
+    /** Absolute path to Codex home. Default: ~/.codex */
+    codexDir?: string;
+    /** Called with new visible messages each poll cycle */
+    onMessages?: (messages: CodexMessage[]) => void;
+    /** Called when a new session becomes active */
+    onSessionChange?: (session: CodexSession | null) => void;
+    /** Stop watching after N polls with no new lines. Default: Infinity */
+    maxIdlePolls?: number;
+}
+export interface WatcherHandle {
+    stop: () => void;
+    isRunning: () => boolean;
+    latestSession: () => CodexSession | null;
+    latestOrdinal: () => number;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/codex-watcher/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,YAAY;IAC5B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IAC1B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,GAAG,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,CAAC;IAChD,+CAA+C;IAC/C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IACzD,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IACzC,aAAa,EAAE,MAAM,MAAM,CAAC;CAC5B"}

package/packages/codex-watcher/dist/src/types.js

@@ -0,0 +1,17 @@
+/**
+ * Codex Session Watcher — types
+ *
+ * Watches ~/.codex/ for active Codex CLI sessions and parses visible
+ * communication between the user and Codex (Planner role in PING-PONG).
+ *
+ * Key file locations:
+ *   ~/.codex/session_index.jsonl          — session registry
+ *   ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl  — session transcripts
+ *
+ * Visible message schema (safe subset — no developer/reasoning):
+ *   type == "event_msg" && payload.type == "item_completed"
+ *   && payload.item.type == "AgentMessage"
+ *   && payload.item.content[].type == "Text"
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/codex-watcher/dist/src/types.js.map

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