valyu-js 2.0.0 → 2.1.0

package/README.md

@@ -1,6 +1,6 @@
 # Valyu SDK
 
-**DeepSearch API for AI**
+**Search for AIs**
 
 Valyu's Deepsearch API gives AI the context it needs. Integrate trusted, high-quality public and proprietary sources, with full-text multimodal retrieval.
 
@@ -10,7 +10,7 @@ Get **$10 free credits** for the Valyu API when you sign up at [Valyu](https://p
 
 ## How does it work?
 
-We do all the heavy lifting for you - through a single API we provide:
+We do all the heavy lifting for you - one unified API for all data:
 
 - **Academic & Research Content** - Access millions of scholarly papers and textbooks
 - **Real-time Web Search** - Get the latest information from across the internet  
@@ -36,7 +36,11 @@ const { Valyu } = require('valyu');
 const valyu = new Valyu("your-api-key-here");
 
 const response = await valyu.search(
-  "Implementation details of agentic search-enhanced large reasoning models"
+  "Implementation details of agentic search-enhanced large reasoning models",
+  {
+    maxNumResults: 5,            // Limit to top 5 results
+    maxPrice: 10                  // Maximum price per thousand queries (CPM)
+  }
 );
 
 console.log(response);
@@ -60,9 +64,12 @@ valyu.search(
         relevanceThreshold: 0.5,                 // Minimum relevance score (0-1)
         maxPrice: 30,                            // Maximum price per thousand queries (CPM)
         includedSources: [],                     // Specific sources to search
+        excludeSources: [],                      // Sources/domains to exclude
         category: null,                          // Category filter
         startDate: null,                         // Start date (YYYY-MM-DD)
-        endDate: null                            // End date (YYYY-MM-DD)
+        endDate: null,                           // End date (YYYY-MM-DD)
+        countryCode: null,                       // Country code filter
+        responseLength: null                     // Response length control
     }
 )
 ```
@@ -78,9 +85,12 @@ valyu.search(
 | `relevanceThreshold` | `number` | `0.5` | Minimum relevance score for results (0.0-1.0) |
 | `maxPrice` | `number` | `30` | Maximum price per thousand queries in CPM |
 | `includedSources` | `string[]` | `[]` | Specific data sources or URLs to search |
+| `excludeSources` | `string[]` | `[]` | Data sources or URLs to exclude from search |
 | `category` | `string` | `null` | Category filter for results |
 | `startDate` | `string` | `null` | Start date filter in YYYY-MM-DD format |
 | `endDate` | `string` | `null` | End date filter in YYYY-MM-DD format |
+| `countryCode` | `string` | `null` | Country code filter (e.g., "US", "GB", "JP", "ALL") |
+| `responseLength` | `string \| number` | `null` | Response length: "short", "medium", "large", "max", or character count |
 
 ### Response Format
 
@@ -120,6 +130,67 @@ Each `SearchResult` contains:
 }
 ```
 
+### Contents Method
+
+The `contents()` method extracts clean, structured content from web pages with optional AI-powered data extraction and summarization. It accepts an array of URLs as the first parameter, followed by optional configuration parameters.
+
+```javascript
+valyu.contents(
+    urls,                                        // Array of URLs to process (max 10)
+    {
+        summary: false,                          // AI processing: false, true, string, or JSON schema
+        extractEffort: "normal",                 // Extraction effort: "normal" or "high"
+        responseLength: "short",                 // Content length control
+        maxPriceDollars: null                    // Maximum cost limit in USD
+    }
+)
+```
+
+### Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `urls` | `string[]` | *required* | Array of URLs to process (maximum 10 URLs per request) |
+| `summary` | `boolean \| string \| object` | `false` | AI summary configuration: `false` (raw content), `true` (auto summary), string (custom instructions), or JSON schema (structured extraction) |
+| `extractEffort` | `string` | `"normal"` | Extraction thoroughness: `"normal"` (fast) or `"high"` (more thorough but slower) |
+| `responseLength` | `string \| number` | `"short"` | Content length per URL: `"short"` (25k chars), `"medium"` (50k), `"large"` (100k), `"max"` (no limit), or custom number |
+| `maxPriceDollars` | `number` | `null` | Maximum cost limit in USD |
+
+### Contents Response Format
+
+The contents method returns a `ContentsResponse` object with the following structure:
+
+```javascript
+{
+    success: boolean,                           // Request success status
+    error: string | null,                       // Error message if any
+    tx_id: string,                              // Transaction ID for tracking
+    urls_requested: number,                     // Total URLs requested
+    urls_processed: number,                     // Successfully processed URLs
+    urls_failed: number,                        // Failed URL count
+    results: ContentResult[],                   // Array of processed results
+    total_cost_dollars: number,                 // Actual cost charged
+    total_characters: number                    // Total characters extracted
+}
+```
+
+Each `ContentResult` contains:
+
+```javascript
+{
+    url: string,                                // Source URL
+    title: string,                              // Page/document title
+    content: string | number,                   // Extracted content
+    length: number,                             // Content length in characters
+    source: string,                             // Data source identifier
+    summary?: string | object,                  // AI-generated summary (if enabled)
+    summary_success?: boolean,                  // Whether summary generation succeeded
+    data_type?: string,                         // Type of data extracted
+    image_url?: Record<string, string>,         // Extracted images
+    citation?: string                           // APA-style citation
+}
+```
+
 ## Examples
 
 ### Basic Search
@@ -139,13 +210,12 @@ console.log(`Found ${response.results.length} results`);
 ```javascript
 // Search academic papers on arXiv
 const response = await valyu.search(
-  "agentic search-enhanced large reasoning models",
+  "transformer architecture improvements",
   {
     searchType: "proprietary",
-    maxNumResults: 10,
-    relevanceThreshold: 0.6,
     includedSources: ["valyu/valyu-arxiv"],
-    startDate: "2024-05-01"
+    relevanceThreshold: 0.7,
+    maxNumResults: 10
   }
 );
 ```
@@ -155,13 +225,12 @@ const response = await valyu.search(
 ```javascript
 // Search recent web content
 const response = await valyu.search(
-  "what is claude 4 opus model",
+  "AI safety developments",
   {
     searchType: "web",
-    maxNumResults: 7,
-    relevanceThreshold: 0.5,
     startDate: "2024-01-01",
-    endDate: "2024-12-31"
+    endDate: "2024-12-31",
+    maxNumResults: 5
   }
 );
 ```
@@ -171,13 +240,13 @@ const response = await valyu.search(
 ```javascript
 // Search both web and proprietary sources
 const response = await valyu.search(
-    "quantum computing breakthroughs",
-    {
-        searchType: "all",
-        category: "technology",
-        relevanceThreshold: 0.6,
-        maxPrice: 50
-    }
+  "quantum computing breakthroughs",
+  {
+    searchType: "all",
+    category: "technology",
+    relevanceThreshold: 0.6,
+    maxPrice: 50
+  }
 );
 ```
 
@@ -201,6 +270,94 @@ if (response.success) {
 }
 ```
 
+### Content Extraction Examples
+
+#### Basic Content Extraction
+
+```javascript
+// Extract raw content from URLs
+const response = await valyu.contents(
+  ["https://techcrunch.com/2025/08/28/anthropic-users-face-a-new-choice-opt-out-or-share-your-data-for-ai-training/"]
+);
+
+if (response.success) {
+    response.results.forEach(result => {
+        console.log(`Title: ${result.title}`);
+        console.log(`Content: ${result.content.substring(0, 500)}...`);
+    });
+}
+```
+
+#### Content with AI Summary
+
+```javascript
+// Extract content with automatic summarization
+const response = await valyu.contents(
+  ["https://docs.python.org/3/tutorial/"],
+  {
+    summary: true,
+    responseLength: "max"
+  }
+);
+
+response.results.forEach(result => {
+    console.log(`Summary: ${result.summary}`);
+});
+```
+
+#### Structured Data Extraction
+
+```javascript
+// Extract structured data using JSON schema
+const companySchema = {
+  type: "object",
+  properties: {
+    company_name: { type: "string" },
+    founded_year: { type: "integer" },
+    key_products: {
+      type: "array",
+      items: { type: "string" },
+      maxItems: 3
+    }
+  }
+};
+
+const response = await valyu.contents(
+  ["https://en.wikipedia.org/wiki/OpenAI"],
+  {
+    summary: companySchema,
+    responseLength: "max"
+  }
+);
+
+if (response.success) {
+    response.results.forEach(result => {
+        if (result.summary) {
+            console.log(`Structured data: ${JSON.stringify(result.summary, null, 2)}`);
+        }
+    });
+}
+```
+
+#### Multiple URLs
+
+```javascript
+// Process multiple URLs with a cost limit
+const response = await valyu.contents(
+  [
+    "https://www.valyu.network/",
+    "https://docs.valyu.network/overview",
+    "https://www.valyu.network/blogs/why-ai-agents-and-llms-struggle-with-search-and-data-access"
+  ],
+  {
+    summary: "Provide key takeaways in bullet points, and write in very emphasised singaporean english"
+  }
+);
+
+console.log(`Processed ${response.urls_processed}/${response.urls_requested} URLs`);
+console.log(`Cost: $${response.total_cost_dollars.toFixed(4)}`);
+```
+
 ## Authentication
 
 Set your API key in one of these ways:
@@ -215,14 +372,6 @@ Set your API key in one of these ways:
    const valyu = new Valyu("your-api-key-here");
    ```
 
-3. **Custom base URL** (for staging/testing):
-   ```javascript
-   const valyu = new Valyu(
-       "your-api-key-here",
-       "https://stage.api.valyu.network/v1"
-   );
-   ```
-
 ## Error Handling
 
 The SDK handles errors gracefully and returns structured error responses:
@@ -243,20 +392,45 @@ if (!response.success) {
 
 ## TypeScript Support
 
-The SDK includes full TypeScript support:
+The SDK includes full TypeScript support with type definitions for all parameters:
 
 ```typescript
-import { Valyu, SearchOptions, SearchResponse } from 'valyu';
+import { 
+  Valyu, 
+  SearchOptions, 
+  SearchResponse,
+  ContentsOptions,
+  ContentsResponse,
+  CountryCode, 
+  ResponseLength 
+} from 'valyu';
 
 const valyu = new Valyu("your-api-key");
 
-const options: SearchOptions = {
+// Search API with types
+const searchOptions: SearchOptions = {
     searchType: "proprietary",
     maxNumResults: 10,
-    relevanceThreshold: 0.6
+    relevanceThreshold: 0.6,
+    excludeSources: ["reddit.com", "twitter.com"],
+    countryCode: "US" as CountryCode,
+    responseLength: "medium" as ResponseLength
+};
+
+const searchResponse: SearchResponse = await valyu.search("machine learning", searchOptions);
+
+// Contents API with types
+const contentsOptions: ContentsOptions = {
+    summary: true,
+    extractEffort: "high",
+    responseLength: "medium",
+    maxPriceDollars: 0.10
 };
 
-const response: SearchResponse = await valyu.search("machine learning", options);
+const contentsResponse: ContentsResponse = await valyu.contents(
+    ["https://example.com"],
+    contentsOptions
+);
 ```
 
 ## Backward Compatibility
@@ -287,7 +461,7 @@ const response = await valyu.context(
 
 ## Getting Started
 
-1. Sign up for a free account at [Valyu](https://exchange.valyu.network)
+1. Sign up for a free account at [Valyu](https://platform.valyu.network)
 2. Get your API key from the dashboard  
 3. Install the SDK: `npm install valyu`
 4. Start building with the examples above
@@ -300,10 +474,16 @@ Run the integration tests:
 npm run test:integration
 ```
 
-Run the v2 API examples:
+Run the Search API examples:
+
+```bash
+node examples/search-examples.js
+```
+
+Run the Contents API examples:
 
 ```bash
-node examples/v2-api-examples.js
+node examples/contents-examples.js
 ```
 
 ## Support

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 type SearchType = "web" | "proprietary" | "all";
 type FeedbackSentiment = "very good" | "good" | "bad" | "very bad";
 type DataType = "structured" | "unstructured";
+type CountryCode = "ALL" | "AR" | "AU" | "AT" | "BE" | "BR" | "CA" | "CL" | "DK" | "FI" | "FR" | "DE" | "HK" | "IN" | "ID" | "IT" | "JP" | "KR" | "MY" | "MX" | "NL" | "NZ" | "NO" | "CN" | "PL" | "PT" | "PH" | "RU" | "SA" | "ZA" | "ES" | "SE" | "CH" | "TW" | "TR" | "GB" | "US";
+type ResponseLength = "short" | "medium" | "large" | "max" | number;
 interface SearchResult {
     title: string;
     url: string;
@@ -19,9 +21,12 @@ interface SearchOptions {
     isToolCall?: boolean;
     relevanceThreshold?: number;
     includedSources?: string[];
+    excludeSources?: string[];
     category?: string;
     startDate?: string;
     endDate?: string;
+    countryCode?: CountryCode;
+    responseLength?: ResponseLength;
 }
 interface SearchResponse {
     success: boolean;
@@ -41,6 +46,38 @@ interface FeedbackResponse {
     success: boolean;
     error?: string;
 }
+type ExtractEffort = "normal" | "high";
+type ContentResponseLength = "short" | "medium" | "large" | "max" | number;
+interface ContentsOptions {
+    summary?: boolean | string | object;
+    extractEffort?: ExtractEffort;
+    responseLength?: ContentResponseLength;
+    maxPriceDollars?: number;
+}
+interface ContentResult {
+    url: string;
+    title: string;
+    content: string | number;
+    length: number;
+    source: string;
+    summary?: string | object;
+    summary_success?: boolean;
+    data_type?: string;
+    image_url?: Record<string, string>;
+    citation?: string;
+}
+interface ContentsResponse {
+    success: boolean;
+    error?: string | null;
+    tx_id?: string;
+    urls_requested?: number;
+    urls_processed?: number;
+    urls_failed?: number;
+    results?: ContentResult[];
+    total_cost_dollars?: number;
+    total_characters?: number;
+    isProvisioning?: boolean;
+}
 
 declare class Valyu {
     private baseUrl;
@@ -51,9 +88,35 @@ declare class Valyu {
      */
     private validateDateFormat;
     /**
-     * Search for information using the Valyu API v2
+     * Search for information using the Valyu DeepSearch API
+     * @param query - The search query string
+     * @param options - Search configuration options
+     * @param options.searchType - Type of search: "web", "proprietary", or "all"
+     * @param options.maxNumResults - Maximum number of results (1-20)
+     * @param options.maxPrice - Maximum price per thousand characters (CPM)
+     * @param options.isToolCall - Whether this is a tool call
+     * @param options.relevanceThreshold - Minimum relevance score (0-1)
+     * @param options.includedSources - List of specific sources to include
+     * @param options.excludeSources - List of URLs/domains to exclude from search results
+     * @param options.category - Category filter for search results
+     * @param options.startDate - Start date filter (YYYY-MM-DD format)
+     * @param options.endDate - End date filter (YYYY-MM-DD format)
+     * @param options.countryCode - Country code filter for search results
+     * @param options.responseLength - Response content length: "short"/"medium"/"large"/"max" or integer character count
+     * @returns Promise resolving to search results
      */
     search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Extract content from URLs with optional AI processing
+     * @param urls - Array of URLs to process (max 10)
+     * @param options - Content extraction configuration options
+     * @param options.summary - AI summary configuration: false (raw), true (auto), string (custom), or JSON schema
+     * @param options.extractEffort - Extraction thoroughness: "normal" or "high"
+     * @param options.responseLength - Content length per URL
+     * @param options.maxPriceDollars - Maximum cost limit in USD
+     * @returns Promise resolving to content extraction results
+     */
+    contents(urls: string[], options?: ContentsOptions): Promise<ContentsResponse>;
 }
 
-export { type FeedbackResponse, type FeedbackSentiment, type SearchOptions, type SearchResponse, type SearchType, Valyu };
+export { type ContentResponseLength, type ContentResult, type ContentsOptions, type ContentsResponse, type CountryCode, type ExtractEffort, type FeedbackResponse, type FeedbackSentiment, type ResponseLength, type SearchOptions, type SearchResponse, type SearchType, Valyu };

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 type SearchType = "web" | "proprietary" | "all";
 type FeedbackSentiment = "very good" | "good" | "bad" | "very bad";
 type DataType = "structured" | "unstructured";
+type CountryCode = "ALL" | "AR" | "AU" | "AT" | "BE" | "BR" | "CA" | "CL" | "DK" | "FI" | "FR" | "DE" | "HK" | "IN" | "ID" | "IT" | "JP" | "KR" | "MY" | "MX" | "NL" | "NZ" | "NO" | "CN" | "PL" | "PT" | "PH" | "RU" | "SA" | "ZA" | "ES" | "SE" | "CH" | "TW" | "TR" | "GB" | "US";
+type ResponseLength = "short" | "medium" | "large" | "max" | number;
 interface SearchResult {
     title: string;
     url: string;
@@ -19,9 +21,12 @@ interface SearchOptions {
     isToolCall?: boolean;
     relevanceThreshold?: number;
     includedSources?: string[];
+    excludeSources?: string[];
     category?: string;
     startDate?: string;
     endDate?: string;
+    countryCode?: CountryCode;
+    responseLength?: ResponseLength;
 }
 interface SearchResponse {
     success: boolean;
@@ -41,6 +46,38 @@ interface FeedbackResponse {
     success: boolean;
     error?: string;
 }
+type ExtractEffort = "normal" | "high";
+type ContentResponseLength = "short" | "medium" | "large" | "max" | number;
+interface ContentsOptions {
+    summary?: boolean | string | object;
+    extractEffort?: ExtractEffort;
+    responseLength?: ContentResponseLength;
+    maxPriceDollars?: number;
+}
+interface ContentResult {
+    url: string;
+    title: string;
+    content: string | number;
+    length: number;
+    source: string;
+    summary?: string | object;
+    summary_success?: boolean;
+    data_type?: string;
+    image_url?: Record<string, string>;
+    citation?: string;
+}
+interface ContentsResponse {
+    success: boolean;
+    error?: string | null;
+    tx_id?: string;
+    urls_requested?: number;
+    urls_processed?: number;
+    urls_failed?: number;
+    results?: ContentResult[];
+    total_cost_dollars?: number;
+    total_characters?: number;
+    isProvisioning?: boolean;
+}
 
 declare class Valyu {
     private baseUrl;
@@ -51,9 +88,35 @@ declare class Valyu {
      */
     private validateDateFormat;
     /**
-     * Search for information using the Valyu API v2
+     * Search for information using the Valyu DeepSearch API
+     * @param query - The search query string
+     * @param options - Search configuration options
+     * @param options.searchType - Type of search: "web", "proprietary", or "all"
+     * @param options.maxNumResults - Maximum number of results (1-20)
+     * @param options.maxPrice - Maximum price per thousand characters (CPM)
+     * @param options.isToolCall - Whether this is a tool call
+     * @param options.relevanceThreshold - Minimum relevance score (0-1)
+     * @param options.includedSources - List of specific sources to include
+     * @param options.excludeSources - List of URLs/domains to exclude from search results
+     * @param options.category - Category filter for search results
+     * @param options.startDate - Start date filter (YYYY-MM-DD format)
+     * @param options.endDate - End date filter (YYYY-MM-DD format)
+     * @param options.countryCode - Country code filter for search results
+     * @param options.responseLength - Response content length: "short"/"medium"/"large"/"max" or integer character count
+     * @returns Promise resolving to search results
      */
     search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Extract content from URLs with optional AI processing
+     * @param urls - Array of URLs to process (max 10)
+     * @param options - Content extraction configuration options
+     * @param options.summary - AI summary configuration: false (raw), true (auto), string (custom), or JSON schema
+     * @param options.extractEffort - Extraction thoroughness: "normal" or "high"
+     * @param options.responseLength - Content length per URL
+     * @param options.maxPriceDollars - Maximum cost limit in USD
+     * @returns Promise resolving to content extraction results
+     */
+    contents(urls: string[], options?: ContentsOptions): Promise<ContentsResponse>;
 }
 
-export { type FeedbackResponse, type FeedbackSentiment, type SearchOptions, type SearchResponse, type SearchType, Valyu };
+export { type ContentResponseLength, type ContentResult, type ContentsOptions, type ContentsResponse, type CountryCode, type ExtractEffort, type FeedbackResponse, type FeedbackSentiment, type ResponseLength, type SearchOptions, type SearchResponse, type SearchType, Valyu };

package/dist/index.js

@@ -60,7 +60,22 @@ var Valyu = class {
     return parsedDate instanceof Date && !isNaN(parsedDate.getTime());
   }
   /**
-   * Search for information using the Valyu API v2
+   * Search for information using the Valyu DeepSearch API
+   * @param query - The search query string
+   * @param options - Search configuration options
+   * @param options.searchType - Type of search: "web", "proprietary", or "all"
+   * @param options.maxNumResults - Maximum number of results (1-20)
+   * @param options.maxPrice - Maximum price per thousand characters (CPM)
+   * @param options.isToolCall - Whether this is a tool call
+   * @param options.relevanceThreshold - Minimum relevance score (0-1)
+   * @param options.includedSources - List of specific sources to include
+   * @param options.excludeSources - List of URLs/domains to exclude from search results
+   * @param options.category - Category filter for search results
+   * @param options.startDate - Start date filter (YYYY-MM-DD format)
+   * @param options.endDate - End date filter (YYYY-MM-DD format)
+   * @param options.countryCode - Country code filter for search results
+   * @param options.responseLength - Response content length: "short"/"medium"/"large"/"max" or integer character count
+   * @returns Promise resolving to search results
    */
   async search(query, options = {}) {
     try {
@@ -137,6 +152,9 @@ var Valyu = class {
       if (options.includedSources !== void 0) {
         payload.included_sources = options.includedSources;
       }
+      if (options.excludeSources !== void 0) {
+        payload.exclude_sources = options.excludeSources;
+      }
       if (options.category !== void 0) {
         payload.category = options.category;
       }
@@ -146,6 +164,12 @@ var Valyu = class {
       if (options.endDate !== void 0) {
         payload.end_date = options.endDate;
       }
+      if (options.countryCode !== void 0) {
+        payload.country_code = options.countryCode;
+      }
+      if (options.responseLength !== void 0) {
+        payload.response_length = options.responseLength;
+      }
       const response = await import_axios.default.post(
         `${this.baseUrl}/deepsearch`,
         payload,
@@ -179,6 +203,139 @@ var Valyu = class {
       };
     }
   }
+  /**
+   * Extract content from URLs with optional AI processing
+   * @param urls - Array of URLs to process (max 10)
+   * @param options - Content extraction configuration options
+   * @param options.summary - AI summary configuration: false (raw), true (auto), string (custom), or JSON schema
+   * @param options.extractEffort - Extraction thoroughness: "normal" or "high"
+   * @param options.responseLength - Content length per URL
+   * @param options.maxPriceDollars - Maximum cost limit in USD
+   * @returns Promise resolving to content extraction results
+   */
+  async contents(urls, options = {}) {
+    try {
+      if (!urls || !Array.isArray(urls)) {
+        return {
+          success: false,
+          error: "urls must be an array",
+          urls_requested: 0,
+          urls_processed: 0,
+          urls_failed: 0,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (urls.length === 0) {
+        return {
+          success: false,
+          error: "urls array cannot be empty",
+          urls_requested: 0,
+          urls_processed: 0,
+          urls_failed: 0,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (urls.length > 10) {
+        return {
+          success: false,
+          error: "Maximum 10 URLs allowed per request",
+          urls_requested: urls.length,
+          urls_processed: 0,
+          urls_failed: urls.length,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (options.extractEffort && !["normal", "high"].includes(options.extractEffort)) {
+        return {
+          success: false,
+          error: "extractEffort must be 'normal' or 'high'",
+          urls_requested: urls.length,
+          urls_processed: 0,
+          urls_failed: urls.length,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (options.responseLength !== void 0) {
+        const validLengths = ["short", "medium", "large", "max"];
+        if (typeof options.responseLength === "string" && !validLengths.includes(options.responseLength)) {
+          return {
+            success: false,
+            error: "responseLength must be 'short', 'medium', 'large', 'max', or a number",
+            urls_requested: urls.length,
+            urls_processed: 0,
+            urls_failed: urls.length,
+            results: [],
+            total_cost_dollars: 0,
+            total_characters: 0
+          };
+        }
+        if (typeof options.responseLength === "number" && options.responseLength <= 0) {
+          return {
+            success: false,
+            error: "responseLength number must be positive",
+            urls_requested: urls.length,
+            urls_processed: 0,
+            urls_failed: urls.length,
+            results: [],
+            total_cost_dollars: 0,
+            total_characters: 0
+          };
+        }
+      }
+      const payload = {
+        urls
+      };
+      if (options.summary !== void 0) {
+        payload.summary = options.summary;
+      }
+      if (options.extractEffort !== void 0) {
+        payload.extract_effort = options.extractEffort;
+      }
+      if (options.responseLength !== void 0) {
+        payload.response_length = options.responseLength;
+      }
+      if (options.maxPriceDollars !== void 0) {
+        payload.max_price_dollars = options.maxPriceDollars;
+      }
+      const response = await import_axios.default.post(
+        `${this.baseUrl}/contents`,
+        payload,
+        { headers: this.headers }
+      );
+      if (!response.status || response.status < 200 || response.status >= 300) {
+        return {
+          success: false,
+          error: response.data?.error || "Request failed",
+          urls_requested: urls.length,
+          urls_processed: 0,
+          urls_failed: urls.length,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      return response.data;
+    } catch (e) {
+      return {
+        success: false,
+        error: e.response?.data?.error || e.message,
+        urls_requested: urls.length,
+        urls_processed: 0,
+        urls_failed: urls.length,
+        results: [],
+        total_cost_dollars: 0,
+        total_characters: 0
+      };
+    }
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, SearchOptions } from './types';\n\nexport class Valyu {\n  private baseUrl: string;\n  private headers: Record<string, string>;\n\n  constructor(apiKey?: string, baseUrl: string = \"https://api.valyu.network/v1\") {\n    if (!apiKey) {\n      apiKey = process.env.VALYU_API_KEY;\n      if (!apiKey) {\n        throw new Error(\"VALYU_API_KEY is not set\");\n      }\n    }\n    this.baseUrl = baseUrl;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey\n    };\n  }\n\n  /**\n   * Validates date format (YYYY-MM-DD)\n   */\n  private validateDateFormat(date: string): boolean {\n    const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n    if (!dateRegex.test(date)) {\n      return false;\n    }\n    const parsedDate = new Date(date);\n    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());\n  }\n\n  /**\n   * Search for information using the Valyu API v2\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n    try {\n      // Default values for v2 API\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultIsToolCall = true;\n      const defaultRelevanceThreshold = 0.5;\n      const defaultMaxPrice = 30;\n\n      // Validate searchType\n      let finalSearchType: SearchType = defaultSearchType;\n      const providedSearchTypeString = options.searchType?.toLowerCase();\n\n      if (providedSearchTypeString === \"web\" || providedSearchTypeString === \"proprietary\" || providedSearchTypeString === \"all\") {\n        finalSearchType = providedSearchTypeString as SearchType;\n      } else if (options.searchType !== undefined) {\n        return {\n          success: false,\n          error: \"Invalid searchType provided. Must be one of: all, web, proprietary\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate date formats\n      if (options.startDate && !this.validateDateFormat(options.startDate)) {\n        return {\n          success: false,\n          error: \"Invalid startDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      if (options.endDate && !this.validateDateFormat(options.endDate)) {\n        return {\n          success: false,\n          error: \"Invalid endDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate maxNumResults range\n      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;\n      if (maxNumResults < 1 || maxNumResults > 20) {\n        return {\n          success: false,\n          error: \"maxNumResults must be between 1 and 20\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: maxNumResults,\n        is_tool_call: options.isToolCall ?? defaultIsToolCall,\n        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      // Add optional parameters only if provided\n      if (options.includedSources !== undefined) {\n        payload.included_sources = options.includedSources;\n      }\n\n      if (options.category !== undefined) {\n        payload.category = options.category;\n      }\n\n      if (options.startDate !== undefined) {\n        payload.start_date = options.startDate;\n      }\n\n      if (options.endDate !== undefined) {\n        payload.end_date = options.endDate;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/deepsearch`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error,\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        tx_id: null,\n        query,\n        results: [],\n        results_by_source: { web: 0, proprietary: 0 },\n        total_deduction_pcm: 0.0,\n        total_deduction_dollars: 0.0,\n        total_characters: 0\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse,\n  SearchOptions\n} from './types'; "],"mappings":"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","names":["axios"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, SearchOptions, ContentsOptions, ContentsResponse } from './types';\n\nexport class Valyu {\n  private baseUrl: string;\n  private headers: Record<string, string>;\n\n  constructor(apiKey?: string, baseUrl: string = \"https://api.valyu.network/v1\") {\n    if (!apiKey) {\n      apiKey = process.env.VALYU_API_KEY;\n      if (!apiKey) {\n        throw new Error(\"VALYU_API_KEY is not set\");\n      }\n    }\n    this.baseUrl = baseUrl;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey\n    };\n  }\n\n  /**\n   * Validates date format (YYYY-MM-DD)\n   */\n  private validateDateFormat(date: string): boolean {\n    const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n    if (!dateRegex.test(date)) {\n      return false;\n    }\n    const parsedDate = new Date(date);\n    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());\n  }\n\n  /**\n   * Search for information using the Valyu DeepSearch API\n   * @param query - The search query string\n   * @param options - Search configuration options\n   * @param options.searchType - Type of search: \"web\", \"proprietary\", or \"all\"\n   * @param options.maxNumResults - Maximum number of results (1-20)\n   * @param options.maxPrice - Maximum price per thousand characters (CPM)\n   * @param options.isToolCall - Whether this is a tool call\n   * @param options.relevanceThreshold - Minimum relevance score (0-1)\n   * @param options.includedSources - List of specific sources to include\n   * @param options.excludeSources - List of URLs/domains to exclude from search results\n   * @param options.category - Category filter for search results\n   * @param options.startDate - Start date filter (YYYY-MM-DD format)\n   * @param options.endDate - End date filter (YYYY-MM-DD format)\n   * @param options.countryCode - Country code filter for search results\n   * @param options.responseLength - Response content length: \"short\"/\"medium\"/\"large\"/\"max\" or integer character count\n   * @returns Promise resolving to search results\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n    try {\n      // Default values\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultIsToolCall = true;\n      const defaultRelevanceThreshold = 0.5;\n      const defaultMaxPrice = 30;\n\n      // Validate searchType\n      let finalSearchType: SearchType = defaultSearchType;\n      const providedSearchTypeString = options.searchType?.toLowerCase();\n\n      if (providedSearchTypeString === \"web\" || providedSearchTypeString === \"proprietary\" || providedSearchTypeString === \"all\") {\n        finalSearchType = providedSearchTypeString as SearchType;\n      } else if (options.searchType !== undefined) {\n        return {\n          success: false,\n          error: \"Invalid searchType provided. Must be one of: all, web, proprietary\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate date formats\n      if (options.startDate && !this.validateDateFormat(options.startDate)) {\n        return {\n          success: false,\n          error: \"Invalid startDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      if (options.endDate && !this.validateDateFormat(options.endDate)) {\n        return {\n          success: false,\n          error: \"Invalid endDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate maxNumResults range\n      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;\n      if (maxNumResults < 1 || maxNumResults > 20) {\n        return {\n          success: false,\n          error: \"maxNumResults must be between 1 and 20\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: maxNumResults,\n        is_tool_call: options.isToolCall ?? defaultIsToolCall,\n        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      // Add optional parameters only if provided\n      if (options.includedSources !== undefined) {\n        payload.included_sources = options.includedSources;\n      }\n\n      if (options.excludeSources !== undefined) {\n        payload.exclude_sources = options.excludeSources;\n      }\n\n      if (options.category !== undefined) {\n        payload.category = options.category;\n      }\n\n      if (options.startDate !== undefined) {\n        payload.start_date = options.startDate;\n      }\n\n      if (options.endDate !== undefined) {\n        payload.end_date = options.endDate;\n      }\n\n      if (options.countryCode !== undefined) {\n        payload.country_code = options.countryCode;\n      }\n\n      if (options.responseLength !== undefined) {\n        payload.response_length = options.responseLength;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/deepsearch`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error,\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        tx_id: null,\n        query,\n        results: [],\n        results_by_source: { web: 0, proprietary: 0 },\n        total_deduction_pcm: 0.0,\n        total_deduction_dollars: 0.0,\n        total_characters: 0\n      };\n    }\n  }\n\n  /**\n   * Extract content from URLs with optional AI processing\n   * @param urls - Array of URLs to process (max 10)\n   * @param options - Content extraction configuration options\n   * @param options.summary - AI summary configuration: false (raw), true (auto), string (custom), or JSON schema\n   * @param options.extractEffort - Extraction thoroughness: \"normal\" or \"high\"\n   * @param options.responseLength - Content length per URL\n   * @param options.maxPriceDollars - Maximum cost limit in USD\n   * @returns Promise resolving to content extraction results\n   */\n  async contents(urls: string[], options: ContentsOptions = {}): Promise<ContentsResponse> {\n    try {\n      // Validate URLs array\n      if (!urls || !Array.isArray(urls)) {\n        return {\n          success: false,\n          error: \"urls must be an array\",\n          urls_requested: 0,\n          urls_processed: 0,\n          urls_failed: 0,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      if (urls.length === 0) {\n        return {\n          success: false,\n          error: \"urls array cannot be empty\",\n          urls_requested: 0,\n          urls_processed: 0,\n          urls_failed: 0,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      if (urls.length > 10) {\n        return {\n          success: false,\n          error: \"Maximum 10 URLs allowed per request\",\n          urls_requested: urls.length,\n          urls_processed: 0,\n          urls_failed: urls.length,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      // Validate extractEffort if provided\n      if (options.extractEffort && ![\"normal\", \"high\"].includes(options.extractEffort)) {\n        return {\n          success: false,\n          error: \"extractEffort must be 'normal' or 'high'\",\n          urls_requested: urls.length,\n          urls_processed: 0,\n          urls_failed: urls.length,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      // Validate responseLength if provided\n      if (options.responseLength !== undefined) {\n        const validLengths = [\"short\", \"medium\", \"large\", \"max\"];\n        if (typeof options.responseLength === \"string\" && !validLengths.includes(options.responseLength)) {\n          return {\n            success: false,\n            error: \"responseLength must be 'short', 'medium', 'large', 'max', or a number\",\n            urls_requested: urls.length,\n            urls_processed: 0,\n            urls_failed: urls.length,\n            results: [],\n            total_cost_dollars: 0,\n            total_characters: 0\n          };\n        }\n        if (typeof options.responseLength === \"number\" && options.responseLength <= 0) {\n          return {\n            success: false,\n            error: \"responseLength number must be positive\",\n            urls_requested: urls.length,\n            urls_processed: 0,\n            urls_failed: urls.length,\n            results: [],\n            total_cost_dollars: 0,\n            total_characters: 0\n          };\n        }\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        urls\n      };\n\n      // Add optional parameters only if provided\n      if (options.summary !== undefined) {\n        payload.summary = options.summary;\n      }\n\n      if (options.extractEffort !== undefined) {\n        payload.extract_effort = options.extractEffort;\n      }\n\n      if (options.responseLength !== undefined) {\n        payload.response_length = options.responseLength;\n      }\n\n      if (options.maxPriceDollars !== undefined) {\n        payload.max_price_dollars = options.maxPriceDollars;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/contents`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error || \"Request failed\",\n          urls_requested: urls.length,\n          urls_processed: 0,\n          urls_failed: urls.length,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        urls_requested: urls.length,\n        urls_processed: 0,\n        urls_failed: urls.length,\n        results: [],\n        total_cost_dollars: 0,\n        total_characters: 0\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse,\n  SearchOptions,\n  CountryCode,\n  ResponseLength,\n  ContentsOptions,\n  ContentsResponse,\n  ContentResult,\n  ExtractEffort,\n  ContentResponseLength\n} from './types'; "],"mappings":"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","names":["axios"]}

package/dist/index.mjs

@@ -26,7 +26,22 @@ var Valyu = class {
     return parsedDate instanceof Date && !isNaN(parsedDate.getTime());
   }
   /**
-   * Search for information using the Valyu API v2
+   * Search for information using the Valyu DeepSearch API
+   * @param query - The search query string
+   * @param options - Search configuration options
+   * @param options.searchType - Type of search: "web", "proprietary", or "all"
+   * @param options.maxNumResults - Maximum number of results (1-20)
+   * @param options.maxPrice - Maximum price per thousand characters (CPM)
+   * @param options.isToolCall - Whether this is a tool call
+   * @param options.relevanceThreshold - Minimum relevance score (0-1)
+   * @param options.includedSources - List of specific sources to include
+   * @param options.excludeSources - List of URLs/domains to exclude from search results
+   * @param options.category - Category filter for search results
+   * @param options.startDate - Start date filter (YYYY-MM-DD format)
+   * @param options.endDate - End date filter (YYYY-MM-DD format)
+   * @param options.countryCode - Country code filter for search results
+   * @param options.responseLength - Response content length: "short"/"medium"/"large"/"max" or integer character count
+   * @returns Promise resolving to search results
    */
   async search(query, options = {}) {
     try {
@@ -103,6 +118,9 @@ var Valyu = class {
       if (options.includedSources !== void 0) {
         payload.included_sources = options.includedSources;
       }
+      if (options.excludeSources !== void 0) {
+        payload.exclude_sources = options.excludeSources;
+      }
       if (options.category !== void 0) {
         payload.category = options.category;
       }
@@ -112,6 +130,12 @@ var Valyu = class {
       if (options.endDate !== void 0) {
         payload.end_date = options.endDate;
       }
+      if (options.countryCode !== void 0) {
+        payload.country_code = options.countryCode;
+      }
+      if (options.responseLength !== void 0) {
+        payload.response_length = options.responseLength;
+      }
       const response = await axios.post(
         `${this.baseUrl}/deepsearch`,
         payload,
@@ -145,6 +169,139 @@ var Valyu = class {
       };
     }
   }
+  /**
+   * Extract content from URLs with optional AI processing
+   * @param urls - Array of URLs to process (max 10)
+   * @param options - Content extraction configuration options
+   * @param options.summary - AI summary configuration: false (raw), true (auto), string (custom), or JSON schema
+   * @param options.extractEffort - Extraction thoroughness: "normal" or "high"
+   * @param options.responseLength - Content length per URL
+   * @param options.maxPriceDollars - Maximum cost limit in USD
+   * @returns Promise resolving to content extraction results
+   */
+  async contents(urls, options = {}) {
+    try {
+      if (!urls || !Array.isArray(urls)) {
+        return {
+          success: false,
+          error: "urls must be an array",
+          urls_requested: 0,
+          urls_processed: 0,
+          urls_failed: 0,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (urls.length === 0) {
+        return {
+          success: false,
+          error: "urls array cannot be empty",
+          urls_requested: 0,
+          urls_processed: 0,
+          urls_failed: 0,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (urls.length > 10) {
+        return {
+          success: false,
+          error: "Maximum 10 URLs allowed per request",
+          urls_requested: urls.length,
+          urls_processed: 0,
+          urls_failed: urls.length,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (options.extractEffort && !["normal", "high"].includes(options.extractEffort)) {
+        return {
+          success: false,
+          error: "extractEffort must be 'normal' or 'high'",
+          urls_requested: urls.length,
+          urls_processed: 0,
+          urls_failed: urls.length,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (options.responseLength !== void 0) {
+        const validLengths = ["short", "medium", "large", "max"];
+        if (typeof options.responseLength === "string" && !validLengths.includes(options.responseLength)) {
+          return {
+            success: false,
+            error: "responseLength must be 'short', 'medium', 'large', 'max', or a number",
+            urls_requested: urls.length,
+            urls_processed: 0,
+            urls_failed: urls.length,
+            results: [],
+            total_cost_dollars: 0,
+            total_characters: 0
+          };
+        }
+        if (typeof options.responseLength === "number" && options.responseLength <= 0) {
+          return {
+            success: false,
+            error: "responseLength number must be positive",
+            urls_requested: urls.length,
+            urls_processed: 0,
+            urls_failed: urls.length,
+            results: [],
+            total_cost_dollars: 0,
+            total_characters: 0
+          };
+        }
+      }
+      const payload = {
+        urls
+      };
+      if (options.summary !== void 0) {
+        payload.summary = options.summary;
+      }
+      if (options.extractEffort !== void 0) {
+        payload.extract_effort = options.extractEffort;
+      }
+      if (options.responseLength !== void 0) {
+        payload.response_length = options.responseLength;
+      }
+      if (options.maxPriceDollars !== void 0) {
+        payload.max_price_dollars = options.maxPriceDollars;
+      }
+      const response = await axios.post(
+        `${this.baseUrl}/contents`,
+        payload,
+        { headers: this.headers }
+      );
+      if (!response.status || response.status < 200 || response.status >= 300) {
+        return {
+          success: false,
+          error: response.data?.error || "Request failed",
+          urls_requested: urls.length,
+          urls_processed: 0,
+          urls_failed: urls.length,
+          results: [],
+          total_cost_dollars: 0,
+          total_characters: 0
+        };
+      }
+      return response.data;
+    } catch (e) {
+      return {
+        success: false,
+        error: e.response?.data?.error || e.message,
+        urls_requested: urls.length,
+        urls_processed: 0,
+        urls_failed: urls.length,
+        results: [],
+        total_cost_dollars: 0,
+        total_characters: 0
+      };
+    }
+  }
 };
 export {
   Valyu

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, SearchOptions } from './types';\n\nexport class Valyu {\n  private baseUrl: string;\n  private headers: Record<string, string>;\n\n  constructor(apiKey?: string, baseUrl: string = \"https://api.valyu.network/v1\") {\n    if (!apiKey) {\n      apiKey = process.env.VALYU_API_KEY;\n      if (!apiKey) {\n        throw new Error(\"VALYU_API_KEY is not set\");\n      }\n    }\n    this.baseUrl = baseUrl;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey\n    };\n  }\n\n  /**\n   * Validates date format (YYYY-MM-DD)\n   */\n  private validateDateFormat(date: string): boolean {\n    const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n    if (!dateRegex.test(date)) {\n      return false;\n    }\n    const parsedDate = new Date(date);\n    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());\n  }\n\n  /**\n   * Search for information using the Valyu API v2\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n    try {\n      // Default values for v2 API\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultIsToolCall = true;\n      const defaultRelevanceThreshold = 0.5;\n      const defaultMaxPrice = 30;\n\n      // Validate searchType\n      let finalSearchType: SearchType = defaultSearchType;\n      const providedSearchTypeString = options.searchType?.toLowerCase();\n\n      if (providedSearchTypeString === \"web\" || providedSearchTypeString === \"proprietary\" || providedSearchTypeString === \"all\") {\n        finalSearchType = providedSearchTypeString as SearchType;\n      } else if (options.searchType !== undefined) {\n        return {\n          success: false,\n          error: \"Invalid searchType provided. Must be one of: all, web, proprietary\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate date formats\n      if (options.startDate && !this.validateDateFormat(options.startDate)) {\n        return {\n          success: false,\n          error: \"Invalid startDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      if (options.endDate && !this.validateDateFormat(options.endDate)) {\n        return {\n          success: false,\n          error: \"Invalid endDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate maxNumResults range\n      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;\n      if (maxNumResults < 1 || maxNumResults > 20) {\n        return {\n          success: false,\n          error: \"maxNumResults must be between 1 and 20\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: maxNumResults,\n        is_tool_call: options.isToolCall ?? defaultIsToolCall,\n        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      // Add optional parameters only if provided\n      if (options.includedSources !== undefined) {\n        payload.included_sources = options.includedSources;\n      }\n\n      if (options.category !== undefined) {\n        payload.category = options.category;\n      }\n\n      if (options.startDate !== undefined) {\n        payload.start_date = options.startDate;\n      }\n\n      if (options.endDate !== undefined) {\n        payload.end_date = options.endDate;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/deepsearch`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error,\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        tx_id: null,\n        query,\n        results: [],\n        results_by_source: { web: 0, proprietary: 0 },\n        total_deduction_pcm: 0.0,\n        total_deduction_dollars: 0.0,\n        total_characters: 0\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse,\n  SearchOptions\n} from './types'; "],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, SearchOptions, ContentsOptions, ContentsResponse } from './types';\n\nexport class Valyu {\n  private baseUrl: string;\n  private headers: Record<string, string>;\n\n  constructor(apiKey?: string, baseUrl: string = \"https://api.valyu.network/v1\") {\n    if (!apiKey) {\n      apiKey = process.env.VALYU_API_KEY;\n      if (!apiKey) {\n        throw new Error(\"VALYU_API_KEY is not set\");\n      }\n    }\n    this.baseUrl = baseUrl;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey\n    };\n  }\n\n  /**\n   * Validates date format (YYYY-MM-DD)\n   */\n  private validateDateFormat(date: string): boolean {\n    const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n    if (!dateRegex.test(date)) {\n      return false;\n    }\n    const parsedDate = new Date(date);\n    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());\n  }\n\n  /**\n   * Search for information using the Valyu DeepSearch API\n   * @param query - The search query string\n   * @param options - Search configuration options\n   * @param options.searchType - Type of search: \"web\", \"proprietary\", or \"all\"\n   * @param options.maxNumResults - Maximum number of results (1-20)\n   * @param options.maxPrice - Maximum price per thousand characters (CPM)\n   * @param options.isToolCall - Whether this is a tool call\n   * @param options.relevanceThreshold - Minimum relevance score (0-1)\n   * @param options.includedSources - List of specific sources to include\n   * @param options.excludeSources - List of URLs/domains to exclude from search results\n   * @param options.category - Category filter for search results\n   * @param options.startDate - Start date filter (YYYY-MM-DD format)\n   * @param options.endDate - End date filter (YYYY-MM-DD format)\n   * @param options.countryCode - Country code filter for search results\n   * @param options.responseLength - Response content length: \"short\"/\"medium\"/\"large\"/\"max\" or integer character count\n   * @returns Promise resolving to search results\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n    try {\n      // Default values\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultIsToolCall = true;\n      const defaultRelevanceThreshold = 0.5;\n      const defaultMaxPrice = 30;\n\n      // Validate searchType\n      let finalSearchType: SearchType = defaultSearchType;\n      const providedSearchTypeString = options.searchType?.toLowerCase();\n\n      if (providedSearchTypeString === \"web\" || providedSearchTypeString === \"proprietary\" || providedSearchTypeString === \"all\") {\n        finalSearchType = providedSearchTypeString as SearchType;\n      } else if (options.searchType !== undefined) {\n        return {\n          success: false,\n          error: \"Invalid searchType provided. Must be one of: all, web, proprietary\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate date formats\n      if (options.startDate && !this.validateDateFormat(options.startDate)) {\n        return {\n          success: false,\n          error: \"Invalid startDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      if (options.endDate && !this.validateDateFormat(options.endDate)) {\n        return {\n          success: false,\n          error: \"Invalid endDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate maxNumResults range\n      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;\n      if (maxNumResults < 1 || maxNumResults > 20) {\n        return {\n          success: false,\n          error: \"maxNumResults must be between 1 and 20\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: maxNumResults,\n        is_tool_call: options.isToolCall ?? defaultIsToolCall,\n        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      // Add optional parameters only if provided\n      if (options.includedSources !== undefined) {\n        payload.included_sources = options.includedSources;\n      }\n\n      if (options.excludeSources !== undefined) {\n        payload.exclude_sources = options.excludeSources;\n      }\n\n      if (options.category !== undefined) {\n        payload.category = options.category;\n      }\n\n      if (options.startDate !== undefined) {\n        payload.start_date = options.startDate;\n      }\n\n      if (options.endDate !== undefined) {\n        payload.end_date = options.endDate;\n      }\n\n      if (options.countryCode !== undefined) {\n        payload.country_code = options.countryCode;\n      }\n\n      if (options.responseLength !== undefined) {\n        payload.response_length = options.responseLength;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/deepsearch`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error,\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        tx_id: null,\n        query,\n        results: [],\n        results_by_source: { web: 0, proprietary: 0 },\n        total_deduction_pcm: 0.0,\n        total_deduction_dollars: 0.0,\n        total_characters: 0\n      };\n    }\n  }\n\n  /**\n   * Extract content from URLs with optional AI processing\n   * @param urls - Array of URLs to process (max 10)\n   * @param options - Content extraction configuration options\n   * @param options.summary - AI summary configuration: false (raw), true (auto), string (custom), or JSON schema\n   * @param options.extractEffort - Extraction thoroughness: \"normal\" or \"high\"\n   * @param options.responseLength - Content length per URL\n   * @param options.maxPriceDollars - Maximum cost limit in USD\n   * @returns Promise resolving to content extraction results\n   */\n  async contents(urls: string[], options: ContentsOptions = {}): Promise<ContentsResponse> {\n    try {\n      // Validate URLs array\n      if (!urls || !Array.isArray(urls)) {\n        return {\n          success: false,\n          error: \"urls must be an array\",\n          urls_requested: 0,\n          urls_processed: 0,\n          urls_failed: 0,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      if (urls.length === 0) {\n        return {\n          success: false,\n          error: \"urls array cannot be empty\",\n          urls_requested: 0,\n          urls_processed: 0,\n          urls_failed: 0,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      if (urls.length > 10) {\n        return {\n          success: false,\n          error: \"Maximum 10 URLs allowed per request\",\n          urls_requested: urls.length,\n          urls_processed: 0,\n          urls_failed: urls.length,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      // Validate extractEffort if provided\n      if (options.extractEffort && ![\"normal\", \"high\"].includes(options.extractEffort)) {\n        return {\n          success: false,\n          error: \"extractEffort must be 'normal' or 'high'\",\n          urls_requested: urls.length,\n          urls_processed: 0,\n          urls_failed: urls.length,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      // Validate responseLength if provided\n      if (options.responseLength !== undefined) {\n        const validLengths = [\"short\", \"medium\", \"large\", \"max\"];\n        if (typeof options.responseLength === \"string\" && !validLengths.includes(options.responseLength)) {\n          return {\n            success: false,\n            error: \"responseLength must be 'short', 'medium', 'large', 'max', or a number\",\n            urls_requested: urls.length,\n            urls_processed: 0,\n            urls_failed: urls.length,\n            results: [],\n            total_cost_dollars: 0,\n            total_characters: 0\n          };\n        }\n        if (typeof options.responseLength === \"number\" && options.responseLength <= 0) {\n          return {\n            success: false,\n            error: \"responseLength number must be positive\",\n            urls_requested: urls.length,\n            urls_processed: 0,\n            urls_failed: urls.length,\n            results: [],\n            total_cost_dollars: 0,\n            total_characters: 0\n          };\n        }\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        urls\n      };\n\n      // Add optional parameters only if provided\n      if (options.summary !== undefined) {\n        payload.summary = options.summary;\n      }\n\n      if (options.extractEffort !== undefined) {\n        payload.extract_effort = options.extractEffort;\n      }\n\n      if (options.responseLength !== undefined) {\n        payload.response_length = options.responseLength;\n      }\n\n      if (options.maxPriceDollars !== undefined) {\n        payload.max_price_dollars = options.maxPriceDollars;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/contents`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error || \"Request failed\",\n          urls_requested: urls.length,\n          urls_processed: 0,\n          urls_failed: urls.length,\n          results: [],\n          total_cost_dollars: 0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        urls_requested: urls.length,\n        urls_processed: 0,\n        urls_failed: urls.length,\n        results: [],\n        total_cost_dollars: 0,\n        total_characters: 0\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse,\n  SearchOptions,\n  CountryCode,\n  ResponseLength,\n  ContentsOptions,\n  ContentsResponse,\n  ContentResult,\n  ExtractEffort,\n  ContentResponseLength\n} from './types'; "],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "valyu-js",
-    "version": "2.0.0",
-    "description": "DeepSearch API for AI.",
+    "version": "2.1.0",
+    "description": "Search for AIs - DeepSearch and Content API.",
     "files": [
         "dist"
     ],
@@ -31,7 +31,10 @@
         "ai",
         "sdk",
         "rag",
-        "valyu"
+        "valyu",
+        "search",
+        "content-extraction",
+        "deepsearch"
     ],
     "author": "Valyu",
     "license": "MIT",