@blockrun/franklin 3.3.1 → 3.3.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.
package/README.md CHANGED
@@ -2,9 +2,9 @@
2
2
 
3
3
  <br>
4
4
 
5
- <h1>
6
- <code>◆</code> &nbsp; Franklin &nbsp; <code>◆</code>
7
- </h1>
5
+ <img src="assets/terminal-banner.png" alt="Franklin terminal" width="680">
6
+
7
+ <br><br>
8
8
 
9
9
  <h3>The wallet-native economic agent.</h3>
10
10
 
package/dist/banner.js CHANGED
@@ -7,32 +7,26 @@ import chalk from 'chalk';
7
7
  // https://commons.wikimedia.org/wiki/File:BenFranklinDuplessis.jpg
8
8
  //
9
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)
10
+ // 1. Crop the 800×989 thumb to a 500×500 square centred on the face
11
+ // (sips --cropToHeightWidth 500 500 --cropOffset 140 150)
12
12
  // 2. Convert via chafa:
13
- // chafa --size=30x14 --symbols=block --colors=256 ben-face.jpg
13
+ // chafa --size=16x8 --symbols=block --colors=full ben-face.jpg
14
14
  // 3. Strip cursor visibility control codes (\x1b[?25l / \x1b[?25h)
15
15
  // 4. Paste here as hex-escaped string array (readable + diff-friendly)
16
16
  //
17
- // Visible dimensions: ~28 characters wide × 14 rows tall.
17
+ // Visible dimensions: ~16 characters wide × 8 rows tall.
18
18
  //
19
19
  // Rendered best in a 256-color or truecolor terminal. Degrades gracefully
20
20
  // on ancient terminals — but those are long gone and we don't support them.
21
21
  const BEN_PORTRAIT_ROWS = [
22
- '\x1b[0m\x1b[38;5;16;48;5;16m \x1b[38;5;232m▁\x1b[38;5;235;48;5;232m▂\x1b[38;5;58;48;5;233m▄\x1b[38;5;95;48;5;234m▆\x1b[38;5;137;48;5;58m▄\x1b[38;5;173m▅\x1b[48;5;94m▅\x1b[48;5;58m▆▅\x1b[48;5;237m▄\x1b[38;5;137;48;5;234m▃\x1b[38;5;235;48;5;233m▂ \x1b[38;5;233;48;5;232m▂▅\x1b[48;5;233m \x1b[0m',
23
- '\x1b[38;5;16;48;5;16m \x1b[38;5;235;48;5;232m▗\x1b[38;5;233;48;5;236m▘\x1b[38;5;8;48;5;239m▌\x1b[38;5;95;48;5;137m▋\x1b[38;5;137;48;5;179m▘ \x1b[38;5;179;48;5;173m▃\x1b[48;5;179m \x1b[48;5;173m▊\x1b[38;5;58;48;5;137m▝\x1b[38;5;94;48;5;235m▖\x1b[38;5;234;48;5;233m▅▄▂ ▂▗▄▃\x1b[0m',
24
- '\x1b[38;5;16;48;5;16m \x1b[38;5;235;48;5;232m▗\x1b[38;5;236;48;5;237m▍ \x1b[38;5;58;48;5;94m▋\x1b[38;5;95;48;5;173m▌\x1b[48;5;179m \x1b[38;5;179;48;5;215m▍\x1b[48;5;221m▔\x1b[38;5;222;48;5;180m▍\x1b[48;5;179m \x1b[38;5;173m▕\x1b[38;5;179;48;5;173m▅\x1b[38;5;137m▕\x1b[38;5;95;48;5;58m▍\x1b[38;5;58;48;5;235m▖\x1b[38;5;235;48;5;234m▖▃▄ \x1b[0m',
25
- '\x1b[38;5;16;48;5;16m \x1b[38;5;233m▗\x1b[48;5;235m▏\x1b[38;5;237;48;5;238m▊\x1b[38;5;238;48;5;236m▌\x1b[38;5;236;48;5;58m▖\x1b[38;5;95;48;5;179m▌ \x1b[38;5;137m▗\x1b[38;5;94m▄\x1b[38;5;58m▄\x1b[38;5;94m▄\x1b[38;5;137m▖\x1b[38;5;173m▗\x1b[38;5;131m▗\x1b[38;5;58;48;5;137m▃\x1b[38;5;131;48;5;58m▘\x1b[38;5;234m▕\x1b[48;5;236m▖\x1b[38;5;236;48;5;235m▃ \x1b[38;5;234m▝\x1b[38;5;235;48;5;234m▃\x1b[0m',
26
- '\x1b[38;5;16;48;5;16m \x1b[38;5;235;48;5;232m▂\x1b[38;5;236;48;5;234m▄\x1b[38;5;237;48;5;236m▗\x1b[38;5;8;48;5;239m▖\x1b[38;5;240;48;5;8m▎\x1b[38;5;94;48;5;236m▕\x1b[38;5;137;48;5;179m▍ \x1b[38;5;94;48;5;137m▝\x1b[38;5;173;48;5;94m▂\x1b[38;5;137;48;5;58m▂\x1b[48;5;94m▃\x1b[48;5;179m▘\x1b[38;5;173m▝\x1b[38;5;137;48;5;235m▍\x1b[38;5;94;48;5;236m▝\x1b[38;5;235;48;5;94m▖\x1b[38;5;52;48;5;58m▖\x1b[38;5;235;48;5;233m▝\x1b[48;5;236m▁\x1b[48;5;235m \x1b[0m',
27
- '\x1b[38;5;232;48;5;16m▗\x1b[38;5;233;48;5;236m▌\x1b[38;5;95;48;5;239m▅\x1b[48;5;240m▃\x1b[38;5;94;48;5;238m▖\x1b[38;5;240;48;5;8m▝\x1b[38;5;95;48;5;236m▘\x1b[38;5;236;48;5;95m▘\x1b[38;5;173;48;5;179m▏ \x1b[38;5;215m▄ \x1b[38;5;179;48;5;137m▅\x1b[38;5;137;48;5;179m▘\x1b[38;5;216m▘\x1b[38;5;179;48;5;216m▃\x1b[48;5;94m▌\x1b[38;5;94;48;5;131m▘\x1b[38;5;95;48;5;94m▋\x1b[38;5;94;48;5;52m▃\x1b[38;5;52;48;5;233m▎\x1b[38;5;233;48;5;235m▅\x1b[38;5;234m▂ \x1b[0m',
28
- '\x1b[38;5;233;48;5;232m▕\x1b[38;5;234;48;5;236m▘\x1b[38;5;8;48;5;95m▌ \x1b[38;5;236m▃\x1b[38;5;58;48;5;234m▘\x1b[38;5;94m▝\x1b[48;5;137m▎\x1b[38;5;179;48;5;173m▍\x1b[38;5;173;48;5;179m▌▆▖▃▞\x1b[38;5;94;48;5;173m▗\x1b[48;5;179m▄\x1b[38;5;179;48;5;58m▘\x1b[38;5;94;48;5;52m▝\x1b[38;5;130;48;5;131m▃\x1b[38;5;94;48;5;58m▍\x1b[38;5;52;48;5;232m▎\x1b[38;5;232;48;5;233m▌\x1b[38;5;233;48;5;234m▏\x1b[38;5;234;48;5;235m▎\x1b[38;5;236m▌▅▄ \x1b[0m',
29
- '\x1b[38;5;232;48;5;235m▋\x1b[38;5;58;48;5;236m▝\x1b[48;5;58m \x1b[38;5;239;48;5;94m▅\x1b[38;5;237;48;5;235m▂\x1b[38;5;235;48;5;233m▂\x1b[38;5;234;48;5;94m▄\x1b[38;5;94;48;5;137m▖\x1b[48;5;173m \x1b[38;5;173;48;5;179m▃ \x1b[38;5;137m▂▃▂\x1b[38;5;131;48;5;137m▃\x1b[38;5;58;48;5;131m▝\x1b[38;5;94;48;5;52m▅\x1b[48;5;94m \x1b[48;5;58m▍\x1b[38;5;235;48;5;232m▎\x1b[38;5;232;48;5;233m▋\x1b[38;5;233;48;5;234m▍\x1b[38;5;235;48;5;236m▏ \x1b[38;5;236;48;5;235m▎ \x1b[0m',
30
- '\x1b[38;5;234;48;5;235m▏\x1b[38;5;236;48;5;237m▋\x1b[38;5;237;48;5;8m▃\x1b[38;5;235;48;5;238m▗\x1b[38;5;237m▖\x1b[38;5;58;48;5;234m▌\x1b[38;5;234;48;5;233m▎\x1b[38;5;236;48;5;137m▎\x1b[38;5;137;48;5;173m▄ \x1b[38;5;173;48;5;179m▄▃ \x1b[38;5;179;48;5;215m▅\x1b[38;5;173;48;5;179m▄\x1b[38;5;179;48;5;137m▘\x1b[38;5;137;48;5;131m▌\x1b[48;5;94m \x1b[38;5;58m▗\x1b[38;5;233;48;5;58m▗\x1b[48;5;233m \x1b[38;5;234;48;5;236m▘ \x1b[38;5;236;48;5;235m▃▞\x1b[38;5;235;48;5;236m▄\x1b[48;5;235m \x1b[0m',
31
- '\x1b[38;5;234;48;5;235m▏▆\x1b[38;5;235;48;5;237m▌\x1b[38;5;236m▝\x1b[38;5;237;48;5;234m▍\x1b[38;5;234;48;5;233m▖\x1b[38;5;240;48;5;234m▗\x1b[38;5;101;48;5;186m▌\x1b[38;5;137m▝\x1b[48;5;137m \x1b[48;5;173m▆▄▃\x1b[38;5;131m▂\x1b[38;5;130;48;5;137m▂\x1b[38;5;58;48;5;94m▃\x1b[48;5;58m \x1b[38;5;234;48;5;233m▏\x1b[38;5;235;48;5;234m▅\x1b[48;5;236m▌ ▝ \x1b[48;5;235m \x1b[0m',
32
- '\x1b[38;5;234;48;5;233m▕\x1b[38;5;239;48;5;235m▂\x1b[38;5;95m▃\x1b[48;5;237m▄\x1b[48;5;236m▄\x1b[48;5;235m▄\x1b[38;5;236;48;5;240m▘\x1b[38;5;101;48;5;95m▕\x1b[48;5;186m▖\x1b[38;5;179;48;5;229m▝\x1b[38;5;223;48;5;137m▃\x1b[38;5;137;48;5;131m▁\x1b[38;5;95m▅\x1b[38;5;94m▂\x1b[48;5;94m \x1b[38;5;58m▗\x1b[38;5;94;48;5;58m▔\x1b[38;5;236m▁ \x1b[48;5;235m▆\x1b[38;5;235;48;5;236m▍\x1b[38;5;236;48;5;235m▆\x1b[48;5;236m \x1b[38;5;235m▅\x1b[48;5;235m \x1b[0m',
33
- '\x1b[38;5;237;48;5;95m▔ \x1b[38;5;137;48;5;101m▝\x1b[48;5;187m▅\x1b[38;5;180;48;5;229m▂\x1b[38;5;143;48;5;222m▔\x1b[38;5;186;48;5;58m▅\x1b[38;5;179m▂\x1b[38;5;95m▁\x1b[38;5;235m▂\x1b[38;5;236m▄\x1b[48;5;233m▌\x1b[38;5;235m▔\x1b[38;5;233;48;5;236m▅\x1b[38;5;234m▃\x1b[38;5;235m▁ ▔\x1b[48;5;235m \x1b[0m',
34
- '\x1b[38;5;101;48;5;137m▔\x1b[38;5;95;48;5;101m▄▔\x1b[38;5;101;48;5;95m▄ ▗ \x1b[38;5;240m▖\x1b[38;5;95;48;5;101m▘\x1b[38;5;137m▔\x1b[48;5;222m▅\x1b[48;5;186m▃\x1b[48;5;179m▂\x1b[38;5;101;48;5;95m▌\x1b[48;5;58m \x1b[38;5;238;48;5;236m▁\x1b[38;5;180;48;5;234m▃\x1b[48;5;235m▄\x1b[38;5;179;48;5;234m▃\x1b[38;5;95m▁\x1b[38;5;234;48;5;235m▊\x1b[48;5;236m▆\x1b[38;5;235m▃\x1b[38;5;234m▂\x1b[38;5;235m▁ \x1b[38;5;236;48;5;235m▎\x1b[0m',
35
- '\x1b[38;5;137;48;5;137m \x1b[48;5;95m▄ \x1b[38;5;95;48;5;101m▖\x1b[48;5;137m▝\x1b[48;5;95m \x1b[38;5;101m▅\x1b[48;5;239m▋\x1b[48;5;95m \x1b[38;5;95;48;5;137m▋\x1b[38;5;101;48;5;95m▍\x1b[38;5;95;48;5;101m▖\x1b[38;5;101;48;5;95m▆\x1b[38;5;239m▗\x1b[38;5;101m▄ \x1b[38;5;95;48;5;137m▅\x1b[38;5;137;48;5;180m▅\x1b[38;5;180;48;5;186m▃\x1b[48;5;143m▆\x1b[38;5;95m▔\x1b[38;5;143;48;5;235m▖\x1b[48;5;234m \x1b[38;5;235m▆\x1b[38;5;234;48;5;235m▝\x1b[38;5;235;48;5;234m▞\x1b[38;5;234;48;5;235m▄ \x1b[0m',
22
+ '\x1b[0m\x1b[38;2;7;0;0;48;2;8;0;0m▔ \x1b[38;2;9;1;0m▂\x1b[38;2;56;36;15;48;2;11;2;0m▗\x1b[38;2;100;73;36;48;2;31;16;6m▅\x1b[38;2;189;141;75;48;2;117;87;43m▅\x1b[38;2;217;162;85;48;2;152;111;51m▆\x1b[38;2;164;122;64;48;2;215;158;85m▔\x1b[38;2;124;90;46;48;2;217;160;93m▔\x1b[38;2;185;136;75;48;2;77;48;20m▅\x1b[38;2;100;61;24;48;2;39;18;4m▖\x1b[38;2;48;26;9;48;2;32;13;3m▃\x1b[38;2;39;18;4;48;2;30;11;2m▄\x1b[38;2;38;17;4;48;2;32;13;3m▄\x1b[38;2;40;20;5;48;2;35;15;2m▃\x1b[38;2;41;21;5;48;2;36;16;3m▂\x1b[0m',
23
+ '\x1b[7m\x1b[38;2;8;0;0m \x1b[0m\x1b[38;2;0;0;0;48;2;8;0;0m \x1b[38;2;13;2;1;48;2;45;26;10m▊\x1b[38;2;61;40;17;48;2;87;63;31m▎\x1b[38;2;88;61;29;48;2;134;94;42m▋\x1b[38;2;182;132;66;48;2;223;172;93m▏\x1b[38;2;140;91;38;48;2;233;193;106m▂\x1b[38;2;135;82;35;48;2;229;178;106m▂\x1b[38;2;201;145;78;48;2;223;166;95m▂\x1b[38;2;133;88;46;48;2;198;148;86m▁\x1b[38;2;144;96;47;48;2;96;57;21m▍\x1b[38;2;66;42;15;48;2;58;33;11m▗\x1b[38;2;59;36;13;48;2;47;25;9m▆\x1b[38;2;57;35;11;48;2;46;24;7m▅\x1b[38;2;58;36;11;48;2;50;29;8m▖\x1b[38;2;53;32;8;48;2;48;26;7m▃\x1b[0m',
24
+ '\x1b[38;2;12;3;3;48;2;9;0;0m▁\x1b[38;2;102;76;40;48;2;19;8;4m▗\x1b[38;2;110;83;45;48;2;56;35;15m▄\x1b[38;2;91;67;37;48;2;105;79;45m▌\x1b[38;2;96;64;31;48;2;186;135;70m▊\x1b[38;2;226;169;101;48;2;217;162;91m▗\x1b[38;2;216;159;89;48;2;144;93;44m▅\x1b[38;2;195;145;83;48;2;112;62;24m▅\x1b[38;2;233;178;110;48;2;206;151;81m▆\x1b[38;2;207;155;92;48;2;105;61;30m▎\x1b[38;2;145;94;46;48;2;94;50;19m▖\x1b[38;2;90;48;17;48;2;52;26;8m▎\x1b[38;2;59;33;9;48;2;64;40;14m▖\x1b[38;2;63;39;13;48;2;65;41;13m▊\x1b[38;2;58;36;11;48;2;64;40;14m▝\x1b[38;2;60;38;13;48;2;57;35;10m▍\x1b[0m',
25
+ '\x1b[38;2;37;22;12;48;2;11;2;2m▕\x1b[38;2;52;32;16;48;2;94;67;32m▘\x1b[38;2;77;53;21;48;2;125;96;52m▗\x1b[38;2;44;15;6;48;2;83;48;21m▞\x1b[38;2;122;73;33;48;2;195;138;72m▍\x1b[38;2;209;149;77;48;2;223;160;89m▋\x1b[38;2;228;157;84;48;2;234;173;98m▆\x1b[38;2;207;140;80;48;2;225;167;96m▝\x1b[38;2;213;151;88;48;2;193;135;79m▏\x1b[38;2;164;111;60;48;2;104;54;21m▍\x1b[38;2;175;110;52;48;2;136;78;32m▘\x1b[38;2;93;47;15;48;2;26;5;2m▎\x1b[38;2;39;13;4;48;2;54;28;8m▍\x1b[38;2;63;40;13;48;2;67;44;16m▔\x1b[38;2;68;44;15;48;2;65;41;16m▊\x1b[38;2;60;36;11;48;2;63;39;14m▝\x1b[0m',
26
+ '\x1b[38;2;12;1;0;48;2;55;33;13m▌\x1b[38;2;92;63;32;48;2;68;43;17m▝\x1b[38;2;75;51;24;48;2;93;65;34m▗\x1b[38;2;88;61;30;48;2;42;18;8m▘\x1b[38;2;62;35;18;48;2;191;150;83m▍\x1b[38;2;186;140;75;48;2;194;138;63m▁\x1b[38;2;189;130;61;48;2;219;157;79m▄\x1b[38;2;191;132;70;48;2;217;159;87m▂\x1b[38;2;179;105;60;48;2;207;146;83m▔\x1b[38;2;171;106;51;48;2;135;79;32m▋\x1b[38;2;64;30;8;48;2;120;69;27m▗\x1b[38;2;56;26;8;48;2;39;13;5m▂\x1b[38;2;44;18;7;48;2;72;44;16m▘\x1b[38;2;72;47;18;48;2;69;44;14m▖\x1b[38;2;70;46;14;48;2;68;44;14m▁\x1b[38;2;65;41;12;48;2;65;41;14m▘\x1b[0m',
27
+ '\x1b[38;2;77;56;35;48;2;22;8;3m▂\x1b[38;2;126;100;69;48;2;59;36;15m▃\x1b[38;2;131;105;70;48;2;80;54;27m▄\x1b[38;2;128;103;68;48;2;57;33;14m▄\x1b[38;2;191;174;117;48;2;125;103;69m▝\x1b[38;2;191;164;108;48;2;236;227;160m▞\x1b[38;2;220;202;137;48;2;173;123;63m▃\x1b[38;2;130;85;43;48;2;164;111;58m▄\x1b[38;2;117;68;26;48;2;185;116;58m▆\x1b[38;2;135;80;33;48;2;94;52;15m▘\x1b[38;2;51;28;9;48;2;80;50;16m▂\x1b[38;2;62;33;9;48;2;76;46;14m▘\x1b[38;2;75;50;16;48;2;74;47;15m▗\x1b[38;2;71;46;14;48;2;72;47;15m▝\x1b[38;2;73;48;16;48;2;69;44;14m▏\x1b[38;2;65;41;11;48;2;66;41;15m▆\x1b[0m',
28
+ '\x1b[38;2;125;101;70;48;2;159;129;87m▔\x1b[38;2;145;114;71;48;2;124;100;70m▆\x1b[38;2;152;123;81;48;2;121;100;69m▃\x1b[38;2;117;95;60;48;2;129;106;70m▖\x1b[38;2;115;91;61;48;2;131;105;69m▗\x1b[38;2;166;145;103;48;2;140;113;71m▔\x1b[38;2;162;135;87;48;2;231;217;147m▅\x1b[38;2;133;107;71;48;2;199;171;110m▂\x1b[38;2;131;100;59;48;2;107;75;37m▍\x1b[38;2;166;139;88;48;2;67;40;14m▃\x1b[38;2;204;179;121;48;2;39;19;8m▄\x1b[38;2;137;112;73;48;2;52;28;10m▖\x1b[38;2;54;32;10;48;2;76;49;16m▅\x1b[38;2;56;33;9;48;2;74;48;15m▃\x1b[38;2;60;37;10;48;2;70;47;14m▁\x1b[38;2;66;43;12;48;2;64;40;11m▅\x1b[0m',
29
+ '\x1b[38;2;157;128;85;48;2;167;138;98m▝\x1b[38;2;141;111;71;48;2;166;136;98m▝\x1b[38;2;149;119;83;48;2;126;96;60m▞\x1b[38;2;157;129;93;48;2;139;113;81m▅\x1b[38;2;144;117;79;48;2;117;92;58m▋\x1b[38;2;130;102;62;48;2;169;138;87m▋\x1b[38;2;171;141;87;48;2;143;117;77m▖\x1b[38;2;144;117;79;48;2;122;96;63m▊\x1b[38;2;132;105;68;48;2;144;117;82m▖\x1b[38;2;153;127;92;48;2;140;115;83m▞\x1b[38;2;134;108;71;48;2;217;193;135m▅\x1b[38;2;176;150;98;48;2;129;105;66m▋\x1b[38;2;118;94;61;48;2;54;32;14m▂\x1b[38;2;44;23;8;48;2;59;37;13m▃\x1b[38;2;62;41;16;48;2;48;26;9m▖\x1b[38;2;46;24;6;48;2;66;42;15m▖\x1b[0m',
36
30
  ];
37
31
  // ─── FRANKLIN text banner (gold → emerald gradient) ────────────────────────
38
32
  //
@@ -69,9 +63,9 @@ function interpolateHex(start, end, t) {
69
63
  }
70
64
  // ─── Banner layout ─────────────────────────────────────────────────────────
71
65
  // Minimum terminal width to show the side-by-side portrait + text layout.
72
- // The portrait is ~28 chars, the FRANKLIN text is ~65 chars, plus a 3-char
73
- // gap = 96 chars. We add a small margin so 100 cols is the threshold.
74
- const MIN_WIDTH_FOR_PORTRAIT = 100;
66
+ // The portrait is ~16 chars, the FRANKLIN text is ~65 chars, plus a 3-char
67
+ // gap = 84 chars. We round up to 85 cols as the threshold.
68
+ const MIN_WIDTH_FOR_PORTRAIT = 85;
75
69
  /**
76
70
  * Pad a line to an exact visual width, ignoring ANSI escape codes when
77
71
  * measuring. Used to align the portrait's right edge before the text block.
@@ -99,28 +93,21 @@ export function printBanner(version) {
99
93
  }
100
94
  /**
101
95
  * Full layout: Ben Franklin portrait on the left, FRANKLIN text block on the
102
- * right. Portrait is 14 rows × ~28 chars, text is 6 rows — text is vertically
103
- * centred inside the portrait with 4 rows of padding above and 4 below,
104
- * tagline sitting right under the FRANKLIN block.
96
+ * right. Portrait is 8 rows × ~16 chars, text is 6 rows — text is vertically
97
+ * centred inside the portrait with 1 row of padding above.
105
98
  *
106
- * [portrait row 1] (empty)
107
- * [portrait row 2] (empty)
108
- * [portrait row 3] (empty)
109
- * [portrait row 4] (empty)
110
- * [portrait row 5] ███████╗██████╗ █████╗ ...
111
- * [portrait row 6] ██╔════╝██╔══██╗██╔══██╗...
112
- * [portrait row 7] █████╗ ██████╔╝███████║...
113
- * [portrait row 8] ██╔══╝ ██╔══██╗██╔══██║...
114
- * [portrait row 9] ██║ ██║ ██║██║ ██║...
115
- * [portrait row 10] ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝...
116
- * [portrait row 11] blockrun.ai · The AI agent with a wallet · vX
117
- * [portrait row 12] (empty)
118
- * [portrait row 13] (empty)
119
- * [portrait row 14] (empty)
99
+ * [portrait row 1] (empty)
100
+ * [portrait row 2] ███████╗██████╗ █████╗ ...
101
+ * [portrait row 3] ██╔════╝██╔══██╗██╔══██╗...
102
+ * [portrait row 4] █████╗ ██████╔╝███████║...
103
+ * [portrait row 5] ██╔══╝ ██╔══██╗██╔══██║...
104
+ * [portrait row 6] ██║ ██║ ██║██║ ██║...
105
+ * [portrait row 7] ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝...
106
+ * [portrait row 8] blockrun.ai · The AI agent with a wallet · vX
120
107
  */
121
108
  function printSideBySide(version) {
122
- const TEXT_TOP_OFFSET = 4; // rows of portrait above the text
123
- const PORTRAIT_WIDTH = 29; // columns (char width) of the portrait + 1 pad
109
+ const TEXT_TOP_OFFSET = 1; // rows of portrait above the text
110
+ const PORTRAIT_WIDTH = 17; // columns (char width) of the portrait + 1 pad
124
111
  const GAP = ' '; // gap between portrait and text
125
112
  const portraitRows = BEN_PORTRAIT_ROWS;
126
113
  const textRows = FRANKLIN_ART.length;
@@ -96,8 +96,28 @@ function migrateMcp(source) {
96
96
  // Claude Code format: { mcpServers: { name: { command, args, env } } }
97
97
  // Franklin format: { mcpServers: { name: { transport, command, args, label } } }
98
98
  const servers = {};
99
+ const skipped = [];
99
100
  if (raw.mcpServers) {
100
101
  for (const [name, config] of Object.entries(raw.mcpServers)) {
102
+ // Skip MCP servers that require external credentials (OAuth, API keys,
103
+ // tokens) — importing them causes noisy startup errors because the
104
+ // credentials aren't available in Franklin's context. Users can add
105
+ // these manually via ~/.blockrun/mcp.json if they set up the credentials.
106
+ const configStr = JSON.stringify(config).toLowerCase();
107
+ const needsCredentials = configStr.includes('oauth') ||
108
+ configStr.includes('credential') ||
109
+ configStr.includes('api_key') ||
110
+ configStr.includes('api-key') ||
111
+ configStr.includes('token') ||
112
+ name.includes('calendar') ||
113
+ name.includes('gmail') ||
114
+ name.includes('google') ||
115
+ name.includes('slack') ||
116
+ name.includes('notion');
117
+ if (needsCredentials) {
118
+ skipped.push(name);
119
+ continue;
120
+ }
101
121
  servers[name] = {
102
122
  transport: config.transport || 'stdio',
103
123
  command: config.command,
@@ -123,7 +143,11 @@ function migrateMcp(source) {
123
143
  };
124
144
  fs.mkdirSync(BLOCKRUN_DIR, { recursive: true });
125
145
  fs.writeFileSync(target, JSON.stringify(merged, null, 2));
126
- console.log(chalk.green(` ✓ ${Object.keys(servers).length} MCP server(s) imported`));
146
+ const importedCount = Object.keys(servers).length;
147
+ console.log(chalk.green(` ✓ ${importedCount} MCP server(s) imported`));
148
+ if (skipped.length > 0) {
149
+ console.log(chalk.dim(` · ${skipped.length} skipped (need credentials): ${skipped.join(', ')}`));
150
+ }
127
151
  }
128
152
  function migrateInstructions(source) {
129
153
  // Read CLAUDE.md and convert key preferences to learnings
@@ -86,6 +86,34 @@ export function loadMcpConfig(workDir) {
86
86
  catch {
87
87
  // Ignore corrupt project config
88
88
  }
89
+ // Filter out servers whose required credential files are missing.
90
+ // This prevents noisy startup errors from MCP servers that were imported
91
+ // (e.g. via `franklin migrate`) but don't have credentials configured yet.
92
+ // The server stays in the config file — it just gets auto-disabled until
93
+ // the user provides the credentials.
94
+ for (const [name, config] of Object.entries(servers)) {
95
+ if (config.disabled)
96
+ continue;
97
+ const env = (config.env || {});
98
+ const args = (config.args || []);
99
+ const configStr = JSON.stringify(config).toLowerCase();
100
+ // Check if any env var points to a file that doesn't exist
101
+ let missingFile = false;
102
+ for (const [, val] of Object.entries(env)) {
103
+ if (typeof val === 'string' && (val.endsWith('.json') || val.endsWith('.key') || val.endsWith('.pem'))) {
104
+ if (!fs.existsSync(val)) {
105
+ missingFile = true;
106
+ break;
107
+ }
108
+ }
109
+ }
110
+ // Check for common credential-dependent patterns in config
111
+ const needsAuth = missingFile ||
112
+ (configStr.includes('oauth') && !args.some(a => fs.existsSync(a)));
113
+ if (needsAuth) {
114
+ servers[name].disabled = true;
115
+ }
116
+ }
89
117
  return { mcpServers: servers };
90
118
  }
91
119
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blockrun/franklin",
3
- "version": "3.3.1",
3
+ "version": "3.3.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": {