@triplef/agent 0.1.5 → 0.1.6

package/dist/tools/index.mjs

@@ -518,7 +518,7 @@ function extractYoutubeVideoId(url) {
 }
 function buildYoutubeThumbnailUrl(url) {
   const id = extractYoutubeVideoId(url);
-  return id ? `https://i.ytimg.com/vi/${id}/hqdefault.jpg` : void 0;
+  return id ? `https://i.ytimg.com/vi/${id}/maxresdefault.jpg` : void 0;
 }
 
 // src/tools/helpers/localized-query-suffix.helper.ts
@@ -1314,6 +1314,22 @@ var serperVideoSearchSchema = z.object({
   recency: z.enum(["day", "week", "month", "year"]).optional().describe(RECENCY_DESCRIPTION),
   lang: z.string().optional().describe("Two-letter ISO language code for result preference (e.g. en, de, ja)")
 });
+
+// src/tools/helpers/repair-video-link.helper.ts
+var YOUTUBE_LINK_PATTERN = /^https?:\/\/(?:[a-z0-9-]+\.)*youtube\.com\/(?:watch\?v=|shorts\/|embed\/|live\/|v\/|e\/)([A-Za-z0-9_-]{11})(?![A-Za-z0-9_-])/;
+var YOUTU_BE_LINK_PATTERN = /^https?:\/\/youtu\.be\/([A-Za-z0-9_-]{11})(?![A-Za-z0-9_-])/;
+var YOUTUBE_NOCOOKIE_LINK_PATTERN = /^https?:\/\/(?:www\.)?youtube-nocookie\.com\/(?:embed\/|v\/)([A-Za-z0-9_-]{11})(?![A-Za-z0-9_-])/;
+var YOUTUBE_HOST_PATTERN = /^https?:\/\/(?:[a-z0-9-]+\.)*youtube(?:-nocookie)?\.com\/|^https?:\/\/youtu\.be\//;
+var CONTAMINATION_PATTERN = /[\s"'<>\uFFFD]/;
+function repairVideoLink(link) {
+  if (!link) return void 0;
+  const id = YOUTUBE_LINK_PATTERN.exec(link)?.[1] ?? YOUTU_BE_LINK_PATTERN.exec(link)?.[1] ?? YOUTUBE_NOCOOKIE_LINK_PATTERN.exec(link)?.[1];
+  if (id) return `https://www.youtube.com/watch?v=${id}`;
+  if (YOUTUBE_HOST_PATTERN.test(link)) return void 0;
+  return CONTAMINATION_PATTERN.test(link) ? void 0 : link;
+}
+
+// src/tools/serper/video-search.tool.ts
 function createSerperVideoSearch(deps) {
   return tool({
     description: 'Search for videos using Serper.dev. Returns titles, links, channel names, duration, and publish dates. Only return URLs from supported embeddable providers: YouTube, Vimeo, Dailymotion, Loom, Wistia, or direct video files. Reject Instagram, Facebook, TikTok, Twitch, X/Twitter, and other unreliable platforms. Pass recency ("day"|"week"|"month"|"year") to restrict to recently uploaded videos. ' + STANDALONE_QUERY_TOOL_CLAUSE,
@@ -1345,16 +1361,24 @@ function createSerperVideoSearch(deps) {
       if (!res.ok) return { results: [] };
       const data = await res.json();
       if (!data.videos?.length) return { results: [] };
-      const results = data.videos.slice(0, num).map((r) => ({
+      const results = data.videos.flatMap((r) => {
+        const link = repairVideoLink(r.link);
+        return link ? [{ r, link }] : [];
+      }).slice(0, num).map(({ r, link }) => ({
         title: r.title,
-        link: r.link,
+        link,
+        // Keep the provider's original link when it had to be repaired —
+        // auditability for provider-side payload corruption.
+        ...link !== r.link ? { originalLink: r.link } : {},
         snippet: r.snippet || "",
         channel: r.channel || "",
         duration: r.duration || "",
         date: r.date || "",
         // Serper thumbnails are Google proxy images (blocked by our image
         // trust rules) — derive a direct thumbnail for YouTube instead.
-        thumbnailUrl: buildYoutubeThumbnailUrl(r.link) ?? "",
+        // maxresdefault is not guaranteed to exist; consumers degrade to
+        // hqdefault/mqdefault on failure.
+        thumbnailUrl: buildYoutubeThumbnailUrl(link) ?? "",
         source: r.source || "",
         views: r.views ?? 0
       }));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@triplef/agent",
   "description": "tripleF (3F) agent domain — structured-output schemas, prompt builders, and model tools shared across the apps.",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "packageManager": "pnpm@11.24.0",
   "license": "MIT",
   "type": "module",