@librechat/agents 2.4.31 → 2.4.34

package/dist/types/tools/search/firecrawl.d.ts

@@ -1,83 +1,4 @@
-export interface FirecrawlScrapeOptions {
-    formats?: string[];
-    includeTags?: string[];
-    excludeTags?: string[];
-    headers?: Record<string, string>;
-    waitFor?: number;
-    timeout?: number;
-}
-interface ScrapeMetadata {
-    sourceURL?: string;
-    url?: string;
-    scrapeId?: string;
-    statusCode?: number;
-    title?: string;
-    description?: string;
-    language?: string;
-    favicon?: string;
-    viewport?: string;
-    robots?: string;
-    'theme-color'?: string;
-    'og:url'?: string;
-    'og:title'?: string;
-    'og:description'?: string;
-    'og:type'?: string;
-    'og:image'?: string;
-    'og:image:width'?: string;
-    'og:image:height'?: string;
-    'og:site_name'?: string;
-    ogUrl?: string;
-    ogTitle?: string;
-    ogDescription?: string;
-    ogImage?: string;
-    ogSiteName?: string;
-    'article:author'?: string;
-    'article:published_time'?: string;
-    'article:modified_time'?: string;
-    'article:section'?: string;
-    'article:tag'?: string;
-    'article:publisher'?: string;
-    publishedTime?: string;
-    modifiedTime?: string;
-    'twitter:site'?: string;
-    'twitter:creator'?: string;
-    'twitter:card'?: string;
-    'twitter:image'?: string;
-    'twitter:dnt'?: string;
-    'twitter:app:name:iphone'?: string;
-    'twitter:app:id:iphone'?: string;
-    'twitter:app:url:iphone'?: string;
-    'twitter:app:name:ipad'?: string;
-    'twitter:app:id:ipad'?: string;
-    'twitter:app:url:ipad'?: string;
-    'twitter:app:name:googleplay'?: string;
-    'twitter:app:id:googleplay'?: string;
-    'twitter:app:url:googleplay'?: string;
-    'fb:app_id'?: string;
-    'al:ios:url'?: string;
-    'al:ios:app_name'?: string;
-    'al:ios:app_store_id'?: string;
-    [key: string]: string | number | boolean | null | undefined;
-}
-export interface FirecrawlScrapeResponse {
-    success: boolean;
-    data?: {
-        markdown?: string;
-        html?: string;
-        rawHtml?: string;
-        screenshot?: string;
-        links?: string[];
-        metadata?: ScrapeMetadata;
-    };
-    error?: string;
-}
-export interface FirecrawlScraperConfig {
-    apiKey?: string;
-    apiUrl?: string;
-    formats?: string[];
-    timeout?: number;
-}
-export declare function getAttribution(link: string, metadata?: ScrapeMetadata): string | undefined;
+import type * as t from './types';
 /**
  * Firecrawl scraper implementation
  * Uses the Firecrawl API to scrape web pages
@@ -87,31 +8,31 @@ export declare class FirecrawlScraper {
     private apiUrl;
     private defaultFormats;
     private timeout;
-    constructor(config?: FirecrawlScraperConfig);
+    private logger;
+    constructor(config?: t.FirecrawlScraperConfig);
     /**
      * Scrape a single URL
      * @param url URL to scrape
      * @param options Scrape options
      * @returns Scrape response
      */
-    scrapeUrl(url: string, options?: FirecrawlScrapeOptions): Promise<[string, FirecrawlScrapeResponse]>;
+    scrapeUrl(url: string, options?: t.FirecrawlScrapeOptions): Promise<[string, t.FirecrawlScrapeResponse]>;
     /**
      * Extract content from scrape response
      * @param response Scrape response
      * @returns Extracted content or empty string if not available
      */
-    extractContent(response: FirecrawlScrapeResponse): string;
+    extractContent(response: t.FirecrawlScrapeResponse): [string, undefined | t.References];
     /**
      * Extract metadata from scrape response
      * @param response Scrape response
      * @returns Metadata object
      */
-    extractMetadata(response: FirecrawlScrapeResponse): ScrapeMetadata;
+    extractMetadata(response: t.FirecrawlScrapeResponse): t.ScrapeMetadata;
 }
 /**
  * Create a Firecrawl scraper instance
  * @param config Scraper configuration
  * @returns Firecrawl scraper instance
  */
-export declare const createFirecrawlScraper: (config?: FirecrawlScraperConfig) => FirecrawlScraper;
-export {};
+export declare const createFirecrawlScraper: (config?: t.FirecrawlScraperConfig) => FirecrawlScraper;

package/dist/types/tools/search/format.d.ts

@@ -1,2 +1,5 @@
 import type * as t from './types';
-export declare function formatResultsForLLM(results: t.SearchResultData): string;
+export declare function formatResultsForLLM(turn: number, results: t.SearchResultData): {
+    output: string;
+    references: t.ResultReference[];
+};

package/dist/types/tools/search/highlights.d.ts

@@ -8,6 +8,6 @@ import type * as t from './types';
  * @param searchResults - Search results object
  * @param mainExpandBy - Primary expansion size on each side (default: 300)
  * @param separatorExpandBy - Additional range to look for separators (default: 150)
- * @returns Copy of search results with expanded highlights
+ * @returns Copy of search results with expanded highlights and tracked references
  */
 export declare function expandHighlights(searchResults: t.SearchResultData, mainExpandBy?: number, separatorExpandBy?: number): t.SearchResultData;

package/dist/types/tools/search/rerankers.d.ts

@@ -1,25 +1,27 @@
 import type * as t from './types';
 export declare abstract class BaseReranker {
     protected apiKey: string | undefined;
-    constructor();
+    protected logger: t.Logger;
+    constructor(logger?: t.Logger);
     abstract rerank(query: string, documents: string[], topK?: number): Promise<t.Highlight[]>;
     protected getDefaultRanking(documents: string[], topK: number): t.Highlight[];
-    protected logDocumentSamples(documents: string[]): void;
 }
 export declare class JinaReranker extends BaseReranker {
-    constructor({ apiKey }: {
+    constructor({ apiKey, logger, }: {
         apiKey?: string;
+        logger?: t.Logger;
     });
     rerank(query: string, documents: string[], topK?: number): Promise<t.Highlight[]>;
 }
 export declare class CohereReranker extends BaseReranker {
-    constructor({ apiKey }: {
+    constructor({ apiKey, logger, }: {
         apiKey?: string;
+        logger?: t.Logger;
     });
     rerank(query: string, documents: string[], topK?: number): Promise<t.Highlight[]>;
 }
 export declare class InfinityReranker extends BaseReranker {
-    constructor();
+    constructor(logger?: t.Logger);
     rerank(query: string, documents: string[], topK?: number): Promise<t.Highlight[]>;
 }
 /**
@@ -29,4 +31,5 @@ export declare const createReranker: (config: {
     rerankerType: t.RerankerType;
     jinaApiKey?: string;
     cohereApiKey?: string;
+    logger?: t.Logger;
 }) => BaseReranker | undefined;

package/dist/types/tools/search/schema.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export declare enum DATE_RANGE {
+    PAST_HOUR = "h",
+    PAST_24_HOURS = "d",
+    PAST_WEEK = "w",
+    PAST_MONTH = "m",
+    PAST_YEAR = "y"
+}
+export declare const DEFAULT_QUERY_DESCRIPTION: string;
+export declare const DEFAULT_COUNTRY_DESCRIPTION: string;
+export declare const querySchema: z.ZodString;
+export declare const dateSchema: z.ZodOptional<z.ZodNativeEnum<typeof DATE_RANGE>>;
+export declare const countrySchema: z.ZodOptional<z.ZodString>;
+export declare const imagesSchema: z.ZodOptional<z.ZodBoolean>;
+export declare const videosSchema: z.ZodOptional<z.ZodBoolean>;
+export declare const newsSchema: z.ZodOptional<z.ZodBoolean>;

package/dist/types/tools/search/search.d.ts

@@ -1,9 +1,9 @@
 import type * as t from './types';
 import { FirecrawlScraper } from './firecrawl';
 export declare const createSearchAPI: (config: t.SearchConfig) => {
-    getSources: (query: string, numResults?: number, storedLocation?: string) => Promise<t.SearchResult>;
+    getSources: (params: t.GetSourcesParams) => Promise<t.SearchResult>;
 };
 export declare const createSourceProcessor: (config?: t.ProcessSourcesConfig, scraperInstance?: FirecrawlScraper) => {
-    processSources: (result: t.SearchResult, numElements: number, query: string, proMode?: boolean) => Promise<t.SearchResultData>;
+    processSources: (fields: t.ProcessSourcesFields) => Promise<t.SearchResultData>;
     topResults: number;
 };

package/dist/types/tools/search/test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tools/search/tool.d.ts

@@ -1,12 +1,33 @@
 import { z } from 'zod';
 import { DynamicStructuredTool } from '@langchain/core/tools';
 import type * as t from './types';
-declare const SearchToolSchema: z.ZodObject<{
+import { DATE_RANGE } from './schema';
+/**
+ * Creates a search tool with a schema that dynamically includes the country field
+ * only when the searchProvider is 'serper'.
+ *
+ * @param config - The search tool configuration
+ * @returns A DynamicStructuredTool with a schema that depends on the searchProvider
+ */
+export declare const createSearchTool: (config?: t.SearchToolConfig) => DynamicStructuredTool<z.ZodObject<{
     query: z.ZodString;
+    date: z.ZodOptional<z.ZodNativeEnum<typeof DATE_RANGE>>;
+    country?: z.ZodOptional<z.ZodString>;
+    images: z.ZodOptional<z.ZodBoolean>;
+    videos: z.ZodOptional<z.ZodBoolean>;
+    news: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     query: string;
+    date?: DATE_RANGE | undefined;
+    images?: boolean | undefined;
+    videos?: boolean | undefined;
+    news?: boolean | undefined;
+    country?: unknown;
 }, {
     query: string;
-}>;
-export declare const createSearchTool: (config?: t.SearchToolConfig) => DynamicStructuredTool<typeof SearchToolSchema>;
-export {};
+    date?: DATE_RANGE | undefined;
+    images?: boolean | undefined;
+    videos?: boolean | undefined;
+    news?: boolean | undefined;
+    country?: unknown;
+}>>;