@threadbase-sh/streamer 1.38.0 → 1.39.1

package/dist/index.d.cts

@@ -81,6 +81,9 @@ interface Logger {
 /** Claude Code `--permission-mode` values, as accepted by CLI v2.1.x. */
 declare const PERMISSION_MODES: readonly ["acceptEdits", "auto", "bypassPermissions", "manual", "dontAsk", "plan"];
 type PermissionMode = (typeof PERMISSION_MODES)[number];
+/** Claude Code `--effort` levels, as accepted by CLI v2.1.x. */
+declare const EFFORT_LEVELS: readonly ["low", "medium", "high", "xhigh", "max"];
+type EffortLevel = (typeof EFFORT_LEVELS)[number];
 type FlagValueType = "boolean" | "string" | "enum" | "list";
 /** How risky enabling a flag is. Drives the client's confirmation UX. */
 type FlagRisk = "low" | "elevated" | "dangerous";
@@ -245,6 +248,7 @@ type WSMessage = {
     type: "terminal_output";
     sessionId: string;
     data: string;
+    seq?: number;
 } | {
     type: "session_update";
     session?: SessionResponse;
@@ -303,6 +307,7 @@ type WSMessage = {
     sessionId: string;
     lines: string[];
     userMessages?: UserMessage[];
+    seq?: number;
 } | {
     type: "session_ready";
     session: SessionResponse;
@@ -493,6 +498,7 @@ interface ServerConfig {
     }>;
     codexRoots?: string[];
     scannerPersistent?: boolean;
+    skipStartupWarmup?: boolean;
     ptyGracePeriodMs?: number;
     cacheDir?: string;
     tailSize?: number;
@@ -502,7 +508,7 @@ interface ServerConfig {
     featureFlags?: FeatureFlagValues;
     defaultPermissionMode?: PermissionMode;
     defaultModel?: string;
-    defaultEffort?: "low" | "medium" | "high" | "xhigh" | "max";
+    defaultEffort?: EffortLevel;
     claudeFlags?: ClaudeFlagValues;
     claudeExtraArgs?: string;
 }
@@ -527,7 +533,7 @@ interface StartSessionOptions {
     branch?: string;
     permissionMode?: PermissionMode;
     model?: string;
-    effort?: "low" | "medium" | "high" | "xhigh" | "max";
+    effort?: EffortLevel;
     claudeFlags?: ClaudeFlagValues;
     claudeExtraArgs?: string;
 }
@@ -537,7 +543,7 @@ interface StartFreshSessionOptions {
     systemPrompt?: string;
     permissionMode?: PermissionMode;
     model?: string;
-    effort?: "low" | "medium" | "high" | "xhigh" | "max";
+    effort?: EffortLevel;
     claudeFlags?: ClaudeFlagValues;
     claudeExtraArgs?: string;
 }
@@ -1277,6 +1283,7 @@ declare class WSHub {
     private pongTimers;
     addClient(ws: WebSocket): void;
     broadcast(message: WSMessage): void;
+    broadcastToClients(clients: Iterable<WebSocket>, message: WSMessage): void;
     unicast(ws: WebSocket, message: WSMessage): void;
     get connectionCount(): number;
     dispose(): void;
@@ -1418,6 +1425,8 @@ type ApiDeps = {
     handleCancel: (sessionId: string, res: ServerResponse) => void;
     handleStopSession: (sessionId: string, res: ServerResponse) => Promise<void>;
     handleSetSessionName: (sessionId: string, req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    handleSetSessionModel: (sessionId: string, req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    handleSetSessionEffort: (sessionId: string, req: IncomingMessage, res: ServerResponse) => Promise<void>;
     handleUploadFile: (sessionId: string, req: IncomingMessage, res: ServerResponse) => Promise<void>;
     handleAdopt: (sessionId: string, res: ServerResponse) => Promise<void>;
     handleResume: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
@@ -1573,6 +1582,7 @@ declare class StreamerServer {
     private allScanners;
     private scannerReady;
     private scannerStale;
+    private staleFiles;
     private conversationReconcileInFlight;
     private refreshInFlight;
     private binding;
@@ -1588,6 +1598,7 @@ declare class StreamerServer {
     private dbPool;
     private dbInstanceId;
     private disableDb;
+    private skipStartupWarmup;
     private browseRoot;
     private publicUrl;
     private browserCors;
@@ -1609,6 +1620,7 @@ declare class StreamerServer {
     private ptyGraceDeferCounts;
     private sessionSubscribers;
     private lastAgentChunkAt;
+    private terminalSeq;
     private idempotency;
     private sessionLifecycles;
     private idleReaperTimer;
@@ -1782,6 +1794,21 @@ declare class StreamerServer {
      * permission prompts entirely, so it needs a forensic trail.
      */
     private setClaudeFlagsConfig;
+    /**
+     * The three spawn options that a configured claude-flag can override, with
+     * the boot-time CLI/yaml default as the fallback. Spread into every
+     * start/resume/adopt call so all three paths agree.
+     *
+     * These ids are excluded from buildFlagArgs (SPAWN_POSITIONAL_FLAG_IDS)
+     * precisely because they arrive here instead — the PTY spawn paths pass them
+     * as explicit positionals, so emitting them from the allowlist too would
+     * duplicate the flag.
+     *
+     * Narrowed with the type guards rather than cast: ClaudeFlagValues is a loose
+     * Record by design, and while validateFlagValues already guarantees the shape
+     * on the way in, TypeScript cannot see that through the record.
+     */
+    private spawnFlagOverrides;
     private checkRateLimit;
     private checkExchangeRateLimit;
     private checkSessionStartRateLimit;
@@ -1795,7 +1822,8 @@ declare class StreamerServer {
      */
     private reconcileConversationsCacheFromDisk;
     private startBackgroundConversationReconcile;
-    private shouldAutoReconcileConversationList;
+    private conversationReconcileMode;
+    private reconcileStaleFilesFromDisk;
     private handleListConversations;
     private handleConversationsCount;
     private refreshCountInBackground;
@@ -1805,6 +1833,8 @@ declare class StreamerServer {
     private buildStatCache;
     private codexScanOpts;
     private newScanner;
+    private takeStaleFiles;
+    private refreshStaleFiles;
     private getScanner;
     private getFreshScanner;
     private rescanForRefresh;
@@ -1902,6 +1932,21 @@ declare class StreamerServer {
     private handleBrowse;
     private handleMkdir;
     private handleSetSessionName;
+    /**
+     * Retarget a LIVE session's model or effort by typing the corresponding
+     * Claude Code slash command into its PTY.
+     *
+     * There is no CLI or IPC channel for this — `--model`/`--effort` are spawn
+     * arguments — so the interactive `/model <x>` / `/effort <y>` commands are the
+     * only way to change a session already running. Both accept an argument and
+     * apply it without opening the picker (verified against Claude Code v2.1.220).
+     *
+     * Answers 202, not 200: the value is applied by the TUI on its next render, so
+     * there is nothing truthful to echo back synchronously. Clients confirm with
+     * `GET /api/sessions/:id`, which scrapes the applied value off the live status
+     * line.
+     */
+    private applyLiveSessionSetting;
     private handleGetSessionNames;
 }
 

package/dist/index.d.ts

@@ -81,6 +81,9 @@ interface Logger {
 /** Claude Code `--permission-mode` values, as accepted by CLI v2.1.x. */
 declare const PERMISSION_MODES: readonly ["acceptEdits", "auto", "bypassPermissions", "manual", "dontAsk", "plan"];
 type PermissionMode = (typeof PERMISSION_MODES)[number];
+/** Claude Code `--effort` levels, as accepted by CLI v2.1.x. */
+declare const EFFORT_LEVELS: readonly ["low", "medium", "high", "xhigh", "max"];
+type EffortLevel = (typeof EFFORT_LEVELS)[number];
 type FlagValueType = "boolean" | "string" | "enum" | "list";
 /** How risky enabling a flag is. Drives the client's confirmation UX. */
 type FlagRisk = "low" | "elevated" | "dangerous";
@@ -245,6 +248,7 @@ type WSMessage = {
     type: "terminal_output";
     sessionId: string;
     data: string;
+    seq?: number;
 } | {
     type: "session_update";
     session?: SessionResponse;
@@ -303,6 +307,7 @@ type WSMessage = {
     sessionId: string;
     lines: string[];
     userMessages?: UserMessage[];
+    seq?: number;
 } | {
     type: "session_ready";
     session: SessionResponse;
@@ -493,6 +498,7 @@ interface ServerConfig {
     }>;
     codexRoots?: string[];
     scannerPersistent?: boolean;
+    skipStartupWarmup?: boolean;
     ptyGracePeriodMs?: number;
     cacheDir?: string;
     tailSize?: number;
@@ -502,7 +508,7 @@ interface ServerConfig {
     featureFlags?: FeatureFlagValues;
     defaultPermissionMode?: PermissionMode;
     defaultModel?: string;
-    defaultEffort?: "low" | "medium" | "high" | "xhigh" | "max";
+    defaultEffort?: EffortLevel;
     claudeFlags?: ClaudeFlagValues;
     claudeExtraArgs?: string;
 }
@@ -527,7 +533,7 @@ interface StartSessionOptions {
     branch?: string;
     permissionMode?: PermissionMode;
     model?: string;
-    effort?: "low" | "medium" | "high" | "xhigh" | "max";
+    effort?: EffortLevel;
     claudeFlags?: ClaudeFlagValues;
     claudeExtraArgs?: string;
 }
@@ -537,7 +543,7 @@ interface StartFreshSessionOptions {
     systemPrompt?: string;
     permissionMode?: PermissionMode;
     model?: string;
-    effort?: "low" | "medium" | "high" | "xhigh" | "max";
+    effort?: EffortLevel;
     claudeFlags?: ClaudeFlagValues;
     claudeExtraArgs?: string;
 }
@@ -1277,6 +1283,7 @@ declare class WSHub {
     private pongTimers;
     addClient(ws: WebSocket): void;
     broadcast(message: WSMessage): void;
+    broadcastToClients(clients: Iterable<WebSocket>, message: WSMessage): void;
     unicast(ws: WebSocket, message: WSMessage): void;
     get connectionCount(): number;
     dispose(): void;
@@ -1418,6 +1425,8 @@ type ApiDeps = {
     handleCancel: (sessionId: string, res: ServerResponse) => void;
     handleStopSession: (sessionId: string, res: ServerResponse) => Promise<void>;
     handleSetSessionName: (sessionId: string, req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    handleSetSessionModel: (sessionId: string, req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    handleSetSessionEffort: (sessionId: string, req: IncomingMessage, res: ServerResponse) => Promise<void>;
     handleUploadFile: (sessionId: string, req: IncomingMessage, res: ServerResponse) => Promise<void>;
     handleAdopt: (sessionId: string, res: ServerResponse) => Promise<void>;
     handleResume: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
@@ -1573,6 +1582,7 @@ declare class StreamerServer {
     private allScanners;
     private scannerReady;
     private scannerStale;
+    private staleFiles;
     private conversationReconcileInFlight;
     private refreshInFlight;
     private binding;
@@ -1588,6 +1598,7 @@ declare class StreamerServer {
     private dbPool;
     private dbInstanceId;
     private disableDb;
+    private skipStartupWarmup;
     private browseRoot;
     private publicUrl;
     private browserCors;
@@ -1609,6 +1620,7 @@ declare class StreamerServer {
     private ptyGraceDeferCounts;
     private sessionSubscribers;
     private lastAgentChunkAt;
+    private terminalSeq;
     private idempotency;
     private sessionLifecycles;
     private idleReaperTimer;
@@ -1782,6 +1794,21 @@ declare class StreamerServer {
      * permission prompts entirely, so it needs a forensic trail.
      */
     private setClaudeFlagsConfig;
+    /**
+     * The three spawn options that a configured claude-flag can override, with
+     * the boot-time CLI/yaml default as the fallback. Spread into every
+     * start/resume/adopt call so all three paths agree.
+     *
+     * These ids are excluded from buildFlagArgs (SPAWN_POSITIONAL_FLAG_IDS)
+     * precisely because they arrive here instead — the PTY spawn paths pass them
+     * as explicit positionals, so emitting them from the allowlist too would
+     * duplicate the flag.
+     *
+     * Narrowed with the type guards rather than cast: ClaudeFlagValues is a loose
+     * Record by design, and while validateFlagValues already guarantees the shape
+     * on the way in, TypeScript cannot see that through the record.
+     */
+    private spawnFlagOverrides;
     private checkRateLimit;
     private checkExchangeRateLimit;
     private checkSessionStartRateLimit;
@@ -1795,7 +1822,8 @@ declare class StreamerServer {
      */
     private reconcileConversationsCacheFromDisk;
     private startBackgroundConversationReconcile;
-    private shouldAutoReconcileConversationList;
+    private conversationReconcileMode;
+    private reconcileStaleFilesFromDisk;
     private handleListConversations;
     private handleConversationsCount;
     private refreshCountInBackground;
@@ -1805,6 +1833,8 @@ declare class StreamerServer {
     private buildStatCache;
     private codexScanOpts;
     private newScanner;
+    private takeStaleFiles;
+    private refreshStaleFiles;
     private getScanner;
     private getFreshScanner;
     private rescanForRefresh;
@@ -1902,6 +1932,21 @@ declare class StreamerServer {
     private handleBrowse;
     private handleMkdir;
     private handleSetSessionName;
+    /**
+     * Retarget a LIVE session's model or effort by typing the corresponding
+     * Claude Code slash command into its PTY.
+     *
+     * There is no CLI or IPC channel for this — `--model`/`--effort` are spawn
+     * arguments — so the interactive `/model <x>` / `/effort <y>` commands are the
+     * only way to change a session already running. Both accept an argument and
+     * apply it without opening the picker (verified against Claude Code v2.1.220).
+     *
+     * Answers 202, not 200: the value is applied by the TUI on its next render, so
+     * there is nothing truthful to echo back synchronously. Clients confirm with
+     * `GET /api/sessions/:id`, which scrapes the applied value off the live status
+     * line.
+     */
+    private applyLiveSessionSetting;
     private handleGetSessionNames;
 }