@every-app/sdk 0.2.0 → 0.3.0-rc.2

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

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

package/dist/internal/catalog/index.js

@@ -0,0 +1,19 @@
+/**
+ * The first fifty catalog providers beyond the ones today's apps use
+ * (docs/design/2026-10-provider-registry.md, section 9), one file per
+ * batch, merged into `CAPABILITIES` after the hand-written entries. A
+ * provider here is a catalog entry like DataForSEO: every gateway has it,
+ * its settings are settable, a row can't take its id.
+ */
+import { COMMERCE } from "./commerce.js";
+import { COMMS } from "./comms.js";
+import { INFRA } from "./infra.js";
+import { INFERENCE } from "./inference.js";
+import { SEARCH } from "./search.js";
+export const CATALOG_ENTRIES = {
+    ...COMMERCE,
+    ...COMMS,
+    ...INFRA,
+    ...INFERENCE,
+    ...SEARCH,
+};

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

@@ -0,0 +1,356 @@
+export declare const INFERENCE: {
+    readonly anthropic: {
+        readonly mode: "ai";
+        readonly label: "Anthropic";
+        readonly description: "Claude models through the Messages API.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "ANTHROPIC_API_KEY";
+        };
+        readonly docs: "https://platform.claude.com/settings/keys";
+        readonly api: "https://platform.claude.com/docs/en/api/overview";
+        readonly origin: "https://api.anthropic.com";
+        readonly inferenceRoutes: readonly ["/v1/messages", "/v1/messages/count_tokens"];
+        readonly hint: "An API key from the Claude Console's API keys page; the Gateway sends it as a bearer token. Apps send the anthropic-version header themselves.";
+        readonly secrets: readonly [{
+            readonly name: "ANTHROPIC_API_KEY";
+            readonly hint: "A key scoped to one workspace, so no call needs an anthropic-workspace-id header.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v1/models";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Send an anthropic-version header, as every call does.";
+        };
+        readonly rate: {
+            readonly note: "Requests and tokens per minute by usage tier, on the Console's Rate limits page; token counting is free, with its own per-minute limit.";
+        };
+        readonly example: "summarize this support thread in three bullet points";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["ai", "llm"];
+    };
+    readonly gemini: {
+        readonly mode: "ai";
+        readonly label: "Google Gemini";
+        readonly description: "Google's Gemini models through their OpenAI-compatible endpoint: chat, embeddings, images.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "GEMINI_API_KEY";
+        };
+        readonly docs: "https://aistudio.google.com/apikey";
+        readonly api: "https://ai.google.dev/gemini-api/docs/openai";
+        readonly origin: "https://generativelanguage.googleapis.com";
+        readonly inferenceRoutes: readonly ["/v1beta/openai/chat/completions", "/v1beta/openai/embeddings", "/v1beta/openai/images/generations"];
+        readonly hint: "An API key from Google AI Studio; the Gateway sends it as a bearer token. Apps call Gemini's OpenAI-shaped paths under /v1beta/openai.";
+        readonly secrets: readonly [{
+            readonly name: "GEMINI_API_KEY";
+            readonly hint: "A Google AI Studio key restricted to the Gemini API only.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v1beta/openai/models";
+            readonly expect: readonly [200];
+            readonly free: true;
+        };
+        readonly rate: {
+            readonly note: "Per project, not per key: requests and tokens per minute and requests per day, by tier (Free, then Tiers 1 to 3).";
+        };
+        readonly example: "describe what is in this product photo";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["ai", "llm", "embeddings", "images"];
+    };
+    readonly mistral: {
+        readonly mode: "ai";
+        readonly label: "Mistral AI";
+        readonly description: "Mistral's models: chat, code completion, embeddings, moderation, OCR, speech.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "MISTRAL_API_KEY";
+        };
+        readonly docs: "https://console.mistral.ai";
+        readonly api: "https://docs.mistral.ai/api/";
+        readonly origin: "https://api.mistral.ai";
+        readonly inferenceRoutes: readonly ["/v1/chat/completions", "/v1/fim/completions", "/v1/embeddings", "/v1/moderations", "/v1/chat/moderations", "/v1/classifications", "/v1/chat/classifications", "/v1/ocr", "/v1/audio/transcriptions", "/v1/audio/speech"];
+        readonly hint: "An API key from API Keys in the Mistral Studio console; the Gateway sends it as a bearer token. Free mode needs no card; usage and rate limits apply.";
+        readonly secrets: readonly [{
+            readonly name: "MISTRAL_API_KEY";
+            readonly hint: "A key from API Keys in the Studio console, with an expiry date.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v1/models";
+            readonly expect: readonly [200];
+            readonly free: true;
+        };
+        readonly example: "extract the text from this scanned invoice";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["ai", "llm", "ocr", "embeddings"];
+    };
+    readonly groq: {
+        readonly mode: "ai";
+        readonly label: "Groq";
+        readonly description: "Open models on Groq through OpenAI's API shape: chat, responses, transcription, speech.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "GROQ_API_KEY";
+        };
+        readonly docs: "https://console.groq.com/keys";
+        readonly api: "https://console.groq.com/docs/api-reference";
+        readonly origin: "https://api.groq.com";
+        readonly inferenceRoutes: readonly ["/openai/v1/chat/completions", "/openai/v1/responses", "/openai/v1/audio/transcriptions", "/openai/v1/audio/translations", "/openai/v1/audio/speech"];
+        readonly hint: "An API key from the Groq console; the Gateway sends it as a bearer token. Apps call the OpenAI-shaped paths under /openai/v1.";
+        readonly secrets: readonly [{
+            readonly name: "GROQ_API_KEY";
+            readonly hint: "A key from the API Keys page of the Groq console.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/openai/v1/models";
+            readonly expect: readonly [200];
+            readonly free: true;
+        };
+        readonly rate: {
+            readonly note: "Requests and tokens per minute and per day, per model and plan, for the whole organization; the console Limits page shows them.";
+        };
+        readonly example: "transcribe this voice memo";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["ai", "llm", "speech"];
+    };
+    readonly cohere: {
+        readonly mode: "ai";
+        readonly label: "Cohere";
+        readonly description: "Cohere's models: chat, embeddings, reranking, classification, transcription, document parsing.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "COHERE_API_KEY";
+        };
+        readonly docs: "https://dashboard.cohere.com/api-keys";
+        readonly api: "https://docs.cohere.com/reference/about";
+        readonly origin: "https://api.cohere.com";
+        readonly inferenceRoutes: readonly ["/v2/chat", "/v2/embed", "/v2/rerank", "/v1/classify", "/v2/audio/transcriptions", "/v2/parse", "/v1/tokenize", "/v1/detokenize"];
+        readonly hint: "An API key from the Cohere dashboard; the Gateway sends it as a bearer token. Trial keys are free and limited; production keys are paid.";
+        readonly secrets: readonly [{
+            readonly name: "COHERE_API_KEY";
+            readonly hint: "A production key; a trial key is limited to 1,000 calls a month.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v1/models";
+            readonly expect: readonly [200];
+            readonly free: true;
+        };
+        readonly rate: {
+            readonly note: "Production: 500 calls a minute for Command A chat and most endpoints, rerank 1,000. Trial: 20 chat calls a minute, 1,000 calls a month.";
+        };
+        readonly example: "rerank these search results for the query refund policy";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["ai", "llm", "embeddings", "rerank"];
+    };
+    readonly voyage: {
+        readonly mode: "api_key";
+        readonly label: "Voyage AI";
+        readonly description: "Embeddings and rerankers for search and retrieval: text, code, multimodal, contextualized chunks.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "VOYAGE_API_KEY";
+        };
+        readonly docs: "https://dashboard.voyageai.com/organization/api-keys";
+        readonly api: "https://docs.voyageai.com/reference/embeddings-api";
+        readonly hosts: readonly ["api.voyageai.com"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["POST"];
+        readonly accountWidePaths: readonly [readonly ["v1", "files"], readonly ["v1", "batches"]];
+        readonly hint: "A secret key from the Voyage dashboard; the Gateway sends it as a bearer token. Apps POST to /v1/embeddings, /v1/multimodalembeddings, /v1/contextualizedembeddings and /v1/rerank.";
+        readonly secrets: readonly [{
+            readonly name: "VOYAGE_API_KEY";
+            readonly hint: "A secret key from API keys in the Voyage dashboard.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v1/batches";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Lists the organization's batches, so the Gateway refuses it for apps; run it from the person's terminal.";
+        };
+        readonly cost: {
+            readonly unit: "token";
+            readonly note: "voyage-4 $0.06 per million tokens; the first 200 million tokens of the voyage-4 family are free per account.";
+        };
+        readonly rate: {
+            readonly perMinute: 2000;
+            readonly note: "2,000 requests a minute at tier 1, doubled at tier 2, tripled at tier 3; tokens per minute vary by model.";
+        };
+        readonly example: "embed these product descriptions for semantic search";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["embeddings", "rerank", "search"];
+    };
+    readonly perplexity: {
+        readonly mode: "api_key";
+        readonly label: "Perplexity";
+        readonly description: "Web-grounded answers from the Agent API, raw web search results, and embeddings.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "PERPLEXITY_API_KEY";
+        };
+        readonly docs: "https://console.perplexity.ai/project/keys";
+        readonly api: "https://docs.perplexity.ai/api-reference/agent-post";
+        readonly hosts: readonly ["api.perplexity.ai"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly accountWidePaths: readonly [readonly ["v1", "batches"], readonly ["v1", "files"], readonly ["v1", "skills"], readonly ["v1", "analytics"], readonly ["v2", "analytics"], readonly ["generate_auth_token"], readonly ["revoke_auth_token"]];
+        readonly hint: "An API key from the Perplexity console; the Gateway sends it as a bearer token. Apps POST to /v1/agent for researched answers and /search for result lists, and GET /v1/agent/{id} to poll a background run.";
+        readonly secrets: readonly [{
+            readonly name: "PERPLEXITY_API_KEY";
+            readonly hint: "An API key from the project's API keys page in the Perplexity console.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/orchestrator/v1/models";
+            readonly expect: readonly [200];
+            readonly free: true;
+        };
+        readonly cost: {
+            readonly unit: "token";
+            readonly note: "Agent API per token plus tool fees (web_search $0.0025 a call); Search API $5 per 1,000 requests.";
+        };
+        readonly example: "research the latest pricing changes from our three main competitors";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["search", "ai", "research"];
+    };
+    readonly jina: {
+        readonly mode: "api_key";
+        readonly label: "Jina AI";
+        readonly description: "Reads web pages as Markdown, searches the web, and embeds and reranks text and images.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "JINA_API_KEY";
+        };
+        readonly docs: "https://jina.ai/api-dashboard/key-manager";
+        readonly api: "https://docs.jina.ai/";
+        readonly hosts: readonly ["api.jina.ai", "r.jina.ai", "s.jina.ai"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly accountWidePaths: readonly [readonly ["v1", "batches"], readonly ["echo"]];
+        readonly hint: "An API key from the Jina API dashboard; the Gateway sends it as a bearer token. Reader is r.jina.ai (POST {\"url\": ...}), Search is s.jina.ai, and embeddings and rerank are on api.jina.ai.";
+        readonly secrets: readonly [{
+            readonly name: "JINA_API_KEY";
+            readonly hint: "A key starting jina_, from Manage API Key in the Jina API dashboard.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly host: "api.jina.ai";
+            readonly path: "/v1/batches";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Lists the account's batch jobs, so the Gateway refuses it for apps; run it from the person's terminal.";
+        };
+        readonly cost: {
+            readonly unit: "token";
+            readonly note: "Billed in tokens against the account balance; GET /v1/models lists each model's price.";
+        };
+        readonly rate: {
+            readonly note: "Reader 500 requests a minute, Search 100, embeddings and rerank 500; premium keys get ten times more.";
+        };
+        readonly example: "read this article as Markdown and pull out the key claims";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["scrape", "search", "embeddings", "rerank"];
+    };
+    readonly replicate: {
+        readonly mode: "api_key";
+        readonly label: "Replicate";
+        readonly description: "Runs open-source and official models by API: images, video, audio and language.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "REPLICATE_API_TOKEN";
+        };
+        readonly docs: "https://replicate.com/account/api-tokens";
+        readonly api: "https://replicate.com/docs/reference/http";
+        readonly hosts: readonly ["api.replicate.com"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["POST"];
+        readonly accountWidePaths: readonly [readonly ["v1", "account"], readonly ["v1", "deployments"], readonly ["v1", "files"], readonly ["v1", "webhooks"], readonly ["trainings"]];
+        readonly hint: "An API token from Replicate's API tokens page; the Gateway sends it as a bearer token. Apps POST to /v1/models/{owner}/{name}/predictions or /v1/predictions with Prefer: wait (up to 60 seconds), or pass a webhook URL for longer runs.";
+        readonly secrets: readonly [{
+            readonly name: "REPLICATE_API_TOKEN";
+            readonly hint: "An API token from the API tokens page of the Replicate account.";
+        }];
+        readonly smoke: {
+            readonly method: "GET";
+            readonly path: "/v1/account";
+            readonly expect: readonly [200];
+            readonly free: true;
+            readonly note: "Account-wide, so the Gateway refuses it for apps; run it from the person's terminal.";
+        };
+        readonly rate: {
+            readonly perMinute: 600;
+            readonly note: "Creating predictions 600 a minute; every other endpoint 3,000 a minute.";
+        };
+        readonly example: "generate a product photo of a ceramic mug on a wooden table";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["ai", "images", "video", "audio"];
+    };
+    readonly huggingface: {
+        readonly mode: "api_key";
+        readonly label: "Hugging Face Inference";
+        readonly description: "Open models from Hugging Face's inference providers through one router: chat, embeddings, images, speech.";
+        readonly auth: {
+            readonly kind: "bearer";
+            readonly secret: "HUGGINGFACE_API_TOKEN";
+        };
+        readonly docs: "https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained";
+        readonly api: "https://huggingface.co/docs/inference-providers/index";
+        readonly hosts: readonly ["router.huggingface.co"];
+        readonly data: "per-call";
+        readonly access: readonly ["read"];
+        readonly readMethods: readonly ["GET", "POST"];
+        readonly accountWidePaths: readonly [];
+        readonly hint: "A fine-grained access token from Hugging Face settings with the Inference Providers permission; the Gateway sends it as a bearer token. Apps POST OpenAI-style chat to /v1/chat/completions, or other tasks under /<provider>/, such as /hf-inference/models/<model>.";
+        readonly secrets: readonly [{
+            readonly name: "HUGGINGFACE_API_TOKEN";
+            readonly hint: "A fine-grained token with only the Make calls to Inference Providers permission.";
+        }];
+        readonly cost: {
+            readonly unit: "call";
+            readonly note: "Pay as you go at each provider's own rate with no markup; PRO accounts get $2 of compute credits a month.";
+        };
+        readonly example: "embed these support articles for semantic search";
+        readonly verified: {
+            readonly on: "2026-10-25";
+            readonly how: "docs";
+        };
+        readonly tags: readonly ["ai", "llm", "embeddings", "images"];
+    };
+};
+//# sourceMappingURL=inference.d.ts.map

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

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