a2acalling 0.6.73 → 0.6.75

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 (134) hide show
  1. package/.a2a-manifest.json +2 -2
  2. package/.c8rc.json +16 -0
  3. package/.node-version +1 -0
  4. package/.serena/project.yml +126 -0
  5. package/ARCHITECTURE.md +40 -16
  6. package/CONVENTIONS.md +39 -6
  7. package/biome.json +27 -0
  8. package/coverage/base.css +224 -0
  9. package/coverage/block-navigation.js +87 -0
  10. package/coverage/favicon.png +0 -0
  11. package/coverage/index.html +146 -0
  12. package/coverage/prettify.css +1 -0
  13. package/coverage/prettify.js +2 -0
  14. package/coverage/sort-arrow-sprite.png +0 -0
  15. package/coverage/sorter.js +210 -0
  16. package/coverage/src/index.html +131 -0
  17. package/coverage/src/index.js.html +313 -0
  18. package/coverage/src/lib/agent-card.js.html +418 -0
  19. package/coverage/src/lib/call-monitor.js.html +700 -0
  20. package/coverage/src/lib/callbook.js.html +1183 -0
  21. package/coverage/src/lib/claude-subagent.js.html +2173 -0
  22. package/coverage/src/lib/client.js.html +2134 -0
  23. package/coverage/src/lib/config.js.html +1525 -0
  24. package/coverage/src/lib/conversation-driver.js.html +1909 -0
  25. package/coverage/src/lib/conversations.js.html +2575 -0
  26. package/coverage/src/lib/crypto.js.html +424 -0
  27. package/coverage/src/lib/dashboard-events.js.html +724 -0
  28. package/coverage/src/lib/disclosure.js.html +2461 -0
  29. package/coverage/src/lib/external-ip.js.html +718 -0
  30. package/coverage/src/lib/index.html +506 -0
  31. package/coverage/src/lib/invite-host.js.html +754 -0
  32. package/coverage/src/lib/local-request.js.html +292 -0
  33. package/coverage/src/lib/logger.js.html +2116 -0
  34. package/coverage/src/lib/openclaw-integration.js.html +1102 -0
  35. package/coverage/src/lib/pid-file.js.html +394 -0
  36. package/coverage/src/lib/port-scanner.js.html +334 -0
  37. package/coverage/src/lib/prompt-template.js.html +1150 -0
  38. package/coverage/src/lib/runtime-adapter.js.html +2188 -0
  39. package/coverage/src/lib/summarizer.js.html +553 -0
  40. package/coverage/src/lib/summary-formatter.js.html +589 -0
  41. package/coverage/src/lib/summary-prompt.js.html +694 -0
  42. package/coverage/src/lib/tokens.js.html +2689 -0
  43. package/coverage/src/lib/turn-timeout.js.html +241 -0
  44. package/coverage/src/lib/update-checker.js.html +364 -0
  45. package/coverage/src/lib/update-manager.js.html +1024 -0
  46. package/coverage/src/routes/a2a.js.html +3724 -0
  47. package/coverage/src/routes/callbook.js.html +511 -0
  48. package/coverage/src/routes/dashboard.js.html +4819 -0
  49. package/coverage/src/routes/index.html +146 -0
  50. package/coverage/src/server.js.html +3622 -0
  51. package/coverage/tmp/coverage-1605378-1772576706365-0.json +1 -0
  52. package/coverage/tmp/coverage-1605384-1772576607459-0.json +1 -0
  53. package/coverage/tmp/coverage-1605410-1772576631155-0.json +1 -0
  54. package/coverage/tmp/coverage-1606942-1772576636869-0.json +1 -0
  55. package/coverage/tmp/coverage-1607004-1772576637454-0.json +1 -0
  56. package/coverage/tmp/coverage-1607044-1772576637876-0.json +1 -0
  57. package/coverage/tmp/coverage-1607096-1772576638356-0.json +1 -0
  58. package/coverage/tmp/coverage-1607145-1772576638777-0.json +1 -0
  59. package/coverage/tmp/coverage-1607201-1772576639277-0.json +1 -0
  60. package/coverage/tmp/coverage-1607247-1772576639755-0.json +1 -0
  61. package/coverage/tmp/coverage-1607317-1772576640083-0.json +1 -0
  62. package/coverage/tmp/coverage-1607381-1772576640465-0.json +1 -0
  63. package/coverage/tmp/coverage-1607446-1772576640868-0.json +1 -0
  64. package/coverage/tmp/coverage-1607501-1772576641662-0.json +1 -0
  65. package/coverage/tmp/coverage-1607534-1772576641565-0.json +1 -0
  66. package/coverage/tmp/coverage-1607627-1772576641871-0.json +1 -0
  67. package/coverage/tmp/coverage-1607665-1772576642172-0.json +1 -0
  68. package/coverage/tmp/coverage-1607714-1772576642577-0.json +1 -0
  69. package/coverage/tmp/coverage-1607788-1772576643466-0.json +1 -0
  70. package/coverage/tmp/coverage-1607924-1772576644678-0.json +1 -0
  71. package/coverage/tmp/coverage-1607978-1772576645154-0.json +1 -0
  72. package/coverage/tmp/coverage-1608035-1772576645564-0.json +1 -0
  73. package/coverage/tmp/coverage-1608106-1772576645967-0.json +1 -0
  74. package/coverage/tmp/coverage-1608179-1772576648656-0.json +1 -0
  75. package/coverage/tmp/coverage-1608196-1772576647367-0.json +1 -0
  76. package/coverage/tmp/coverage-1608217-1772576648557-0.json +1 -0
  77. package/coverage/tmp/coverage-1608256-1772576651378-0.json +1 -0
  78. package/coverage/tmp/coverage-1608265-1772576650058-0.json +1 -0
  79. package/coverage/tmp/coverage-1608289-1772576651358-0.json +1 -0
  80. package/coverage/tmp/coverage-1608591-1772576660465-0.json +1 -0
  81. package/coverage/tmp/coverage-1608648-1772576659272-0.json +1 -0
  82. package/coverage/tmp/coverage-1608665-1772576660374-0.json +1 -0
  83. package/coverage/tmp/coverage-1608677-1772576661268-0.json +1 -0
  84. package/coverage/tmp/coverage-1608684-1772576663968-0.json +1 -0
  85. package/coverage/tmp/coverage-1608692-1772576662575-0.json +1 -0
  86. package/coverage/tmp/coverage-1608701-1772576663873-0.json +1 -0
  87. package/coverage/tmp/coverage-1608718-1772576666674-0.json +1 -0
  88. package/coverage/tmp/coverage-1608725-1772576665463-0.json +1 -0
  89. package/coverage/tmp/coverage-1608738-1772576666577-0.json +1 -0
  90. package/coverage/tmp/coverage-1608753-1772576669664-0.json +1 -0
  91. package/coverage/tmp/coverage-1608763-1772576668275-0.json +1 -0
  92. package/coverage/tmp/coverage-1608771-1772576669563-0.json +1 -0
  93. package/coverage/tmp/coverage-1608828-1772576676574-0.json +1 -0
  94. package/coverage/tmp/coverage-1609244-1772576675272-0.json +1 -0
  95. package/coverage/tmp/coverage-1609342-1772576676478-0.json +1 -0
  96. package/coverage/tmp/coverage-1609450-1772576686954-0.json +1 -0
  97. package/coverage/tmp/coverage-1609841-1772576685466-0.json +1 -0
  98. package/coverage/tmp/coverage-1609925-1772576686855-0.json +1 -0
  99. package/coverage/tmp/coverage-1610399-1772576692469-0.json +1 -0
  100. package/coverage/tmp/coverage-1611283-1772576703062-0.json +1 -0
  101. package/coverage/tmp/coverage-1611294-1772576703755-0.json +1 -0
  102. package/docs/assessments/2026-02-27-google-a2a-protocol-assessment.md +292 -0
  103. package/docs/plans/2026-03-01-a2a-68-openclaw-integration-tests.md +676 -0
  104. package/docs/plans/2026-03-01-a2a-77-invoke-security-tests.md +661 -0
  105. package/docs/plans/2026-03-03-a2a-91-macos-packaging-plan.md +144 -0
  106. package/docs/signing-setup.md +49 -0
  107. package/eslint.config.js +16 -0
  108. package/knip.json +17 -0
  109. package/native/macos/certs/appldevcert.cer +0 -0
  110. package/native/macos/src-tauri/binaries/.gitkeep +0 -0
  111. package/native/macos/src-tauri/capabilities/default.json +11 -1
  112. package/native/macos/src-tauri/entitlements.plist +14 -0
  113. package/native/macos/src-tauri/src/discovery.rs +14 -3
  114. package/native/macos/src-tauri/src/health.rs +4 -0
  115. package/native/macos/src-tauri/src/lib.rs +52 -11
  116. package/native/macos/src-tauri/src/server.rs +262 -26
  117. package/native/macos/src-tauri/tauri.conf.json +13 -4
  118. package/package.json +16 -2
  119. package/pkg.config.json +14 -0
  120. package/scripts/build-standalone.sh +106 -0
  121. package/scripts/install-openclaw.js +3 -5
  122. package/scripts/smoke-test-standalone.sh +101 -0
  123. package/scripts/sync-version.sh +28 -0
  124. package/scripts/verify-app-bundle.sh +34 -0
  125. package/src/lib/agent-card.js +111 -0
  126. package/src/lib/client.js +290 -49
  127. package/src/lib/conversations.js +2 -0
  128. package/src/lib/local-request.js +69 -0
  129. package/src/lib/logger.js +2 -0
  130. package/src/lib/runtime-adapter.js +41 -1
  131. package/src/routes/a2a.js +393 -66
  132. package/src/routes/dashboard.js +1 -27
  133. package/src/server.js +19 -0
  134. package/.maestro/inbox/release-workflow-spam.md +0 -25
package/coverage/src/lib/invite-host.js.html ADDED
@@ -0,0 +1,754 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for src/lib/invite-host.js</title>
7
+ <meta charset="utf-8" />
8
+ <link rel="stylesheet" href="../../prettify.css" />
9
+ <link rel="stylesheet" href="../../base.css" />
10
+ <link rel="shortcut icon" type="image/x-icon" href="../../favicon.png" />
11
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
12
+ <style type='text/css'>
13
+ .coverage-summary .sorter {
14
+ background-image: url(../../sort-arrow-sprite.png);
15
+ }
16
+ </style>
17
+ </head>
18
+
19
+ <body>
20
+ <div class='wrapper'>
21
+ <div class='pad1'>
22
+ <h1><a href="../../index.html">All files</a> / <a href="index.html">src/lib</a> invite-host.js</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">78.92% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>176/223</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">63.63% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>49/77</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">75% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>6/8</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">78.92% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>176/223</span>
50
+ </div>
51
+
52
+
53
+ </div>
54
+ <p class="quiet">
55
+ Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
+ </p>
57
+ <template id="filterTemplate">
58
+ <div class="quiet">
59
+ Filter:
60
+ <input type="search" id="fileSearch">
61
+ </div>
62
+ </template>
63
+ </div>
64
+ <div class='status-line medium'></div>
65
+ <pre><table class="coverage">
66
+ <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
67
+ <a name='L2'></a><a href='#L2'>2</a>
68
+ <a name='L3'></a><a href='#L3'>3</a>
69
+ <a name='L4'></a><a href='#L4'>4</a>
70
+ <a name='L5'></a><a href='#L5'>5</a>
71
+ <a name='L6'></a><a href='#L6'>6</a>
72
+ <a name='L7'></a><a href='#L7'>7</a>
73
+ <a name='L8'></a><a href='#L8'>8</a>
74
+ <a name='L9'></a><a href='#L9'>9</a>
75
+ <a name='L10'></a><a href='#L10'>10</a>
76
+ <a name='L11'></a><a href='#L11'>11</a>
77
+ <a name='L12'></a><a href='#L12'>12</a>
78
+ <a name='L13'></a><a href='#L13'>13</a>
79
+ <a name='L14'></a><a href='#L14'>14</a>
80
+ <a name='L15'></a><a href='#L15'>15</a>
81
+ <a name='L16'></a><a href='#L16'>16</a>
82
+ <a name='L17'></a><a href='#L17'>17</a>
83
+ <a name='L18'></a><a href='#L18'>18</a>
84
+ <a name='L19'></a><a href='#L19'>19</a>
85
+ <a name='L20'></a><a href='#L20'>20</a>
86
+ <a name='L21'></a><a href='#L21'>21</a>
87
+ <a name='L22'></a><a href='#L22'>22</a>
88
+ <a name='L23'></a><a href='#L23'>23</a>
89
+ <a name='L24'></a><a href='#L24'>24</a>
90
+ <a name='L25'></a><a href='#L25'>25</a>
91
+ <a name='L26'></a><a href='#L26'>26</a>
92
+ <a name='L27'></a><a href='#L27'>27</a>
93
+ <a name='L28'></a><a href='#L28'>28</a>
94
+ <a name='L29'></a><a href='#L29'>29</a>
95
+ <a name='L30'></a><a href='#L30'>30</a>
96
+ <a name='L31'></a><a href='#L31'>31</a>
97
+ <a name='L32'></a><a href='#L32'>32</a>
98
+ <a name='L33'></a><a href='#L33'>33</a>
99
+ <a name='L34'></a><a href='#L34'>34</a>
100
+ <a name='L35'></a><a href='#L35'>35</a>
101
+ <a name='L36'></a><a href='#L36'>36</a>
102
+ <a name='L37'></a><a href='#L37'>37</a>
103
+ <a name='L38'></a><a href='#L38'>38</a>
104
+ <a name='L39'></a><a href='#L39'>39</a>
105
+ <a name='L40'></a><a href='#L40'>40</a>
106
+ <a name='L41'></a><a href='#L41'>41</a>
107
+ <a name='L42'></a><a href='#L42'>42</a>
108
+ <a name='L43'></a><a href='#L43'>43</a>
109
+ <a name='L44'></a><a href='#L44'>44</a>
110
+ <a name='L45'></a><a href='#L45'>45</a>
111
+ <a name='L46'></a><a href='#L46'>46</a>
112
+ <a name='L47'></a><a href='#L47'>47</a>
113
+ <a name='L48'></a><a href='#L48'>48</a>
114
+ <a name='L49'></a><a href='#L49'>49</a>
115
+ <a name='L50'></a><a href='#L50'>50</a>
116
+ <a name='L51'></a><a href='#L51'>51</a>
117
+ <a name='L52'></a><a href='#L52'>52</a>
118
+ <a name='L53'></a><a href='#L53'>53</a>
119
+ <a name='L54'></a><a href='#L54'>54</a>
120
+ <a name='L55'></a><a href='#L55'>55</a>
121
+ <a name='L56'></a><a href='#L56'>56</a>
122
+ <a name='L57'></a><a href='#L57'>57</a>
123
+ <a name='L58'></a><a href='#L58'>58</a>
124
+ <a name='L59'></a><a href='#L59'>59</a>
125
+ <a name='L60'></a><a href='#L60'>60</a>
126
+ <a name='L61'></a><a href='#L61'>61</a>
127
+ <a name='L62'></a><a href='#L62'>62</a>
128
+ <a name='L63'></a><a href='#L63'>63</a>
129
+ <a name='L64'></a><a href='#L64'>64</a>
130
+ <a name='L65'></a><a href='#L65'>65</a>
131
+ <a name='L66'></a><a href='#L66'>66</a>
132
+ <a name='L67'></a><a href='#L67'>67</a>
133
+ <a name='L68'></a><a href='#L68'>68</a>
134
+ <a name='L69'></a><a href='#L69'>69</a>
135
+ <a name='L70'></a><a href='#L70'>70</a>
136
+ <a name='L71'></a><a href='#L71'>71</a>
137
+ <a name='L72'></a><a href='#L72'>72</a>
138
+ <a name='L73'></a><a href='#L73'>73</a>
139
+ <a name='L74'></a><a href='#L74'>74</a>
140
+ <a name='L75'></a><a href='#L75'>75</a>
141
+ <a name='L76'></a><a href='#L76'>76</a>
142
+ <a name='L77'></a><a href='#L77'>77</a>
143
+ <a name='L78'></a><a href='#L78'>78</a>
144
+ <a name='L79'></a><a href='#L79'>79</a>
145
+ <a name='L80'></a><a href='#L80'>80</a>
146
+ <a name='L81'></a><a href='#L81'>81</a>
147
+ <a name='L82'></a><a href='#L82'>82</a>
148
+ <a name='L83'></a><a href='#L83'>83</a>
149
+ <a name='L84'></a><a href='#L84'>84</a>
150
+ <a name='L85'></a><a href='#L85'>85</a>
151
+ <a name='L86'></a><a href='#L86'>86</a>
152
+ <a name='L87'></a><a href='#L87'>87</a>
153
+ <a name='L88'></a><a href='#L88'>88</a>
154
+ <a name='L89'></a><a href='#L89'>89</a>
155
+ <a name='L90'></a><a href='#L90'>90</a>
156
+ <a name='L91'></a><a href='#L91'>91</a>
157
+ <a name='L92'></a><a href='#L92'>92</a>
158
+ <a name='L93'></a><a href='#L93'>93</a>
159
+ <a name='L94'></a><a href='#L94'>94</a>
160
+ <a name='L95'></a><a href='#L95'>95</a>
161
+ <a name='L96'></a><a href='#L96'>96</a>
162
+ <a name='L97'></a><a href='#L97'>97</a>
163
+ <a name='L98'></a><a href='#L98'>98</a>
164
+ <a name='L99'></a><a href='#L99'>99</a>
165
+ <a name='L100'></a><a href='#L100'>100</a>
166
+ <a name='L101'></a><a href='#L101'>101</a>
167
+ <a name='L102'></a><a href='#L102'>102</a>
168
+ <a name='L103'></a><a href='#L103'>103</a>
169
+ <a name='L104'></a><a href='#L104'>104</a>
170
+ <a name='L105'></a><a href='#L105'>105</a>
171
+ <a name='L106'></a><a href='#L106'>106</a>
172
+ <a name='L107'></a><a href='#L107'>107</a>
173
+ <a name='L108'></a><a href='#L108'>108</a>
174
+ <a name='L109'></a><a href='#L109'>109</a>
175
+ <a name='L110'></a><a href='#L110'>110</a>
176
+ <a name='L111'></a><a href='#L111'>111</a>
177
+ <a name='L112'></a><a href='#L112'>112</a>
178
+ <a name='L113'></a><a href='#L113'>113</a>
179
+ <a name='L114'></a><a href='#L114'>114</a>
180
+ <a name='L115'></a><a href='#L115'>115</a>
181
+ <a name='L116'></a><a href='#L116'>116</a>
182
+ <a name='L117'></a><a href='#L117'>117</a>
183
+ <a name='L118'></a><a href='#L118'>118</a>
184
+ <a name='L119'></a><a href='#L119'>119</a>
185
+ <a name='L120'></a><a href='#L120'>120</a>
186
+ <a name='L121'></a><a href='#L121'>121</a>
187
+ <a name='L122'></a><a href='#L122'>122</a>
188
+ <a name='L123'></a><a href='#L123'>123</a>
189
+ <a name='L124'></a><a href='#L124'>124</a>
190
+ <a name='L125'></a><a href='#L125'>125</a>
191
+ <a name='L126'></a><a href='#L126'>126</a>
192
+ <a name='L127'></a><a href='#L127'>127</a>
193
+ <a name='L128'></a><a href='#L128'>128</a>
194
+ <a name='L129'></a><a href='#L129'>129</a>
195
+ <a name='L130'></a><a href='#L130'>130</a>
196
+ <a name='L131'></a><a href='#L131'>131</a>
197
+ <a name='L132'></a><a href='#L132'>132</a>
198
+ <a name='L133'></a><a href='#L133'>133</a>
199
+ <a name='L134'></a><a href='#L134'>134</a>
200
+ <a name='L135'></a><a href='#L135'>135</a>
201
+ <a name='L136'></a><a href='#L136'>136</a>
202
+ <a name='L137'></a><a href='#L137'>137</a>
203
+ <a name='L138'></a><a href='#L138'>138</a>
204
+ <a name='L139'></a><a href='#L139'>139</a>
205
+ <a name='L140'></a><a href='#L140'>140</a>
206
+ <a name='L141'></a><a href='#L141'>141</a>
207
+ <a name='L142'></a><a href='#L142'>142</a>
208
+ <a name='L143'></a><a href='#L143'>143</a>
209
+ <a name='L144'></a><a href='#L144'>144</a>
210
+ <a name='L145'></a><a href='#L145'>145</a>
211
+ <a name='L146'></a><a href='#L146'>146</a>
212
+ <a name='L147'></a><a href='#L147'>147</a>
213
+ <a name='L148'></a><a href='#L148'>148</a>
214
+ <a name='L149'></a><a href='#L149'>149</a>
215
+ <a name='L150'></a><a href='#L150'>150</a>
216
+ <a name='L151'></a><a href='#L151'>151</a>
217
+ <a name='L152'></a><a href='#L152'>152</a>
218
+ <a name='L153'></a><a href='#L153'>153</a>
219
+ <a name='L154'></a><a href='#L154'>154</a>
220
+ <a name='L155'></a><a href='#L155'>155</a>
221
+ <a name='L156'></a><a href='#L156'>156</a>
222
+ <a name='L157'></a><a href='#L157'>157</a>
223
+ <a name='L158'></a><a href='#L158'>158</a>
224
+ <a name='L159'></a><a href='#L159'>159</a>
225
+ <a name='L160'></a><a href='#L160'>160</a>
226
+ <a name='L161'></a><a href='#L161'>161</a>
227
+ <a name='L162'></a><a href='#L162'>162</a>
228
+ <a name='L163'></a><a href='#L163'>163</a>
229
+ <a name='L164'></a><a href='#L164'>164</a>
230
+ <a name='L165'></a><a href='#L165'>165</a>
231
+ <a name='L166'></a><a href='#L166'>166</a>
232
+ <a name='L167'></a><a href='#L167'>167</a>
233
+ <a name='L168'></a><a href='#L168'>168</a>
234
+ <a name='L169'></a><a href='#L169'>169</a>
235
+ <a name='L170'></a><a href='#L170'>170</a>
236
+ <a name='L171'></a><a href='#L171'>171</a>
237
+ <a name='L172'></a><a href='#L172'>172</a>
238
+ <a name='L173'></a><a href='#L173'>173</a>
239
+ <a name='L174'></a><a href='#L174'>174</a>
240
+ <a name='L175'></a><a href='#L175'>175</a>
241
+ <a name='L176'></a><a href='#L176'>176</a>
242
+ <a name='L177'></a><a href='#L177'>177</a>
243
+ <a name='L178'></a><a href='#L178'>178</a>
244
+ <a name='L179'></a><a href='#L179'>179</a>
245
+ <a name='L180'></a><a href='#L180'>180</a>
246
+ <a name='L181'></a><a href='#L181'>181</a>
247
+ <a name='L182'></a><a href='#L182'>182</a>
248
+ <a name='L183'></a><a href='#L183'>183</a>
249
+ <a name='L184'></a><a href='#L184'>184</a>
250
+ <a name='L185'></a><a href='#L185'>185</a>
251
+ <a name='L186'></a><a href='#L186'>186</a>
252
+ <a name='L187'></a><a href='#L187'>187</a>
253
+ <a name='L188'></a><a href='#L188'>188</a>
254
+ <a name='L189'></a><a href='#L189'>189</a>
255
+ <a name='L190'></a><a href='#L190'>190</a>
256
+ <a name='L191'></a><a href='#L191'>191</a>
257
+ <a name='L192'></a><a href='#L192'>192</a>
258
+ <a name='L193'></a><a href='#L193'>193</a>
259
+ <a name='L194'></a><a href='#L194'>194</a>
260
+ <a name='L195'></a><a href='#L195'>195</a>
261
+ <a name='L196'></a><a href='#L196'>196</a>
262
+ <a name='L197'></a><a href='#L197'>197</a>
263
+ <a name='L198'></a><a href='#L198'>198</a>
264
+ <a name='L199'></a><a href='#L199'>199</a>
265
+ <a name='L200'></a><a href='#L200'>200</a>
266
+ <a name='L201'></a><a href='#L201'>201</a>
267
+ <a name='L202'></a><a href='#L202'>202</a>
268
+ <a name='L203'></a><a href='#L203'>203</a>
269
+ <a name='L204'></a><a href='#L204'>204</a>
270
+ <a name='L205'></a><a href='#L205'>205</a>
271
+ <a name='L206'></a><a href='#L206'>206</a>
272
+ <a name='L207'></a><a href='#L207'>207</a>
273
+ <a name='L208'></a><a href='#L208'>208</a>
274
+ <a name='L209'></a><a href='#L209'>209</a>
275
+ <a name='L210'></a><a href='#L210'>210</a>
276
+ <a name='L211'></a><a href='#L211'>211</a>
277
+ <a name='L212'></a><a href='#L212'>212</a>
278
+ <a name='L213'></a><a href='#L213'>213</a>
279
+ <a name='L214'></a><a href='#L214'>214</a>
280
+ <a name='L215'></a><a href='#L215'>215</a>
281
+ <a name='L216'></a><a href='#L216'>216</a>
282
+ <a name='L217'></a><a href='#L217'>217</a>
283
+ <a name='L218'></a><a href='#L218'>218</a>
284
+ <a name='L219'></a><a href='#L219'>219</a>
285
+ <a name='L220'></a><a href='#L220'>220</a>
286
+ <a name='L221'></a><a href='#L221'>221</a>
287
+ <a name='L222'></a><a href='#L222'>222</a>
288
+ <a name='L223'></a><a href='#L223'>223</a>
289
+ <a name='L224'></a><a href='#L224'>224</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">7x</span>
290
+ <span class="cline-any cline-yes">7x</span>
291
+ <span class="cline-any cline-yes">7x</span>
292
+ <span class="cline-any cline-yes">7x</span>
293
+ <span class="cline-any cline-yes">7x</span>
294
+ <span class="cline-any cline-yes">7x</span>
295
+ <span class="cline-any cline-yes">7x</span>
296
+ <span class="cline-any cline-yes">7x</span>
297
+ <span class="cline-any cline-yes">7x</span>
298
+ <span class="cline-any cline-yes">7x</span>
299
+ <span class="cline-any cline-yes">7x</span>
300
+ <span class="cline-any cline-yes">7x</span>
301
+ <span class="cline-any cline-yes">7x</span>
302
+ <span class="cline-any cline-yes">7x</span>
303
+ <span class="cline-any cline-yes">7x</span>
304
+ <span class="cline-any cline-yes">7x</span>
305
+ <span class="cline-any cline-yes">7x</span>
306
+ <span class="cline-any cline-yes">7x</span>
307
+ <span class="cline-any cline-no">&nbsp;</span>
308
+ <span class="cline-any cline-no">&nbsp;</span>
309
+ <span class="cline-any cline-no">&nbsp;</span>
310
+ <span class="cline-any cline-no">&nbsp;</span>
311
+ <span class="cline-any cline-no">&nbsp;</span>
312
+ <span class="cline-any cline-no">&nbsp;</span>
313
+ <span class="cline-any cline-yes">7x</span>
314
+ <span class="cline-any cline-yes">43x</span>
315
+ <span class="cline-any cline-yes">43x</span>
316
+ <span class="cline-any cline-yes">43x</span>
317
+ <span class="cline-any cline-yes">17x</span>
318
+ <span class="cline-any cline-yes">17x</span>
319
+ <span class="cline-any cline-yes">43x</span>
320
+ <span class="cline-any cline-no">&nbsp;</span>
321
+ <span class="cline-any cline-no">&nbsp;</span>
322
+ <span class="cline-any cline-no">&nbsp;</span>
323
+ <span class="cline-any cline-no">&nbsp;</span>
324
+ <span class="cline-any cline-no">&nbsp;</span>
325
+ <span class="cline-any cline-no">&nbsp;</span>
326
+ <span class="cline-any cline-no">&nbsp;</span>
327
+ <span class="cline-any cline-yes">17x</span>
328
+ <span class="cline-any cline-yes">17x</span>
329
+ <span class="cline-any cline-yes">43x</span>
330
+ <span class="cline-any cline-yes">7x</span>
331
+ <span class="cline-any cline-yes">8x</span>
332
+ <span class="cline-any cline-yes">8x</span>
333
+ <span class="cline-any cline-yes">8x</span>
334
+ <span class="cline-any cline-yes">8x</span>
335
+ <span class="cline-any cline-yes">8x</span>
336
+ <span class="cline-any cline-yes">8x</span>
337
+ <span class="cline-any cline-yes">8x</span>
338
+ <span class="cline-any cline-no">&nbsp;</span>
339
+ <span class="cline-any cline-no">&nbsp;</span>
340
+ <span class="cline-any cline-no">&nbsp;</span>
341
+ <span class="cline-any cline-no">&nbsp;</span>
342
+ <span class="cline-any cline-no">&nbsp;</span>
343
+ <span class="cline-any cline-yes">8x</span>
344
+ <span class="cline-any cline-yes">8x</span>
345
+ <span class="cline-any cline-yes">8x</span>
346
+ <span class="cline-any cline-yes">5x</span>
347
+ <span class="cline-any cline-yes">5x</span>
348
+ <span class="cline-any cline-yes">5x</span>
349
+ <span class="cline-any cline-yes">5x</span>
350
+ <span class="cline-any cline-yes">5x</span>
351
+ <span class="cline-any cline-yes">5x</span>
352
+ <span class="cline-any cline-yes">5x</span>
353
+ <span class="cline-any cline-yes">5x</span>
354
+ <span class="cline-any cline-yes">3x</span>
355
+ <span class="cline-any cline-yes">3x</span>
356
+ <span class="cline-any cline-yes">8x</span>
357
+ <span class="cline-any cline-yes">7x</span>
358
+ <span class="cline-any cline-yes">10x</span>
359
+ <span class="cline-any cline-yes">10x</span>
360
+ <span class="cline-any cline-yes">10x</span>
361
+ <span class="cline-any cline-yes">10x</span>
362
+ <span class="cline-any cline-yes">10x</span>
363
+ <span class="cline-any cline-yes">10x</span>
364
+ <span class="cline-any cline-yes">10x</span>
365
+ <span class="cline-any cline-yes">10x</span>
366
+ <span class="cline-any cline-yes">10x</span>
367
+ <span class="cline-any cline-yes">10x</span>
368
+ <span class="cline-any cline-yes">7x</span>
369
+ <span class="cline-any cline-no">&nbsp;</span>
370
+ <span class="cline-any cline-no">&nbsp;</span>
371
+ <span class="cline-any cline-no">&nbsp;</span>
372
+ <span class="cline-any cline-no">&nbsp;</span>
373
+ <span class="cline-any cline-no">&nbsp;</span>
374
+ <span class="cline-any cline-no">&nbsp;</span>
375
+ <span class="cline-any cline-no">&nbsp;</span>
376
+ <span class="cline-any cline-no">&nbsp;</span>
377
+ <span class="cline-any cline-no">&nbsp;</span>
378
+ <span class="cline-any cline-no">&nbsp;</span>
379
+ <span class="cline-any cline-no">&nbsp;</span>
380
+ <span class="cline-any cline-no">&nbsp;</span>
381
+ <span class="cline-any cline-no">&nbsp;</span>
382
+ <span class="cline-any cline-no">&nbsp;</span>
383
+ <span class="cline-any cline-yes">7x</span>
384
+ <span class="cline-any cline-yes">8x</span>
385
+ <span class="cline-any cline-yes">8x</span>
386
+ <span class="cline-any cline-yes">8x</span>
387
+ <span class="cline-any cline-yes">8x</span>
388
+ <span class="cline-any cline-yes">8x</span>
389
+ <span class="cline-any cline-yes">8x</span>
390
+ <span class="cline-any cline-yes">4x</span>
391
+ <span class="cline-any cline-yes">4x</span>
392
+ <span class="cline-any cline-yes">7x</span>
393
+ <span class="cline-any cline-yes">7x</span>
394
+ <span class="cline-any cline-no">&nbsp;</span>
395
+ <span class="cline-any cline-no">&nbsp;</span>
396
+ <span class="cline-any cline-no">&nbsp;</span>
397
+ <span class="cline-any cline-no">&nbsp;</span>
398
+ <span class="cline-any cline-no">&nbsp;</span>
399
+ <span class="cline-any cline-no">&nbsp;</span>
400
+ <span class="cline-any cline-yes">4x</span>
401
+ <span class="cline-any cline-yes">4x</span>
402
+ <span class="cline-any cline-yes">7x</span>
403
+ <span class="cline-any cline-yes">4x</span>
404
+ <span class="cline-any cline-yes">4x</span>
405
+ <span class="cline-any cline-yes">8x</span>
406
+ <span class="cline-any cline-yes">7x</span>
407
+ <span class="cline-any cline-yes">1x</span>
408
+ <span class="cline-any cline-yes">1x</span>
409
+ <span class="cline-any cline-yes">1x</span>
410
+ <span class="cline-any cline-yes">1x</span>
411
+ <span class="cline-any cline-yes">1x</span>
412
+ <span class="cline-any cline-yes">1x</span>
413
+ <span class="cline-any cline-yes">1x</span>
414
+ <span class="cline-any cline-yes">1x</span>
415
+ <span class="cline-any cline-yes">7x</span>
416
+ <span class="cline-any cline-yes">7x</span>
417
+ <span class="cline-any cline-yes">7x</span>
418
+ <span class="cline-any cline-yes">7x</span>
419
+ <span class="cline-any cline-yes">7x</span>
420
+ <span class="cline-any cline-yes">7x</span>
421
+ <span class="cline-any cline-yes">7x</span>
422
+ <span class="cline-any cline-yes">7x</span>
423
+ <span class="cline-any cline-yes">7x</span>
424
+ <span class="cline-any cline-yes">7x</span>
425
+ <span class="cline-any cline-yes">7x</span>
426
+ <span class="cline-any cline-yes">7x</span>
427
+ <span class="cline-any cline-yes">7x</span>
428
+ <span class="cline-any cline-yes">7x</span>
429
+ <span class="cline-any cline-yes">3x</span>
430
+ <span class="cline-any cline-yes">3x</span>
431
+ <span class="cline-any cline-no">&nbsp;</span>
432
+ <span class="cline-any cline-no">&nbsp;</span>
433
+ <span class="cline-any cline-no">&nbsp;</span>
434
+ <span class="cline-any cline-no">&nbsp;</span>
435
+ <span class="cline-any cline-no">&nbsp;</span>
436
+ <span class="cline-any cline-yes">7x</span>
437
+ <span class="cline-any cline-yes">7x</span>
438
+ <span class="cline-any cline-yes">7x</span>
439
+ <span class="cline-any cline-yes">7x</span>
440
+ <span class="cline-any cline-yes">7x</span>
441
+ <span class="cline-any cline-yes">7x</span>
442
+ <span class="cline-any cline-yes">7x</span>
443
+ <span class="cline-any cline-yes">7x</span>
444
+ <span class="cline-any cline-yes">7x</span>
445
+ <span class="cline-any cline-yes">7x</span>
446
+ <span class="cline-any cline-yes">7x</span>
447
+ <span class="cline-any cline-yes">7x</span>
448
+ <span class="cline-any cline-yes">7x</span>
449
+ <span class="cline-any cline-yes">7x</span>
450
+ <span class="cline-any cline-yes">7x</span>
451
+ <span class="cline-any cline-yes">7x</span>
452
+ <span class="cline-any cline-yes">7x</span>
453
+ <span class="cline-any cline-yes">7x</span>
454
+ <span class="cline-any cline-yes">4x</span>
455
+ <span class="cline-any cline-yes">4x</span>
456
+ <span class="cline-any cline-yes">7x</span>
457
+ <span class="cline-any cline-yes">7x</span>
458
+ <span class="cline-any cline-yes">7x</span>
459
+ <span class="cline-any cline-yes">7x</span>
460
+ <span class="cline-any cline-yes">7x</span>
461
+ <span class="cline-any cline-yes">7x</span>
462
+ <span class="cline-any cline-yes">7x</span>
463
+ <span class="cline-any cline-yes">7x</span>
464
+ <span class="cline-any cline-yes">7x</span>
465
+ <span class="cline-any cline-yes">7x</span>
466
+ <span class="cline-any cline-yes">4x</span>
467
+ <span class="cline-any cline-yes">4x</span>
468
+ <span class="cline-any cline-yes">4x</span>
469
+ <span class="cline-any cline-yes">4x</span>
470
+ <span class="cline-any cline-yes">4x</span>
471
+ <span class="cline-any cline-yes">4x</span>
472
+ <span class="cline-any cline-yes">7x</span>
473
+ <span class="cline-any cline-yes">7x</span>
474
+ <span class="cline-any cline-yes">7x</span>
475
+ <span class="cline-any cline-yes">3x</span>
476
+ <span class="cline-any cline-yes">3x</span>
477
+ <span class="cline-any cline-yes">3x</span>
478
+ <span class="cline-any cline-yes">3x</span>
479
+ <span class="cline-any cline-yes">3x</span>
480
+ <span class="cline-any cline-yes">3x</span>
481
+ <span class="cline-any cline-yes">3x</span>
482
+ <span class="cline-any cline-yes">3x</span>
483
+ <span class="cline-any cline-yes">3x</span>
484
+ <span class="cline-any cline-yes">3x</span>
485
+ <span class="cline-any cline-yes">3x</span>
486
+ <span class="cline-any cline-yes">3x</span>
487
+ <span class="cline-any cline-yes">3x</span>
488
+ <span class="cline-any cline-yes">3x</span>
489
+ <span class="cline-any cline-yes">3x</span>
490
+ <span class="cline-any cline-yes">4x</span>
491
+ <span class="cline-any cline-yes">7x</span>
492
+ <span class="cline-any cline-no">&nbsp;</span>
493
+ <span class="cline-any cline-no">&nbsp;</span>
494
+ <span class="cline-any cline-no">&nbsp;</span>
495
+ <span class="cline-any cline-no">&nbsp;</span>
496
+ <span class="cline-any cline-yes">4x</span>
497
+ <span class="cline-any cline-yes">4x</span>
498
+ <span class="cline-any cline-yes">4x</span>
499
+ <span class="cline-any cline-yes">4x</span>
500
+ <span class="cline-any cline-yes">4x</span>
501
+ <span class="cline-any cline-yes">4x</span>
502
+ <span class="cline-any cline-yes">4x</span>
503
+ <span class="cline-any cline-yes">7x</span>
504
+ <span class="cline-any cline-yes">7x</span>
505
+ <span class="cline-any cline-yes">7x</span>
506
+ <span class="cline-any cline-yes">7x</span>
507
+ <span class="cline-any cline-yes">7x</span>
508
+ <span class="cline-any cline-yes">7x</span>
509
+ <span class="cline-any cline-yes">7x</span>
510
+ <span class="cline-any cline-yes">7x</span>
511
+ <span class="cline-any cline-yes">7x</span>
512
+ <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">/**
513
+ * Invite Host Resolution
514
+ *
515
+ * Goal: produce a host:port that other agents can reach, even when the
516
+ * local machine's hostname is not publicly resolvable.
517
+ *
518
+ * Strategy:
519
+ * - Prefer explicit env `A2A_HOSTNAME`
520
+ * - Else use config agent.hostname if present
521
+ * - Else fall back to OS/env hostname
522
+ *
523
+ * If the selected hostname is clearly local/private/unroutable, replace
524
+ * it with the machine's external IP (cached with TTL).
525
+ */
526
+ &nbsp;
527
+ const net = require('net');
528
+ const { getExternalIp } = require('./external-ip');
529
+ &nbsp;
530
+ <span class="cstat-no" title="statement not covered" ><span class="fstat-no" title="function not covered" >function readIntEnv(name) {</span></span>
531
+ <span class="cstat-no" title="statement not covered" > const raw = process.env[name];</span>
532
+ <span class="cstat-no" title="statement not covered" > if (!raw) return null;</span>
533
+ <span class="cstat-no" title="statement not covered" > const parsed = Number.parseInt(String(raw), 10);</span>
534
+ <span class="cstat-no" title="statement not covered" > return Number.isFinite(parsed) ? parsed : null;</span>
535
+ <span class="cstat-no" title="statement not covered" >}</span>
536
+ &nbsp;
537
+ function normalizeHostInput(value) {
538
+ const raw = String(value || '').trim();
539
+ if (!raw) return '';
540
+ &nbsp;
541
+ // Accept accidental `http(s)://host:port` input.
542
+ if (raw.includes('://')) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
543
+ <span class="cstat-no" title="statement not covered" > try {</span>
544
+ <span class="cstat-no" title="statement not covered" > const parsed = new URL(raw);</span>
545
+ <span class="cstat-no" title="statement not covered" > return parsed.host;</span>
546
+ <span class="cstat-no" title="statement not covered" > } catch (err) {</span>
547
+ <span class="cstat-no" title="statement not covered" > // fall through</span>
548
+ <span class="cstat-no" title="statement not covered" > }</span>
549
+ <span class="cstat-no" title="statement not covered" > }</span>
550
+ &nbsp;
551
+ return raw.replace(/\/+$/, '');
552
+ }
553
+ &nbsp;
554
+ function splitHostPort(rawHost) {
555
+ const host = normalizeHostInput(rawHost);
556
+ if (!host) <span class="branch-0 cbranch-no" title="branch not covered" >return { hostname: '', port: null };</span>
557
+ &nbsp;
558
+ // IPv6 in brackets: [::1]:3001
559
+ const bracketed = host.match(/^\[([^\]]+)\](?::(\d+))?$/);
560
+ if (bracketed) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
561
+ <span class="cstat-no" title="statement not covered" > return {</span>
562
+ <span class="cstat-no" title="statement not covered" > hostname: bracketed[1],</span>
563
+ <span class="cstat-no" title="statement not covered" > port: bracketed[2] ? Number.parseInt(bracketed[2], 10) : null</span>
564
+ <span class="cstat-no" title="statement not covered" > };</span>
565
+ <span class="cstat-no" title="statement not covered" > }</span>
566
+ &nbsp;
567
+ const lastColon = host.lastIndexOf(':');
568
+ if (lastColon !== -1 &amp;&amp; host.indexOf(':') === lastColon) {
569
+ const maybePort = host.slice(lastColon + 1);
570
+ if (/^\d+$/.test(maybePort)) {
571
+ return {
572
+ hostname: host.slice(0, lastColon),
573
+ port: Number.parseInt(maybePort, 10)
574
+ };
575
+ }
576
+ }
577
+ &nbsp;
578
+ return { hostname: host, port: null };
579
+ }
580
+ &nbsp;
581
+ function formatHostPort(hostname, port) {
582
+ const host = String(hostname <span class="branch-0 cbranch-no" title="branch not covered" >|| '')</span>.trim();
583
+ const p = Number.isFinite(port) ? port <span class="branch-0 cbranch-no" title="branch not covered" >: null;</span>
584
+ &nbsp;
585
+ if (!host) <span class="branch-0 cbranch-no" title="branch not covered" >return '';</span>
586
+ const needsBrackets = net.isIP(host) === 6;
587
+ const hostPart = needsBrackets <span class="branch-0 cbranch-no" title="branch not covered" >? `[${host}]` </span>: host;
588
+ // Don't append port 80 (it's the default HTTP port)
589
+ return (p &amp;&amp; p !== 80) ? `${hostPart}:${p}` <span class="branch-0 cbranch-no" title="branch not covered" >: hostPart;</span>
590
+ }
591
+ &nbsp;
592
+ <span class="cstat-no" title="statement not covered" ><span class="fstat-no" title="function not covered" >function isPrivateIpv4(ip) {</span></span>
593
+ <span class="cstat-no" title="statement not covered" > const parts = ip.split('.').map(n =&gt; Number.parseInt(n, 10));</span>
594
+ <span class="cstat-no" title="statement not covered" > if (parts.length !== 4 || parts.some(n =&gt; !Number.isFinite(n) || n &lt; 0 || n &gt; 255)) return false;</span>
595
+ <span class="cstat-no" title="statement not covered" > const [a, b] = parts;</span>
596
+ <span class="cstat-no" title="statement not covered" > if (a === 10) return true;</span>
597
+ <span class="cstat-no" title="statement not covered" > if (a === 127) return true; // loopback</span>
598
+ <span class="cstat-no" title="statement not covered" > if (a === 0) return true; // "this" network</span>
599
+ <span class="cstat-no" title="statement not covered" > if (a === 169 &amp;&amp; b === 254) return true; // link-local</span>
600
+ <span class="cstat-no" title="statement not covered" > if (a === 192 &amp;&amp; b === 168) return true;</span>
601
+ <span class="cstat-no" title="statement not covered" > if (a === 172 &amp;&amp; b &gt;= 16 &amp;&amp; b &lt;= 31) return true;</span>
602
+ <span class="cstat-no" title="statement not covered" > // CGNAT 100.64.0.0/10</span>
603
+ <span class="cstat-no" title="statement not covered" > if (a === 100 &amp;&amp; b &gt;= 64 &amp;&amp; b &lt;= 127) return true;</span>
604
+ <span class="cstat-no" title="statement not covered" > return false;</span>
605
+ <span class="cstat-no" title="statement not covered" >}</span>
606
+ &nbsp;
607
+ function isLocalOrUnroutableHost(hostname) {
608
+ const host = String(hostname <span class="branch-0 cbranch-no" title="branch not covered" >|| '')</span>.trim().toLowerCase();
609
+ if (!host) <span class="branch-0 cbranch-no" title="branch not covered" >return true;</span>
610
+ if (host === 'localhost' || host === '0.0.0.0') return true;
611
+ if (host === '::' || host === '::1') <span class="branch-0 cbranch-no" title="branch not covered" >return true;</span>
612
+ if (host.endsWith('.local') || host.endsWith('.lan')) return true;
613
+ &nbsp;
614
+ const ipType = net.isIP(host);
615
+ if (ipType === 4) <span class="branch-0 cbranch-no" title="branch not covered" >return isPrivateIpv4(host);</span>
616
+ if (ipType === 6) <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
617
+ <span class="cstat-no" title="statement not covered" > // Unique local (fc00::/7), link-local (fe80::/10), loopback.</span>
618
+ <span class="cstat-no" title="statement not covered" > if (host === '::1') return true;</span>
619
+ <span class="cstat-no" title="statement not covered" > if (host.startsWith('fc') || host.startsWith('fd')) return true;</span>
620
+ <span class="cstat-no" title="statement not covered" > if (host.startsWith('fe80:')) return true;</span>
621
+ <span class="cstat-no" title="statement not covered" > return false;</span>
622
+ <span class="cstat-no" title="statement not covered" > }</span>
623
+ &nbsp;
624
+ // Heuristic: bare hostnames without a dot are commonly local-only.
625
+ if (!host.includes('.')) <span class="branch-0 cbranch-no" title="branch not covered" >return true;</span>
626
+ &nbsp;
627
+ return false;
628
+ }
629
+ &nbsp;
630
+ function isPublicIpHostname(hostname) {
631
+ const host = String(hostname <span class="branch-0 cbranch-no" title="branch not covered" >|| '')</span>.trim();
632
+ const type = net.isIP(host);
633
+ if (type === 4) <span class="branch-0 cbranch-no" title="branch not covered" >return !isPrivateIpv4(host);</span>
634
+ // For IPv6: if it's a real v6 and not local per heuristic, treat as public.
635
+ if (type === 6) <span class="branch-0 cbranch-no" title="branch not covered" >return !isLocalOrUnroutableHost(host);</span>
636
+ return false;
637
+ }
638
+ &nbsp;
639
+ async function resolveInviteHost(options = {}) {
640
+ const config = options.config || null;
641
+ &nbsp;
642
+ const envHost = normalizeHostInput(process.env.A2A_HOSTNAME);
643
+ const cfgHost = normalizeHostInput(config &amp;&amp; config.getAgent ? (config.getAgent().hostname || '') : '');
644
+ const fallbackHost = normalizeHostInput(options.fallbackHost);
645
+ const openclawHost = normalizeHostInput(process.env.OPENCLAW_HOSTNAME);
646
+ const osHost = normalizeHostInput(process.env.HOSTNAME);
647
+ &nbsp;
648
+ const candidate = envHost || cfgHost <span class="branch-0 cbranch-no" title="branch not covered" >|| openclawHost <span class="branch-0 cbranch-no" title="branch not covered" ></span>|| fallbackHost <span class="branch-0 cbranch-no" title="branch not covered" ></span>|| osHost <span class="branch-0 cbranch-no" title="branch not covered" ></span>|| 'localhost';</span>
649
+ const candidateSource = envHost
650
+ ? 'env'
651
+ : cfgHost
652
+ ? 'config'
653
+ <span class="branch-0 cbranch-no" title="branch not covered" > : openclawHost</span>
654
+ <span class="cstat-no" title="statement not covered" > ? 'openclaw_env'</span>
655
+ <span class="cstat-no" title="statement not covered" > : fallbackHost</span>
656
+ <span class="cstat-no" title="statement not covered" > ? 'fallback'</span>
657
+ <span class="cstat-no" title="statement not covered" > : osHost</span>
658
+ <span class="cstat-no" title="statement not covered" > ? 'os'</span>
659
+ : 'default';
660
+ &nbsp;
661
+ const parsed = splitHostPort(candidate);
662
+ const desiredPort = parsed.port ||
663
+ Number.parseInt(String(options.defaultPort <span class="branch-0 cbranch-no" title="branch not covered" >|| '')</span>, 10) <span class="branch-0 cbranch-no" title="branch not covered" >||</span>
664
+ readIntEnv('PORT') <span class="branch-0 cbranch-no" title="branch not covered" >||</span>
665
+ readIntEnv('A2A_PORT') <span class="branch-0 cbranch-no" title="branch not covered" >||</span>
666
+ 3001;
667
+ &nbsp;
668
+ const candidateHostWithPort = formatHostPort(parsed.hostname, desiredPort);
669
+ &nbsp;
670
+ const warnings = [];
671
+ &nbsp;
672
+ const ttlMs = Number.isFinite(options.externalIpTtlMs)
673
+ ? options.externalIpTtlMs
674
+ : undefined;
675
+ &nbsp;
676
+ const shouldReplaceWithExternalIp = isLocalOrUnroutableHost(parsed.hostname) ||
677
+ (
678
+ options.refreshExternalIp &amp;&amp; isPublicIpHostname(parsed.hostname)
679
+ );
680
+ &nbsp;
681
+ const alwaysLookupExternalIp = Boolean(options.alwaysLookupExternalIp);
682
+ const wantsExternalIp = shouldReplaceWithExternalIp || alwaysLookupExternalIp;
683
+ const warnOnExternalIpFailure = options.warnOnExternalIpFailure !== undefined
684
+ ? Boolean(options.warnOnExternalIpFailure)
685
+ : shouldReplaceWithExternalIp;
686
+ &nbsp;
687
+ const external = wantsExternalIp
688
+ ? await getExternalIp({
689
+ ttlMs,
690
+ timeoutMs: options.externalIpTimeoutMs,
691
+ services: options.externalIpServices,
692
+ cacheFile: options.externalIpCacheFile,
693
+ forceRefresh: Boolean(options.forceRefreshExternalIp)
694
+ })
695
+ : null;
696
+ &nbsp;
697
+ if (shouldReplaceWithExternalIp &amp;&amp; external &amp;&amp; external.ip) {
698
+ const finalHost = formatHostPort(external.ip, desiredPort);
699
+ if (finalHost !== candidateHostWithPort) {
700
+ warnings.push(
701
+ `Invite host "${candidateHostWithPort}" looks local/unroutable. Using external IP "${finalHost}" instead.`
702
+ );
703
+ }
704
+ return {
705
+ host: finalHost,
706
+ source: 'external_ip',
707
+ originalHost: candidateHostWithPort,
708
+ externalIp: external.ip,
709
+ externalIpInfo: external,
710
+ warnings
711
+ };
712
+ }
713
+ &nbsp;
714
+ if (wantsExternalIp &amp;&amp; (!external || !external.ip) <span class="branch-0 cbranch-no" title="branch not covered" >&amp;&amp; warnOnExternalIpFailure)</span> <span class="branch-0 cbranch-no" title="branch not covered" >{</span>
715
+ <span class="cstat-no" title="statement not covered" > warnings.push(</span>
716
+ <span class="cstat-no" title="statement not covered" > `Invite host "${candidateHostWithPort}" may not be reachable from other machines, and external IP lookup failed. Set A2A_HOSTNAME="your-public-host:port".`</span>
717
+ <span class="cstat-no" title="statement not covered" > );</span>
718
+ <span class="cstat-no" title="statement not covered" > }</span>
719
+ return {
720
+ host: candidateHostWithPort,
721
+ source: candidateSource,
722
+ originalHost: candidateHostWithPort,
723
+ externalIpInfo: external,
724
+ warnings
725
+ };
726
+ }
727
+ &nbsp;
728
+ module.exports = {
729
+ normalizeHostInput,
730
+ splitHostPort,
731
+ formatHostPort,
732
+ isLocalOrUnroutableHost,
733
+ resolveInviteHost
734
+ };
735
+ &nbsp;</pre></td></tr></table></pre>
736
+
737
+ <div class='push'></div><!-- for sticky footer -->
738
+ </div><!-- /wrapper -->
739
+ <div class='footer quiet pad2 space-top1 center small'>
740
+ Code coverage generated by
741
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
742
+ at 2026-03-03T22:25:10.857Z
743
+ </div>
744
+ <script src="../../prettify.js"></script>
745
+ <script>
746
+ window.onload = function () {
747
+ prettyPrint();
748
+ };
749
+ </script>
750
+ <script src="../../sorter.js"></script>
751
+ <script src="../../block-navigation.js"></script>
752
+ </body>
753
+ </html>
754
+