@threadbase-sh/streamer 1.23.0 → 1.24.0

package/dist/index.d.cts

@@ -76,9 +76,16 @@ interface Logger {
     pino: Logger$1;
 }
 
+declare const CLAUDE_CODE_PROVIDER: "claude-code";
+declare const CODEX_CLI_PROVIDER: "codex-cli";
+type ProviderName = typeof CLAUDE_CODE_PROVIDER | typeof CODEX_CLI_PROVIDER;
+declare function isProviderName(value: unknown): value is ProviderName;
+declare function isProviderResumable(_provider: string | null | undefined, availabilityResumable: boolean): boolean;
+
 type SessionStatus = "running" | "waiting_input" | "idle";
 interface ManagedSession {
     id: string;
+    provider?: ProviderName;
     projectId?: string;
     projectPath: string;
     projectName: string;
@@ -101,6 +108,15 @@ interface ManagedSession {
     lastActivityAt?: Date;
     filePath?: string;
     resumedFromConversationId?: string;
+    /**
+     * Set once a live session's underlying persisted conversation file is
+     * discovered after the fact (currently: fresh Codex sessions, whose
+     * rollout id isn't known until the CLI creates its own JSONL). Distinct
+     * from `resumedFromConversationId` (resume flow) and `conversationId` on
+     * `SessionResponse` (stable mobile deep-link alias, always === id for the
+     * lifetime of a live PTY) — must never be written into either of those.
+     */
+    boundConversationId?: string;
     /**
      * Multi-agent mode only. Per-session in-memory LRU of progress event ids
      * seen by the webhook receiver. Used to drop Temporal-replay duplicates
@@ -226,6 +242,7 @@ type WSMessage = {
 interface SessionResponse {
     id: string;
     conversationId: string;
+    provider?: ProviderName;
     projectId?: string;
     status: SessionStatus;
     projectPath: string;
@@ -251,6 +268,8 @@ interface SessionResponse {
     lastActivityAt?: string;
     filePath?: string;
     resumedFromConversationId?: string;
+    /** See `ManagedSession.boundConversationId` — never repurposes `conversationId`. */
+    boundConversationId?: string;
 }
 interface ConversationListResponse {
     conversations: unknown[];
@@ -324,6 +343,21 @@ interface StartFreshSessionOptions {
     projectName?: string;
     systemPrompt?: string;
 }
+interface SessionRunner {
+    start(sessionId: string, options: StartSessionOptions): Promise<ManagedSession>;
+    startFresh(options: StartFreshSessionOptions): Promise<ManagedSession>;
+    sendInput(sessionId: string, input: string): number;
+    sendKeys(sessionId: string, keys: string): void;
+    cancel(sessionId: string): void;
+    killPid(pid: number): void;
+    putOnHold(sessionId: string): void;
+    getOutput(sessionId: string): string;
+    getOutputLines(sessionId: string, maxLines: number): Promise<string[]>;
+    getSession(sessionId: string): ManagedSession | null;
+    hasSession(sessionId: string): boolean;
+    listSessions(): ManagedSession[];
+    dispose(): void;
+}
 
 interface ConversationCacheOptions {
     filterAgentConversations?: boolean;
@@ -454,7 +488,24 @@ declare class ConversationCache {
     getSessionName(sessionId: string): string | null;
     listSessionNames(): Record<string, string>;
     invalidate(id?: string): void;
-    invalidateByFilePath(filePath: string): string | null;
+    /**
+     * Drop the cached row for a file. Two callers with opposite intent:
+     *  - a directory-watch "change" event (the file was appended to) — pass
+     *    `skipIfTailed: true`. A cached tail means the row is being actively
+     *    maintained from the file's real content by the live-tail
+     *    (updateFromLines) or warm-up path, fresher than any scanner-derived
+     *    view. Both watchers fire on the same append with no ordering guarantee;
+     *    without this guard the invalidate can land after the tail write and wipe
+     *    the just-cached row, flickering the conversation out of
+     *    /api/conversations on nearly every message (CRITICAL #2). The debounced
+     *    rescan still re-derives metadata, so skipping the eager drop loses
+     *    nothing.
+     *  - a genuine unlink (the file is gone) — leave `skipIfTailed` false so the
+     *    row is always removed, otherwise a deleted session ghosts in the cache.
+     */
+    invalidateByFilePath(filePath: string, opts?: {
+        skipIfTailed?: boolean;
+    }): string | null;
     /**
      * Drop rows whose `file_path` no longer exists on disk AND which have no
      * cached tail to fall back to. Rows with a tail are left alone so
@@ -579,30 +630,17 @@ declare class SessionsRepository {
     listManagedSessions(): ManagedSession[];
 }
 
-declare class PTYManager {
-    private sessions;
-    private onOutput;
-    private onStatusChange;
-    private onReady;
-    private onPermissionChange;
-    private onLiveQuestion;
-    private onLiveQuestionGone;
-    private permissionOpen;
-    private lastScreenQuestionKey;
-    private shellPromptOpen;
-    private pendingReady;
-    private queuedInputs;
-    private log;
-    private firstChunkAt;
-    private chunkIndex;
-    private lastChunkAt;
+declare class LiveSessionManager {
+    private runners;
     constructor(options?: PTYManagerOptions);
-    start(sessionId: string, options: StartSessionOptions): Promise<ManagedSession>;
-    startFresh(options: StartFreshSessionOptions): Promise<ManagedSession>;
-    sendKeys(sessionId: string, keys: string): void;
+    start(sessionId: string, options: StartSessionOptions & {
+        provider?: ProviderName;
+    }): Promise<ManagedSession>;
+    startFresh(options: StartFreshSessionOptions & {
+        provider?: ProviderName;
+    }): Promise<ManagedSession>;
     sendInput(sessionId: string, input: string): number;
-    private writeSubmit;
-    private flushQueuedInputs;
+    sendKeys(sessionId: string, keys: string): void;
     cancel(sessionId: string): void;
     killPid(pid: number): void;
     putOnHold(sessionId: string): void;
@@ -612,10 +650,8 @@ declare class PTYManager {
     hasSession(sessionId: string): boolean;
     listSessions(): ManagedSession[];
     dispose(): void;
-    private handleOutput;
-    private detectLivePrompts;
-    private markReady;
-    private handleExit;
+    private runnerFor;
+    private assertSupportedProvider;
 }
 
 declare class WSHub {
@@ -640,7 +676,7 @@ type ApiDeps = {
     };
     publicUrl: string | null;
     browseRoot: string | null;
-    ptyManager: PTYManager;
+    ptyManager: LiveSessionManager;
     sessionStore: SessionStore;
     wsHub: WSHub;
     cache: () => ConversationCache | null;
@@ -744,6 +780,47 @@ declare function createPool(config: DbConfig): Promise<Pool>;
 
 declare function discoverClaudeProcesses(): Promise<DiscoveredProcess[]>;
 
+declare class PTYManager implements SessionRunner {
+    private sessions;
+    private onOutput;
+    private onStatusChange;
+    private onReady;
+    private onPermissionChange;
+    private onLiveQuestion;
+    private onLiveQuestionGone;
+    private permissionOpen;
+    private lastScreenQuestionKey;
+    private shellPromptOpen;
+    private pendingReady;
+    private queuedInputs;
+    private log;
+    private firstChunkAt;
+    private chunkIndex;
+    private lastChunkAt;
+    private startPromises;
+    constructor(options?: PTYManagerOptions);
+    start(sessionId: string, options: StartSessionOptions): Promise<ManagedSession>;
+    private doStart;
+    startFresh(options: StartFreshSessionOptions): Promise<ManagedSession>;
+    sendKeys(sessionId: string, keys: string): void;
+    sendInput(sessionId: string, input: string): number;
+    private writeSubmit;
+    private flushQueuedInputs;
+    cancel(sessionId: string): void;
+    killPid(pid: number): void;
+    putOnHold(sessionId: string): void;
+    getOutput(sessionId: string): string;
+    getOutputLines(sessionId: string, maxLines: number): Promise<string[]>;
+    getSession(sessionId: string): ManagedSession | null;
+    hasSession(sessionId: string): boolean;
+    listSessions(): ManagedSession[];
+    dispose(): void;
+    private handleOutput;
+    private detectLivePrompts;
+    private markReady;
+    private handleExit;
+}
+
 declare class StreamerServer {
     private httpServer;
     private ptyManager;
@@ -860,6 +937,7 @@ declare class StreamerServer {
     private linkSessionToProject;
     private watchConversationFile;
     private watchForJsonl;
+    private watchForCodexRollout;
     private handleBrowse;
     private handleMkdir;
     private handleSetSessionName;
@@ -916,4 +994,4 @@ declare class ConversationWatcher {
     private readNewLines;
 }
 
-export { type AgentClient, type AgentClientOpts, type AgentConfig, type AppendArgs, type AskOption, type AskQuestion, type ConversationListResponse, ConversationWatcher, type ConversationWriter, type DbConfig, type DiscoveredProcess, type ManagedSession, PTYManager, type PTYManagerOptions, type PermissionOption, type ProgressDedupeLRU, type ServerConfig, type SessionCursor, type SessionListPage, type SessionListQuery, type SessionResponse, type SessionSortKey, type SessionStatus, SessionStore, type SortOrder, type StartFreshSessionOptions, type StartSessionOptions, StreamerServer, WSHub, type WSMessage, createAgentClient, createConversationWriter, createPool, createProgressDedupeLRU, createProgressRoutes, discoverClaudeProcesses, generateApiKey, getDbConfig, isDbEnabled, loadOrCreateApiKey, maskConnectionString, readAgentConfig, validateApiKey };
+export { type AgentClient, type AgentClientOpts, type AgentConfig, type AppendArgs, type AskOption, type AskQuestion, CLAUDE_CODE_PROVIDER, CODEX_CLI_PROVIDER, type ConversationListResponse, ConversationWatcher, type ConversationWriter, type DbConfig, type DiscoveredProcess, LiveSessionManager, type ManagedSession, PTYManager, type PTYManagerOptions, type PermissionOption, type ProgressDedupeLRU, type ProviderName, type ServerConfig, type SessionCursor, type SessionListPage, type SessionListQuery, type SessionResponse, type SessionRunner, type SessionSortKey, type SessionStatus, SessionStore, type SortOrder, type StartFreshSessionOptions, type StartSessionOptions, StreamerServer, WSHub, type WSMessage, createAgentClient, createConversationWriter, createPool, createProgressDedupeLRU, createProgressRoutes, discoverClaudeProcesses, generateApiKey, getDbConfig, isDbEnabled, isProviderName, isProviderResumable, loadOrCreateApiKey, maskConnectionString, readAgentConfig, validateApiKey };

package/dist/index.d.ts

@@ -76,9 +76,16 @@ interface Logger {
     pino: Logger$1;
 }
 
+declare const CLAUDE_CODE_PROVIDER: "claude-code";
+declare const CODEX_CLI_PROVIDER: "codex-cli";
+type ProviderName = typeof CLAUDE_CODE_PROVIDER | typeof CODEX_CLI_PROVIDER;
+declare function isProviderName(value: unknown): value is ProviderName;
+declare function isProviderResumable(_provider: string | null | undefined, availabilityResumable: boolean): boolean;
+
 type SessionStatus = "running" | "waiting_input" | "idle";
 interface ManagedSession {
     id: string;
+    provider?: ProviderName;
     projectId?: string;
     projectPath: string;
     projectName: string;
@@ -101,6 +108,15 @@ interface ManagedSession {
     lastActivityAt?: Date;
     filePath?: string;
     resumedFromConversationId?: string;
+    /**
+     * Set once a live session's underlying persisted conversation file is
+     * discovered after the fact (currently: fresh Codex sessions, whose
+     * rollout id isn't known until the CLI creates its own JSONL). Distinct
+     * from `resumedFromConversationId` (resume flow) and `conversationId` on
+     * `SessionResponse` (stable mobile deep-link alias, always === id for the
+     * lifetime of a live PTY) — must never be written into either of those.
+     */
+    boundConversationId?: string;
     /**
      * Multi-agent mode only. Per-session in-memory LRU of progress event ids
      * seen by the webhook receiver. Used to drop Temporal-replay duplicates
@@ -226,6 +242,7 @@ type WSMessage = {
 interface SessionResponse {
     id: string;
     conversationId: string;
+    provider?: ProviderName;
     projectId?: string;
     status: SessionStatus;
     projectPath: string;
@@ -251,6 +268,8 @@ interface SessionResponse {
     lastActivityAt?: string;
     filePath?: string;
     resumedFromConversationId?: string;
+    /** See `ManagedSession.boundConversationId` — never repurposes `conversationId`. */
+    boundConversationId?: string;
 }
 interface ConversationListResponse {
     conversations: unknown[];
@@ -324,6 +343,21 @@ interface StartFreshSessionOptions {
     projectName?: string;
     systemPrompt?: string;
 }
+interface SessionRunner {
+    start(sessionId: string, options: StartSessionOptions): Promise<ManagedSession>;
+    startFresh(options: StartFreshSessionOptions): Promise<ManagedSession>;
+    sendInput(sessionId: string, input: string): number;
+    sendKeys(sessionId: string, keys: string): void;
+    cancel(sessionId: string): void;
+    killPid(pid: number): void;
+    putOnHold(sessionId: string): void;
+    getOutput(sessionId: string): string;
+    getOutputLines(sessionId: string, maxLines: number): Promise<string[]>;
+    getSession(sessionId: string): ManagedSession | null;
+    hasSession(sessionId: string): boolean;
+    listSessions(): ManagedSession[];
+    dispose(): void;
+}
 
 interface ConversationCacheOptions {
     filterAgentConversations?: boolean;
@@ -454,7 +488,24 @@ declare class ConversationCache {
     getSessionName(sessionId: string): string | null;
     listSessionNames(): Record<string, string>;
     invalidate(id?: string): void;
-    invalidateByFilePath(filePath: string): string | null;
+    /**
+     * Drop the cached row for a file. Two callers with opposite intent:
+     *  - a directory-watch "change" event (the file was appended to) — pass
+     *    `skipIfTailed: true`. A cached tail means the row is being actively
+     *    maintained from the file's real content by the live-tail
+     *    (updateFromLines) or warm-up path, fresher than any scanner-derived
+     *    view. Both watchers fire on the same append with no ordering guarantee;
+     *    without this guard the invalidate can land after the tail write and wipe
+     *    the just-cached row, flickering the conversation out of
+     *    /api/conversations on nearly every message (CRITICAL #2). The debounced
+     *    rescan still re-derives metadata, so skipping the eager drop loses
+     *    nothing.
+     *  - a genuine unlink (the file is gone) — leave `skipIfTailed` false so the
+     *    row is always removed, otherwise a deleted session ghosts in the cache.
+     */
+    invalidateByFilePath(filePath: string, opts?: {
+        skipIfTailed?: boolean;
+    }): string | null;
     /**
      * Drop rows whose `file_path` no longer exists on disk AND which have no
      * cached tail to fall back to. Rows with a tail are left alone so
@@ -579,30 +630,17 @@ declare class SessionsRepository {
     listManagedSessions(): ManagedSession[];
 }
 
-declare class PTYManager {
-    private sessions;
-    private onOutput;
-    private onStatusChange;
-    private onReady;
-    private onPermissionChange;
-    private onLiveQuestion;
-    private onLiveQuestionGone;
-    private permissionOpen;
-    private lastScreenQuestionKey;
-    private shellPromptOpen;
-    private pendingReady;
-    private queuedInputs;
-    private log;
-    private firstChunkAt;
-    private chunkIndex;
-    private lastChunkAt;
+declare class LiveSessionManager {
+    private runners;
     constructor(options?: PTYManagerOptions);
-    start(sessionId: string, options: StartSessionOptions): Promise<ManagedSession>;
-    startFresh(options: StartFreshSessionOptions): Promise<ManagedSession>;
-    sendKeys(sessionId: string, keys: string): void;
+    start(sessionId: string, options: StartSessionOptions & {
+        provider?: ProviderName;
+    }): Promise<ManagedSession>;
+    startFresh(options: StartFreshSessionOptions & {
+        provider?: ProviderName;
+    }): Promise<ManagedSession>;
     sendInput(sessionId: string, input: string): number;
-    private writeSubmit;
-    private flushQueuedInputs;
+    sendKeys(sessionId: string, keys: string): void;
     cancel(sessionId: string): void;
     killPid(pid: number): void;
     putOnHold(sessionId: string): void;
@@ -612,10 +650,8 @@ declare class PTYManager {
     hasSession(sessionId: string): boolean;
     listSessions(): ManagedSession[];
     dispose(): void;
-    private handleOutput;
-    private detectLivePrompts;
-    private markReady;
-    private handleExit;
+    private runnerFor;
+    private assertSupportedProvider;
 }
 
 declare class WSHub {
@@ -640,7 +676,7 @@ type ApiDeps = {
     };
     publicUrl: string | null;
     browseRoot: string | null;
-    ptyManager: PTYManager;
+    ptyManager: LiveSessionManager;
     sessionStore: SessionStore;
     wsHub: WSHub;
     cache: () => ConversationCache | null;
@@ -744,6 +780,47 @@ declare function createPool(config: DbConfig): Promise<Pool>;
 
 declare function discoverClaudeProcesses(): Promise<DiscoveredProcess[]>;
 
+declare class PTYManager implements SessionRunner {
+    private sessions;
+    private onOutput;
+    private onStatusChange;
+    private onReady;
+    private onPermissionChange;
+    private onLiveQuestion;
+    private onLiveQuestionGone;
+    private permissionOpen;
+    private lastScreenQuestionKey;
+    private shellPromptOpen;
+    private pendingReady;
+    private queuedInputs;
+    private log;
+    private firstChunkAt;
+    private chunkIndex;
+    private lastChunkAt;
+    private startPromises;
+    constructor(options?: PTYManagerOptions);
+    start(sessionId: string, options: StartSessionOptions): Promise<ManagedSession>;
+    private doStart;
+    startFresh(options: StartFreshSessionOptions): Promise<ManagedSession>;
+    sendKeys(sessionId: string, keys: string): void;
+    sendInput(sessionId: string, input: string): number;
+    private writeSubmit;
+    private flushQueuedInputs;
+    cancel(sessionId: string): void;
+    killPid(pid: number): void;
+    putOnHold(sessionId: string): void;
+    getOutput(sessionId: string): string;
+    getOutputLines(sessionId: string, maxLines: number): Promise<string[]>;
+    getSession(sessionId: string): ManagedSession | null;
+    hasSession(sessionId: string): boolean;
+    listSessions(): ManagedSession[];
+    dispose(): void;
+    private handleOutput;
+    private detectLivePrompts;
+    private markReady;
+    private handleExit;
+}
+
 declare class StreamerServer {
     private httpServer;
     private ptyManager;
@@ -860,6 +937,7 @@ declare class StreamerServer {
     private linkSessionToProject;
     private watchConversationFile;
     private watchForJsonl;
+    private watchForCodexRollout;
     private handleBrowse;
     private handleMkdir;
     private handleSetSessionName;
@@ -916,4 +994,4 @@ declare class ConversationWatcher {
     private readNewLines;
 }
 
-export { type AgentClient, type AgentClientOpts, type AgentConfig, type AppendArgs, type AskOption, type AskQuestion, type ConversationListResponse, ConversationWatcher, type ConversationWriter, type DbConfig, type DiscoveredProcess, type ManagedSession, PTYManager, type PTYManagerOptions, type PermissionOption, type ProgressDedupeLRU, type ServerConfig, type SessionCursor, type SessionListPage, type SessionListQuery, type SessionResponse, type SessionSortKey, type SessionStatus, SessionStore, type SortOrder, type StartFreshSessionOptions, type StartSessionOptions, StreamerServer, WSHub, type WSMessage, createAgentClient, createConversationWriter, createPool, createProgressDedupeLRU, createProgressRoutes, discoverClaudeProcesses, generateApiKey, getDbConfig, isDbEnabled, loadOrCreateApiKey, maskConnectionString, readAgentConfig, validateApiKey };
+export { type AgentClient, type AgentClientOpts, type AgentConfig, type AppendArgs, type AskOption, type AskQuestion, CLAUDE_CODE_PROVIDER, CODEX_CLI_PROVIDER, type ConversationListResponse, ConversationWatcher, type ConversationWriter, type DbConfig, type DiscoveredProcess, LiveSessionManager, type ManagedSession, PTYManager, type PTYManagerOptions, type PermissionOption, type ProgressDedupeLRU, type ProviderName, type ServerConfig, type SessionCursor, type SessionListPage, type SessionListQuery, type SessionResponse, type SessionRunner, type SessionSortKey, type SessionStatus, SessionStore, type SortOrder, type StartFreshSessionOptions, type StartSessionOptions, StreamerServer, WSHub, type WSMessage, createAgentClient, createConversationWriter, createPool, createProgressDedupeLRU, createProgressRoutes, discoverClaudeProcesses, generateApiKey, getDbConfig, isDbEnabled, isProviderName, isProviderResumable, loadOrCreateApiKey, maskConnectionString, readAgentConfig, validateApiKey };