@blockrun/franklin 3.2.1 → 3.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/banner.js +79 -67
  2. package/package.json +1 -1
package/dist/banner.js CHANGED
@@ -2,38 +2,47 @@ import chalk from 'chalk';
2
2
  // ─── Ben Franklin portrait ─────────────────────────────────────────────────
3
3
  //
4
4
  // Generated once, at build time, from the Joseph Duplessis 1785 oil painting
5
- // of Benjamin Franklin (same source as the portrait on the US $100 bill).
6
- // Public domain image from Wikimedia Commons:
5
+ // of Benjamin Franklin (same source used for the engraving on the US $100
6
+ // bill). Public domain image from Wikimedia Commons:
7
7
  // https://commons.wikimedia.org/wiki/File:BenFranklinDuplessis.jpg
8
8
  //
9
- // Rendered via chafa with:
10
- // chafa --size=20x10 --symbols=block --colors=256 ben-franklin.jpg
9
+ // Pipeline:
10
+ // 1. Crop the 2403×2971 original to a 1400×1400 square centred on the face
11
+ // (sips --cropToHeightWidth 1400 1400 --cropOffset 400 500)
12
+ // 2. Convert with ascii-image-converter in braille mode:
13
+ // ascii-image-converter ben-face.jpg --dimensions 34,16 --braille \
14
+ // --threshold 110
11
15
  //
12
- // The raw ANSI escape codes are hex-encoded below so the TS source stays
13
- // readable and diff-friendly. Each string is one row of the portrait.
14
- // Visible dimensions: ~17 characters wide × 10 rows tall.
16
+ // Braille characters (U+2800..U+28FF) encode 2×4 dot matrices per cell, so
17
+ // a 34×16 braille output gives 68×64 = 4,352 effective "pixels" — 2.7× the
18
+ // resolution of chafa half-block mode at the same visible size. For a face,
19
+ // which is all about silhouette + key features, this is a massive win.
15
20
  //
16
- // Rendered best in a 256-color or truecolor terminal. Degrades gracefully
17
- // (shows as block-character garbage) on ancient terminals but those
18
- // are long gone and we don't support them.
21
+ // The output is pure Unicode no ANSI escape codes, no color tinting baked
22
+ // in which means it's trivial to wrap in chalk.hex() at render time for
23
+ // brand tinting, and it ships as a clean readable TS array.
19
24
  const BEN_PORTRAIT_ROWS = [
20
- '\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',
21
- '\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',
22
- '\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',
23
- '\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',
24
- '\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',
25
- '\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',
26
- '\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',
27
- '\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',
28
- '\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',
29
- '\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',
25
+ '⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣤⣴⣶⣶⣦⣤⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
26
+ '⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
27
+ '⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
28
+ '⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡆⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
29
+ '⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⠁⣀⠀⠉⣿⣿⣿⠋⢀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
30
+ '⠀⠀⠀⠀⠀⠀⠀⢀⠀⢠⣿⣿⣿⣾⣤⣴⣴⣿⣿⣷⠀⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
31
+ '⠀⠀⠀⢠⡄⠀⠀⠁⢀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡄⢾⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
32
+ '⠀⠀⠀⠸⡔⠂⠀⠀⠘⣿⣿⣿⣿⣿⣿⣿⣿⣛⣛⠛⠁⠈⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
33
+ '⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⣿⢿⣿⠿⢷⠄⠀⠙⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
34
+ '⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡆⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
35
+ '⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
36
+ '⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⡿⣿⡿⣿⣏⠛⠛⠙⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
37
+ '⠀⠀⡴⠺⠖⢒⣂⢄⡀⣹⣿⣿⣿⣶⣙⠂⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
38
+ '⣶⣤⣄⡀⠈⠻⠿⡙⠗⠸⡻⣿⡻⣿⣿⣷⣦⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀',
39
+ '⣿⡟⠻⣿⣦⡀⠀⢁⡆⠀⠹⢿⣿⣮⣟⠿⣿⠏⠀⠀⣀⣴⣶⣦⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀',
40
+ '⣿⣷⣄⠈⠿⣷⡀⣾⣿⡀⢦⢸⣿⡹⣿⣿⡆⣤⡐⠻⡻⣿⣿⣿⣿⣦⠀⠀⠀⠀⠀⠀⠀⠀',
30
41
  ];
31
42
  // ─── FRANKLIN text banner (gold → emerald gradient) ────────────────────────
32
43
  //
33
- // Kept from v3.1.0. The text is laid out as 6 block-letter rows. Each row
34
- // is tinted with a color interpolated between GOLD_START and EMERALD_END,
35
- // giving the smooth vertical gradient that's been Franklin's banner since
36
- // v3.1.0.
44
+ // Kept from v3.1.0. 6 block-letter rows, each tinted with an interpolated
45
+ // colour between GOLD_START and EMERALD_END for a smooth vertical gradient.
37
46
  const FRANKLIN_ART = [
38
47
  ' ███████╗██████╗ █████╗ ███╗ ██╗██╗ ██╗██╗ ██╗███╗ ██╗',
39
48
  ' ██╔════╝██╔══██╗██╔══██╗████╗ ██║██║ ██╔╝██║ ██║████╗ ██║',
@@ -63,23 +72,19 @@ function interpolateHex(start, end, t) {
63
72
  }
64
73
  // ─── Banner layout ─────────────────────────────────────────────────────────
65
74
  // Minimum terminal width to show the side-by-side portrait + text layout.
66
- // The portrait is ~17 chars, the FRANKLIN text is ~65 chars, plus a 4-char
67
- // gap = 86 chars. We add a small margin so ~90 cols is the threshold.
68
- const MIN_WIDTH_FOR_PORTRAIT = 90;
75
+ // Portrait: 34 cols braille, FRANKLIN text: ~65 cols, gap: 3 cols,
76
+ // total: ~102 cols. Add a 3-col margin of safety 105.
77
+ const MIN_WIDTH_FOR_PORTRAIT = 105;
69
78
  /**
70
- * Pad a line to an exact visual width, ignoring ANSI escape codes when
71
- * measuring. Used to align the portrait's right edge before the text block.
79
+ * Pad a line to an exact visual width. Braille characters have no ANSI
80
+ * escape codes and are all 1 cell wide, so this is a straightforward
81
+ * codepoint count.
72
82
  */
73
- function padVisible(s, targetWidth) {
74
- // Strip ANSI color codes to measure visible length
75
- // eslint-disable-next-line no-control-regex
76
- const visible = s.replace(/\x1b\[[0-9;]*m/g, '');
77
- // Unicode block characters are width 1 (they're half-blocks, not double-width)
78
- const current = [...visible].length;
83
+ function padBraillePortrait(s, targetWidth) {
84
+ const current = [...s].length;
79
85
  if (current >= targetWidth)
80
86
  return s;
81
- // Append a reset + padding so background colors don't bleed into the gap
82
- return s + '\x1b[0m' + ' '.repeat(targetWidth - current);
87
+ return s + ' '.repeat(targetWidth - current);
83
88
  }
84
89
  export function printBanner(version) {
85
90
  const termWidth = process.stdout.columns ?? 80;
@@ -92,36 +97,42 @@ export function printBanner(version) {
92
97
  }
93
98
  }
94
99
  /**
95
- * Full layout: Ben Franklin portrait on the left, FRANKLIN text block on the
96
- * right. Portrait is 10 rows, text is 6 rows portrait extends 4 rows below
97
- * the text, so the 2-row tagline sits under the text and the last 2 rows
98
- * below the portrait are just the bottom of the portrait.
100
+ * Full layout: Ben Franklin braille portrait on the left, FRANKLIN gradient
101
+ * text on the right. Portrait is 16 rows × 34 cols, text is 6 rows + 1-row
102
+ * tagline. Text starts at portrait row 5 so the FRANKLIN block aligns with
103
+ * Ben's face region (head at rows 1-4, face at rows 5-10, shoulders 11-16),
104
+ * giving the classic "portrait and nameplate" composition.
99
105
  *
100
- * [portrait row 1] [empty]
101
- * [portrait row 2] [empty]
102
- * [portrait row 3] ███████╗██████╗ █████╗ ...
103
- * [portrait row 4] ██╔════╝██╔══██╗██╔══██╗...
104
- * [portrait row 5] █████╗ ██████╔╝███████║...
105
- * [portrait row 6] ██╔══╝ ██╔══██╗██╔══██║...
106
- * [portrait row 7] ██║ ██║ ██║██║ ██║...
107
- * [portrait row 8] ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝...
108
- * [portrait row 9] Franklin · The AI agent with a wallet · vX
109
- * [portrait row 10] (empty)
110
- *
111
- * The text is vertically centered within the portrait — its top edge sits
112
- * at portrait row 3 so there's a 2-row header padding above.
106
+ * row 1 ⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣤⣴⣶⣶⣦⣤⣄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
107
+ * row 2 ⠀⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⣿⣿⣿⣿⣿⣷⡄⠀⠀⠀⠀⠀⠀⠀⠀
108
+ * row 3 ⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⠀⠀⠀⠀⠀⠀⠀
109
+ * row 4 ⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡆⠀⠀⠀⠀⠀⠀
110
+ * row 5 ⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⠁... ███████╗██████╗ █████╗ ...
111
+ * row 6 ⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣾... ██╔════╝██╔══██╗██╔══██╗...
112
+ * row 7 ⠀⠀⠀⢠⡄⠀⠀⠀⢀⣾⣿... █████╗ ██████╔╝███████║...
113
+ * row 8 ⠀⠀⠀⠸⡔⠂⠀⠀⠘⣿⣿... ██╔══╝ ██╔══██╗██╔══██║...
114
+ * row 9 ⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿... ██║ ██║ ██║██║ ██║...
115
+ * row 10 ⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿... ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝...
116
+ * row 11 ⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿... blockrun.ai · The AI agent with a wallet · vX
117
+ * row 12 ⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿...
118
+ * row 13-16: neck, collar, body
113
119
  */
114
120
  function printSideBySide(version) {
115
- const TEXT_TOP_OFFSET = 2; // rows of portrait above the text
116
- const PORTRAIT_WIDTH = 18; // columns (char width) of the portrait + 1 pad
117
- const GAP = ' '; // gap between portrait and text
121
+ const TEXT_TOP_OFFSET = 4; // text block starts at portrait row 5 (0-indexed row 4)
122
+ const PORTRAIT_WIDTH = 35; // 34 cols braille + 1 trailing space
123
+ const GAP = ' ';
118
124
  const portraitRows = BEN_PORTRAIT_ROWS;
119
125
  const textRows = FRANKLIN_ART.length;
120
126
  const totalRows = Math.max(portraitRows.length, TEXT_TOP_OFFSET + textRows + 2);
127
+ // Tint the braille portrait in dim white for a "pencil portrait" feel.
128
+ // Braille chars carry no colour on their own — chalk wraps them in an
129
+ // ANSI colour sequence at render time.
130
+ const portraitTint = chalk.hex('#E8E8E8');
121
131
  for (let i = 0; i < totalRows; i++) {
122
- const portraitLine = i < portraitRows.length
123
- ? padVisible(portraitRows[i], PORTRAIT_WIDTH)
132
+ const rawPortraitLine = i < portraitRows.length
133
+ ? padBraillePortrait(portraitRows[i], PORTRAIT_WIDTH)
124
134
  : ' '.repeat(PORTRAIT_WIDTH);
135
+ const portraitLine = portraitTint(rawPortraitLine);
125
136
  // Text column content
126
137
  let textCol = '';
127
138
  const textIdx = i - TEXT_TOP_OFFSET;
@@ -132,21 +143,22 @@ function printSideBySide(version) {
132
143
  textCol = chalk.hex(color)(FRANKLIN_ART[textIdx]);
133
144
  }
134
145
  else if (textIdx === textRows) {
135
- // Tagline row sits right under the FRANKLIN block
146
+ // Tagline row sits right under the FRANKLIN block.
147
+ // The big block-letter FRANKLIN above already says the product name
148
+ // — the tagline uses that line for the parent brand URL
149
+ // (blockrun.ai — a real live domain; see v3.1.0 notes for why
150
+ // franklin.run is explicitly NOT used here).
136
151
  textCol =
137
- chalk.bold.hex(GOLD_START)(' Franklin') +
152
+ chalk.bold.hex(GOLD_START)(' blockrun.ai') +
138
153
  chalk.dim(' · The AI agent with a wallet · v' + version);
139
154
  }
140
- // Write with a reset at the very start to prevent stray bg from the
141
- // previous line bleeding into the current row's portrait column.
142
- process.stdout.write('\x1b[0m' + portraitLine + GAP + textCol + '\x1b[0m\n');
155
+ process.stdout.write(portraitLine + GAP + textCol + '\n');
143
156
  }
144
- // Trailing blank line for breathing room
145
157
  process.stdout.write('\n');
146
158
  }
147
159
  /**
148
160
  * Compact layout for narrow terminals: just the FRANKLIN text block with
149
- * its gradient, no portrait. Matches the v3.1.0 banner exactly.
161
+ * its gradient, no portrait.
150
162
  */
151
163
  function printTextOnly(version) {
152
164
  const textRows = FRANKLIN_ART.length;
@@ -155,7 +167,7 @@ function printTextOnly(version) {
155
167
  const color = interpolateHex(GOLD_START, EMERALD_END, t);
156
168
  console.log(chalk.hex(color)(FRANKLIN_ART[i]));
157
169
  }
158
- console.log(chalk.bold.hex(GOLD_START)(' Franklin') +
170
+ console.log(chalk.bold.hex(GOLD_START)(' blockrun.ai') +
159
171
  chalk.dim(' · The AI agent with a wallet · v' + version) +
160
172
  '\n');
161
173
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blockrun/franklin",
3
- "version": "3.2.1",
3
+ "version": "3.2.3",
4
4
  "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
5
5
  "type": "module",
6
6
  "exports": {