[{"data":1,"prerenderedAt":1599},["ShallowReactive",2],{"navigation_docs":3,"-guide-search":104,"-guide-search-surround":1594},[4,44],{"title":5,"path":6,"stem":7,"children":8,"icon":43},"Guide","\u002Fguide","1.guide\u002F1.index",[9,11,15,19,23,27,31,35,39],{"title":10,"path":6,"stem":7},"Getting Started",{"title":12,"path":13,"stem":14},"Searching","\u002Fguide\u002Fsearch","1.guide\u002F2.search",{"title":16,"path":17,"stem":18},"Fan-out","\u002Fguide\u002Ffanout","1.guide\u002F3.fanout",{"title":20,"path":21,"stem":22},"Reading","\u002Fguide\u002Fread","1.guide\u002F4.read",{"title":24,"path":25,"stem":26},"Reverse Image Search","\u002Fguide\u002Fimage","1.guide\u002F5.image",{"title":28,"path":29,"stem":30},"CLI","\u002Fguide\u002Fcli","1.guide\u002F6.cli",{"title":32,"path":33,"stem":34},"Agents","\u002Fguide\u002Fagents","1.guide\u002F7.agents",{"title":36,"path":37,"stem":38},"Custom Providers","\u002Fguide\u002Fcustom","1.guide\u002F8.custom",{"title":40,"path":41,"stem":42},"Explorer","\u002Fguide\u002Fexplorer","1.guide\u002F9.explorer","i-lucide-book-open",{"title":45,"path":46,"stem":47,"children":48,"icon":103},"Providers","\u002Fproviders","2.providers\u002F0.index",[49,51,55,59,63,67,71,75,79,83,87,91,95,99],{"title":50,"path":46,"stem":47},"Overview",{"title":52,"path":53,"stem":54},"Brave","\u002Fproviders\u002Fbrave","2.providers\u002F01.brave",{"title":56,"path":57,"stem":58},"Context.dev","\u002Fproviders\u002Fcontext","2.providers\u002F02.context",{"title":60,"path":61,"stem":62},"Exa","\u002Fproviders\u002Fexa","2.providers\u002F03.exa",{"title":64,"path":65,"stem":66},"Firecrawl","\u002Fproviders\u002Ffirecrawl","2.providers\u002F04.firecrawl",{"title":68,"path":69,"stem":70},"Jina","\u002Fproviders\u002Fjina","2.providers\u002F05.jina",{"title":72,"path":73,"stem":74},"Mojeek","\u002Fproviders\u002Fmojeek","2.providers\u002F06.mojeek",{"title":76,"path":77,"stem":78},"SearXNG","\u002Fproviders\u002Fsearxng","2.providers\u002F07.searxng",{"title":80,"path":81,"stem":82},"SerpAPI","\u002Fproviders\u002Fserpapi","2.providers\u002F08.serpapi",{"title":84,"path":85,"stem":86},"SerpBase","\u002Fproviders\u002Fserpbase","2.providers\u002F09.serpbase",{"title":88,"path":89,"stem":90},"Tavily","\u002Fproviders\u002Ftavily","2.providers\u002F10.tavily",{"title":92,"path":93,"stem":94},"TinyFish","\u002Fproviders\u002Ftinyfish","2.providers\u002F11.tinyfish",{"title":96,"path":97,"stem":98},"OpenAI Codex","\u002Fproviders\u002Fopenai-codex","2.providers\u002F12.openai-codex",{"title":100,"path":101,"stem":102},"Marginalia","\u002Fproviders\u002Fmarginalia","2.providers\u002F13.marginalia","i-lucide-library",{"id":105,"title":12,"body":106,"description":1587,"extension":1588,"links":1589,"meta":1590,"navigation":258,"path":13,"seo":1592,"stem":14,"__hash__":1593},"docs\u002F1.guide\u002F2.search.md",{"type":107,"value":108,"toc":1579},"minimark",[109,114,197,209,362,365,542,560,563,803,809,813,819,1005,1023,1033,1036,1039,1166,1315,1330,1334,1391,1424,1427,1569,1575],[110,111,113],"h2",{"id":112},"the-contract","The contract",[115,116,121],"pre",{"className":117,"code":118,"language":119,"meta":120,"style":120},"language-ts shiki shiki-themes github-light github-light poimandres","interface SearchProvider {\n  search(query: string, options?: SearchRequestOptions): Promise\u003CSearchResult[]>;\n}\n","ts","",[122,123,124,141,191],"code",{"__ignoreMap":120},[125,126,129,133,137],"span",{"class":127,"line":128},"line",1,[125,130,132],{"class":131},"s1TYA","interface",[125,134,136],{"class":135},"sCrqT"," SearchProvider",[125,138,140],{"class":139},"sKlNE"," {\n",[125,142,144,148,151,155,158,162,165,168,171,174,177,179,182,185,188],{"class":127,"line":143},2,[125,145,147],{"class":146},"scZRh","  search",[125,149,150],{"class":139},"(",[125,152,154],{"class":153},"s1jWp","query",[125,156,157],{"class":131},":",[125,159,161],{"class":160},"s8yaW"," string",[125,163,164],{"class":139},", ",[125,166,167],{"class":153},"options",[125,169,170],{"class":131},"?:",[125,172,173],{"class":135}," SearchRequestOptions",[125,175,176],{"class":139},")",[125,178,157],{"class":131},[125,180,181],{"class":135}," Promise",[125,183,184],{"class":139},"\u003C",[125,186,187],{"class":135},"SearchResult",[125,189,190],{"class":139},"[]>;\n",[125,192,194],{"class":127,"line":193},3,[125,195,196],{"class":139},"}\n",[198,199,200,201,204,205,208],"p",{},"Every search adapter has this one method. ",[122,202,203],{},"create(name)"," imports that adapter on its first call and gives you the provider, ",[122,206,207],{},"isSearchProvider(provider)"," is the type guard when you hold something you did not create yourself.",[115,210,212],{"className":117,"code":211,"language":119,"meta":120,"style":120},"import { create, isSearchProvider } from \"@agntn\u002Fweb\";\n\nconst provider = await create(\"brave\");\nif (isSearchProvider(provider)) {\n  const results = await provider.search(\"typescript runtimes\", { maxResults: 5 });\n}\n",[122,213,214,254,260,291,312,357],{"__ignoreMap":120},[125,215,216,220,223,227,230,233,236,240,244,248,251],{"class":127,"line":128},[125,217,219],{"class":218},"sP0CR","import",[125,221,222],{"class":139}," {",[125,224,226],{"class":225},"snHMy"," create",[125,228,229],{"class":139},",",[125,231,232],{"class":225}," isSearchProvider",[125,234,235],{"class":139}," }",[125,237,239],{"class":238},"stCPd"," from",[125,241,243],{"class":242},"scVjq"," \"",[125,245,247],{"class":246},"sQ7BG","@agntn\u002Fweb",[125,249,250],{"class":242},"\"",[125,252,253],{"class":139},";\n",[125,255,256],{"class":127,"line":143},[125,257,259],{"emptyLinePlaceholder":258},true,"\n",[125,261,262,265,269,272,276,279,281,283,286,288],{"class":127,"line":193},[125,263,264],{"class":131},"const",[125,266,268],{"class":267},"saoiD"," provider",[125,270,271],{"class":131}," =",[125,273,275],{"class":274},"sZW6a"," await",[125,277,226],{"class":278},"sULi6",[125,280,150],{"class":139},[125,282,250],{"class":242},[125,284,285],{"class":246},"brave",[125,287,250],{"class":242},[125,289,290],{"class":139},");\n",[125,292,294,297,300,303,305,309],{"class":127,"line":293},4,[125,295,296],{"class":238},"if",[125,298,299],{"class":139}," (",[125,301,302],{"class":278},"isSearchProvider",[125,304,150],{"class":139},[125,306,308],{"class":307},"spVlQ","provider",[125,310,311],{"class":139},")) {\n",[125,313,315,318,321,323,325,327,330,333,335,337,340,342,345,348,350,354],{"class":127,"line":314},5,[125,316,317],{"class":131},"  const",[125,319,320],{"class":267}," results",[125,322,271],{"class":131},[125,324,275],{"class":274},[125,326,268],{"class":307},[125,328,329],{"class":139},".",[125,331,332],{"class":278},"search",[125,334,150],{"class":139},[125,336,250],{"class":242},[125,338,339],{"class":246},"typescript runtimes",[125,341,250],{"class":242},[125,343,344],{"class":139},", {",[125,346,347],{"class":225}," maxResults",[125,349,157],{"class":139},[125,351,353],{"class":352},"siHFe"," 5",[125,355,356],{"class":139}," });\n",[125,358,360],{"class":127,"line":359},6,[125,361,196],{"class":139},[110,363,364],{"id":167},"Options",[115,366,368],{"className":117,"code":367,"language":119,"meta":120,"style":120},"interface SearchRequestOptions extends ExecutionOptions {\n  maxResults?: number; \u002F\u002F default 10\n  highlights?: boolean; \u002F\u002F default true\n  summary?: boolean; \u002F\u002F default false\n  fullText?: boolean; \u002F\u002F default false\n  includeDomains?: readonly string[];\n  excludeDomains?: readonly string[];\n  sources?: readonly string[];\n  categories?: readonly string[];\n  startPublishedDate?: string;\n  endPublishedDate?: string;\n  category?: string;\n}\n",[122,369,370,384,402,417,431,444,459,473,487,501,513,525,537],{"__ignoreMap":120},[125,371,372,374,376,379,382],{"class":127,"line":128},[125,373,132],{"class":131},[125,375,173],{"class":135},[125,377,378],{"class":218}," extends",[125,380,381],{"class":146}," ExecutionOptions",[125,383,140],{"class":139},[125,385,386,390,392,395,398],{"class":127,"line":143},[125,387,389],{"class":388},"s0VbO","  maxResults",[125,391,170],{"class":131},[125,393,394],{"class":160}," number",[125,396,397],{"class":139},"; ",[125,399,401],{"class":400},"sjhu3","\u002F\u002F default 10\n",[125,403,404,407,409,412,414],{"class":127,"line":193},[125,405,406],{"class":388},"  highlights",[125,408,170],{"class":131},[125,410,411],{"class":160}," boolean",[125,413,397],{"class":139},[125,415,416],{"class":400},"\u002F\u002F default true\n",[125,418,419,422,424,426,428],{"class":127,"line":293},[125,420,421],{"class":388},"  summary",[125,423,170],{"class":131},[125,425,411],{"class":160},[125,427,397],{"class":139},[125,429,430],{"class":400},"\u002F\u002F default false\n",[125,432,433,436,438,440,442],{"class":127,"line":314},[125,434,435],{"class":388},"  fullText",[125,437,170],{"class":131},[125,439,411],{"class":160},[125,441,397],{"class":139},[125,443,430],{"class":400},[125,445,446,449,451,454,456],{"class":127,"line":359},[125,447,448],{"class":388},"  includeDomains",[125,450,170],{"class":131},[125,452,453],{"class":218}," readonly",[125,455,161],{"class":160},[125,457,458],{"class":139},"[];\n",[125,460,462,465,467,469,471],{"class":127,"line":461},7,[125,463,464],{"class":388},"  excludeDomains",[125,466,170],{"class":131},[125,468,453],{"class":218},[125,470,161],{"class":160},[125,472,458],{"class":139},[125,474,476,479,481,483,485],{"class":127,"line":475},8,[125,477,478],{"class":388},"  sources",[125,480,170],{"class":131},[125,482,453],{"class":218},[125,484,161],{"class":160},[125,486,458],{"class":139},[125,488,490,493,495,497,499],{"class":127,"line":489},9,[125,491,492],{"class":388},"  categories",[125,494,170],{"class":131},[125,496,453],{"class":218},[125,498,161],{"class":160},[125,500,458],{"class":139},[125,502,504,507,509,511],{"class":127,"line":503},10,[125,505,506],{"class":388},"  startPublishedDate",[125,508,170],{"class":131},[125,510,161],{"class":160},[125,512,253],{"class":139},[125,514,516,519,521,523],{"class":127,"line":515},11,[125,517,518],{"class":388},"  endPublishedDate",[125,520,170],{"class":131},[125,522,161],{"class":160},[125,524,253],{"class":139},[125,526,528,531,533,535],{"class":127,"line":527},12,[125,529,530],{"class":388},"  category",[125,532,170],{"class":131},[125,534,161],{"class":160},[125,536,253],{"class":139},[125,538,540],{"class":127,"line":539},13,[125,541,196],{"class":139},[198,543,544,547,548,551,552,555,556,559],{},[122,545,546],{},"maxResults"," goes to the provider as the requested count and is applied again to what comes back, so an engine that pages by ten still gives you five. ",[122,549,550],{},"highlights"," asks for passages relevant to the query where the engine has them (Exa, Firecrawl). ",[122,553,554],{},"summary"," asks Exa for a summary of each result or Tavily and OpenAI Codex for an answer to the query. ",[122,557,558],{},"fullText"," asks for the whole page text, which is a lot of tokens, so think before you turn it on.",[198,561,562],{},"The filters are per provider. A provider that cannot do one does not fail, it just tells you through the detailed helpers:",[564,565,566,588],"table",{},[567,568,569],"thead",{},[570,571,572,576,579,582,585],"tr",{},[573,574,575],"th",{},"Provider",[573,577,578],{},"Domain filters",[573,580,581],{},"Source values",[573,583,584],{},"Category values",[573,586,587],{},"Date bounds",[589,590,591,606,619,632,662,681,693,705,717,729,741,766,786],"tbody",{},[570,592,593,596,599,601,603],{},[594,595,52],"td",{},[594,597,598],{},"none",[594,600,598],{},[594,602,598],{},[594,604,605],{},"start, end",[570,607,608,610,613,615,617],{},[594,609,56],{},[594,611,612],{},"include, exclude",[594,614,598],{},[594,616,598],{},[594,618,598],{},[570,620,621,623,625,627,630],{},[594,622,60],{},[594,624,612],{},[594,626,598],{},[594,628,629],{},"forwarded as given",[594,631,605],{},[570,633,634,636,638,649,660],{},[594,635,64],{},[594,637,612],{},[594,639,640,164,643,164,646],{},[122,641,642],{},"web",[122,644,645],{},"news",[122,647,648],{},"images",[594,650,651,164,654,164,657],{},[122,652,653],{},"research",[122,655,656],{},"pdf",[122,658,659],{},"developer",[594,661,598],{},[570,663,664,666,669,671,679],{},[594,665,68],{},[594,667,668],{},"include",[594,670,598],{},[594,672,673,164,675,164,677],{},[122,674,642],{},[122,676,648],{},[122,678,645],{},[594,680,598],{},[570,682,683,685,687,689,691],{},[594,684,100],{},[594,686,598],{},[594,688,598],{},[594,690,598],{},[594,692,598],{},[570,694,695,697,699,701,703],{},[594,696,72],{},[594,698,612],{},[594,700,598],{},[594,702,598],{},[594,704,605],{},[570,706,707,709,711,713,715],{},[594,708,96],{},[594,710,598],{},[594,712,598],{},[594,714,598],{},[594,716,598],{},[570,718,719,721,723,725,727],{},[594,720,76],{},[594,722,598],{},[594,724,598],{},[594,726,629],{},[594,728,598],{},[570,730,731,733,735,737,739],{},[594,732,80],{},[594,734,598],{},[594,736,598],{},[594,738,598],{},[594,740,605],{},[570,742,743,745,747,749,764],{},[594,744,84],{},[594,746,598],{},[594,748,598],{},[594,750,751,164,754,164,756,164,758,164,761],{},[122,752,753],{},"image",[122,755,648],{},[122,757,645],{},[122,759,760],{},"video",[122,762,763],{},"videos",[594,765,598],{},[570,767,768,770,772,774,784],{},[594,769,88],{},[594,771,612],{},[594,773,598],{},[594,775,776,164,779,164,781],{},[122,777,778],{},"general",[122,780,645],{},[122,782,783],{},"finance",[594,785,605],{},[570,787,788,790,792,794,801],{},[594,789,92],{},[594,791,612],{},[594,793,598],{},[594,795,796,164,798],{},[122,797,645],{},[122,799,800],{},"research_paper",[594,802,605],{},[198,804,805,808],{},[122,806,807],{},"getSearchFilterCapabilities(name)"," gives you the same table for one provider at runtime.",[110,810,812],{"id":811},"diagnostics","Diagnostics",[198,814,815,818],{},[122,816,817],{},"search()"," is a list API. When you want to know what the provider actually did with your options, ask for the detailed answer:",[115,820,822],{"className":117,"code":821,"language":119,"meta":120,"style":120},"import { searchProviderDetailed } from \"@agntn\u002Fweb\";\n\nconst answer = await searchProviderDetailed(\"brave\", \"typescript runtimes\", {\n  maxResults: 10,\n  includeDomains: [\"github.com\"],\n});\n\nanswer.provider; \u002F\u002F \"brave\"\nanswer.results; \u002F\u002F SearchResult[]\nanswer.ignoredFilters; \u002F\u002F [\"includeDomains\"], Brave has no domain filter\nanswer.undeclaredFilters; \u002F\u002F [] on built-ins, custom providers without capability metadata land here\nanswer.pagination; \u002F\u002F { status: \"next\", continuation: \"…\" }\nanswer.metadata; \u002F\u002F metadata for the whole response when the provider has it\n",[122,823,824,845,849,881,893,912,917,921,935,949,963,977,991],{"__ignoreMap":120},[125,825,826,828,830,833,835,837,839,841,843],{"class":127,"line":128},[125,827,219],{"class":218},[125,829,222],{"class":139},[125,831,832],{"class":225}," searchProviderDetailed",[125,834,235],{"class":139},[125,836,239],{"class":238},[125,838,243],{"class":242},[125,840,247],{"class":246},[125,842,250],{"class":242},[125,844,253],{"class":139},[125,846,847],{"class":127,"line":143},[125,848,259],{"emptyLinePlaceholder":258},[125,850,851,853,856,858,860,862,864,866,868,870,872,874,876,878],{"class":127,"line":193},[125,852,264],{"class":131},[125,854,855],{"class":267}," answer",[125,857,271],{"class":131},[125,859,275],{"class":274},[125,861,832],{"class":278},[125,863,150],{"class":139},[125,865,250],{"class":242},[125,867,285],{"class":246},[125,869,250],{"class":242},[125,871,164],{"class":139},[125,873,250],{"class":242},[125,875,339],{"class":246},[125,877,250],{"class":242},[125,879,880],{"class":139},", {\n",[125,882,883,885,887,890],{"class":127,"line":293},[125,884,389],{"class":225},[125,886,157],{"class":139},[125,888,889],{"class":352}," 10",[125,891,892],{"class":139},",\n",[125,894,895,897,899,902,904,907,909],{"class":127,"line":314},[125,896,448],{"class":225},[125,898,157],{"class":139},[125,900,901],{"class":139}," [",[125,903,250],{"class":242},[125,905,906],{"class":246},"github.com",[125,908,250],{"class":242},[125,910,911],{"class":139},"],\n",[125,913,914],{"class":127,"line":359},[125,915,916],{"class":139},"});\n",[125,918,919],{"class":127,"line":461},[125,920,259],{"emptyLinePlaceholder":258},[125,922,923,926,928,930,932],{"class":127,"line":475},[125,924,925],{"class":307},"answer",[125,927,329],{"class":139},[125,929,308],{"class":307},[125,931,397],{"class":139},[125,933,934],{"class":400},"\u002F\u002F \"brave\"\n",[125,936,937,939,941,944,946],{"class":127,"line":489},[125,938,925],{"class":307},[125,940,329],{"class":139},[125,942,943],{"class":307},"results",[125,945,397],{"class":139},[125,947,948],{"class":400},"\u002F\u002F SearchResult[]\n",[125,950,951,953,955,958,960],{"class":127,"line":503},[125,952,925],{"class":307},[125,954,329],{"class":139},[125,956,957],{"class":307},"ignoredFilters",[125,959,397],{"class":139},[125,961,962],{"class":400},"\u002F\u002F [\"includeDomains\"], Brave has no domain filter\n",[125,964,965,967,969,972,974],{"class":127,"line":515},[125,966,925],{"class":307},[125,968,329],{"class":139},[125,970,971],{"class":307},"undeclaredFilters",[125,973,397],{"class":139},[125,975,976],{"class":400},"\u002F\u002F [] on built-ins, custom providers without capability metadata land here\n",[125,978,979,981,983,986,988],{"class":127,"line":527},[125,980,925],{"class":307},[125,982,329],{"class":139},[125,984,985],{"class":307},"pagination",[125,987,397],{"class":139},[125,989,990],{"class":400},"\u002F\u002F { status: \"next\", continuation: \"…\" }\n",[125,992,993,995,997,1000,1002],{"class":127,"line":539},[125,994,925],{"class":307},[125,996,329],{"class":139},[125,998,999],{"class":307},"metadata",[125,1001,397],{"class":139},[125,1003,1004],{"class":400},"\u002F\u002F metadata for the whole response when the provider has it\n",[198,1006,1007,1008,1010,1011,1014,1015,1018,1019,1022],{},"Silently dropping a filter is the worst thing a wrapper can do, you end up trusting results that were never filtered. So the ignored ones are always listed. Firecrawl puts its request id, warnings and credits used in ",[122,1009,999],{},", Tavily puts the generated answer in ",[122,1012,1013],{},"metadata.answer",". ",[122,1016,1017],{},"isDetailedSearchProvider(provider)"," tells you whether a provider exposes ",[122,1020,1021],{},"searchDetailed()"," directly.",[198,1024,1025,1026,1029,1030,1032],{},"The detailed helpers also take ",[122,1027,1028],{},"favicon: false",", which drops the favicon URL from every result and every fan-out evidence record before it reaches you. Brave's run about 280 bytes each and SerpAPI's about 400, so the agent surfaces pass it unless the model asks. ",[122,1031,817],{}," on a provider has no such switch, it hands over what the engine mapped.",[110,1034,1035],{"id":985},"Pagination",[198,1037,1038],{},"Brave, Marginalia, Mojeek, SearXNG, SerpAPI, SerpBase and TinyFish have deeper pages. The detailed helpers normalize the state:",[115,1040,1042],{"className":117,"code":1041,"language":119,"meta":120,"style":120},"type SearchPagination =\n  | { status: \"next\"; continuation: string } \u002F\u002F the provider said there is more\n  | { status: \"unknown\"; continuation: string } \u002F\u002F another page must be probed\n  | { status: \"end\" } \u002F\u002F no further page\n  | { status: \"unsupported\" }; \u002F\u002F the provider does not page\n",[122,1043,1044,1056,1091,1121,1143],{"__ignoreMap":120},[125,1045,1046,1049,1053],{"class":127,"line":128},[125,1047,1048],{"class":131},"type",[125,1050,1052],{"class":1051},"s3-Zl"," SearchPagination",[125,1054,1055],{"class":131}," =\n",[125,1057,1058,1061,1063,1067,1069,1071,1074,1076,1079,1082,1084,1086,1088],{"class":127,"line":143},[125,1059,1060],{"class":131},"  |",[125,1062,222],{"class":139},[125,1064,1066],{"class":1065},"stSEH"," status",[125,1068,157],{"class":131},[125,1070,243],{"class":242},[125,1072,1073],{"class":246},"next",[125,1075,250],{"class":242},[125,1077,1078],{"class":139},";",[125,1080,1081],{"class":1065}," continuation",[125,1083,157],{"class":131},[125,1085,161],{"class":160},[125,1087,235],{"class":139},[125,1089,1090],{"class":400}," \u002F\u002F the provider said there is more\n",[125,1092,1093,1095,1097,1099,1101,1103,1106,1108,1110,1112,1114,1116,1118],{"class":127,"line":193},[125,1094,1060],{"class":131},[125,1096,222],{"class":139},[125,1098,1066],{"class":1065},[125,1100,157],{"class":131},[125,1102,243],{"class":242},[125,1104,1105],{"class":246},"unknown",[125,1107,250],{"class":242},[125,1109,1078],{"class":139},[125,1111,1081],{"class":1065},[125,1113,157],{"class":131},[125,1115,161],{"class":160},[125,1117,235],{"class":139},[125,1119,1120],{"class":400}," \u002F\u002F another page must be probed\n",[125,1122,1123,1125,1127,1129,1131,1133,1136,1138,1140],{"class":127,"line":293},[125,1124,1060],{"class":131},[125,1126,222],{"class":139},[125,1128,1066],{"class":1065},[125,1130,157],{"class":131},[125,1132,243],{"class":242},[125,1134,1135],{"class":246},"end",[125,1137,250],{"class":242},[125,1139,235],{"class":139},[125,1141,1142],{"class":400}," \u002F\u002F no further page\n",[125,1144,1145,1147,1149,1151,1153,1155,1158,1160,1163],{"class":127,"line":314},[125,1146,1060],{"class":131},[125,1148,222],{"class":139},[125,1150,1066],{"class":1065},[125,1152,157],{"class":131},[125,1154,243],{"class":242},[125,1156,1157],{"class":246},"unsupported",[125,1159,250],{"class":242},[125,1161,1162],{"class":139}," }; ",[125,1164,1165],{"class":400},"\u002F\u002F the provider does not page\n",[115,1167,1169],{"className":117,"code":1168,"language":119,"meta":120,"style":120},"const first = await searchProviderDetailed(\"brave\", \"typescript runtimes\", { maxResults: 10 });\n\nif (first.pagination.status === \"next\") {\n  const second = await searchProviderDetailed(\"brave\", \"typescript runtimes\", {\n    maxResults: 10,\n    continuation: first.pagination.continuation,\n  });\n}\n",[122,1170,1171,1210,1214,1244,1275,1286,1306,1311],{"__ignoreMap":120},[125,1172,1173,1175,1178,1180,1182,1184,1186,1188,1190,1192,1194,1196,1198,1200,1202,1204,1206,1208],{"class":127,"line":128},[125,1174,264],{"class":131},[125,1176,1177],{"class":267}," first",[125,1179,271],{"class":131},[125,1181,275],{"class":274},[125,1183,832],{"class":278},[125,1185,150],{"class":139},[125,1187,250],{"class":242},[125,1189,285],{"class":246},[125,1191,250],{"class":242},[125,1193,164],{"class":139},[125,1195,250],{"class":242},[125,1197,339],{"class":246},[125,1199,250],{"class":242},[125,1201,344],{"class":139},[125,1203,347],{"class":225},[125,1205,157],{"class":139},[125,1207,889],{"class":352},[125,1209,356],{"class":139},[125,1211,1212],{"class":127,"line":143},[125,1213,259],{"emptyLinePlaceholder":258},[125,1215,1216,1218,1220,1223,1225,1227,1229,1232,1235,1237,1239,1241],{"class":127,"line":193},[125,1217,296],{"class":238},[125,1219,299],{"class":139},[125,1221,1222],{"class":307},"first",[125,1224,329],{"class":139},[125,1226,985],{"class":307},[125,1228,329],{"class":139},[125,1230,1231],{"class":307},"status",[125,1233,1234],{"class":131}," ===",[125,1236,243],{"class":242},[125,1238,1073],{"class":246},[125,1240,250],{"class":242},[125,1242,1243],{"class":139},") {\n",[125,1245,1246,1248,1251,1253,1255,1257,1259,1261,1263,1265,1267,1269,1271,1273],{"class":127,"line":293},[125,1247,317],{"class":131},[125,1249,1250],{"class":267}," second",[125,1252,271],{"class":131},[125,1254,275],{"class":274},[125,1256,832],{"class":278},[125,1258,150],{"class":139},[125,1260,250],{"class":242},[125,1262,285],{"class":246},[125,1264,250],{"class":242},[125,1266,164],{"class":139},[125,1268,250],{"class":242},[125,1270,339],{"class":246},[125,1272,250],{"class":242},[125,1274,880],{"class":139},[125,1276,1277,1280,1282,1284],{"class":127,"line":314},[125,1278,1279],{"class":225},"    maxResults",[125,1281,157],{"class":139},[125,1283,889],{"class":352},[125,1285,892],{"class":139},[125,1287,1288,1291,1293,1295,1297,1299,1301,1304],{"class":127,"line":359},[125,1289,1290],{"class":225},"    continuation",[125,1292,157],{"class":139},[125,1294,1177],{"class":307},[125,1296,329],{"class":139},[125,1298,985],{"class":307},[125,1300,329],{"class":139},[125,1302,1303],{"class":307},"continuation",[125,1305,892],{"class":139},[125,1307,1308],{"class":127,"line":461},[125,1309,1310],{"class":139},"  });\n",[125,1312,1313],{"class":127,"line":475},[125,1314,196],{"class":139},[198,1316,1317,1318,1321,1322,1325,1326,1329],{},"The token is opaque and bound to the provider, the query and every option that changes the page. Change any of them and you get ",[122,1319,1320],{},"InvalidSearchContinuationError"," before another request leaves. But opaque does not mean signed. A token you did not produce yourself is untrusted input, treat it like one. Tokens are at most ",[122,1323,1324],{},"MAX_SEARCH_CONTINUATION_LENGTH"," (4 096) characters, the provider's own state inside at most ",[122,1327,1328],{},"MAX_PROVIDER_SEARCH_CONTINUATION_LENGTH"," (2 048).",[110,1331,1333],{"id":1332},"execution-controls","Execution controls",[115,1335,1337],{"className":117,"code":1336,"language":119,"meta":120,"style":120},"interface ExecutionOptions {\n  signal?: AbortSignal;\n  deadline?: number; \u002F\u002F absolute Unix timestamp in milliseconds\n  concurrency?: number; \u002F\u002F batch and fan-out only; default 3, maximum 10\n}\n",[122,1338,1339,1347,1359,1373,1387],{"__ignoreMap":120},[125,1340,1341,1343,1345],{"class":127,"line":128},[125,1342,132],{"class":131},[125,1344,381],{"class":135},[125,1346,140],{"class":139},[125,1348,1349,1352,1354,1357],{"class":127,"line":143},[125,1350,1351],{"class":388},"  signal",[125,1353,170],{"class":131},[125,1355,1356],{"class":135}," AbortSignal",[125,1358,253],{"class":139},[125,1360,1361,1364,1366,1368,1370],{"class":127,"line":193},[125,1362,1363],{"class":388},"  deadline",[125,1365,170],{"class":131},[125,1367,394],{"class":160},[125,1369,397],{"class":139},[125,1371,1372],{"class":400},"\u002F\u002F absolute Unix timestamp in milliseconds\n",[125,1374,1375,1378,1380,1382,1384],{"class":127,"line":293},[125,1376,1377],{"class":388},"  concurrency",[125,1379,170],{"class":131},[125,1381,394],{"class":160},[125,1383,397],{"class":139},[125,1385,1386],{"class":400},"\u002F\u002F batch and fan-out only; default 3, maximum 10\n",[125,1388,1389],{"class":127,"line":314},[125,1390,196],{"class":139},[198,1392,1393,1394,1397,1398,1401,1402,1405,1406,1409,1410,1413,1414,1416,1417,1420,1421,329],{},"Every network call takes them. ",[122,1395,1396],{},"signal"," cancels the request in flight. ",[122,1399,1400],{},"deadline"," is one budget for the whole operation, fallback and fan-out included, so waiting on a slow first provider does not reset the clock for the second. ",[122,1403,1404],{},"concurrency"," bounds how many requests the batch and fan-out helpers start at once. None of them change a continuation token. When the deadline cuts a fan-out, ",[122,1407,1408],{},"searchAllDetailed"," returns the providers that finished and lists the rest in ",[122,1411,1412],{},"errors",", a batch does the same per item, and a cancelled ",[122,1415,1396],{}," still rejects. ",[122,1418,1419],{},"deadlineAfterSeconds(30)"," turns a budget into that timestamp, the agent tools use it for ",[122,1422,1423],{},"timeoutSeconds",[110,1425,1426],{"id":1412},"Errors",[564,1428,1429,1439],{},[567,1430,1431],{},[570,1432,1433,1436],{},[573,1434,1435],{},"Error",[573,1437,1438],{},"When",[589,1440,1441,1451,1461,1473,1483,1492,1502,1520,1537],{},[570,1442,1443,1448],{},[594,1444,1445],{},[122,1446,1447],{},"EmptyQueryError",[594,1449,1450],{},"the query is blank",[570,1452,1453,1458],{},[594,1454,1455],{},[122,1456,1457],{},"UnknownProviderError",[594,1459,1460],{},"the name is not registered",[570,1462,1463,1468],{},[594,1464,1465],{},[122,1466,1467],{},"SearchNotSupportedError",[594,1469,1470,1471],{},"the provider has no ",[122,1472,817],{},[570,1474,1475,1480],{},[594,1476,1477],{},[122,1478,1479],{},"InvalidDateFilterError",[594,1481,1482],{},"a date bound is not an ISO date, or the end is before the start",[570,1484,1485,1489],{},[594,1486,1487],{},[122,1488,1320],{},[594,1490,1491],{},"the token does not belong to this provider, query and options",[570,1493,1494,1499],{},[594,1495,1496],{},[122,1497,1498],{},"AuthError",[594,1500,1501],{},"the provider rejected the key with 401, or the key is missing",[570,1503,1504,1509],{},[594,1505,1506],{},[122,1507,1508],{},"PaymentError",[594,1510,1511,1512,1515,1516,1519],{},"spent credits, however the provider spells them: Context.dev 401 with ",[122,1513,1514],{},"USAGE_EXCEEDED",", Tavily 432 or 433, SerpBase ",[122,1517,1518],{},"status: 1020",". Automatic fallback keeps going",[570,1521,1522,1527],{},[594,1523,1524],{},[122,1525,1526],{},"RateLimitError",[594,1528,1529,1530,1533,1534,1536],{},"the provider answered 429, ",[122,1531,1532],{},"retryAfter"," in seconds, ",[122,1535,308],{}," says which",[570,1538,1539,1544],{},[594,1540,1541],{},[122,1542,1543],{},"HTTPError",[594,1545,1546,1547,1550,1551,1554,1555,1558,1559,1561,1562,1564,1565,1568],{},"any other non-2xx, with ",[122,1548,1549],{},"statusCode",", redacted ",[122,1552,1553],{},"url"," and ",[122,1556,1557],{},"body","; no response at all is ",[122,1560,1549],{}," 0, ",[122,1563,1557],{}," names the transport cause and ",[122,1566,1567],{},"cause"," keeps the original error",[198,1570,1571,1574],{},[122,1572,1573],{},"normalizeError(error, provider)"," is what the adapters use to map a raw HTTP failure onto this list. It is exported, custom providers should use it too.",[1576,1577,1578],"style",{},"html pre.shiki code .s1TYA, html code.shiki .s1TYA{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#91B4D5}html pre.shiki code .sCrqT, html code.shiki .sCrqT{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#A6ACCDC0}html pre.shiki code .sKlNE, html code.shiki .sKlNE{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#A6ACCD}html pre.shiki code .scZRh, html code.shiki .scZRh{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#ADD7FF}html pre.shiki code .s1jWp, html code.shiki .s1jWp{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#E4F0FB}html pre.shiki code .s8yaW, html code.shiki .s8yaW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#A6ACCDC0}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sP0CR, html code.shiki .sP0CR{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#5DE4C7}html pre.shiki code .snHMy, html code.shiki .snHMy{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#ADD7FF}html pre.shiki code .stCPd, html code.shiki .stCPd{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#A6ACCD}html pre.shiki code .scVjq, html code.shiki .scVjq{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#A6ACCD}html pre.shiki code .sQ7BG, html code.shiki .sQ7BG{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#5DE4C7}html pre.shiki code .saoiD, html code.shiki .saoiD{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#E4F0FB}html pre.shiki code .sZW6a, html code.shiki .sZW6a{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#5DE4C7C0}html pre.shiki code .sULi6, html code.shiki .sULi6{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#E4F0FBD0}html pre.shiki code .spVlQ, html code.shiki .spVlQ{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E4F0FB}html pre.shiki code .siHFe, html code.shiki .siHFe{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#5DE4C7}html pre.shiki code .s0VbO, html code.shiki .s0VbO{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#A6ACCD}html pre.shiki code .sjhu3, html code.shiki .sjhu3{--shiki-light:#6A737D;--shiki-light-font-style:inherit;--shiki-default:#6A737D;--shiki-default-font-style:inherit;--shiki-dark:#767C9DB0;--shiki-dark-font-style:italic}html pre.shiki code .s3-Zl, html code.shiki .s3-Zl{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#A6ACCD}html pre.shiki code .stSEH, html code.shiki .stSEH{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#ADD7FF}",{"title":120,"searchDepth":143,"depth":143,"links":1580},[1581,1582,1583,1584,1585,1586],{"id":112,"depth":143,"text":113},{"id":167,"depth":143,"text":364},{"id":811,"depth":143,"text":812},{"id":985,"depth":143,"text":1035},{"id":1332,"depth":143,"text":1333},{"id":1412,"depth":143,"text":1426},"One provider, one query, the options every adapter takes, the filters each one honours, and the diagnostics that come back.","md",null,{"icon":1591},"i-lucide-search",{"title":12,"description":1587},"vi9K9vM8C87o4uejcmZkhirHNbW4kFVyKsHQaXehKnA",[1595,1597],{"title":10,"path":6,"stem":7,"description":1596,"children":-1},"Install the package, run one search, and get the same result shape from thirteen providers.",{"title":16,"path":17,"stem":18,"description":1598,"children":-1},"Every configured provider at once with deduplicated results and evidence, automatic fallback for one query, and batches of queries.",1790257650384]