@decocms/mesh-sdk 1.1.0

package/src/lib/constants.ts

@@ -0,0 +1,204 @@
+/**
+ * Well-known MCP Constants
+ *
+ * Single source of truth for well-known MCP IDs and connection definitions.
+ * This module provides constants and factory functions for creating standard MCP connections.
+ */
+
+import type { ConnectionCreateData } from "../types/connection";
+import type { VirtualMCPEntity } from "../types/virtual-mcp";
+
+/**
+ * Well-known MCP connection ID generators (org-scoped)
+ *
+ * These generate org-prefixed connection IDs for well-known MCPs.
+ * Example: WellKnownOrgMCPId.SELF("my-org") => "my-org_self"
+ */
+export const WellKnownOrgMCPId = {
+  /** Self/management MCP - used for management tools (monitoring, organization, user, collections) */
+  SELF: (org: string) => `${org}_self`,
+  /** Deco Store registry */
+  REGISTRY: (org: string) => `${org}_registry`,
+  /** Community MCP registry */
+  COMMUNITY_REGISTRY: (org: string) => `${org}_community-registry`,
+};
+
+/**
+ * Frontend connection ID for the self/management MCP endpoint.
+ * Use this constant when calling management tools (ALL_TOOLS) from the frontend.
+ * The endpoint is exposed at /mcp/self.
+ */
+export const SELF_MCP_ALIAS_ID = "self";
+
+/**
+ * Get well-known connection definition for the Deco Store registry.
+ * This can be used by both frontend and backend to create registry connections.
+ *
+ * @returns ConnectionCreateData for the Deco Store registry
+ */
+export function getWellKnownRegistryConnection(
+  orgId: string,
+): ConnectionCreateData {
+  return {
+    id: WellKnownOrgMCPId.REGISTRY(orgId),
+    title: "Deco Store",
+    description: "Official deco MCP registry with curated integrations",
+    connection_type: "HTTP",
+    connection_url: "https://api.decocms.com/mcp/registry",
+    icon: "https://assets.decocache.com/decocms/00ccf6c3-9e13-4517-83b0-75ab84554bb9/596364c63320075ca58483660156b6d9de9b526e.png",
+    app_name: "deco-registry",
+    app_id: null,
+    connection_token: null,
+    connection_headers: null,
+    oauth_config: null,
+    configuration_state: null,
+    configuration_scopes: null,
+    metadata: {
+      isDefault: true,
+      type: "registry",
+    },
+  };
+}
+
+/**
+ * Get well-known connection definition for the Community Registry.
+ * Community MCP registry with thousands of handy MCPs.
+ *
+ * @returns ConnectionCreateData for the Community Registry
+ */
+export function getWellKnownCommunityRegistryConnection(): ConnectionCreateData {
+  return {
+    id: "community-registry",
+    title: "MCP Registry",
+    description: "Community MCP registry with thousands of handy MCPs",
+    connection_type: "HTTP",
+    connection_url: "https://sites-registry.decocache.com/mcp",
+    icon: "https://assets.decocache.com/decocms/cd7ca472-0f72-463a-b0de-6e44bdd0f9b4/mcp.png",
+    app_name: "mcp-registry",
+    app_id: null,
+    connection_token: null,
+    connection_headers: null,
+    oauth_config: null,
+    configuration_state: null,
+    configuration_scopes: null,
+    metadata: {
+      isDefault: true,
+      type: "registry",
+    },
+  };
+}
+
+/**
+ * Get well-known connection definition for the Management MCP (SELF).
+ * The connection URL is dynamic based on the base URL, so this is a function.
+ *
+ * @param baseUrl - The base URL for the MCP server (e.g., "http://localhost:3000" or "https://mesh.example.com")
+ * @returns ConnectionCreateData for the Management MCP
+ */
+export function getWellKnownSelfConnection(
+  baseUrl: string,
+  orgId: string,
+): ConnectionCreateData {
+  return {
+    id: WellKnownOrgMCPId.SELF(orgId),
+    title: "Mesh MCP",
+    description: "The MCP for the mesh API",
+    connection_type: "HTTP",
+    // Custom url for targeting this mcp. It's a standalone endpoint that exposes all management tools.
+    connection_url: `${baseUrl}/mcp/${SELF_MCP_ALIAS_ID}`,
+    icon: "https://assets.decocache.com/mcp/09e44283-f47d-4046-955f-816d227c626f/app.png",
+    app_name: "@deco/management-mcp",
+    connection_token: null,
+    connection_headers: null,
+    oauth_config: null,
+    configuration_state: null,
+    configuration_scopes: null,
+    metadata: {
+      isDefault: true,
+      type: "self",
+    },
+  };
+}
+
+/**
+ * Get well-known connection definition for OpenRouter.
+ * Used by the chat UI to offer a one-click install when no model provider is connected.
+ */
+export function getWellKnownOpenRouterConnection(
+  opts: { id?: string } = {},
+): ConnectionCreateData {
+  return {
+    id: opts.id,
+    title: "OpenRouter",
+    description: "Access hundreds of LLM models from a single API",
+    icon: "https://openrouter.ai/favicon.ico",
+    app_name: "openrouter",
+    app_id: "openrouter",
+    connection_type: "HTTP",
+    connection_url: "https://sites-openrouter.decocache.com/mcp",
+    connection_token: null,
+    connection_headers: null,
+    oauth_config: null,
+    configuration_state: null,
+    configuration_scopes: null,
+    metadata: {
+      source: "chat",
+      verified: false,
+      scopeName: "deco",
+      toolsCount: 0,
+      publishedAt: null,
+      repository: null,
+    },
+  };
+}
+
+/**
+ * Get well-known connection definition for MCP Studio.
+ * Used by agents and workflows pages to offer installation when no provider is connected.
+ */
+export function getWellKnownMcpStudioConnection(): ConnectionCreateData {
+  return {
+    title: "MCP Studio",
+    description: "An app that allows you to create and manage MCPs",
+    icon: "https://assets.decocache.com/mcp/09e44283-f47d-4046-955f-816d227c626f/app.png",
+    app_name: "mcp-studio",
+    app_id: "65a1b407-b6af-41e2-a89f-ce9450c05bbc",
+    connection_type: "HTTP",
+    connection_url: "https://sites-vibemcp.decocache.com/mcp",
+    connection_token: null,
+    connection_headers: null,
+    oauth_config: null,
+    configuration_state: null,
+    configuration_scopes: null,
+    metadata: {
+      isDefault: false,
+      type: "mcp-studio",
+    },
+  };
+}
+
+/**
+ * Get well-known Decopilot Agent virtual MCP entity.
+ * This is the default agent that aggregates ALL org connections.
+ *
+ * @param organizationId - Organization ID
+ * @returns VirtualMCPEntity representing the Decopilot agent
+ */
+export function getWellKnownDecopilotAgent(
+  organizationId: string,
+): VirtualMCPEntity {
+  return {
+    id: `decopilot-${organizationId}`,
+    organization_id: organizationId,
+    title: "Decopilot",
+    description: "Default agent that aggregates all organization connections",
+    icon: "https://assets.decocache.com/decocms/fd07a578-6b1c-40f1-bc05-88a3b981695d/f7fc4ffa81aec04e37ae670c3cd4936643a7b269.png",
+    tool_selection_mode: "exclusion",
+    status: "active",
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+    created_by: "system",
+    updated_by: undefined,
+    connections: [], // Empty = no exclusions, include all connections
+  };
+}