slashvibe-mcp 0.3.21 → 0.3.23

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 (235) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +280 -47
  3. package/auto-update.js +10 -15
  4. package/config.js +36 -31
  5. package/crypto.js +1 -6
  6. package/debug.js +12 -0
  7. package/discord.js +19 -19
  8. package/eslint.config.js +54 -0
  9. package/index.js +217 -207
  10. package/intelligence/index.js +2 -9
  11. package/intelligence/infer.js +10 -16
  12. package/intelligence/patterns.js +23 -18
  13. package/intelligence/proactive.js +16 -15
  14. package/intelligence/serendipity.js +57 -20
  15. package/memory.js +13 -8
  16. package/migrate-v2.js +72 -0
  17. package/notification-emitter.js +2 -2
  18. package/notify.js +39 -14
  19. package/package.json +28 -29
  20. package/post-install.js +141 -0
  21. package/presence.js +2 -2
  22. package/prompts.js +5 -9
  23. package/protocol/index.js +123 -87
  24. package/protocol/telegram-commands.js +36 -37
  25. package/store/api.js +358 -529
  26. package/store/local.js +9 -10
  27. package/store/profiles.js +48 -192
  28. package/store/reservations.js +2 -9
  29. package/store/skills.js +69 -71
  30. package/store/sqlite.js +355 -0
  31. package/test-skills-bootstrap.js +20 -0
  32. package/test-v2-integration.js +385 -0
  33. package/tools/_actions.js +48 -387
  34. package/tools/_connection-queue.js +45 -56
  35. package/tools/_discovery-enhanced.js +52 -57
  36. package/tools/_discovery.js +87 -185
  37. package/tools/{l2-status.js → _experimental/l2-status.js} +68 -70
  38. package/tools/{shipback.js → _experimental/shipback.js} +4 -3
  39. package/tools/_proactive-discovery.js +60 -73
  40. package/tools/_shared/index.js +41 -64
  41. package/tools/admin-inbox.js +10 -15
  42. package/tools/agents.js +1 -1
  43. package/tools/artifact-create.js +13 -23
  44. package/tools/artifact-view.js +4 -4
  45. package/tools/{_deprecated/back.js → back.js} +1 -1
  46. package/tools/bye.js +3 -5
  47. package/tools/consent.js +2 -2
  48. package/tools/context.js +9 -10
  49. package/tools/crossword.js +3 -2
  50. package/tools/discover.js +94 -356
  51. package/tools/dm.js +27 -86
  52. package/tools/doctor.js +12 -41
  53. package/tools/drawing.js +34 -20
  54. package/tools/echo.js +11 -11
  55. package/tools/feed.js +30 -58
  56. package/tools/follow.js +64 -187
  57. package/tools/{_deprecated/forget.js → forget.js} +4 -7
  58. package/tools/game.js +144 -48
  59. package/tools/handoff.js +6 -8
  60. package/tools/help.js +3 -3
  61. package/tools/idea.js +15 -27
  62. package/tools/inbox.js +121 -293
  63. package/tools/init.js +54 -151
  64. package/tools/invite.js +8 -21
  65. package/tools/migrate.js +27 -24
  66. package/tools/multiplayer-game.js +50 -40
  67. package/tools/{_deprecated/mute.js → mute.js} +4 -3
  68. package/tools/notifications.js +58 -48
  69. package/tools/observe.js +12 -15
  70. package/tools/onboarding.js +8 -11
  71. package/tools/open.js +13 -144
  72. package/tools/party-game.js +23 -12
  73. package/tools/patterns.js +2 -1
  74. package/tools/ping.js +5 -7
  75. package/tools/react.js +28 -30
  76. package/tools/{_deprecated/recall.js → recall.js} +5 -10
  77. package/tools/release.js +4 -2
  78. package/tools/{_deprecated/remember.js → remember.js} +4 -6
  79. package/tools/report.js +2 -2
  80. package/tools/request.js +6 -26
  81. package/tools/reserve.js +1 -1
  82. package/tools/session-fork.js +97 -0
  83. package/tools/session-save.js +109 -0
  84. package/tools/settings.js +30 -99
  85. package/tools/ship.js +74 -56
  86. package/tools/{_deprecated/skills-exchange.js → skills-exchange.js} +38 -39
  87. package/tools/social-inbox.js +22 -28
  88. package/tools/social-post.js +24 -27
  89. package/tools/solo-game.js +54 -46
  90. package/tools/start.js +14 -148
  91. package/tools/status.js +21 -68
  92. package/tools/submit.js +4 -2
  93. package/tools/suggest-tags.js +36 -33
  94. package/tools/summarize.js +19 -16
  95. package/tools/tag-suggestions.js +72 -73
  96. package/tools/test.js +1 -1
  97. package/tools/{_deprecated/tictactoe.js → tictactoe.js} +26 -26
  98. package/tools/token.js +4 -4
  99. package/tools/update.js +1 -2
  100. package/tools/watch.js +132 -112
  101. package/tools/who.js +20 -40
  102. package/tools/{_deprecated/wordassociation.js → wordassociation.js} +23 -20
  103. package/tools/workshop-buddy.js +52 -53
  104. package/tools/x-mentions.js +0 -1
  105. package/tools/x-reply.js +0 -1
  106. package/twitter.js +14 -20
  107. package/version.json +8 -10
  108. package/webhook-runner.js +132 -0
  109. package/auth-store.js +0 -148
  110. package/bridges/bridge-monitor.js +0 -388
  111. package/bridges/discord-bot.js +0 -431
  112. package/bridges/farcaster.js +0 -299
  113. package/bridges/telegram.js +0 -261
  114. package/bridges/webhook-health.js +0 -420
  115. package/bridges/webhook-server.js +0 -437
  116. package/bridges/whatsapp.js +0 -441
  117. package/bridges/x-webhook.js +0 -423
  118. package/games/arcade.js +0 -406
  119. package/games/chess.js +0 -451
  120. package/games/colorguess.js +0 -343
  121. package/games/crossword-words.js +0 -171
  122. package/games/crossword.js +0 -461
  123. package/games/drawing.js +0 -347
  124. package/games/gameroulette.js +0 -300
  125. package/games/gamerouter.js +0 -336
  126. package/games/gamestatus.js +0 -337
  127. package/games/guessnumber.js +0 -209
  128. package/games/hangman.js +0 -279
  129. package/games/memory.js +0 -338
  130. package/games/multiplayer-tictactoe.js +0 -389
  131. package/games/pixelart.js +0 -399
  132. package/games/quickduel.js +0 -354
  133. package/games/riddle.js +0 -371
  134. package/games/rockpaperscissors.js +0 -291
  135. package/games/snake.js +0 -406
  136. package/games/storybuilder.js +0 -343
  137. package/games/tictactoe.js +0 -345
  138. package/games/twentyquestions.js +0 -286
  139. package/games/twotruths.js +0 -207
  140. package/games/werewolf.js +0 -508
  141. package/games/wordassociation.js +0 -247
  142. package/games/wordchain.js +0 -135
  143. package/intelligence/interests.js +0 -369
  144. package/setup.js +0 -480
  145. package/smart-inbox.js +0 -276
  146. package/tools/_deprecated/auto-suggest-connections.js +0 -304
  147. package/tools/_deprecated/bootstrap-skills.js +0 -231
  148. package/tools/_deprecated/bridge-dashboard.js +0 -342
  149. package/tools/_deprecated/bridge-health.js +0 -400
  150. package/tools/_deprecated/bridge-live.js +0 -384
  151. package/tools/_deprecated/bridges.js +0 -383
  152. package/tools/_deprecated/colorguess.js +0 -281
  153. package/tools/_deprecated/discover-insights.js +0 -379
  154. package/tools/_deprecated/discover-momentum.js +0 -256
  155. package/tools/_deprecated/discovery-analytics.js +0 -345
  156. package/tools/_deprecated/discovery-auto-suggest.js +0 -275
  157. package/tools/_deprecated/discovery-bootstrap.js +0 -267
  158. package/tools/_deprecated/discovery-daily.js +0 -375
  159. package/tools/_deprecated/discovery-dashboard.js +0 -385
  160. package/tools/_deprecated/discovery-digest.js +0 -314
  161. package/tools/_deprecated/discovery-hub.js +0 -357
  162. package/tools/_deprecated/discovery-insights.js +0 -384
  163. package/tools/_deprecated/discovery-momentum.js +0 -281
  164. package/tools/_deprecated/discovery-monitor.js +0 -319
  165. package/tools/_deprecated/discovery-proactive.js +0 -300
  166. package/tools/_deprecated/draw.js +0 -317
  167. package/tools/_deprecated/farcaster.js +0 -307
  168. package/tools/_deprecated/games-catalog.js +0 -376
  169. package/tools/_deprecated/games.js +0 -313
  170. package/tools/_deprecated/guessnumber.js +0 -194
  171. package/tools/_deprecated/hangman.js +0 -129
  172. package/tools/_deprecated/multiplayer-tictactoe.js +0 -303
  173. package/tools/_deprecated/riddle.js +0 -240
  174. package/tools/_deprecated/run-bootstrap.js +0 -69
  175. package/tools/_deprecated/skills-analytics.js +0 -349
  176. package/tools/_deprecated/skills-bootstrap.js +0 -301
  177. package/tools/_deprecated/skills-dashboard.js +0 -268
  178. package/tools/_deprecated/skills.js +0 -380
  179. package/tools/_deprecated/smart-intro.js +0 -353
  180. package/tools/_deprecated/storybuilder.js +0 -331
  181. package/tools/_deprecated/telegram-bot.js +0 -183
  182. package/tools/_deprecated/telegram-setup.js +0 -214
  183. package/tools/_deprecated/twentyquestions.js +0 -143
  184. package/tools/_shared.js +0 -234
  185. package/tools/_work-context.js +0 -338
  186. package/tools/_work-context.manual-test.js +0 -199
  187. package/tools/_work-context.test.js +0 -260
  188. package/tools/activity.js +0 -220
  189. package/tools/agent-treasury.js +0 -288
  190. package/tools/analytics.js +0 -191
  191. package/tools/approve.js +0 -197
  192. package/tools/arcade.js +0 -173
  193. package/tools/artifacts-price.js +0 -107
  194. package/tools/ask-expert.js +0 -160
  195. package/tools/available.js +0 -120
  196. package/tools/become-expert.js +0 -150
  197. package/tools/broadcast.js +0 -325
  198. package/tools/chat.js +0 -202
  199. package/tools/collaborative-drawing.js +0 -286
  200. package/tools/connection-status.js +0 -178
  201. package/tools/earnings.js +0 -126
  202. package/tools/friends.js +0 -207
  203. package/tools/genesis.js +0 -233
  204. package/tools/gig-browse.js +0 -206
  205. package/tools/gig-complete.js +0 -144
  206. package/tools/health.js +0 -87
  207. package/tools/leaderboard.js +0 -117
  208. package/tools/lib/git-apply.js +0 -206
  209. package/tools/lib/git-bundle.js +0 -407
  210. package/tools/mint.js +0 -377
  211. package/tools/plan.js +0 -225
  212. package/tools/profile.js +0 -219
  213. package/tools/proof-of-work.js +0 -144
  214. package/tools/pulse.js +0 -218
  215. package/tools/reply.js +0 -166
  216. package/tools/reputation.js +0 -175
  217. package/tools/schedule.js +0 -367
  218. package/tools/search-messages.js +0 -123
  219. package/tools/session.js +0 -467
  220. package/tools/session_price.js +0 -128
  221. package/tools/smart-check.js +0 -201
  222. package/tools/social-processor.js +0 -445
  223. package/tools/streak.js +0 -147
  224. package/tools/stuck.js +0 -297
  225. package/tools/subscribe.js +0 -148
  226. package/tools/subscriptions.js +0 -134
  227. package/tools/tip.js +0 -193
  228. package/tools/wallet.js +0 -269
  229. package/tools/webhook-test.js +0 -388
  230. package/tools/withdraw.js +0 -145
  231. package/tools/work-summary.js +0 -96
  232. package/tools/workshop.js +0 -327
  233. /package/tools/{l2-bridge.js → _experimental/l2-bridge.js} +0 -0
  234. /package/tools/{l2.js → _experimental/l2.js} +0 -0
  235. /package/tools/{_deprecated/away.js → away.js} +0 -0
@@ -1,317 +0,0 @@
1
- /**
2
- * vibe draw — Join collaborative drawing sessions or create art together
3
- *
4
- * A shared canvas where multiple users can draw together in real-time!
5
- */
6
-
7
- const config = require('../config');
8
- const store = require('../store');
9
- const { requireInit, normalizeHandle } = require('./_shared');
10
- const drawing = require('../games/drawing');
11
-
12
- // Global drawing sessions storage (in-memory for now)
13
- const drawingSessions = new Map();
14
-
15
- const definition = {
16
- name: 'vibe_draw',
17
- description: 'Join or create collaborative drawing sessions. Draw together with others in real-time!',
18
- inputSchema: {
19
- type: 'object',
20
- properties: {
21
- action: {
22
- type: 'string',
23
- description: 'Action to perform',
24
- enum: ['join', 'draw', 'line', 'clear', 'theme', 'stats', 'tips', 'list']
25
- },
26
- room: {
27
- type: 'string',
28
- description: 'Drawing room name (default: "main")'
29
- },
30
- x: {
31
- type: 'number',
32
- description: 'X coordinate (0-19)'
33
- },
34
- y: {
35
- type: 'number',
36
- description: 'Y coordinate (0-11)'
37
- },
38
- x1: {
39
- type: 'number',
40
- description: 'End X coordinate for lines'
41
- },
42
- y1: {
43
- type: 'number',
44
- description: 'End Y coordinate for lines'
45
- },
46
- char: {
47
- type: 'string',
48
- description: 'Character to draw (use character names: empty, dot, circle, square, star, heart, tree, house, sun, moon, etc.)'
49
- },
50
- theme: {
51
- type: 'string',
52
- description: 'Set drawing theme/prompt'
53
- }
54
- }
55
- }
56
- };
57
-
58
- // Post drawing activities to the board
59
- async function postDrawingActivity(activity) {
60
- try {
61
- const API_URL = process.env.VIBE_API_URL || 'https://www.slashvibe.dev';
62
-
63
- await fetch(`${API_URL}/api/board`, {
64
- method: 'POST',
65
- headers: { 'Content-Type': 'application/json' },
66
- body: JSON.stringify({
67
- author: 'echo',
68
- content: activity,
69
- category: 'general'
70
- })
71
- });
72
- } catch (e) {
73
- console.error('[draw] Failed to post to board:', e.message);
74
- }
75
- }
76
-
77
- // Get or create drawing session
78
- function getDrawingSession(roomName) {
79
- const sessionKey = roomName || 'main';
80
-
81
- if (!drawingSessions.has(sessionKey)) {
82
- drawingSessions.set(sessionKey, drawing.createInitialDrawingState());
83
- }
84
-
85
- return drawingSessions.get(sessionKey);
86
- }
87
-
88
- // Save drawing session
89
- function saveDrawingSession(roomName, gameState) {
90
- const sessionKey = roomName || 'main';
91
- drawingSessions.set(sessionKey, gameState);
92
- }
93
-
94
- async function handler(args) {
95
- const initCheck = requireInit();
96
- if (initCheck) return initCheck;
97
-
98
- const { action = 'join', room, x, y, x1, y1, char, theme } = args;
99
- const myHandle = config.getHandle();
100
- const roomName = room || 'main';
101
-
102
- // List available commands
103
- if (action === 'list') {
104
- return {
105
- display: `## 🎨 Collaborative Drawing Commands
106
-
107
- **Basic Usage:**
108
- • \`vibe draw\` - Join the main drawing room
109
- • \`vibe draw --action draw --x 5 --y 3 --char star\` - Draw a star at (5,3)
110
- • \`vibe draw --action line --x 2 --y 1 --x1 8 --y1 6 --char dot\` - Draw a line
111
- • \`vibe draw --action clear --x 0 --y 0 --x1 5 --y1 3\` - Clear a region
112
- • \`vibe draw --action theme --theme "landscape"\` - Set drawing theme
113
-
114
- **Available Characters:**
115
- ${Object.entries(drawing.DRAWING_CHARS).map(([name, char]) => `${char} (${name})`).join(' ')}
116
-
117
- **Pro Tips:**
118
- • Canvas is ${drawing.CANVAS_WIDTH}x${drawing.CANVAS_HEIGHT} (coordinates start at 0,0)
119
- • Multiple people can draw at the same time!
120
- • Use themes to inspire collaborative art
121
- • Try \`--action stats\` to see drawing statistics`
122
- };
123
- }
124
-
125
- // Get drawing session
126
- let gameState = getDrawingSession(roomName);
127
-
128
- // Handle different actions
129
- if (action === 'join') {
130
- // Join the drawing session
131
- const result = drawing.addPlayer(gameState, myHandle);
132
-
133
- if (result.error) {
134
- return { display: result.error };
135
- }
136
-
137
- if (result.success) {
138
- gameState = result.gameState;
139
- saveDrawingSession(roomName, gameState);
140
-
141
- // Post to board if this is their first time joining
142
- if (gameState.players.length === 1) {
143
- await postDrawingActivity(`🎨 @${myHandle} started drawing in room "${roomName}"`);
144
- } else {
145
- await postDrawingActivity(`🎨 @${myHandle} joined the drawing session in "${roomName}" (${gameState.players.length} artists)`);
146
- }
147
- }
148
-
149
- const display = drawing.formatDrawingDisplay(gameState);
150
- return { display: `## Drawing Room: "${roomName}"\n\n${display}` };
151
- }
152
-
153
- if (action === 'draw') {
154
- // Make a single drawing move
155
- if (x === undefined || y === undefined || !char) {
156
- return { display: 'Please provide x, y coordinates and character name. Use `vibe draw --action list` for help.' };
157
- }
158
-
159
- // Convert character name to symbol
160
- const charSymbol = drawing.DRAWING_CHARS[char.toLowerCase()];
161
- if (!charSymbol) {
162
- const validChars = Object.keys(drawing.DRAWING_CHARS).join(', ');
163
- return { display: `Invalid character "${char}". Available: ${validChars}` };
164
- }
165
-
166
- const result = drawing.makeMove(gameState, x, y, charSymbol, myHandle);
167
-
168
- if (result.error) {
169
- return { display: result.error };
170
- }
171
-
172
- gameState = result.gameState;
173
- saveDrawingSession(roomName, gameState);
174
-
175
- const display = drawing.formatDrawingDisplay(gameState);
176
- return { display: `## Drawing Room: "${roomName}"\n\n${display}` };
177
- }
178
-
179
- if (action === 'line') {
180
- // Draw a line between two points
181
- if (x === undefined || y === undefined || x1 === undefined || y1 === undefined || !char) {
182
- return { display: 'Please provide x, y, x1, y1 coordinates and character name for line drawing.' };
183
- }
184
-
185
- const charSymbol = drawing.DRAWING_CHARS[char.toLowerCase()];
186
- if (!charSymbol) {
187
- const validChars = Object.keys(drawing.DRAWING_CHARS).join(', ');
188
- return { display: `Invalid character "${char}". Available: ${validChars}` };
189
- }
190
-
191
- const result = drawing.drawLine(gameState, x, y, x1, y1, charSymbol, myHandle);
192
-
193
- if (result.error) {
194
- return { display: result.error };
195
- }
196
-
197
- gameState = result.gameState;
198
- saveDrawingSession(roomName, gameState);
199
-
200
- const display = drawing.formatDrawingDisplay(gameState);
201
- return { display: `## Drawing Room: "${roomName}"\n\n${display}` };
202
- }
203
-
204
- if (action === 'clear') {
205
- // Clear a region
206
- const clearX1 = x1 !== undefined ? x1 : x;
207
- const clearY1 = y1 !== undefined ? y1 : y;
208
-
209
- if (x === undefined || y === undefined) {
210
- return { display: 'Please provide coordinates to clear. Use x,y for single point or x,y,x1,y1 for region.' };
211
- }
212
-
213
- const result = drawing.clearRegion(gameState, x, y, clearX1, clearY1, myHandle);
214
-
215
- if (result.error) {
216
- return { display: result.error };
217
- }
218
-
219
- gameState = result.gameState;
220
- saveDrawingSession(roomName, gameState);
221
-
222
- const display = drawing.formatDrawingDisplay(gameState);
223
- return { display: `## Drawing Room: "${roomName}"\n\n${display}` };
224
- }
225
-
226
- if (action === 'theme') {
227
- // Set drawing theme
228
- if (!theme) {
229
- return { display: 'Please provide a theme. Examples: landscape, portrait, house, animals, nature, vehicle' };
230
- }
231
-
232
- const result = drawing.setTheme(gameState, theme, myHandle);
233
-
234
- if (result.error) {
235
- return { display: result.error };
236
- }
237
-
238
- gameState = result.gameState;
239
- saveDrawingSession(roomName, gameState);
240
-
241
- // Get tips for this theme
242
- const tips = drawing.getDrawingTips(theme);
243
-
244
- await postDrawingActivity(`🎨 @${myHandle} set drawing theme to "${theme}" in room "${roomName}"`);
245
-
246
- const display = drawing.formatDrawingDisplay(gameState);
247
- return {
248
- display: `## Drawing Room: "${roomName}" - Theme: ${theme}\n\n${display}\n**Tips for "${theme}":**\n${tips.map(tip => `• ${tip}`).join('\n')}`
249
- };
250
- }
251
-
252
- if (action === 'stats') {
253
- // Show drawing statistics
254
- const stats = drawing.getCanvasStats(gameState);
255
-
256
- let statsDisplay = `## 📊 Drawing Stats for "${roomName}"\n\n`;
257
- statsDisplay += `**Canvas:** ${stats.fillPercentage}% filled (${stats.totalDrawnCells}/${drawing.CANVAS_WIDTH * drawing.CANVAS_HEIGHT} cells)\n`;
258
- statsDisplay += `**Total moves:** ${stats.totalMoves}\n`;
259
- statsDisplay += `**Unique characters used:** ${stats.uniqueCharsUsed}\n\n`;
260
-
261
- if (stats.mostUsedChar) {
262
- const [char, count] = stats.mostUsedChar;
263
- statsDisplay += `**Most used character:** ${char} (${count} times)\n\n`;
264
- }
265
-
266
- if (Object.keys(stats.playerMoves).length > 0) {
267
- statsDisplay += `**Moves by player:**\n`;
268
- Object.entries(stats.playerMoves)
269
- .sort(([,a], [,b]) => b - a)
270
- .forEach(([player, moves]) => {
271
- statsDisplay += `• @${player}: ${moves} moves\n`;
272
- });
273
- statsDisplay += '\n';
274
- }
275
-
276
- if (Object.keys(stats.charCount).length > 0) {
277
- statsDisplay += `**Character usage:**\n`;
278
- Object.entries(stats.charCount)
279
- .sort(([,a], [,b]) => b - a)
280
- .slice(0, 5)
281
- .forEach(([char, count]) => {
282
- statsDisplay += `• ${char}: ${count} times\n`;
283
- });
284
- }
285
-
286
- const display = drawing.formatDrawingDisplay(gameState);
287
- return { display: statsDisplay + '\n---\n\n' + display };
288
- }
289
-
290
- if (action === 'tips') {
291
- // Show drawing tips
292
- const currentTheme = gameState.theme;
293
- const tips = drawing.getDrawingTips(currentTheme);
294
-
295
- let tipsDisplay = `## 🎨 Drawing Tips\n\n`;
296
-
297
- if (currentTheme) {
298
- tipsDisplay += `**For theme "${currentTheme}":**\n`;
299
- } else {
300
- tipsDisplay += `**General tips:**\n`;
301
- }
302
-
303
- tips.forEach(tip => {
304
- tipsDisplay += `• ${tip}\n`;
305
- });
306
-
307
- tipsDisplay += `\n**Canvas size:** ${drawing.CANVAS_WIDTH}x${drawing.CANVAS_HEIGHT}\n`;
308
- tipsDisplay += `**Coordinates:** (0,0) is top-left, (${drawing.CANVAS_WIDTH-1},${drawing.CANVAS_HEIGHT-1}) is bottom-right\n\n`;
309
-
310
- const display = drawing.formatDrawingDisplay(gameState);
311
- return { display: tipsDisplay + '\n---\n\n' + display };
312
- }
313
-
314
- return { display: 'Unknown action. Use `vibe draw --action list` for help.' };
315
- }
316
-
317
- module.exports = { definition, handler };
@@ -1,307 +0,0 @@
1
- /**
2
- * vibe farcaster — Interact with Farcaster protocol
3
- *
4
- * Read and write to the decentralized social protocol.
5
- * Supports channels, mentions, casts, and reactions.
6
- */
7
-
8
- const farcaster = require('../bridges/farcaster');
9
- const { requireInit, header, divider, success, warning, formatTimeAgo } = require('./_shared');
10
-
11
- const definition = {
12
- name: 'vibe_farcaster',
13
- description: 'Interact with Farcaster - read feed, post casts, get mentions',
14
- inputSchema: {
15
- type: 'object',
16
- properties: {
17
- action: {
18
- type: 'string',
19
- enum: ['feed', 'mentions', 'cast', 'channels', 'search', 'user', 'status'],
20
- description: 'Action to perform (default: feed)'
21
- },
22
- text: {
23
- type: 'string',
24
- description: 'Text to cast (use with action: cast)'
25
- },
26
- channel: {
27
- type: 'string',
28
- description: 'Channel ID to post to or read from (e.g., "dev", "builders")'
29
- },
30
- reply_to: {
31
- type: 'string',
32
- description: 'Cast hash to reply to (use with action: cast)'
33
- },
34
- query: {
35
- type: 'string',
36
- description: 'Search query (use with action: search)'
37
- },
38
- username: {
39
- type: 'string',
40
- description: 'Username to look up (use with action: user)'
41
- },
42
- limit: {
43
- type: 'number',
44
- description: 'Number of results to show (default: 10, max: 25)'
45
- }
46
- }
47
- }
48
- };
49
-
50
- async function handler(args) {
51
- const initCheck = requireInit();
52
- if (initCheck) return initCheck;
53
-
54
- const { action = 'feed', text, channel, reply_to, query, username, limit = 10 } = args;
55
-
56
- // Check configuration
57
- if (!farcaster.isConfigured()) {
58
- return {
59
- display: `${header('Farcaster')}\n\n${warning('Farcaster not configured.')}\n\nSet NEYNAR_API_KEY, FARCASTER_SIGNER_UUID, and FARCASTER_FID in config.json\n\nGet API key: https://neynar.com\nSetup guide: https://docs.neynar.com/reference/developer-managed-signers`
60
- };
61
- }
62
-
63
- try {
64
- switch (action) {
65
- case 'status':
66
- return await handleStatus();
67
-
68
- case 'feed':
69
- return await handleFeed(channel, Math.min(limit, 25));
70
-
71
- case 'mentions':
72
- return await handleMentions(Math.min(limit, 25));
73
-
74
- case 'cast':
75
- return await handleCast(text, channel, reply_to);
76
-
77
- case 'channels':
78
- return handleChannels();
79
-
80
- case 'search':
81
- return await handleSearch(query, Math.min(limit, 25));
82
-
83
- case 'user':
84
- return await handleUser(username);
85
-
86
- default:
87
- return { display: `Unknown action: ${action}` };
88
- }
89
- } catch (e) {
90
- return {
91
- display: `${header('Farcaster')}\n\n_Error:_ ${e.message}`
92
- };
93
- }
94
- }
95
-
96
- async function handleStatus() {
97
- let display = header('Farcaster Status');
98
- display += '\n\n';
99
-
100
- const userInfo = await farcaster.getUser();
101
- const user = userInfo.users[0];
102
-
103
- display += success(`✅ Connected to Farcaster\n\n`);
104
- display += `**Your Account:**\n`;
105
- display += `• Name: ${user.display_name}\n`;
106
- display += `• Username: @${user.username}\n`;
107
- display += `• FID: ${user.fid}\n`;
108
- display += `• Followers: ${user.follower_count}\n`;
109
- display += `• Following: ${user.following_count}\n`;
110
- display += `• Bio: ${user.profile?.bio?.text || 'No bio'}\n\n`;
111
-
112
- display += divider();
113
- display += '**Available actions:**\n';
114
- display += '• `vibe farcaster --action feed` - View your feed\n';
115
- display += '• `vibe farcaster --action mentions` - See mentions\n';
116
- display += '• `vibe farcaster --action cast --text "hello farcaster"` - Post cast\n';
117
- display += '• `vibe farcaster --action channels` - Browse channels\n';
118
- display += '• `vibe farcaster --action search --query "ethereum"`';
119
-
120
- return { display };
121
- }
122
-
123
- async function handleFeed(channelId, limit) {
124
- let display = header(channelId ? `/${channelId} Channel` : 'Your Feed');
125
- display += '\n\n';
126
-
127
- let feedData;
128
- if (channelId) {
129
- feedData = await farcaster.getChannelFeed(channelId, limit);
130
- } else {
131
- feedData = await farcaster.getFeed(null, limit);
132
- }
133
-
134
- const casts = feedData.casts || [];
135
-
136
- if (casts.length === 0) {
137
- display += '_No casts found._';
138
- return { display };
139
- }
140
-
141
- display += `📡 ${casts.length} casts\n`;
142
- display += divider();
143
- display += '\n';
144
-
145
- for (const cast of casts) {
146
- const processed = farcaster.processCast(cast);
147
- display += formatCast(processed);
148
- display += '\n';
149
- }
150
-
151
- display += divider();
152
- display += 'Reply: `vibe farcaster --action cast --text "your reply" --reply_to CAST_HASH`';
153
-
154
- return { display };
155
- }
156
-
157
- async function handleMentions(limit) {
158
- let display = header('Mentions');
159
- display += '\n\n';
160
-
161
- const mentionsData = await farcaster.getMentions(null, limit);
162
- const notifications = mentionsData.notifications || [];
163
-
164
- if (notifications.length === 0) {
165
- display += '_No mentions found._';
166
- return { display };
167
- }
168
-
169
- display += `@️ ${notifications.length} mentions\n`;
170
- display += divider();
171
- display += '\n';
172
-
173
- for (const notification of notifications) {
174
- if (notification.cast) {
175
- const processed = farcaster.processCast(notification.cast);
176
- display += formatCast(processed, true);
177
- display += '\n';
178
- }
179
- }
180
-
181
- display += divider();
182
- display += 'Reply: `vibe farcaster --action cast --text "thanks!" --reply_to CAST_HASH`';
183
-
184
- return { display };
185
- }
186
-
187
- async function handleCast(text, channelId, replyTo) {
188
- if (!text || text.trim().length === 0) {
189
- return { display: 'Need text to cast. Use --text "your message here"' };
190
- }
191
-
192
- const options = {};
193
- if (channelId) options.channel = channelId;
194
- if (replyTo) options.replyTo = replyTo;
195
-
196
- let display = header(replyTo ? 'Casting Reply...' : 'Casting...');
197
- display += '\n\n';
198
-
199
- const result = await farcaster.publishCast(text.trim(), options);
200
-
201
- if (result.success) {
202
- display = header('Cast Published! 🚀');
203
- display += '\n\n';
204
- display += success(`✅ Cast sent successfully\n\n`);
205
- display += `**Details:**\n`;
206
- display += `• Hash: ${result.cast.hash}\n`;
207
- display += `• Content: "${text.trim()}"\n`;
208
- if (channelId) display += `• Channel: /${channelId}\n`;
209
- if (replyTo) display += `• Reply to: ${replyTo}\n`;
210
- display += `• URL: https://warpcast.com/${result.cast.author.username}/${result.cast.hash.slice(0, 10)}\n\n`;
211
-
212
- display += divider();
213
- display += 'Your cast is now live on Farcaster! 🎉';
214
- } else {
215
- display += `❌ Failed to publish cast\n`;
216
- display += `Error: ${result.message || 'Unknown error'}`;
217
- }
218
-
219
- return { display };
220
- }
221
-
222
- function handleChannels() {
223
- let display = header('Recommended Channels');
224
- display += '\n\n';
225
-
226
- const channels = farcaster.getRecommendedChannels();
227
-
228
- display += `🔮 Popular channels for builders:\n\n`;
229
-
230
- for (const channel of channels) {
231
- display += `• **/${channel.id}** — ${channel.name}\n`;
232
- }
233
-
234
- display += '\n' + divider();
235
- display += '**Usage:**\n';
236
- display += '• Browse: `vibe farcaster --action feed --channel dev`\n';
237
- display += '• Post: `vibe farcaster --action cast --text "gm builders" --channel dev`\n\n';
238
-
239
- display += 'Find more channels at: https://warpcast.com/~/channels';
240
-
241
- return { display };
242
- }
243
-
244
- async function handleSearch(query, limit) {
245
- if (!query || query.trim().length === 0) {
246
- return { display: 'Need search query. Use --query "your search terms"' };
247
- }
248
-
249
- let display = header(`Search: "${query}"`);
250
- display += '\n\n';
251
-
252
- const searchResults = await farcaster.searchCasts(query.trim(), limit);
253
- const casts = searchResults.result?.casts || [];
254
-
255
- if (casts.length === 0) {
256
- display += `_No casts found for "${query}"._`;
257
- return { display };
258
- }
259
-
260
- display += `🔍 ${casts.length} results\n`;
261
- display += divider();
262
- display += '\n';
263
-
264
- for (const cast of casts) {
265
- const processed = farcaster.processCast(cast);
266
- display += formatCast(processed);
267
- display += '\n';
268
- }
269
-
270
- return { display };
271
- }
272
-
273
- async function handleUser(username) {
274
- if (!username) {
275
- return { display: 'Need username. Use --username "handle"' };
276
- }
277
-
278
- // This would require additional API call to lookup by username
279
- // For now, show error message with guidance
280
- return {
281
- display: `${header('User Lookup')}\n\n_Username lookup not implemented yet._\n\nUse FID instead with the status action or search for their casts.`
282
- };
283
- }
284
-
285
- function formatCast(cast, isMention = false) {
286
- const channelInfo = cast.channel_id ? ` in /${cast.channel_id}` : '';
287
- const mentionFlag = isMention ? ' @' : '';
288
-
289
- let result = `🟣 **@${cast.from.handle}**${mentionFlag}${channelInfo} — _${formatTimeAgo(new Date(cast.timestamp))}_\n`;
290
- result += `${cast.content}\n`;
291
-
292
- // Show engagement metrics
293
- const metrics = [];
294
- if (cast.replies > 0) metrics.push(`${cast.replies} replies`);
295
- if (cast.reactions > 0) metrics.push(`${cast.reactions} likes`);
296
- if (cast.recasts > 0) metrics.push(`${cast.recasts} recasts`);
297
-
298
- if (metrics.length > 0) {
299
- result += `_${metrics.join(' • ')}_\n`;
300
- }
301
-
302
- result += `_[farcaster:${cast.hash.slice(0, 8)}]_\n`;
303
-
304
- return result;
305
- }
306
-
307
- module.exports = { definition, handler };