@blockrun/franklin 3.2.0 → 3.2.1

package/dist/banner.js

@@ -1,5 +1,39 @@
 import chalk from 'chalk';
-// "FRANKLIN" — the AI agent with a wallet
+// ─── Ben Franklin portrait ─────────────────────────────────────────────────
+//
+// Generated once, at build time, from the Joseph Duplessis 1785 oil painting
+// of Benjamin Franklin (same source as the portrait on the US $100 bill).
+// Public domain image from Wikimedia Commons:
+//   https://commons.wikimedia.org/wiki/File:BenFranklinDuplessis.jpg
+//
+// Rendered via chafa with:
+//   chafa --size=20x10 --symbols=block --colors=256 ben-franklin.jpg
+//
+// The raw ANSI escape codes are hex-encoded below so the TS source stays
+// readable and diff-friendly. Each string is one row of the portrait.
+// Visible dimensions: ~17 characters wide × 10 rows tall.
+//
+// Rendered best in a 256-color or truecolor terminal. Degrades gracefully
+// (shows as block-character garbage) on ancient terminals — but those
+// are long gone and we don't support them.
+const BEN_PORTRAIT_ROWS = [
+    '\x1b[0m\x1b[38;5;232;48;5;16m▏     \x1b[48;5;232m  \x1b[48;5;16m▂\x1b[48;5;232m    \x1b[38;5;233m▃▃\x1b[48;5;233m  \x1b[0m',
+    '\x1b[38;5;232;48;5;16m▏    \x1b[38;5;234m▂\x1b[38;5;95;48;5;232m▄\x1b[38;5;137;48;5;233m▅\x1b[38;5;173m▅\x1b[38;5;137;48;5;234m▃\x1b[38;5;235;48;5;233m▁    \x1b[38;5;234m▄ \x1b[0m',
+    '\x1b[38;5;232;48;5;16m▏▕  \x1b[38;5;234;48;5;232m▁\x1b[38;5;235;48;5;237m▎\x1b[38;5;58;48;5;179m▌\x1b[38;5;131m▄\x1b[38;5;94m▖\x1b[38;5;58;48;5;137m▗\x1b[48;5;235m▍\x1b[38;5;235;48;5;234m▆▆▄▅  \x1b[0m',
+    '\x1b[38;5;233;48;5;232m▏\x1b[38;5;232;48;5;16m▏\x1b[38;5;16;48;5;232m▏\x1b[38;5;233m▗\x1b[38;5;236;48;5;240m▎\x1b[38;5;235;48;5;238m▄\x1b[38;5;95;48;5;173m▎\x1b[38;5;173;48;5;179m▖\x1b[38;5;137m▁\x1b[48;5;94m▍\x1b[38;5;94;48;5;233m▋\x1b[38;5;233;48;5;235m▖\x1b[38;5;236m▄  \x1b[38;5;235;48;5;234m▌ \x1b[0m',
+    '\x1b[38;5;233;48;5;232m▏  \x1b[38;5;232;48;5;234m▌\x1b[38;5;240;48;5;236m▁\x1b[38;5;95;48;5;235m▁\x1b[38;5;186;48;5;137m▗ \x1b[38;5;95;48;5;173m▃\x1b[38;5;137;48;5;94m▘\x1b[38;5;58;48;5;234m▍\x1b[38;5;234;48;5;236m▘ \x1b[38;5;236;48;5;235m▏  \x1b[38;5;232;48;5;234m▄\x1b[0m',
+    '\x1b[38;5;233;48;5;232m▏\x1b[38;5;235m▁\x1b[38;5;95;48;5;234m▄\x1b[38;5;137;48;5;236m▆\x1b[48;5;95m \x1b[38;5;101m▁\x1b[38;5;137m▔\x1b[48;5;186m▄\x1b[48;5;95m▍\x1b[48;5;236m▃\x1b[38;5;143;48;5;235m▃\x1b[38;5;236m▏\x1b[38;5;235;48;5;236m▃\x1b[48;5;235m \x1b[38;5;234m▁\x1b[38;5;235;48;5;232m▘\x1b[38;5;232;48;5;16m▔\x1b[0m',
+    '\x1b[38;5;238;48;5;233m▗\x1b[38;5;8;48;5;137m▘\x1b[38;5;138m▘ \x1b[38;5;137;48;5;95m▊\x1b[38;5;95;48;5;101m▎\x1b[38;5;137;48;5;95m▎\x1b[48;5;101m▌\x1b[48;5;95m \x1b[38;5;95;48;5;101m▏\x1b[38;5;143m▔\x1b[38;5;101;48;5;236m▅\x1b[38;5;240;48;5;234m▖\x1b[38;5;235m▞\x1b[38;5;234;48;5;232m▘\x1b[38;5;232;48;5;16m▔ \x1b[0m',
+    '\x1b[38;5;52;48;5;95m▋\x1b[48;5;137m   \x1b[38;5;95;48;5;101m▕\x1b[38;5;240;48;5;137m▌\x1b[38;5;101m▂ \x1b[48;5;95m▏\x1b[38;5;239m▖▂\x1b[38;5;237m▄\x1b[38;5;101;48;5;234m▘\x1b[38;5;234;48;5;233m▝\x1b[48;5;232m▖\x1b[48;5;16m  \x1b[0m',
+    '\x1b[38;5;235;48;5;95m▌\x1b[38;5;95;48;5;137m▄\x1b[38;5;101m▁ \x1b[48;5;95m▌\x1b[38;5;238m▋\x1b[38;5;240;48;5;101m▃ \x1b[38;5;95;48;5;240m▎\x1b[38;5;236;48;5;239m▝\x1b[38;5;95;48;5;235m▆\x1b[38;5;240m▆\x1b[38;5;237;48;5;233m▆\x1b[48;5;234m▃\x1b[38;5;235;48;5;233m▎\x1b[38;5;233;48;5;232m▖\x1b[48;5;16m \x1b[0m',
+    '\x1b[38;5;234;48;5;95m▌  \x1b[38;5;95;48;5;101m▃\x1b[38;5;239;48;5;95m▗\x1b[38;5;238;48;5;234m▋\x1b[38;5;236;48;5;101m▎\x1b[38;5;101;48;5;95m▋\x1b[38;5;239m▂▎  \x1b[48;5;240m▃\x1b[38;5;8;48;5;236m▍\x1b[38;5;235;48;5;233m▋\x1b[38;5;232m▅\x1b[38;5;233;48;5;232m▖\x1b[0m',
+];
+// ─── FRANKLIN text banner (gold → emerald gradient) ────────────────────────
+//
+// Kept from v3.1.0. The text is laid out as 6 block-letter rows. Each row
+// is tinted with a color interpolated between GOLD_START and EMERALD_END,
+// giving the smooth vertical gradient that's been Franklin's banner since
+// v3.1.0.
 const FRANKLIN_ART = [
     ' ███████╗██████╗  █████╗ ███╗   ██╗██╗  ██╗██╗     ██╗███╗   ██╗',
     ' ██╔════╝██╔══██╗██╔══██╗████╗  ██║██║ ██╔╝██║     ██║████╗  ██║',
@@ -8,10 +42,6 @@ const FRANKLIN_ART = [
     ' ██║     ██║  ██║██║  ██║██║ ╚████║██║  ██╗███████╗██║██║ ╚████║',
     ' ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝╚═╝╚═╝  ╚═══╝',
 ];
-// Franklin brand gradient: gold → emerald
-// Gold (#FFD700) is the $100 bill / Benjamins color — marketing product energy
-// Emerald (#10B981) is the trading / money-moving color
-// The gradient between them tells the Franklin story in one glance
 const GOLD_START = '#FFD700';
 const EMERALD_END = '#10B981';
 function hexToRgb(hex) {
@@ -31,11 +61,97 @@ function interpolateHex(start, end, t) {
     const [r2, g2, b2] = hexToRgb(end);
     return rgbToHex(r1 + (r2 - r1) * t, g1 + (g2 - g1) * t, b1 + (b2 - b1) * t);
 }
+// ─── Banner layout ─────────────────────────────────────────────────────────
+// Minimum terminal width to show the side-by-side portrait + text layout.
+// The portrait is ~17 chars, the FRANKLIN text is ~65 chars, plus a 4-char
+// gap = 86 chars. We add a small margin so ~90 cols is the threshold.
+const MIN_WIDTH_FOR_PORTRAIT = 90;
+/**
+ * Pad a line to an exact visual width, ignoring ANSI escape codes when
+ * measuring. Used to align the portrait's right edge before the text block.
+ */
+function padVisible(s, targetWidth) {
+    // Strip ANSI color codes to measure visible length
+    // eslint-disable-next-line no-control-regex
+    const visible = s.replace(/\x1b\[[0-9;]*m/g, '');
+    // Unicode block characters are width 1 (they're half-blocks, not double-width)
+    const current = [...visible].length;
+    if (current >= targetWidth)
+        return s;
+    // Append a reset + padding so background colors don't bleed into the gap
+    return s + '\x1b[0m' + ' '.repeat(targetWidth - current);
+}
 export function printBanner(version) {
-    // Smooth 6-row gradient: each line gets its own interpolated color
-    const steps = FRANKLIN_ART.length;
-    for (let i = 0; i < steps; i++) {
-        const t = i / (steps - 1);
+    const termWidth = process.stdout.columns ?? 80;
+    const useSideBySide = termWidth >= MIN_WIDTH_FOR_PORTRAIT;
+    if (useSideBySide) {
+        printSideBySide(version);
+    }
+    else {
+        printTextOnly(version);
+    }
+}
+/**
+ * Full layout: Ben Franklin portrait on the left, FRANKLIN text block on the
+ * right. Portrait is 10 rows, text is 6 rows — portrait extends 4 rows below
+ * the text, so the 2-row tagline sits under the text and the last 2 rows
+ * below the portrait are just the bottom of the portrait.
+ *
+ *   [portrait row 1]                [empty]
+ *   [portrait row 2]                [empty]
+ *   [portrait row 3]     ███████╗██████╗  █████╗ ...
+ *   [portrait row 4]     ██╔════╝██╔══██╗██╔══██╗...
+ *   [portrait row 5]     █████╗  ██████╔╝███████║...
+ *   [portrait row 6]     ██╔══╝  ██╔══██╗██╔══██║...
+ *   [portrait row 7]     ██║     ██║  ██║██║  ██║...
+ *   [portrait row 8]     ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝...
+ *   [portrait row 9]     Franklin · The AI agent with a wallet · vX
+ *   [portrait row 10]    (empty)
+ *
+ * The text is vertically centered within the portrait — its top edge sits
+ * at portrait row 3 so there's a 2-row header padding above.
+ */
+function printSideBySide(version) {
+    const TEXT_TOP_OFFSET = 2; // rows of portrait above the text
+    const PORTRAIT_WIDTH = 18; // columns (char width) of the portrait + 1 pad
+    const GAP = '  '; // gap between portrait and text
+    const portraitRows = BEN_PORTRAIT_ROWS;
+    const textRows = FRANKLIN_ART.length;
+    const totalRows = Math.max(portraitRows.length, TEXT_TOP_OFFSET + textRows + 2);
+    for (let i = 0; i < totalRows; i++) {
+        const portraitLine = i < portraitRows.length
+            ? padVisible(portraitRows[i], PORTRAIT_WIDTH)
+            : ' '.repeat(PORTRAIT_WIDTH);
+        // Text column content
+        let textCol = '';
+        const textIdx = i - TEXT_TOP_OFFSET;
+        if (textIdx >= 0 && textIdx < textRows) {
+            // FRANKLIN block letters with gradient colour
+            const t = textRows === 1 ? 0 : textIdx / (textRows - 1);
+            const color = interpolateHex(GOLD_START, EMERALD_END, t);
+            textCol = chalk.hex(color)(FRANKLIN_ART[textIdx]);
+        }
+        else if (textIdx === textRows) {
+            // Tagline row sits right under the FRANKLIN block
+            textCol =
+                chalk.bold.hex(GOLD_START)('  Franklin') +
+                    chalk.dim('  ·  The AI agent with a wallet  ·  v' + version);
+        }
+        // Write with a reset at the very start to prevent stray bg from the
+        // previous line bleeding into the current row's portrait column.
+        process.stdout.write('\x1b[0m' + portraitLine + GAP + textCol + '\x1b[0m\n');
+    }
+    // Trailing blank line for breathing room
+    process.stdout.write('\n');
+}
+/**
+ * Compact layout for narrow terminals: just the FRANKLIN text block with
+ * its gradient, no portrait. Matches the v3.1.0 banner exactly.
+ */
+function printTextOnly(version) {
+    const textRows = FRANKLIN_ART.length;
+    for (let i = 0; i < textRows; i++) {
+        const t = textRows === 1 ? 0 : i / (textRows - 1);
         const color = interpolateHex(GOLD_START, EMERALD_END, t);
         console.log(chalk.hex(color)(FRANKLIN_ART[i]));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {