youtube-knowledge-mcp 2.1.0 → 2.2.0

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 (344) hide show
  1. package/README.md +105 -34
  2. package/dist/brain-schemas.d.ts +10 -10
  3. package/dist/brain-schemas.d.ts.map +1 -1
  4. package/dist/brain-schemas.js +0 -4
  5. package/dist/brain-schemas.js.map +1 -1
  6. package/dist/http/app.d.ts +16 -0
  7. package/dist/http/app.d.ts.map +1 -0
  8. package/dist/http/app.js +176 -0
  9. package/dist/http/app.js.map +1 -0
  10. package/dist/http/auth.d.ts +38 -0
  11. package/dist/http/auth.d.ts.map +1 -0
  12. package/dist/http/auth.js +79 -0
  13. package/dist/http/auth.js.map +1 -0
  14. package/dist/http/config.d.ts +41 -0
  15. package/dist/http/config.d.ts.map +1 -0
  16. package/dist/http/config.js +65 -0
  17. package/dist/http/config.js.map +1 -0
  18. package/dist/http/rate-limiter.d.ts +24 -0
  19. package/dist/http/rate-limiter.d.ts.map +1 -0
  20. package/dist/http/rate-limiter.js +55 -0
  21. package/dist/http/rate-limiter.js.map +1 -0
  22. package/dist/http/sessions.d.ts +34 -0
  23. package/dist/http/sessions.d.ts.map +1 -0
  24. package/dist/http/sessions.js +62 -0
  25. package/dist/http/sessions.js.map +1 -0
  26. package/dist/http.d.ts +6 -48
  27. package/dist/http.d.ts.map +1 -1
  28. package/dist/http.js +35 -252
  29. package/dist/http.js.map +1 -1
  30. package/dist/index.d.ts.map +1 -1
  31. package/dist/index.js +11 -517
  32. package/dist/index.js.map +1 -1
  33. package/dist/prompts-brain.d.ts +4 -0
  34. package/dist/prompts-brain.d.ts.map +1 -0
  35. package/dist/prompts-brain.js +48 -0
  36. package/dist/prompts-brain.js.map +1 -0
  37. package/dist/prompts-research.d.ts +4 -0
  38. package/dist/prompts-research.d.ts.map +1 -0
  39. package/dist/prompts-research.js +74 -0
  40. package/dist/prompts-research.js.map +1 -0
  41. package/dist/prompts-shared.d.ts +13 -0
  42. package/dist/prompts-shared.d.ts.map +1 -0
  43. package/dist/prompts-shared.js +7 -0
  44. package/dist/prompts-shared.js.map +1 -0
  45. package/dist/prompts.d.ts.map +1 -1
  46. package/dist/prompts.js +5 -100
  47. package/dist/prompts.js.map +1 -1
  48. package/dist/registry/brain-tools.d.ts +4 -0
  49. package/dist/registry/brain-tools.d.ts.map +1 -0
  50. package/dist/registry/brain-tools.js +104 -0
  51. package/dist/registry/brain-tools.js.map +1 -0
  52. package/dist/registry/channel-tools.d.ts +4 -0
  53. package/dist/registry/channel-tools.d.ts.map +1 -0
  54. package/dist/registry/channel-tools.js +53 -0
  55. package/dist/registry/channel-tools.js.map +1 -0
  56. package/dist/registry/health-tools.d.ts +4 -0
  57. package/dist/registry/health-tools.d.ts.map +1 -0
  58. package/dist/registry/health-tools.js +21 -0
  59. package/dist/registry/health-tools.js.map +1 -0
  60. package/dist/registry/index.d.ts +8 -0
  61. package/dist/registry/index.d.ts.map +1 -0
  62. package/dist/registry/index.js +27 -0
  63. package/dist/registry/index.js.map +1 -0
  64. package/dist/registry/library-tools.d.ts +4 -0
  65. package/dist/registry/library-tools.d.ts.map +1 -0
  66. package/dist/registry/library-tools.js +116 -0
  67. package/dist/registry/library-tools.js.map +1 -0
  68. package/dist/registry/media-tools.d.ts +4 -0
  69. package/dist/registry/media-tools.d.ts.map +1 -0
  70. package/dist/registry/media-tools.js +100 -0
  71. package/dist/registry/media-tools.js.map +1 -0
  72. package/dist/registry/thumbnail-tools.d.ts +7 -0
  73. package/dist/registry/thumbnail-tools.d.ts.map +1 -0
  74. package/dist/registry/thumbnail-tools.js +72 -0
  75. package/dist/registry/thumbnail-tools.js.map +1 -0
  76. package/dist/registry/transcript-tools.d.ts +4 -0
  77. package/dist/registry/transcript-tools.d.ts.map +1 -0
  78. package/dist/registry/transcript-tools.js +68 -0
  79. package/dist/registry/transcript-tools.js.map +1 -0
  80. package/dist/registry/types.d.ts +41 -0
  81. package/dist/registry/types.d.ts.map +1 -0
  82. package/dist/registry/types.js +17 -0
  83. package/dist/registry/types.js.map +1 -0
  84. package/dist/registry/video-tools.d.ts +4 -0
  85. package/dist/registry/video-tools.d.ts.map +1 -0
  86. package/dist/registry/video-tools.js +101 -0
  87. package/dist/registry/video-tools.js.map +1 -0
  88. package/dist/resources.d.ts.map +1 -1
  89. package/dist/resources.js +13 -10
  90. package/dist/resources.js.map +1 -1
  91. package/dist/schemas.d.ts +11 -2
  92. package/dist/schemas.d.ts.map +1 -1
  93. package/dist/schemas.js +5 -0
  94. package/dist/schemas.js.map +1 -1
  95. package/dist/thumbnail-resource.d.ts +8 -0
  96. package/dist/thumbnail-resource.d.ts.map +1 -0
  97. package/dist/thumbnail-resource.js +38 -0
  98. package/dist/thumbnail-resource.js.map +1 -0
  99. package/dist/thumbnail-schemas.d.ts +512 -0
  100. package/dist/thumbnail-schemas.d.ts.map +1 -0
  101. package/dist/thumbnail-schemas.js +95 -0
  102. package/dist/thumbnail-schemas.js.map +1 -0
  103. package/dist/tools/batch.js +1 -1
  104. package/dist/tools/batch.js.map +1 -1
  105. package/dist/tools/build-brain.js +1 -1
  106. package/dist/tools/build-brain.js.map +1 -1
  107. package/dist/tools/check-health.d.ts +2 -0
  108. package/dist/tools/check-health.d.ts.map +1 -1
  109. package/dist/tools/check-health.js +9 -0
  110. package/dist/tools/check-health.js.map +1 -1
  111. package/dist/tools/clips.d.ts +9 -41
  112. package/dist/tools/clips.d.ts.map +1 -1
  113. package/dist/tools/clips.js +52 -128
  114. package/dist/tools/clips.js.map +1 -1
  115. package/dist/tools/fetch-channel-thumbnails.d.ts +179 -0
  116. package/dist/tools/fetch-channel-thumbnails.d.ts.map +1 -0
  117. package/dist/tools/fetch-channel-thumbnails.js +123 -0
  118. package/dist/tools/fetch-channel-thumbnails.js.map +1 -0
  119. package/dist/tools/fetch-videos.d.ts +3 -0
  120. package/dist/tools/fetch-videos.d.ts.map +1 -1
  121. package/dist/tools/fetch-videos.js +3 -0
  122. package/dist/tools/fetch-videos.js.map +1 -1
  123. package/dist/tools/frames-subtitles.d.ts +44 -0
  124. package/dist/tools/frames-subtitles.d.ts.map +1 -0
  125. package/dist/tools/frames-subtitles.js +104 -0
  126. package/dist/tools/frames-subtitles.js.map +1 -0
  127. package/dist/tools/get-channel-info.d.ts +2 -0
  128. package/dist/tools/get-channel-info.d.ts.map +1 -1
  129. package/dist/tools/get-channel-info.js +8 -1
  130. package/dist/tools/get-channel-info.js.map +1 -1
  131. package/dist/tools/get-playlist-info.d.ts.map +1 -1
  132. package/dist/tools/get-playlist-info.js +1 -0
  133. package/dist/tools/get-playlist-info.js.map +1 -1
  134. package/dist/tools/get-thumbnail.d.ts +38 -0
  135. package/dist/tools/get-thumbnail.d.ts.map +1 -0
  136. package/dist/tools/get-thumbnail.js +152 -0
  137. package/dist/tools/get-thumbnail.js.map +1 -0
  138. package/dist/tools/get-transcript.d.ts.map +1 -1
  139. package/dist/tools/get-transcript.js +2 -14
  140. package/dist/tools/get-transcript.js.map +1 -1
  141. package/dist/tools/library.d.ts.map +1 -1
  142. package/dist/tools/library.js +13 -3
  143. package/dist/tools/library.js.map +1 -1
  144. package/dist/tools/list-channel-thumbnails.d.ts +235 -0
  145. package/dist/tools/list-channel-thumbnails.d.ts.map +1 -0
  146. package/dist/tools/list-channel-thumbnails.js +79 -0
  147. package/dist/tools/list-channel-thumbnails.js.map +1 -0
  148. package/dist/tools/save-to-library.d.ts.map +1 -1
  149. package/dist/tools/save-to-library.js +5 -1
  150. package/dist/tools/save-to-library.js.map +1 -1
  151. package/dist/tools/search-channels.d.ts +6 -0
  152. package/dist/tools/search-channels.d.ts.map +1 -1
  153. package/dist/tools/search-transcript.d.ts.map +1 -1
  154. package/dist/tools/search-transcript.js +6 -13
  155. package/dist/tools/search-transcript.js.map +1 -1
  156. package/dist/tools/search-videos.d.ts +3 -0
  157. package/dist/tools/search-videos.d.ts.map +1 -1
  158. package/dist/utils/batches.d.ts +15 -0
  159. package/dist/utils/batches.d.ts.map +1 -0
  160. package/dist/utils/batches.js +31 -0
  161. package/dist/utils/batches.js.map +1 -0
  162. package/dist/utils/brain-build.d.ts.map +1 -1
  163. package/dist/utils/brain-build.js +1 -12
  164. package/dist/utils/brain-build.js.map +1 -1
  165. package/dist/utils/brain-index.d.ts.map +1 -1
  166. package/dist/utils/brain-index.js +3 -2
  167. package/dist/utils/brain-index.js.map +1 -1
  168. package/dist/utils/brain-lock.d.ts +2 -18
  169. package/dist/utils/brain-lock.d.ts.map +1 -1
  170. package/dist/utils/brain-lock.js +4 -80
  171. package/dist/utils/brain-lock.js.map +1 -1
  172. package/dist/utils/brain-lookup.d.ts +8 -0
  173. package/dist/utils/brain-lookup.d.ts.map +1 -1
  174. package/dist/utils/brain-lookup.js +5 -31
  175. package/dist/utils/brain-lookup.js.map +1 -1
  176. package/dist/utils/brain-storage.d.ts.map +1 -1
  177. package/dist/utils/brain-storage.js +5 -5
  178. package/dist/utils/brain-storage.js.map +1 -1
  179. package/dist/utils/caption-probe.d.ts +7 -0
  180. package/dist/utils/caption-probe.d.ts.map +1 -0
  181. package/dist/utils/caption-probe.js +36 -0
  182. package/dist/utils/caption-probe.js.map +1 -0
  183. package/dist/utils/channel-images.d.ts +16 -0
  184. package/dist/utils/channel-images.d.ts.map +1 -0
  185. package/dist/utils/channel-images.js +35 -0
  186. package/dist/utils/channel-images.js.map +1 -0
  187. package/dist/utils/channel-lookup.d.ts +5 -0
  188. package/dist/utils/channel-lookup.d.ts.map +1 -0
  189. package/dist/utils/channel-lookup.js +37 -0
  190. package/dist/utils/channel-lookup.js.map +1 -0
  191. package/dist/utils/chapters.d.ts +11 -0
  192. package/dist/utils/chapters.d.ts.map +1 -0
  193. package/dist/utils/chapters.js +24 -0
  194. package/dist/utils/chapters.js.map +1 -0
  195. package/dist/utils/clips.d.ts.map +1 -1
  196. package/dist/utils/clips.js +18 -26
  197. package/dist/utils/clips.js.map +1 -1
  198. package/dist/utils/env.d.ts +26 -0
  199. package/dist/utils/env.d.ts.map +1 -0
  200. package/dist/utils/env.js +72 -0
  201. package/dist/utils/env.js.map +1 -0
  202. package/dist/utils/errors.d.ts +1 -1
  203. package/dist/utils/errors.d.ts.map +1 -1
  204. package/dist/utils/errors.js +20 -2
  205. package/dist/utils/errors.js.map +1 -1
  206. package/dist/utils/file-lock.d.ts +34 -0
  207. package/dist/utils/file-lock.d.ts.map +1 -0
  208. package/dist/utils/file-lock.js +91 -0
  209. package/dist/utils/file-lock.js.map +1 -0
  210. package/dist/utils/flat-listing.d.ts +89 -0
  211. package/dist/utils/flat-listing.d.ts.map +1 -0
  212. package/dist/utils/flat-listing.js +68 -0
  213. package/dist/utils/flat-listing.js.map +1 -0
  214. package/dist/utils/format.d.ts +1 -3
  215. package/dist/utils/format.d.ts.map +1 -1
  216. package/dist/utils/format.js +1 -5
  217. package/dist/utils/format.js.map +1 -1
  218. package/dist/utils/guard.d.ts +21 -0
  219. package/dist/utils/guard.d.ts.map +1 -0
  220. package/dist/utils/guard.js +105 -0
  221. package/dist/utils/guard.js.map +1 -0
  222. package/dist/utils/image-dimensions.d.ts +19 -0
  223. package/dist/utils/image-dimensions.d.ts.map +1 -0
  224. package/dist/utils/image-dimensions.js +93 -0
  225. package/dist/utils/image-dimensions.js.map +1 -0
  226. package/dist/utils/image-fetch.d.ts +31 -0
  227. package/dist/utils/image-fetch.d.ts.map +1 -0
  228. package/dist/utils/image-fetch.js +141 -0
  229. package/dist/utils/image-fetch.js.map +1 -0
  230. package/dist/utils/json-file.d.ts +14 -5
  231. package/dist/utils/json-file.d.ts.map +1 -1
  232. package/dist/utils/json-file.js +24 -9
  233. package/dist/utils/json-file.js.map +1 -1
  234. package/dist/utils/paths.d.ts +10 -0
  235. package/dist/utils/paths.d.ts.map +1 -1
  236. package/dist/utils/paths.js +14 -0
  237. package/dist/utils/paths.js.map +1 -1
  238. package/dist/utils/pattern.d.ts +30 -0
  239. package/dist/utils/pattern.d.ts.map +1 -0
  240. package/dist/utils/pattern.js +130 -0
  241. package/dist/utils/pattern.js.map +1 -0
  242. package/dist/utils/search-index.d.ts.map +1 -1
  243. package/dist/utils/search-index.js +9 -4
  244. package/dist/utils/search-index.js.map +1 -1
  245. package/dist/utils/storage.d.ts.map +1 -1
  246. package/dist/utils/storage.js +14 -8
  247. package/dist/utils/storage.js.map +1 -1
  248. package/dist/utils/subtitles.d.ts +7 -0
  249. package/dist/utils/subtitles.d.ts.map +1 -0
  250. package/dist/utils/subtitles.js +30 -0
  251. package/dist/utils/subtitles.js.map +1 -0
  252. package/dist/utils/thumbnail-entry.d.ts +19 -0
  253. package/dist/utils/thumbnail-entry.d.ts.map +1 -0
  254. package/dist/utils/thumbnail-entry.js +119 -0
  255. package/dist/utils/thumbnail-entry.js.map +1 -0
  256. package/dist/utils/thumbnail-fetch.d.ts +37 -0
  257. package/dist/utils/thumbnail-fetch.d.ts.map +1 -0
  258. package/dist/utils/thumbnail-fetch.js +89 -0
  259. package/dist/utils/thumbnail-fetch.js.map +1 -0
  260. package/dist/utils/thumbnail-ladder.d.ts +44 -0
  261. package/dist/utils/thumbnail-ladder.d.ts.map +1 -0
  262. package/dist/utils/thumbnail-ladder.js +68 -0
  263. package/dist/utils/thumbnail-ladder.js.map +1 -0
  264. package/dist/utils/thumbnail-listing.d.ts +16 -0
  265. package/dist/utils/thumbnail-listing.d.ts.map +1 -0
  266. package/dist/utils/thumbnail-listing.js +26 -0
  267. package/dist/utils/thumbnail-listing.js.map +1 -0
  268. package/dist/utils/thumbnail-paths.d.ts +20 -0
  269. package/dist/utils/thumbnail-paths.d.ts.map +1 -0
  270. package/dist/utils/thumbnail-paths.js +35 -0
  271. package/dist/utils/thumbnail-paths.js.map +1 -0
  272. package/dist/utils/thumbnail-store.d.ts +19 -0
  273. package/dist/utils/thumbnail-store.d.ts.map +1 -0
  274. package/dist/utils/thumbnail-store.js +125 -0
  275. package/dist/utils/thumbnail-store.js.map +1 -0
  276. package/dist/utils/transcript-cache.d.ts +20 -0
  277. package/dist/utils/transcript-cache.d.ts.map +1 -0
  278. package/dist/utils/transcript-cache.js +127 -0
  279. package/dist/utils/transcript-cache.js.map +1 -0
  280. package/dist/utils/transcript-search.d.ts +20 -0
  281. package/dist/utils/transcript-search.d.ts.map +1 -0
  282. package/dist/utils/transcript-search.js +35 -0
  283. package/dist/utils/transcript-search.js.map +1 -0
  284. package/dist/utils/transcript.d.ts +10 -31
  285. package/dist/utils/transcript.d.ts.map +1 -1
  286. package/dist/utils/transcript.js +2 -64
  287. package/dist/utils/transcript.js.map +1 -1
  288. package/dist/utils/validate-youtube.d.ts +35 -0
  289. package/dist/utils/validate-youtube.d.ts.map +1 -0
  290. package/dist/utils/validate-youtube.js +87 -0
  291. package/dist/utils/validate-youtube.js.map +1 -0
  292. package/dist/utils/validate.d.ts +11 -4
  293. package/dist/utils/validate.d.ts.map +1 -1
  294. package/dist/utils/validate.js +43 -36
  295. package/dist/utils/validate.js.map +1 -1
  296. package/dist/utils/version.d.ts +2 -0
  297. package/dist/utils/version.d.ts.map +1 -0
  298. package/dist/utils/version.js +19 -0
  299. package/dist/utils/version.js.map +1 -0
  300. package/dist/utils/youtube-channel.d.ts +44 -0
  301. package/dist/utils/youtube-channel.d.ts.map +1 -0
  302. package/dist/utils/youtube-channel.js +61 -0
  303. package/dist/utils/youtube-channel.js.map +1 -0
  304. package/dist/utils/youtube-download.d.ts +27 -0
  305. package/dist/utils/youtube-download.d.ts.map +1 -0
  306. package/dist/utils/youtube-download.js +118 -0
  307. package/dist/utils/youtube-download.js.map +1 -0
  308. package/dist/utils/youtube-schemas.d.ts +394 -0
  309. package/dist/utils/youtube-schemas.d.ts.map +1 -0
  310. package/dist/utils/youtube-schemas.js +118 -0
  311. package/dist/utils/youtube-schemas.js.map +1 -0
  312. package/dist/utils/youtube-search.d.ts +14 -0
  313. package/dist/utils/youtube-search.d.ts.map +1 -0
  314. package/dist/utils/youtube-search.js +39 -0
  315. package/dist/utils/youtube-search.js.map +1 -0
  316. package/dist/utils/youtube-url.d.ts +25 -0
  317. package/dist/utils/youtube-url.d.ts.map +1 -0
  318. package/dist/utils/youtube-url.js +75 -0
  319. package/dist/utils/youtube-url.js.map +1 -0
  320. package/dist/utils/youtube-video.d.ts +47 -0
  321. package/dist/utils/youtube-video.d.ts.map +1 -0
  322. package/dist/utils/youtube-video.js +98 -0
  323. package/dist/utils/youtube-video.js.map +1 -0
  324. package/dist/utils/youtube.d.ts +10 -122
  325. package/dist/utils/youtube.d.ts.map +1 -1
  326. package/dist/utils/youtube.js +11 -486
  327. package/dist/utils/youtube.js.map +1 -1
  328. package/dist/utils/ytdlp-env.d.ts +33 -0
  329. package/dist/utils/ytdlp-env.d.ts.map +1 -0
  330. package/dist/utils/ytdlp-env.js +121 -0
  331. package/dist/utils/ytdlp-env.js.map +1 -0
  332. package/dist/utils/ytdlp-limiter.d.ts +24 -0
  333. package/dist/utils/ytdlp-limiter.d.ts.map +1 -0
  334. package/dist/utils/ytdlp-limiter.js +69 -0
  335. package/dist/utils/ytdlp-limiter.js.map +1 -0
  336. package/dist/utils/ytdlp-parse.d.ts +13 -0
  337. package/dist/utils/ytdlp-parse.d.ts.map +1 -0
  338. package/dist/utils/ytdlp-parse.js +48 -0
  339. package/dist/utils/ytdlp-parse.js.map +1 -0
  340. package/dist/utils/ytdlp.d.ts +13 -18
  341. package/dist/utils/ytdlp.d.ts.map +1 -1
  342. package/dist/utils/ytdlp.js +21 -110
  343. package/dist/utils/ytdlp.js.map +1 -1
  344. package/package.json +2 -1
@@ -0,0 +1,123 @@
1
+ import { z } from 'zod';
2
+ import { channelImageSchema, thumbnailQualitySchema, thumbnailStatsSchema, thumbnailTabSchema, } from '../thumbnail-schemas.js';
3
+ import { YouTubeError } from '../utils/errors.js';
4
+ import { withFileLock } from '../utils/file-lock.js';
5
+ import { fileResult } from '../utils/format.js';
6
+ import { fetchChannelThumbnails } from '../utils/thumbnail-fetch.js';
7
+ import { listTabs } from '../utils/thumbnail-listing.js';
8
+ import { thumbnailDir, thumbnailLockPath, thumbnailManifestPath, } from '../utils/thumbnail-paths.js';
9
+ import { ensureThumbnailDirs, readThumbnailManifest } from '../utils/thumbnail-store.js';
10
+ import { assertChannelId } from '../utils/validate.js';
11
+ import { getChannelInfo } from '../utils/youtube.js';
12
+ export const fetchChannelThumbnailsSchema = {
13
+ channel: z.string().max(256).describe('Channel URL, @handle, or name'),
14
+ maxVideos: z
15
+ .number()
16
+ .int()
17
+ .min(1)
18
+ .max(500)
19
+ .default(100)
20
+ .describe('Most recent videos to consider, per tab. Default: 100'),
21
+ tabs: z
22
+ .array(thumbnailTabSchema)
23
+ .min(1)
24
+ .default(['videos'])
25
+ .describe("Which channel tabs to read. Shorts have portrait thumbnails and are saved under shorts/. Default: ['videos']"),
26
+ quality: thumbnailQualitySchema.default('best'),
27
+ };
28
+ export const fetchChannelThumbnailsOutputSchema = {
29
+ channelId: z.string(),
30
+ name: z.string(),
31
+ handle: z.string(),
32
+ channelUrl: z.string(),
33
+ directory: z.string(),
34
+ manifestPath: z.string(),
35
+ tabs: z.array(thumbnailTabSchema),
36
+ quality: thumbnailQualitySchema,
37
+ considered: z.number().int().describe('Videos with a record after this call'),
38
+ fetched: z.number().int().describe('Images saved during this call'),
39
+ skipped: z.number().int().describe('Images already on disk'),
40
+ failed: z.number().int(),
41
+ failures: z.array(z.object({ videoId: z.string(), tab: thumbnailTabSchema, error: z.string() })),
42
+ tabErrors: z
43
+ .array(z.object({ tab: thumbnailTabSchema, error: z.string() }))
44
+ .describe('Tabs that could not be listed'),
45
+ avatar: channelImageSchema.optional(),
46
+ banner: channelImageSchema.optional(),
47
+ stoppedEarly: z.boolean(),
48
+ stopReason: z.string().optional(),
49
+ stats: thumbnailStatsSchema,
50
+ };
51
+ /**
52
+ * Save every thumbnail of a channel, plus its avatar and banner.
53
+ *
54
+ * Idempotent by construction: images already on disk are kept, missing or
55
+ * truncated ones are fetched again, and a second call after an interruption
56
+ * continues. The listing is one yt-dlp call per tab; the images come from
57
+ * YouTube's image hosts directly, so no video is extracted individually.
58
+ */
59
+ export async function fetchChannelThumbnailsHandler({ channel, maxVideos, tabs, quality, }) {
60
+ const info = await getChannelInfo(channel);
61
+ const channelId = assertChannelId(info.channelId);
62
+ const wanted = [...new Set(tabs)];
63
+ await ensureThumbnailDirs(channelId, wanted);
64
+ const result = await withFileLock(thumbnailLockPath(channelId), async () => {
65
+ const { listings, tabErrors } = await listTabs(info.channelUrl, wanted, maxVideos);
66
+ const outcome = await fetchChannelThumbnails({
67
+ channel: info,
68
+ listings,
69
+ existing: await readThumbnailManifest(channelId),
70
+ quality,
71
+ });
72
+ return { ...outcome, tabErrors };
73
+ }, (existing) => alreadyFetching(channelId, existing));
74
+ const directory = thumbnailDir(channelId);
75
+ const manifestPath = thumbnailManifestPath(channelId);
76
+ const { manifest } = result;
77
+ return fileResult(render(info.name, directory, result), {
78
+ channelId,
79
+ name: info.name,
80
+ handle: info.handle,
81
+ channelUrl: info.channelUrl,
82
+ directory,
83
+ manifestPath,
84
+ tabs: manifest.tabs,
85
+ quality,
86
+ considered: result.considered,
87
+ fetched: result.fetched,
88
+ skipped: result.skipped,
89
+ failed: result.failed,
90
+ failures: result.failures,
91
+ tabErrors: result.tabErrors,
92
+ ...(manifest.avatar === undefined ? {} : { avatar: manifest.avatar }),
93
+ ...(manifest.banner === undefined ? {} : { banner: manifest.banner }),
94
+ stoppedEarly: result.stoppedEarly,
95
+ ...(result.stopReason === undefined ? {} : { stopReason: result.stopReason }),
96
+ stats: manifest.stats,
97
+ }, { path: manifestPath, name: `${info.name} thumbnails`, mimeType: 'application/json' });
98
+ }
99
+ function alreadyFetching(channelId, existing) {
100
+ const owner = existing === undefined ? '' : `Started at ${existing.startedAt} by process ${existing.pid}. `;
101
+ return new YouTubeError('INVALID_INPUT', `Thumbnails for ${channelId} are already being fetched.`, {
102
+ nextStep: `${owner}Wait for it to finish, then call fetch_channel_thumbnails again to continue.`,
103
+ });
104
+ }
105
+ function render(name, directory, result) {
106
+ const lines = [
107
+ `Thumbnails for ${name}: ${result.considered - result.failed} of ${result.considered} saved.`,
108
+ '',
109
+ `Fetched ${result.fetched} · already had ${result.skipped}${result.failed > 0 ? ` · ${result.failed} failed` : ''}`,
110
+ `Avatar: ${result.manifest.avatar?.state ?? 'not listed'} · banner: ${result.manifest.banner?.state ?? 'not listed'}`,
111
+ '',
112
+ directory,
113
+ ];
114
+ for (const { tab, error } of result.tabErrors)
115
+ lines.push(`The ${tab} tab could not be listed (${error}).`);
116
+ if (result.failed > 0)
117
+ lines.push('Call fetch_channel_thumbnails again to retry the failures.');
118
+ if (result.stopReason !== undefined) {
119
+ lines.push('', `Stopped early: ${result.stopReason}`, 'Call fetch_channel_thumbnails again to continue.');
120
+ }
121
+ return lines.join('\n');
122
+ }
123
+ //# sourceMappingURL=fetch-channel-thumbnails.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fetch-channel-thumbnails.js","sourceRoot":"","sources":["../../src/tools/fetch-channel-thumbnails.ts"],"names":[],"mappings":"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"}
@@ -20,6 +20,7 @@ export declare const fetchVideosOutputSchema: {
20
20
  channel: z.ZodOptional<z.ZodString>;
21
21
  viewCount: z.ZodOptional<z.ZodNumber>;
22
22
  uploadDate: z.ZodOptional<z.ZodString>;
23
+ thumbnailUrl: z.ZodOptional<z.ZodString>;
23
24
  }, "strip", z.ZodTypeAny, {
24
25
  id: string;
25
26
  title: string;
@@ -29,6 +30,7 @@ export declare const fetchVideosOutputSchema: {
29
30
  channel?: string | undefined;
30
31
  viewCount?: number | undefined;
31
32
  uploadDate?: string | undefined;
33
+ thumbnailUrl?: string | undefined;
32
34
  }, {
33
35
  id: string;
34
36
  title: string;
@@ -38,6 +40,7 @@ export declare const fetchVideosOutputSchema: {
38
40
  channel?: string | undefined;
39
41
  viewCount?: number | undefined;
40
42
  uploadDate?: string | undefined;
43
+ thumbnailUrl?: string | undefined;
41
44
  }>, "many">;
42
45
  };
43
46
  export declare function fetchVideosHandler({ url, limit, }: {
@@ -1 +1 @@
1
- {"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;CAY7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GACN,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CAwB1B"}
1
+ {"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;CAa7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GACN,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CA0B1B"}
@@ -5,6 +5,7 @@ import { paginationShape, videoSummarySchema } from '../schemas.js';
5
5
  export const fetchVideosSchema = {
6
6
  url: z
7
7
  .string()
8
+ .max(2048)
8
9
  .describe('YouTube playlist URL, channel URL, or channel handle (e.g., https://www.youtube.com/@channel)'),
9
10
  limit: z
10
11
  .number()
@@ -36,6 +37,8 @@ export async function fetchVideosHandler({ url, limit, }) {
36
37
  durationFormatted: v.durationFormatted,
37
38
  url: v.url,
38
39
  uploadDate: v.uploadDate,
40
+ ...(v.thumbnailUrl === undefined ? {} : { thumbnailUrl: v.thumbnailUrl }),
41
+ ...(v.viewCount === undefined ? {} : { viewCount: v.viewCount }),
39
42
  })),
40
43
  ...pageInfo(videos.length, videos.length),
41
44
  });
@@ -1 +1 @@
1
- {"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGpE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,+FAA+F,CAChG;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACnC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GAIN;IACC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,WAAW,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClC,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,CAAC,CAAC,QAAQ;YAC3B,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC;QACH,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}
1
+ {"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGpE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CACP,+FAA+F,CAChG;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACnC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GAIN;IACC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,WAAW,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClC,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,CAAC,CAAC,QAAQ;YAC3B,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;YACzE,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;SACjE,CAAC,CAAC;QACH,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,44 @@
1
+ import { z } from 'zod';
2
+ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
3
+ /**
4
+ * Stills and subtitles: the two extraction tools that produce something other
5
+ * than a media clip. Split from clips.ts only for size.
6
+ */
7
+ export declare const extractFrameSchema: {
8
+ video: z.ZodString;
9
+ timestamp: z.ZodString;
10
+ format: z.ZodDefault<z.ZodEnum<["png", "jpg"]>>;
11
+ outputDir: z.ZodOptional<z.ZodString>;
12
+ };
13
+ export declare const extractFrameOutputSchema: {
14
+ videoId: z.ZodString;
15
+ title: z.ZodString;
16
+ filePath: z.ZodString;
17
+ timestampSeconds: z.ZodNumber;
18
+ };
19
+ export declare function extractFrameHandler(args: {
20
+ video: string;
21
+ timestamp: string;
22
+ format: 'png' | 'jpg';
23
+ outputDir?: string;
24
+ }): Promise<CallToolResult>;
25
+ export declare const exportSubtitlesSchema: {
26
+ video: z.ZodString;
27
+ format: z.ZodDefault<z.ZodEnum<["srt", "vtt", "txt"]>>;
28
+ language: z.ZodDefault<z.ZodString>;
29
+ outputDir: z.ZodOptional<z.ZodString>;
30
+ };
31
+ export declare const exportSubtitlesOutputSchema: {
32
+ videoId: z.ZodString;
33
+ language: z.ZodString;
34
+ format: z.ZodEnum<["srt", "vtt", "txt"]>;
35
+ filePath: z.ZodString;
36
+ cueCount: z.ZodNumber;
37
+ };
38
+ export declare function exportSubtitlesHandler(args: {
39
+ video: string;
40
+ format: 'srt' | 'vtt' | 'txt';
41
+ language: string;
42
+ outputDir?: string;
43
+ }): Promise<CallToolResult>;
44
+ //# sourceMappingURL=frames-subtitles.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frames-subtitles.d.ts","sourceRoot":"","sources":["../../src/tools/frames-subtitles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;GAGG;AAIH,eAAO,MAAM,kBAAkB;;;;;CAQ9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;CAKpC,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B1B;AAID,eAAO,MAAM,qBAAqB;;;;;CAajC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;CAMvC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2C1B"}
@@ -0,0 +1,104 @@
1
+ import { z } from 'zod';
2
+ import { join } from 'node:path';
3
+ import { mkdir, writeFile } from 'node:fs/promises';
4
+ import { fileResult } from '../utils/format.js';
5
+ import { parseTimestamp, resolveOutputDir } from '../utils/validate.js';
6
+ import { extractFrame, safeStem, subtitlesDir } from '../utils/clips.js';
7
+ import { getTranscript } from '../utils/youtube.js';
8
+ import { formatTimestamp, segmentsToText, toSrt, toVtt } from '../utils/transcript.js';
9
+ /**
10
+ * Stills and subtitles: the two extraction tools that produce something other
11
+ * than a media clip. Split from clips.ts only for size.
12
+ */
13
+ // -- extract_frame -------------------------------------------------------
14
+ export const extractFrameSchema = {
15
+ video: z.string().describe('YouTube video ID or full URL'),
16
+ timestamp: z.string().describe('When to capture. Seconds, MM:SS or HH:MM:SS.'),
17
+ format: z.enum(['png', 'jpg']).default('png').describe('Image format. Default: png'),
18
+ outputDir: z
19
+ .string()
20
+ .optional()
21
+ .describe('Where to write the image. Must be inside your home directory.'),
22
+ };
23
+ export const extractFrameOutputSchema = {
24
+ videoId: z.string(),
25
+ title: z.string(),
26
+ filePath: z.string(),
27
+ timestampSeconds: z.number(),
28
+ };
29
+ export async function extractFrameHandler(args) {
30
+ const seconds = parseTimestamp(args.timestamp, 'timestamp');
31
+ const result = await extractFrame(args.video, seconds, {
32
+ outputDir: args.outputDir,
33
+ format: args.format,
34
+ });
35
+ return fileResult([
36
+ '✓ Frame captured',
37
+ '',
38
+ result.title,
39
+ `at ${formatTimestamp(result.timestamp)}`,
40
+ '',
41
+ result.filePath,
42
+ ].join('\n'), {
43
+ videoId: result.videoId,
44
+ title: result.title,
45
+ filePath: result.filePath,
46
+ timestampSeconds: result.timestamp,
47
+ }, {
48
+ path: result.filePath,
49
+ name: `${result.title} frame`,
50
+ mimeType: args.format === 'png' ? 'image/png' : 'image/jpeg',
51
+ });
52
+ }
53
+ // -- export_subtitles ----------------------------------------------------
54
+ export const exportSubtitlesSchema = {
55
+ video: z.string().describe('YouTube video ID or full URL'),
56
+ format: z
57
+ .enum(['srt', 'vtt', 'txt'])
58
+ .default('srt')
59
+ .describe('Subtitle format. srt and vtt import into any editor; txt is plain text. Default: srt'),
60
+ language: z.string().default('en').describe('Caption language. Default: en'),
61
+ outputDir: z
62
+ .string()
63
+ .optional()
64
+ .describe('Where to write the file. Must be inside your home directory.'),
65
+ };
66
+ export const exportSubtitlesOutputSchema = {
67
+ videoId: z.string(),
68
+ language: z.string(),
69
+ format: z.enum(['srt', 'vtt', 'txt']),
70
+ filePath: z.string(),
71
+ cueCount: z.number().int(),
72
+ };
73
+ export async function exportSubtitlesHandler(args) {
74
+ // Validate the destination before spending a network round trip on a
75
+ // transcript we would then have nowhere to write.
76
+ const targetDir = resolveOutputDir(args.outputDir, subtitlesDir());
77
+ const transcript = await getTranscript(args.video, { language: args.language });
78
+ const body = args.format === 'srt'
79
+ ? toSrt(transcript.segments)
80
+ : args.format === 'vtt'
81
+ ? toVtt(transcript.segments)
82
+ : segmentsToText(transcript.segments);
83
+ await mkdir(targetDir, { recursive: true });
84
+ const filePath = join(targetDir, `${safeStem(transcript.videoId, transcript.videoId)}.${args.language}.${args.format}`);
85
+ await writeFile(filePath, body, 'utf-8');
86
+ return fileResult([
87
+ `✓ Subtitles exported (${args.format.toUpperCase()})`,
88
+ '',
89
+ `${transcript.segments.length.toLocaleString()} cues · ${transcript.language}`,
90
+ '',
91
+ filePath,
92
+ ].join('\n'), {
93
+ videoId: transcript.videoId,
94
+ language: transcript.language,
95
+ format: args.format,
96
+ filePath,
97
+ cueCount: transcript.segments.length,
98
+ }, {
99
+ path: filePath,
100
+ name: `${transcript.videoId}.${args.format}`,
101
+ mimeType: args.format === 'txt' ? 'text/plain' : `text/${args.format}`,
102
+ });
103
+ }
104
+ //# sourceMappingURL=frames-subtitles.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frames-subtitles.js","sourceRoot":"","sources":["../../src/tools/frames-subtitles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAGvF;;;GAGG;AAEH,2EAA2E;AAE3E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC9E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpF,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;CAC7B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAKzC;IACC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE;QACrD,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,OAAO,UAAU,CACf;QACE,kBAAkB;QAClB,EAAE;QACF,MAAM,CAAC,KAAK;QACZ,MAAM,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;QACzC,EAAE;QACF,MAAM,CAAC,QAAQ;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE,MAAM,CAAC,SAAS;KACnC,EACD;QACE,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,QAAQ;QAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY;KAC7D,CACF,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;SAC3B,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,sFAAsF,CACvF;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC5E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC3B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAK5C;IACC,qEAAqE;IACrE,kDAAkD;IAClD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEhF,MAAM,IAAI,GACR,IAAI,CAAC,MAAM,KAAK,KAAK;QACnB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC5B,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK;YACrB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC5B,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE5C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,IAAI,CACnB,SAAS,EACT,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CACtF,CAAC;IACF,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO,UAAU,CACf;QACE,yBAAyB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG;QACrD,EAAE;QACF,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,UAAU,CAAC,QAAQ,EAAE;QAC9E,EAAE;QACF,QAAQ;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ;QACE,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ;QACR,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;KACrC,EACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,GAAG,UAAU,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE;QAC5C,QAAQ,EAAE,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE;KACvE,CACF,CAAC;AACJ,CAAC"}
@@ -10,6 +10,8 @@ export declare const getChannelInfoOutputSchema: {
10
10
  subscriberCount: z.ZodNumber;
11
11
  channelUrl: z.ZodString;
12
12
  description: z.ZodString;
13
+ avatarUrl: z.ZodOptional<z.ZodString>;
14
+ bannerUrl: z.ZodOptional<z.ZodString>;
13
15
  };
14
16
  export declare function getChannelInfoHandler({ channel, }: {
15
17
  channel: string;
@@ -1 +1 @@
1
- {"version":3,"file":"get-channel-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;CAEhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;CAA0B,CAAC;AAElE,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAgB1B"}
1
+ {"version":3,"file":"get-channel-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;CAKhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;CAA0B,CAAC;AAElE,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1B"}
@@ -3,7 +3,10 @@ import { getChannelInfo } from '../utils/youtube.js';
3
3
  import { formatCount, toolResult } from '../utils/format.js';
4
4
  import { channelInfoSchema } from '../schemas.js';
5
5
  export const getChannelInfoSchema = {
6
- channel: z.string().describe('YouTube channel URL, handle (e.g., @Fireship), or channel name'),
6
+ channel: z
7
+ .string()
8
+ .max(256)
9
+ .describe('YouTube channel URL, handle (e.g., @Fireship), or channel name'),
7
10
  };
8
11
  export const getChannelInfoOutputSchema = channelInfoSchema.shape;
9
12
  export async function getChannelInfoHandler({ channel, }) {
@@ -14,6 +17,10 @@ export async function getChannelInfoHandler({ channel, }) {
14
17
  `${formatCount(info.subscriberCount)} subscribers`,
15
18
  info.channelUrl,
16
19
  ].filter(Boolean);
20
+ if (info.avatarUrl !== undefined)
21
+ lines.push(`Avatar: ${info.avatarUrl}`);
22
+ if (info.bannerUrl !== undefined)
23
+ lines.push(`Banner: ${info.bannerUrl}`);
17
24
  if (info.description) {
18
25
  lines.push('');
19
26
  lines.push(info.description);
@@ -1 +1 @@
1
- {"version":3,"file":"get-channel-info.js","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;CAC/F,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,KAAK,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,OAAO,GAGR;IACC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9B,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;QAClD,IAAI,CAAC,UAAU;KAChB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}
1
+ {"version":3,"file":"get-channel-info.js","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,KAAK,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,OAAO,GAGR;IACC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9B,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;QAClD,IAAI,CAAC,UAAU;KAChB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1E,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAE1E,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"get-playlist-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,qBAAqB;;CAMjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;CAA2B,CAAC;AAEpE,wBAAsB,sBAAsB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB9F"}
1
+ {"version":3,"file":"get-playlist-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,qBAAqB;;CAOjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;CAA2B,CAAC;AAEpE,wBAAsB,sBAAsB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB9F"}
@@ -5,6 +5,7 @@ import { playlistInfoSchema } from '../schemas.js';
5
5
  export const getPlaylistInfoSchema = {
6
6
  url: z
7
7
  .string()
8
+ .max(2048)
8
9
  .describe('YouTube playlist URL (e.g., https://www.youtube.com/playlist?list=PLlrATfBNZ98dudnM48yfGUldqGD0S4FFb)'),
9
10
  };
10
11
  export const getPlaylistInfoOutputSchema = playlistInfoSchema.shape;
@@ -1 +1 @@
1
- {"version":3,"file":"get-playlist-info.js","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,uGAAuG,CACxG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC,KAAK,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAE,GAAG,EAAmB;IACnE,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAExC,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;QACjF,EAAE;QACF,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS;QACxC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7D,IAAI,CAAC,GAAG;KACT,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}
1
+ {"version":3,"file":"get-playlist-info.js","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CACP,uGAAuG,CACxG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC,KAAK,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAE,GAAG,EAAmB;IACnE,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAExC,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;QACjF,EAAE;QACF,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS;QACxC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7D,IAAI,CAAC,GAAG;KACT,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}
@@ -0,0 +1,38 @@
1
+ import { z } from 'zod';
2
+ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
3
+ import { type ThumbnailQuality } from '../thumbnail-schemas.js';
4
+ export declare const getThumbnailSchema: {
5
+ video: z.ZodOptional<z.ZodString>;
6
+ channel: z.ZodOptional<z.ZodString>;
7
+ image: z.ZodDefault<z.ZodEnum<["thumbnail", "avatar", "banner"]>>;
8
+ quality: z.ZodDefault<z.ZodEnum<["best", "listed"]>>;
9
+ };
10
+ export declare const getThumbnailOutputSchema: {
11
+ image: z.ZodEnum<["thumbnail", "avatar", "banner"]>;
12
+ videoId: z.ZodOptional<z.ZodString>;
13
+ channelId: z.ZodOptional<z.ZodString>;
14
+ sourceUrl: z.ZodString;
15
+ variant: z.ZodString;
16
+ mimeType: z.ZodString;
17
+ width: z.ZodNumber;
18
+ height: z.ZodNumber;
19
+ bytes: z.ZodNumber;
20
+ fromDisk: z.ZodBoolean;
21
+ };
22
+ export interface GetThumbnailArgs {
23
+ video?: string;
24
+ channel?: string;
25
+ image: 'thumbnail' | 'avatar' | 'banner';
26
+ quality: ThumbnailQuality;
27
+ }
28
+ /**
29
+ * One image, returned as an MCP image block so the model can look at it.
30
+ *
31
+ * Remote-safe: the image is fetched into memory under a cap and never written.
32
+ * Locally, an image a previous fetch_channel_thumbnails run saved is served
33
+ * from disk instead, so what the model sees is exactly what was stored.
34
+ */
35
+ export declare function getThumbnailHandler(args: GetThumbnailArgs, options?: {
36
+ store: boolean;
37
+ }): Promise<CallToolResult>;
38
+ //# sourceMappingURL=get-thumbnail.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-thumbnail.d.ts","sourceRoot":"","sources":["../../src/tools/get-thumbnail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAUxF,eAAO,MAAM,kBAAkB;;;;;CAe9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAWpC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAYD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAqB,GAC7C,OAAO,CAAC,cAAc,CAAC,CA6BzB"}
@@ -0,0 +1,152 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { z } from 'zod';
3
+ import { thumbnailQualitySchema } from '../thumbnail-schemas.js';
4
+ import { YouTubeError } from '../utils/errors.js';
5
+ import { probeImage } from '../utils/image-dimensions.js';
6
+ import { fetchImage, MAX_INLINE_IMAGE_BYTES } from '../utils/image-fetch.js';
7
+ import { climb, videoRungs } from '../utils/thumbnail-ladder.js';
8
+ import { channelImageFile, entryPath, listThumbnailManifests } from '../utils/thumbnail-store.js';
9
+ import { assertChannelId } from '../utils/validate.js';
10
+ import { extractVideoId, getChannelInfo } from '../utils/youtube.js';
11
+ import { findByChannel } from '../utils/channel-lookup.js';
12
+ export const getThumbnailSchema = {
13
+ video: z
14
+ .string()
15
+ .optional()
16
+ .describe('Video ID or URL. Required unless image is avatar or banner'),
17
+ channel: z
18
+ .string()
19
+ .max(256)
20
+ .optional()
21
+ .describe('Channel URL, @handle or name, for image = avatar or banner'),
22
+ image: z
23
+ .enum(['thumbnail', 'avatar', 'banner'])
24
+ .default('thumbnail')
25
+ .describe("A video's thumbnail, or a channel's avatar or banner. Default: thumbnail"),
26
+ quality: thumbnailQualitySchema.default('best'),
27
+ };
28
+ export const getThumbnailOutputSchema = {
29
+ image: z.enum(['thumbnail', 'avatar', 'banner']),
30
+ videoId: z.string().optional(),
31
+ channelId: z.string().optional(),
32
+ sourceUrl: z.string(),
33
+ variant: z.string(),
34
+ mimeType: z.string(),
35
+ width: z.number().int(),
36
+ height: z.number().int(),
37
+ bytes: z.number().int(),
38
+ fromDisk: z.boolean().describe('True when served from a saved fetch_channel_thumbnails run'),
39
+ };
40
+ /**
41
+ * One image, returned as an MCP image block so the model can look at it.
42
+ *
43
+ * Remote-safe: the image is fetched into memory under a cap and never written.
44
+ * Locally, an image a previous fetch_channel_thumbnails run saved is served
45
+ * from disk instead, so what the model sees is exactly what was stored.
46
+ */
47
+ export async function getThumbnailHandler(args, options = { store: false }) {
48
+ const picture = args.image === 'thumbnail'
49
+ ? await videoPicture(args, options.store)
50
+ : await channelPicture(args, options.store);
51
+ const { bytes, probe, sourceUrl, variant, fromDisk, videoId, channelId } = picture;
52
+ const label = videoId ?? channelId ?? '';
53
+ return {
54
+ content: [
55
+ {
56
+ type: 'text',
57
+ text: `${label} ${args.image}, ${probe.width}x${probe.height} ${probe.format.toUpperCase()}, ${Math.round(bytes.byteLength / 1024)} KB (${variant}${fromDisk ? ', from disk' : ''})`,
58
+ },
59
+ { type: 'image', data: bytes.toString('base64'), mimeType: probe.mimeType },
60
+ ],
61
+ structuredContent: {
62
+ image: args.image,
63
+ ...(videoId === undefined ? {} : { videoId }),
64
+ ...(channelId === undefined ? {} : { channelId }),
65
+ sourceUrl,
66
+ variant,
67
+ mimeType: probe.mimeType,
68
+ width: probe.width,
69
+ height: probe.height,
70
+ bytes: bytes.byteLength,
71
+ fromDisk,
72
+ },
73
+ };
74
+ }
75
+ async function videoPicture(args, store) {
76
+ if (args.video === undefined) {
77
+ throw new YouTubeError('INVALID_INPUT', 'Pass video to fetch a thumbnail.', {
78
+ nextStep: 'Give a video ID or URL, or set image to avatar or banner with a channel.',
79
+ });
80
+ }
81
+ const videoId = extractVideoId(args.video);
82
+ const stored = store ? await storedVideo(videoId) : undefined;
83
+ if (stored !== undefined)
84
+ return stored;
85
+ const climbed = await climb(videoRungs(videoId, undefined, false, args.quality), MAX_INLINE_IMAGE_BYTES);
86
+ return {
87
+ bytes: climbed.bytes,
88
+ probe: climbed.probe,
89
+ sourceUrl: climbed.rung.url,
90
+ variant: climbed.rung.variant,
91
+ fromDisk: false,
92
+ videoId,
93
+ };
94
+ }
95
+ async function channelPicture(args, store) {
96
+ if (args.channel === undefined || args.image === 'thumbnail') {
97
+ throw new YouTubeError('INVALID_INPUT', `Pass channel to fetch a channel ${args.image}.`, {
98
+ nextStep: 'Give a channel URL, @handle or name.',
99
+ });
100
+ }
101
+ const kind = args.image;
102
+ const stored = store ? await storedChannelImage(args.channel, kind) : undefined;
103
+ if (stored !== undefined)
104
+ return stored;
105
+ const info = await getChannelInfo(args.channel);
106
+ const channelId = assertChannelId(info.channelId);
107
+ const url = kind === 'avatar' ? info.avatarUrl : info.bannerUrl;
108
+ if (url === undefined) {
109
+ throw new YouTubeError('NOT_FOUND', `${info.name} lists no ${kind}.`);
110
+ }
111
+ const { bytes } = await fetchImage(url, { maxBytes: MAX_INLINE_IMAGE_BYTES });
112
+ const probe = probeImage(bytes);
113
+ if (probe === undefined)
114
+ throw new YouTubeError('FETCH_FAILED', 'The image could not be read.');
115
+ return { bytes, probe, sourceUrl: url, variant: 'uncropped', fromDisk: false, channelId };
116
+ }
117
+ /** A saved thumbnail for this video in any fetched channel, when there is one. */
118
+ async function storedVideo(videoId) {
119
+ for (const manifest of await listThumbnailManifests()) {
120
+ const entry = manifest.videos[videoId];
121
+ const path = entry === undefined ? undefined : entryPath(manifest.channel.channelId, entry);
122
+ if (entry === undefined || path === undefined)
123
+ continue;
124
+ const picture = await fromDisk(path, entry.sourceUrl ?? '', entry.variant ?? 'saved');
125
+ if (picture !== undefined)
126
+ return { ...picture, videoId };
127
+ }
128
+ return undefined;
129
+ }
130
+ async function storedChannelImage(channel, kind) {
131
+ const [manifest] = findByChannel(await listThumbnailManifests(), channel);
132
+ const image = manifest?.[kind];
133
+ if (manifest === undefined || image === undefined)
134
+ return undefined;
135
+ const path = channelImageFile(manifest.channel.channelId, image);
136
+ if (path === undefined)
137
+ return undefined;
138
+ const picture = await fromDisk(path, image.sourceUrl ?? '', image.variant ?? 'saved');
139
+ return picture === undefined ? undefined : { ...picture, channelId: manifest.channel.channelId };
140
+ }
141
+ async function fromDisk(path, sourceUrl, variant) {
142
+ let bytes;
143
+ try {
144
+ bytes = await readFile(path);
145
+ }
146
+ catch {
147
+ return undefined;
148
+ }
149
+ const probe = probeImage(bytes);
150
+ return probe === undefined ? undefined : { bytes, probe, sourceUrl, variant, fromDisk: true };
151
+ }
152
+ //# sourceMappingURL=get-thumbnail.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"get-thumbnail.js","sourceRoot":"","sources":["../../src/tools/get-thumbnail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAyB,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAmB,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACzE,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACzE,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;SACvC,OAAO,CAAC,WAAW,CAAC;SACpB,QAAQ,CAAC,0EAA0E,CAAC;IACvF,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC;CAChD,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;CAC7F,CAAC;AAmBF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAsB,EACtB,UAA8B,EAAE,KAAK,EAAE,KAAK,EAAE;IAE9C,MAAM,OAAO,GACX,IAAI,CAAC,KAAK,KAAK,WAAW;QACxB,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC;QACzC,CAAC,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACnF,MAAM,KAAK,GAAG,OAAO,IAAI,SAAS,IAAI,EAAE,CAAC;IAEzC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG;aACrL;YACD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;SAC5E;QACD,iBAAiB,EAAE;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;YAC7C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;YACjD,SAAS;YACT,OAAO;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,UAAU;YACvB,QAAQ;SACT;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAsB,EAAE,KAAc;IAChE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,kCAAkC,EAAE;YAC1E,QAAQ,EAAE,0EAA0E;SACrF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,MAAM,OAAO,GAAG,MAAM,KAAK,CACzB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EACnD,sBAAsB,CACvB,CAAC;IACF,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;QAC3B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO;QAC7B,QAAQ,EAAE,KAAK;QACf,OAAO;KACR,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAsB,EAAE,KAAc;IAClE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAC7D,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,mCAAmC,IAAI,CAAC,KAAK,GAAG,EAAE;YACxF,QAAQ,EAAE,sCAAsC;SACjD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;IAExB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IAChE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,aAAa,IAAI,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,YAAY,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAC;IAChG,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC5F,CAAC;AAED,kFAAkF;AAClF,KAAK,UAAU,WAAW,CAAC,OAAe;IACxC,KAAK,MAAM,QAAQ,IAAI,MAAM,sBAAsB,EAAE,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC5F,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACxD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;QACtF,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,OAAe,EACf,IAAyB;IAEzB,MAAM,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,MAAM,sBAAsB,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACpE,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACjE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;IACtF,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;AACnG,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,IAAY,EACZ,SAAiB,EACjB,OAAe;IAEf,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAChG,CAAC"}