yepanywhere 0.1.0

package/dist/sdk/providers/types.d.ts

@@ -0,0 +1,99 @@
+import type { ModelInfo, PermissionMode } from "@yep-anywhere/shared";
+import type { MessageQueue } from "../messageQueue.js";
+import type { CanUseTool, SDKMessage, UserMessage } from "../types.js";
+/**
+ * Provider names - extensible for future providers.
+ */
+export type ProviderName = "claude" | "codex" | "codex-oss" | "gemini" | "opencode";
+/**
+ * Authentication status for a provider.
+ */
+export interface AuthStatus {
+    /** Whether the provider is installed/available */
+    installed: boolean;
+    /** Whether the provider is authenticated */
+    authenticated: boolean;
+    /** Whether auth is enabled (e.g., ANTHROPIC_API_KEY is set) */
+    enabled: boolean;
+    /** When authentication expires (if applicable) */
+    expiresAt?: Date;
+    /** User info if available */
+    user?: {
+        email?: string;
+        name?: string;
+    };
+}
+/**
+ * Options for starting a new agent session.
+ */
+export interface StartSessionOptions {
+    /** Working directory for the session */
+    cwd: string;
+    /** Initial message to send (optional - session can wait for message) */
+    initialMessage?: UserMessage;
+    /** Session ID to resume (optional) */
+    resumeSessionId?: string;
+    /** Permission mode for tool approvals */
+    permissionMode?: PermissionMode;
+    /** Model to use (e.g., "sonnet", "opus", "haiku") */
+    model?: string;
+    /** Max thinking tokens (undefined = disabled) */
+    maxThinkingTokens?: number;
+    /** Tool approval callback */
+    onToolApproval?: CanUseTool;
+}
+/**
+ * Result of starting an agent session.
+ * This is the common interface all providers must return.
+ */
+export interface AgentSession {
+    /** Async iterator yielding SDK messages */
+    iterator: AsyncIterableIterator<SDKMessage>;
+    /** Message queue for sending messages to the agent */
+    queue: MessageQueue;
+    /** Abort function to cancel the session */
+    abort: () => void;
+    /** Session ID if available immediately (some providers provide later via messages) */
+    sessionId?: string;
+}
+/**
+ * Agent provider interface.
+ * All providers (Claude, Codex, Gemini, local) implement this interface.
+ */
+export interface AgentProvider {
+    /** Provider identifier */
+    readonly name: ProviderName;
+    /** Human-readable display name */
+    readonly displayName: string;
+    /** Whether this provider supports permission modes (default: true) */
+    readonly supportsPermissionMode: boolean;
+    /** Whether this provider supports extended thinking toggle (default: true) */
+    readonly supportsThinkingToggle: boolean;
+    /**
+     * Check if this provider is installed and available.
+     * For SDK-based providers, this is always true.
+     * For CLI-based providers, this checks if the binary exists.
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Check if this provider is authenticated.
+     * Returns true if the provider can be used immediately.
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * Get detailed authentication status.
+     */
+    getAuthStatus(): Promise<AuthStatus>;
+    /**
+     * Start a new agent session.
+     * Returns the session iterator, message queue, and abort function.
+     */
+    startSession(options: StartSessionOptions): Promise<AgentSession>;
+    /**
+     * Get available models for this provider.
+     * For local providers (Codex with Ollama), this queries the local model list.
+     * For cloud providers (Claude, Gemini), this returns a static list.
+     */
+    getAvailableModels(): Promise<ModelInfo[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sdk/providers/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,OAAO,GACP,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,aAAa,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,6BAA6B;IAC7B,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC5C,sDAAsD;IACtD,KAAK,EAAE,YAAY,CAAC;IACpB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IAEzC;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpC;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAErC;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAElE;;;;OAIG;IACH,kBAAkB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC5C"}

package/dist/sdk/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sdk/providers/types.js.map

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

package/dist/sdk/real.d.ts

@@ -0,0 +1,20 @@
+import type { RealClaudeSDKInterface, StartSessionOptions, StartSessionResult } from "./types.js";
+/**
+ * Real Claude SDK implementation.
+ *
+ * This is a thin wrapper around ClaudeProvider for backward compatibility.
+ * New code should use ClaudeProvider directly or via the AgentProvider interface.
+ *
+ * @deprecated Use ClaudeProvider from ./providers/claude.js instead
+ */
+export declare class RealClaudeSDK implements RealClaudeSDKInterface {
+    private provider;
+    /**
+     * Start a new Claude session.
+     *
+     * @param options - Session configuration
+     * @returns Iterator, message queue, and abort function
+     */
+    startSession(options: StartSessionOptions): Promise<StartSessionResult>;
+}
+//# sourceMappingURL=real.d.ts.map

package/dist/sdk/real.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real.d.ts","sourceRoot":"","sources":["../../src/sdk/real.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,sBAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAwB;IAExC;;;;;OAKG;IACG,YAAY,CAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;CAG/B"}

package/dist/sdk/real.js

@@ -0,0 +1,22 @@
+import { ClaudeProvider } from "./providers/claude.js";
+/**
+ * Real Claude SDK implementation.
+ *
+ * This is a thin wrapper around ClaudeProvider for backward compatibility.
+ * New code should use ClaudeProvider directly or via the AgentProvider interface.
+ *
+ * @deprecated Use ClaudeProvider from ./providers/claude.js instead
+ */
+export class RealClaudeSDK {
+    provider = new ClaudeProvider();
+    /**
+     * Start a new Claude session.
+     *
+     * @param options - Session configuration
+     * @returns Iterator, message queue, and abort function
+     */
+    async startSession(options) {
+        return this.provider.startSession(options);
+    }
+}
+//# sourceMappingURL=real.js.map

package/dist/sdk/real.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"real.js","sourceRoot":"","sources":["../../src/sdk/real.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAOvD;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IAChB,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IAExC;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,OAA4B;QAE5B,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/sdk/types.d.ts

@@ -0,0 +1,113 @@
+export type { PermissionMode } from "@yep-anywhere/shared";
+import type { PermissionMode, UploadedFile } from "@yep-anywhere/shared";
+export interface ContentBlock {
+    type: "text" | "tool_use" | "tool_result" | "image" | "thinking";
+    text?: string;
+    /** For thinking blocks */
+    thinking?: string;
+    id?: string;
+    name?: string;
+    input?: unknown;
+    /** For tool_result blocks - references the tool_use id */
+    tool_use_id?: string;
+    /** For tool_result blocks - the result content */
+    content?: string;
+}
+/**
+ * SDK Message - loosely typed to preserve all fields from the SDK.
+ *
+ * We intentionally use a loose type here to:
+ * 1. Pass through all SDK fields without stripping
+ * 2. Allow frontend to inspect any field for debugging
+ * 3. Avoid breaking when SDK adds new fields
+ *
+ * Known fields are documented but not enforced.
+ */
+export interface SDKMessage {
+    type: string;
+    uuid?: string;
+    subtype?: string;
+    session_id?: string;
+    timestamp?: string;
+    message?: {
+        content: string | ContentBlock[];
+        role?: string;
+    };
+    parentUuid?: string | null;
+    parent_tool_use_id?: string;
+    isSynthetic?: boolean;
+    isReplay?: boolean;
+    userType?: string;
+    tool_use_id?: string;
+    tool_name?: string;
+    tool_input?: unknown;
+    toolUseResult?: unknown;
+    input_request?: {
+        id: string;
+        type: "tool-approval" | "question" | "choice";
+        prompt: string;
+        options?: string[];
+    };
+    duration_ms?: number;
+    duration_api_ms?: number;
+    total_cost_usd?: number;
+    usage?: unknown;
+    modelUsage?: unknown;
+    num_turns?: number;
+    error?: unknown;
+    [key: string]: unknown;
+}
+export interface UserMessage {
+    text: string;
+    images?: string[];
+    documents?: string[];
+    /** File attachments with paths for agent to access via Read tool */
+    attachments?: UploadedFile[];
+    mode?: PermissionMode;
+    /** UUID to use for this message. If not provided, SDK will generate one. */
+    uuid?: string;
+    /** Client-generated temp ID for optimistic UI tracking. Echoed back in SSE. */
+    tempId?: string;
+}
+export interface SDKSessionOptions {
+    cwd: string;
+    resume?: string;
+}
+export interface ClaudeSDK {
+    startSession(options: SDKSessionOptions): AsyncIterableIterator<SDKMessage>;
+}
+import type { MessageQueue } from "./messageQueue.js";
+export interface ToolApprovalResult {
+    behavior: "allow" | "deny";
+    updatedInput?: unknown;
+    message?: string;
+    /**
+     * If true, interrupt execution and do not continue.
+     * Set to true when user denies without guidance (just clicks "No").
+     * Leave false/unset when user provides feedback for Claude to incorporate.
+     */
+    interrupt?: boolean;
+}
+export type CanUseTool = (toolName: string, input: unknown, options: {
+    signal: AbortSignal;
+}) => Promise<ToolApprovalResult>;
+export interface StartSessionOptions {
+    cwd: string;
+    initialMessage?: UserMessage;
+    resumeSessionId?: string;
+    permissionMode?: PermissionMode;
+    /** Model to use (e.g., "sonnet", "opus", "haiku"). undefined = use CLI default */
+    model?: string;
+    /** Max thinking tokens. undefined = thinking disabled */
+    maxThinkingTokens?: number;
+    onToolApproval?: CanUseTool;
+}
+export interface StartSessionResult {
+    iterator: AsyncIterableIterator<SDKMessage>;
+    queue: MessageQueue;
+    abort: () => void;
+}
+export interface RealClaudeSDKInterface {
+    startSession(options: StartSessionOptions): Promise<StartSessionResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/sdk/types.js

@@ -0,0 +1,3 @@
+// Core types for Claude SDK abstraction
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

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

package/dist/sessions/Session.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Session class provides a unified interface for session operations on the server.
+ *
+ * Extends SessionView (from shared) with server-side I/O capabilities:
+ * - Reading/writing custom titles
+ * - Refreshing from disk
+ * - Archive/star status management
+ *
+ * Usage:
+ *   const session = await Session.load(sessionId, projectId, deps);
+ *   console.log(session.displayTitle);  // inherited from SessionView
+ *   await session.rename("New name");   // server-only
+ */
+import { type AppSessionSummary, SessionView, type UrlProjectId } from "@yep-anywhere/shared";
+import type { ISessionIndexService } from "../indexes/types.js";
+import type { SessionMetadataService } from "../metadata/SessionMetadataService.js";
+import type { ISessionReader } from "./types.js";
+/**
+ * Dependencies required by Session for I/O operations.
+ * Passed via constructor or load() for testability.
+ *
+ * These are provider-agnostic interfaces, allowing Session to work
+ * with any provider (Claude, Codex, Gemini, etc.).
+ */
+export interface SessionDeps {
+    indexService: ISessionIndexService;
+    metadataService: SessionMetadataService;
+    reader: ISessionReader;
+    sessionDir: string;
+}
+/**
+ * Session extends SessionView with server-side capabilities.
+ */
+export declare class Session extends SessionView {
+    private deps;
+    private constructor();
+    /**
+     * Load a session by ID, combining data from cache and metadata services.
+     *
+     * @param sessionId - The session ID
+     * @param projectId - The project ID
+     * @param deps - Service dependencies for I/O
+     * @returns Session instance or null if not found
+     */
+    static load(sessionId: string, projectId: UrlProjectId, deps: SessionDeps): Promise<Session | null>;
+    /**
+     * Create a Session from an existing AppSessionSummary (already loaded data).
+     * Useful when you've already fetched the summary via other means.
+     */
+    static fromSummary(summary: AppSessionSummary, deps: SessionDeps): Session;
+    /**
+     * Set a custom title for this session.
+     * Pass undefined or empty string to clear the custom title.
+     */
+    rename(title: string | undefined): Promise<void>;
+    /**
+     * Set the archived status for this session.
+     */
+    setArchived(archived: boolean): Promise<void>;
+    /**
+     * Set the starred status for this session.
+     */
+    setStarred(starred: boolean): Promise<void>;
+    /**
+     * Refresh session data from disk.
+     * Returns a new Session instance with updated data.
+     */
+    refresh(): Promise<Session | null>;
+    /**
+     * Get the auto-generated title (from first user message).
+     * This is the title before any custom rename.
+     */
+    getAutoTitle(): string | null;
+    /**
+     * Convert to a plain object suitable for API responses.
+     * Returns the full session summary with all fields.
+     */
+    toJSON(): AppSessionSummary;
+}
+//# sourceMappingURL=Session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../src/sessions/Session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,WAAW,EACX,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,oBAAoB,CAAC;IACnC,eAAe,EAAE,sBAAsB,CAAC;IACxC,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC,OAAO,CAAC,IAAI,CAAc;IAE1B,OAAO;IAuBP;;;;;;;OAOG;WACU,IAAI,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAuB1B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO;IAI1E;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQxC;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B;;;OAGG;IACH,MAAM,IAAI,iBAAiB;CAqB5B"}

package/dist/sessions/Session.js

@@ -0,0 +1,119 @@
+/**
+ * Session class provides a unified interface for session operations on the server.
+ *
+ * Extends SessionView (from shared) with server-side I/O capabilities:
+ * - Reading/writing custom titles
+ * - Refreshing from disk
+ * - Archive/star status management
+ *
+ * Usage:
+ *   const session = await Session.load(sessionId, projectId, deps);
+ *   console.log(session.displayTitle);  // inherited from SessionView
+ *   await session.rename("New name");   // server-only
+ */
+import { SessionView, } from "@yep-anywhere/shared";
+/**
+ * Session extends SessionView with server-side capabilities.
+ */
+export class Session extends SessionView {
+    deps;
+    constructor(summary, deps) {
+        super(summary.id, summary.projectId, summary.title, summary.fullTitle, summary.customTitle, summary.createdAt, summary.updatedAt, summary.messageCount, summary.status, summary.isArchived ?? false, summary.isStarred ?? false, summary.pendingInputType, summary.processState, summary.lastSeenAt, summary.hasUnread ?? false, summary.contextUsage, summary.provider);
+        this.deps = deps;
+    }
+    /**
+     * Load a session by ID, combining data from cache and metadata services.
+     *
+     * @param sessionId - The session ID
+     * @param projectId - The project ID
+     * @param deps - Service dependencies for I/O
+     * @returns Session instance or null if not found
+     */
+    static async load(sessionId, projectId, deps) {
+        // Get full summary to check if session exists
+        const summary = await deps.reader.getSessionSummary(sessionId, projectId);
+        // Return null if session doesn't exist
+        if (!summary) {
+            return null;
+        }
+        // Get custom metadata to merge in
+        const metadata = deps.metadataService.getMetadata(sessionId);
+        // Merge metadata into summary
+        const enrichedSummary = {
+            ...summary,
+            customTitle: metadata?.customTitle,
+            isArchived: metadata?.isArchived,
+            isStarred: metadata?.isStarred,
+        };
+        return new Session(enrichedSummary, deps);
+    }
+    /**
+     * Create a Session from an existing AppSessionSummary (already loaded data).
+     * Useful when you've already fetched the summary via other means.
+     */
+    static fromSummary(summary, deps) {
+        return new Session(summary, deps);
+    }
+    /**
+     * Set a custom title for this session.
+     * Pass undefined or empty string to clear the custom title.
+     */
+    async rename(title) {
+        await this.deps.metadataService.setTitle(this.id, title);
+    }
+    /**
+     * Set the archived status for this session.
+     */
+    async setArchived(archived) {
+        await this.deps.metadataService.setArchived(this.id, archived);
+    }
+    /**
+     * Set the starred status for this session.
+     */
+    async setStarred(starred) {
+        await this.deps.metadataService.setStarred(this.id, starred);
+    }
+    /**
+     * Refresh session data from disk.
+     * Returns a new Session instance with updated data.
+     */
+    async refresh() {
+        // Invalidate cache to force re-read
+        this.deps.indexService.invalidateSession(this.deps.sessionDir, this.id);
+        // Reload
+        return Session.load(this.id, this.projectId, this.deps);
+    }
+    /**
+     * Get the auto-generated title (from first user message).
+     * This is the title before any custom rename.
+     */
+    getAutoTitle() {
+        return this.autoTitle;
+    }
+    /**
+     * Convert to a plain object suitable for API responses.
+     * Returns the full session summary with all fields.
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            projectId: this.projectId,
+            title: this.autoTitle,
+            fullTitle: this.fullTitle,
+            customTitle: this.customTitle,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+            messageCount: this.messageCount,
+            status: this.status,
+            isArchived: this.isArchived,
+            isStarred: this.isStarred,
+            pendingInputType: this.pendingInputType,
+            processState: this.processState,
+            lastSeenAt: this.lastSeenAt,
+            hasUnread: this.hasUnread,
+            contextUsage: this.contextUsage,
+            provider: this.provider,
+        };
+    }
+}
+//# sourceMappingURL=Session.js.map

package/dist/sessions/Session.js.map

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

package/dist/sessions/codex-reader.d.ts

@@ -0,0 +1,166 @@
+/**
+ * CodexSessionReader - Reads Codex sessions from disk.
+ *
+ * Codex stores sessions at ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
+ * with a different format than Claude:
+ * - session_meta: Session initialization (id, cwd, timestamp)
+ * - response_item: Messages, reasoning, function calls
+ * - event_msg: User/agent messages, token counts
+ * - turn_context: Per-turn configuration
+ *
+ * Unlike Claude's DAG structure, Codex sessions are linear.
+ */
+import { type UrlProjectId } from "@yep-anywhere/shared";
+import type { Message, SessionSummary } from "../supervisor/types.js";
+import type { GetSessionOptions, ISessionReader, LoadedSession } from "./types.js";
+export interface CodexSessionReaderOptions {
+    /**
+     * Base directory for Codex sessions (~/.codex/sessions).
+     * Sessions are stored in YYYY/MM/DD/rollout-*.jsonl structure.
+     */
+    sessionsDir: string;
+    /**
+     * The project path (cwd) to filter sessions by.
+     * Only sessions with this cwd will be listed.
+     */
+    projectPath?: string;
+}
+/**
+ * Codex-specific session reader for Codex CLI JSONL files.
+ *
+ * Handles Codex's linear conversation structure with session_meta,
+ * response_item, event_msg, and turn_context entries.
+ */
+export declare class CodexSessionReader implements ISessionReader {
+    private sessionsDir;
+    private projectPath?;
+    private sessionFileCache;
+    private cacheTimestamp;
+    private readonly CACHE_TTL_MS;
+    constructor(options: CodexSessionReaderOptions);
+    listSessions(projectId: UrlProjectId): Promise<SessionSummary[]>;
+    getSessionSummary(sessionId: string, projectId: UrlProjectId): Promise<SessionSummary | null>;
+    getSession(sessionId: string, projectId: UrlProjectId, afterMessageId?: string, _options?: GetSessionOptions): Promise<LoadedSession | null>;
+    getSessionSummaryIfChanged(sessionId: string, projectId: UrlProjectId, cachedMtime: number, cachedSize: number): Promise<{
+        summary: SessionSummary;
+        mtime: number;
+        size: number;
+    } | null>;
+    /**
+     * Codex doesn't have subagent sessions like Claude.
+     * Returns empty array for compatibility.
+     */
+    getAgentMappings(): Promise<{
+        toolUseId: string;
+        agentId: string;
+    }[]>;
+    /**
+     * Codex doesn't have subagent sessions like Claude.
+     * Returns null for compatibility.
+     */
+    getAgentSession(_agentId: string): Promise<{
+        messages: Message[];
+        status: string;
+    } | null>;
+    /**
+     * Scan the sessions directory and find all session files.
+     */
+    private scanSessions;
+    /**
+     * Find a session file by ID.
+     */
+    private findSessionFile;
+    /**
+     * Recursively find all .jsonl files in a directory.
+     */
+    private findJsonlFiles;
+    /**
+     * Read session metadata from the first line of a file.
+     */
+    private readSessionMeta;
+    /**
+     * Extract title from entries (first user message).
+     */
+    private extractTitle;
+    private isSystemPromptUserMessage;
+    /**
+     * Count user/assistant messages in entries.
+     *
+     * Matches the logic in convertEntriesToMessages - we count user_message
+     * events and response_item messages, but not agent_message events since
+     * those are streaming duplicates.
+     */
+    private countMessages;
+    /**
+     * Extract context usage from token_count events.
+     */
+    private extractContextUsage;
+    /**
+     * Extract the model from turn_context entries.
+     */
+    private extractModel;
+    /**
+     * Determine provider based on session metadata or model.
+     */
+    private determineProvider;
+    /**
+     * Helper to determine provider from a list of entries.
+     */
+    private determineProviderFromEntries;
+    /**
+     * Convert Codex JSONL entries to Message format.
+     *
+     * Codex sessions contain both streaming events (event_msg) and aggregated
+     * response_item entries. We prefer response_item for messages since they
+     * contain the complete text, and only use event_msg for user_message events.
+     *
+     * Unlike Claude's DAG structure, Codex sessions are linear. We create a
+     * parentUuid chain by linking each message to the previous one, which
+     * enables proper ordering and deduplication in the client.
+     *
+     * @deprecated Potentially dead code - conversion now happens in normalization.ts.
+     * This method may be removed once we confirm it's no longer called.
+     */
+    private convertEntriesToMessages;
+    private hasResponseItemUserMessages;
+    /**
+     * Convert a response_item entry to a Message.
+     *
+     * @deprecated Potentially dead code - conversion now happens in normalization.ts.
+     */
+    private convertResponseItem;
+    /**
+     * Convert a message payload (user or assistant).
+     *
+     * Codex streams tokens as separate output_text blocks, so we concatenate
+     * them into a single text block for proper rendering.
+     *
+     * @deprecated Potentially dead code - conversion now happens in normalization.ts.
+     */
+    private convertMessagePayload;
+    /**
+     * Convert a reasoning payload (thinking).
+     *
+     * @deprecated Potentially dead code - conversion now happens in normalization.ts.
+     */
+    private convertReasoningPayload;
+    /**
+     * Convert a function_call payload to tool_use.
+     *
+     * @deprecated Potentially dead code - conversion now happens in normalization.ts.
+     */
+    private convertFunctionCallPayload;
+    /**
+     * Convert a function_call_output payload to tool_result.
+     *
+     * @deprecated Potentially dead code - conversion now happens in normalization.ts.
+     */
+    private convertFunctionCallOutputPayload;
+    /**
+     * Convert an event_msg entry to a Message.
+     *
+     * @deprecated Potentially dead code - conversion now happens in normalization.ts.
+     */
+    private convertEventMsg;
+}
+//# sourceMappingURL=codex-reader.d.ts.map