valyu-js 1.0.7 → 2.0.0

package/README.md

@@ -1,40 +1,319 @@
-# Valyu SDK for Node.js
+# Valyu SDK
 
-Connect your AI applications to high-quality proprietary data with Valyu, an AI context engine built by AI Engineers for AI Engineers.
+**DeepSearch API for AI**
 
-## Why Valyu?
+Valyu's Deepsearch API gives AI the context it needs. Integrate trusted, high-quality public and proprietary sources, with full-text multimodal retrieval.
 
-- **Ready-to-use RAG Data**: All data is returned in Markdown format, optimized for AI consumption.
-- **Multimodal Support**: Retrieve text, images, and other data types for comprehensive answers.
-- **Pay-per-use**: Transparent pricing—you only pay for what you use.
-- **Hybrid Search**: Combine proprietary dataset access with web search capabilities.
-- **Built for AI**: Designed specifically for Retrieval-Augmented Generation (RAG) applications.
+Get **$10 free credits** for the Valyu API when you sign up at [Valyu](https://platform.valyu.network)!
+
+*No credit card required.*
+
+## How does it work?
+
+We do all the heavy lifting for you - through a single API we provide:
+
+- **Academic & Research Content** - Access millions of scholarly papers and textbooks
+- **Real-time Web Search** - Get the latest information from across the internet  
+- **Structured Financial Data** - Stock prices, market data, and financial metrics
+- **Intelligent Reranking** - Results across all sources are automatically sorted by relevance
+- **Transparent Pricing** - Pay only for what you use with clear CPM pricing
 
 ## Installation
 
-Install the Valyu SDK via npm:
+Install the Valyu SDK using npm:
 
 ```bash
 npm install valyu
 ```
 
-Quick Start
-```js
+## Quick Start
+
+Here's what it looks like, make your first query in just 4 lines of code:
+
+```javascript
+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"
+);
+
+console.log(response);
+
+// Feed the results to your AI agent as you would with other search APIs
+```
+
+## API Reference
+
+### Search Method
+
+The `search()` method is the core of the Valyu SDK. It accepts a query string as the first parameter, followed by optional configuration parameters.
+
+```javascript
+valyu.search(
+    query,                                        // Your search query
+    {
+        searchType: "all",                       // "all", "web", or "proprietary"
+        maxNumResults: 10,                       // Maximum results to return (1-20)
+        isToolCall: true,                        // Whether this is an AI tool call
+        relevanceThreshold: 0.5,                 // Minimum relevance score (0-1)
+        maxPrice: 30,                            // Maximum price per thousand queries (CPM)
+        includedSources: [],                     // Specific sources to search
+        category: null,                          // Category filter
+        startDate: null,                         // Start date (YYYY-MM-DD)
+        endDate: null                            // End date (YYYY-MM-DD)
+    }
+)
+```
+
+### Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `query` | `string` | *required* | The search query string |
+| `searchType` | `string` | `"all"` | Search scope: `"all"`, `"web"`, or `"proprietary"` |
+| `maxNumResults` | `number` | `10` | Maximum number of results to return (1-20) |
+| `isToolCall` | `boolean` | `true` | Whether this is an AI tool call (affects processing) |
+| `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 |
+| `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 |
+
+### Response Format
+
+The search method returns a `SearchResponse` object with the following structure:
+
+```javascript
+{
+    success: boolean,                           // Whether the search was successful
+    error: string | null,                       // Error message if any
+    tx_id: string,                             // Transaction ID for feedback
+    query: string,                             // The original query
+    results: SearchResult[],                   // List of search results
+    results_by_source: {                       // Count of results by source type
+        web: number,
+        proprietary: number
+    },
+    total_deduction_pcm: number,               // Cost in CPM
+    total_deduction_dollars: number,           // Cost in dollars
+    total_characters: number                   // Total characters returned
+}
+```
+
+Each `SearchResult` contains:
+
+```javascript
+{
+    title: string,                             // Result title
+    url: string,                              // Source URL
+    content: string,                          // Full content
+    description?: string,                     // Brief description
+    source: string,                           // Source identifier
+    price: number,                            // Cost for this result
+    length: number,                           // Content length in characters
+    image_url?: Record<string, string>,       // Associated images
+    relevance_score: number,                  // Relevance score (0-1)
+    data_type?: string                        // "structured" or "unstructured"
+}
+```
+
+## Examples
+
+### Basic Search
+
+```javascript
 const { Valyu } = require('valyu');
 
-// Initialize the Valyu client (provide your API key)
 const valyu = new Valyu("your-api-key");
 
-// Get relevant context for your query
-(async () => {
-  const response = await valyu.context(
-    "Tell me about ancient civilizations", // query
-    "proprietary",                         // search_type ("proprietary" or "web")
-    5,                                     // num_query: number of queries to generate
-    3,                                     // num_results: number of results per query
-    10                                     // max_price: maximum price per thousand queries
-  );
-  console.log(response);
-})();
+// Simple search across all sources
+const response = await valyu.search("What is machine learning?");
+console.log(`Found ${response.results.length} results`);
+```
+
+### Academic Research
+
+```javascript
+// Search academic papers on arXiv
+const response = await valyu.search(
+  "agentic search-enhanced large reasoning models",
+  {
+    searchType: "proprietary",
+    maxNumResults: 10,
+    relevanceThreshold: 0.6,
+    includedSources: ["valyu/valyu-arxiv"],
+    startDate: "2024-05-01"
+  }
+);
+```
+
+### Web Search with Date Filtering
+
+```javascript
+// Search recent web content
+const response = await valyu.search(
+  "what is claude 4 opus model",
+  {
+    searchType: "web",
+    maxNumResults: 7,
+    relevanceThreshold: 0.5,
+    startDate: "2024-01-01",
+    endDate: "2024-12-31"
+  }
+);
+```
+
+### Hybrid 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
+    }
+);
+```
+
+### Processing Results
+
+```javascript
+const response = await valyu.search("climate change solutions");
+
+if (response.success) {
+    console.log(`Search cost: $${response.total_deduction_dollars.toFixed(4)}`);
+    console.log(`Sources: Web=${response.results_by_source.web}, Proprietary=${response.results_by_source.proprietary}`);
+    
+    response.results.forEach((result, i) => {
+        console.log(`\n${i + 1}. ${result.title}`);
+        console.log(`   Source: ${result.source}`);
+        console.log(`   Relevance: ${result.relevance_score.toFixed(2)}`);
+        console.log(`   Content: ${result.content.substring(0, 200)}...`);
+    });
+} else {
+    console.log(`Search failed: ${response.error}`);
+}
+```
+
+## Authentication
+
+Set your API key in one of these ways:
+
+1. **Environment variable** (recommended):
+   ```bash
+   export VALYU_API_KEY="your-api-key-here"
+   ```
+
+2. **Direct initialization**:
+   ```javascript
+   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:
+
+```javascript
+const response = await valyu.search("test query");
+
+if (!response.success) {
+    console.log(`Error: ${response.error}`);
+    console.log(`Transaction ID: ${response.tx_id}`);
+} else {
+    // Process successful results
+    response.results.forEach(result => {
+        console.log(result.title);
+    });
+}
+```
+
+## TypeScript Support
+
+The SDK includes full TypeScript support:
+
+```typescript
+import { Valyu, SearchOptions, SearchResponse } from 'valyu';
+
+const valyu = new Valyu("your-api-key");
+
+const options: SearchOptions = {
+    searchType: "proprietary",
+    maxNumResults: 10,
+    relevanceThreshold: 0.6
+};
+
+const response: SearchResponse = await valyu.search("machine learning", options);
 ```
 
+## Backward Compatibility
+
+The legacy `context()` method is still supported but deprecated:
+
+```javascript
+// Legacy method (deprecated)
+const response = await valyu.context(
+    "neural networks basics",
+    {
+        searchType: "all",
+        maxNumResults: 5,
+        queryRewrite: true,
+        similarityThreshold: 0.5,
+        dataSources: ["valyu/valyu-arxiv"]
+    }
+);
+```
+
+**Migration from v1 to v2:**
+- `context()` → `search()`
+- `similarityThreshold` → `relevanceThreshold`
+- `dataSources` → `includedSources`
+- `queryRewrite` → `isToolCall`
+- Default `relevanceThreshold` changed from `0.4` to `0.5`
+- Default `maxPrice` changed from `1` to `30`
+
+## Getting Started
+
+1. Sign up for a free account at [Valyu](https://exchange.valyu.network)
+2. Get your API key from the dashboard  
+3. Install the SDK: `npm install valyu`
+4. Start building with the examples above
+
+## Testing
+
+Run the integration tests:
+
+```bash
+npm run test:integration
+```
+
+Run the v2 API examples:
+
+```bash
+node examples/v2-api-examples.js
+```
+
+## Support
+
+- **Documentation**: [docs.valyu.network](https://docs.valyu.network)
+- **API Reference**: Full parameter documentation above
+- **Examples**: Check the `examples/` directory in this repository
+- **Issues**: Report bugs on GitHub
+
+## License
+
+This project is licensed under the MIT License.
+

package/dist/index.d.mts

@@ -12,6 +12,17 @@ interface SearchResult {
     relevance_score: number;
     data_type?: DataType;
 }
+interface SearchOptions {
+    searchType?: SearchType;
+    maxNumResults?: number;
+    maxPrice?: number;
+    isToolCall?: boolean;
+    relevanceThreshold?: number;
+    includedSources?: string[];
+    category?: string;
+    startDate?: string;
+    endDate?: string;
+}
 interface SearchResponse {
     success: boolean;
     error?: string;
@@ -35,19 +46,14 @@ declare class Valyu {
     private baseUrl;
     private headers;
     constructor(apiKey?: string, baseUrl?: string);
-    context(query: string, options?: {
-        searchType?: string;
-        maxNumResults?: number;
-        queryRewrite?: boolean;
-        similarityThreshold?: number;
-        maxPrice?: number;
-        dataSources?: string[];
-    }): Promise<SearchResponse>;
-    feedback({ tx_id, feedback, sentiment }: {
-        tx_id: string;
-        feedback: string;
-        sentiment: FeedbackSentiment;
-    }): Promise<FeedbackResponse>;
+    /**
+     * Validates date format (YYYY-MM-DD)
+     */
+    private validateDateFormat;
+    /**
+     * Search for information using the Valyu API v2
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
 }
 
-export { type FeedbackResponse, type FeedbackSentiment, type SearchResponse, type SearchType, Valyu };
+export { type FeedbackResponse, type FeedbackSentiment, type SearchOptions, type SearchResponse, type SearchType, Valyu };

package/dist/index.d.ts

@@ -12,6 +12,17 @@ interface SearchResult {
     relevance_score: number;
     data_type?: DataType;
 }
+interface SearchOptions {
+    searchType?: SearchType;
+    maxNumResults?: number;
+    maxPrice?: number;
+    isToolCall?: boolean;
+    relevanceThreshold?: number;
+    includedSources?: string[];
+    category?: string;
+    startDate?: string;
+    endDate?: string;
+}
 interface SearchResponse {
     success: boolean;
     error?: string;
@@ -35,19 +46,14 @@ declare class Valyu {
     private baseUrl;
     private headers;
     constructor(apiKey?: string, baseUrl?: string);
-    context(query: string, options?: {
-        searchType?: string;
-        maxNumResults?: number;
-        queryRewrite?: boolean;
-        similarityThreshold?: number;
-        maxPrice?: number;
-        dataSources?: string[];
-    }): Promise<SearchResponse>;
-    feedback({ tx_id, feedback, sentiment }: {
-        tx_id: string;
-        feedback: string;
-        sentiment: FeedbackSentiment;
-    }): Promise<FeedbackResponse>;
+    /**
+     * Validates date format (YYYY-MM-DD)
+     */
+    private validateDateFormat;
+    /**
+     * Search for information using the Valyu API v2
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
 }
 
-export { type FeedbackResponse, type FeedbackSentiment, type SearchResponse, type SearchType, Valyu };
+export { type FeedbackResponse, type FeedbackSentiment, type SearchOptions, type SearchResponse, type SearchType, Valyu };

package/dist/index.js

@@ -48,13 +48,27 @@ var Valyu = class {
       "x-api-key": apiKey
     };
   }
-  async context(query, options = {}) {
+  /**
+   * Validates date format (YYYY-MM-DD)
+   */
+  validateDateFormat(date) {
+    const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+    if (!dateRegex.test(date)) {
+      return false;
+    }
+    const parsedDate = new Date(date);
+    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());
+  }
+  /**
+   * Search for information using the Valyu API v2
+   */
+  async search(query, options = {}) {
     try {
       const defaultSearchType = "all";
       const defaultMaxNumResults = 10;
-      const defaultQueryRewrite = true;
-      const defaultSimilarityThreshold = 0.4;
-      const defaultMaxPrice = 1;
+      const defaultIsToolCall = true;
+      const defaultRelevanceThreshold = 0.5;
+      const defaultMaxPrice = 30;
       let finalSearchType = defaultSearchType;
       const providedSearchTypeString = options.searchType?.toLowerCase();
       if (providedSearchTypeString === "web" || providedSearchTypeString === "proprietary" || providedSearchTypeString === "all") {
@@ -72,19 +86,68 @@ var Valyu = class {
           total_characters: 0
         };
       }
+      if (options.startDate && !this.validateDateFormat(options.startDate)) {
+        return {
+          success: false,
+          error: "Invalid startDate format. Must be YYYY-MM-DD",
+          tx_id: null,
+          query,
+          results: [],
+          results_by_source: { web: 0, proprietary: 0 },
+          total_deduction_pcm: 0,
+          total_deduction_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (options.endDate && !this.validateDateFormat(options.endDate)) {
+        return {
+          success: false,
+          error: "Invalid endDate format. Must be YYYY-MM-DD",
+          tx_id: null,
+          query,
+          results: [],
+          results_by_source: { web: 0, proprietary: 0 },
+          total_deduction_pcm: 0,
+          total_deduction_dollars: 0,
+          total_characters: 0
+        };
+      }
+      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;
+      if (maxNumResults < 1 || maxNumResults > 20) {
+        return {
+          success: false,
+          error: "maxNumResults must be between 1 and 20",
+          tx_id: null,
+          query,
+          results: [],
+          results_by_source: { web: 0, proprietary: 0 },
+          total_deduction_pcm: 0,
+          total_deduction_dollars: 0,
+          total_characters: 0
+        };
+      }
       const payload = {
         query,
         search_type: finalSearchType,
-        max_num_results: options.maxNumResults ?? defaultMaxNumResults,
-        query_rewrite: options.queryRewrite ?? defaultQueryRewrite,
-        similarity_threshold: options.similarityThreshold ?? defaultSimilarityThreshold,
+        max_num_results: maxNumResults,
+        is_tool_call: options.isToolCall ?? defaultIsToolCall,
+        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,
         max_price: options.maxPrice ?? defaultMaxPrice
       };
-      if (options.dataSources !== void 0) {
-        payload.data_sources = options.dataSources;
+      if (options.includedSources !== void 0) {
+        payload.included_sources = options.includedSources;
+      }
+      if (options.category !== void 0) {
+        payload.category = options.category;
+      }
+      if (options.startDate !== void 0) {
+        payload.start_date = options.startDate;
+      }
+      if (options.endDate !== void 0) {
+        payload.end_date = options.endDate;
       }
       const response = await import_axios.default.post(
-        `${this.baseUrl}/knowledge`,
+        `${this.baseUrl}/deepsearch`,
         payload,
         { headers: this.headers }
       );
@@ -105,7 +168,7 @@ var Valyu = class {
     } catch (e) {
       return {
         success: false,
-        error: e.message,
+        error: e.response?.data?.error || e.message,
         tx_id: null,
         query,
         results: [],
@@ -116,36 +179,6 @@ var Valyu = class {
       };
     }
   }
-  async feedback({
-    tx_id,
-    feedback,
-    sentiment
-  }) {
-    try {
-      const payload = {
-        tx_id,
-        feedback,
-        sentiment
-      };
-      const response = await import_axios.default.post(
-        `${this.baseUrl}/feedback`,
-        payload,
-        { headers: this.headers }
-      );
-      if (!response.status || response.status < 200 || response.status >= 300) {
-        return {
-          success: false,
-          error: response.data?.error
-        };
-      }
-      return response.data;
-    } catch (e) {
-      return {
-        success: false,
-        error: e.message
-      };
-    }
-  }
 };
 // 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, FeedbackSentiment, FeedbackResponse } 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  async context(\n    query: string,\n    options: {\n      searchType?: string;\n      maxNumResults?: number;\n      queryRewrite?: boolean;\n      similarityThreshold?: number;\n      maxPrice?: number;\n      dataSources?: string[];\n    } = {}\n  ): Promise<SearchResponse> {\n    try {\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultQueryRewrite = true;\n      const defaultSimilarityThreshold = 0.4;\n      const defaultMaxPrice = 1;\n\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      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: options.maxNumResults ?? defaultMaxNumResults,\n        query_rewrite: options.queryRewrite ?? defaultQueryRewrite,\n        similarity_threshold: options.similarityThreshold ?? defaultSimilarityThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      if (options.dataSources !== undefined) {\n        payload.data_sources = options.dataSources;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/knowledge`,\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.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  async feedback({\n    tx_id,\n    feedback,\n    sentiment\n  }: {\n    tx_id: string;\n    feedback: string;\n    sentiment: FeedbackSentiment;\n  }): Promise<FeedbackResponse> {\n    try {\n      const payload = {\n        tx_id,\n        feedback,\n        sentiment\n      };\n\n      const response = await axios.post(\n        `${this.baseUrl}/feedback`,\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        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.message\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse \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 } 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"]}

package/dist/index.mjs

@@ -14,13 +14,27 @@ var Valyu = class {
       "x-api-key": apiKey
     };
   }
-  async context(query, options = {}) {
+  /**
+   * Validates date format (YYYY-MM-DD)
+   */
+  validateDateFormat(date) {
+    const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+    if (!dateRegex.test(date)) {
+      return false;
+    }
+    const parsedDate = new Date(date);
+    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());
+  }
+  /**
+   * Search for information using the Valyu API v2
+   */
+  async search(query, options = {}) {
     try {
       const defaultSearchType = "all";
       const defaultMaxNumResults = 10;
-      const defaultQueryRewrite = true;
-      const defaultSimilarityThreshold = 0.4;
-      const defaultMaxPrice = 1;
+      const defaultIsToolCall = true;
+      const defaultRelevanceThreshold = 0.5;
+      const defaultMaxPrice = 30;
       let finalSearchType = defaultSearchType;
       const providedSearchTypeString = options.searchType?.toLowerCase();
       if (providedSearchTypeString === "web" || providedSearchTypeString === "proprietary" || providedSearchTypeString === "all") {
@@ -38,19 +52,68 @@ var Valyu = class {
           total_characters: 0
         };
       }
+      if (options.startDate && !this.validateDateFormat(options.startDate)) {
+        return {
+          success: false,
+          error: "Invalid startDate format. Must be YYYY-MM-DD",
+          tx_id: null,
+          query,
+          results: [],
+          results_by_source: { web: 0, proprietary: 0 },
+          total_deduction_pcm: 0,
+          total_deduction_dollars: 0,
+          total_characters: 0
+        };
+      }
+      if (options.endDate && !this.validateDateFormat(options.endDate)) {
+        return {
+          success: false,
+          error: "Invalid endDate format. Must be YYYY-MM-DD",
+          tx_id: null,
+          query,
+          results: [],
+          results_by_source: { web: 0, proprietary: 0 },
+          total_deduction_pcm: 0,
+          total_deduction_dollars: 0,
+          total_characters: 0
+        };
+      }
+      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;
+      if (maxNumResults < 1 || maxNumResults > 20) {
+        return {
+          success: false,
+          error: "maxNumResults must be between 1 and 20",
+          tx_id: null,
+          query,
+          results: [],
+          results_by_source: { web: 0, proprietary: 0 },
+          total_deduction_pcm: 0,
+          total_deduction_dollars: 0,
+          total_characters: 0
+        };
+      }
       const payload = {
         query,
         search_type: finalSearchType,
-        max_num_results: options.maxNumResults ?? defaultMaxNumResults,
-        query_rewrite: options.queryRewrite ?? defaultQueryRewrite,
-        similarity_threshold: options.similarityThreshold ?? defaultSimilarityThreshold,
+        max_num_results: maxNumResults,
+        is_tool_call: options.isToolCall ?? defaultIsToolCall,
+        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,
         max_price: options.maxPrice ?? defaultMaxPrice
       };
-      if (options.dataSources !== void 0) {
-        payload.data_sources = options.dataSources;
+      if (options.includedSources !== void 0) {
+        payload.included_sources = options.includedSources;
+      }
+      if (options.category !== void 0) {
+        payload.category = options.category;
+      }
+      if (options.startDate !== void 0) {
+        payload.start_date = options.startDate;
+      }
+      if (options.endDate !== void 0) {
+        payload.end_date = options.endDate;
       }
       const response = await axios.post(
-        `${this.baseUrl}/knowledge`,
+        `${this.baseUrl}/deepsearch`,
         payload,
         { headers: this.headers }
       );
@@ -71,7 +134,7 @@ var Valyu = class {
     } catch (e) {
       return {
         success: false,
-        error: e.message,
+        error: e.response?.data?.error || e.message,
         tx_id: null,
         query,
         results: [],
@@ -82,36 +145,6 @@ var Valyu = class {
       };
     }
   }
-  async feedback({
-    tx_id,
-    feedback,
-    sentiment
-  }) {
-    try {
-      const payload = {
-        tx_id,
-        feedback,
-        sentiment
-      };
-      const response = await axios.post(
-        `${this.baseUrl}/feedback`,
-        payload,
-        { headers: this.headers }
-      );
-      if (!response.status || response.status < 200 || response.status >= 300) {
-        return {
-          success: false,
-          error: response.data?.error
-        };
-      }
-      return response.data;
-    } catch (e) {
-      return {
-        success: false,
-        error: e.message
-      };
-    }
-  }
 };
 export {
   Valyu

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, FeedbackSentiment, FeedbackResponse } 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  async context(\n    query: string,\n    options: {\n      searchType?: string;\n      maxNumResults?: number;\n      queryRewrite?: boolean;\n      similarityThreshold?: number;\n      maxPrice?: number;\n      dataSources?: string[];\n    } = {}\n  ): Promise<SearchResponse> {\n    try {\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultQueryRewrite = true;\n      const defaultSimilarityThreshold = 0.4;\n      const defaultMaxPrice = 1;\n\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      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: options.maxNumResults ?? defaultMaxNumResults,\n        query_rewrite: options.queryRewrite ?? defaultQueryRewrite,\n        similarity_threshold: options.similarityThreshold ?? defaultSimilarityThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      if (options.dataSources !== undefined) {\n        payload.data_sources = options.dataSources;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/knowledge`,\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.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  async feedback({\n    tx_id,\n    feedback,\n    sentiment\n  }: {\n    tx_id: string;\n    feedback: string;\n    sentiment: FeedbackSentiment;\n  }): Promise<FeedbackResponse> {\n    try {\n      const payload = {\n        tx_id,\n        feedback,\n        sentiment\n      };\n\n      const response = await axios.post(\n        `${this.baseUrl}/feedback`,\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        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.message\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse \n} from './types'; "],"mappings":"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","names":[]}
+{"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":";AAAA,OAAO,WAAW;AAGX,IAAM,QAAN,MAAY;AAAA,EAIjB,YAAY,QAAiB,UAAkB,gCAAgC;AAC7E,QAAI,CAAC,QAAQ;AACX,eAAS,QAAQ,IAAI;AACrB,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI,MAAM,0BAA0B;AAAA,MAC5C;AAAA,IACF;AACA,SAAK,UAAU;AACf,SAAK,UAAU;AAAA,MACb,gBAAgB;AAAA,MAChB,aAAa;AAAA,IACf;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,mBAAmB,MAAuB;AAChD,UAAM,YAAY;AAClB,QAAI,CAAC,UAAU,KAAK,IAAI,GAAG;AACzB,aAAO;AAAA,IACT;AACA,UAAM,aAAa,IAAI,KAAK,IAAI;AAChC,WAAO,sBAAsB,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAe,UAAyB,CAAC,GAA4B;AAChF,QAAI;AAEF,YAAM,oBAAgC;AACtC,YAAM,uBAAuB;AAC7B,YAAM,oBAAoB;AAC1B,YAAM,4BAA4B;AAClC,YAAM,kBAAkB;AAGxB,UAAI,kBAA8B;AAClC,YAAM,2BAA2B,QAAQ,YAAY,YAAY;AAEjE,UAAI,6BAA6B,SAAS,6BAA6B,iBAAiB,6BAA6B,OAAO;AAC1H,0BAAkB;AAAA,MACpB,WAAW,QAAQ,eAAe,QAAW;AAC3C,eAAO;AAAA,UACL,SAAS;AAAA,UACT,OAAO;AAAA,UACP,OAAO;AAAA,UACP;AAAA,UACA,SAAS,CAAC;AAAA,UACV,mBAAmB,EAAE,KAAK,GAAG,aAAa,EAAE;AAAA,UAC5C,qBAAqB;AAAA,UACrB,yBAAyB;AAAA,UACzB,kBAAkB;AAAA,QACpB;AAAA,MACF;AAGA,UAAI,QAAQ,aAAa,CAAC,KAAK,mBAAmB,QAAQ,SAAS,GAAG;AACpE,eAAO;AAAA,UACL,SAAS;AAAA,UACT,OAAO;AAAA,UACP,OAAO;AAAA,UACP;AAAA,UACA,SAAS,CAAC;AAAA,UACV,mBAAmB,EAAE,KAAK,GAAG,aAAa,EAAE;AAAA,UAC5C,qBAAqB;AAAA,UACrB,yBAAyB;AAAA,UACzB,kBAAkB;AAAA,QACpB;AAAA,MACF;AAEA,UAAI,QAAQ,WAAW,CAAC,KAAK,mBAAmB,QAAQ,OAAO,GAAG;AAChE,eAAO;AAAA,UACL,SAAS;AAAA,UACT,OAAO;AAAA,UACP,OAAO;AAAA,UACP;AAAA,UACA,SAAS,CAAC;AAAA,UACV,mBAAmB,EAAE,KAAK,GAAG,aAAa,EAAE;AAAA,UAC5C,qBAAqB;AAAA,UACrB,yBAAyB;AAAA,UACzB,kBAAkB;AAAA,QACpB;AAAA,MACF;AAGA,YAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,UAAI,gBAAgB,KAAK,gBAAgB,IAAI;AAC3C,eAAO;AAAA,UACL,SAAS;AAAA,UACT,OAAO;AAAA,UACP,OAAO;AAAA,UACP;AAAA,UACA,SAAS,CAAC;AAAA,UACV,mBAAmB,EAAE,KAAK,GAAG,aAAa,EAAE;AAAA,UAC5C,qBAAqB;AAAA,UACrB,yBAAyB;AAAA,UACzB,kBAAkB;AAAA,QACpB;AAAA,MACF;AAGA,YAAM,UAA+B;AAAA,QACnC;AAAA,QACA,aAAa;AAAA,QACb,iBAAiB;AAAA,QACjB,cAAc,QAAQ,cAAc;AAAA,QACpC,qBAAqB,QAAQ,sBAAsB;AAAA,QACnD,WAAW,QAAQ,YAAY;AAAA,MACjC;AAGA,UAAI,QAAQ,oBAAoB,QAAW;AACzC,gBAAQ,mBAAmB,QAAQ;AAAA,MACrC;AAEA,UAAI,QAAQ,aAAa,QAAW;AAClC,gBAAQ,WAAW,QAAQ;AAAA,MAC7B;AAEA,UAAI,QAAQ,cAAc,QAAW;AACnC,gBAAQ,aAAa,QAAQ;AAAA,MAC/B;AAEA,UAAI,QAAQ,YAAY,QAAW;AACjC,gBAAQ,WAAW,QAAQ;AAAA,MAC7B;AAEA,YAAM,WAAW,MAAM,MAAM;AAAA,QAC3B,GAAG,KAAK,OAAO;AAAA,QACf;AAAA,QACA,EAAE,SAAS,KAAK,QAAQ;AAAA,MAC1B;AAEA,UAAI,CAAC,SAAS,UAAU,SAAS,SAAS,OAAO,SAAS,UAAU,KAAK;AACvE,eAAO;AAAA,UACL,SAAS;AAAA,UACT,OAAO,SAAS,MAAM;AAAA,UACtB,OAAO;AAAA,UACP;AAAA,UACA,SAAS,CAAC;AAAA,UACV,mBAAmB,EAAE,KAAK,GAAG,aAAa,EAAE;AAAA,UAC5C,qBAAqB;AAAA,UACrB,yBAAyB;AAAA,UACzB,kBAAkB;AAAA,QACpB;AAAA,MACF;AAEA,aAAO,SAAS;AAAA,IAClB,SAAS,GAAQ;AACf,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,EAAE,UAAU,MAAM,SAAS,EAAE;AAAA,QACpC,OAAO;AAAA,QACP;AAAA,QACA,SAAS,CAAC;AAAA,QACV,mBAAmB,EAAE,KAAK,GAAG,aAAa,EAAE;AAAA,QAC5C,qBAAqB;AAAA,QACrB,yBAAyB;AAAA,QACzB,kBAAkB;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "valyu-js",
-    "version": "1.0.7",
+    "version": "2.0.0",
     "description": "DeepSearch API for AI.",
     "files": [
         "dist"