@saccolabs/tars 1.35.1 → 1.37.0

package/dist/channels/channel-manager.d.ts

@@ -12,6 +12,11 @@ export declare class ChannelManager {
      * Initialize enabled channels based on configuration
      */
     private initializeChannels;
+    /**
+     * Register an additional communication channel at runtime.
+     * Used to add channels like the TUI that aren't config-driven.
+     */
+    registerChannel(channel: CommunicationChannel): void;
     /**
      * Start all enabled channels
      */

package/dist/channels/channel-manager.js

@@ -23,6 +23,13 @@ export class ChannelManager {
             this.channels.set(discord.id, discord);
         }
     }
+    /**
+     * Register an additional communication channel at runtime.
+     * Used to add channels like the TUI that aren't config-driven.
+     */
+    registerChannel(channel) {
+        this.channels.set(channel.id, channel);
+    }
     /**
      * Start all enabled channels
      */

package/dist/channels/channel-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel-manager.js","sourceRoot":"","sources":["../../src/channels/channel-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"channel-manager.js","sourceRoot":"","sources":["../../src/channels/channel-manager.ts"],"names":[],"mappings":"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"}

package/dist/channels/tui/tui-channel.d.ts

@@ -0,0 +1,98 @@
+import type { Terminal } from '@earendil-works/pi-tui';
+import { CommunicationChannel, ChannelMessage } from '../types.js';
+/**
+ * Custom Terminal implementation wrapping Readable and Writable streams.
+ * Used for testing and custom I/O redirection.
+ */
+export declare class StreamTerminal implements Terminal {
+    private readonly input;
+    private readonly output;
+    private inputHandler?;
+    private wasRaw;
+    constructor(input: NodeJS.ReadableStream, output: NodeJS.WritableStream);
+    start(onInput: (data: string) => void, onResize: () => void): void;
+    private handleData;
+    stop(): void;
+    drainInput(maxMs?: number, idleMs?: number): Promise<void>;
+    write(data: string): void;
+    get columns(): number;
+    get rows(): number;
+    get kittyProtocolActive(): boolean;
+    moveBy(lines: number): void;
+    hideCursor(): void;
+    showCursor(): void;
+    clearLine(): void;
+    clearFromCursor(): void;
+    clearScreen(): void;
+    setTitle(title: string): void;
+    setProgress(active: boolean): void;
+}
+/**
+ * Terminal UI (TUI) Channel Implementation for Tars.
+ * Provides an interactive chat experience in the terminal with
+ * real-time token streaming, status updates, and markdown rendering.
+ */
+export declare class TuiChannel implements CommunicationChannel {
+    readonly id = "tui";
+    readonly isEnabled = true;
+    private messageHandler?;
+    private terminal;
+    private tui;
+    private chatContainer;
+    private statusContainer;
+    private editor;
+    private isProcessing;
+    private onExitCallback?;
+    private isStopped;
+    private activeStreamingComponent?;
+    private activeStreamingText;
+    private activeStatusComponent?;
+    private loader?;
+    private lastStatusLineCount;
+    private readonly input;
+    private readonly output;
+    constructor(opts?: {
+        input?: NodeJS.ReadableStream;
+        output?: NodeJS.WritableStream;
+        onExit?: () => Promise<void>;
+    });
+    /**
+     * Start the TUI — render logo, show header, enter TUI rendering loop.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the TUI channel.
+     */
+    stop(): Promise<void>;
+    /**
+     * Send a proactive notification to the terminal.
+     * Used for status updates (first send) and background task notifications.
+     */
+    notify(content: string): Promise<void>;
+    /**
+     * Edit the last status notification in-place using TUI states.
+     * Returns true if the edit succeeded.
+     */
+    editStatus(content: string): Promise<boolean>;
+    /**
+     * Clear the tracked status message.
+     */
+    clearStatus(): void;
+    /**
+     * Register message handler.
+     */
+    onMessage(handler: (message: ChannelMessage) => Promise<void>): void;
+    /**
+     * Stream a text chunk directly to the terminal (no buffering).
+     * Called by the event handler in bootstrap for real-time token streaming.
+     */
+    streamText(text: string): void;
+    /**
+     * Write directly to output stream (utility for commands).
+     */
+    private write;
+    /**
+     * Clear last status lines (legacy compatibility helper).
+     */
+    private clearLastStatus;
+}

package/dist/channels/tui/tui-channel.js

@@ -0,0 +1,362 @@
+import chalk from 'chalk';
+import { TUI, ProcessTerminal, Editor, Markdown, Loader, CombinedAutocompleteProvider, Container } from '@earendil-works/pi-tui';
+import { TuiRenderer } from './tui-renderer.js';
+import { versionString } from '../../utils/version.js';
+import { Config } from '../../config/config.js';
+/**
+ * Custom Terminal implementation wrapping Readable and Writable streams.
+ * Used for testing and custom I/O redirection.
+ */
+export class StreamTerminal {
+    input;
+    output;
+    inputHandler;
+    wasRaw = false;
+    constructor(input, output) {
+        this.input = input;
+        this.output = output;
+    }
+    start(onInput, onResize) {
+        this.inputHandler = onInput;
+        this.wasRaw = this.input.isRaw || false;
+        if (this.input.setRawMode) {
+            try {
+                this.input.setRawMode(true);
+            }
+            catch { }
+        }
+        if (typeof this.input.resume === 'function') {
+            this.input.resume();
+        }
+        this.input.on('data', this.handleData);
+    }
+    handleData = (chunk) => {
+        if (this.inputHandler) {
+            this.inputHandler(chunk.toString('utf8'));
+        }
+    };
+    stop() {
+        this.input.removeListener('data', this.handleData);
+        if (this.input.setRawMode) {
+            try {
+                this.input.setRawMode(this.wasRaw);
+            }
+            catch { }
+        }
+        if (typeof this.input.pause === 'function') {
+            this.input.pause();
+        }
+    }
+    async drainInput(maxMs = 1000, idleMs = 50) {
+        await new Promise((resolve) => setTimeout(resolve, idleMs));
+    }
+    write(data) {
+        this.output.write(data);
+    }
+    get columns() {
+        return this.output.columns || 80;
+    }
+    get rows() {
+        return this.output.rows || 24;
+    }
+    get kittyProtocolActive() {
+        return false;
+    }
+    moveBy(lines) {
+        if (lines > 0) {
+            this.write(`\x1b[${lines}B`);
+        }
+        else if (lines < 0) {
+            this.write(`\x1b[${-lines}A`);
+        }
+    }
+    hideCursor() {
+        this.write('\x1b[?25l');
+    }
+    showCursor() {
+        this.write('\x1b[?25h');
+    }
+    clearLine() {
+        this.write('\x1b[K');
+    }
+    clearFromCursor() {
+        this.write('\x1b[J');
+    }
+    clearScreen() {
+        this.write('\x1b[2J\x1b[H');
+    }
+    setTitle(title) {
+        this.write(`\x1b]0;${title}\x07`);
+    }
+    setProgress(active) { }
+}
+/**
+ * Terminal UI (TUI) Channel Implementation for Tars.
+ * Provides an interactive chat experience in the terminal with
+ * real-time token streaming, status updates, and markdown rendering.
+ */
+export class TuiChannel {
+    id = 'tui';
+    isEnabled = true;
+    messageHandler;
+    terminal;
+    tui;
+    chatContainer;
+    statusContainer;
+    editor;
+    isProcessing = false;
+    onExitCallback;
+    isStopped = false;
+    activeStreamingComponent;
+    activeStreamingText = '';
+    activeStatusComponent;
+    loader;
+    lastStatusLineCount = 0;
+    // Allow injecting custom streams for testing
+    input;
+    output;
+    constructor(opts = {}) {
+        this.input = opts.input || process.stdin;
+        this.output = opts.output || process.stdout;
+        this.onExitCallback = opts.onExit;
+    }
+    /**
+     * Start the TUI — render logo, show header, enter TUI rendering loop.
+     */
+    async start() {
+        const config = Config.getInstance();
+        // 1. Initialize Terminal layer
+        if (this.input === process.stdin && this.output === process.stdout) {
+            this.terminal = new ProcessTerminal();
+        }
+        else {
+            this.terminal = new StreamTerminal(this.input, this.output);
+        }
+        // 2. Initialize TUI manager
+        this.tui = new TUI(this.terminal);
+        // 3. Create initial static components (Logo & Header)
+        const logo = TuiRenderer.renderLogo();
+        const header = TuiRenderer.renderHeader({
+            version: versionString,
+            provider: config.piProvider,
+            model: config.piModel,
+            contextWindow: config.contextWindowTokens,
+            assistantName: config.assistantName
+        });
+        this.tui.addChild(new Markdown(logo + '\n' + header + '\n', 1, 0, TuiRenderer.markdownTheme));
+        // 4. Create Chat History Container
+        this.chatContainer = new Container();
+        this.tui.addChild(this.chatContainer);
+        // 5. Create Status updates Container (keeps status below chat but above editor)
+        this.statusContainer = new Container();
+        this.tui.addChild(this.statusContainer);
+        // 6. Create Input Editor
+        this.editor = new Editor(this.tui, TuiRenderer.editorTheme);
+        // Configure Autocomplete
+        const autocomplete = new CombinedAutocompleteProvider([
+            { name: 'help', description: 'Show list of available commands and usage guide' },
+            { name: 'exit', description: 'Gracefully shut down the session and exit the TUI' },
+            {
+                name: 'stats',
+                description: 'Display current session status and token statistics'
+            },
+            {
+                name: 'reset',
+                description: 'Clear session context and reset conversation history'
+            }
+        ], process.cwd());
+        this.editor.setAutocompleteProvider(autocomplete);
+        // Setup Submit handler
+        this.editor.onSubmit = async (value) => {
+            if (this.isProcessing)
+                return;
+            const trimmed = value.trim();
+            if (!trimmed)
+                return;
+            // Handle TUI-local commands
+            const lowerVal = trimmed.toLowerCase();
+            if (lowerVal === '/exit' || lowerVal === '/quit') {
+                this.write('\n👋 Goodbye.\n');
+                if (this.onExitCallback) {
+                    await this.onExitCallback();
+                }
+                await this.stop();
+                process.exit(0);
+                return;
+            }
+            if (!this.messageHandler)
+                return;
+            // Clear input box
+            this.editor.setText('');
+            this.isProcessing = true;
+            this.editor.disableSubmit = true;
+            // Reset active stream states
+            this.activeStreamingComponent = undefined;
+            this.activeStreamingText = '';
+            // Add user message to history
+            this.chatContainer.addChild(new Markdown(`**❯** ${trimmed}`, 1, 0, TuiRenderer.markdownTheme));
+            this.tui.requestRender();
+            // Display "Thinking..." Loader
+            this.loader = new Loader(this.tui, (s) => chalk.yellow(s), (s) => chalk.dim(s), 'Thinking...');
+            this.tui.addChild(this.loader);
+            this.tui.requestRender();
+            const channelMessage = {
+                content: trimmed,
+                senderId: 'tui-user',
+                senderName: 'user',
+                channelId: 'tui',
+                reply: async (content) => {
+                    this.clearLastStatus();
+                    if (!this.tui) {
+                        const formatted = TuiRenderer.formatMarkdown(content);
+                        this.write(formatted + '\n');
+                        return;
+                    }
+                    if (this.loader) {
+                        this.tui.removeChild(this.loader);
+                        this.loader = undefined;
+                    }
+                    // Format and append response to chat history
+                    this.chatContainer.addChild(new Markdown(content, 1, 0, TuiRenderer.markdownTheme));
+                    this.tui.requestRender();
+                },
+                startTyping: () => { },
+                stopTyping: () => {
+                    if (!this.tui) {
+                        this.isProcessing = false;
+                        return;
+                    }
+                    if (this.loader) {
+                        this.tui.removeChild(this.loader);
+                        this.loader = undefined;
+                    }
+                    this.isProcessing = false;
+                    this.editor.disableSubmit = false;
+                    this.tui.setFocus(this.editor);
+                    this.tui.requestRender();
+                }
+            };
+            await this.messageHandler(channelMessage);
+        };
+        this.tui.addChild(this.editor);
+        this.tui.setFocus(this.editor);
+        // 7. Start TUI loop
+        this.tui.start();
+    }
+    /**
+     * Stop the TUI channel.
+     */
+    async stop() {
+        if (this.isStopped)
+            return;
+        this.isStopped = true;
+        this.tui?.stop();
+    }
+    /**
+     * Send a proactive notification to the terminal.
+     * Used for status updates (first send) and background task notifications.
+     */
+    async notify(content) {
+        if (!content.trim())
+            return;
+        if (!this.tui) {
+            const formatted = TuiRenderer.formatMarkdown(content);
+            this.write(formatted + '\n');
+            this.lastStatusLineCount = TuiRenderer.countLines(formatted, this.output.columns || 80);
+            return;
+        }
+        // Clear existing status component if present
+        this.statusContainer.clear();
+        const statusMarkdown = new Markdown(content, 1, 0, TuiRenderer.markdownTheme);
+        this.statusContainer.addChild(statusMarkdown);
+        this.activeStatusComponent = statusMarkdown;
+        this.tui.requestRender();
+    }
+    /**
+     * Edit the last status notification in-place using TUI states.
+     * Returns true if the edit succeeded.
+     */
+    async editStatus(content) {
+        if (!this.tui) {
+            if (this.lastStatusLineCount <= 0)
+                return false;
+            try {
+                TuiRenderer.clearLines(this.output, this.lastStatusLineCount);
+                const formatted = TuiRenderer.formatMarkdown(content);
+                this.write(formatted + '\n');
+                this.lastStatusLineCount = TuiRenderer.countLines(formatted, this.output.columns || 80);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        if (!this.activeStatusComponent)
+            return false;
+        this.activeStatusComponent.setText(content);
+        this.tui.requestRender();
+        return true;
+    }
+    /**
+     * Clear the tracked status message.
+     */
+    clearStatus() {
+        if (!this.tui) {
+            if (this.lastStatusLineCount > 0) {
+                try {
+                    TuiRenderer.clearLines(this.output, this.lastStatusLineCount);
+                }
+                catch { }
+            }
+            this.lastStatusLineCount = 0;
+            return;
+        }
+        this.statusContainer.clear();
+        this.activeStatusComponent = undefined;
+        this.tui.requestRender();
+    }
+    /**
+     * Register message handler.
+     */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    /**
+     * Stream a text chunk directly to the terminal (no buffering).
+     * Called by the event handler in bootstrap for real-time token streaming.
+     */
+    streamText(text) {
+        if (!this.tui) {
+            this.write(text);
+            return;
+        }
+        // Remove loader spinner if active
+        if (this.loader) {
+            this.tui.removeChild(this.loader);
+            this.loader = undefined;
+        }
+        if (!this.activeStreamingComponent) {
+            this.activeStreamingComponent = new Markdown(text, 1, 0, TuiRenderer.markdownTheme);
+            this.chatContainer.addChild(this.activeStreamingComponent);
+            this.activeStreamingText = text;
+        }
+        else {
+            this.activeStreamingText += text;
+            this.activeStreamingComponent.setText(this.activeStreamingText);
+        }
+        this.tui.requestRender();
+    }
+    /**
+     * Write directly to output stream (utility for commands).
+     */
+    write(text) {
+        this.output.write(text);
+    }
+    /**
+     * Clear last status lines (legacy compatibility helper).
+     */
+    clearLastStatus() {
+        this.clearStatus();
+    }
+}
+//# sourceMappingURL=tui-channel.js.map

package/dist/channels/tui/tui-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-channel.js","sourceRoot":"","sources":["../../../src/channels/tui/tui-channel.ts"],"names":[],"mappings":"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"}

package/dist/channels/tui/tui-renderer.d.ts

@@ -0,0 +1,49 @@
+import type { EditorTheme, MarkdownTheme, SelectListTheme } from '@earendil-works/pi-tui';
+/**
+ * Terminal rendering utilities and themes for the Tars TUI chat interface.
+ */
+export declare class TuiRenderer {
+    /**
+     * Render the ASCII logo in cyan.
+     */
+    static renderLogo(): string;
+    /**
+     * Render the session metadata header.
+     */
+    static renderHeader(opts: {
+        version: string;
+        provider: string;
+        model: string;
+        contextWindow: number;
+        assistantName: string;
+    }): string;
+    /**
+     * Tars custom SelectListTheme.
+     */
+    static readonly selectListTheme: SelectListTheme;
+    /**
+     * Tars custom MarkdownTheme.
+     */
+    static readonly markdownTheme: MarkdownTheme;
+    /**
+     * Tars custom EditorTheme.
+     */
+    static readonly editorTheme: EditorTheme;
+    /**
+     * Render the token stats in the footer.
+     */
+    static renderFooter(tokens: number, contextLimit: number, cost: number): string;
+    /**
+     * Format basic Markdown syntax (bold, inline code) for non-TUI fallback output.
+     */
+    static formatMarkdown(text: string): string;
+    /**
+     * Count the number of terminal lines required to display the text, accounting for wrapping.
+     */
+    static countLines(text: string, columns?: number): number;
+    /**
+     * Clear the specified number of lines from the terminal.
+     */
+    static clearLines(stream: NodeJS.WritableStream, linesCount: number): void;
+}
+export default TuiRenderer;