@ccpocket-base-auth/bridge 1.26.0

package/dist/sessions-index.d.ts

@@ -0,0 +1,128 @@
+export interface SessionIndexEntry {
+    sessionId: string;
+    provider: "claude" | "codex";
+    /** User-assigned session name (customTitle for Claude, thread_name for Codex). */
+    name?: string;
+    agentNickname?: string;
+    agentRole?: string;
+    summary?: string;
+    firstPrompt: string;
+    lastPrompt?: string;
+    created: string;
+    modified: string;
+    gitBranch: string;
+    projectPath: string;
+    /** Raw cwd used to resume this session (worktree path for codex, if any). */
+    resumeCwd?: string;
+    isSidechain: boolean;
+    codexSettings?: {
+        approvalPolicy?: string;
+        sandboxMode?: string;
+        model?: string;
+        modelReasoningEffort?: string;
+        networkAccessEnabled?: boolean;
+        webSearchMode?: string;
+    };
+}
+export interface GetRecentSessionsOptions {
+    limit?: number;
+    offset?: number;
+    projectPath?: string;
+    /** Session IDs to exclude (archived sessions). */
+    archivedSessionIds?: ReadonlySet<string>;
+    /** Filter by provider (claude or codex). */
+    provider?: "claude" | "codex";
+    /** Show only sessions with a non-empty name. */
+    namedOnly?: boolean;
+    /** Free-text search across name, firstPrompt, lastPrompt and summary. */
+    searchQuery?: string;
+}
+export interface GetRecentSessionsResult {
+    sessions: SessionIndexEntry[];
+    hasMore: boolean;
+}
+interface JsonlScanStats {
+    filesTotal: number;
+    filesExcluded: number;
+    filesRead: number;
+    entriesReturned: number;
+}
+interface ScanJsonlDirOptions {
+    excludeSessionIds?: ReadonlySet<string>;
+    stats?: JsonlScanStats;
+}
+/** Convert a filesystem path to Claude's project directory slug (e.g. /foo/bar → -foo-bar). */
+export declare function pathToSlug(p: string): string;
+/**
+ * Normalize a worktree cwd back to the main project path.
+ * e.g. /path/to/project-worktrees/branch → /path/to/project
+ */
+export declare function normalizeWorktreePath(p: string): string;
+/**
+ * Check if a directory slug represents a worktree directory for a given project slug.
+ * e.g. "-Users-x-proj-worktrees-branch" is a worktree dir for "-Users-x-proj".
+ */
+export declare function isWorktreeSlug(dirSlug: string, projectSlug: string): boolean;
+/**
+ * Scan a directory for JSONL session files and create SessionIndexEntry objects.
+ * Used as a fallback when sessions-index.json is missing (common for worktree sessions).
+ * File reads are parallelized and use head+tail partial reads for performance.
+ */
+export declare function scanJsonlDir(dirPath: string, options?: ScanJsonlDirOptions): Promise<SessionIndexEntry[]>;
+export declare function getAllRecentSessions(options?: GetRecentSessionsOptions): Promise<GetRecentSessionsResult>;
+/**
+ * Look up the saved name (customTitle) for a Claude Code session.
+ * Returns the name if found, or undefined.
+ */
+export declare function getClaudeSessionName(projectPath: string, claudeSessionId: string): Promise<string | undefined>;
+/**
+ * Rename a Claude Code session by writing customTitle to sessions-index.json.
+ * This is the same mechanism the CLI uses for /rename.
+ */
+export declare function renameClaudeSession(projectPath: string, claudeSessionId: string, name: string | null): Promise<boolean>;
+/**
+ * Read the Codex session_index.jsonl and build a threadId → name map.
+ */
+export declare function loadCodexSessionNames(): Promise<Map<string, string>>;
+/**
+ * Rename a Codex session by appending to ~/.codex/session_index.jsonl.
+ * Passing `null` or empty name writes an empty thread_name to effectively clear it.
+ */
+export declare function renameCodexSession(threadId: string, name: string | null): Promise<boolean>;
+export interface SessionHistoryMessage {
+    role: "user" | "assistant";
+    uuid?: string;
+    timestamp?: string;
+    /** Skill loading prompt or other meta message (rendered as a chip). */
+    isMeta?: boolean;
+    /** Number of images attached to this user message (for display indicator). */
+    imageCount?: number;
+    content: Array<{
+        type: string;
+        text?: string;
+        id?: string;
+        name?: string;
+        input?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Read past conversation messages from a session's JSONL file.
+ * Returns user and assistant messages suitable for display.
+ */
+export declare function getSessionHistory(sessionId: string): Promise<SessionHistoryMessage[]>;
+export interface ExtractedImage {
+    base64: string;
+    mimeType: string;
+}
+/**
+ * Extract image base64 data from a Claude Code session JSONL for a specific message UUID.
+ */
+export declare function extractMessageImages(sessionId: string, messageUuid: string): Promise<ExtractedImage[]>;
+export declare function getCodexSessionHistory(threadId: string): Promise<SessionHistoryMessage[]>;
+/**
+ * Look up session metadata for a set of Claude CLI sessionIds.
+ * Returns a map from sessionId to a subset of session metadata.
+ * More efficient than getAllRecentSessions when you only need a few entries.
+ */
+export declare function findSessionsByClaudeIds(ids: Set<string>): Promise<Map<string, Pick<SessionIndexEntry, "summary" | "firstPrompt" | "lastPrompt" | "projectPath">>>;
+export {};