@scavio/ai-sdk 0.2.1 → 0.2.2

package/dist/index.cjs

@@ -43,17 +43,35 @@ function trim(res, max) {
   }
   return res;
 }
+function trimList(res, key, max) {
+  const list = res[key];
+  if (Array.isArray(list) && list.length > max) {
+    return { ...res, [key]: list.slice(0, max) };
+  }
+  return res;
+}
 function scavioSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return (0, import_ai.tool)({
-    description: "Search the web with Google via the Scavio API. Returns real-time organic search results.",
+    description: "Search the web with Google via the Scavio API (1 credit). Returns real-time organic search results, each with a title, link, and snippet, under `organic_results`.",
     inputSchema: import_zod.z.object({
       query: import_zod.z.string().describe("The search query."),
-      country_code: import_zod.z.string().optional().describe('Two-letter country code to localize results, e.g. "us".'),
-      language: import_zod.z.string().optional().describe('Two-letter language code, e.g. "en".')
+      countryCode: import_zod.z.string().optional().describe('Two-letter country code to localize results, e.g. "us".'),
+      language: import_zod.z.string().optional().describe('Two-letter UI language code, e.g. "en".'),
+      page: import_zod.z.number().int().optional().describe("1-based result page; page 2 starts at result 10."),
+      device: import_zod.z.enum(["desktop", "mobile"]).optional().describe("Device to emulate."),
+      nfpr: import_zod.z.boolean().optional().describe("Disable spelling auto-correction / similar-result substitution when true.")
     }),
-    execute: async ({ query, country_code, language }) => trim(await c.google.search({ query, country_code, language }), max)
+    execute: async ({ query, countryCode, language, page, device, nfpr }) => {
+      const params = { query };
+      if (countryCode) params.gl = countryCode;
+      if (language) params.hl = language;
+      if (page && page > 1) params.start = (page - 1) * 10;
+      if (device) params.device = device;
+      if (nfpr !== void 0) params.nfpr = nfpr;
+      return trimList(await c.google.search(params), "organic_results", max);
+    }
   });
 }
 function scavioYoutubeSearch(config) {
@@ -112,7 +130,14 @@ function scavioTiktokSearch(config) {
       sort_type: import_zod.z.string().optional().describe("Sort order for results."),
       publish_time: import_zod.z.string().optional().describe("Filter by publish time window.")
     }),
-    execute: async ({ keyword, sort_type, publish_time }) => trim(await c.tiktok.searchVideos({ keyword, sort_type, publish_time }), max)
+    execute: async ({ keyword, sort_type, publish_time }) => trim(
+      await c.tiktok.searchVideos({
+        keyword,
+        sort_type,
+        publish_time
+      }),
+      max
+    )
   });
 }
 function scavioInstagramSearch(config) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { Scavio, type ScavioConfig } from \"scavio\";\n\nexport interface ScavioToolConfig extends ScavioConfig {\n  /** Max number of results to keep in `results`-style lists. Defaults to 10. */\n  maxResults?: number;\n}\n\nfunction client(config?: ScavioToolConfig): Scavio {\n  return new Scavio({ apiKey: config?.apiKey });\n}\n\nfunction trim(res: Record<string, unknown>, max: number): Record<string, unknown> {\n  const results = res.results;\n  if (Array.isArray(results) && results.length > max) {\n    return { ...res, results: results.slice(0, max) };\n  }\n  return res;\n}\n\n/** Google web search. */\nexport function scavioSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description:\n      \"Search the web with Google via the Scavio API. Returns real-time organic search results.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n      country_code: z.string().optional().describe('Two-letter country code to localize results, e.g. \"us\".'),\n      language: z.string().optional().describe('Two-letter language code, e.g. \"en\".'),\n    }),\n    execute: async ({ query, country_code, language }) =>\n      trim(await c.google.search({ query, country_code, language }), max),\n  });\n}\n\n/** YouTube video search. */\nexport function scavioYoutubeSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search YouTube for videos via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n    }),\n    execute: async ({ query }) => trim(await c.youtube.search({ query }), max),\n  });\n}\n\n/** Reddit post/community search (costs 2 credits). */\nexport function scavioRedditSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Reddit posts and communities via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n      sort: z.string().optional().describe(\"Sort order for results.\"),\n    }),\n    execute: async ({ query, sort }) => trim(await c.reddit.search({ query, sort }), max),\n  });\n}\n\n/** Amazon product search. */\nexport function scavioAmazonSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Amazon for products via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The product search query.\"),\n      domain: z.string().optional().describe('Amazon domain, e.g. \"amazon.com\".'),\n    }),\n    execute: async ({ query, domain }) => trim(await c.amazon.search({ query, domain }), max),\n  });\n}\n\n/** Walmart product search. */\nexport function scavioWalmartSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Walmart for products via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The product search query.\"),\n    }),\n    execute: async ({ query }) => trim(await c.walmart.search({ query }), max),\n  });\n}\n\n/** TikTok video search. */\nexport function scavioTiktokSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search TikTok for videos by keyword via the Scavio API.\",\n    inputSchema: z.object({\n      keyword: z.string().describe(\"The search keyword.\"),\n      sort_type: z.string().optional().describe(\"Sort order for results.\"),\n      publish_time: z.string().optional().describe(\"Filter by publish time window.\"),\n    }),\n    execute: async ({ keyword, sort_type, publish_time }) =>\n      trim(await c.tiktok.searchVideos({ keyword, sort_type, publish_time }), max),\n  });\n}\n\n/** Instagram user search. */\nexport function scavioInstagramSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Instagram for users by keyword via the Scavio API.\",\n    inputSchema: z.object({\n      keyword: z.string().describe(\"The search keyword.\"),\n    }),\n    execute: async ({ keyword }) => trim(await c.instagram.searchUsers({ keyword }), max),\n  });\n}\n\n/**\n * All Scavio tools as an object keyed by tool name, ready to spread into the\n * `tools` option of `generateText` / `streamText`.\n */\nexport function scavioTools(config?: ScavioToolConfig) {\n  return {\n    scavio_search: scavioSearch(config),\n    scavio_youtube_search: scavioYoutubeSearch(config),\n    scavio_reddit_search: scavioRedditSearch(config),\n    scavio_amazon_search: scavioAmazonSearch(config),\n    scavio_walmart_search: scavioWalmartSearch(config),\n    scavio_tiktok_search: scavioTiktokSearch(config),\n    scavio_instagram_search: scavioInstagramSearch(config),\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { Scavio, type ScavioConfig, type GoogleSearchOptions } from \"scavio\";\n\nexport interface ScavioToolConfig extends ScavioConfig {\n  /** Max number of results to keep in `results`-style lists. Defaults to 10. */\n  maxResults?: number;\n}\n\nfunction client(config?: ScavioToolConfig): Scavio {\n  return new Scavio({ apiKey: config?.apiKey });\n}\n\nfunction trim(res: Record<string, unknown>, max: number): Record<string, unknown> {\n  const results = res.results;\n  if (Array.isArray(results) && results.length > max) {\n    return { ...res, results: results.slice(0, max) };\n  }\n  return res;\n}\n\nfunction trimList(res: Record<string, unknown>, key: string, max: number): Record<string, unknown> {\n  const list = res[key];\n  if (Array.isArray(list) && list.length > max) {\n    return { ...res, [key]: list.slice(0, max) };\n  }\n  return res;\n}\n\n/** Google web search (/api/v2/google, 1 credit). */\nexport function scavioSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description:\n      \"Search the web with Google via the Scavio API (1 credit). Returns real-time organic search results, each with a title, link, and snippet, under `organic_results`.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n      countryCode: z.string().optional().describe('Two-letter country code to localize results, e.g. \"us\".'),\n      language: z.string().optional().describe('Two-letter UI language code, e.g. \"en\".'),\n      page: z.number().int().optional().describe(\"1-based result page; page 2 starts at result 10.\"),\n      device: z.enum([\"desktop\", \"mobile\"]).optional().describe(\"Device to emulate.\"),\n      nfpr: z.boolean().optional().describe(\"Disable spelling auto-correction / similar-result substitution when true.\"),\n    }),\n    execute: async ({ query, countryCode, language, page, device, nfpr }) => {\n      const params: GoogleSearchOptions = { query };\n      if (countryCode) params.gl = countryCode;\n      if (language) params.hl = language;\n      if (page && page > 1) params.start = (page - 1) * 10;\n      if (device) params.device = device;\n      if (nfpr !== undefined) params.nfpr = nfpr;\n      return trimList(await c.google.search(params), \"organic_results\", max);\n    },\n  });\n}\n\n/** YouTube video search. */\nexport function scavioYoutubeSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search YouTube for videos via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n    }),\n    execute: async ({ query }) => trim(await c.youtube.search({ query }), max),\n  });\n}\n\n/** Reddit post/community search (costs 2 credits). */\nexport function scavioRedditSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Reddit posts and communities via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n      sort: z.string().optional().describe(\"Sort order for results.\"),\n    }),\n    execute: async ({ query, sort }) =>\n      trim(await c.reddit.search({ query, sort } as Parameters<typeof c.reddit.search>[0]), max),\n  });\n}\n\n/** Amazon product search. */\nexport function scavioAmazonSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Amazon for products via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The product search query.\"),\n      domain: z.string().optional().describe('Amazon domain, e.g. \"amazon.com\".'),\n    }),\n    execute: async ({ query, domain }) => trim(await c.amazon.search({ query, domain }), max),\n  });\n}\n\n/** Walmart product search. */\nexport function scavioWalmartSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Walmart for products via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The product search query.\"),\n    }),\n    execute: async ({ query }) => trim(await c.walmart.search({ query }), max),\n  });\n}\n\n/** TikTok video search. */\nexport function scavioTiktokSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search TikTok for videos by keyword via the Scavio API.\",\n    inputSchema: z.object({\n      keyword: z.string().describe(\"The search keyword.\"),\n      sort_type: z.string().optional().describe(\"Sort order for results.\"),\n      publish_time: z.string().optional().describe(\"Filter by publish time window.\"),\n    }),\n    execute: async ({ keyword, sort_type, publish_time }) =>\n      trim(\n        await c.tiktok.searchVideos({\n          keyword,\n          sort_type,\n          publish_time,\n        } as Parameters<typeof c.tiktok.searchVideos>[0]),\n        max,\n      ),\n  });\n}\n\n/** Instagram user search. */\nexport function scavioInstagramSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Instagram for users by keyword via the Scavio API.\",\n    inputSchema: z.object({\n      keyword: z.string().describe(\"The search keyword.\"),\n    }),\n    execute: async ({ keyword }) => trim(await c.instagram.searchUsers({ keyword }), max),\n  });\n}\n\n/**\n * All Scavio tools as an object keyed by tool name, ready to spread into the\n * `tools` option of `generateText` / `streamText`.\n */\nexport function scavioTools(config?: ScavioToolConfig) {\n  return {\n    scavio_search: scavioSearch(config),\n    scavio_youtube_search: scavioYoutubeSearch(config),\n    scavio_reddit_search: scavioRedditSearch(config),\n    scavio_amazon_search: scavioAmazonSearch(config),\n    scavio_walmart_search: scavioWalmartSearch(config),\n    scavio_tiktok_search: scavioTiktokSearch(config),\n    scavio_instagram_search: scavioInstagramSearch(config),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -5,11 +5,14 @@ interface ScavioToolConfig extends ScavioConfig {
     /** Max number of results to keep in `results`-style lists. Defaults to 10. */
     maxResults?: number;
 }
-/** Google web search. */
+/** Google web search (/api/v2/google, 1 credit). */
 declare function scavioSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
-    country_code?: string | undefined;
+    countryCode?: string | undefined;
     language?: string | undefined;
+    page?: number | undefined;
+    device?: "desktop" | "mobile" | undefined;
+    nfpr?: boolean | undefined;
 }, Record<string, unknown>>;
 /** YouTube video search. */
 declare function scavioYoutubeSearch(config?: ScavioToolConfig): ai.Tool<{
@@ -46,8 +49,11 @@ declare function scavioInstagramSearch(config?: ScavioToolConfig): ai.Tool<{
 declare function scavioTools(config?: ScavioToolConfig): {
     scavio_search: ai.Tool<{
         query: string;
-        country_code?: string | undefined;
+        countryCode?: string | undefined;
         language?: string | undefined;
+        page?: number | undefined;
+        device?: "desktop" | "mobile" | undefined;
+        nfpr?: boolean | undefined;
     }, Record<string, unknown>>;
     scavio_youtube_search: ai.Tool<{
         query: string;

package/dist/index.d.ts

@@ -5,11 +5,14 @@ interface ScavioToolConfig extends ScavioConfig {
     /** Max number of results to keep in `results`-style lists. Defaults to 10. */
     maxResults?: number;
 }
-/** Google web search. */
+/** Google web search (/api/v2/google, 1 credit). */
 declare function scavioSearch(config?: ScavioToolConfig): ai.Tool<{
     query: string;
-    country_code?: string | undefined;
+    countryCode?: string | undefined;
     language?: string | undefined;
+    page?: number | undefined;
+    device?: "desktop" | "mobile" | undefined;
+    nfpr?: boolean | undefined;
 }, Record<string, unknown>>;
 /** YouTube video search. */
 declare function scavioYoutubeSearch(config?: ScavioToolConfig): ai.Tool<{
@@ -46,8 +49,11 @@ declare function scavioInstagramSearch(config?: ScavioToolConfig): ai.Tool<{
 declare function scavioTools(config?: ScavioToolConfig): {
     scavio_search: ai.Tool<{
         query: string;
-        country_code?: string | undefined;
+        countryCode?: string | undefined;
         language?: string | undefined;
+        page?: number | undefined;
+        device?: "desktop" | "mobile" | undefined;
+        nfpr?: boolean | undefined;
     }, Record<string, unknown>>;
     scavio_youtube_search: ai.Tool<{
         query: string;

package/dist/index.js

@@ -12,17 +12,35 @@ function trim(res, max) {
   }
   return res;
 }
+function trimList(res, key, max) {
+  const list = res[key];
+  if (Array.isArray(list) && list.length > max) {
+    return { ...res, [key]: list.slice(0, max) };
+  }
+  return res;
+}
 function scavioSearch(config) {
   const c = client(config);
   const max = config?.maxResults ?? 10;
   return tool({
-    description: "Search the web with Google via the Scavio API. Returns real-time organic search results.",
+    description: "Search the web with Google via the Scavio API (1 credit). Returns real-time organic search results, each with a title, link, and snippet, under `organic_results`.",
     inputSchema: z.object({
       query: z.string().describe("The search query."),
-      country_code: z.string().optional().describe('Two-letter country code to localize results, e.g. "us".'),
-      language: z.string().optional().describe('Two-letter language code, e.g. "en".')
+      countryCode: z.string().optional().describe('Two-letter country code to localize results, e.g. "us".'),
+      language: z.string().optional().describe('Two-letter UI language code, e.g. "en".'),
+      page: z.number().int().optional().describe("1-based result page; page 2 starts at result 10."),
+      device: z.enum(["desktop", "mobile"]).optional().describe("Device to emulate."),
+      nfpr: z.boolean().optional().describe("Disable spelling auto-correction / similar-result substitution when true.")
     }),
-    execute: async ({ query, country_code, language }) => trim(await c.google.search({ query, country_code, language }), max)
+    execute: async ({ query, countryCode, language, page, device, nfpr }) => {
+      const params = { query };
+      if (countryCode) params.gl = countryCode;
+      if (language) params.hl = language;
+      if (page && page > 1) params.start = (page - 1) * 10;
+      if (device) params.device = device;
+      if (nfpr !== void 0) params.nfpr = nfpr;
+      return trimList(await c.google.search(params), "organic_results", max);
+    }
   });
 }
 function scavioYoutubeSearch(config) {
@@ -81,7 +99,14 @@ function scavioTiktokSearch(config) {
       sort_type: z.string().optional().describe("Sort order for results."),
       publish_time: z.string().optional().describe("Filter by publish time window.")
     }),
-    execute: async ({ keyword, sort_type, publish_time }) => trim(await c.tiktok.searchVideos({ keyword, sort_type, publish_time }), max)
+    execute: async ({ keyword, sort_type, publish_time }) => trim(
+      await c.tiktok.searchVideos({
+        keyword,
+        sort_type,
+        publish_time
+      }),
+      max
+    )
   });
 }
 function scavioInstagramSearch(config) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { Scavio, type ScavioConfig } from \"scavio\";\n\nexport interface ScavioToolConfig extends ScavioConfig {\n  /** Max number of results to keep in `results`-style lists. Defaults to 10. */\n  maxResults?: number;\n}\n\nfunction client(config?: ScavioToolConfig): Scavio {\n  return new Scavio({ apiKey: config?.apiKey });\n}\n\nfunction trim(res: Record<string, unknown>, max: number): Record<string, unknown> {\n  const results = res.results;\n  if (Array.isArray(results) && results.length > max) {\n    return { ...res, results: results.slice(0, max) };\n  }\n  return res;\n}\n\n/** Google web search. */\nexport function scavioSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description:\n      \"Search the web with Google via the Scavio API. Returns real-time organic search results.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n      country_code: z.string().optional().describe('Two-letter country code to localize results, e.g. \"us\".'),\n      language: z.string().optional().describe('Two-letter language code, e.g. \"en\".'),\n    }),\n    execute: async ({ query, country_code, language }) =>\n      trim(await c.google.search({ query, country_code, language }), max),\n  });\n}\n\n/** YouTube video search. */\nexport function scavioYoutubeSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search YouTube for videos via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n    }),\n    execute: async ({ query }) => trim(await c.youtube.search({ query }), max),\n  });\n}\n\n/** Reddit post/community search (costs 2 credits). */\nexport function scavioRedditSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Reddit posts and communities via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n      sort: z.string().optional().describe(\"Sort order for results.\"),\n    }),\n    execute: async ({ query, sort }) => trim(await c.reddit.search({ query, sort }), max),\n  });\n}\n\n/** Amazon product search. */\nexport function scavioAmazonSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Amazon for products via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The product search query.\"),\n      domain: z.string().optional().describe('Amazon domain, e.g. \"amazon.com\".'),\n    }),\n    execute: async ({ query, domain }) => trim(await c.amazon.search({ query, domain }), max),\n  });\n}\n\n/** Walmart product search. */\nexport function scavioWalmartSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Walmart for products via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The product search query.\"),\n    }),\n    execute: async ({ query }) => trim(await c.walmart.search({ query }), max),\n  });\n}\n\n/** TikTok video search. */\nexport function scavioTiktokSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search TikTok for videos by keyword via the Scavio API.\",\n    inputSchema: z.object({\n      keyword: z.string().describe(\"The search keyword.\"),\n      sort_type: z.string().optional().describe(\"Sort order for results.\"),\n      publish_time: z.string().optional().describe(\"Filter by publish time window.\"),\n    }),\n    execute: async ({ keyword, sort_type, publish_time }) =>\n      trim(await c.tiktok.searchVideos({ keyword, sort_type, publish_time }), max),\n  });\n}\n\n/** Instagram user search. */\nexport function scavioInstagramSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Instagram for users by keyword via the Scavio API.\",\n    inputSchema: z.object({\n      keyword: z.string().describe(\"The search keyword.\"),\n    }),\n    execute: async ({ keyword }) => trim(await c.instagram.searchUsers({ keyword }), max),\n  });\n}\n\n/**\n * All Scavio tools as an object keyed by tool name, ready to spread into the\n * `tools` option of `generateText` / `streamText`.\n */\nexport function scavioTools(config?: ScavioToolConfig) {\n  return {\n    scavio_search: scavioSearch(config),\n    scavio_youtube_search: scavioYoutubeSearch(config),\n    scavio_reddit_search: scavioRedditSearch(config),\n    scavio_amazon_search: scavioAmazonSearch(config),\n    scavio_walmart_search: scavioWalmartSearch(config),\n    scavio_tiktok_search: scavioTiktokSearch(config),\n    scavio_instagram_search: scavioInstagramSearch(config),\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { Scavio, type ScavioConfig, type GoogleSearchOptions } from \"scavio\";\n\nexport interface ScavioToolConfig extends ScavioConfig {\n  /** Max number of results to keep in `results`-style lists. Defaults to 10. */\n  maxResults?: number;\n}\n\nfunction client(config?: ScavioToolConfig): Scavio {\n  return new Scavio({ apiKey: config?.apiKey });\n}\n\nfunction trim(res: Record<string, unknown>, max: number): Record<string, unknown> {\n  const results = res.results;\n  if (Array.isArray(results) && results.length > max) {\n    return { ...res, results: results.slice(0, max) };\n  }\n  return res;\n}\n\nfunction trimList(res: Record<string, unknown>, key: string, max: number): Record<string, unknown> {\n  const list = res[key];\n  if (Array.isArray(list) && list.length > max) {\n    return { ...res, [key]: list.slice(0, max) };\n  }\n  return res;\n}\n\n/** Google web search (/api/v2/google, 1 credit). */\nexport function scavioSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description:\n      \"Search the web with Google via the Scavio API (1 credit). Returns real-time organic search results, each with a title, link, and snippet, under `organic_results`.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n      countryCode: z.string().optional().describe('Two-letter country code to localize results, e.g. \"us\".'),\n      language: z.string().optional().describe('Two-letter UI language code, e.g. \"en\".'),\n      page: z.number().int().optional().describe(\"1-based result page; page 2 starts at result 10.\"),\n      device: z.enum([\"desktop\", \"mobile\"]).optional().describe(\"Device to emulate.\"),\n      nfpr: z.boolean().optional().describe(\"Disable spelling auto-correction / similar-result substitution when true.\"),\n    }),\n    execute: async ({ query, countryCode, language, page, device, nfpr }) => {\n      const params: GoogleSearchOptions = { query };\n      if (countryCode) params.gl = countryCode;\n      if (language) params.hl = language;\n      if (page && page > 1) params.start = (page - 1) * 10;\n      if (device) params.device = device;\n      if (nfpr !== undefined) params.nfpr = nfpr;\n      return trimList(await c.google.search(params), \"organic_results\", max);\n    },\n  });\n}\n\n/** YouTube video search. */\nexport function scavioYoutubeSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search YouTube for videos via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n    }),\n    execute: async ({ query }) => trim(await c.youtube.search({ query }), max),\n  });\n}\n\n/** Reddit post/community search (costs 2 credits). */\nexport function scavioRedditSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Reddit posts and communities via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The search query.\"),\n      sort: z.string().optional().describe(\"Sort order for results.\"),\n    }),\n    execute: async ({ query, sort }) =>\n      trim(await c.reddit.search({ query, sort } as Parameters<typeof c.reddit.search>[0]), max),\n  });\n}\n\n/** Amazon product search. */\nexport function scavioAmazonSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Amazon for products via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The product search query.\"),\n      domain: z.string().optional().describe('Amazon domain, e.g. \"amazon.com\".'),\n    }),\n    execute: async ({ query, domain }) => trim(await c.amazon.search({ query, domain }), max),\n  });\n}\n\n/** Walmart product search. */\nexport function scavioWalmartSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Walmart for products via the Scavio API.\",\n    inputSchema: z.object({\n      query: z.string().describe(\"The product search query.\"),\n    }),\n    execute: async ({ query }) => trim(await c.walmart.search({ query }), max),\n  });\n}\n\n/** TikTok video search. */\nexport function scavioTiktokSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search TikTok for videos by keyword via the Scavio API.\",\n    inputSchema: z.object({\n      keyword: z.string().describe(\"The search keyword.\"),\n      sort_type: z.string().optional().describe(\"Sort order for results.\"),\n      publish_time: z.string().optional().describe(\"Filter by publish time window.\"),\n    }),\n    execute: async ({ keyword, sort_type, publish_time }) =>\n      trim(\n        await c.tiktok.searchVideos({\n          keyword,\n          sort_type,\n          publish_time,\n        } as Parameters<typeof c.tiktok.searchVideos>[0]),\n        max,\n      ),\n  });\n}\n\n/** Instagram user search. */\nexport function scavioInstagramSearch(config?: ScavioToolConfig) {\n  const c = client(config);\n  const max = config?.maxResults ?? 10;\n  return tool({\n    description: \"Search Instagram for users by keyword via the Scavio API.\",\n    inputSchema: z.object({\n      keyword: z.string().describe(\"The search keyword.\"),\n    }),\n    execute: async ({ keyword }) => trim(await c.instagram.searchUsers({ keyword }), max),\n  });\n}\n\n/**\n * All Scavio tools as an object keyed by tool name, ready to spread into the\n * `tools` option of `generateText` / `streamText`.\n */\nexport function scavioTools(config?: ScavioToolConfig) {\n  return {\n    scavio_search: scavioSearch(config),\n    scavio_youtube_search: scavioYoutubeSearch(config),\n    scavio_reddit_search: scavioRedditSearch(config),\n    scavio_amazon_search: scavioAmazonSearch(config),\n    scavio_walmart_search: scavioWalmartSearch(config),\n    scavio_tiktok_search: scavioTiktokSearch(config),\n    scavio_instagram_search: scavioInstagramSearch(config),\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scavio/ai-sdk",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Scavio search tools for the Vercel AI SDK (Google, YouTube, Reddit, Amazon, Walmart, TikTok, Instagram).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -48,12 +48,12 @@
     "zod": ">=3"
   },
   "dependencies": {
-    "scavio": "^0.2.1"
+    "scavio": "^0.5.0"
   },
   "devDependencies": {
     "@ai-sdk/openai": "^3.0.74",
     "ai": "^6.0.208",
-    "scavio": "^0.2.1",
+    "scavio": "^0.5.0",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "^2.0.0",