@wrongstack/tui 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 ECOSTACK TECHNOLOGY OÜ
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { Agent, SlashCommandRegistry, AttachmentStore, EventBus, TokenCounter, QueueStore } from '@wrongstack/core';
+
+interface RunTuiOptions {
+    agent: Agent;
+    slashRegistry: SlashCommandRegistry;
+    attachments: AttachmentStore;
+    events: EventBus;
+    tokenCounter?: TokenCounter;
+    model: string;
+    banner?: boolean;
+    /** Persists the input queue across crashes; if omitted, the queue is in-memory only. */
+    queueStore?: QueueStore;
+    /** Surfaces the "⚠ YOLO" chip in the status bar. */
+    yolo?: boolean;
+    /** Renders in the startup banner. Read from the CLI's package.json. */
+    appVersion?: string;
+    /** Provider id for the startup banner ("openai", "anthropic", ...). */
+    provider?: string;
+    /**
+     * Model-specific maxContext (tokens), resolved by the CLI via the
+     * ModelsRegistry. When omitted, the TUI falls back to the provider
+     * family's baseline (e.g. anthropic = 200_000), which can be wrong
+     * for variants like the 1M-context Opus build. The status bar's
+     * context chip uses this for its progress denominator.
+     */
+    effectiveMaxContext?: number;
+    /**
+     * Render into the terminal's alternate screen buffer (like vim/less/htop).
+     * Default: false — we render into normal scrollback so the user can
+     * scroll history with the terminal's native mouse wheel / Shift+PgUp,
+     * and so completed chat survives after exit. Pass true to switch to
+     * a fixed full-screen view (no scrollback, no native scroll); useful
+     * when terminal redraw flicker is bad enough to outweigh the loss of
+     * scrollback.
+     */
+    altScreen?: boolean;
+    /**
+     * Called right after we exit the alt-screen on a clean shutdown. The
+     * CLI uses this to print a one-line "session saved to …" hint into
+     * the user's normal terminal, since alt-screen exit erases the whole
+     * TUI view.
+     */
+    onAfterExit?: () => void;
+}
+declare function runTui(opts: RunTuiOptions): Promise<number>;
+
+export { type RunTuiOptions, runTui };