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.
import type { McpServer, OrchestrationBot, ProviderAccessStatus } from "@akeru/contracts";
import {
PLUGIN_CATEGORIES,
type PluginCategory,
type PluginDirectoryDefinition,
} from "../../../../../plugins";
export type PluginFilter = "All" | "Featured" | "Installed" | PluginCategory;
function pluginMatchesCategory(
plugin: PluginDirectoryDefinition,
category: PluginCategory,
): boolean {
return (
plugin.category === category ||
plugin.tags.some((tag) => tag.toLocaleLowerCase() === category.toLocaleLowerCase())
);
}
export function buildPluginFilters(
plugins: readonly PluginDirectoryDefinition[],
): readonly PluginFilter[] {
const categories = PLUGIN_CATEGORIES.filter((category) =>
plugins.some((plugin) => pluginMatchesCategory(plugin, category)),
);
return ["All", "Featured", "Installed", ...categories];
}
export interface PluginSection {
readonly title: string;
readonly plugins: readonly PluginDirectoryDefinition[];
}
export interface PluginPrimaryAction {
readonly label: "Add" | "Connect" | "Add key" | "Disable" | "Reconnect";
readonly enable: boolean | null;
readonly blocker?: string;
}
export function pluginMatchesQuery(plugin: PluginDirectoryDefinition, query: string): boolean {
return [
plugin.name,
plugin.title,
plugin.description,
plugin.category,
...plugin.tags,
...plugin.capabilities,
plugin.publisher.name,
...(plugin.connection.type === "brokered" ? [plugin.connection.broker.name] : []),
]
.join("\n")
.toLocaleLowerCase()
.includes(query.trim().toLocaleLowerCase());
}
type DependentBot = Pick<OrchestrationBot, "name" | "archivedAt" | "disabledMcpServerIds">;
export function pluginActiveDependentBotNames(
server: McpServer | undefined,
bots: readonly DependentBot[],
): readonly string[] {
if (!server?.enabled) return [];
return bots.flatMap((bot) =>
bot.archivedAt === null && !bot.disabledMcpServerIds.includes(server.id) ? [bot.name] : [],
);
}
export function buildPluginSections(input: {
readonly plugins: readonly PluginDirectoryDefinition[];
readonly query: string;
readonly filter: PluginFilter;
readonly installedPluginIds?: ReadonlySet<string>;
}): readonly PluginSection[] {
const plugins = input.plugins
.filter((plugin) => pluginMatchesQuery(plugin, input.query))
.filter((plugin) => {
if (input.filter === "All") return true;
if (input.filter === "Featured") return plugin.featured === true;
if (input.filter === "Installed") return input.installedPluginIds?.has(plugin.id) ?? false;
return pluginMatchesCategory(plugin, input.filter);
});
if (input.query.trim()) return [{ title: "Search results", plugins }];
if (input.filter !== "All") return [{ title: input.filter, plugins }];
const featured = plugins.filter((plugin) => plugin.featured);
const sections = PLUGIN_CATEGORIES.map((category) => ({
title: category,
plugins: plugins.filter((plugin) => !plugin.featured && plugin.category === category),
})).filter((section) => section.plugins.length > 0);
return featured.length > 0 ? [{ title: "Featured", plugins: featured }, ...sections] : sections;
}
export function pluginBlocker(plugin: PluginDirectoryDefinition): string | null {
if (plugin.connection.type === "brokered") return plugin.connection.pendingBlocker ?? null;
if (
plugin.connection.type === "approval-pending" ||
plugin.connection.type === "verification-pending"
) {
return plugin.connection.blocker;
}
if (plugin.kind === "mcp-unavailable") return `${plugin.title} has no available connector.`;
return null;
}
export function pluginPrimaryAction(
plugin: PluginDirectoryDefinition,
server: McpServer | undefined,
accessStatus?: ProviderAccessStatus,
): PluginPrimaryAction {
const needsReconnect =
(plugin.authentication === "oauth" || plugin.authentication === "optional-oauth") &&
accessStatus !== undefined &&
["expired", "revoked", "failed", "failed-first-request"].includes(accessStatus.health);
if (server?.enabled && !needsReconnect) return { label: "Disable", enable: false };
const blocker = pluginBlocker(plugin);
// A blocked entry cannot reconnect, but an enabled server must stay switchable off.
if (blocker && server?.enabled) return { label: "Disable", enable: false };
if (blocker) return { label: "Connect", enable: null, blocker };
if (server) return { label: "Reconnect", enable: true };
if (plugin.authentication === "api-key") return { label: "Add key", enable: true };
if (plugin.connection.type === "local" || plugin.authentication === "none") {
return { label: "Add", enable: true };
}
return { label: "Connect", enable: true };
}
export function pluginConnectionLabel(plugin: PluginDirectoryDefinition): string {
if (plugin.connection.type === "approval-pending") return "Approval pending";
if (
plugin.connection.type === "verification-pending" ||
(plugin.connection.type === "brokered" && plugin.connection.pendingBlocker !== undefined)
) {
return "Verification pending";
}
if (plugin.connection.type === "local") return "Local";
if (plugin.authentication === "api-key") return "API key";
if (plugin.authentication === "oauth" || plugin.authentication === "optional-oauth") {
return "OAuth";
}
return "No sign-in";
}
/**
* Names the broker that holds a plugin's accounts. Catalog rows and details use
* it so an app such as Gmail reads as its own entry while still saying who
* actually carries the connection.
*/
export function pluginBrokerName(plugin: PluginDirectoryDefinition): string | null {
return plugin.connection.type === "brokered" ? plugin.connection.broker.name : null;
}
export function pluginExecutionLabel(plugin: PluginDirectoryDefinition): string {
if (plugin.connection.type === "brokered") return "Hosted";
if (plugin.kind === "mcp-unavailable") return "Unavailable";
return plugin.kind === "mcp-stdio" || plugin.connection.type === "local" ? "Local" : "Hosted";
}