Skip to content

Lightpanda: the headless browser designed for AI and automation

5.6 KB
Raw Blame
// Copyright (C) 2023-2026  Lightpanda (Selecy SAS)
//
// Francis Bouvier <[email protected]>
// Pierre Tachoire <[email protected]>
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as
// published by the Free Software Foundation, either version 3 of the
// License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.

//! The agent REPL's startup banner: a pre-colored braille panda logo with the
//! title and command hints laid out beside it. Sized at comptime to fit 80
//! columns so it never has to measure the terminal.

const std = @import("std");
const lp = @import("lightpanda");
const ansi = @import("ansi.zig");

// A pre-colored (truecolor braille) panda. Each line carries its own ANSI and
// resets at the end, so it prints as-is; non-empty lines are the visible rows.
const logo =
    "⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀\x1b[0m\n" ++
    "⠀⠀⠀⠀⠀⠀⠀\x1b[38;2;247;247;239m⣀⣴⣶⣿⣿⣿⣿⣿⣿⣶⣦⣀⠀⠀⠀⠀⠀\x1b[0m\n" ++
    "⠀⠀⠀⠀\x1b[38;2;247;247;239m⢀⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣆⠀⠀⠀\x1b[0m\n" ++
    "⠀⠀⠀\x1b[38;2;247;247;239m⢠⣾⣿⣿⣿⣿⠉⠈⣉⣭⣭⣥⣤⡀⣿⣿⣿⣿⣷⡀⠀\x1b[0m\n" ++
    "⠀⠀\x1b[38;2;247;247;239m⢀⣿⠿⠟⠛⠛⠛⢠⣾⣿⠟⠛⢿⣿⠛⢎⢿⣿⣿⣿⣷⡀\x1b[0m\n" ++
    "⠀⠀\x1b[38;2;247;247;239m⢸⣀⠀⠀⠀⠀⠀⣿⣿⣿⠀⢠⣼⡿⠾⣺⢸⣿⣿⣿⣿⡇\x1b[0m\n" ++
    "⠀⠀\x1b[38;2;247;247;239m⢸⣿⣿⣷⣶⣤⡀⠹⣿⣿⣿⣿⣟⣗⣐⠟⠸⣿⣿⣿⣿⡇\x1b[0m\n" ++
    "⠀⠀\x1b[38;2;247;247;239m⠸⣿⣿⣿⣿⡿⠓⠀⠈⠛⠻⠿⠟⠛⠁⠀⠀⠘⣿⣿⣿⠇\x1b[0m\n" ++
    "⠀⠀\x1b[38;2;8;132;177m⢀⣼⣿⣿⣿⣶⣶\x1b[38;2;247;247;239m⣼⣶⡇⠀⠀⠀⠀⠀⢀⠀⠀⠘⣿⠏⠀\x1b[0m\n" ++
    "⠀\x1b[38;2;106;196;229m⣰⣿⣿⣿⣿⣿⣿⣿\x1b[38;2;8;132;177m⣿⣿⣿⣷⣦⣄⣀⠀⠀\x1b[38;2;247;247;239m⠑⢤⣤⢏\x1b[38;2;8;132;177m⣀⡀\x1b[0m\n" ++
    "\x1b[38;2;106;196;229m⠊⠉⠀⠀⠀⠀⠀⠀⠀⠉⠙⠻⢯\x1b[38;2;8;132;177m⡛⠿⢿⣿⣿⣿⡾⠿⠛⠉⠀\x1b[0m\n" ++
    "⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀\x1b[0m";
const logo_cols = 24; // braille cells per row
const logo_rows = blk: {
    @setEvalBranchQuota(20000);
    var n: usize = 0;
    var it = std.mem.splitScalar(u8, logo, '\n');
    while (it.next()) |line| {
        if (line.len != 0) n += 1;
    }
    break :blk n;
};
const welcome_gap = "   ";

/// Banner text. Kept narrow enough that logo + gap + widest line fits in 80
/// columns (asserted at comptime below), so the banner always shows in full
/// without measuring the terminal or shedding the logo.
const banner_tagline_llm = "Control the browser with natural language";
const banner_tagline_basic = "Basic REPL (--no-llm) — commands only";
const banner_setup = "Set an API key, then run /provider <name>";
const banner_hints = [_][]const u8{
    "/goto <url> to navigate",
    "/save to generate a reproducible script",
    "/help to list commands   /quit to exit",
    "! to run JavaScript on the current page",
};

comptime {
    // Excludes the version line: it's build-environment-controlled (nightly tags
    // add a commit count + hash), so asserting it would break the build over an
    // input this file doesn't own.
    const fixed = [_][]const u8{
        "Lightpanda Agent",
        banner_tagline_llm,
        banner_tagline_basic,
        banner_setup,
    } ++ banner_hints;
    var maxw: usize = 0;
    for (fixed) |s| maxw = @max(maxw, std.unicode.utf8CountCodepoints(s) catch s.len);
    if (logo_cols + welcome_gap.len + maxw > 79) @compileError("welcome banner exceeds 79 columns");
}

/// Prints the welcome banner: the logo on the left with the title and command
/// hints beside it, vertically centered. `llm_active` picks the tagline.
pub fn print(llm_active: bool) void {
    var version_buf: [192]u8 = undefined;
    const version: []const u8 = std.mem.print(&version_buf, ansi.dim ++ "{s}" ++ ansi.reset, .{lp.build_config.version}) catch "";

    var lines: [9][]const u8 = undefined;
    var n: usize = 0;
    lines[n] = ansi.bold ++ "Lightpanda Agent" ++ ansi.reset;
    n += 1;
    lines[n] = version;
    n += 1;
    lines[n] = "";
    n += 1;
    if (llm_active) {
        lines[n] = ansi.italic ++ banner_tagline_llm ++ ansi.reset;
        n += 1;
    } else {
        lines[n] = ansi.italic ++ banner_tagline_basic ++ ansi.reset;
        n += 1;
        lines[n] = ansi.dim ++ banner_setup ++ ansi.reset;
        n += 1;
    }
    inline for (banner_hints) |t| {
        lines[n] = ansi.dim ++ t ++ ansi.reset;
        n += 1;
    }
    const text = lines[0..n];

    const start = (logo_rows - text.len) / 2;
    std.debug.print("\n", .{});
    var row: usize = 0;
    var it = std.mem.splitScalar(u8, logo, '\n');
    while (it.next()) |logo_line| {
        if (logo_line.len == 0) continue;
        std.debug.print("{s}", .{logo_line});
        if (row >= start and row - start < text.len) {
            const line = text[row - start];
            if (line.len != 0) std.debug.print("{s}{s}", .{ welcome_gap, line });
        }
        std.debug.print("\n", .{});
        row += 1;
    }
}