exempclaw 0.4.0

package/dist/cli/probe.js

@@ -0,0 +1,140 @@
+import { ImapFlow } from "imapflow";
+import { createTransport } from "nodemailer";
+import { HttpJson } from "../connectors/http.js";
+const TIMEOUT_MS = 12_000;
+export async function probeSlack(config, fetchImpl) {
+    try {
+        const api = new HttpJson({
+            connector: "slack",
+            baseUrl: "https://slack.com/api",
+            headers: { authorization: `Bearer ${config.botToken}` },
+            fetchImpl,
+            timeoutMs: TIMEOUT_MS,
+            maxRetries: 0,
+        });
+        const auth = await api.post("/auth.test", {});
+        if (!auth.ok)
+            return { ok: false, detail: auth.error ?? "auth.test failed" };
+        let socket = "events off (no SLACK_APP_TOKEN)";
+        if (config.appToken) {
+            const appApi = new HttpJson({
+                connector: "slack",
+                baseUrl: "https://slack.com/api",
+                headers: { authorization: `Bearer ${config.appToken}` },
+                fetchImpl,
+                timeoutMs: TIMEOUT_MS,
+                maxRetries: 0,
+            });
+            const open = await appApi.post("/apps.connections.open", {});
+            socket = open.ok ? "socket mode ready" : `socket mode failed: ${open.error ?? "?"}`;
+            if (!open.ok)
+                return { ok: false, detail: `bot ok (${auth.team}) but ${socket}` };
+        }
+        return { ok: true, detail: `${auth.user} @ ${auth.team} · ${socket}` };
+    }
+    catch (err) {
+        return { ok: false, detail: err.message };
+    }
+}
+export async function probeNotion(config, fetchImpl) {
+    try {
+        const api = new HttpJson({
+            connector: "notion",
+            baseUrl: "https://api.notion.com/v1",
+            headers: { authorization: `Bearer ${config.token}`, "notion-version": "2022-06-28" },
+            fetchImpl,
+            timeoutMs: TIMEOUT_MS,
+            maxRetries: 0,
+        });
+        const me = await api.get("/users/me");
+        return { ok: true, detail: `integration "${me.name ?? "?"}"${me.bot?.workspace_name ? ` in ${me.bot.workspace_name}` : ""}` };
+    }
+    catch (err) {
+        return { ok: false, detail: err.message };
+    }
+}
+export async function probeGitHub(config, fetchImpl) {
+    try {
+        const api = new HttpJson({
+            connector: "github",
+            baseUrl: "https://api.github.com",
+            headers: {
+                authorization: `Bearer ${config.token}`,
+                accept: "application/vnd.github+json",
+                "x-github-api-version": "2022-11-28",
+                "user-agent": "exempclaw",
+            },
+            fetchImpl,
+            timeoutMs: TIMEOUT_MS,
+            maxRetries: 0,
+        });
+        const me = await api.get("/user");
+        const repos = (config.repos ?? "").split(",").map((r) => r.trim()).filter(Boolean);
+        const failures = [];
+        for (const repo of repos) {
+            try {
+                await api.get(`/repos/${repo}`);
+            }
+            catch {
+                failures.push(repo);
+            }
+        }
+        if (failures.length > 0) {
+            return { ok: false, detail: `as ${me.login}, but cannot reach: ${failures.join(", ")}` };
+        }
+        return { ok: true, detail: `as ${me.login}${repos.length ? ` · ${repos.length} repo(s) reachable` : ""}` };
+    }
+    catch (err) {
+        return { ok: false, detail: err.message };
+    }
+}
+export async function probeEmail(config, transports = {}) {
+    const parts = [];
+    try {
+        if (config.imapHost) {
+            const imapFactory = transports.imapFactory ?? ((opts) => new ImapFlow(opts));
+            const client = imapFactory({
+                host: config.imapHost,
+                port: Number(config.imapPort ?? 993),
+                secure: Number(config.imapPort ?? 993) === 993,
+                auth: { user: config.user, pass: config.password },
+                logger: false,
+                connectionTimeout: TIMEOUT_MS,
+            });
+            await client.connect();
+            await client.logout().catch(() => undefined);
+            parts.push(`imap ${config.imapHost} ok`);
+        }
+        if (config.smtpHost) {
+            const smtpFactory = transports.smtpFactory ?? createTransport;
+            const transport = smtpFactory({
+                host: config.smtpHost,
+                port: Number(config.smtpPort ?? 587),
+                secure: Number(config.smtpPort ?? 587) === 465,
+                auth: { user: config.user, pass: config.password },
+                connectionTimeout: TIMEOUT_MS,
+            });
+            try {
+                await transport.verify();
+                parts.push(`smtp ${config.smtpHost} ok`);
+            }
+            finally {
+                transport.close();
+            }
+        }
+        if (parts.length === 0)
+            return { ok: false, detail: "no IMAP or SMTP host configured" };
+        return { ok: true, detail: parts.join(" · ") };
+    }
+    catch (err) {
+        return { ok: false, detail: [...parts, err.message].join(" · ") };
+    }
+}
+/** Probe per connector id; consumed by `doctor`. */
+export const PROBES = {
+    slack: (config) => probeSlack(config),
+    notion: (config) => probeNotion(config),
+    github: (config) => probeGitHub(config),
+    email: (config) => probeEmail(config),
+};
+//# sourceMappingURL=probe.js.map

package/dist/cli/probe.js.map

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

package/dist/cli/render.d.ts

@@ -0,0 +1,15 @@
+import { type UsageTotals } from "../core/usage.js";
+export declare const dim: (text: string) => string;
+export declare const bold: (text: string) => string;
+export declare const green: (text: string) => string;
+export declare const red: (text: string) => string;
+export declare const yellow: (text: string) => string;
+export declare const cyan: (text: string) => string;
+export declare const ok: (text: string) => string;
+export declare const fail: (text: string) => string;
+export declare const warn: (text: string) => string;
+/** Renders rows as a left-aligned table with two-space gutters. */
+export declare function table(rows: string[][]): string;
+export declare function formatTokens(n: number): string;
+/** One-line run summary shown after chat/run completes. */
+export declare function usageLine(usage: UsageTotals, costUsd: number | null, iterations: number): string;

package/dist/cli/render.js

@@ -0,0 +1,50 @@
+import { formatUsd } from "../core/usage.js";
+/** Minimal ANSI helpers for the CLI. Colors disabled when not a TTY. */
+const useColor = process.stdout.isTTY === true && process.env.NO_COLOR === undefined;
+function wrap(code) {
+    return (text) => (useColor ? `\x1b[${code}m${text}\x1b[0m` : text);
+}
+export const dim = wrap("2");
+export const bold = wrap("1");
+export const green = wrap("32");
+export const red = wrap("31");
+export const yellow = wrap("33");
+export const cyan = wrap("36");
+export const ok = (text) => `${green("✓")} ${text}`;
+export const fail = (text) => `${red("✗")} ${text}`;
+export const warn = (text) => `${yellow("!")} ${text}`;
+/** Renders rows as a left-aligned table with two-space gutters. */
+export function table(rows) {
+    if (rows.length === 0)
+        return "";
+    const widths = [];
+    for (const row of rows) {
+        row.forEach((cell, i) => {
+            widths[i] = Math.max(widths[i] ?? 0, stripAnsi(cell).length);
+        });
+    }
+    return rows
+        .map((row) => row
+        .map((cell, i) => cell + " ".repeat((widths[i] ?? 0) - stripAnsi(cell).length))
+        .join("  ")
+        .trimEnd())
+        .join("\n");
+}
+function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*m/g, "");
+}
+export function formatTokens(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 10_000)
+        return `${Math.round(n / 1000)}k`;
+    return String(n);
+}
+/** One-line run summary shown after chat/run completes. */
+export function usageLine(usage, costUsd, iterations) {
+    const tokens = `${formatTokens(usage.inputTokens + usage.cacheReadTokens + usage.cacheWriteTokens)} in / ${formatTokens(usage.outputTokens)} out`;
+    const cache = usage.cacheReadTokens > 0 ? ` · ${formatTokens(usage.cacheReadTokens)} cached` : "";
+    return dim(`↳ ${iterations} turn${iterations === 1 ? "" : "s"} · ${tokens}${cache} · ${formatUsd(costUsd)}`);
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/render.js.map

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

package/dist/cli/tui.d.ts

@@ -0,0 +1,101 @@
+export type Paint = "amber" | "red" | "green" | "dim" | "plain";
+/** A frame-based animation. All frames should render at the same width. */
+export interface Anim {
+    frames: string[];
+    intervalMs: number;
+    color?: Paint;
+}
+export declare function frameAt(anim: Anim, elapsedMs: number): string;
+export declare const ANIMS: {
+    /** The mascot: a claw, pinching. */
+    claw: Anim;
+    /** Classic braille spinner — model is reasoning. */
+    thinking: Anim;
+    /** A lens sweeping across slots. */
+    searching: Anim;
+    /** Pages turning. */
+    reading: Anim;
+    /** A cursor laying down ink. */
+    writing: Anim;
+    /** An envelope leaving a dot trail. */
+    sending: Anim;
+    /** Patient arc. */
+    waiting: Anim;
+    /** Sparkle burst for wins. */
+    celebrating: Anim;
+    /** Attention blink. */
+    alert: Anim;
+    /** Generic tool gear-tick. */
+    tool: Anim;
+};
+export type AnimName = keyof typeof ANIMS;
+export declare function toolIcon(name: string): string;
+export interface StageWriter {
+    write(text: string): unknown;
+}
+export interface StageOptions {
+    out?: StageWriter;
+    /** Force TTY behavior on/off; defaults to stdout.isTTY && !EXEMPCLAW_NO_ANIM. */
+    tty?: boolean;
+    intervalMs?: number;
+    now?: () => number;
+}
+export declare class Stage {
+    private readonly out;
+    private readonly tty;
+    private readonly intervalMs;
+    private readonly now;
+    private rows;
+    private renderedLines;
+    private timer?;
+    private suspended;
+    private cursorHidden;
+    constructor(opts?: StageOptions);
+    get isAnimated(): boolean;
+    /** Adds (or replaces) an animated row. */
+    addRow(id: string, spec: {
+        label: string;
+        anim?: AnimName | Anim;
+        icon?: string;
+        color?: Paint;
+        hint?: string;
+    }): void;
+    updateRow(id: string, patch: {
+        label?: string;
+        hint?: string;
+    }): void;
+    /** Removes a row and prints its permanent settled line. */
+    settleRow(id: string, opts?: {
+        mark?: string;
+        color?: Paint;
+        label?: string;
+        suffix?: string;
+    }): void;
+    /** Removes a row without printing anything. */
+    removeRow(id: string): void;
+    /** Writes ordinary output above the live region. */
+    print(text: string): void;
+    /** Streaming-friendly raw write (no trailing newline added). */
+    write(text: string): void;
+    /** Temporarily clears the live region (e.g. while a prompt owns the line). */
+    suspend(): void;
+    resume(): void;
+    /** Clears everything without settling — end of a run or shutdown. */
+    stopAll(): void;
+    private takeRow;
+    private elapsedText;
+    private wake;
+    private stopTimer;
+    private erase;
+    private render;
+    private setCursor;
+}
+/**
+ * Plays the animated wordmark: the claw pinches while the letters sweep in.
+ * Resolves in ~700ms; prints a single static line on non-TTY terminals.
+ */
+export declare function playBanner(subtitle: string, opts?: StageOptions): Promise<void>;
+/** Renders a fixed-width progress bar like ▰▰▰▱▱. */
+export declare function progressBar(done: number, total: number, width?: number): string;
+/** One-shot flash: a few quick frames, then a permanent line (TTY only). */
+export declare function flashLine(text: string, opts?: StageOptions): Promise<void>;

package/dist/cli/tui.js

@@ -0,0 +1,334 @@
+import { performance } from "node:perf_hooks";
+/**
+ * Dependency-free terminal animation engine.
+ *
+ * The Stage owns a "live region" at the bottom of the terminal: a set of
+ * animated rows (spinners, activity lines, progress bars) that are redrawn in
+ * place while ordinary output scrolls above them. Rows settle into permanent
+ * printed lines when their work finishes.
+ *
+ * Degrades gracefully: when stdout isn't a TTY (pipes, CI, tests) or
+ * EXEMPCLAW_NO_ANIM is set, rows print once as plain lines and settle as
+ * plain lines — no timers, no escape codes.
+ */
+const ESC = "\x1b[";
+const HIDE_CURSOR = `${ESC}?25l`;
+const SHOW_CURSOR = `${ESC}?25h`;
+const CLEAR_LINE = `${ESC}2K`;
+const AMBER = `${ESC}38;5;214m`;
+const RED = `${ESC}31m`;
+const GREEN = `${ESC}32m`;
+const DIM = `${ESC}2m`;
+const RESET = `${ESC}0m`;
+function paint(color, text, enabled) {
+    if (!enabled || color === "plain")
+        return text;
+    const code = { amber: AMBER, red: RED, green: GREEN, dim: DIM }[color];
+    return `${code}${text}${RESET}`;
+}
+export function frameAt(anim, elapsedMs) {
+    const index = Math.floor(elapsedMs / anim.intervalMs) % anim.frames.length;
+    return anim.frames[index];
+}
+/* ── frame library ─────────────────────────────────────────────────── */
+export const ANIMS = {
+    /** The mascot: a claw, pinching. */
+    claw: { frames: ["(\\/)", "(\\|)", "(\\-)", "(\\|)"], intervalMs: 220, color: "amber" },
+    /** Classic braille spinner — model is reasoning. */
+    thinking: { frames: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"], intervalMs: 90, color: "amber" },
+    /** A lens sweeping across slots. */
+    searching: {
+        frames: ["[●····]", "[·●···]", "[··●··]", "[···●·]", "[····●]", "[···●·]", "[··●··]", "[·●···]"],
+        intervalMs: 110,
+        color: "amber",
+    },
+    /** Pages turning. */
+    reading: { frames: ["◐", "◓", "◑", "◒"], intervalMs: 160, color: "amber" },
+    /** A cursor laying down ink. */
+    writing: { frames: ["▍", "▌", "▋", "▊", "▋", "▌"], intervalMs: 130, color: "amber" },
+    /** An envelope leaving a dot trail. */
+    sending: {
+        frames: ["✉····", "·✉···", "··✉··", "···✉·", "····✉"],
+        intervalMs: 140,
+        color: "amber",
+    },
+    /** Patient arc. */
+    waiting: { frames: ["◜", "◠", "◝", "◞", "◡", "◟"], intervalMs: 140, color: "dim" },
+    /** Sparkle burst for wins. */
+    celebrating: { frames: ["✦ · ˙", "˙ ✦ ·", "· ˙ ✦", "˙ · ✦", "✧ ˙ ·"], intervalMs: 120, color: "amber" },
+    /** Attention blink. */
+    alert: { frames: ["▲", "△", "▲", "△"], intervalMs: 260, color: "red" },
+    /** Generic tool gear-tick. */
+    tool: { frames: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"], intervalMs: 90, color: "dim" },
+};
+/** Static icons that prefix tool rows, keyed by tool-name prefix. */
+const TOOL_ICONS = [
+    ["email_", "✉"],
+    ["slack_", "#"],
+    ["github_", "⎇"],
+    ["notion_", "▤"],
+    ["remember", "◆"],
+    ["recall", "◇"],
+    ["display_status", "≋"],
+    ["current_time", "◷"],
+];
+export function toolIcon(name) {
+    for (const [prefix, icon] of TOOL_ICONS) {
+        if (name.startsWith(prefix))
+            return icon;
+    }
+    return "⚙";
+}
+export class Stage {
+    out;
+    tty;
+    intervalMs;
+    now;
+    rows = [];
+    renderedLines = 0;
+    timer;
+    suspended = false;
+    cursorHidden = false;
+    constructor(opts = {}) {
+        this.out = opts.out ?? process.stdout;
+        this.tty =
+            opts.tty ??
+                (process.stdout.isTTY === true && !process.env.EXEMPCLAW_NO_ANIM && !process.env.NO_COLOR);
+        this.intervalMs = opts.intervalMs ?? 80;
+        this.now = opts.now ?? (() => performance.now());
+    }
+    get isAnimated() {
+        return this.tty;
+    }
+    /** Adds (or replaces) an animated row. */
+    addRow(id, spec) {
+        const anim = typeof spec.anim === "object" ? spec.anim : ANIMS[spec.anim ?? "tool"];
+        const row = {
+            id,
+            icon: spec.icon,
+            label: spec.label,
+            anim,
+            color: spec.color ?? anim.color ?? "plain",
+            startedAt: this.now(),
+            hint: spec.hint,
+        };
+        const existing = this.rows.findIndex((r) => r.id === id);
+        if (existing >= 0) {
+            row.startedAt = this.rows[existing].startedAt;
+            this.rows[existing] = row;
+        }
+        else {
+            this.rows.push(row);
+            if (!this.tty) {
+                this.out.write(`${row.icon ? `${row.icon} ` : ""}${row.label}…\n`);
+            }
+        }
+        this.wake();
+    }
+    updateRow(id, patch) {
+        const row = this.rows.find((r) => r.id === id);
+        if (!row)
+            return;
+        if (patch.label !== undefined)
+            row.label = patch.label;
+        if (patch.hint !== undefined)
+            row.hint = patch.hint;
+        this.wake();
+    }
+    /** Removes a row and prints its permanent settled line. */
+    settleRow(id, opts = {}) {
+        const row = this.takeRow(id);
+        if (!row)
+            return;
+        const mark = opts.mark ?? "✓";
+        const color = opts.color ?? "green";
+        const label = opts.label ?? row.label;
+        const elapsed = this.elapsedText(row);
+        const line = `${paint(color, mark, this.tty)} ${row.icon ? `${row.icon} ` : ""}${label}${opts.suffix ? ` ${opts.suffix}` : ""}${elapsed}`;
+        this.print(`${line}\n`);
+    }
+    /** Removes a row without printing anything. */
+    removeRow(id) {
+        this.takeRow(id);
+    }
+    /** Writes ordinary output above the live region. */
+    print(text) {
+        if (!this.tty) {
+            this.out.write(text);
+            return;
+        }
+        this.erase();
+        this.out.write(text);
+        this.render();
+    }
+    /** Streaming-friendly raw write (no trailing newline added). */
+    write(text) {
+        this.print(text);
+    }
+    /** Temporarily clears the live region (e.g. while a prompt owns the line). */
+    suspend() {
+        if (this.suspended)
+            return;
+        this.suspended = true;
+        if (this.tty) {
+            this.erase();
+            this.stopTimer();
+            this.setCursor(true);
+        }
+    }
+    resume() {
+        if (!this.suspended)
+            return;
+        this.suspended = false;
+        this.wake();
+    }
+    /** Clears everything without settling — end of a run or shutdown. */
+    stopAll() {
+        this.rows = [];
+        if (this.tty)
+            this.erase();
+        this.stopTimer();
+        this.setCursor(true);
+    }
+    /* ── internals ── */
+    takeRow(id) {
+        const index = this.rows.findIndex((r) => r.id === id);
+        if (index < 0)
+            return undefined;
+        const [row] = this.rows.splice(index, 1);
+        if (this.tty) {
+            this.erase();
+            this.render();
+        }
+        if (this.rows.length === 0)
+            this.stopTimer();
+        return row;
+    }
+    elapsedText(row) {
+        const seconds = (this.now() - row.startedAt) / 1000;
+        if (seconds < 0.05)
+            return "";
+        return paint("dim", ` · ${seconds.toFixed(1)}s`, this.tty);
+    }
+    wake() {
+        if (!this.tty || this.suspended)
+            return;
+        this.setCursor(false);
+        this.render();
+        if (!this.timer && this.rows.length > 0) {
+            this.timer = setInterval(() => this.render(), this.intervalMs);
+            this.timer.unref?.();
+        }
+    }
+    stopTimer() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+    erase() {
+        if (this.renderedLines === 0)
+            return;
+        let seq = "";
+        for (let i = 0; i < this.renderedLines; i++) {
+            seq += `${ESC}1A${CLEAR_LINE}`;
+        }
+        seq += "\r";
+        this.out.write(seq);
+        this.renderedLines = 0;
+    }
+    render() {
+        if (!this.tty || this.suspended)
+            return;
+        this.erase();
+        if (this.rows.length === 0) {
+            this.setCursor(true);
+            return;
+        }
+        let block = "";
+        for (const row of this.rows) {
+            const frame = paint(row.color, frameAt(row.anim, this.now() - row.startedAt), this.tty);
+            const icon = row.icon ? `${row.icon} ` : "";
+            const hint = row.hint ? paint("dim", ` ${row.hint}`, this.tty) : "";
+            block += `${frame} ${icon}${row.label}${hint}${this.elapsedText(row)}\n`;
+        }
+        this.out.write(block);
+        this.renderedLines = this.rows.length;
+    }
+    setCursor(visible) {
+        if (!this.tty)
+            return;
+        if (visible && this.cursorHidden) {
+            this.out.write(SHOW_CURSOR);
+            this.cursorHidden = false;
+        }
+        else if (!visible && !this.cursorHidden) {
+            this.out.write(HIDE_CURSOR);
+            this.cursorHidden = true;
+            ensureCursorRestoredOnExit();
+        }
+    }
+}
+let exitHookInstalled = false;
+function ensureCursorRestoredOnExit() {
+    if (exitHookInstalled)
+        return;
+    exitHookInstalled = true;
+    process.on("exit", () => {
+        if (process.stdout.isTTY)
+            process.stdout.write(SHOW_CURSOR);
+    });
+}
+/* ── banner ────────────────────────────────────────────────────────── */
+/**
+ * Plays the animated wordmark: the claw pinches while the letters sweep in.
+ * Resolves in ~700ms; prints a single static line on non-TTY terminals.
+ */
+export async function playBanner(subtitle, opts = {}) {
+    const out = opts.out ?? process.stdout;
+    const tty = opts.tty ?? (process.stdout.isTTY === true && !process.env.EXEMPCLAW_NO_ANIM && !process.env.NO_COLOR);
+    const word = "E X E M P C L A W";
+    if (!tty) {
+        out.write(`(\\/) ${word} — ${subtitle}\n`);
+        return;
+    }
+    const claw = ANIMS.claw.frames;
+    const steps = 10;
+    out.write(HIDE_CURSOR);
+    for (let i = 0; i <= steps; i++) {
+        const visible = Math.round((word.length * i) / steps);
+        const frame = claw[i % claw.length];
+        const text = word.slice(0, visible);
+        const ghost = " ".repeat(word.length - visible);
+        out.write(`\r${CLEAR_LINE}${AMBER}${frame}${RESET} ${AMBER}${text}${RESET}${ghost}`);
+        await sleepMs(55);
+    }
+    out.write(`\r${CLEAR_LINE}${AMBER}(\\/)${RESET} ${AMBER}${word}${RESET}\n`);
+    out.write(`${DIM}     ${subtitle}${RESET}\n`);
+    out.write(SHOW_CURSOR);
+}
+/** Renders a fixed-width progress bar like ▰▰▰▱▱. */
+export function progressBar(done, total, width = 14) {
+    if (total <= 0)
+        return "▱".repeat(width);
+    const filled = Math.max(0, Math.min(width, Math.round((done / total) * width)));
+    return "▰".repeat(filled) + "▱".repeat(width - filled);
+}
+/** One-shot flash: a few quick frames, then a permanent line (TTY only). */
+export async function flashLine(text, opts = {}) {
+    const out = opts.out ?? process.stdout;
+    const tty = opts.tty ?? (process.stdout.isTTY === true && !process.env.EXEMPCLAW_NO_ANIM && !process.env.NO_COLOR);
+    if (!tty) {
+        out.write(`${text}\n`);
+        return;
+    }
+    for (const frame of ["⚡", "✦", "⚡"]) {
+        out.write(`\r${CLEAR_LINE}${AMBER}${frame}${RESET} ${text}`);
+        await sleepMs(70);
+    }
+    out.write(`\r${CLEAR_LINE}${AMBER}⚡${RESET} ${text}\n`);
+}
+function sleepMs(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=tui.js.map