@vapi-network/cli 0.2.0 → 0.2.2

package/dist/brand.d.ts

@@ -1,13 +1,35 @@
-export declare const MARK_STEP_MS = 70;
+/** Terminal cells are about twice as tall as wide; 21x9 keeps the 743x659 aspect. */
+export declare const MARK_COLUMNS = 21;
+export declare const MARK_ROWS = 9;
 export declare const WORDMARK = "vAPI Network";
-/** `ink` renders in the terminal's default foreground, like the black mark on paper. */
+export declare const WELCOME = "Welcome to the vAPI Network";
+export declare const TAGLINE: readonly ["The trusted network where agents", "and humans do business.", "", "Search APIs, pay per call, keep", "receipts. More coming soon."];
+/** Design-token colours; `ink` renders in the terminal's own foreground colour. */
 export declare const MARK_PALETTE: {
-    readonly orange: "#FF6A1A";
-    readonly pink: "#FF3D8B";
-    readonly lime: "#B8F32D";
-    readonly cyan: "#22D3EE";
-    readonly blue: "#0052FF";
-    readonly purple: "#8B5CF6";
+    readonly orange: {
+        readonly hex: "#ff7300";
+        readonly ansi16: 33;
+    };
+    readonly pink: {
+        readonly hex: "#ff337c";
+        readonly ansi16: 95;
+    };
+    readonly lime: {
+        readonly hex: "#c3ff3d";
+        readonly ansi16: 92;
+    };
+    readonly cyan: {
+        readonly hex: "#97efff";
+        readonly ansi16: 96;
+    };
+    readonly blue: {
+        readonly hex: "#0041eb";
+        readonly ansi16: 34;
+    };
+    readonly purple: {
+        readonly hex: "#8a37fb";
+        readonly ansi16: 35;
+    };
     readonly ink: null;
 };
 export type MarkColorName = keyof typeof MARK_PALETTE;
@@ -16,37 +38,37 @@ export type MarkBlock = {
     x: number;
     width: number;
     color: MarkColorName;
-    /** Reveal step; blocks that share a delay appear in the same frame. */
-    delay: number;
 };
 export declare const MARK_BLOCKS: readonly MarkBlock[];
-export type MarkRenderOptions = {
-    /** Emit 24-bit ANSI colour. Defaults to false so output stays pipe-safe. */
-    color?: boolean;
-};
-export type BannerOptions = MarkRenderOptions & {
-    version: string;
-};
-export type AnimateBannerOptions = BannerOptions & {
-    write(chunk: string): void;
-    stepMs?: number;
-    sleep?(milliseconds: number): Promise<void>;
-};
-export type AnimationEnvironment = {
+/** 0 = no colour, 1 = 16 colours, 2 = 256 colours, 3 = truecolour (the supports-color scale). */
+export type ColorLevel = 0 | 1 | 2 | 3;
+export type TerminalEnvironment = {
     isTty?: boolean;
-    json?: boolean;
     env?: NodeJS.ProcessEnv;
 };
-/** Colour is off whenever `NO_COLOR` is set or stdout is not a terminal. */
-export declare function markColorEnabled(environment?: AnimationEnvironment): boolean;
-/** Animate only in an interactive, colour-capable, human-facing terminal. */
-export declare function shouldAnimateMark(environment?: AnimationEnvironment): boolean;
+export type BannerOptions = {
+    version: string;
+    /** Defaults to 0 so output stays pipe-safe. */
+    colorLevel?: ColorLevel;
+    /** Terminal width; below the framed width the banner falls back to plain text. */
+    columns?: number;
+};
+/**
+ * Colour capability the way chalk's supports-color decides it: NO_COLOR and
+ * a redirected stdout disable colour, FORCE_COLOR overrides, and otherwise
+ * the terminal's own advertisement (COLORTERM, TERM, TERM_PROGRAM) picks
+ * the level. Apple Terminal advertises 256 colours, not truecolour.
+ */
+export declare function detectColorLevel(environment?: TerminalEnvironment): ColorLevel;
+/** The complete mark: `MARK_ROWS` lines of exactly `MARK_COLUMNS` visible cells. */
+export declare function renderMark(colorLevel?: ColorLevel): string;
+/** Width in columns of the framed banner. */
+export declare function bannerWidth(): number;
 /**
- * Every reveal step of the mark, oldest first. Pure: the last frame is the
- * complete mark and each frame is exactly `MARK_ROWS` lines.
+ * The welcome banner: the mark on the left, the welcome text on the right,
+ * inside a rounded frame. When the terminal is narrower than the frame, the
+ * text alone is printed so nothing wraps.
  */
-export declare function renderMarkFrames(options?: MarkRenderOptions): string[];
-/** The complete mark with the wordmark and version beneath it. */
 export declare function renderBanner(options: BannerOptions): string;
-/** Reveal the mark in place, then print the wordmark and version. */
-export declare function animateBanner(options: AnimateBannerOptions): Promise<void>;
+/** Nearest xterm 256-colour index, the same cube mapping chalk's ansi-styles uses. */
+export declare function rgbToAnsi256(red: number, green: number, blue: number): number;

package/dist/cli.d.ts

@@ -2,11 +2,6 @@ export declare const HELP = "vAPI Network\n\nUsage:\n  vapi init [--networks <ba
 export type CliIo = {
     stdout(message: string): void;
     stderr(message: string): void;
-    /**
-     * Raw stdout sink for cursor control. Only an interactive terminal supplies
-     * one; without it every banner falls back to a single static frame.
-     */
-    write?(chunk: string): void;
 };
 export type CliDependencies = {
     fetchImpl?: typeof fetch;

package/dist/cli.js

@@ -46673,7 +46673,7 @@ function csvCell(value) {
 import { mkdir as mkdir6, writeFile as writeFile4 } from "node:fs/promises";
 import { arch, platform, release } from "node:os";
 import { join as join2 } from "node:path";
-var VAPI_CLIENT_VERSION = "0.2.0";
+var VAPI_CLIENT_VERSION = "0.2.2";
 async function createSupportReport(options) {
   const message = options.message.trim();
   if (!message) throw new Error("Support report message must not be empty.");
@@ -48805,96 +48805,124 @@ function asRecord(value) {
 
 // src/brand.ts
 var MARK_SOURCE_WIDTH = 743;
-var MARK_COLUMNS = 34;
-var MARK_ROWS = 3;
+var MARK_SOURCE_HEIGHT = 659;
+var MARK_SOURCE_ROW_HEIGHT = 217;
+var MARK_COLUMNS = 21;
+var MARK_ROWS = 9;
 var BLOCK = "\u2588";
-var MARK_STEP_MS = 70;
 var WORDMARK = "vAPI Network";
-var RESET = "\x1B[0m";
-var DEFAULT_FOREGROUND = "\x1B[39m";
-var HIDE_CURSOR = "\x1B[?25l";
-var SHOW_CURSOR = "\x1B[?25h";
+var WELCOME = "Welcome to the vAPI Network";
+var TAGLINE = [
+  "The trusted network where agents",
+  "and humans do business.",
+  "",
+  "Search APIs, pay per call, keep",
+  "receipts. More coming soon."
+];
+var ESC = String.fromCharCode(27);
+var RESET = `${ESC}[0m`;
+var BOLD = `${ESC}[1m`;
+var DIM = `${ESC}[2m`;
+var DEFAULT_FOREGROUND = `${ESC}[39m`;
 var MARK_PALETTE = {
-  orange: "#FF6A1A",
-  pink: "#FF3D8B",
-  lime: "#B8F32D",
-  cyan: "#22D3EE",
-  blue: "#0052FF",
-  purple: "#8B5CF6",
+  orange: { hex: "#ff7300", ansi16: 33 },
+  pink: { hex: "#ff337c", ansi16: 95 },
+  lime: { hex: "#c3ff3d", ansi16: 92 },
+  cyan: { hex: "#97efff", ansi16: 96 },
+  blue: { hex: "#0041eb", ansi16: 34 },
+  purple: { hex: "#8a37fb", ansi16: 35 },
   ink: null
 };
 var MARK_BLOCKS = [
-  { row: 0, x: 2, width: 90, color: "orange", delay: 0 },
-  { row: 0, x: 94, width: 35, color: "pink", delay: 1 },
-  { row: 0, x: 131, width: 16, color: "lime", delay: 2 },
-  { row: 0, x: 522, width: 219, color: "ink", delay: 1 },
-  { row: 1, x: 124, width: 50, color: "cyan", delay: 3 },
-  { row: 1, x: 176, width: 24, color: "blue", delay: 4 },
-  { row: 1, x: 202, width: 17, color: "purple", delay: 5 },
-  { row: 1, x: 402, width: 219, color: "blue", delay: 4 },
-  { row: 2, x: 282, width: 219, color: "ink", delay: 7 }
+  { row: 0, x: 2, width: 90, color: "orange" },
+  { row: 0, x: 94, width: 35, color: "pink" },
+  { row: 0, x: 131, width: 16, color: "lime" },
+  { row: 0, x: 522, width: 219, color: "ink" },
+  { row: 1, x: 124, width: 50, color: "cyan" },
+  { row: 1, x: 176, width: 24, color: "blue" },
+  { row: 1, x: 202, width: 17, color: "purple" },
+  { row: 1, x: 402, width: 219, color: "blue" },
+  { row: 2, x: 282, width: 219, color: "ink" }
 ];
-function markColorEnabled(environment = {}) {
+function detectColorLevel(environment = {}) {
   const env = environment.env ?? process.env;
   const isTty = environment.isTty ?? Boolean(process.stdout.isTTY);
-  return isTty && !env.NO_COLOR;
-}
-function shouldAnimateMark(environment = {}) {
-  const env = environment.env ?? process.env;
-  if (environment.json) return false;
-  if (env.NO_COLOR || env.CI) return false;
-  return markColorEnabled(environment);
-}
-function renderMarkFrames(options = {}) {
-  const steps = [...new Set(MARK_BLOCKS.map((block) => block.delay))].sort(
-    (left, right) => left - right
-  );
-  return steps.map(
-    (step) => renderFrame(
-      MARK_BLOCKS.filter((block) => block.delay <= step),
-      options.color === true
-    )
-  );
-}
-function renderBanner(options) {
-  const frames = renderMarkFrames(options);
-  return [frames[frames.length - 1], WORDMARK, `v${options.version}`].join("\n");
-}
-async function animateBanner(options) {
-  const frames = renderMarkFrames({ color: options.color !== false });
-  const sleep = options.sleep ?? defaultSleep;
-  const stepMs = options.stepMs ?? MARK_STEP_MS;
-  options.write(HIDE_CURSOR);
-  try {
-    for (const [index2, frame] of frames.entries()) {
-      if (index2 > 0) options.write(`\x1B[${MARK_ROWS}A`);
-      options.write(
-        frame.split("\n").map((line) => `\r\x1B[2K${line}
-`).join("")
-      );
-      if (index2 < frames.length - 1) await sleep(stepMs);
-    }
-  } finally {
-    options.write(SHOW_CURSOR);
+  if (env.NO_COLOR) return 0;
+  const forced = env.FORCE_COLOR;
+  if (forced !== void 0) {
+    if (forced === "0" || forced === "false") return 0;
+    if (forced === "2") return 2;
+    if (forced === "3") return 3;
+    return 1;
   }
-  options.write(`${WORDMARK}
-`);
-  options.write(`v${options.version}
-`);
-}
-function renderFrame(blocks, color) {
+  if (!isTty) return 0;
+  const term = env.TERM ?? "";
+  const program = env.TERM_PROGRAM ?? "";
+  if (term === "dumb") return 0;
+  if (/^(truecolor|24bit)$/i.test(env.COLORTERM ?? "")) return 3;
+  if (/kitty|wezterm|ghostty|alacritty/i.test(term)) return 3;
+  if (/^(iTerm\.app|vscode|Hyper|WezTerm|ghostty)$/i.test(program)) return 3;
+  if (/-256(?:color)?$/i.test(term) || program === "Apple_Terminal") return 2;
+  return 1;
+}
+function renderMark(colorLevel = 0) {
   const rows = [];
   for (let row = 0; row < MARK_ROWS; row += 1) {
+    const sourceY = row * MARK_SOURCE_HEIGHT / MARK_ROWS;
+    const band = Math.min(2, Math.floor(sourceY / MARK_SOURCE_ROW_HEIGHT));
     rows.push(
       renderRow(
-        blocks.filter((block) => block.row === row),
-        color
+        MARK_BLOCKS.filter((block) => block.row === band),
+        colorLevel
       )
     );
   }
   return rows.join("\n");
 }
-function renderRow(blocks, color) {
+function bannerWidth() {
+  return frameInnerWidth() + 2;
+}
+function renderBanner(options) {
+  const colorLevel = options.colorLevel ?? 0;
+  const columns = options.columns ?? Number.POSITIVE_INFINITY;
+  const text = bannerText(options.version, colorLevel);
+  if (columns < bannerWidth()) {
+    return text.map((line) => line.styled).join("\n");
+  }
+  const inner = frameInnerWidth();
+  const markLines = renderMark(colorLevel).split("\n");
+  const lines = [];
+  lines.push(`\u256D${"\u2500".repeat(inner)}\u256E`);
+  lines.push(`\u2502${" ".repeat(inner)}\u2502`);
+  for (let row = 0; row < MARK_ROWS; row += 1) {
+    const entry = text[row];
+    const value = entry?.value ?? "";
+    const styled = entry?.styled ?? "";
+    const pad4 = " ".repeat(TEXT_WIDTH - value.length);
+    lines.push(`\u2502  ${markLines[row]}${" ".repeat(GAP)}${styled}${pad4}  \u2502`);
+  }
+  lines.push(`\u2502${" ".repeat(inner)}\u2502`);
+  lines.push(`\u2570${"\u2500".repeat(inner)}\u256F`);
+  return lines.join("\n");
+}
+var GAP = 3;
+var TEXT_WIDTH = Math.max(WELCOME.length, ...TAGLINE.map((line) => line.length));
+function frameInnerWidth() {
+  return 2 + MARK_COLUMNS + GAP + TEXT_WIDTH + 2;
+}
+function bannerText(version5, colorLevel) {
+  const style = (value, code) => colorLevel > 0 && value ? `${code}${value}${RESET}` : value;
+  const rows = [
+    { value: WELCOME, styled: style(WELCOME, BOLD) },
+    { value: "", styled: "" },
+    ...TAGLINE.map((line) => ({ value: line, styled: line })),
+    { value: "", styled: "" },
+    { value: `${WORDMARK} v${version5}`, styled: style(`${WORDMARK} v${version5}`, DIM) }
+  ];
+  if (rows.length > MARK_ROWS) throw new Error("banner text is taller than the mark");
+  return rows;
+}
+function renderRow(blocks, colorLevel) {
   const ordered = [...blocks].sort((left, right) => left.x - right.x);
   let column = 0;
   let line = "";
@@ -48905,11 +48933,11 @@ function renderRow(blocks, color) {
       column = start;
     }
     const width = scaleWidth(block.width);
-    const glyphs = BLOCK.repeat(width);
-    line += color ? `${ansiPrefix(block.color)}${glyphs}${RESET}` : glyphs;
+    const cells = BLOCK.repeat(width);
+    line += colorLevel > 0 ? `${foreground(block.color, colorLevel)}${cells}${RESET}` : cells;
     column += width;
   }
-  return line;
+  return line + " ".repeat(Math.max(0, MARK_COLUMNS - column));
 }
 function scaleColumn(x) {
   return Math.round(x * MARK_COLUMNS / MARK_SOURCE_WIDTH);
@@ -48917,20 +48945,28 @@ function scaleColumn(x) {
 function scaleWidth(width) {
   return Math.max(1, Math.round(width * MARK_COLUMNS / MARK_SOURCE_WIDTH));
 }
-function ansiPrefix(color) {
-  const hex3 = MARK_PALETTE[color];
-  if (hex3 === null) return DEFAULT_FOREGROUND;
-  const value = Number.parseInt(hex3.slice(1), 16);
-  return `\x1B[38;2;${value >> 16 & 255};${value >> 8 & 255};${value & 255}m`;
+function foreground(color, colorLevel) {
+  const entry = MARK_PALETTE[color];
+  if (entry === null) return DEFAULT_FOREGROUND;
+  const value = Number.parseInt(entry.hex.slice(1), 16);
+  const red = value >> 16 & 255;
+  const green = value >> 8 & 255;
+  const blue = value & 255;
+  if (colorLevel === 3) return `${ESC}[38;2;${red};${green};${blue}m`;
+  if (colorLevel === 2) return `${ESC}[38;5;${rgbToAnsi256(red, green, blue)}m`;
+  return `${ESC}[${entry.ansi16}m`;
 }
-function defaultSleep(milliseconds) {
-  return new Promise((resolve) => {
-    setTimeout(resolve, milliseconds);
-  });
+function rgbToAnsi256(red, green, blue) {
+  if (red === green && green === blue) {
+    if (red < 8) return 16;
+    if (red > 248) return 231;
+    return Math.round((red - 8) / 247 * 24) + 232;
+  }
+  return 16 + 36 * Math.round(red / 255 * 5) + 6 * Math.round(green / 255 * 5) + Math.round(blue / 255 * 5);
 }
 
 // src/version.ts
-var CLI_VERSION = "0.2.0";
+var CLI_VERSION = "0.2.2";
 
 // src/cli.ts
 var HELP_HEADING = "vAPI Network";
@@ -48959,8 +48995,7 @@ var processIo = {
   stdout: (message) => process.stdout.write(`${message}
 `),
   stderr: (message) => process.stderr.write(`${message}
-`),
-  write: (chunk) => process.stdout.write(chunk)
+`)
 };
 var UsageError = class extends Error {
 };
@@ -48979,7 +49014,7 @@ async function runCli(argv = process.argv.slice(2), io = processIo, dependencies
     if (command === void 0 || command === "help" || command === "--help" || command === "-h") {
       requireNoArguments(args.slice(command === void 0 ? 0 : 1), command ?? "help");
       if (command === void 0 && !json2) {
-        io.stdout(staticBanner());
+        showBanner(io);
         io.stdout(HELP.slice(HELP_HEADING.length + 2));
         return 0;
       }
@@ -49050,7 +49085,7 @@ async function initCommand(argv, json2, io, dependencies) {
   });
   const networks = parseInitNetworks(parsed.one("--networks") ?? "base");
   const enableSolana = networks.includes("solana");
-  if (!json2) await showBanner(io);
+  if (!json2) showBanner(io);
   const paths = getVapiPaths();
   let migrated = [];
   if (!process.env.VAPI_HOME?.trim()) {
@@ -49412,16 +49447,14 @@ function formatNextStep(label, value, note) {
   const step = `${label.padEnd(10)}${value}`;
   return note === void 0 ? step : `${step.padEnd(52)} ${note}`;
 }
-async function showBanner(io) {
-  const write = io.write;
-  if (write === void 0 || !shouldAnimateMark()) {
-    io.stdout(staticBanner());
-    return;
-  }
-  await animateBanner({ version: CLI_VERSION, write });
-}
-function staticBanner() {
-  return renderBanner({ version: CLI_VERSION, color: markColorEnabled() });
+function showBanner(io) {
+  io.stdout(
+    renderBanner({
+      version: CLI_VERSION,
+      colorLevel: detectColorLevel(),
+      columns: process.stdout.columns
+    })
+  );
 }
 function formatAccounts(accounts) {
   if (accounts.length === 0) return "No configured network accounts.";