nterminal 1.2.79 → 1.2.81

package/dist/server/terminal/TerminalManager.d.ts

@@ -1,7 +1,7 @@
 import type { AppConfig } from '../config.js';
-import type { ServerTerminalMessage, TerminalHistoryCursor, TerminalHistoryResponse, TerminalTranscriptHistoryResponse, TerminalTranscriptSourceResponse } from '../../shared/protocol.js';
+import type { ServerTerminalMessage, TerminalHistoryCursor, TerminalHistoryResponse, TerminalSubagentsResponse, TerminalTranscriptHistoryResponse, TerminalTranscriptSourceResponse } from '../../shared/protocol.js';
 import type { TerminalCompletionOutcome, TerminalId, TerminalSummary } from '../../shared/types.js';
-import type { PtyAdapter } from './PtyAdapter.js';
+import { type PtyAdapter } from './PtyAdapter.js';
 export interface CreateTerminalOptions {
     parentTerminalId?: TerminalId;
     cwd?: string;
@@ -23,8 +23,12 @@ export interface TerminalManagerOptions {
     resolveCwd?: (pid: number) => Promise<string | null>;
     now?: () => Date;
     onCompletion?: (event: TerminalManagerCompletionEvent) => void | Promise<void>;
+    onDiagnostic?: (diagnostic: TerminalManagerDiagnostic) => void;
 }
-export interface WriteTerminalOptions {
+export interface TerminalControlOptions {
+    canExecute?: () => boolean;
+}
+export interface WriteTerminalOptions extends TerminalControlOptions {
     cancelScrollbackMode?: boolean;
 }
 export interface TerminalManagerCompletionEvent {
@@ -35,6 +39,24 @@ export interface TerminalManagerCompletionEvent {
     commandName?: string | null;
     occurredAt: string;
 }
+export interface TerminalManagerDiagnostic {
+    event: 'terminal.status_poll_failed' | 'terminal.process_snapshot_failed' | 'terminal.restore_failed' | 'terminal.transcript_poll_failed' | 'terminal.transcript_poll_slow' | 'terminal.reattach_failed' | 'terminal.destroy_failed' | 'terminal.close_failed';
+    terminalId?: TerminalId;
+    queueDepth?: number;
+    elapsedMs?: number;
+    error?: unknown;
+}
+export interface DestroyAllTerminalsResult {
+    requested: number;
+    destroyed: number;
+    failed: number;
+}
+export type RenameTerminalResult = {
+    status: 'renamed';
+    terminal: TerminalSummary;
+} | {
+    status: 'not_found' | 'closing' | 'persistence_failed' | 'queue_full';
+};
 type TerminalSubscriber = (message: ServerTerminalMessage) => void;
 export declare class TerminalManager {
     private readonly config;
@@ -43,47 +65,94 @@ export declare class TerminalManager {
     private readonly resolveCwd;
     private readonly now;
     private readonly onCompletion;
+    private readonly onDiagnostic;
     private readonly shellBasename;
     private readonly terminalCapabilities;
     private readonly agentTranscriptTracker;
+    private readonly transcriptQueue;
+    private readonly lastDiagnosticAt;
     private readonly completionStates;
     private statusPollTimer;
+    private restoreRetryTimer;
+    private restoreInflight;
     private statusPollInflight;
+    private activeTranscriptWorkers;
+    private readonly pendingInitializations;
+    private readonly reattachInflight;
+    private terminalResetBlockers;
+    private terminalMutationGeneration;
+    private shutdownRequested;
+    private disposed;
     constructor(config: AppConfig, ptyAdapter: PtyAdapter, options?: TerminalManagerOptions);
     private startStatusPoller;
+    private runStatusPoll;
     private pollOnce;
+    private applyProcessSnapshot;
+    private scheduleTranscriptRefresh;
+    private pumpTranscriptQueue;
+    private refreshAgentTranscript;
+    private refreshAgentTranscriptOnce;
     dispose(): void;
     createTerminal(options?: CreateTerminalOptions): Promise<TerminalSummary>;
+    private createTerminalUntracked;
     restoreSessions(): Promise<void>;
+    private restoreSessionsUntracked;
+    private scheduleRestoreRetry;
+    private clearRestoreRetryTimer;
     private wireUpPty;
+    private finishPtyExit;
+    private applyPtyExitState;
+    private persistentSessionState;
+    private markSessionUnavailable;
     private reattachToSession;
-    private captureTerminalHistoryCursor;
     listTerminals(): TerminalSummary[];
     getTerminal(id: TerminalId): TerminalSummary | null;
     getOutputSnapshot(id: TerminalId): string[] | null;
     getTerminalHistory(id: TerminalId, options?: {
         beforeLine?: number;
+        snapshotHistorySize?: number;
+        snapshotHistoryLimit?: number;
+        snapshotHistoryToken?: string;
+        snapshotPaneWidth?: number;
         limit?: number;
-    }): TerminalHistoryResponse | null;
+    }): Promise<TerminalHistoryResponse | null>;
+    private resolveLiveTranscriptSource;
+    private transcriptRequestStillLive;
     getTerminalTranscriptHistory(id: TerminalId, options?: {
         cursor?: string;
         limit?: number;
         maxLines?: number;
         includeTools?: boolean;
-    }): TerminalTranscriptHistoryResponse | null;
-    getTerminalTranscriptSource(id: TerminalId): TerminalTranscriptSourceResponse | null;
+    }): Promise<TerminalTranscriptHistoryResponse | null>;
+    getTerminalTranscriptSource(id: TerminalId): Promise<TerminalTranscriptSourceResponse | null>;
+    getTerminalSubagents(id: TerminalId): Promise<TerminalSubagentsResponse | null>;
+    getTerminalSubagentTranscript(id: TerminalId, subagentId: string, options?: {
+        cursor?: string;
+        limit?: number;
+        maxLines?: number;
+        includeTools?: boolean;
+    }): Promise<TerminalTranscriptHistoryResponse | null>;
     resolveTerminalCwd(id: TerminalId): Promise<string | null>;
-    renameTerminal(id: TerminalId, title: string): TerminalSummary | null;
+    renameTerminal(id: TerminalId, title: string): Promise<RenameTerminalResult>;
     refreshTerminalCwd(id: TerminalId): Promise<TerminalSummary | null>;
     attachTerminal(id: TerminalId, subscriber: TerminalSubscriber, options?: AttachTerminalOptions): TerminalAttachment | null;
-    writeToTerminal(id: TerminalId, data: string, options?: WriteTerminalOptions): boolean;
-    scrollTerminalScrollback(id: TerminalId, lines: number): boolean;
-    cancelTerminalScrollbackMode(id: TerminalId): boolean;
+    attachTerminalAsync(id: TerminalId, subscriber: TerminalSubscriber, options?: AttachTerminalOptions): Promise<TerminalAttachment | null>;
+    private createAttachment;
+    writeToTerminal(id: TerminalId, data: string, options?: WriteTerminalOptions): Promise<boolean>;
+    scrollTerminalScrollback(id: TerminalId, lines: number, options?: TerminalControlOptions): Promise<boolean>;
+    cancelTerminalScrollbackMode(id: TerminalId, options?: TerminalControlOptions): Promise<boolean>;
     resizeTerminal(id: TerminalId, cols: number, rows: number): boolean;
-    closeTerminal(id: TerminalId): boolean;
-    closeAll(): void;
-    destroyAllTerminals(): void;
+    closeTerminal(id: TerminalId): Promise<boolean>;
+    private sealPendingScroll;
+    private markClosing;
+    private recoverOrFinalizeFailedClose;
+    closeAll(): Promise<void>;
+    destroyAllTerminals(): Promise<DestroyAllTerminalsResult>;
+    private awaitPendingInitializations;
     private ensureAttached;
+    private ensureAttachedAsync;
+    private attachOrRefresh;
+    private refreshAndAttach;
     private resolveInitialCwd;
     private safeResolveCwd;
     private refreshCwd;
@@ -93,6 +162,10 @@ export declare class TerminalManager {
     private resolveAgentTranscript;
     private disposeRecord;
     private createTitle;
+    private cancelQueuedTranscriptRefresh;
     private timestamp;
+    private reportDiagnostic;
+    private canEnqueueControl;
+    private enqueueControl;
 }
 export {};