Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.
/**
* The launch pad: the first screen of the Mercury TUI.
*
* Design rules:
* - Every status row reflects real state (provider handshake, skills
* discovered, web server, budget, workspace). Nothing ticks on a timer.
* - The layout never jumps: every row is present from the first frame, and
* pending rows show a spinner in place of the check.
* - The wordmark draws in top-down once (~120 ms), then stays still.
* - Typing anywhere starts chat (handled by the app's input layer); Enter on
* an empty pad does the same; Tab toggles the skills list.
*/
import React from 'react';
import { Box, Text } from 'ink';
import { homedir } from 'node:os';
import type { TuiState } from '../channels/cli.js';
import { IS_LIGHT_TERMINAL } from '../utils/terminal-theme.js';
import { isDevBuild } from '../utils/dev-build.js';
import { fitText, fitTail } from './layout.js';
import { useTick, spinnerFrame } from './tick-store.js';
import { renderPixelWord } from './pixel-logo.js';
/** MERCURY in the pixel font the Mercury Code header uses: one brand, two screens. */
export const LAUNCH_WORDMARK: readonly string[] = renderPixelWord('MERCURY', '█').map((row) => row.replace(/\s+$/, ''));
export const LAUNCH_WORDMARK_WIDTH = Math.max(...LAUNCH_WORDMARK.map((row) => row.length));
const COLORS = IS_LIGHT_TERMINAL
? { mark: 'blue', title: 'blue', muted: 'gray', key: 'blue', accent: 'magenta' }
: { mark: 'cyan', title: 'cyan', muted: 'gray', key: 'cyan', accent: 'magenta' };
/** Milliseconds between wordmark rows during the draw-in. */
export const MARK_REVEAL_STEP_MS = 24;
export interface LaunchPadCheck {
label: string;
value: string;
/** done = ✓, pending = spinner, info = · (not a readiness gate). */
status: 'done' | 'pending' | 'info' | 'off';
/** Paths keep their tail when truncated (the folder name matters most). */
keepTail?: boolean;
}
/** The status rows, derived only from real state. Exported for tests. */
export function launchPadChecks(state: TuiState, cwd: string = process.cwd()): LaunchPadCheck[] {
const checks: LaunchPadCheck[] = [];
checks.push(state.provider
? { label: 'Provider', value: `${state.provider.name} · ${state.provider.model}`, status: 'done' }
: { label: 'Provider', value: 'connecting…', status: 'pending' });
const skillCount = state.skills.length;
// Skills are discovered from disk before the TUI mounts, so this is a fact,
// not a readiness gate.
checks.push(skillCount > 0
? { label: 'Skills', value: skillCount === 1 ? '1 ready' : `${skillCount} ready`, status: 'done' }
: { label: 'Skills', value: 'none installed', status: 'info' });
checks.push(state.web?.enabled
? { label: 'Web', value: `127.0.0.1:${state.web.port}`, status: 'done' }
: { label: 'Web', value: 'off', status: 'off' });
if (state.tokenInfo) {
checks.push({ label: 'Budget', value: `${state.tokenInfo.used.toLocaleString()} / ${state.tokenInfo.budget.toLocaleString()} today`, status: 'info' });
}
checks.push({ label: 'Workspace', value: tildify(cwd), status: 'info', keepTail: true });
return checks;
}
export function tildify(path: string, home: string = homedir()): string {
return home && (path === home || path.startsWith(home + '/')) ? '~' + path.slice(home.length) : path;
}
export function isLaunchPadReady(state: TuiState): boolean {
return state.provider != null;
}
/** Draw-in progress for the mark: rows revealed so far, advancing once. */
function useMarkReveal(total: number): number {
const [shown, setShown] = React.useState(0);
React.useEffect(() => {
if (shown >= total) return;
const t = setTimeout(() => setShown((n) => Math.min(total, n + 1)), MARK_REVEAL_STEP_MS);
return () => clearTimeout(t);
}, [shown, total]);
return shown;
}
function CheckRow({ check, labelWidth, valueWidth, frame }: { check: LaunchPadCheck; labelWidth: number; valueWidth: number; frame: string }) {
const glyph = check.status === 'done' ? '✓' : check.status === 'pending' ? frame : '·';
const glyphColor = check.status === 'done' ? 'green' : check.status === 'pending' ? 'yellow' : COLORS.muted;
return (
<Text wrap="truncate-end">
<Text color={glyphColor}>{glyph}</Text>
<Text> {check.label.padEnd(labelWidth)} </Text>
<Text color={check.status === 'off' ? COLORS.muted : undefined}>{check.keepTail ? fitTail(check.value, valueWidth) : fitText(check.value, valueWidth)}</Text>
</Text>
);
}
export interface LaunchPadProps {
state: TuiState;
cols: number;
showDetails: boolean;
tip?: string | null;
}
/**
* How many terminal rows the pad takes (details hidden), so a screen that
* stacks something under it can fit the whole thing: Ink drops rows off the
* TOP when the output is taller than the terminal, and the first casualty
* was the wordmark. Mirrors the render below row for row.
*/
export function launchPadRows(cols: number, tip?: string | null): number {
const showWordmark = cols >= LAUNCH_WORDMARK_WIDTH + 4;
const header = showWordmark ? 1 + LAUNCH_WORDMARK.length + 1 : 2; // paddingTop + mark + tagline | mark line + tagline
const checks = 5; // provider, skills, web, budget, workspace
return header + 1 + checks + 1 + 1 + 1 + (tip ? 2 : 0); // blank, checks, blank, "Type to start", "/code … Tab", tip pair
}
export function LaunchPad({ state, cols, showDetails, tip }: LaunchPadProps) {
// The wordmark needs its width plus the side padding; below that the
// header is a single text line (Termux portrait, split panes).
const showWordmark = cols >= LAUNCH_WORDMARK_WIDTH + 4;
const revealed = useMarkReveal(showWordmark ? LAUNCH_WORDMARK.length : 0);
const ready = isLaunchPadReady(state);
const now = useTick(!ready);
const frame = spinnerFrame(now);
const width = Math.max(10, cols - 2);
const checks = launchPadChecks(state);
const labelWidth = Math.max(...checks.map((c) => c.label.length));
const valueWidth = Math.max(4, width - labelWidth - 4);
const versionLabel = `v${state.version}`;
const tagline = 'Your soul-driven AI agent';
// Version sits flush right under the wordmark when there is room.
const versionGap = showWordmark ? Math.max(2, LAUNCH_WORDMARK_WIDTH - tagline.length - versionLabel.length) : 2;
return (
<Box flexDirection="column" flexGrow={1} paddingX={1} paddingTop={showWordmark ? 1 : 0}>
{showWordmark ? (
<>
{LAUNCH_WORDMARK.map((line, i) => (
// Unrevealed rows render blank so the layout never jumps.
<Text key={i} color={COLORS.mark}>{i < revealed ? line : ' '}</Text>
))}
<Text wrap="truncate-end">
<Text color={COLORS.muted}>{tagline}</Text>
<Text color={COLORS.muted}>{' '.repeat(versionGap)}{versionLabel}</Text>
{isDevBuild(state.version) && <Text color="yellow"> ⚠ development build</Text>}
</Text>
</>
) : (
<>
<Text wrap="truncate-end">
<Text color={COLORS.mark}>☿ </Text>
<Text bold color={COLORS.title}>MERCURY</Text>
<Text color={COLORS.muted}> {versionLabel}</Text>
{isDevBuild(state.version) && <Text color="yellow"> ⚠ dev</Text>}
</Text>
<Text color={COLORS.muted} wrap="truncate-end">{tagline}</Text>
</>
)}
<Text> </Text>
{checks.map((check) => (
<CheckRow key={check.label} check={check} labelWidth={labelWidth} valueWidth={valueWidth} frame={frame} />
))}
<Text> </Text>
{ready ? (
<Text bold wrap="truncate-end">Type to start chatting</Text>
) : (
<Text color={COLORS.muted} wrap="truncate-end">Starting up — you can already type</Text>
)}
<Text wrap="truncate-end">
<Text color={COLORS.key}>/code</Text><Text color={COLORS.muted}> Mercury Code here </Text>
<Text color={COLORS.key}>Tab</Text><Text color={COLORS.muted}> {showDetails ? 'hide skills' : 'skills'}</Text>
</Text>
{tip ? (
<>
<Text> </Text>
<Text color={COLORS.muted} wrap="truncate-end">tip: {fitText(tip, Math.max(4, width - 5))}</Text>
</>
) : null}
{showDetails && (
<Box flexDirection="column" marginTop={1}>
<Text color={COLORS.muted}>Skills</Text>
{state.skills.length === 0
? <Text color={COLORS.muted}> none installed — /skills to browse the registry</Text>
: state.skills.map((skill) => (
<Text key={skill.name} color={COLORS.muted} wrap="truncate-end"> {skill.name}</Text>
))}
</Box>
)}
</Box>
);
}