@threadbase-sh/streamer 1.23.1 → 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;
@@ -596,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;
@@ -629,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 {
@@ -657,7 +676,7 @@ type ApiDeps = {
     };
     publicUrl: string | null;
     browseRoot: string | null;
-    ptyManager: PTYManager;
+    ptyManager: LiveSessionManager;
     sessionStore: SessionStore;
     wsHub: WSHub;
     cache: () => ConversationCache | null;
@@ -761,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;
@@ -877,6 +937,7 @@ declare class StreamerServer {
     private linkSessionToProject;
     private watchConversationFile;
     private watchForJsonl;
+    private watchForCodexRollout;
     private handleBrowse;
     private handleMkdir;
     private handleSetSessionName;
@@ -933,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;
@@ -596,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;
@@ -629,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 {
@@ -657,7 +676,7 @@ type ApiDeps = {
     };
     publicUrl: string | null;
     browseRoot: string | null;
-    ptyManager: PTYManager;
+    ptyManager: LiveSessionManager;
     sessionStore: SessionStore;
     wsHub: WSHub;
     cache: () => ConversationCache | null;
@@ -761,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;
@@ -877,6 +937,7 @@ declare class StreamerServer {
     private linkSessionToProject;
     private watchConversationFile;
     private watchForJsonl;
+    private watchForCodexRollout;
     private handleBrowse;
     private handleMkdir;
     private handleSetSessionName;
@@ -933,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 };