@every-app/sdk 0.3.0-rc.1 → 0.3.0-rc.10

package/dist/internal/catalog/search.d.ts

@@ -0,0 +1,400 @@
+export declare const SEARCH: {
+    readonly firecrawl: {
+        readonly mode: "api_key";
+        readonly label: "Firecrawl";
+        readonly description: "Scrapes, crawls, maps and searches the web, returning clean markdown or structured data.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "FIRECRAWL_API_KEY";
+        };
+        readonly docs: "https://www.firecrawl.dev/app/api-keys";
+        readonly api: "https://docs.firecrawl.dev/api-reference/introduction";
+        readonly hosts: readonly ["api.firecrawl.dev"];
+        readonly data: "per-call";
+        readonly access: readonly ["read", "write"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly writeMethods: readonly ["DELETE"];
+        readonly accountWidePaths: readonly [readonly ["team"], readonly ["crawl", "active"], readonly ["monitor"], readonly ["agent"], readonly ["interact"], readonly ["support", "ask"]];
+        readonly hint: "An API key from Firecrawl's API keys page; the Gateway sends it as a bearer token. Scrape, crawl, map, search and extract are POSTs and job status is a GET; cancelling a crawl or batch (DELETE) needs write.";
+        readonly secrets: readonly [{
+            readonly name: "FIRECRAWL_API_KEY";
+            readonly hint: "An API key from Firecrawl's API keys page; it starts with fc-.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v2/team/credit-usage";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Remaining credits; account-wide, so the Gateway refuses it for apps: run it from the person's terminal.";
+        };
+        readonly cost: {
+            readonly unit: "result";
+            readonly note: "Credits: 1 per page scraped or crawled, 1 per map call, 2 per 10 search results; JSON extraction and other options add more.";
+        };
+        readonly rate: {
+            readonly note: "Per team per minute, by plan: /scrape 10 on Free, 100 Hobby, 500 Standard, 5,000 Growth; /crawl 2, 20, 100, 1,000.";
+        };
+        readonly example: "scrape https://example.com/pricing into markdown";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["scrape", "crawl", "search"];
+    };
+    readonly exa: {
+        readonly mode: "api_key";
+        readonly label: "Exa";
+        readonly description: "Web search built for AI: search results, page contents, similar links and cited answers.";
+        readonly auth: {
+            readonly kind: "header";
+            readonly secret: "EXA_API_KEY";
+            readonly header: "x-api-key";
+        };
+        readonly docs: "https://dashboard.exa.ai/api-keys";
+        readonly api: "https://exa.ai/docs/reference/search";
+        readonly hosts: readonly ["api.exa.ai"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["POST"];
+        readonly accountWidePaths: readonly [readonly ["websets"], readonly ["monitors"], readonly ["agent"], readonly ["batches"]];
+        readonly hint: "An API key from the Exa dashboard (the free tier gives $10 of credit a month); the Gateway sends it in the x-api-key header. Search, contents, find-similar and answer are POSTs.";
+        readonly secrets: readonly [{
+            readonly name: "EXA_API_KEY";
+            readonly hint: "An API key from the API keys page of the Exa dashboard.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/websets/v0/teams/me";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Team info under the Websets API (the docs page leaves out the /websets prefix); account-wide, so run it from the person's terminal.";
+        };
+        readonly cost: {
+            readonly unit: "call";
+            readonly usd: 0.007;
+            readonly note: "Search $7 per 1k (auto and fast; lite $4), contents $1 per 1k pages, answer $5 per 1k; up to 10 results included.";
+        };
+        readonly rate: {
+            readonly perSecond: 10;
+            readonly note: "Per team: /search and /answer 10 QPS, deep search 5, /contents 100.";
+        };
+        readonly example: "find recent articles about solid-state batteries";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["search"];
+    };
+    readonly tavily: {
+        readonly mode: "api_key";
+        readonly label: "Tavily";
+        readonly description: "Web search, page extraction, crawling and site maps for AI agents, plus research reports.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "TAVILY_API_KEY";
+        };
+        readonly docs: "https://app.tavily.com";
+        readonly api: "https://docs.tavily.com/documentation/api-reference/endpoint/search";
+        readonly hosts: readonly ["api.tavily.com"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly accountWidePaths: readonly [readonly ["usage"], readonly ["logs"], readonly ["org-usage"]];
+        readonly hint: "An API key from app.tavily.com (1,000 free credits a month); the Gateway sends it as a bearer token. Search, extract, crawl, map and research are POSTs; a research result is a GET.";
+        readonly secrets: readonly [{
+            readonly name: "TAVILY_API_KEY";
+            readonly hint: "An API key from the Tavily dashboard; it starts with tvly-.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/usage";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Key and account usage, not an endpoint that costs credits; account-wide, so run it from the person's terminal (10 calls per 10 minutes).";
+        };
+        readonly cost: {
+            readonly unit: "call";
+            readonly usd: 0.008;
+            readonly note: "Pay as you go $0.008 per credit: basic search 1 credit, advanced 2; extract 1 credit per 5 URLs; map 1 per 10 pages.";
+        };
+        readonly rate: {
+            readonly perMinute: 100;
+            readonly note: "Development keys 100 per minute, production keys 1,000; crawl 100 and research 20 per minute for both.";
+        };
+        readonly example: "search the web for this week's news on EU AI rules";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["search", "scrape"];
+    };
+    readonly serper: {
+        readonly mode: "api_key";
+        readonly label: "Serper";
+        readonly description: "Google search results as JSON: web, news, images, places, shopping, scholar and patents.";
+        readonly auth: {
+            readonly kind: "header";
+            readonly secret: "SERPER_API_KEY";
+            readonly header: "X-API-KEY";
+        };
+        readonly docs: "https://serper.dev/api-keys";
+        readonly api: "https://serper.dev/playground";
+        readonly hosts: readonly ["google.serper.dev", "scrape.serper.dev"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["POST"];
+        readonly accountWidePaths: readonly [];
+        readonly hint: "An API key from serper.dev (2,500 free queries to start); the Gateway sends it in the X-API-KEY header. Every search is a POST to google.serper.dev/<type> (search, news, images, places, …) with a JSON body such as {\"q\": \"…\"}.";
+        readonly secrets: readonly [{
+            readonly name: "SERPER_API_KEY";
+            readonly hint: "The API key on serper.dev's API keys page.";
+        }];
+        readonly cost: {
+            readonly unit: "call";
+            readonly usd: 0.001;
+            readonly note: "Prepaid credits, one per successful query: $1.00 per 1k on the 50k pack, down to $0.30 per 1k on the largest.";
+        };
+        readonly rate: {
+            readonly perSecond: 50;
+            readonly note: "Starter credits 50 queries per second; Standard 100, Scale 200, Ultimate 300.";
+        };
+        readonly example: "get the top Google results for best project management software";
+        readonly verified: false;
+        readonly tags: readonly ["search", "serp"];
+    };
+    readonly "brave-search": {
+        readonly mode: "api_key";
+        readonly label: "Brave Search";
+        readonly description: "Brave's independent web index: web, news, images, videos, places, LLM context and answers.";
+        readonly auth: {
+            readonly kind: "header";
+            readonly secret: "BRAVE_SEARCH_API_KEY";
+            readonly header: "X-Subscription-Token";
+        };
+        readonly docs: "https://api-dashboard.search.brave.com/app/keys";
+        readonly api: "https://api-dashboard.search.brave.com/documentation";
+        readonly hosts: readonly ["api.search.brave.com"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly accountWidePaths: readonly [];
+        readonly hint: "Activate a plan (it includes $5 of free credit a month), then create a key under API Keys; the Gateway sends it in the X-Subscription-Token header. Searches are GETs (POST works too); answers are a POST to /res/v1/chat/completions.";
+        readonly secrets: readonly [{
+            readonly name: "BRAVE_SEARCH_API_KEY";
+            readonly hint: "A key from the API Keys section of the Brave Search API dashboard, made after activating a plan.";
+        }];
+        readonly cost: {
+            readonly unit: "call";
+            readonly usd: 0.005;
+            readonly note: "Search $5 per 1k requests; Answers $4 per 1k plus $5 per million tokens; $5 free credit a month; only successful calls count.";
+        };
+        readonly rate: {
+            readonly perSecond: 50;
+            readonly note: "Search plan 50 queries per second; Answers 2 per second.";
+        };
+        readonly example: "search the web for the latest Cloudflare Workers release notes";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["search"];
+    };
+    readonly apify: {
+        readonly mode: "api_key";
+        readonly label: "Apify";
+        readonly description: "Runs Apify Actors (ready-made scrapers and automations) and reads their datasets and stores.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "APIFY_API_TOKEN";
+        };
+        readonly docs: "https://console.apify.com/settings/integrations";
+        readonly api: "https://docs.apify.com/api/v2";
+        readonly hosts: readonly ["api.apify.com"];
+        readonly data: "account";
+        readonly access: readonly ["read", "write"];
+        readonly readMethods: readonly ["GET", "HEAD"];
+        readonly writeMethods: readonly ["POST", "PUT", "DELETE"];
+        readonly accountWidePaths: readonly [readonly ["users"], readonly ["webhooks"], readonly ["webhook-dispatches"], readonly ["env-vars"]];
+        readonly hint: "The API token from Apify Console, Settings > API & Integrations; the Gateway sends it as a bearer token. Reading Actors, runs and datasets needs read; starting a run is a POST, so it needs write.";
+        readonly secrets: readonly [{
+            readonly name: "APIFY_API_TOKEN";
+            readonly hint: "The API token under Settings > API & Integrations in Apify Console.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v2/users/me";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "The docs' verify call; account-wide, so the Gateway refuses it for apps: run it from the person's terminal.";
+        };
+        readonly rate: {
+            readonly perSecond: 60;
+            readonly note: "60 requests per second per resource (one Actor, run, dataset or store); 250,000 requests per minute per user overall.";
+        };
+        readonly example: "run the Google Maps scraper Actor for coffee shops in Austin and list the results";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["scrape", "automation"];
+    };
+    readonly deepgram: {
+        readonly mode: "api_key";
+        readonly label: "Deepgram";
+        readonly description: "Speech to text, text to speech and text analysis.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "DEEPGRAM_API_KEY";
+            readonly scheme: "Token";
+        };
+        readonly docs: "https://console.deepgram.com/";
+        readonly api: "https://developers.deepgram.com/reference/deepgram-api-overview";
+        readonly hosts: readonly ["api.deepgram.com", "api.eu.deepgram.com", "api.au.deepgram.com", "api.in.deepgram.com"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly accountWidePaths: readonly [readonly ["projects"], readonly ["auth", "grant"]];
+        readonly hint: "An API key from the Deepgram Console; the Gateway sends it as Authorization: Token <key>, and the EU, Australia and India hosts take the same key. Transcription (/v1/listen), speech (/v1/speak) and text analysis (/v1/read) are POSTs.";
+        readonly secrets: readonly [{
+            readonly name: "DEEPGRAM_API_KEY";
+            readonly hint: "A project API key created in the Deepgram Console.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v1/models";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Lists the public models; it needs the key and processes no audio.";
+        };
+        readonly cost: {
+            readonly unit: "call";
+            readonly note: "Nova-3 pre-recorded $0.0043 per audio minute (pay as you go); Aura-2 speech $0.030 per 1k characters; $200 free credit.";
+        };
+        readonly rate: {
+            readonly note: "Concurrency per project on pay as you go: 50 pre-recorded transcriptions, 15 text-to-speech requests.";
+        };
+        readonly example: "transcribe this podcast episode and label the speakers";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["speech", "transcription"];
+    };
+    readonly elevenlabs: {
+        readonly mode: "api_key";
+        readonly label: "ElevenLabs";
+        readonly description: "Text to speech, speech to text, sound effects, music and voice changing.";
+        readonly auth: {
+            readonly kind: "header";
+            readonly secret: "ELEVENLABS_API_KEY";
+            readonly header: "xi-api-key";
+        };
+        readonly docs: "https://elevenlabs.io/app/settings/api-keys";
+        readonly api: "https://elevenlabs.io/docs/api-reference/introduction";
+        readonly hosts: readonly ["api.elevenlabs.io"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly accountWidePaths: readonly [readonly ["v1", "user"], readonly ["v1", "usage"], readonly ["v1", "workspace"], readonly ["v1", "workspaces"], readonly ["v1", "service-accounts"], readonly ["v1", "history"], readonly ["v1", "single-use-token"], readonly ["v1", "convai"], readonly ["v1", "dubbing"], readonly ["v1", "studio"], readonly ["v1", "pronunciation-dictionaries"], readonly ["v1", "voices", "add"], readonly ["v1", "voices", "pvc"], readonly ["v1", "voices", "collections"], readonly ["edit"], readonly ["replicate-to-isolated-environment"], readonly ["v1", "text-to-voice"], readonly ["v1", "audio-native"], readonly ["v1", "productions"], readonly ["v1", "speech-engine"], readonly ["v1", "music", "finetunes"], readonly ["v1", "flows"], readonly ["v1", "assets"], readonly ["v1", "audio-isolation", "history"]];
+        readonly hint: "An API key from ElevenLabs' API keys page; the Gateway sends it in the xi-api-key header. Speech, transcription and sound generation are POSTs; listing voices and models are GETs.";
+        readonly secrets: readonly [{
+            readonly name: "ELEVENLABS_API_KEY";
+            readonly hint: "An API key from ElevenLabs' API keys page; it can be scoped to the endpoints the app uses and given a credit cap.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v1/models";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "The first request in ElevenLabs' authentication docs; it generates nothing.";
+        };
+        readonly example: "read this paragraph aloud in a calm narrator voice";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["speech", "audio"];
+    };
+    readonly assemblyai: {
+        readonly mode: "api_key";
+        readonly label: "AssemblyAI";
+        readonly description: "Transcribes recorded audio and video, with speaker labels, redaction and subtitles.";
+        readonly auth: {
+            readonly kind: "header";
+            readonly secret: "ASSEMBLYAI_API_KEY";
+            readonly header: "Authorization";
+        };
+        readonly docs: "https://www.assemblyai.com/dashboard/home";
+        readonly api: "https://www.assemblyai.com/docs";
+        readonly hosts: readonly ["api.assemblyai.com", "api.eu.assemblyai.com"];
+        readonly data: "account";
+        readonly access: readonly ["read", "write"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly writeMethods: readonly ["DELETE"];
+        readonly accountWidePaths: readonly [];
+        readonly hint: "The API key from your AssemblyAI dashboard; the Gateway sends it as the whole Authorization header, with no Bearer word. Audio is submitted with a POST to /v2/transcript and the app polls GET /v2/transcript/<id>; deleting a transcript needs write.";
+        readonly secrets: readonly [{
+            readonly name: "ASSEMBLYAI_API_KEY";
+            readonly hint: "The API key on your AssemblyAI dashboard.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v2/transcript?limit=1";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Lists the account's latest transcript; it transcribes nothing.";
+        };
+        readonly cost: {
+            readonly unit: "call";
+            readonly note: "Per hour of audio submitted: Universal-3.5 Pro $0.21, Universal-2 $0.15; the free tier covers up to 185 hours of pre-recorded audio.";
+        };
+        readonly rate: {
+            readonly perMinute: 4000;
+            readonly note: "20,000 requests per 5 minutes per account; 5 transcriptions in parallel on free accounts, 200 or more on paid.";
+        };
+        readonly example: "transcribe this sales call recording with speaker labels";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["speech", "transcription"];
+    };
+    readonly newsapi: {
+        readonly mode: "api_key";
+        readonly label: "NewsAPI";
+        readonly description: "Searches news articles and live headlines from over 150,000 sources.";
+        readonly auth: {
+            readonly kind: "header";
+            readonly secret: "NEWSAPI_API_KEY";
+            readonly header: "X-Api-Key";
+        };
+        readonly docs: "https://newsapi.org/register";
+        readonly api: "https://newsapi.org/docs";
+        readonly hosts: readonly ["newsapi.org"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["GET"];
+        readonly accountWidePaths: readonly [];
+        readonly hint: "An API key from newsapi.org/register; the Gateway sends it in the X-Api-Key header. The free Developer plan allows 100 requests a day, delays articles by 24 hours and is for development only; production needs a paid plan.";
+        readonly secrets: readonly [{
+            readonly name: "NEWSAPI_API_KEY";
+            readonly hint: "The API key NewsAPI shows after you register.";
+        }];
+        readonly cost: {
+            readonly unit: "call";
+            readonly usd: 0.0018;
+            readonly note: "Developer plan free (100 requests a day, development only); Business $449 a month for 250,000 requests, then $0.0018 each.";
+        };
+        readonly rate: {
+            readonly perDay: 100;
+            readonly note: "Developer plan; Business includes 250,000 requests a month, Advanced 2,000,000.";
+        };
+        readonly example: "find today's top business headlines in the US";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["news"];
+    };
+};
+//# sourceMappingURL=search.d.ts.map

package/dist/internal/catalog/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/internal/catalog/search.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwdkC,CAAC"}