arbiter-ai 1.0.0 → 1.0.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "arbiter-ai",
-  "version": "1.0.0",
-  "description": "Hierarchical AI orchestration system for extending Claude's effective context window",
+  "version": "1.0.1",
+  "description": "Hierarchical AI orchestration system for extending Claude's effective context window while staying on task",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/dist/tui/layout.d.ts

@@ -1,30 +0,0 @@
-import blessed from 'blessed';
-/**
- * Layout elements interface - exposes all UI components
- */
-export interface LayoutElements {
-    screen: blessed.Widgets.Screen;
-    titleBox: blessed.Widgets.BoxElement;
-    conversationBox: blessed.Widgets.BoxElement;
-    statusBox: blessed.Widgets.BoxElement;
-    inputBox: blessed.Widgets.TextboxElement;
-}
-/**
- * Creates the blessed screen layout matching the architecture doc design
- *
- * Layout:
- * - Full terminal takeover
- * - Title area at top with "THE ARBITER" and subtitle
- * - Main conversation area (scrollable)
- * - Status bar showing Arbiter context %, Orchestrator context %, current tool
- * - Input box at bottom with ">" prompt
- */
-export declare function createLayout(): LayoutElements;
-/**
- * Creates the input prompt line with box drawing characters
- */
-export declare function createInputPrompt(width: number): string;
-/**
- * Creates a horizontal separator line
- */
-export declare function createSeparator(width: number): string;

package/dist/tui/layout.js

@@ -1,200 +0,0 @@
-// TUI layout configuration using blessed
-// Defines the screen layout, panels, and UI structure
-import blessed from 'blessed';
-/**
- * Box drawing characters for roguelike aesthetic
- */
-const BOX_CHARS = {
-    topLeft: '\u2554', // ╔
-    topRight: '\u2557', // ╗
-    bottomLeft: '\u255A', // ╚
-    bottomRight: '\u255D', // ╝
-    horizontal: '\u2550', // ═
-    vertical: '\u2551', // ║
-    leftT: '\u2560', // ╠
-    rightT: '\u2563', // ╣
-};
-/**
- * Creates the blessed screen layout matching the architecture doc design
- *
- * Layout:
- * - Full terminal takeover
- * - Title area at top with "THE ARBITER" and subtitle
- * - Main conversation area (scrollable)
- * - Status bar showing Arbiter context %, Orchestrator context %, current tool
- * - Input box at bottom with ">" prompt
- */
-export function createLayout() {
-    // Create the main screen
-    const screen = blessed.screen({
-        smartCSR: true,
-        title: 'THE ARBITER',
-        fullUnicode: true,
-        dockBorders: true,
-        autoPadding: false,
-    });
-    // Title box at the top
-    const titleBox = blessed.box({
-        parent: screen,
-        top: 0,
-        left: 0,
-        width: '100%',
-        height: 4,
-        content: '',
-        tags: true,
-        style: {
-            fg: 'white',
-            bg: 'black',
-        },
-    });
-    // Set title content with box drawing characters
-    updateTitleContent(titleBox, screen.width);
-    // Main conversation area (scrollable)
-    const conversationBox = blessed.box({
-        parent: screen,
-        top: 4,
-        left: 0,
-        width: '100%',
-        height: '100%-10', // Leave room for status (3 lines) and input (3 lines)
-        content: '',
-        tags: true,
-        scrollable: true,
-        alwaysScroll: true,
-        scrollbar: {
-            ch: '\u2588', // █
-            style: {
-                fg: 'white',
-            },
-        },
-        mouse: true,
-        keys: true,
-        vi: true,
-        style: {
-            fg: 'white',
-            bg: 'black',
-            border: {
-                fg: 'white',
-            },
-        },
-        border: {
-            type: 'line',
-        },
-    });
-    // Override border characters to use double-line box drawing
-    conversationBox.border = {
-        type: 'line',
-        ch: ' ',
-        top: BOX_CHARS.horizontal,
-        bottom: BOX_CHARS.horizontal,
-        left: BOX_CHARS.vertical,
-        right: BOX_CHARS.vertical,
-    };
-    // Status bar area (3 lines)
-    const statusBox = blessed.box({
-        parent: screen,
-        bottom: 3,
-        left: 0,
-        width: '100%',
-        height: 4,
-        content: '',
-        tags: true,
-        style: {
-            fg: 'white',
-            bg: 'black',
-        },
-    });
-    // Input box at the bottom
-    const inputBox = blessed.textbox({
-        parent: screen,
-        bottom: 0,
-        left: 2, // Leave room for "> " prompt
-        width: '100%-2',
-        height: 3,
-        inputOnFocus: true,
-        mouse: true,
-        keys: true,
-        style: {
-            fg: 'white',
-            bg: 'black',
-            border: {
-                fg: 'white',
-            },
-        },
-        border: {
-            type: 'line',
-        },
-    });
-    // Create a fixed prompt label "> " that sits to the left of the input
-    const _promptLabel = blessed.text({
-        parent: screen,
-        bottom: 1,
-        left: 0,
-        width: 2,
-        height: 1,
-        content: '> ',
-        style: {
-            fg: 'white',
-            bg: 'black',
-        },
-    });
-    // Handle screen resize to update title width
-    screen.on('resize', () => {
-        updateTitleContent(titleBox, screen.width);
-        screen.render();
-    });
-    // Set up quit key bindings
-    screen.key(['escape', 'q', 'C-c'], () => {
-        return process.exit(0);
-    });
-    return {
-        screen,
-        titleBox,
-        conversationBox,
-        statusBox,
-        inputBox,
-    };
-}
-/**
- * Updates the title box content with proper width-based formatting
- */
-function updateTitleContent(titleBox, width) {
-    const title = 'THE ARBITER';
-    const subtitle = 'OF THAT WHICH WAS, THAT WHICH IS, AND THAT WHICH SHALL COME TO BE';
-    // Calculate effective width (accounting for border characters)
-    const effectiveWidth = Math.max(width - 2, 80);
-    // Create top border
-    const topBorder = BOX_CHARS.topLeft + BOX_CHARS.horizontal.repeat(effectiveWidth) + BOX_CHARS.topRight;
-    // Center the title and subtitle
-    const titlePadding = Math.max(0, Math.floor((effectiveWidth - title.length) / 2));
-    const subtitlePadding = Math.max(0, Math.floor((effectiveWidth - subtitle.length) / 2));
-    const titleLine = BOX_CHARS.vertical +
-        ' '.repeat(titlePadding) +
-        `{bold}${title}{/bold}` +
-        ' '.repeat(effectiveWidth - titlePadding - title.length) +
-        BOX_CHARS.vertical;
-    const subtitleLine = BOX_CHARS.vertical +
-        ' '.repeat(subtitlePadding) +
-        subtitle +
-        ' '.repeat(Math.max(0, effectiveWidth - subtitlePadding - subtitle.length)) +
-        BOX_CHARS.vertical;
-    // Create separator
-    const separator = BOX_CHARS.leftT + BOX_CHARS.horizontal.repeat(effectiveWidth) + BOX_CHARS.rightT;
-    titleBox.setContent(`${topBorder}\n${titleLine}\n${subtitleLine}\n${separator}`);
-}
-/**
- * Creates the input prompt line with box drawing characters
- */
-export function createInputPrompt(width) {
-    const effectiveWidth = Math.max(width - 4, 76);
-    const promptLine = `${BOX_CHARS.vertical} > `;
-    const endLine = ' '.repeat(effectiveWidth) + BOX_CHARS.vertical;
-    const bottomBorder = BOX_CHARS.bottomLeft + BOX_CHARS.horizontal.repeat(width - 2) + BOX_CHARS.bottomRight;
-    return `${promptLine + endLine}\n${bottomBorder}`;
-}
-/**
- * Creates a horizontal separator line
- */
-export function createSeparator(width) {
-    const effectiveWidth = Math.max(width - 2, 78);
-    return BOX_CHARS.leftT + BOX_CHARS.horizontal.repeat(effectiveWidth) + BOX_CHARS.rightT;
-}

package/dist/tui/render.d.ts

@@ -1,57 +0,0 @@
-import type { LayoutElements } from './layout.js';
-import { type AppState } from '../state.js';
-/**
- * Generates animated dots text based on current animation frame
- * Cycles through: "Working." -> "Working.." -> "Working..."
- * @param baseText - The base text to animate (e.g., "Working" or "Waiting for Arbiter")
- * @returns The text with animated dots appended
- */
-export declare function getAnimatedDots(baseText: string): string;
-/**
- * Advances the animation frame for the loading dots
- * Should be called by an interval timer
- */
-export declare function advanceAnimation(): void;
-/**
- * Resets the animation frame to 0
- */
-export declare function resetAnimation(): void;
-/**
- * Renders the conversation log to the conversation box
- * Formats messages with speakers (You:, Arbiter:, Orchestrator I:, etc.)
- */
-export declare function renderConversation(elements: LayoutElements, state: AppState): void;
-/**
- * Waiting state enum for different waiting scenarios
- */
-export type WaitingState = 'none' | 'arbiter' | 'orchestrator';
-/**
- * Renders the status bar with context percentages and current tool
- *
- * When orchestrator is active:
- * ║  Arbiter ─────────────────────────────────────────────────── ██░░░░░░░░ 18%    ║
- * ║  Orchestrator I ──────────────────────────────────────────── ████████░░ 74%    ║
- * ║  ◈ Edit (12)                                                                   ║
- *
- * When no orchestrator (Arbiter speaks to human):
- * ║  Arbiter ─────────────────────────────────────────────────── ██░░░░░░░░ 18%    ║
- * ║  Awaiting your command.                                                        ║
- *
- * @param waitingState - Optional waiting state to show animated dots
- */
-export declare function renderStatus(elements: LayoutElements, state: AppState, waitingState?: WaitingState): void;
-/**
- * Creates an ASCII progress bar
- * @param percent - Current percentage (0-100)
- * @param width - Total width of the progress bar
- * @returns Progress bar string like "████████░░"
- */
-export declare function renderProgressBar(percent: number, width: number): string;
-/**
- * Renders the input area with prompt
- */
-export declare function renderInputArea(elements: LayoutElements): void;
-/**
- * Updates the entire display
- */
-export declare function renderAll(elements: LayoutElements, state: AppState): void;

package/dist/tui/render.js

@@ -1,266 +0,0 @@
-// TUI rendering logic
-// Handles updating the display with agent outputs and system status
-import { toRoman } from '../state.js';
-/**
- * Box drawing characters for borders
- */
-const BOX_CHARS = {
-    topLeft: '\u2554', // ╔
-    topRight: '\u2557', // ╗
-    bottomLeft: '\u255A', // ╚
-    bottomRight: '\u255D', // ╝
-    horizontal: '\u2550', // ═
-    vertical: '\u2551', // ║
-    leftT: '\u2560', // ╠
-    rightT: '\u2563', // ╣
-};
-/**
- * Progress bar characters
- */
-const PROGRESS_CHARS = {
-    filled: '\u2588', // █
-    empty: '\u2591', // ░
-};
-/**
- * Tool indicator character
- */
-const TOOL_INDICATOR = '\u25C8'; // ◈
-/**
- * Animation state for loading dots
- */
-let animationFrame = 0;
-/**
- * Generates animated dots text based on current animation frame
- * Cycles through: "Working." -> "Working.." -> "Working..."
- * @param baseText - The base text to animate (e.g., "Working" or "Waiting for Arbiter")
- * @returns The text with animated dots appended
- */
-export function getAnimatedDots(baseText) {
-    const dotCount = (animationFrame % 3) + 1;
-    return baseText + '.'.repeat(dotCount);
-}
-/**
- * Advances the animation frame for the loading dots
- * Should be called by an interval timer
- */
-export function advanceAnimation() {
-    animationFrame = (animationFrame + 1) % 3;
-}
-/**
- * Resets the animation frame to 0
- */
-export function resetAnimation() {
-    animationFrame = 0;
-}
-/**
- * Renders the conversation log to the conversation box
- * Formats messages with speakers (You:, Arbiter:, Orchestrator I:, etc.)
- */
-export function renderConversation(elements, state) {
-    const { conversationBox, screen } = elements;
-    const lines = [];
-    // Get effective width for text wrapping
-    const effectiveWidth = Math.max(screen.width - 6, 74);
-    for (const message of state.conversationLog) {
-        // Format speaker label
-        const speakerLabel = formatSpeakerLabel(message.speaker);
-        // Format and wrap the message text
-        const wrappedText = wrapText(message.text, effectiveWidth - speakerLabel.length - 2);
-        const textLines = wrappedText.split('\n');
-        // First line with speaker label
-        lines.push(`  ${speakerLabel} ${textLines[0]}`);
-        // Subsequent lines indented to align with first line
-        const indent = ' '.repeat(speakerLabel.length + 3);
-        for (let i = 1; i < textLines.length; i++) {
-            lines.push(`${indent}${textLines[i]}`);
-        }
-        // Add empty line between messages
-        lines.push('');
-    }
-    // Join lines and add vertical borders
-    const formattedContent = lines
-        .map((line) => {
-        const paddedLine = line.padEnd(effectiveWidth, ' ');
-        return `${BOX_CHARS.vertical}${paddedLine}${BOX_CHARS.vertical}`;
-    })
-        .join('\n');
-    conversationBox.setContent(formattedContent);
-    // Auto-scroll to bottom
-    conversationBox.setScrollPerc(100);
-    screen.render();
-}
-/**
- * Renders the status bar with context percentages and current tool
- *
- * When orchestrator is active:
- * ║  Arbiter ─────────────────────────────────────────────────── ██░░░░░░░░ 18%    ║
- * ║  Orchestrator I ──────────────────────────────────────────── ████████░░ 74%    ║
- * ║  ◈ Edit (12)                                                                   ║
- *
- * When no orchestrator (Arbiter speaks to human):
- * ║  Arbiter ─────────────────────────────────────────────────── ██░░░░░░░░ 18%    ║
- * ║  Awaiting your command.                                                        ║
- *
- * @param waitingState - Optional waiting state to show animated dots
- */
-export function renderStatus(elements, state, waitingState = 'none') {
-    const { statusBox, screen } = elements;
-    const effectiveWidth = Math.max(screen.width - 2, 78);
-    // Status separator at top
-    const separator = BOX_CHARS.leftT + BOX_CHARS.horizontal.repeat(effectiveWidth) + BOX_CHARS.rightT;
-    // Progress bar width (10 characters for the bar)
-    const barWidth = 10;
-    // Build Arbiter status line
-    const arbiterLabel = 'Arbiter';
-    const arbiterBar = renderProgressBar(state.arbiterContextPercent, barWidth);
-    const arbiterPercent = `${Math.round(state.arbiterContextPercent)}%`.padStart(4);
-    const arbiterDashes = createDashLine(effectiveWidth - arbiterLabel.length - barWidth - arbiterPercent.length - 8);
-    const arbiterLine = `${BOX_CHARS.vertical}  ${arbiterLabel} ${arbiterDashes} ${arbiterBar} ${arbiterPercent}  ${BOX_CHARS.vertical}`;
-    let orchestratorLine;
-    let toolLine;
-    if (state.currentOrchestrator) {
-        // Orchestrator status line
-        const orchLabel = `Orchestrator ${toRoman(state.currentOrchestrator.number)}`;
-        const orchBar = renderProgressBar(state.currentOrchestrator.contextPercent, barWidth);
-        const orchPercent = `${Math.round(state.currentOrchestrator.contextPercent)}%`.padStart(4);
-        const orchDashes = createDashLine(effectiveWidth - orchLabel.length - barWidth - orchPercent.length - 8);
-        orchestratorLine = `${BOX_CHARS.vertical}  ${orchLabel} ${orchDashes} ${orchBar} ${orchPercent}  ${BOX_CHARS.vertical}`;
-        // Tool indicator line
-        if (state.currentOrchestrator.currentTool) {
-            const toolText = `${TOOL_INDICATOR} ${state.currentOrchestrator.currentTool} (${state.currentOrchestrator.toolCallCount})`;
-            const toolPadding = ' '.repeat(effectiveWidth - toolText.length - 2);
-            toolLine = `${BOX_CHARS.vertical}  ${toolText}${toolPadding}${BOX_CHARS.vertical}`;
-        }
-        else if (waitingState === 'orchestrator') {
-            // Show animated dots when waiting for orchestrator response
-            const waitingText = getAnimatedDots('Working');
-            const waitingPadding = ' '.repeat(effectiveWidth - waitingText.length - 2);
-            toolLine = `${BOX_CHARS.vertical}  ${waitingText}${waitingPadding}${BOX_CHARS.vertical}`;
-        }
-        else {
-            const waitingText = 'Working...';
-            const waitingPadding = ' '.repeat(effectiveWidth - waitingText.length - 2);
-            toolLine = `${BOX_CHARS.vertical}  ${waitingText}${waitingPadding}${BOX_CHARS.vertical}`;
-        }
-    }
-    else if (waitingState === 'arbiter') {
-        // Waiting for Arbiter response - show animated dots
-        const waitingText = getAnimatedDots('Waiting for Arbiter');
-        const waitingPadding = ' '.repeat(effectiveWidth - waitingText.length - 2);
-        orchestratorLine = `${BOX_CHARS.vertical}  ${waitingText}${waitingPadding}${BOX_CHARS.vertical}`;
-        toolLine = `${BOX_CHARS.vertical}${' '.repeat(effectiveWidth)}${BOX_CHARS.vertical}`;
-    }
-    else {
-        // No orchestrator - show awaiting message
-        const awaitingText = 'Awaiting your command.';
-        const awaitingPadding = ' '.repeat(effectiveWidth - awaitingText.length - 2);
-        orchestratorLine = `${BOX_CHARS.vertical}  ${awaitingText}${awaitingPadding}${BOX_CHARS.vertical}`;
-        toolLine = `${BOX_CHARS.vertical}${' '.repeat(effectiveWidth)}${BOX_CHARS.vertical}`;
-    }
-    statusBox.setContent(`${separator}\n${arbiterLine}\n${orchestratorLine}\n${toolLine}`);
-    screen.render();
-}
-/**
- * Creates an ASCII progress bar
- * @param percent - Current percentage (0-100)
- * @param width - Total width of the progress bar
- * @returns Progress bar string like "████████░░"
- */
-export function renderProgressBar(percent, width) {
-    // Clamp percent between 0 and 100
-    const clampedPercent = Math.max(0, Math.min(100, percent));
-    // Calculate filled width
-    const filledWidth = Math.round((clampedPercent / 100) * width);
-    const emptyWidth = width - filledWidth;
-    // Build progress bar
-    return PROGRESS_CHARS.filled.repeat(filledWidth) + PROGRESS_CHARS.empty.repeat(emptyWidth);
-}
-/**
- * Formats a speaker label with appropriate styling
- */
-function formatSpeakerLabel(speaker) {
-    switch (speaker) {
-        case 'human':
-            return '{bold}You:{/bold}';
-        case 'arbiter':
-            return '{bold}{yellow-fg}Arbiter:{/yellow-fg}{/bold}';
-        default:
-            // Orchestrator labels come through as-is (e.g., "Orchestrator I")
-            if (speaker.startsWith('Orchestrator')) {
-                return `{bold}{cyan-fg}${speaker}:{/cyan-fg}{/bold}`;
-            }
-            return `{bold}${speaker}:{/bold}`;
-    }
-}
-/**
- * Wraps text to fit within a specified width
- */
-function wrapText(text, maxWidth) {
-    if (maxWidth <= 0) {
-        return text;
-    }
-    const words = text.split(' ');
-    const lines = [];
-    let currentLine = '';
-    for (const word of words) {
-        // Handle words that are longer than maxWidth
-        if (word.length > maxWidth) {
-            // If there's content in the current line, push it first
-            if (currentLine) {
-                lines.push(currentLine.trim());
-                currentLine = '';
-            }
-            // Break the long word
-            let remaining = word;
-            while (remaining.length > maxWidth) {
-                lines.push(remaining.substring(0, maxWidth));
-                remaining = remaining.substring(maxWidth);
-            }
-            currentLine = `${remaining} `;
-            continue;
-        }
-        // Check if adding this word would exceed the limit
-        if (currentLine.length + word.length + 1 > maxWidth) {
-            lines.push(currentLine.trim());
-            currentLine = `${word} `;
-        }
-        else {
-            currentLine += `${word} `;
-        }
-    }
-    // Add remaining content
-    if (currentLine.trim()) {
-        lines.push(currentLine.trim());
-    }
-    return lines.join('\n');
-}
-/**
- * Creates a dash line for status bar alignment
- * Uses em-dash (─) for cleaner appearance
- */
-function createDashLine(length) {
-    const dashChar = '\u2500'; // ─
-    return dashChar.repeat(Math.max(0, length));
-}
-/**
- * Renders the input area with prompt
- */
-export function renderInputArea(elements) {
-    const { screen } = elements;
-    const effectiveWidth = Math.max(screen.width - 2, 78);
-    // Input separator and prompt are handled by the layout
-    // This function can be used for additional input area styling if needed
-    // Create input separator
-    const _inputSeparator = BOX_CHARS.leftT + BOX_CHARS.horizontal.repeat(effectiveWidth) + BOX_CHARS.rightT;
-    // The inputBox already has its own styling from layout
-    // We can prepend a separator to the status box if needed
-    screen.render();
-}
-/**
- * Updates the entire display
- */
-export function renderAll(elements, state) {
-    renderConversation(elements, state);
-    renderStatus(elements, state);
-    elements.screen.render();
-}