@bubblebrain-ai/bubble 0.0.52 → 0.0.54

package/dist/tui/animation-clock.js

@@ -0,0 +1,34 @@
+/**
+ * One clock owns all decorative TUI animation. Components expose pure frame
+ * advancement; they never create timers or request renders independently.
+ */
+export class TuiAnimationClock {
+    onTick;
+    intervalMs;
+    timer = null;
+    constructor(onTick, intervalMs = 100) {
+        this.onTick = onTick;
+        this.intervalMs = intervalMs;
+    }
+    setActive(active) {
+        if (active) {
+            if (this.timer)
+                return;
+            this.timer = setInterval(() => this.onTick(this.intervalMs), this.intervalMs);
+            return;
+        }
+        this.stop();
+    }
+    isActive() {
+        return this.timer !== null;
+    }
+    dispose() {
+        this.stop();
+    }
+    stop() {
+        if (!this.timer)
+            return;
+        clearInterval(this.timer);
+        this.timer = null;
+    }
+}

package/dist/tui/app.d.ts

@@ -0,0 +1,176 @@
+import { type TuiMode, type Terminal } from "@bubblebrain-ai/pi-tui";
+import { BubbleTuiController } from "./controller/controller.js";
+import { type ClipboardImageReader } from "./controller/composer-controller.js";
+import type { Agent } from "../agent.js";
+import { SessionManager } from "../session.js";
+import type { ProviderRegistry } from "../provider-registry.js";
+import type { QuestionController } from "../question/controller.js";
+import type { ApprovalDecision, ApprovalRequest } from "../approval/types.js";
+import type { PlanDecision } from "../types.js";
+import type { FeedbackPayload, SubmitResult } from "../feedback/types.js";
+import type { BashAllowlist } from "../approval/session-cache.js";
+import type { SkillRegistry } from "../skills/registry.js";
+import { type ResolvedTheme, type ThemeMode } from "./model/theme.js";
+export interface PiAppCallbacks {
+    onExitRequest(): void;
+    onClearTranscript(): void;
+    onThemeToggle(): void;
+    onThemeModeChange?(mode: import("../config.js").ThemeMode): void;
+    onCompact?(): void;
+}
+export interface PiTuiAppOptions {
+    agent: Agent;
+    sessionManager: SessionManager;
+    registry?: ProviderRegistry;
+    createProvider?: (providerId: string, apiKey: string, baseURL: string) => unknown;
+    skillRegistry?: SkillRegistry;
+    bashAllowlist?: BashAllowlist;
+    settingsManager?: unknown;
+    hookController?: unknown;
+    mcpManager?: unknown;
+    lspService?: unknown;
+    questionController?: QuestionController;
+    planHandlerRef?: {
+        current?: (plan: string) => Promise<PlanDecision>;
+    };
+    approvalHandlerRef?: {
+        current?: (request: ApprovalRequest) => Promise<ApprovalDecision>;
+    };
+    controller: BubbleTuiController;
+    callbacks: PiAppCallbacks;
+    /** Update notice already known from the local startup cache. */
+    updateNotice?: string;
+    /** Late registry result that should surface without restarting the TUI. */
+    updateNoticeRefresh?: Promise<string | null>;
+    flushMemory?: () => Promise<void>;
+    runMemoryCompaction?: () => Promise<string>;
+    runMemorySummary?: (scope?: string) => Promise<string>;
+    runMemoryRefresh?: (scope?: string) => Promise<string>;
+    /** Test/embedded host injection; production uses ProcessTerminal. */
+    terminal?: Terminal;
+    /** Renderer selected before the first terminal paint. Production defaults to fullscreen. */
+    uiMode?: TuiMode;
+    /** Non-blocking git lookup used to populate the footer after first paint. */
+    resolveGitBranch?: (cwd: string) => Promise<string | undefined>;
+    /** Override composer history storage (primarily for embedded hosts/tests). */
+    inputHistoryFilePath?: string;
+    /** Override the native clipboard image reader (primarily for embedded hosts/tests). */
+    readClipboardImage?: ClipboardImageReader;
+    /** Override feedback transport for embedded hosts and tests. */
+    submitFeedback?: (payload: FeedbackPayload) => Promise<SubmitResult>;
+    /** Persisted theme preference and the terminal color detected before raw mode. */
+    themeMode?: ThemeMode;
+    detectedTheme?: ResolvedTheme;
+    themeOverrides?: Record<string, string>;
+}
+export declare class PiTuiApp {
+    private readonly options;
+    private readonly tui;
+    private readonly editor;
+    private readonly composer;
+    private readonly composerPreview;
+    private readonly composerSlot;
+    private viewportScroll;
+    private readonly transcriptBox;
+    private readonly streamingMessage;
+    private readonly markdown;
+    private readonly markdownRenderer;
+    private readonly settledTranscript;
+    private readonly welcome;
+    private readonly footer;
+    private readonly tasksPane;
+    private readonly taskStatusBar;
+    private readonly animationClock;
+    private readonly traceInteraction;
+    private readonly overlays;
+    private themeMode;
+    private readonly detectedTheme;
+    private readonly themeOverrides?;
+    private theme;
+    private readonly transcriptTheme;
+    private gitBranch;
+    private metadataManager;
+    private metadataUnsubscribe;
+    private currentUpdateNotice?;
+    private updateNoticeRefreshStarted;
+    private showReasoning;
+    private verboseTrace;
+    private controllerUnsubscribe;
+    private questionUnsubscribe;
+    private activeQuestion;
+    private readonly questionQueue;
+    private providerKeyPhase;
+    private rewindPhase;
+    private rewindPreviewMessageIndex;
+    private feishuSetupPhase;
+    private disposed;
+    /** Compatibility/debug view backed by the canonical persistent history. */
+    get history(): string[];
+    constructor(options: PiTuiAppOptions);
+    private activeSessionManager;
+    private syncMetadataSubscription;
+    private installBlockingHandlers;
+    private buildLayout;
+    private wireInput;
+    private handleSubmit;
+    private handleCommand;
+    private buildSlashContext;
+    private pushUserRow;
+    private resolvedTheme;
+    private applyThemeMode;
+    private pushNotice;
+    private appendTranscriptRow;
+    private streamingMounted;
+    /** One display policy feeds both committed history and the live row pool. */
+    private transcriptRenderOptions;
+    renderSnapshot(): void;
+    /**
+     * The streaming preview is a persistent row-pool component mounted as the
+     * transcript's LAST child (upstream AssistantMessageComponent pattern).
+     * Rows are only ever setText — re-creating components per frame is what
+     * leaked every intermediate prefix into scrollback (verified with a
+     * VirtualTerminal matrix). On turn end it collapses to zero rows in the
+     * same frame the settled message commits, so the full answer replaces the
+     * preview with no duplicate.
+     */
+    private updateStreamingRegion;
+    private syncAnimationClock;
+    private fullscreen;
+    /**
+     * Switch to the alternate-screen transcript view. The main screen stays
+     * mounted but paused (stopped renderer); both modes subscribe to the same
+     * controller so the transcript stays in sync. Escape / Ctrl+C / /fullscreen
+     * return here.
+     */
+    private enterFullscreen;
+    private exitFullscreen;
+    private openImageViewer;
+    private openStats;
+    private openSkills;
+    private openSessionPicker;
+    private openContextInfo;
+    private openProviderKeyPhase;
+    private closeProviderKeyPhase;
+    private saveProviderKey;
+    private openRewindPicker;
+    private collectRewindPoints;
+    private cancelRunForRewind;
+    private waitForControllerIdle;
+    private executeRewindFromPicker;
+    private closeRewindPicker;
+    private previewRewindPoint;
+    private planDialog;
+    private openFeedback;
+    private openFeishuSetup;
+    private openWorkflowInspector;
+    private openSubagentInspector;
+    private handleTraceAction;
+    private openTaskInspector;
+    private approvalDialog;
+    private openNextQuestion;
+    private removeQueuedQuestion;
+    start(): void;
+    private watchUpdateNoticeRefresh;
+    dispose(): void;
+    waitUntilExit(): Promise<void>;
+}