Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

feat(plugins): load declarative catalog entries (#19)

Leo8e7768fe9f9f
diff --git a/apps/web/src/components/plugins/PluginsDialog.test.tsx b/apps/web/src/components/plugins/PluginsDialog.test.tsx
index fdbe036ac..410a83466 100644
--- a/apps/web/src/components/plugins/PluginsDialog.test.tsx
+++ b/apps/web/src/components/plugins/PluginsDialog.test.tsx
@@ -9,6 +9,7 @@ import {
PLUGIN_DIRECTORY_HEADER_CLASS_NAME,
PLUGIN_DIRECTORY_PANEL_CLASS_NAME,
PLUGIN_DIRECTORY_SCROLL_CLASS_NAME,
+ resolvePluginDialogServers,
validateMcpServerDraft,
} from "./PluginsDialog";
import { CustomMcpServers, PluginsCatalog } from "./PluginsCatalog";
@@ -30,6 +31,12 @@ const rawServer: McpServer = {
updatedAt: "2026-08-27T00:00:00.000Z",
};
+const removedBuiltinServer: McpServer = {
+ ...rawServer,
+ id: McpServerId.make("builtin-removed-vendor"),
+ name: "Removed Vendor",
+};
+
describe("Plugins dialog content", () => {
it("keeps the marketplace and plugin details at one fixed size", () => {
expect(PLUGIN_DIALOG_CLASS_NAME).toContain("h-[min(48rem,90dvh)]");
@@ -60,17 +67,16 @@ describe("Plugins dialog content", () => {
/>,
);
expect(markup).toContain("Featured");
- expect(markup).toContain("Data Extraction");
- expect(markup).toContain("Search");
+ expect(markup).toContain("Web");
+ expect(markup).toContain("Work");
expect(markup).toContain("Add Firecrawl");
expect(markup).toContain("Open Firecrawl");
expect(markup).toContain("cursor-pointer");
expect(markup).not.toContain("Configure Firecrawl");
- expect(markup).toContain("/plugin-logos/context.png");
- expect(markup).toContain("/plugin-logos/firecrawl.svg");
- expect(markup).toContain("/plugin-logos/exa.svg");
- expect(markup).toContain("/plugin-logos/parallel.svg");
- for (const plugin of catalog) expect(markup).toContain(`data-plugin-id="${plugin.id}"`);
+ for (const plugin of catalog) {
+ expect(markup).toContain(plugin.logo.src.replaceAll("'", "'"));
+ expect(markup).toContain(`data-plugin-id="${plugin.id}"`);
+ }
});
it("shows plugin information instead of transport configuration", () => {
@@ -148,4 +154,25 @@ describe("Plugins dialog content", () => {
}),
).toBeNull();
});
+
+ it("keeps removed builtins editable without absorbing current catalog entries", () => {
+ const currentBuiltinServer: McpServer = {
+ ...rawServer,
+ id: McpServerId.make("builtin-firecrawl"),
+ name: "Firecrawl",
+ transport: "url",
+ url: "https://mcp.firecrawl.dev/v2/mcp-oauth",
+ };
+ const resolved = resolvePluginDialogServers([
+ currentBuiltinServer,
+ removedBuiltinServer,
+ rawServer,
+ ]);
+
+ expect(resolved.installedPlugins.map((plugin) => plugin.id)).toEqual(["firecrawl"]);
+ expect(resolved.customServers.map((server) => server.id)).toEqual([
+ "builtin-removed-vendor",
+ "raw-filesystem",
+ ]);
+ });
});
diff --git a/apps/web/src/components/plugins/PluginsDialog.tsx b/apps/web/src/components/plugins/PluginsDialog.tsx
index c7362ee2c..433c4bf10 100644
--- a/apps/web/src/components/plugins/PluginsDialog.tsx
+++ b/apps/web/src/components/plugins/PluginsDialog.tsx
@@ -6,7 +6,12 @@ import {
import type { EnvironmentId, McpServer } from "@t3tools/contracts";
import { ChevronLeftIcon, ChevronRightIcon, SearchIcon } from "lucide-react";
import { useMemo, useState } from "react";
-import { loadCatalog, type PluginDefinition, type PluginSkill } from "../../../../../plugins";
+import {
+ loadCatalog,
+ resolveCatalogInstallations,
+ type PluginDefinition,
+ type PluginSkill,
+} from "../../../../../plugins";
import { ensureLocalApi } from "../../localApi";
import { cn } from "../../lib/utils";
import { closePlugins, usePluginsDialogStore } from "../../pluginsDialogStore";
@@ -45,6 +50,26 @@ import {
const CATALOG = loadCatalog();
+export function resolvePluginDialogServers(
+ servers: readonly McpServer[],
+ catalog: readonly PluginDefinition[] = CATALOG,
+): {
+ readonly installedPlugins: readonly PluginDefinition[];
+ readonly customServers: readonly McpServer[];
+} {
+ const legacyIds = new Set(
+ resolveCatalogInstallations(servers, catalog).flatMap((installation) =>
+ installation.kind === "legacy" ? [installation.serverId] : [],
+ ),
+ );
+ return {
+ installedPlugins: catalog.filter((plugin) => findPluginServer(plugin, servers)?.enabled),
+ customServers: servers.filter(
+ (server) => !isBuiltinMcpServer(server) || legacyIds.has(server.id),
+ ),
+ };
+}
+
export const PLUGIN_DIALOG_CLASS_NAME = "h-[min(48rem,90dvh)] max-w-5xl flex-col overflow-hidden";
export const PLUGIN_DIRECTORY_HEADER_CLASS_NAME =
"max-h-[45%] min-h-0 shrink-0 gap-3 overflow-y-auto overscroll-contain px-6 py-5";
@@ -129,8 +154,7 @@ function PluginsDialogForEnvironment({ environmentId }: { readonly environmentId
() => buildPluginSections({ plugins: CATALOG, query, filter }),
[filter, query],
);
- const customServers = servers.filter((server) => !isBuiltinMcpServer(server));
- const installedPlugins = CATALOG.filter((plugin) => findPluginServer(plugin, servers)?.enabled);
+ const { customServers, installedPlugins } = resolvePluginDialogServers(servers);
const installedSections = buildInstalledPluginSection({ plugins: installedPlugins, query });
const validationError = validateMcpServerDraft(draft);
diff --git a/apps/web/src/components/plugins/pluginPresentation.test.ts b/apps/web/src/components/plugins/pluginPresentation.test.ts
index af908cb65..29bd8ca69 100644
--- a/apps/web/src/components/plugins/pluginPresentation.test.ts
+++ b/apps/web/src/components/plugins/pluginPresentation.test.ts
@@ -14,19 +14,24 @@ describe("plugin presentation", () => {
expect(sections[0]?.title).toBe("Featured");
expect(sections[0]?.plugins.map((plugin) => plugin.id)).toEqual([
"context",
- "exa",
- "executor",
"firecrawl",
+ "exa",
"parallel-search",
+ "executor",
]);
- expect(sections.some((section) => section.title === "Data Extraction")).toBe(true);
- expect(sections.some((section) => section.title === "Search")).toBe(true);
+ expect(sections.some((section) => section.title === "Web")).toBe(true);
+ expect(sections.some((section) => section.title === "Work")).toBe(true);
expect(PLUGIN_FILTERS).toEqual([
"All",
"Featured",
- "Data Extraction",
- "Search",
- "Productivity",
+ "Work",
+ "Web",
+ "Marketing",
+ "Build",
+ "Design",
+ "Sales",
+ "Support",
+ "Commerce",
]);
});
@@ -39,19 +44,21 @@ describe("plugin presentation", () => {
});
it("filters by category and search text", () => {
- const searchPlugins = buildPluginSections({
+ const webPlugins = buildPluginSections({
plugins: catalog,
query: "",
- filter: "Search",
+ filter: "Web",
});
- expect(searchPlugins[0]?.plugins.map((plugin) => plugin.id)).toEqual([
+ expect(webPlugins[0]?.plugins.map((plugin) => plugin.id)).toEqual([
+ "context",
+ "firecrawl",
"exa",
"parallel-search",
]);
const extraction = buildPluginSections({
plugins: catalog,
- query: "data extraction",
+ query: "scrape",
filter: "All",
});
expect(extraction[0]?.plugins.map((plugin) => plugin.id)).toEqual(["context", "firecrawl"]);
diff --git a/apps/web/src/components/roster/BotToolsSheet.test.ts b/apps/web/src/components/roster/BotToolsSheet.test.ts
index eb30e52d9..13d693556 100644
--- a/apps/web/src/components/roster/BotToolsSheet.test.ts
+++ b/apps/web/src/components/roster/BotToolsSheet.test.ts
@@ -1,20 +1,11 @@
import { McpServerId, type McpServer } from "@t3tools/contracts";
import { describe, expect, it } from "vite-plus/test";
-import type { PluginDefinition } from "../../../../../plugins";
+import { loadCatalog } from "../../../../../plugins";
import { buildBotToolItems, planBotToolToggle } from "./BotToolsSheet";
-const installedPlugin: PluginDefinition = {
- id: "exa",
- title: "Exa",
- description: "Search the web.",
- category: "Search",
- logo: { src: "/plugin-logos/exa.svg" },
- kind: "mcp-url",
- authentication: "optional-oauth",
- url: "https://mcp.exa.ai/mcp",
- builtin: true,
-};
+const installedPlugin = loadCatalog().find((plugin) => plugin.id === "exa");
+if (!installedPlugin) throw new TypeError("Exa must remain in the plugin catalog.");
const globalServer: McpServer = {
id: McpServerId.make("builtin-exa"),
@@ -42,6 +33,24 @@ describe("bot plugin exclusions", () => {
expect(buildBotToolItems([{ ...globalServer, enabled: false }], [installedPlugin])).toEqual([]);
});
+ it("keeps an enabled removed builtin available as a per-bot tool", () => {
+ const removedServer: McpServer = {
+ ...globalServer,
+ id: McpServerId.make("builtin-removed-vendor"),
+ name: "Removed Vendor",
+ };
+
+ expect(buildBotToolItems([removedServer], [installedPlugin])).toEqual([
+ {
+ id: "builtin-removed-vendor",
+ kind: "plugin",
+ name: "Removed Vendor",
+ description: "https://mcp.exa.ai/mcp",
+ workspaceEnabled: true,
+ },
+ ]);
+ });
+
it("stores only per-bot exclusions when a bot disables a plugin", () => {
const exaId = McpServerId.make("builtin-exa");
const otherId = McpServerId.make("custom-other");
diff --git a/apps/web/src/components/roster/BotToolsSheet.tsx b/apps/web/src/components/roster/BotToolsSheet.tsx
index fc42e53ba..d2f539c48 100644
--- a/apps/web/src/components/roster/BotToolsSheet.tsx
+++ b/apps/web/src/components/roster/BotToolsSheet.tsx
@@ -3,8 +3,12 @@ import { PuzzleIcon, SearchIcon, ServerIcon, XIcon } from "lucide-react";
import { useEffect, useMemo, useState } from "react";
import { createPortal } from "react-dom";
-import { loadCatalog, type PluginDefinition } from "../../../../../plugins";
-import { findPluginServer, isBuiltinMcpServer } from "../plugins/pluginRegistry";
+import {
+ loadCatalog,
+ resolveCatalogInstallations,
+ type PluginDefinition,
+} from "../../../../../plugins";
+import { isBuiltinMcpServer } from "../plugins/pluginRegistry";
import { Button } from "../ui/button";
import { Input } from "../ui/input";
import { Switch } from "../ui/switch";
@@ -41,20 +45,30 @@ export function buildBotToolItems(
servers: readonly McpServer[],
catalog: readonly PluginDefinition[] = CATALOG,
): readonly BotToolItem[] {
- const plugins = catalog.flatMap((plugin) => {
- const server = findPluginServer(plugin, servers);
- return server?.enabled
+ const serversById = new Map<string, McpServer>(servers.map((server) => [server.id, server]));
+ const plugins = resolveCatalogInstallations(servers, catalog).flatMap((installation) => {
+ const server = serversById.get(installation.serverId);
+ if (!server?.enabled) return [];
+ return installation.kind === "catalog"
? [
{
id: server.id,
kind: "plugin" as const,
- name: plugin.title,
- description: plugin.description,
+ name: installation.plugin.title,
+ description: installation.plugin.description,
workspaceEnabled: true,
- logo: plugin.logo,
+ logo: installation.plugin.logo,
},
]
- : [];
+ : [
+ {
+ id: server.id,
+ kind: "plugin" as const,
+ name: installation.title,
+ description: mcpDescription(server),
+ workspaceEnabled: true,
+ },
+ ];
});
const mcpServers = servers
.filter((server) => server.enabled && !isBuiltinMcpServer(server))
diff --git a/apps/web/src/components/sidebar/SidebarChrome.test.ts b/apps/web/src/components/sidebar/SidebarChrome.test.ts
index 143afa341..53acfebbd 100644
--- a/apps/web/src/components/sidebar/SidebarChrome.test.ts
+++ b/apps/web/src/components/sidebar/SidebarChrome.test.ts
@@ -1,9 +1,26 @@
// @effect-diagnostics nodeBuiltinImport:off - This integration guard reads related source files.
import * as NodeFS from "node:fs";
+import { McpServerId, type McpServer } from "@t3tools/contracts";
import { describe, expect, it } from "vite-plus/test";
-import { formatEnabledPluginStatus } from "./SidebarChrome";
+import { loadCatalog } from "../../../../../plugins";
+import { formatEnabledPluginStatus, summarizeEnabledPlugins } from "./SidebarChrome";
+
+const catalogPlugin = loadCatalog().find((plugin) => plugin.id === "exa");
+if (!catalogPlugin) throw new TypeError("Exa must remain in the plugin catalog.");
+
+function server(id: string, enabled = true): McpServer {
+ return {
+ id: McpServerId.make(id),
+ name: id,
+ transport: "url",
+ url: "https://mcp.example.com",
+ enabled,
+ createdAt: "2026-08-27T00:00:00.000Z",
+ updatedAt: "2026-08-27T00:00:00.000Z",
+ };
+}
describe("sidebar footer", () => {
it("describes real enabled state without claiming an account connection", () => {
@@ -12,6 +29,16 @@ describe("sidebar footer", () => {
expect(formatEnabledPluginStatus(3)).toBe("3 plugins enabled");
});
+ it("counts removed builtins and custom MCP servers without inventing catalog logos", () => {
+ const summary = summarizeEnabledPlugins(
+ [server("builtin-exa"), server("builtin-removed-vendor"), server("custom-mcp")],
+ [catalogPlugin],
+ );
+
+ expect(summary.enabledCount).toBe(3);
+ expect(summary.enabledPlugins).toEqual([catalogPlugin]);
+ });
+
it("keeps the error inbox in Settings instead of the sidebar", () => {
const source = NodeFS.readFileSync(new URL("./SidebarChrome.tsx", import.meta.url), "utf8");
diff --git a/apps/web/src/components/sidebar/SidebarChrome.tsx b/apps/web/src/components/sidebar/SidebarChrome.tsx
index 1b2e00726..3eb88668b 100644
--- a/apps/web/src/components/sidebar/SidebarChrome.tsx
+++ b/apps/web/src/components/sidebar/SidebarChrome.tsx
@@ -5,11 +5,15 @@ import {
PlugSocketIcon,
Settings02Icon,
} from "@hugeicons/core-free-icons";
-import type { EnvironmentId } from "@t3tools/contracts";
+import type { EnvironmentId, McpServer } from "@t3tools/contracts";
import { Link } from "@tanstack/react-router";
import type { ReactNode } from "react";
import { memo, useCallback } from "react";
-import { loadCatalog } from "../../../../../plugins";
+import {
+ loadCatalog,
+ resolveCatalogInstallations,
+ type PluginDefinition,
+} from "../../../../../plugins";
import { useEnvironmentIdentificationMode } from "../../hooks/useSettings";
import { openSettings } from "../../settingsDialogStore";
@@ -21,7 +25,7 @@ import { environmentMcpServersAtom } from "../../state/mcpServers";
import { AkeruMark } from "../AkeruMark";
import { T3ConnectSidebarAvatar, T3ConnectSidebarSignIn } from "../clerk/T3ConnectSidebarSignIn";
import { PluginLogoImage } from "../plugins/PluginsCatalog";
-import { findPluginServer, isBuiltinMcpServer } from "../plugins/pluginRegistry";
+import { isBuiltinMcpServer } from "../plugins/pluginRegistry";
import { cn } from "../../lib/utils";
import {
resolveEnvironmentIdentificationPillLabel,
@@ -122,6 +126,29 @@ export function formatEnabledPluginStatus(enabledCount: number): string {
return `${enabledCount} ${enabledCount === 1 ? "plugin" : "plugins"} enabled`;
}
+export function summarizeEnabledPlugins(
+ servers: readonly McpServer[],
+ catalog: readonly PluginDefinition[] = PLUGIN_CATALOG,
+): { readonly enabledPlugins: readonly PluginDefinition[]; readonly enabledCount: number } {
+ const enabledIds = new Set<string>(
+ servers.filter((server) => server.enabled).map((server) => server.id),
+ );
+ const installations = resolveCatalogInstallations(servers, catalog);
+ const enabledPluginIds = new Set(
+ installations.flatMap((installation) =>
+ installation.kind === "catalog" && enabledIds.has(installation.serverId)
+ ? [installation.plugin.id]
+ : [],
+ ),
+ );
+ return {
+ enabledPlugins: catalog.filter((plugin) => enabledPluginIds.has(plugin.id)),
+ enabledCount:
+ installations.filter((installation) => enabledIds.has(installation.serverId)).length +
+ servers.filter((server) => server.enabled && !isBuiltinMcpServer(server)).length,
+ };
+}
+
function SidebarPluginSummaryForEnvironment({
environmentId,
onClick,
@@ -130,13 +157,7 @@ function SidebarPluginSummaryForEnvironment({
readonly onClick: () => void;
}) {
const servers = useAtomValue(environmentMcpServersAtom(environmentId));
- const enabledPlugins = PLUGIN_CATALOG.filter(
- (plugin) => findPluginServer(plugin, servers)?.enabled,
- );
- const enabledCustomCount = servers.filter(
- (server) => server.enabled && !isBuiltinMcpServer(server),
- ).length;
- const enabledCount = enabledPlugins.length + enabledCustomCount;
+ const { enabledCount, enabledPlugins } = summarizeEnabledPlugins(servers);
const statusLabel = formatEnabledPluginStatus(enabledCount);
return (
diff --git a/docs/user/plugins.md b/docs/user/plugins.md
index e0168227e..29c073c12 100644
--- a/docs/user/plugins.md
+++ b/docs/user/plugins.md
@@ -1,6 +1,6 @@
# Plugins
-Open **Plugins** from the sidebar or command palette. Browse focused sections such as **Data Extraction** and **Search**, or search by plugin name, description, or category. Select a plugin to see what it does, inspect its connector, copy its source link, or open its documentation. Choose **Add** to install it for the current environment and enable it for every bot by default. Use a bot's **Plugins** setting to disable it for that bot. Choose **Added** to disable it for the environment.
+Open **Plugins** from the sidebar or command palette. Browse focused sections such as **Web** and **Work**, or search by plugin name, description, or category. Select a plugin to see what it does, inspect its connector, copy its source link, or open its documentation. Choose **Add** to install it for the current environment and enable it for every bot by default. Use a bot's **Plugins** setting to disable it for that bot. Choose **Added** to disable it for the environment.
Select the installed and custom count below the title to review active plugins and custom MCP servers. Builtin plugins use their catalog configuration and do not expose transport editing. Akeru Bot stores no plugin credentials in the catalog or MCP registry. Keep credentials in the host environment or the service sign-in flow.
diff --git a/package.json b/package.json
index bf504b2f5..736232400 100644
--- a/package.json
+++ b/package.json
@@ -18,6 +18,7 @@
"screenshots:mobile": "node scripts/mobile-showcase.ts",
"icons:export": "node scripts/export-brand-icons.ts",
"icons:check": "node scripts/export-brand-icons.ts --check",
+ "plugins:check": "node scripts/validate-plugin-catalog.ts",
"build": "vp run --filter './apps/*' --filter './packages/*' --filter './oxlint-plugin-t3code' --filter './scripts' build",
"build:marketing": "vp run --filter @t3tools/marketing build",
"build:desktop": "vp run --filter @t3tools/desktop --filter akeru-bot build",
diff --git a/plugins/AGENTS.md b/plugins/AGENTS.md
new file mode 100644
index 000000000..47abf2cca
--- /dev/null
+++ b/plugins/AGENTS.md
@@ -0,0 +1,9 @@
+# Plugin catalog
+
+- Keep one plugin in each `entries/<id>/` directory.
+- Each directory contains `plugin.json`, `logo.svg`, and `logo-dark.svg`. Do not add generated catalog files.
+- Preserve an existing plugin `id`. Its MCP server ID remains `builtin-<id>`.
+- Mark a plugin `available` only after its real connection lifecycle passes.
+- Use `approval-pending` with an explicit blocker when a vendor must approve access.
+- Declare an approval for send, pay, delete, production, secrets, publishing, signatures, refunds, and account-wide changes.
+- Run `bun run plugins:check` and the focused catalog tests after each entry change.
diff --git a/plugins/README.md b/plugins/README.md
new file mode 100644
index 000000000..637f73ee0
--- /dev/null
+++ b/plugins/README.md
@@ -0,0 +1,11 @@
+# Plugin directory
+
+The live `entries/` tree is the plugin catalog. Each `entries/<id>/` directory owns one `plugin.json` manifest plus official `logo.svg` and `logo-dark.svg` assets. The loader preserves the manifest ID as `builtin-<id>` and orders featured entries by `featuredRank`.
+
+An available entry needs a real HTTPS URL or stdio command. A blocked vendor entry uses an unavailable transport, `approval-pending` connection and catalog status, and a concrete blocker. Permission declarations must name each consequential approval class that the plugin can require.
+
+Run the catalog validator before review:
+
+```sh
+bun run plugins:check
+```
diff --git a/plugins/catalog.test.ts b/plugins/catalog.test.ts
index 14c11e142..add7bc20d 100644
--- a/plugins/catalog.test.ts
+++ b/plugins/catalog.test.ts
@@ -1,93 +1,191 @@
import * as NodeFS from "node:fs";
-import { describe, expect, it } from "vite-plus/test";
+import { describe, expect, expectTypeOf, it } from "vite-plus/test";
-import context from "./context";
-import { loadCatalog } from "./index";
+import {
+ isInstallablePlugin,
+ loadCatalog,
+ loadDirectoryCatalog,
+ resolveCatalogInstallations,
+ type PluginDefinition,
+} from "./catalog";
+import { parsePluginManifestJson } from "./schema";
-const CATALOG_IDS = ["context", "exa", "executor", "firecrawl", "parallel-search"];
-const DISALLOWED_ID_PART = ["pipe", "dream"].join("");
+const EXPECTED_IDS = ["context", "firecrawl", "exa", "parallel-search", "executor"];
-describe("plugin catalog", () => {
- it("loads the focused builtin catalog with unique launch recipes", () => {
- const catalog = loadCatalog();
- const ids = catalog.map((plugin) => plugin.id);
- expect(ids.toSorted()).toEqual(CATALOG_IDS);
- expect(new Set(ids).size).toBe(catalog.length);
- expect(ids.some((id) => id.includes(DISALLOWED_ID_PART))).toBe(false);
- for (const plugin of catalog) {
- expect(plugin.builtin).toBe(true);
- expect(plugin.featured).toBe(true);
- expect(plugin.title.trim()).not.toBe("");
- expect(plugin.description.trim()).not.toBe("");
- expect(plugin.category.trim()).not.toBe("");
- expect(
- NodeFS.existsSync(new URL(`../apps/web/public${plugin.logo.src}`, import.meta.url)),
- ).toBe(true);
- if (plugin.logo.darkSrc) {
- expect(
- NodeFS.existsSync(new URL(`../apps/web/public${plugin.logo.darkSrc}`, import.meta.url)),
- ).toBe(true);
- }
- if (plugin.docsUrl) expect(plugin.docsUrl).toMatch(/^https:\/\//);
- for (const skill of plugin.skills ?? []) {
- expect(skill.title.trim()).not.toBe("");
- expect(skill.description.trim()).not.toBe("");
- expect(skill.url).toMatch(/^https:\/\/skills\.sh\//);
- }
- if (plugin.kind === "mcp-url") {
- expect(plugin.url).toMatch(/^https:\/\//);
- expect(["none", "oauth", "optional-oauth"]).toContain(plugin.authentication);
- } else {
- expect(plugin.command.trim()).not.toBe("");
- }
+function manifest(id: string) {
+ return parsePluginManifestJson(
+ NodeFS.readFileSync(new URL(`./entries/${id}/plugin.json`, import.meta.url), "utf8"),
+ id,
+ );
+}
+
+describe("plugin catalog loader", () => {
+ it("loads unavailable entries for the directory without installing them", () => {
+ const context = manifest("context");
+ const pending = {
+ ...context,
+ id: "pending-vendor",
+ name: "Pending Vendor",
+ transport: { type: "unavailable" },
+ connection: {
+ type: "approval-pending",
+ blocker: "The vendor must approve Akeru as an OAuth client.",
+ },
+ catalogStatus: "approval-pending",
+ };
+ expect(
+ loadDirectoryCatalog(
+ { "./entries/pending-vendor/plugin.json": pending },
+ {
+ "./entries/pending-vendor/logo.svg": "/pending-vendor.svg",
+ "./entries/pending-vendor/logo-dark.svg": "/pending-vendor-dark.svg",
+ },
+ )[0],
+ ).toMatchObject({ id: "pending-vendor", kind: "mcp-unavailable" });
+ });
+
+ it("shows pending URL entries without making them installable", () => {
+ const context = manifest("context");
+ const pending = {
+ ...context,
+ id: "pending-vendor",
+ name: "Pending Vendor",
+ transport: { type: "url", url: "https://mcp.pending.example/mcp" },
+ connection: {
+ type: "approval-pending",
+ blocker: "The vendor must approve Akeru as an OAuth client.",
+ },
+ catalogStatus: "approval-pending",
+ };
+ const modules = {
+ "./entries/context/plugin.json": context,
+ "./entries/pending-vendor/plugin.json": pending,
+ };
+ const assets = {
+ "./entries/context/logo.svg": "/context.svg",
+ "./entries/context/logo-dark.svg": "/context-dark.svg",
+ "./entries/pending-vendor/logo.svg": "/pending-vendor.svg",
+ "./entries/pending-vendor/logo-dark.svg": "/pending-vendor-dark.svg",
+ };
+
+ const directory = loadDirectoryCatalog(modules, assets);
+ expect(directory).toMatchObject([
+ { id: "context", kind: "mcp-url", catalogStatus: "available" },
+ { id: "pending-vendor", kind: "mcp-url", catalogStatus: "approval-pending" },
+ ]);
+ const pendingPlugin = directory[1];
+ expect(isInstallablePlugin(directory[0]!)).toBe(true);
+ expect(isInstallablePlugin(pendingPlugin!)).toBe(false);
+ if (pendingPlugin?.catalogStatus !== "approval-pending") {
+ throw new Error("Expected the pending vendor in the directory catalog.");
}
+ expectTypeOf(pendingPlugin).not.toMatchTypeOf<PluginDefinition>();
+
+ const installable = loadCatalog(modules, assets);
+ expect(installable.map((plugin) => plugin.id)).toEqual(["context"]);
+ expect(
+ resolveCatalogInstallations(
+ [
+ { id: "builtin-pending-vendor", name: "Pending Vendor" },
+ { id: "custom-mcp", name: "Custom MCP" },
+ ],
+ directory,
+ ),
+ ).toEqual([
+ {
+ kind: "catalog",
+ serverId: "builtin-pending-vendor",
+ plugin: expect.objectContaining({
+ id: "pending-vendor",
+ catalogStatus: "approval-pending",
+ connection: {
+ type: "approval-pending",
+ blocker: "The vendor must approve Akeru as an OAuth client.",
+ },
+ }),
+ },
+ ]);
});
- it("keeps the verified hosted services in focused sections", () => {
- const byId = new Map(loadCatalog().map((plugin) => [plugin.id, plugin]));
+ it("migrates the five identities and working recipes", () => {
+ const catalog = loadCatalog();
+ expect(catalog.map((plugin) => plugin.id)).toEqual(EXPECTED_IDS);
+ expect(catalog.map((plugin) => `builtin-${plugin.id}`)).toEqual(
+ EXPECTED_IDS.map((id) => `builtin-${id}`),
+ );
+ expect(catalog.map((plugin) => plugin.featuredRank)).toEqual([1, 2, 3, 4, 5]);
+ expect(catalog.map((plugin) => plugin.category)).toEqual(["Web", "Web", "Web", "Web", "Work"]);
+ expect(catalog.every((plugin) => plugin.logo.src.length > 0)).toBe(true);
+ const byId = new Map(catalog.map((plugin) => [plugin.id, plugin]));
expect(byId.get("context")).toMatchObject({
- category: "Data Extraction",
+ kind: "mcp-url",
url: "https://mcp.context.dev/mcp",
authentication: "oauth",
});
- expect(byId.get("firecrawl")).toMatchObject({
- category: "Data Extraction",
- url: "https://mcp.firecrawl.dev/v2/mcp-oauth",
- authentication: "oauth",
- });
expect(byId.get("exa")).toMatchObject({
- category: "Search",
+ kind: "mcp-url",
url: "https://mcp.exa.ai/mcp",
authentication: "optional-oauth",
});
- expect(byId.get("parallel-search")).toMatchObject({
- category: "Search",
- url: "https://search.parallel.ai/mcp-oauth",
- authentication: "oauth",
- });
expect(byId.get("executor")).toMatchObject({
- category: "Productivity",
+ kind: "mcp-stdio",
command: "bunx",
args: ["-y", "executor", "mcp"],
});
- expect(byId.get("firecrawl")?.skills?.[0]?.url).toBe(
- "https://skills.sh/firecrawl/cli/firecrawl",
- );
- expect(byId.get("exa")?.skills?.[0]?.url).toBe(
- "https://skills.sh/exa-labs/agent-skills/exa-search",
- );
- expect(byId.get("parallel-search")?.skills?.[0]?.url).toBe(
- "https://skills.sh/parallel-web/parallel-agent-skills/parallel-web-search",
- );
+ expect(byId.get("firecrawl")).toMatchObject({
+ kind: "mcp-url",
+ url: "https://mcp.firecrawl.dev/v2/mcp-oauth",
+ authentication: "oauth",
+ });
+ expect(byId.get("parallel-search")).toMatchObject({
+ kind: "mcp-url",
+ url: "https://search.parallel.ai/mcp-oauth",
+ authentication: "oauth",
+ });
});
- it("rejects duplicate ids", () => {
+ it("rejects duplicate ids and mismatched isolated directories", () => {
+ const context = manifest("context");
+ const assets = {
+ "./entries/context/logo.svg": "/context.svg",
+ "./entries/context/logo-dark.svg": "/context-dark.svg",
+ "./entries/context-copy/logo.svg": "/context-copy.svg",
+ "./entries/context-copy/logo-dark.svg": "/context-copy-dark.svg",
+ };
expect(() =>
- loadCatalog({
- "./context.ts": { default: context },
- "./context-copy.ts": { default: context },
- }),
+ loadCatalog(
+ {
+ "./entries/context/plugin.json": context,
+ "./entries/context-copy/plugin.json": context,
+ },
+ assets,
+ ),
).toThrow("Duplicate plugin id 'context'");
+ expect(() => loadCatalog({ "./entries/wrong/plugin.json": context }, assets)).toThrow(
+ "must live in entries/context",
+ );
+ });
+
+ it("keeps removed builtins visible and Custom MCP independent", () => {
+ const catalog = loadCatalog();
+ expect(
+ resolveCatalogInstallations(
+ [
+ { id: "builtin-exa", name: "Exa" },
+ { id: "builtin-removed-vendor", name: "Removed Vendor" },
+ { id: "custom-mcp", name: "Custom MCP" },
+ ],
+ catalog,
+ ),
+ ).toEqual([
+ { kind: "catalog", serverId: "builtin-exa", plugin: catalog[2] },
+ {
+ kind: "legacy",
+ serverId: "builtin-removed-vendor",
+ pluginId: "removed-vendor",
+ title: "Removed Vendor",
+ },
+ ]);
});
});
diff --git a/plugins/catalog.ts b/plugins/catalog.ts
new file mode 100644
index 000000000..022b36cfa
--- /dev/null
+++ b/plugins/catalog.ts
@@ -0,0 +1,209 @@
+import type { PluginCategory } from "./categories";
+import { parsePluginManifest, type PluginManifest, type PluginSkill } from "./schema";
+
+export interface PluginLogo {
+ readonly src: string;
+ readonly darkSrc?: string;
+ readonly provenance?: PluginManifest["logo"]["provenance"];
+}
+
+interface CatalogPluginBase extends Omit<PluginManifest, "logo"> {
+ readonly title: string;
+ readonly category: PluginCategory;
+ readonly logo: PluginLogo;
+ readonly featured?: true;
+ readonly docsUrl: string;
+ readonly builtin: true;
+}
+
+interface DirectoryUrlPlugin extends CatalogPluginBase {
+ readonly kind: "mcp-url";
+ readonly transport: Extract<PluginManifest["transport"], { readonly type: "url" }>;
+ readonly url: string;
+ readonly command?: never;
+ readonly args?: never;
+}
+
+interface DirectoryStdioPlugin extends CatalogPluginBase {
+ readonly kind: "mcp-stdio";
+ readonly transport: Extract<PluginManifest["transport"], { readonly type: "stdio" }>;
+ readonly command: string;
+ readonly args?: readonly string[];
+ readonly url?: never;
+}
+
+type InstallableConnection = Exclude<
+ PluginManifest["connection"],
+ { readonly type: "approval-pending" }
+>;
+
+export type CatalogPluginDefinition = (DirectoryUrlPlugin | DirectoryStdioPlugin) & {
+ readonly catalogStatus: "available";
+ readonly connection: InstallableConnection;
+};
+
+interface PendingPluginDefinition extends CatalogPluginBase {
+ readonly kind: "mcp-unavailable";
+ readonly transport: { readonly type: "unavailable" };
+ readonly url?: never;
+ readonly command?: never;
+ readonly args?: never;
+}
+
+export type PluginDirectoryDefinition =
+ | DirectoryUrlPlugin
+ | DirectoryStdioPlugin
+ | PendingPluginDefinition;
+
+export type PluginDefinition = CatalogPluginDefinition;
+export type { PluginSkill };
+
+type CatalogModules = Readonly<Record<string, unknown>>;
+type AssetModules = Readonly<Record<string, string>>;
+
+const catalogModules = import.meta.glob<unknown>("./entries/*/plugin.json", {
+ eager: true,
+ import: "default",
+});
+const catalogAssets = import.meta.glob<string>(
+ ["./entries/*/logo.svg", "./entries/*/logo-dark.svg"],
+ {
+ eager: true,
+ import: "default",
+ query: "?url",
+ },
+);
+
+function pluginDirectory(manifestPath: string): string {
+ const match = /^\.\/entries\/([^/]+)\/plugin\.json$/.exec(manifestPath);
+ if (!match?.[1]) throw new TypeError(`Invalid plugin manifest path '${manifestPath}'.`);
+ return match[1];
+}
+
+function assetUrl(
+ assets: AssetModules,
+ directory: string,
+ filename: string,
+ pluginId: string,
+): string {
+ const path = `./entries/${directory}/${filename}`;
+ const url = assets[path];
+ if (!url) throw new TypeError(`Plugin '${pluginId}' is missing logo asset '${filename}'.`);
+ return url;
+}
+
+function toPluginDefinition(
+ manifest: PluginManifest,
+ directory: string,
+ assets: AssetModules,
+): PluginDirectoryDefinition {
+ if (manifest.id !== directory) {
+ throw new TypeError(`Plugin '${manifest.id}' must live in entries/${manifest.id}/.`);
+ }
+ const logo = {
+ ...manifest.logo,
+ src: assetUrl(assets, directory, "logo.svg", manifest.id),
+ darkSrc: assetUrl(assets, directory, "logo-dark.svg", manifest.id),
+ };
+ const base = {
+ ...manifest,
+ title: manifest.name,
+ category: manifest.primaryCategory,
+ logo,
+ ...(manifest.featuredRank === undefined ? {} : { featured: true as const }),
+ docsUrl: manifest.documentationUrl,
+ builtin: true as const,
+ };
+ if (manifest.transport.type === "url") {
+ return Object.freeze({
+ ...base,
+ kind: "mcp-url" as const,
+ transport: manifest.transport,
+ url: manifest.transport.url,
+ });
+ }
+ if (manifest.transport.type === "stdio") {
+ return Object.freeze({
+ ...base,
+ kind: "mcp-stdio" as const,
+ transport: manifest.transport,
+ command: manifest.transport.command,
+ ...(manifest.transport.args ? { args: manifest.transport.args } : {}),
+ });
+ }
+ return Object.freeze({
+ ...base,
+ kind: "mcp-unavailable" as const,
+ transport: manifest.transport,
+ });
+}
+
+function comparePluginOrder(
+ left: PluginDirectoryDefinition,
+ right: PluginDirectoryDefinition,
+): number {
+ return (
+ (left.featuredRank ?? Number.POSITIVE_INFINITY) -
+ (right.featuredRank ?? Number.POSITIVE_INFINITY) || left.id.localeCompare(right.id)
+ );
+}
+
+export function loadDirectoryCatalog(
+ modules: CatalogModules = catalogModules,
+ assets: AssetModules = catalogAssets,
+): readonly PluginDirectoryDefinition[] {
+ const ids = new Set<string>();
+ const plugins = Object.entries(modules).map(([path, input]) => {
+ const directory = pluginDirectory(path);
+ const manifest = parsePluginManifest(input, path);
+ if (ids.has(manifest.id)) throw new TypeError(`Duplicate plugin id '${manifest.id}'.`);
+ ids.add(manifest.id);
+ return toPluginDefinition(manifest, directory, assets);
+ });
+ return Object.freeze(plugins.toSorted(comparePluginOrder));
+}
+
+export function isInstallablePlugin(plugin: PluginDirectoryDefinition): plugin is PluginDefinition {
+ return (
+ plugin.catalogStatus === "available" &&
+ plugin.kind !== "mcp-unavailable" &&
+ plugin.connection.type !== "approval-pending"
+ );
+}
+
+export function loadCatalog(
+ modules: CatalogModules = catalogModules,
+ assets: AssetModules = catalogAssets,
+): readonly CatalogPluginDefinition[] {
+ return loadDirectoryCatalog(modules, assets).filter(isInstallablePlugin);
+}
+
+const BUILTIN_PREFIX = "builtin-";
+
+export type CatalogInstallation =
+ | {
+ readonly kind: "catalog";
+ readonly serverId: string;
+ readonly plugin: PluginDirectoryDefinition;
+ }
+ | {
+ readonly kind: "legacy";
+ readonly serverId: string;
+ readonly pluginId: string;
+ readonly title: string;
+ };
+
+export function resolveCatalogInstallations(
+ installed: readonly { readonly id: string; readonly name: string }[],
+ catalog: readonly PluginDirectoryDefinition[] = loadDirectoryCatalog(),
+): readonly CatalogInstallation[] {
+ const byId = new Map(catalog.map((plugin) => [plugin.id, plugin]));
+ return installed.flatMap((server): readonly CatalogInstallation[] => {
+ if (!server.id.startsWith(BUILTIN_PREFIX)) return [];
+ const pluginId = server.id.slice(BUILTIN_PREFIX.length);
+ const plugin = byId.get(pluginId);
+ return plugin
+ ? [{ kind: "catalog", serverId: server.id, plugin }]
+ : [{ kind: "legacy", serverId: server.id, pluginId, title: server.name }];
+ });
+}
diff --git a/plugins/categories.ts b/plugins/categories.ts
new file mode 100644
index 000000000..4e40e7f50
--- /dev/null
+++ b/plugins/categories.ts
@@ -0,0 +1,28 @@
+export const PLUGIN_CATEGORIES = [
+ "Work",
+ "Web",
+ "Marketing",
+ "Build",
+ "Design",
+ "Sales",
+ "Support",
+ "Commerce",
+] as const;
+
+export type CatalogCategory = (typeof PLUGIN_CATEGORIES)[number];
+
+export type PluginCategory = CatalogCategory;
+
+export const PLUGIN_APPROVAL_CLASSES = [
+ "send",
+ "pay",
+ "delete",
+ "production",
+ "secrets",
+ "publishing",
+ "signatures",
+ "refunds",
+ "account-wide",
+] as const;
+
+export type PluginApprovalClass = (typeof PLUGIN_APPROVAL_CLASSES)[number];
diff --git a/plugins/context.ts b/plugins/context.ts
deleted file mode 100644
index 07eb12cca..000000000
--- a/plugins/context.ts
+++ /dev/null
@@ -1,18 +0,0 @@
-import { definePlugin } from "./definePlugin";
-
-export default definePlugin({
- id: "context",
- title: "Context.dev",
- description: "Scrape, extract, parse, enrich, and monitor web data.",
- category: "Data Extraction",
- logo: {
- src: "/plugin-logos/context.png",
- darkSrc: "/plugin-logos/context-dark.png",
- },
- featured: true,
- kind: "mcp-url",
- authentication: "oauth",
- url: "https://mcp.context.dev/mcp",
- docsUrl: "https://docs.context.dev/install-mcp",
- builtin: true,
-});
diff --git a/plugins/definePlugin.ts b/plugins/definePlugin.ts
deleted file mode 100644
index 017cef724..000000000
--- a/plugins/definePlugin.ts
+++ /dev/null
@@ -1,80 +0,0 @@
-export type PluginKind = "mcp-stdio" | "mcp-url";
-
-export const PLUGIN_CATEGORIES = ["Data Extraction", "Search", "Productivity"] as const;
-
-export type PluginCategory = (typeof PLUGIN_CATEGORIES)[number];
-
-export interface PluginLogo {
- readonly src: `/plugin-logos/${string}`;
- readonly darkSrc?: `/plugin-logos/${string}`;
-}
-
-export interface PluginSkill {
- readonly title: string;
- readonly description: string;
- readonly url: `https://${string}`;
-}
-
-interface PluginBase {
- readonly id: string;
- readonly title: string;
- readonly description: string;
- readonly category: PluginCategory;
- readonly logo: PluginLogo;
- readonly featured?: true;
- readonly docsUrl?: string;
- readonly skills?: readonly PluginSkill[];
- readonly builtin: true;
-}
-
-interface CommandPlugin extends PluginBase {
- readonly kind: "mcp-stdio";
- readonly command: string;
- readonly args?: readonly string[];
- readonly url?: never;
-}
-
-interface UrlPlugin extends PluginBase {
- readonly kind: "mcp-url";
- readonly url: string;
- readonly authentication: "none" | "oauth" | "optional-oauth";
- readonly command?: never;
- readonly args?: never;
-}
-
-export type PluginDefinition = CommandPlugin | UrlPlugin;
-
-const PLUGIN_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-const DISALLOWED_PROVIDER = ["pipe", "dream"].join("");
-
-export function definePlugin<const T extends PluginDefinition>(plugin: T): Readonly<T> {
- if (!PLUGIN_ID.test(plugin.id)) {
- throw new TypeError(`Plugin id '${plugin.id}' must use stable kebab-case.`);
- }
- if (plugin.id.includes(DISALLOWED_PROVIDER)) {
- throw new TypeError(`Plugin id '${plugin.id}' names an unsupported provider.`);
- }
- if (!plugin.logo.src.startsWith("/plugin-logos/")) {
- throw new TypeError(`Plugin '${plugin.id}' needs a local logo.`);
- }
- if (plugin.title.trim().length === 0 || plugin.description.trim().length === 0) {
- throw new TypeError(`Plugin '${plugin.id}' needs a title and description.`);
- }
- for (const skill of plugin.skills ?? []) {
- if (skill.title.trim().length === 0 || skill.description.trim().length === 0) {
- throw new TypeError(`Plugin '${plugin.id}' has an incomplete skill.`);
- }
- if (new URL(skill.url).protocol !== "https:") {
- throw new TypeError(`Plugin '${plugin.id}' skill URLs must use HTTPS.`);
- }
- }
- if (plugin.kind === "mcp-url") {
- const url = new URL(plugin.url);
- if (url.protocol !== "http:" && url.protocol !== "https:") {
- throw new TypeError(`Plugin '${plugin.id}' needs an HTTP or HTTPS URL.`);
- }
- } else if (plugin.command.trim().length === 0) {
- throw new TypeError(`Plugin '${plugin.id}' needs a command.`);
- }
- return Object.freeze(plugin);
-}
diff --git a/plugins/entries/context/logo-dark.svg b/plugins/entries/context/logo-dark.svg
new file mode 100644
index 000000000..248e06779
--- /dev/null
+++ b/plugins/entries/context/logo-dark.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 772.32 531.2">
+ <path fill="#ffffff" d="M260.5,27.06v240.41c-29-28.17-69.08-44.96-113.07-43.26C69.5,227.24,5.16,289.98.31,367.81c-5.56,89.26,65.18,163.38,153.24,163.38,41.58,0,79.3-16.51,106.95-43.37h0c0,13.26,10.75,24.01,24.01,24.01h129.54c-51.07,0-96.29-24.98-124.23-63.34,2.81-5.4,5.32-10.98,7.47-16.76,0,0,0,0,0,0,.02-.12.06-.23.12-.35.46-1.2.89-2.4,1.3-3.6.41-1.22.81-2.42,1.2-3.64,0-.01,0-.02.01-.03.53-1.64,1.05-3.31,1.5-4.99,0,0,0,0,0,0,.02-.12.06-.23.08-.35,0,0,0-.01,0-.02.33-1.08.61-2.18.87-3.27,0-.02,0-.03.01-.04.12-.47.23-.95.35-1.43.27-1.08.52-2.15.74-3.23.06-.25.1-.5.17-.74.06-.29.12-.58.19-.89.04-.19.08-.37.13-.54.16-.85.33-1.7.47-2.55.04-.12.06-.25.08-.37.02-.1.04-.21.06-.33.12-.7.25-1.41.37-2.11.1-.58.19-1.18.29-1.76.02-.12.04-.23.04-.35.25-1.53.46-3.06.64-4.61.08-.72.17-1.45.25-2.17.04-.23.06-.45.08-.68h0c.06-.54.1-1.1.14-1.63h0c.02-.06.02-.13.02-.17.02-.19.04-.35.04-.54.1-.97.19-1.95.23-2.92.02-.1.04-.21.02-.31.06-.52.08-1.03.1-1.55.02-.1.02-.21.02-.31.04-.52.06-1.01.08-1.53h0c.04-.62.06-1.24.06-1.86h0c.02-.15.02-.27.02-.39.06-1.59.08-3.19.08-4.78h0c0-1.05-.02-2.11-.04-3.14,0-.39,0-.79-.02-1.16,0-.35-.02-.7-.04-1.06,0-.56-.02-1.12-.06-1.68,0-.29-.02-.58-.04-.87,0-.12,0-.23-.02-.33,0-.21-.02-.41-.04-.6,0-.19,0-.37-.02-.56,0-.08,0-.17-.02-.25-.02-.37-.04-.74-.06-1.1-.02-.37-.06-.72-.08-1.08,0-.08,0-.16-.02-.23-.04-.77-.12-1.55-.21-2.34-.02-.41-.06-.81-.1-1.2-.02-.14-.02-.29-.04-.41-.12-1.2-.27-2.38-.41-3.56-.06-.48-.12-.95-.19-1.43-.08-.6-.17-1.18-.25-1.76-.06-.37-.12-.72-.17-1.08-.06-.35-.1-.7-.17-1.03-.14-.85-.29-1.7-.43-2.52-.02-.12-.04-.25-.06-.37-.19-1.01-.39-2.03-.6-3.04-.08-.39-.15-.79-.25-1.16-.12-.58-.25-1.18-.37-1.76-.12-.54-.25-1.06-.37-1.59-.1-.46-.21-.91-.31-1.35-.15-.56-.29-1.1-.43-1.66-.1-.5-.25-.97-.37-1.47-.25-.89-.5-1.8-.74-2.71-.04-.1-.06-.21-.1-.31-.12-.43-.25-.89-.39-1.32-.27-.93-.56-1.84-.87-2.77-.12-.43-.27-.89-.41-1.32-.12-.35-.23-.68-.35-1.03-.1-.29-.19-.58-.29-.87-.1-.31-.23-.62-.33-.93-.33-.93-.66-1.86-1.01-2.79-.43-1.16-.89-2.3-1.34-3.44-.48-1.18-.95-2.36-1.47-3.52-.19-.43-.37-.87-.56-1.32-.33-.72-.66-1.43-.99-2.15-.1-.23-.21-.46-.33-.68-.1-.23-.23-.43-.33-.68-.85-1.78-1.72-3.58-2.65-5.34-.02-.08-.06-.14-.1-.23-.56-1.08-1.14-2.13-1.74-3.21-.56-1.03-1.16-2.05-1.76-3.06-.02-.06-.06-.14-.1-.21-.41-.72-.85-1.43-1.3-2.15-.89-1.49-1.82-2.94-2.77-4.39-.66-.99-1.32-2.01-2.03-3-.17-.23-.31-.48-.5-.7-.33-.48-.66-.97-1.03-1.47-.02-.02-.04-.06-.08-.1-.14-.23-.29-.43-.45-.66v-.02l-.1-.1c-.27-.37-.56-.77-.83-1.14-.17-.23-.33-.43-.5-.66-.31-.39-.62-.81-.93-1.2-.64-.85-1.3-1.7-1.99-2.55-.27-.35-.56-.7-.87-1.06-.6-.77-1.22-1.51-1.86-2.26-.83-.97-1.66-1.95-2.5-2.9-.52-.58-1.03-1.16-1.57-1.72-.58-.64-1.18-1.28-1.8-1.92-.25-.29-.52-.56-.81-.85h0c.29.29.56.56.81.85.62.64,1.22,1.28,1.8,1.92.54.56,1.05,1.14,1.57,1.72.85.95,1.68,1.92,2.5,2.9.64.74,1.26,1.49,1.86,2.26.31.35.6.7.87,1.06.68.85,1.34,1.7,1.99,2.55.31.39.62.81.93,1.2.17.23.33.44.5.66.27.37.56.77.83,1.14l.1.1c26.35-50.54,79.92-84.63,141.29-82.65,78.35,2.52,143.32,65.42,148.19,143.66,5.55,89.25-65.19,163.36-153.24,163.36h331.21c14.95,0,27.06-12.12,27.06-27.06V27.06c0-14.95-12.12-27.06-27.06-27.06h-457.7c-14.95,0-27.06,12.12-27.06,27.06ZM286.24,454.89s.01-.02.02-.03c0,0,0,.02-.01.02h0ZM286.62,454.23c.69-1.19,1.34-2.41,2-3.63-.66,1.21-1.31,2.44-1.99,3.62,0,0,0,0,0,.01Z"/>
+</svg>
diff --git a/plugins/entries/context/logo.svg b/plugins/entries/context/logo.svg
new file mode 100644
index 000000000..5f6ca81dd
--- /dev/null
+++ b/plugins/entries/context/logo.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 772.32 531.2">
+ <path fill="currentColor" d="M260.5,27.06v240.41c-29-28.17-69.08-44.96-113.07-43.26C69.5,227.24,5.16,289.98.31,367.81c-5.56,89.26,65.18,163.38,153.24,163.38,41.58,0,79.3-16.51,106.95-43.37h0c0,13.26,10.75,24.01,24.01,24.01h129.54c-51.07,0-96.29-24.98-124.23-63.34,2.81-5.4,5.32-10.98,7.47-16.76,0,0,0,0,0,0,.02-.12.06-.23.12-.35.46-1.2.89-2.4,1.3-3.6.41-1.22.81-2.42,1.2-3.64,0-.01,0-.02.01-.03.53-1.64,1.05-3.31,1.5-4.99,0,0,0,0,0,0,.02-.12.06-.23.08-.35,0,0,0-.01,0-.02.33-1.08.61-2.18.87-3.27,0-.02,0-.03.01-.04.12-.47.23-.95.35-1.43.27-1.08.52-2.15.74-3.23.06-.25.1-.5.17-.74.06-.29.12-.58.19-.89.04-.19.08-.37.13-.54.16-.85.33-1.7.47-2.55.04-.12.06-.25.08-.37.02-.1.04-.21.06-.33.12-.7.25-1.41.37-2.11.1-.58.19-1.18.29-1.76.02-.12.04-.23.04-.35.25-1.53.46-3.06.64-4.61.08-.72.17-1.45.25-2.17.04-.23.06-.45.08-.68h0c.06-.54.1-1.1.14-1.63h0c.02-.06.02-.13.02-.17.02-.19.04-.35.04-.54.1-.97.19-1.95.23-2.92.02-.1.04-.21.02-.31.06-.52.08-1.03.1-1.55.02-.1.02-.21.02-.31.04-.52.06-1.01.08-1.53h0c.04-.62.06-1.24.06-1.86h0c.02-.15.02-.27.02-.39.06-1.59.08-3.19.08-4.78h0c0-1.05-.02-2.11-.04-3.14,0-.39,0-.79-.02-1.16,0-.35-.02-.7-.04-1.06,0-.56-.02-1.12-.06-1.68,0-.29-.02-.58-.04-.87,0-.12,0-.23-.02-.33,0-.21-.02-.41-.04-.6,0-.19,0-.37-.02-.56,0-.08,0-.17-.02-.25-.02-.37-.04-.74-.06-1.1-.02-.37-.06-.72-.08-1.08,0-.08,0-.16-.02-.23-.04-.77-.12-1.55-.21-2.34-.02-.41-.06-.81-.1-1.2-.02-.14-.02-.29-.04-.41-.12-1.2-.27-2.38-.41-3.56-.06-.48-.12-.95-.19-1.43-.08-.6-.17-1.18-.25-1.76-.06-.37-.12-.72-.17-1.08-.06-.35-.1-.7-.17-1.03-.14-.85-.29-1.7-.43-2.52-.02-.12-.04-.25-.06-.37-.19-1.01-.39-2.03-.6-3.04-.08-.39-.15-.79-.25-1.16-.12-.58-.25-1.18-.37-1.76-.12-.54-.25-1.06-.37-1.59-.1-.46-.21-.91-.31-1.35-.15-.56-.29-1.1-.43-1.66-.1-.5-.25-.97-.37-1.47-.25-.89-.5-1.8-.74-2.71-.04-.1-.06-.21-.1-.31-.12-.43-.25-.89-.39-1.32-.27-.93-.56-1.84-.87-2.77-.12-.43-.27-.89-.41-1.32-.12-.35-.23-.68-.35-1.03-.1-.29-.19-.58-.29-.87-.1-.31-.23-.62-.33-.93-.33-.93-.66-1.86-1.01-2.79-.43-1.16-.89-2.3-1.34-3.44-.48-1.18-.95-2.36-1.47-3.52-.19-.43-.37-.87-.56-1.32-.33-.72-.66-1.43-.99-2.15-.1-.23-.21-.46-.33-.68-.1-.23-.23-.43-.33-.68-.85-1.78-1.72-3.58-2.65-5.34-.02-.08-.06-.14-.1-.23-.56-1.08-1.14-2.13-1.74-3.21-.56-1.03-1.16-2.05-1.76-3.06-.02-.06-.06-.14-.1-.21-.41-.72-.85-1.43-1.3-2.15-.89-1.49-1.82-2.94-2.77-4.39-.66-.99-1.32-2.01-2.03-3-.17-.23-.31-.48-.5-.7-.33-.48-.66-.97-1.03-1.47-.02-.02-.04-.06-.08-.1-.14-.23-.29-.43-.45-.66v-.02l-.1-.1c-.27-.37-.56-.77-.83-1.14-.17-.23-.33-.43-.5-.66-.31-.39-.62-.81-.93-1.2-.64-.85-1.3-1.7-1.99-2.55-.27-.35-.56-.7-.87-1.06-.6-.77-1.22-1.51-1.86-2.26-.83-.97-1.66-1.95-2.5-2.9-.52-.58-1.03-1.16-1.57-1.72-.58-.64-1.18-1.28-1.8-1.92-.25-.29-.52-.56-.81-.85h0c.29.29.56.56.81.85.62.64,1.22,1.28,1.8,1.92.54.56,1.05,1.14,1.57,1.72.85.95,1.68,1.92,2.5,2.9.64.74,1.26,1.49,1.86,2.26.31.35.6.7.87,1.06.68.85,1.34,1.7,1.99,2.55.31.39.62.81.93,1.2.17.23.33.44.5.66.27.37.56.77.83,1.14l.1.1c26.35-50.54,79.92-84.63,141.29-82.65,78.35,2.52,143.32,65.42,148.19,143.66,5.55,89.25-65.19,163.36-153.24,163.36h331.21c14.95,0,27.06-12.12,27.06-27.06V27.06c0-14.95-12.12-27.06-27.06-27.06h-457.7c-14.95,0-27.06,12.12-27.06,27.06ZM286.24,454.89s.01-.02.02-.03c0,0,0,.02-.01.02h0ZM286.62,454.23c.69-1.19,1.34-2.41,2-3.63-.66,1.21-1.31,2.44-1.99,3.62,0,0,0,0,0,.01Z"/>
+</svg>
diff --git a/plugins/entries/context/plugin.json b/plugins/entries/context/plugin.json
new file mode 100644
index 000000000..bf54f6555
--- /dev/null
+++ b/plugins/entries/context/plugin.json
@@ -0,0 +1,36 @@
+{
+ "schemaVersion": 1,
+ "id": "context",
+ "name": "Context.dev",
+ "description": "Scrape, extract, parse, enrich, and monitor web data.",
+ "primaryCategory": "Web",
+ "tags": ["scraping", "extraction", "monitoring", "brand-data"],
+ "capabilities": ["scrape pages", "extract structured data", "monitor web changes"],
+ "featuredRank": 1,
+ "publisher": { "name": "Context.dev", "url": "https://www.context.dev" },
+ "maintainer": { "name": "Context.dev", "url": "https://www.context.dev" },
+ "documentationUrl": "https://docs.context.dev/install-mcp",
+ "sourceUrl": "https://github.com/context-dot-dev",
+ "license": "Proprietary",
+ "logo": {
+ "provenance": {
+ "sourceUrl": "https://www.context.dev/home/context_dev_logo_icon.svg",
+ "license": "Context.dev brand asset"
+ }
+ },
+ "platforms": ["web", "desktop", "mobile"],
+ "transport": { "type": "url", "url": "https://mcp.context.dev/mcp" },
+ "connection": { "type": "ready" },
+ "authentication": "oauth",
+ "requiredCredentials": [],
+ "setup": ["Sign in through the Context.dev OAuth flow."],
+ "permissions": [
+ {
+ "id": "read-web-data",
+ "description": "Read public web pages and Context.dev extraction results.",
+ "approval": "read"
+ }
+ ],
+ "approvals": [],
+ "catalogStatus": "available"
+}
diff --git a/plugins/entries/exa/logo-dark.svg b/plugins/entries/exa/logo-dark.svg
new file mode 100644
index 000000000..17962d2ca
--- /dev/null
+++ b/plugins/entries/exa/logo-dark.svg
@@ -0,0 +1,6 @@
+<svg width="129" height="129" viewBox="0 0 129 129" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M106.417 9.30741C106.417 9.57392 106.324 9.83227 106.155 10.0388L61.5395 64.5L106.155 118.96C106.324 119.166 106.417 119.425 106.417 119.691V127.843C106.417 128.482 105.897 129 105.255 129H1.16175C0.520132 129 0 128.482 0 127.843V1.15695C0 0.517982 0.520131 0 1.16174 0H105.255C105.897 0 106.417 0.517984 106.417 1.15695V9.30741ZM19.0364 116.382H87.6921L53.363 74.4795L19.0364 116.382ZM12.6699 104.192L40.1426 70.6585H12.6699V104.192ZM12.6699 58.0409H39.8964L12.6699 24.8064V58.0409ZM53.363 54.5193L87.6921 12.6176H19.0364L53.363 54.5193Z" fill="#0143D9"/>
+<path d="M176.198 117.65C166.094 117.65 157.323 115.553 149.886 111.36C142.589 107.167 136.905 101.017 132.835 92.9109C128.906 84.8045 126.941 75.0208 126.941 63.5599C126.941 53.3569 128.976 44.2022 133.046 36.0957C137.256 27.9892 143.01 21.6298 150.307 17.0175C157.744 12.4052 166.024 10.099 175.146 10.099C185.109 10.099 193.599 12.3353 200.616 16.8078C207.633 21.1406 212.965 27.3602 216.614 35.4667C220.263 43.4334 222.087 52.8677 222.087 63.7695V66.1766C222.087 66.8156 221.567 67.3336 220.925 67.3336H145.044C145.185 74.881 146.588 81.3802 149.254 86.8311C152.061 92.282 155.78 96.475 160.411 99.4101C165.182 102.205 170.515 103.603 176.409 103.603C183.285 103.603 189.179 102.066 194.091 98.9908C198.779 95.9225 201.741 91.008 202.977 84.2471C203.08 83.6853 203.565 83.267 204.139 83.267H219.737C220.429 83.267 220.969 83.8669 220.871 84.5494C220.038 90.3376 217.988 95.6406 214.72 100.458C211.211 105.63 206.159 109.823 199.564 113.037C193.108 116.112 185.32 117.65 176.198 117.65ZM202.721 54.5449C202.721 45.3203 200.265 37.9825 195.354 32.5316C190.582 27.0807 183.846 24.3552 175.146 24.3552C166.866 24.3552 160.06 27.2205 154.727 32.9509C149.395 38.6814 146.377 45.8794 145.676 54.5449H202.721Z" fill="#ffffff"/>
+<path d="M364.585 117.65C358.13 117.65 352.236 116.392 346.903 113.876C341.571 111.36 337.361 107.796 334.273 103.184C331.186 98.4317 329.642 92.9808 329.642 86.8311C329.642 77.7462 332.73 70.688 338.904 65.6564C345.219 60.485 353.359 57.0607 363.322 55.3835L385.004 52.0291C387.67 51.6098 389.705 51.0507 391.108 50.3519C392.652 49.5133 393.704 48.465 394.266 47.2071C394.967 45.8095 395.318 44.0624 395.318 41.9659C395.318 36.515 393.424 32.2521 389.635 29.1772C385.846 25.9626 380.934 24.3552 374.9 24.3552C367.322 24.3552 361.498 26.2421 357.428 30.0158C353.595 33.4387 351.443 38.1016 350.971 44.0046C350.922 44.622 350.412 45.1106 349.79 45.1106H334.014C333.353 45.1106 332.823 44.5605 332.872 43.9032C333.312 38.0771 335.042 32.6792 338.062 27.7096C341.29 22.3985 345.921 18.1356 351.955 14.921C358.13 11.7063 365.287 10.099 373.426 10.099C381.706 10.099 388.793 11.6364 394.687 14.7113C400.721 17.7862 405.282 22.1888 408.369 27.9193C411.456 33.6497 413 40.4284 413 48.2554V113.348C413 113.987 412.48 114.505 411.838 114.505H396.901C396.259 114.505 395.739 113.987 395.739 113.348V109.473C395.739 108.076 395.739 106.678 395.739 105.28C395.739 103.743 395.739 102.275 395.739 100.878C393.213 106.189 389.214 110.312 383.741 113.247C378.408 116.182 372.023 117.65 364.585 117.65ZM367.111 103.603C372.444 103.603 377.215 102.485 381.425 100.249C385.775 97.8727 389.143 94.6581 391.529 90.6048C394.055 86.4118 395.318 81.6597 395.318 76.3486V61.4634C394.757 62.302 393.564 63.0707 391.74 63.7695C389.915 64.4684 387.389 65.1672 384.162 65.866L369.427 68.5915C362.971 69.8494 357.849 71.9459 354.06 74.881C350.271 77.8161 348.377 81.7995 348.377 86.8311C348.377 91.8627 350.131 95.916 353.639 98.9908C357.288 102.066 361.779 103.603 367.111 103.603Z" fill="#ffffff"/>
+<path d="M285.673 62.9573L325.127 112.948C325.726 113.707 325.183 114.82 324.213 114.82H305.929C305.572 114.82 305.235 114.657 305.015 114.378L275.053 76.414L245.093 114.378C244.872 114.657 244.536 114.82 244.179 114.82H225.893C224.924 114.82 224.381 113.707 224.98 112.948L264.433 62.9573L227.177 15.7512C226.578 14.9921 227.121 13.8793 228.091 13.8793H246.375C246.732 13.8793 247.068 14.0423 247.289 14.3214L275.053 49.5006L302.818 14.3214C303.038 14.0423 303.375 13.8793 303.731 13.8793H322.016C322.985 13.8793 323.528 14.9921 322.929 15.7512L285.673 62.9573Z" fill="#ffffff"/>
+</svg>
diff --git a/plugins/entries/exa/logo.svg b/plugins/entries/exa/logo.svg
new file mode 100644
index 000000000..730dc4a66
--- /dev/null
+++ b/plugins/entries/exa/logo.svg
@@ -0,0 +1,6 @@
+<svg width="129" height="129" viewBox="0 0 129 129" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M106.417 9.30741C106.417 9.57392 106.324 9.83227 106.155 10.0388L61.5395 64.5L106.155 118.96C106.324 119.166 106.417 119.425 106.417 119.691V127.843C106.417 128.482 105.897 129 105.255 129H1.16175C0.520132 129 0 128.482 0 127.843V1.15695C0 0.517982 0.520131 0 1.16174 0H105.255C105.897 0 106.417 0.517984 106.417 1.15695V9.30741ZM19.0364 116.382H87.6921L53.363 74.4795L19.0364 116.382ZM12.6699 104.192L40.1426 70.6585H12.6699V104.192ZM12.6699 58.0409H39.8964L12.6699 24.8064V58.0409ZM53.363 54.5193L87.6921 12.6176H19.0364L53.363 54.5193Z" fill="#0143D9"/>
+<path d="M176.198 117.65C166.094 117.65 157.323 115.553 149.886 111.36C142.589 107.167 136.905 101.017 132.835 92.9109C128.906 84.8045 126.941 75.0208 126.941 63.5599C126.941 53.3569 128.976 44.2022 133.046 36.0957C137.256 27.9892 143.01 21.6298 150.307 17.0175C157.744 12.4052 166.024 10.099 175.146 10.099C185.109 10.099 193.599 12.3353 200.616 16.8078C207.633 21.1406 212.965 27.3602 216.614 35.4667C220.263 43.4334 222.087 52.8677 222.087 63.7695V66.1766C222.087 66.8156 221.567 67.3336 220.925 67.3336H145.044C145.185 74.881 146.588 81.3802 149.254 86.8311C152.061 92.282 155.78 96.475 160.411 99.4101C165.182 102.205 170.515 103.603 176.409 103.603C183.285 103.603 189.179 102.066 194.091 98.9908C198.779 95.9225 201.741 91.008 202.977 84.2471C203.08 83.6853 203.565 83.267 204.139 83.267H219.737C220.429 83.267 220.969 83.8669 220.871 84.5494C220.038 90.3376 217.988 95.6406 214.72 100.458C211.211 105.63 206.159 109.823 199.564 113.037C193.108 116.112 185.32 117.65 176.198 117.65ZM202.721 54.5449C202.721 45.3203 200.265 37.9825 195.354 32.5316C190.582 27.0807 183.846 24.3552 175.146 24.3552C166.866 24.3552 160.06 27.2205 154.727 32.9509C149.395 38.6814 146.377 45.8794 145.676 54.5449H202.721Z" fill="black"/>
+<path d="M364.585 117.65C358.13 117.65 352.236 116.392 346.903 113.876C341.571 111.36 337.361 107.796 334.273 103.184C331.186 98.4317 329.642 92.9808 329.642 86.8311C329.642 77.7462 332.73 70.688 338.904 65.6564C345.219 60.485 353.359 57.0607 363.322 55.3835L385.004 52.0291C387.67 51.6098 389.705 51.0507 391.108 50.3519C392.652 49.5133 393.704 48.465 394.266 47.2071C394.967 45.8095 395.318 44.0624 395.318 41.9659C395.318 36.515 393.424 32.2521 389.635 29.1772C385.846 25.9626 380.934 24.3552 374.9 24.3552C367.322 24.3552 361.498 26.2421 357.428 30.0158C353.595 33.4387 351.443 38.1016 350.971 44.0046C350.922 44.622 350.412 45.1106 349.79 45.1106H334.014C333.353 45.1106 332.823 44.5605 332.872 43.9032C333.312 38.0771 335.042 32.6792 338.062 27.7096C341.29 22.3985 345.921 18.1356 351.955 14.921C358.13 11.7063 365.287 10.099 373.426 10.099C381.706 10.099 388.793 11.6364 394.687 14.7113C400.721 17.7862 405.282 22.1888 408.369 27.9193C411.456 33.6497 413 40.4284 413 48.2554V113.348C413 113.987 412.48 114.505 411.838 114.505H396.901C396.259 114.505 395.739 113.987 395.739 113.348V109.473C395.739 108.076 395.739 106.678 395.739 105.28C395.739 103.743 395.739 102.275 395.739 100.878C393.213 106.189 389.214 110.312 383.741 113.247C378.408 116.182 372.023 117.65 364.585 117.65ZM367.111 103.603C372.444 103.603 377.215 102.485 381.425 100.249C385.775 97.8727 389.143 94.6581 391.529 90.6048C394.055 86.4118 395.318 81.6597 395.318 76.3486V61.4634C394.757 62.302 393.564 63.0707 391.74 63.7695C389.915 64.4684 387.389 65.1672 384.162 65.866L369.427 68.5915C362.971 69.8494 357.849 71.9459 354.06 74.881C350.271 77.8161 348.377 81.7995 348.377 86.8311C348.377 91.8627 350.131 95.916 353.639 98.9908C357.288 102.066 361.779 103.603 367.111 103.603Z" fill="black"/>
+<path d="M285.673 62.9573L325.127 112.948C325.726 113.707 325.183 114.82 324.213 114.82H305.929C305.572 114.82 305.235 114.657 305.015 114.378L275.053 76.414L245.093 114.378C244.872 114.657 244.536 114.82 244.179 114.82H225.893C224.924 114.82 224.381 113.707 224.98 112.948L264.433 62.9573L227.177 15.7512C226.578 14.9921 227.121 13.8793 228.091 13.8793H246.375C246.732 13.8793 247.068 14.0423 247.289 14.3214L275.053 49.5006L302.818 14.3214C303.038 14.0423 303.375 13.8793 303.731 13.8793H322.016C322.985 13.8793 323.528 14.9921 322.929 15.7512L285.673 62.9573Z" fill="black"/>
+</svg>
diff --git a/plugins/entries/exa/plugin.json b/plugins/entries/exa/plugin.json
new file mode 100644
index 000000000..cc6aeef73
--- /dev/null
+++ b/plugins/entries/exa/plugin.json
@@ -0,0 +1,40 @@
+{
+ "schemaVersion": 1,
+ "id": "exa",
+ "name": "Exa",
+ "description": "Search the web, find code, and run focused research.",
+ "primaryCategory": "Web",
+ "tags": ["search", "research", "code-search"],
+ "capabilities": ["search the web", "find code", "research topics"],
+ "featuredRank": 3,
+ "publisher": { "name": "Exa Labs", "url": "https://exa.ai" },
+ "maintainer": { "name": "Exa Labs", "url": "https://exa.ai" },
+ "documentationUrl": "https://exa.ai/mcp",
+ "sourceUrl": "https://github.com/exa-labs/exa-mcp-server",
+ "license": "MIT",
+ "logo": {
+ "provenance": { "sourceUrl": "https://exa.ai", "license": "Exa brand asset" }
+ },
+ "platforms": ["web", "desktop", "mobile"],
+ "transport": { "type": "url", "url": "https://mcp.exa.ai/mcp" },
+ "connection": { "type": "ready" },
+ "authentication": "optional-oauth",
+ "requiredCredentials": [],
+ "setup": ["Connect with OAuth for higher limits or continue without authentication."],
+ "permissions": [
+ {
+ "id": "read-search-results",
+ "description": "Read public web and code search results.",
+ "approval": "read"
+ }
+ ],
+ "approvals": [],
+ "catalogStatus": "available",
+ "skills": [
+ {
+ "title": "Exa Search",
+ "description": "Search the web through the Exa CLI.",
+ "url": "https://skills.sh/exa-labs/agent-skills/exa-search"
+ }
+ ]
+}
diff --git a/plugins/entries/executor/logo-dark.svg b/plugins/entries/executor/logo-dark.svg
new file mode 100644
index 000000000..76fe01519
--- /dev/null
+++ b/plugins/entries/executor/logo-dark.svg
@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 520 940">
+ <path fill="#ffffff" d="M7 7c-14 13-6 22 26 28 17 4 38 12 45 17 17 14 18 833 0 844-6 4-25 10-41 13-17 4-32 12-35 19-3 9 54 12 246 12 230 0 251-1 256-18 2-9 8-72 11-140 6-106 5-122-8-122-17 0-20 8-37 90-6 31-19 70-30 88-50 81-216 98-249 25-25-55-16-74 105-214 64-74 120-141 124-150 6-11-23-52-116-159L180 245v-55c0-82 16-100 92-100 110 0 158 42 182 162 9 46 18 64 30 66 17 4 17-5 11-120-5-94-11-126-23-136-12-9-75-12-237-12C113 50 10 53 7 57Zm279 382c41 29 94 86 94 101 0 33-119 130-160 130-36 0-40-12-40-130 0-54 3-105 6-114 10-25 57-19 100 13Z" transform="translate(0 940) scale(1 -1)"/>
+</svg>
diff --git a/plugins/entries/executor/logo.svg b/plugins/entries/executor/logo.svg
new file mode 100644
index 000000000..896bc7d88
--- /dev/null
+++ b/plugins/entries/executor/logo.svg
@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 520 940">
+ <path fill="#181818" d="M7 7c-14 13-6 22 26 28 17 4 38 12 45 17 17 14 18 833 0 844-6 4-25 10-41 13-17 4-32 12-35 19-3 9 54 12 246 12 230 0 251-1 256-18 2-9 8-72 11-140 6-106 5-122-8-122-17 0-20 8-37 90-6 31-19 70-30 88-50 81-216 98-249 25-25-55-16-74 105-214 64-74 120-141 124-150 6-11-23-52-116-159L180 245v-55c0-82 16-100 92-100 110 0 158 42 182 162 9 46 18 64 30 66 17 4 17-5 11-120-5-94-11-126-23-136-12-9-75-12-237-12C113 50 10 53 7 57Zm279 382c41 29 94 86 94 101 0 33-119 130-160 130-36 0-40-12-40-130 0-54 3-105 6-114 10-25 57-19 100 13Z" transform="translate(0 940) scale(1 -1)"/>
+</svg>
diff --git a/plugins/entries/executor/plugin.json b/plugins/entries/executor/plugin.json
new file mode 100644
index 000000000..5d1c2f803
--- /dev/null
+++ b/plugins/entries/executor/plugin.json
@@ -0,0 +1,75 @@
+{
+ "schemaVersion": 1,
+ "id": "executor",
+ "name": "Executor",
+ "description": "Use the integrations configured in your local Executor account.",
+ "primaryCategory": "Work",
+ "tags": ["integrations", "automation", "local"],
+ "capabilities": ["use configured integrations", "run local integration tools"],
+ "featuredRank": 5,
+ "publisher": { "name": "Useful Software Co.", "url": "https://executor.sh" },
+ "maintainer": { "name": "Useful Software Co.", "url": "https://executor.sh" },
+ "documentationUrl": "https://executor.sh/docs",
+ "sourceUrl": "https://github.com/UsefulSoftwareCo/executor",
+ "license": "MIT",
+ "logo": {
+ "provenance": {
+ "sourceUrl": "https://executor.sh/favicon-192.png",
+ "license": "Executor brand asset"
+ }
+ },
+ "platforms": ["macos", "windows", "linux"],
+ "transport": { "type": "stdio", "command": "bunx", "args": ["-y", "executor", "mcp"] },
+ "connection": { "type": "local" },
+ "authentication": "none",
+ "requiredCredentials": [],
+ "setup": ["Sign in to Executor locally, then start its MCP command."],
+ "permissions": [
+ {
+ "id": "read-integrations",
+ "description": "Read data from configured integrations.",
+ "approval": "read"
+ },
+ { "id": "send-content", "description": "Send messages or other content.", "approval": "send" },
+ { "id": "make-payment", "description": "Submit a payment.", "approval": "pay" },
+ { "id": "delete-data", "description": "Delete integration data.", "approval": "delete" },
+ {
+ "id": "change-production",
+ "description": "Change production systems.",
+ "approval": "production"
+ },
+ {
+ "id": "access-secrets",
+ "description": "Access or change secret settings.",
+ "approval": "secrets"
+ },
+ {
+ "id": "publish-content",
+ "description": "Publish content to an external audience.",
+ "approval": "publishing"
+ },
+ {
+ "id": "create-signature",
+ "description": "Create or apply a signature.",
+ "approval": "signatures"
+ },
+ { "id": "issue-refund", "description": "Issue a payment refund.", "approval": "refunds" },
+ {
+ "id": "change-account",
+ "description": "Change account-wide settings.",
+ "approval": "account-wide"
+ }
+ ],
+ "approvals": [
+ "send",
+ "pay",
+ "delete",
+ "production",
+ "secrets",
+ "publishing",
+ "signatures",
+ "refunds",
+ "account-wide"
+ ],
+ "catalogStatus": "available"
+}
diff --git a/plugins/entries/firecrawl/logo-dark.svg b/plugins/entries/firecrawl/logo-dark.svg
new file mode 100644
index 000000000..c38014c3a
--- /dev/null
+++ b/plugins/entries/firecrawl/logo-dark.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="50" height="72" fill="none" viewBox="0 0 50 72"><path fill="#fff" d="M41.715 23.193c-2.762.82-4.844 2.675-6.37 4.69-.327.432-1.01.107-.88-.423 2.92-12.007-.937-21.986-12.961-26.898a.803.803 0 0 0-1.085.937c5.47 21.961-17.537 20.109-14.63 45.005.05.427-.43.72-.78.47-1.09-.782-2.307-2.415-3.142-3.562a.502.502 0 0 0-.887.16c-.665 2.404-.98 4.67-.98 6.92 0 8.749 4.497 16.45 11.304 20.915.39.255.89-.11.758-.557a13.5 13.5 0 0 1-.563-3.697c0-.788.05-1.593.173-2.343.285-1.885.94-3.68 2.04-5.314 3.772-5.663 11.334-11.132 10.127-18.56-.078-.47.477-.78.827-.457 5.328 4.868 6.383 11.415 5.508 17.287-.075.51.564.782.887.382a11.6 11.6 0 0 1 2.892-2.587c.27-.168.63-.04.733.26.602 1.752 1.497 3.397 2.342 5.042a13.46 13.46 0 0 1 .905 9.982.502.502 0 0 0 .755.57C45.5 66.95 50 59.248 50 50.494c0-3.043-.532-6.025-1.54-8.82-2.112-5.862-7.472-10.264-6.117-17.904.065-.365-.273-.682-.628-.577"/></svg>
\ No newline at end of file
diff --git a/plugins/entries/firecrawl/logo.svg b/plugins/entries/firecrawl/logo.svg
new file mode 100644
index 000000000..d49dff46d
--- /dev/null
+++ b/plugins/entries/firecrawl/logo.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="50" height="72" fill="none" viewBox="0 0 50 72"><path fill="#fa5d19" d="M41.715 23.193c-2.762.82-4.844 2.675-6.37 4.69-.327.432-1.01.107-.88-.423 2.92-12.007-.937-21.986-12.961-26.898a.803.803 0 0 0-1.085.937c5.47 21.961-17.537 20.109-14.63 45.005.05.427-.43.72-.78.47-1.09-.782-2.307-2.415-3.142-3.562a.502.502 0 0 0-.887.16c-.665 2.404-.98 4.67-.98 6.92 0 8.749 4.497 16.45 11.304 20.915.39.255.89-.11.758-.557a13.5 13.5 0 0 1-.563-3.697c0-.788.05-1.593.173-2.343.285-1.885.94-3.68 2.04-5.314 3.772-5.663 11.334-11.132 10.127-18.56-.078-.47.477-.78.827-.457 5.328 4.868 6.383 11.415 5.508 17.287-.075.51.564.782.887.382a11.6 11.6 0 0 1 2.892-2.587c.27-.168.63-.04.733.26.602 1.752 1.497 3.397 2.342 5.042a13.46 13.46 0 0 1 .905 9.982.502.502 0 0 0 .755.57C45.5 66.95 50 59.248 50 50.494c0-3.043-.532-6.025-1.54-8.82-2.112-5.862-7.472-10.264-6.117-17.904.065-.365-.273-.682-.628-.577" style="fill:#fa5d19;fill:color(display-p3 .9816 .3634 .0984);fill-opacity:1"/></svg>
\ No newline at end of file
diff --git a/plugins/entries/firecrawl/plugin.json b/plugins/entries/firecrawl/plugin.json
new file mode 100644
index 000000000..e7400f721
--- /dev/null
+++ b/plugins/entries/firecrawl/plugin.json
@@ -0,0 +1,40 @@
+{
+ "schemaVersion": 1,
+ "id": "firecrawl",
+ "name": "Firecrawl",
+ "description": "Search, scrape, and extract structured data from the web.",
+ "primaryCategory": "Web",
+ "tags": ["search", "scraping", "crawling", "extraction"],
+ "capabilities": ["search the web", "crawl sites", "extract structured data"],
+ "featuredRank": 2,
+ "publisher": { "name": "Firecrawl", "url": "https://www.firecrawl.dev" },
+ "maintainer": { "name": "Firecrawl", "url": "https://www.firecrawl.dev" },
+ "documentationUrl": "https://docs.firecrawl.dev/mcp-server/oauth",
+ "sourceUrl": "https://github.com/mendableai/firecrawl-mcp-server",
+ "license": "MIT",
+ "logo": {
+ "provenance": { "sourceUrl": "https://www.firecrawl.dev", "license": "Firecrawl brand asset" }
+ },
+ "platforms": ["web", "desktop", "mobile"],
+ "transport": { "type": "url", "url": "https://mcp.firecrawl.dev/v2/mcp-oauth" },
+ "connection": { "type": "ready" },
+ "authentication": "oauth",
+ "requiredCredentials": [],
+ "setup": ["Sign in through the Firecrawl OAuth flow."],
+ "permissions": [
+ {
+ "id": "read-web-data",
+ "description": "Read public web pages and Firecrawl extraction results.",
+ "approval": "read"
+ }
+ ],
+ "approvals": [],
+ "catalogStatus": "available",
+ "skills": [
+ {
+ "title": "Firecrawl CLI",
+ "description": "Search, scrape, crawl, and extract through the Firecrawl CLI.",
+ "url": "https://skills.sh/firecrawl/cli/firecrawl"
+ }
+ ]
+}
diff --git a/plugins/entries/parallel-search/logo-dark.svg b/plugins/entries/parallel-search/logo-dark.svg
new file mode 100644
index 000000000..57e6c67ad
--- /dev/null
+++ b/plugins/entries/parallel-search/logo-dark.svg
@@ -0,0 +1,13 @@
+<svg width="96" height="96" viewBox="0 0 96 96" fill="none" xmlns="http://www.w3.org/2000/svg">
+<circle cx="48" cy="48" r="48" fill="#121212"/>
+<g transform="translate(11.0025 11.0) scale(1.088235)">
+<path d="M67.271 26.6083H48.6399C48.6897 26.9014 48.7305 27.1991 48.7712 27.4967H19.1336C19.0793 27.8891 19.0249 28.286 18.9797 28.6783H0.235433C0.144881 29.2646 0.0633863 29.8554 0 30.4552H18.8076C18.7759 30.8476 18.7533 31.2445 18.7307 31.6368H49.1742C49.1878 31.93 49.2014 32.2276 49.2104 32.5253H67.9954V31.5782C67.8732 29.8825 67.6332 28.2228 67.271 26.6083Z" fill="#ffffff"/>
+<path d="M49.1742 36.3677H18.7307C18.7488 36.7646 18.7759 37.1569 18.8076 37.5493H0C0.0633863 38.1446 0.140354 38.7354 0.235433 39.3262H18.9797C19.0249 39.723 19.0748 40.1154 19.1336 40.5078H48.7712C48.7305 40.8054 48.6852 41.0986 48.6399 41.3962H67.271C67.6332 39.7817 67.8732 38.122 67.9954 36.4263V35.4792H49.2104C49.2014 35.7769 49.1878 36.07 49.1742 36.3677Z" fill="#ffffff"/>
+<path d="M47.8341 45.2431H20.0618C20.1614 45.64 20.2701 46.0323 20.3788 46.4247H2.16877C2.40421 47.0245 2.65775 47.6153 2.92488 48.2016H20.9175C21.0488 48.5985 21.1801 48.9908 21.3205 49.3832H46.5664C46.4577 49.6808 46.349 49.974 46.2358 50.2716H63.9252C64.9529 48.4 65.8041 46.4202 66.4651 44.3547H48.0424C47.9744 44.6523 47.902 44.9455 47.8296 45.2431H47.8341Z" fill="#ffffff"/>
+<path d="M44.5696 54.1186H23.3307C23.5254 54.5154 23.7291 54.9123 23.9374 55.3002H7.34827C7.84178 55.909 8.3534 56.4998 8.88313 57.0771H24.9244C25.1598 57.4739 25.3998 57.8708 25.6443 58.2586H42.2606C42.0749 58.5563 41.8848 58.8539 41.6901 59.1471H56.9345C58.8768 57.3837 60.6109 55.3949 62.105 53.2301H44.9952C44.8549 53.5278 44.719 53.8254 44.5742 54.1186H44.5696Z" fill="#ffffff"/>
+<path d="M38.8468 62.9895H29.0536C29.3841 63.3909 29.7191 63.7833 30.0632 64.1711H18.2145C22.8961 66.5974 28.2115 67.9865 33.8483 68C33.8845 68 33.9162 68 33.9479 68C33.9796 68 34.0158 68 34.0475 68C41.1377 67.9775 47.7209 65.8037 53.1675 62.0966H39.5531C39.3176 62.3942 39.0822 62.6919 38.8422 62.985L38.8468 62.9895Z" fill="#ffffff"/>
+<path d="M29.0537 5.01499H38.8469C39.0868 5.30813 39.3223 5.60578 39.5577 5.90343H53.1722C47.721 2.19631 41.1424 0.0225494 34.0521 0C34.0159 0 33.9842 0 33.9525 0C33.9208 0 33.8846 0 33.8529 0C28.2116 0.0180395 22.9007 1.40257 18.2192 3.82889H30.0679C29.7238 4.21674 29.3887 4.61361 29.0582 5.01048L29.0537 5.01499Z" fill="#ffffff"/>
+<path d="M23.3308 13.8904H44.5697C44.7146 14.1836 44.855 14.4812 44.9908 14.7789H62.1006C60.6065 12.6141 58.8724 10.6253 56.9301 8.86193H41.6856C41.8803 9.15507 42.0705 9.45272 42.2561 9.75037H25.6399C25.3954 10.1427 25.1554 10.5351 24.92 10.932H8.8787C8.34444 11.5047 7.83283 12.0955 7.34385 12.7089H23.9329C23.7247 13.1012 23.5255 13.4936 23.3263 13.8904H23.3308Z" fill="#ffffff"/>
+<path d="M20.0663 22.7613H47.8386C47.911 23.0545 47.9835 23.3521 48.0514 23.6498H66.4741C65.8131 21.5843 64.9619 19.6044 63.9342 17.7328H46.2449C46.358 18.026 46.4667 18.3236 46.5754 18.6213H21.3295C21.1892 19.0136 21.0533 19.406 20.9266 19.8029H2.9339C2.66677 20.3846 2.41323 20.9754 2.17779 21.5798H20.3878C20.2791 21.9721 20.1704 22.3645 20.0708 22.7613H20.0663Z" fill="#ffffff"/>
+</g>
+</svg>
diff --git a/plugins/entries/parallel-search/logo.svg b/plugins/entries/parallel-search/logo.svg
new file mode 100644
index 000000000..ccd0c3198
--- /dev/null
+++ b/plugins/entries/parallel-search/logo.svg
@@ -0,0 +1,13 @@
+<svg width="96" height="96" viewBox="0 0 96 96" fill="none" xmlns="http://www.w3.org/2000/svg">
+<circle cx="48" cy="48" r="48" fill="#ffffff"/>
+<g transform="translate(11.0025 11.0) scale(1.088235)">
+<path d="M67.271 26.6083H48.6399C48.6897 26.9014 48.7305 27.1991 48.7712 27.4967H19.1336C19.0793 27.8891 19.0249 28.286 18.9797 28.6783H0.235433C0.144881 29.2646 0.0633863 29.8554 0 30.4552H18.8076C18.7759 30.8476 18.7533 31.2445 18.7307 31.6368H49.1742C49.1878 31.93 49.2014 32.2276 49.2104 32.5253H67.9954V31.5782C67.8732 29.8825 67.6332 28.2228 67.271 26.6083Z" fill="#181818"/>
+<path d="M49.1742 36.3677H18.7307C18.7488 36.7646 18.7759 37.1569 18.8076 37.5493H0C0.0633863 38.1446 0.140354 38.7354 0.235433 39.3262H18.9797C19.0249 39.723 19.0748 40.1154 19.1336 40.5078H48.7712C48.7305 40.8054 48.6852 41.0986 48.6399 41.3962H67.271C67.6332 39.7817 67.8732 38.122 67.9954 36.4263V35.4792H49.2104C49.2014 35.7769 49.1878 36.07 49.1742 36.3677Z" fill="#181818"/>
+<path d="M47.8341 45.2431H20.0618C20.1614 45.64 20.2701 46.0323 20.3788 46.4247H2.16877C2.40421 47.0245 2.65775 47.6153 2.92488 48.2016H20.9175C21.0488 48.5985 21.1801 48.9908 21.3205 49.3832H46.5664C46.4577 49.6808 46.349 49.974 46.2358 50.2716H63.9252C64.9529 48.4 65.8041 46.4202 66.4651 44.3547H48.0424C47.9744 44.6523 47.902 44.9455 47.8296 45.2431H47.8341Z" fill="#181818"/>
+<path d="M44.5696 54.1186H23.3307C23.5254 54.5154 23.7291 54.9123 23.9374 55.3002H7.34827C7.84178 55.909 8.3534 56.4998 8.88313 57.0771H24.9244C25.1598 57.4739 25.3998 57.8708 25.6443 58.2586H42.2606C42.0749 58.5563 41.8848 58.8539 41.6901 59.1471H56.9345C58.8768 57.3837 60.6109 55.3949 62.105 53.2301H44.9952C44.8549 53.5278 44.719 53.8254 44.5742 54.1186H44.5696Z" fill="#181818"/>
+<path d="M38.8468 62.9895H29.0536C29.3841 63.3909 29.7191 63.7833 30.0632 64.1711H18.2145C22.8961 66.5974 28.2115 67.9865 33.8483 68C33.8845 68 33.9162 68 33.9479 68C33.9796 68 34.0158 68 34.0475 68C41.1377 67.9775 47.7209 65.8037 53.1675 62.0966H39.5531C39.3176 62.3942 39.0822 62.6919 38.8422 62.985L38.8468 62.9895Z" fill="#181818"/>
+<path d="M29.0537 5.01499H38.8469C39.0868 5.30813 39.3223 5.60578 39.5577 5.90343H53.1722C47.721 2.19631 41.1424 0.0225494 34.0521 0C34.0159 0 33.9842 0 33.9525 0C33.9208 0 33.8846 0 33.8529 0C28.2116 0.0180395 22.9007 1.40257 18.2192 3.82889H30.0679C29.7238 4.21674 29.3887 4.61361 29.0582 5.01048L29.0537 5.01499Z" fill="#181818"/>
+<path d="M23.3308 13.8904H44.5697C44.7146 14.1836 44.855 14.4812 44.9908 14.7789H62.1006C60.6065 12.6141 58.8724 10.6253 56.9301 8.86193H41.6856C41.8803 9.15507 42.0705 9.45272 42.2561 9.75037H25.6399C25.3954 10.1427 25.1554 10.5351 24.92 10.932H8.8787C8.34444 11.5047 7.83283 12.0955 7.34385 12.7089H23.9329C23.7247 13.1012 23.5255 13.4936 23.3263 13.8904H23.3308Z" fill="#181818"/>
+<path d="M20.0663 22.7613H47.8386C47.911 23.0545 47.9835 23.3521 48.0514 23.6498H66.4741C65.8131 21.5843 64.9619 19.6044 63.9342 17.7328H46.2449C46.358 18.026 46.4667 18.3236 46.5754 18.6213H21.3295C21.1892 19.0136 21.0533 19.406 20.9266 19.8029H2.9339C2.66677 20.3846 2.41323 20.9754 2.17779 21.5798H20.3878C20.2791 21.9721 20.1704 22.3645 20.0708 22.7613H20.0663Z" fill="#181818"/>
+</g>
+</svg>
diff --git a/plugins/entries/parallel-search/plugin.json b/plugins/entries/parallel-search/plugin.json
new file mode 100644
index 000000000..c80695bc6
--- /dev/null
+++ b/plugins/entries/parallel-search/plugin.json
@@ -0,0 +1,40 @@
+{
+ "schemaVersion": 1,
+ "id": "parallel-search",
+ "name": "Parallel Search",
+ "description": "Search the web and extract token-efficient content from URLs.",
+ "primaryCategory": "Web",
+ "tags": ["search", "research", "extraction"],
+ "capabilities": ["search the web", "extract URL content", "rank search results"],
+ "featuredRank": 4,
+ "publisher": { "name": "Parallel", "url": "https://parallel.ai" },
+ "maintainer": { "name": "Parallel", "url": "https://parallel.ai" },
+ "documentationUrl": "https://docs.parallel.ai/integrations/mcp/search-mcp",
+ "sourceUrl": "https://github.com/parallel-web/parallel-agent-skills",
+ "license": "Proprietary",
+ "logo": {
+ "provenance": { "sourceUrl": "https://parallel.ai", "license": "Parallel brand asset" }
+ },
+ "platforms": ["web", "desktop", "mobile"],
+ "transport": { "type": "url", "url": "https://search.parallel.ai/mcp-oauth" },
+ "connection": { "type": "ready" },
+ "authentication": "oauth",
+ "requiredCredentials": [],
+ "setup": ["Sign in through the Parallel OAuth flow."],
+ "permissions": [
+ {
+ "id": "read-search-results",
+ "description": "Read public web search and extraction results.",
+ "approval": "read"
+ }
+ ],
+ "approvals": [],
+ "catalogStatus": "available",
+ "skills": [
+ {
+ "title": "Parallel Web Search",
+ "description": "Run ranked web searches through the Parallel CLI.",
+ "url": "https://skills.sh/parallel-web/parallel-agent-skills/parallel-web-search"
+ }
+ ]
+}
diff --git a/plugins/exa.ts b/plugins/exa.ts
deleted file mode 100644
index 0edcd513f..000000000
--- a/plugins/exa.ts
+++ /dev/null
@@ -1,22 +0,0 @@
-import { definePlugin } from "./definePlugin";
-
-export default definePlugin({
- id: "exa",
- title: "Exa",
- description: "Search the web, find code, and run focused research.",
- category: "Search",
- logo: { src: "/plugin-logos/exa.svg" },
- featured: true,
- kind: "mcp-url",
- authentication: "optional-oauth",
- url: "https://mcp.exa.ai/mcp",
- docsUrl: "https://exa.ai/mcp",
- skills: [
- {
- title: "Exa Search",
- description: "Search the web through the Exa CLI.",
- url: "https://skills.sh/exa-labs/agent-skills/exa-search",
- },
- ],
- builtin: true,
-});
diff --git a/plugins/executor.ts b/plugins/executor.ts
deleted file mode 100644
index 0742743bf..000000000
--- a/plugins/executor.ts
+++ /dev/null
@@ -1,15 +0,0 @@
-import { definePlugin } from "./definePlugin";
-
-export default definePlugin({
- id: "executor",
- title: "Executor",
- description: "Use the integrations configured in your local Executor account.",
- category: "Productivity",
- logo: { src: "/plugin-logos/mcp.svg", darkSrc: "/plugin-logos/mcp-dark.svg" },
- featured: true,
- kind: "mcp-stdio",
- command: "bunx",
- args: ["-y", "executor", "mcp"],
- docsUrl: "https://executor.sh/docs",
- builtin: true,
-});
diff --git a/plugins/firecrawl.ts b/plugins/firecrawl.ts
deleted file mode 100644
index 42cb27f3e..000000000
--- a/plugins/firecrawl.ts
+++ /dev/null
@@ -1,25 +0,0 @@
-import { definePlugin } from "./definePlugin";
-
-export default definePlugin({
- id: "firecrawl",
- title: "Firecrawl",
- description: "Search, scrape, and extract structured data from the web.",
- category: "Data Extraction",
- logo: {
- src: "/plugin-logos/firecrawl.svg",
- darkSrc: "/plugin-logos/firecrawl-dark.svg",
- },
- featured: true,
- kind: "mcp-url",
- authentication: "oauth",
- url: "https://mcp.firecrawl.dev/v2/mcp-oauth",
- docsUrl: "https://docs.firecrawl.dev/mcp-server/oauth",
- skills: [
- {
- title: "Firecrawl CLI",
- description: "Search, scrape, crawl, and extract through the Firecrawl CLI.",
- url: "https://skills.sh/firecrawl/cli/firecrawl",
- },
- ],
- builtin: true,
-});
diff --git a/plugins/index.ts b/plugins/index.ts
index ab2c77cee..37db5b328 100644
--- a/plugins/index.ts
+++ b/plugins/index.ts
@@ -1,35 +1,24 @@
-import type { PluginDefinition } from "./definePlugin";
-
-interface PluginModule {
- readonly default: PluginDefinition;
-}
-
-const catalogModules = import.meta.glob<PluginModule>(
- ["./*.ts", "!./definePlugin.ts", "!./index.ts", "!./*.test.ts"],
- { eager: true },
-);
-
-export function loadCatalog(
- modules: Readonly<Record<string, PluginModule>> = catalogModules,
-): readonly PluginDefinition[] {
- const plugins = Object.entries(modules).map(([path, module]) => {
- if (!module.default)
- throw new TypeError(`Plugin module '${path}' must export a default plugin.`);
- return module.default;
- });
- const ids = new Set<string>();
- for (const plugin of plugins) {
- if (ids.has(plugin.id)) throw new TypeError(`Duplicate plugin id '${plugin.id}'.`);
- ids.add(plugin.id);
- }
- return Object.freeze(plugins.toSorted((left, right) => left.title.localeCompare(right.title)));
-}
-
-export { PLUGIN_CATEGORIES } from "./definePlugin";
-export type {
- PluginCategory,
- PluginDefinition,
- PluginKind,
- PluginLogo,
- PluginSkill,
-} from "./definePlugin";
+export {
+ loadCatalog,
+ loadDirectoryCatalog,
+ resolveCatalogInstallations,
+ type CatalogInstallation,
+ type CatalogPluginDefinition,
+ type PluginDefinition,
+ type PluginDirectoryDefinition,
+ type PluginLogo,
+ type PluginSkill,
+} from "./catalog";
+export {
+ PLUGIN_APPROVAL_CLASSES,
+ PLUGIN_CATEGORIES,
+ type CatalogCategory,
+ type PluginApprovalClass,
+ type PluginCategory,
+} from "./categories";
+export {
+ parsePluginManifest,
+ parsePluginManifestJson,
+ PLUGIN_SCHEMA_VERSION,
+ type PluginManifest,
+} from "./schema";
diff --git a/plugins/parallel-search.ts b/plugins/parallel-search.ts
deleted file mode 100644
index 1e2747269..000000000
--- a/plugins/parallel-search.ts
+++ /dev/null
@@ -1,22 +0,0 @@
-import { definePlugin } from "./definePlugin";
-
-export default definePlugin({
- id: "parallel-search",
- title: "Parallel Search",
- description: "Search the web and extract token-efficient content from URLs.",
- category: "Search",
- logo: { src: "/plugin-logos/parallel.svg" },
- featured: true,
- kind: "mcp-url",
- authentication: "oauth",
- url: "https://search.parallel.ai/mcp-oauth",
- docsUrl: "https://docs.parallel.ai/integrations/mcp/search-mcp",
- skills: [
- {
- title: "Parallel Web Search",
- description: "Run ranked web searches through the Parallel CLI.",
- url: "https://skills.sh/parallel-web/parallel-agent-skills/parallel-web-search",
- },
- ],
- builtin: true,
-});
diff --git a/plugins/schema.test.ts b/plugins/schema.test.ts
new file mode 100644
index 000000000..43edbcfe3
--- /dev/null
+++ b/plugins/schema.test.ts
@@ -0,0 +1,140 @@
+import { describe, expect, it } from "vite-plus/test";
+
+import { PLUGIN_APPROVAL_CLASSES, PLUGIN_CATEGORIES } from "./categories";
+import { parsePluginManifest } from "./schema";
+
+const VALID_MANIFEST = {
+ schemaVersion: 1,
+ id: "example",
+ name: "Example",
+ description: "Connect Example.",
+ primaryCategory: "Work",
+ tags: ["example"],
+ capabilities: ["read-data"],
+ publisher: { name: "Example", url: "https://example.com" },
+ maintainer: { name: "Example", url: "https://example.com" },
+ documentationUrl: "https://example.com/docs",
+ sourceUrl: "https://example.com/source",
+ license: "MIT",
+ logo: {
+ provenance: { sourceUrl: "https://example.com/brand", license: "Trademark" },
+ },
+ platforms: ["web"],
+ transport: { type: "url", url: "https://example.com/mcp" },
+ connection: { type: "ready" },
+ authentication: "oauth",
+ requiredCredentials: [],
+ setup: ["Connect Example."],
+ permissions: [{ id: "read-data", description: "Read data.", approval: "read" }],
+ approvals: [],
+ catalogStatus: "available",
+} as const;
+
+describe("plugin catalog schema", () => {
+ it("defines the categories and consequential approval classes", () => {
+ expect(PLUGIN_CATEGORIES).toEqual([
+ "Work",
+ "Web",
+ "Marketing",
+ "Build",
+ "Design",
+ "Sales",
+ "Support",
+ "Commerce",
+ ]);
+ expect(PLUGIN_APPROVAL_CLASSES).toEqual([
+ "send",
+ "pay",
+ "delete",
+ "production",
+ "secrets",
+ "publishing",
+ "signatures",
+ "refunds",
+ "account-wide",
+ ]);
+ });
+
+ it("rejects insecure endpoints, undeclared credentials, and missing approvals", () => {
+ expect(() =>
+ parsePluginManifest({
+ ...VALID_MANIFEST,
+ transport: { type: "url", url: "http://example.com/mcp" },
+ }),
+ ).toThrow("endpoint must use HTTPS");
+ expect(() =>
+ parsePluginManifest({ ...VALID_MANIFEST, requiredCredentials: ["example-api-key"] }),
+ ).toThrow("declares credentials without API key authentication");
+ expect(() =>
+ parsePluginManifest({
+ ...VALID_MANIFEST,
+ permissions: [{ id: "delete-data", description: "Delete data.", approval: "delete" }],
+ }),
+ ).toThrow("requires 'delete' approval");
+ });
+
+ it("allows loopback HTTP only for local connections and requires a named broker", () => {
+ expect(
+ parsePluginManifest({
+ ...VALID_MANIFEST,
+ transport: { type: "url", url: "http://127.0.0.1:29979/mcp" },
+ connection: { type: "local" },
+ authentication: "none",
+ }).connection.type,
+ ).toBe("local");
+ expect(() =>
+ parsePluginManifest({
+ ...VALID_MANIFEST,
+ connection: { type: "brokered" },
+ }),
+ ).toThrow("broker");
+ });
+
+ it("rejects stdio recipes that expose local paths or credentials", () => {
+ const local = {
+ ...VALID_MANIFEST,
+ transport: { type: "stdio", command: "bunx", args: ["example", "mcp"] },
+ connection: { type: "local" },
+ authentication: "none",
+ };
+ expect(() =>
+ parsePluginManifest({
+ ...local,
+ transport: { type: "stdio", command: "/usr/local/bin/bunx" },
+ }),
+ ).toThrow("must not use an absolute path");
+ expect(() =>
+ parsePluginManifest({
+ ...local,
+ transport: { type: "stdio", command: "bunx", args: ["--config=/tmp/example"] },
+ }),
+ ).toThrow("arguments must not use absolute paths");
+ expect(() =>
+ parsePluginManifest({
+ ...local,
+ transport: { type: "stdio", command: "bunx", args: ["--api-key=secret"] },
+ }),
+ ).toThrow("arguments must not contain credentials");
+ });
+
+ it("requires an explicit blocker when no MCP transport exists", () => {
+ const pending = {
+ ...VALID_MANIFEST,
+ id: "pending-vendor",
+ name: "Pending Vendor",
+ transport: { type: "unavailable" },
+ connection: {
+ type: "approval-pending",
+ blocker: "The vendor must approve Akeru as an OAuth client.",
+ },
+ catalogStatus: "approval-pending",
+ };
+ expect(parsePluginManifest(pending).connection).toEqual(pending.connection);
+ expect(() => parsePluginManifest({ ...pending, catalogStatus: "available" })).toThrow(
+ "cannot be available without a transport recipe",
+ );
+ expect(() =>
+ parsePluginManifest({ ...pending, connection: { type: "approval-pending" } }),
+ ).toThrow("blocker");
+ });
+});
diff --git a/plugins/schema.ts b/plugins/schema.ts
new file mode 100644
index 000000000..c716765db
--- /dev/null
+++ b/plugins/schema.ts
@@ -0,0 +1,474 @@
+import {
+ PLUGIN_APPROVAL_CLASSES,
+ PLUGIN_CATEGORIES,
+ type PluginApprovalClass,
+ type CatalogCategory,
+} from "./categories.ts";
+
+export const PLUGIN_SCHEMA_VERSION = 1 as const;
+
+type PluginPlatform = "web" | "desktop" | "mobile" | "macos" | "windows" | "linux";
+type PluginAuthentication = "none" | "oauth" | "optional-oauth" | "api-key";
+type PluginCatalogStatus = "available" | "approval-pending" | "deprecated";
+
+interface Party {
+ readonly name: string;
+ readonly url: string;
+}
+
+interface PluginLogoManifest {
+ readonly provenance: { readonly sourceUrl: string; readonly license: string };
+}
+
+type PluginTransport =
+ | { readonly type: "url"; readonly url: string }
+ | { readonly type: "stdio"; readonly command: string; readonly args?: readonly string[] }
+ | { readonly type: "unavailable" };
+
+type PluginConnection =
+ | { readonly type: "ready" }
+ | { readonly type: "api-key" }
+ | { readonly type: "local" }
+ | { readonly type: "brokered"; readonly broker: Party }
+ | { readonly type: "approval-pending"; readonly blocker: string };
+
+export interface PluginSkill {
+ readonly title: string;
+ readonly description: string;
+ readonly url: string;
+}
+
+interface PluginPermission {
+ readonly id: string;
+ readonly description: string;
+ readonly approval: "read" | PluginApprovalClass;
+}
+
+export interface PluginManifest {
+ readonly schemaVersion: typeof PLUGIN_SCHEMA_VERSION;
+ readonly id: string;
+ readonly name: string;
+ readonly description: string;
+ readonly primaryCategory: CatalogCategory;
+ readonly tags: readonly string[];
+ readonly capabilities: readonly string[];
+ readonly featuredRank?: number;
+ readonly publisher: Party;
+ readonly maintainer: Party;
+ readonly documentationUrl: string;
+ readonly sourceUrl: string;
+ readonly license: string;
+ readonly logo: PluginLogoManifest;
+ readonly platforms: readonly PluginPlatform[];
+ readonly transport: PluginTransport;
+ readonly connection: PluginConnection;
+ readonly authentication: PluginAuthentication;
+ readonly requiredCredentials: readonly string[];
+ readonly setup: readonly string[];
+ readonly permissions: readonly PluginPermission[];
+ readonly approvals: readonly PluginApprovalClass[];
+ readonly catalogStatus: PluginCatalogStatus;
+ readonly skills?: readonly PluginSkill[];
+}
+
+const PLUGIN_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const ABSOLUTE_FILE_PATH = /(?:^|=)(?:\/|[a-z]:[\\/]|\\\\)/i;
+const CREDENTIAL_ARGUMENT =
+ /(?:^|[^a-z0-9])(?:api[-_]?key|access[-_]?token|auth[-_]?token|token|password|secret)(?:[^a-z0-9]|$)/i;
+const PLATFORMS: readonly PluginPlatform[] = [
+ "web",
+ "desktop",
+ "mobile",
+ "macos",
+ "windows",
+ "linux",
+];
+const AUTHENTICATION: readonly PluginAuthentication[] = [
+ "none",
+ "oauth",
+ "optional-oauth",
+ "api-key",
+];
+const CATALOG_STATUSES: readonly PluginCatalogStatus[] = [
+ "available",
+ "approval-pending",
+ "deprecated",
+];
+
+function object(value: unknown, path: string): Record<string, unknown> {
+ if (typeof value !== "object" || value === null || Array.isArray(value)) {
+ throw new TypeError(`${path} must be an object.`);
+ }
+ return value as Record<string, unknown>;
+}
+
+function exactKeys(value: Record<string, unknown>, keys: readonly string[], path: string): void {
+ const unexpected = Object.keys(value).filter((key) => !keys.includes(key));
+ if (unexpected.length > 0) {
+ throw new TypeError(`${path} has unknown fields: ${unexpected.join(", ")}.`);
+ }
+}
+
+function nonEmptyString(value: unknown, path: string): string {
+ if (typeof value !== "string" || value.trim().length === 0) {
+ throw new TypeError(`${path} must be a non-empty string.`);
+ }
+ return value;
+}
+
+function pluginId(value: unknown, path: string): string {
+ const id = nonEmptyString(value, path);
+ if (!PLUGIN_ID.test(id)) throw new TypeError(`${path} must use stable kebab-case.`);
+ return id;
+}
+
+function literal<const T extends string>(value: unknown, allowed: readonly T[], path: string): T {
+ if (typeof value !== "string" || !allowed.includes(value as T)) {
+ throw new TypeError(`${path} must be one of: ${allowed.join(", ")}.`);
+ }
+ return value as T;
+}
+
+function strings(value: unknown, path: string, ids = false): readonly string[] {
+ if (!Array.isArray(value)) throw new TypeError(`${path} must be an array.`);
+ return value.map((item, index) =>
+ ids ? pluginId(item, `${path}[${index}]`) : nonEmptyString(item, `${path}[${index}]`),
+ );
+}
+
+function secureUrl(value: unknown, path: string): string {
+ const input = nonEmptyString(value, path);
+ let url: URL;
+ try {
+ url = new URL(input);
+ } catch {
+ throw new TypeError(`${path} must be an absolute HTTPS URL.`);
+ }
+ if (url.protocol !== "https:" || url.username !== "" || url.password !== "") {
+ throw new TypeError(`${path} must use HTTPS and must not contain credentials.`);
+ }
+ return input;
+}
+
+function endpointUrl(value: unknown, path: string): string {
+ const input = nonEmptyString(value, path);
+ let url: URL;
+ try {
+ url = new URL(input);
+ } catch {
+ throw new TypeError(`${path} must be an absolute HTTP or HTTPS URL.`);
+ }
+ if (
+ (url.protocol !== "http:" && url.protocol !== "https:") ||
+ url.username !== "" ||
+ url.password !== ""
+ ) {
+ throw new TypeError(`${path} must use HTTP or HTTPS and must not contain credentials.`);
+ }
+ return input;
+}
+
+function party(value: unknown, path: string): Party {
+ const input = object(value, path);
+ exactKeys(input, ["name", "url"], path);
+ return {
+ name: nonEmptyString(input.name, `${path}.name`),
+ url: secureUrl(input.url, `${path}.url`),
+ };
+}
+
+function logo(value: unknown, path: string): PluginLogoManifest {
+ const input = object(value, path);
+ exactKeys(input, ["provenance"], path);
+ const provenance = object(input.provenance, `${path}.provenance`);
+ exactKeys(provenance, ["sourceUrl", "license"], `${path}.provenance`);
+ return {
+ provenance: {
+ sourceUrl: secureUrl(provenance.sourceUrl, `${path}.provenance.sourceUrl`),
+ license: nonEmptyString(provenance.license, `${path}.provenance.license`),
+ },
+ };
+}
+
+function transport(value: unknown, path: string): PluginTransport {
+ const input = object(value, path);
+ if (input.type === "url") {
+ exactKeys(input, ["type", "url"], path);
+ return { type: "url", url: endpointUrl(input.url, `${path}.url`) };
+ }
+ if (input.type === "stdio") {
+ exactKeys(input, ["type", "command", "args"], path);
+ const args = input.args === undefined ? undefined : strings(input.args, `${path}.args`);
+ return {
+ type: "stdio",
+ command: nonEmptyString(input.command, `${path}.command`),
+ ...(args === undefined ? {} : { args }),
+ };
+ }
+ if (input.type === "unavailable") {
+ exactKeys(input, ["type"], path);
+ return { type: "unavailable" };
+ }
+ throw new TypeError(`${path}.type must be url, stdio, or unavailable.`);
+}
+
+function connection(value: unknown, path: string): PluginConnection {
+ const input = object(value, path);
+ if (input.type === "brokered") {
+ exactKeys(input, ["type", "broker"], path);
+ return { type: "brokered", broker: party(input.broker, `${path}.broker`) };
+ }
+ if (input.type === "approval-pending") {
+ exactKeys(input, ["type", "blocker"], path);
+ return {
+ type: "approval-pending",
+ blocker: nonEmptyString(input.blocker, `${path}.blocker`),
+ };
+ }
+ exactKeys(input, ["type"], path);
+ return {
+ type: literal(input.type, ["ready", "api-key", "local"] as const, `${path}.type`),
+ };
+}
+
+function permissions(value: unknown, path: string): readonly PluginPermission[] {
+ if (!Array.isArray(value)) throw new TypeError(`${path} must be an array.`);
+ return value.map((item, index) => {
+ const input = object(item, `${path}[${index}]`);
+ exactKeys(input, ["id", "description", "approval"], `${path}[${index}]`);
+ return {
+ id: pluginId(input.id, `${path}[${index}].id`),
+ description: nonEmptyString(input.description, `${path}[${index}].description`),
+ approval: literal(
+ input.approval,
+ ["read", ...PLUGIN_APPROVAL_CLASSES] as const,
+ `${path}[${index}].approval`,
+ ),
+ };
+ });
+}
+
+function skills(value: unknown, path: string): readonly PluginSkill[] {
+ if (!Array.isArray(value)) throw new TypeError(`${path} must be an array.`);
+ return value.map((item, index) => {
+ const input = object(item, `${path}[${index}]`);
+ exactKeys(input, ["title", "description", "url"], `${path}[${index}]`);
+ return {
+ title: nonEmptyString(input.title, `${path}[${index}].title`),
+ description: nonEmptyString(input.description, `${path}[${index}].description`),
+ url: secureUrl(input.url, `${path}[${index}].url`),
+ };
+ });
+}
+
+function assertUnique(values: readonly string[], field: string, id: string): void {
+ if (new Set(values).size !== values.length) {
+ throw new TypeError(`Plugin '${id}' has duplicate ${field}.`);
+ }
+}
+
+function decodePluginManifest(value: unknown): PluginManifest {
+ const input = object(value, "plugin manifest");
+ exactKeys(
+ input,
+ [
+ "schemaVersion",
+ "id",
+ "name",
+ "description",
+ "primaryCategory",
+ "tags",
+ "capabilities",
+ "featuredRank",
+ "publisher",
+ "maintainer",
+ "documentationUrl",
+ "sourceUrl",
+ "license",
+ "logo",
+ "platforms",
+ "transport",
+ "connection",
+ "authentication",
+ "requiredCredentials",
+ "setup",
+ "permissions",
+ "approvals",
+ "catalogStatus",
+ "skills",
+ ],
+ "plugin manifest",
+ );
+ if (input.schemaVersion !== PLUGIN_SCHEMA_VERSION) {
+ throw new TypeError(`plugin manifest.schemaVersion must be ${PLUGIN_SCHEMA_VERSION}.`);
+ }
+ const featuredRank = input.featuredRank;
+ if (
+ featuredRank !== undefined &&
+ (!Number.isInteger(featuredRank) || typeof featuredRank !== "number" || featuredRank < 1)
+ ) {
+ throw new TypeError("plugin manifest.featuredRank must be a positive integer.");
+ }
+ const parsedSkills =
+ input.skills === undefined ? undefined : skills(input.skills, "plugin manifest.skills");
+ return {
+ schemaVersion: PLUGIN_SCHEMA_VERSION,
+ id: pluginId(input.id, "plugin manifest.id"),
+ name: nonEmptyString(input.name, "plugin manifest.name"),
+ description: nonEmptyString(input.description, "plugin manifest.description"),
+ primaryCategory: literal(
+ input.primaryCategory,
+ PLUGIN_CATEGORIES,
+ "plugin manifest.primaryCategory",
+ ),
+ tags: strings(input.tags, "plugin manifest.tags"),
+ capabilities: strings(input.capabilities, "plugin manifest.capabilities"),
+ ...(featuredRank === undefined ? {} : { featuredRank }),
+ publisher: party(input.publisher, "plugin manifest.publisher"),
+ maintainer: party(input.maintainer, "plugin manifest.maintainer"),
+ documentationUrl: secureUrl(input.documentationUrl, "plugin manifest.documentationUrl"),
+ sourceUrl: secureUrl(input.sourceUrl, "plugin manifest.sourceUrl"),
+ license: nonEmptyString(input.license, "plugin manifest.license"),
+ logo: logo(input.logo, "plugin manifest.logo"),
+ platforms: strings(input.platforms, "plugin manifest.platforms").map((platform, index) =>
+ literal(platform, PLATFORMS, `plugin manifest.platforms[${index}]`),
+ ),
+ transport: transport(input.transport, "plugin manifest.transport"),
+ connection: connection(input.connection, "plugin manifest.connection"),
+ authentication: literal(input.authentication, AUTHENTICATION, "plugin manifest.authentication"),
+ requiredCredentials: strings(
+ input.requiredCredentials,
+ "plugin manifest.requiredCredentials",
+ true,
+ ),
+ setup: strings(input.setup, "plugin manifest.setup"),
+ permissions: permissions(input.permissions, "plugin manifest.permissions"),
+ approvals: strings(input.approvals, "plugin manifest.approvals").map((approval, index) =>
+ literal(approval, PLUGIN_APPROVAL_CLASSES, `plugin manifest.approvals[${index}]`),
+ ),
+ catalogStatus: literal(input.catalogStatus, CATALOG_STATUSES, "plugin manifest.catalogStatus"),
+ ...(parsedSkills === undefined ? {} : { skills: parsedSkills }),
+ };
+}
+
+function validateManifest(manifest: PluginManifest): PluginManifest {
+ assertUnique(manifest.tags, "tags", manifest.id);
+ assertUnique(manifest.capabilities, "capabilities", manifest.id);
+ assertUnique(manifest.platforms, "platforms", manifest.id);
+ assertUnique(manifest.requiredCredentials, "credential names", manifest.id);
+ assertUnique(
+ manifest.permissions.map((permission) => permission.id),
+ "permissions",
+ manifest.id,
+ );
+ assertUnique(manifest.approvals, "approval classes", manifest.id);
+ if (manifest.setup.length === 0)
+ throw new TypeError(`Plugin '${manifest.id}' needs setup instructions.`);
+ if (manifest.permissions.length === 0) {
+ throw new TypeError(`Plugin '${manifest.id}' must document its permissions.`);
+ }
+ if (manifest.capabilities.length === 0) {
+ throw new TypeError(`Plugin '${manifest.id}' must document its capabilities.`);
+ }
+ if (manifest.authentication === "api-key" && manifest.requiredCredentials.length === 0) {
+ throw new TypeError(`Plugin '${manifest.id}' must name its required API key credentials.`);
+ }
+ if (manifest.authentication !== "api-key" && manifest.requiredCredentials.length > 0) {
+ throw new TypeError(
+ `Plugin '${manifest.id}' declares credentials without API key authentication.`,
+ );
+ }
+ if (manifest.authentication === "api-key" && manifest.connection.type !== "api-key") {
+ throw new TypeError(`Plugin '${manifest.id}' must label its API key connection.`);
+ }
+ if (manifest.connection.type === "api-key" && manifest.authentication !== "api-key") {
+ throw new TypeError(
+ `Plugin '${manifest.id}' labels an API key connection without API key authentication.`,
+ );
+ }
+ if (manifest.transport.type === "stdio" && manifest.connection.type !== "local") {
+ throw new TypeError(`Plugin '${manifest.id}' must label its stdio connection as local.`);
+ }
+ if (
+ manifest.transport.type === "unavailable" &&
+ manifest.connection.type !== "approval-pending"
+ ) {
+ throw new TypeError(
+ `Plugin '${manifest.id}' unavailable transport requires an approval blocker.`,
+ );
+ }
+ if (manifest.catalogStatus === "available" && manifest.transport.type === "unavailable") {
+ throw new TypeError(`Plugin '${manifest.id}' cannot be available without a transport recipe.`);
+ }
+ if (
+ manifest.connection.type === "approval-pending" &&
+ manifest.catalogStatus !== "approval-pending"
+ ) {
+ throw new TypeError(`Plugin '${manifest.id}' must use approval-pending catalog status.`);
+ }
+ if (
+ manifest.catalogStatus === "approval-pending" &&
+ manifest.connection.type !== "approval-pending"
+ ) {
+ throw new TypeError(`Plugin '${manifest.id}' must label its connection as approval-pending.`);
+ }
+ if (
+ manifest.transport.type === "stdio" &&
+ manifest.transport.command.trim() !== manifest.transport.command
+ ) {
+ throw new TypeError(`Plugin '${manifest.id}' has an invalid stdio command.`);
+ }
+ if (manifest.transport.type === "stdio" && ABSOLUTE_FILE_PATH.test(manifest.transport.command)) {
+ throw new TypeError(`Plugin '${manifest.id}' stdio command must not use an absolute path.`);
+ }
+ if (manifest.transport.type === "stdio") {
+ for (const argument of manifest.transport.args ?? []) {
+ if (ABSOLUTE_FILE_PATH.test(argument)) {
+ throw new TypeError(`Plugin '${manifest.id}' stdio arguments must not use absolute paths.`);
+ }
+ if (CREDENTIAL_ARGUMENT.test(argument)) {
+ throw new TypeError(
+ `Plugin '${manifest.id}' stdio arguments must not contain credentials.`,
+ );
+ }
+ }
+ }
+ if (manifest.transport.type === "url") {
+ const endpoint = new URL(manifest.transport.url);
+ const local = ["localhost", "127.0.0.1", "[::1]"].includes(endpoint.hostname);
+ if (
+ endpoint.protocol !== "https:" &&
+ !(endpoint.protocol === "http:" && local && manifest.connection.type === "local")
+ ) {
+ throw new TypeError(
+ `Plugin '${manifest.id}' endpoint must use HTTPS unless it is a local loopback connection.`,
+ );
+ }
+ }
+ const approvals = new Set(manifest.approvals);
+ for (const permission of manifest.permissions) {
+ if (permission.approval !== "read" && !approvals.has(permission.approval)) {
+ throw new TypeError(
+ `Plugin '${manifest.id}' permission '${permission.id}' requires '${permission.approval}' approval.`,
+ );
+ }
+ }
+ return Object.freeze(manifest);
+}
+
+export function parsePluginManifest(input: unknown, source = "plugin manifest"): PluginManifest {
+ try {
+ return validateManifest(decodePluginManifest(input));
+ } catch (error) {
+ throw new TypeError(`${source} is invalid: ${String(error)}`, { cause: error });
+ }
+}
+
+export function parsePluginManifestJson(input: string, source = "plugin manifest"): PluginManifest {
+ try {
+ const value: unknown = JSON.parse(input);
+ return validateManifest(decodePluginManifest(value));
+ } catch (error) {
+ throw new TypeError(`${source} is invalid: ${String(error)}`, { cause: error });
+ }
+}
diff --git a/scripts/tsconfig.json b/scripts/tsconfig.json
index 61307d299..31973a58f 100644
--- a/scripts/tsconfig.json
+++ b/scripts/tsconfig.json
@@ -2,8 +2,9 @@
"extends": "../tsconfig.base.json",
"compilerOptions": {
"composite": true,
+ "rootDir": "..",
"types": ["node"],
"lib": ["ESNext", "esnext.disposable"]
},
- "include": ["**/*.ts"]
+ "include": ["**/*.ts", "../plugins/categories.ts", "../plugins/schema.ts"]
}
diff --git a/scripts/validate-plugin-catalog.test.ts b/scripts/validate-plugin-catalog.test.ts
new file mode 100644
index 000000000..5662b5752
--- /dev/null
+++ b/scripts/validate-plugin-catalog.test.ts
@@ -0,0 +1,100 @@
+// @effect-diagnostics nodeBuiltinImport:off - Tests build isolated catalog directories on disk.
+import * as NodeFS from "node:fs";
+import * as NodeOS from "node:os";
+import * as NodePath from "node:path";
+import * as NodeURL from "node:url";
+import { afterEach, describe, expect, it } from "vite-plus/test";
+
+import { validatePluginCatalog } from "./validate-plugin-catalog.ts";
+
+const temporaryDirectories: string[] = [];
+
+function fixtureRoot(): URL {
+ const directory = NodeFS.mkdtempSync(NodePath.join(NodeOS.tmpdir(), "akeru-plugins-"));
+ temporaryDirectories.push(directory);
+ return NodeURL.pathToFileURL(`${directory}/`);
+}
+
+function copyEntry(id: string, root: URL): URL {
+ const target = new URL(`${id}/`, root);
+ NodeFS.cpSync(new URL(`../plugins/entries/${id}/`, import.meta.url), target, { recursive: true });
+ return target;
+}
+
+afterEach(() => {
+ for (const directory of temporaryDirectories.splice(0)) {
+ NodeFS.rmSync(directory, { recursive: true, force: true });
+ }
+});
+
+describe("plugin catalog validation", () => {
+ it("validates the live plugin directory", () => {
+ expect(validatePluginCatalog().map((entry) => entry.manifest.id)).toEqual([
+ "context",
+ "exa",
+ "executor",
+ "firecrawl",
+ "parallel-search",
+ ]);
+ });
+
+ it("validates isolated manifests and official local assets", () => {
+ const root = fixtureRoot();
+ copyEntry("context", root);
+ copyEntry("executor", root);
+ expect(validatePluginCatalog(root).map((entry) => entry.manifest.id)).toEqual([
+ "context",
+ "executor",
+ ]);
+ });
+
+ it("rejects missing, generic, oversized, unsafe, and shared logos", () => {
+ const missingRoot = fixtureRoot();
+ const missing = copyEntry("exa", missingRoot);
+ NodeFS.rmSync(new URL("logo.svg", missing));
+ expect(() => validatePluginCatalog(missingRoot)).toThrow("is missing logo");
+
+ const renamedGenericRoot = fixtureRoot();
+ const renamedGeneric = copyEntry("exa", renamedGenericRoot);
+ NodeFS.copyFileSync(
+ new URL("../apps/web/public/plugin-logos/mcp.svg", import.meta.url),
+ new URL("logo.svg", renamedGeneric),
+ );
+ expect(() => validatePluginCatalog(renamedGenericRoot)).toThrow("uses a generic MCP logo");
+
+ const unsafeRoot = fixtureRoot();
+ const unsafe = copyEntry("exa", unsafeRoot);
+ NodeFS.writeFileSync(new URL("logo.svg", unsafe), '<svg><script>alert("x")</script></svg>');
+ expect(() => validatePluginCatalog(unsafeRoot)).toThrow("unsafe SVG");
+
+ const oversizedRoot = fixtureRoot();
+ const oversized = copyEntry("exa", oversizedRoot);
+ NodeFS.writeFileSync(new URL("logo.svg", oversized), Buffer.alloc(128 * 1024 + 1));
+ expect(() => validatePluginCatalog(oversizedRoot)).toThrow("exceeds 128 KiB");
+
+ const sharedRoot = fixtureRoot();
+ const context = copyEntry("context", sharedRoot);
+ const exa = copyEntry("exa", sharedRoot);
+ NodeFS.copyFileSync(new URL("logo.svg", context), new URL("logo.svg", exa));
+ expect(() => validatePluginCatalog(sharedRoot)).toThrow("use the same logo");
+ });
+
+ it("requires the exact light and dark SVG asset names", () => {
+ const missingRoot = fixtureRoot();
+ const missing = copyEntry("context", missingRoot);
+ NodeFS.rmSync(new URL("logo-dark.svg", missing));
+ expect(() => validatePluginCatalog(missingRoot)).toThrow("is missing logo 'logo-dark.svg'");
+
+ const renamedRoot = fixtureRoot();
+ const renamed = copyEntry("context", renamedRoot);
+ NodeFS.renameSync(new URL("logo.svg", renamed), new URL("brand.svg", renamed));
+ expect(() => validatePluginCatalog(renamedRoot)).toThrow("is missing logo 'logo.svg'");
+ });
+
+ it("rejects undeclared files so the live directory is the only catalog source", () => {
+ const root = fixtureRoot();
+ const entry = copyEntry("exa", root);
+ NodeFS.writeFileSync(new URL("catalog.generated.json", entry), "[]");
+ expect(() => validatePluginCatalog(root)).toThrow("has undeclared files");
+ });
+});
diff --git a/scripts/validate-plugin-catalog.ts b/scripts/validate-plugin-catalog.ts
new file mode 100644
index 000000000..1383cf7d9
--- /dev/null
+++ b/scripts/validate-plugin-catalog.ts
@@ -0,0 +1,89 @@
+// @effect-diagnostics nodeBuiltinImport:off - Catalog validation reads repository-owned manifests and assets before an Effect runtime exists.
+import * as NodeCrypto from "node:crypto";
+import * as NodeFS from "node:fs";
+
+import { parsePluginManifestJson, type PluginManifest } from "../plugins/schema.ts";
+
+const MAX_LOGO_BYTES = 128 * 1024;
+const UNSAFE_SVG =
+ /<(?:script|foreignObject|iframe|object|embed)|\son[a-z]+\s*=|\b(?:href|src)\s*=\s*["'](?:data:|https?:|\/\/|javascript:)|<!DOCTYPE|<!ENTITY/i;
+const GENERIC_LOGO = /(?:^|[-_.])(default|generic|mcp|placeholder)(?:[-_.]|$)/i;
+const GENERIC_LOGO_HASHES = new Set([
+ "c1f3c1672346935816d34b1d64bd34998f578aef8ba51aa24a032055c23ecfd9",
+ "08f63cb8ff556cf2241d5a5b1633989bc872238a015a4789fc5dbee30babd9b0",
+]);
+
+export interface ValidatedCatalogEntry {
+ readonly directory: string;
+ readonly manifest: PluginManifest;
+}
+
+function validateLogo(
+ directoryUrl: URL,
+ directory: string,
+ filename: string,
+ hashes: Map<string, string>,
+): void {
+ if (GENERIC_LOGO.test(filename)) {
+ throw new TypeError(`Plugin '${directory}' uses generic logo '${filename}'.`);
+ }
+ const logoUrl = new URL(filename, directoryUrl);
+ if (!NodeFS.existsSync(logoUrl)) {
+ throw new TypeError(`Plugin '${directory}' is missing logo '${filename}'.`);
+ }
+ const bytes = NodeFS.readFileSync(logoUrl);
+ if (bytes.byteLength > MAX_LOGO_BYTES) {
+ throw new TypeError(`Plugin '${directory}' logo '${filename}' exceeds 128 KiB.`);
+ }
+ if (filename.endsWith(".svg") && UNSAFE_SVG.test(bytes.toString("utf8"))) {
+ throw new TypeError(`Plugin '${directory}' logo '${filename}' contains unsafe SVG content.`);
+ }
+ const hash = NodeCrypto.createHash("sha256").update(bytes).digest("hex");
+ if (GENERIC_LOGO_HASHES.has(hash)) {
+ throw new TypeError(`Plugin '${directory}' uses a generic MCP logo.`);
+ }
+ const otherPlugin = hashes.get(hash);
+ if (otherPlugin && otherPlugin !== directory) {
+ throw new TypeError(`Plugins '${otherPlugin}' and '${directory}' use the same logo.`);
+ }
+ hashes.set(hash, directory);
+}
+
+export function validatePluginCatalog(
+ entriesRoot = new URL("../plugins/entries/", import.meta.url),
+): readonly ValidatedCatalogEntry[] {
+ const directories = NodeFS.readdirSync(entriesRoot, { withFileTypes: true })
+ .filter((entry) => entry.isDirectory())
+ .map((entry) => entry.name)
+ .toSorted();
+ const ids = new Set<string>();
+ const hashes = new Map<string, string>();
+ const entries = directories.map((directory) => {
+ const directoryUrl = new URL(`${directory}/`, entriesRoot);
+ const manifestUrl = new URL("plugin.json", directoryUrl);
+ if (!NodeFS.existsSync(manifestUrl)) {
+ throw new TypeError(`Plugin directory '${directory}' is missing plugin.json.`);
+ }
+ const manifest = parsePluginManifestJson(
+ NodeFS.readFileSync(manifestUrl, "utf8"),
+ `${directory}/plugin.json`,
+ );
+ if (manifest.id !== directory) {
+ throw new TypeError(`Plugin '${manifest.id}' must live in entries/${manifest.id}/.`);
+ }
+ if (ids.has(manifest.id)) throw new TypeError(`Duplicate plugin id '${manifest.id}'.`);
+ ids.add(manifest.id);
+
+ const logos = ["logo.svg", "logo-dark.svg"];
+ for (const filename of logos) validateLogo(directoryUrl, directory, filename, hashes);
+ const expectedFiles = new Set(["plugin.json", ...logos]);
+ const unexpected = NodeFS.readdirSync(directoryUrl).filter((file) => !expectedFiles.has(file));
+ if (unexpected.length > 0) {
+ throw new TypeError(`Plugin '${directory}' has undeclared files: ${unexpected.join(", ")}.`);
+ }
+ return Object.freeze({ directory, manifest });
+ });
+ return Object.freeze(entries);
+}
+
+if (import.meta.main) validatePluginCatalog();