feat: add GitHub Copilot agent format and MCP server support

.github/agents/git-master.agent.md

@@ -1,5 +1,5 @@
 ---
 description: 'Describe what this custom agent does and when to use it.'
-tools: ['vscode', 'launch', 'edit', 'runNotebooks', 'search', 'new', 'shell', 'agents', 'usages', 'vscodeAPI', 'problems', 'changes', 'testFailure', 'openSimpleBrowser', 'fetch', 'githubRepo', 'github.vscode-pull-request-github/copilotCodingAgent', 'github.vscode-pull-request-github/issue_fetch', 'github.vscode-pull-request-github/suggest-fix', 'github.vscode-pull-request-github/searchSyntax', 'github.vscode-pull-request-github/doSearch', 'github.vscode-pull-request-github/renderIssues', 'github.vscode-pull-request-github/activePullRequest', 'github.vscode-pull-request-github/openPullRequest', 'todo']
+tools: ['vscode', 'launch', 'edit', 'read', 'search', 'web', 'shell', 'agents', 'github.vscode-pull-request-github/copilotCodingAgent', 'github.vscode-pull-request-github/issue_fetch', 'github.vscode-pull-request-github/suggest-fix', 'github.vscode-pull-request-github/searchSyntax', 'github.vscode-pull-request-github/doSearch', 'github.vscode-pull-request-github/renderIssues', 'github.vscode-pull-request-github/activePullRequest', 'github.vscode-pull-request-github/openPullRequest', 'todo']
 ---
 Define what this custom agent accomplishes for the user, when to use it, and the edges it won't cross. Specify its ideal inputs/outputs, the tools it may call, and how it reports progress or asks for help.

packages/backend/src/routes/agents/get-agent.ts

@@ -32,7 +32,17 @@ export const getAgentHandler = (serviceProvider: ServiceProvider<AppServiceMap>)
         });
       }
 
+      // Get versions list
+      const versions = await agentService.listAgentVersions(owner, name, userId);
+
       const mappedAgent = mapAgentToDetailResponse(agent);
+      mappedAgent.versions = versions.map((v) => ({
+        version: v.version,
+        agentVersion: v.agentVersion,
+        publishedAt: v.publishedAt.toISOString(),
+        downloads: v.downloads,
+        isLatest: v.isLatest,
+      }));
 
       res.json({
         success: true,

packages/backend/src/routes/agents/get-version.ts

@@ -2,7 +2,7 @@ import { NextFunction, Request, Response } from 'express';
 import { z } from 'zod';
 import { validateRequest } from '../../middleware/validation.middleware';
 import { AppServiceMap, ServiceProvider } from '../../services';
-import { mapAgentToDetailResponse } from '../../utils/agent-response.mapper';
+import { mapAgentVersionToResponse } from '../../utils/agent-response.mapper';
 
 export const getAgentVersionHandler = (serviceProvider: ServiceProvider<AppServiceMap>) => [
   validateRequest({
@@ -33,23 +33,7 @@ export const getAgentVersionHandler = (serviceProvider: ServiceProvider<AppServi
         });
       }
 
-      // Get agent for metadata
-      const agent = await agentService.getAgent(owner, name, userId);
-      if (!agent) {
-        return res.status(404).json({
-          success: false,
-          error: 'Not Found',
-          message: `Agent '${owner}/${name}' not found`,
-        });
-      }
-
-      // Combine agent metadata with version content
-      const response = {
-        ...mapAgentToDetailResponse(agent),
-        version: versionDoc.version,
-        content: versionDoc.content,
-        publishedAt: versionDoc.publishedAt.toISOString(),
-      };
+      const response = mapAgentVersionToResponse(versionDoc);
 
       res.json({
         success: true,

packages/backend/src/routes/agents/index.ts

@@ -10,6 +10,7 @@ import { deleteAgentHandler } from './delete';
 import { getAgentHandler } from './get-agent';
 import { getAgentVersionHandler } from './get-version';
 import { getListAgentsHandler } from './list';
+import { getAgentsByMcpServerHandler, getMcpServersHandler } from './mcp-servers';
 import { publishAgentHandler } from './publish';
 import { searchAgentsHandler } from './search';
 import { updateAgentMetadataHandler } from './update-metadata';
@@ -22,6 +23,8 @@ export const getAgentsRouter = (serviceProvider: ServiceProvider<AppServiceMap>)
   // Public routes
   router.get('/', ...getListAgentsHandler(serviceProvider));
   router.get('/search', ...searchAgentsHandler(serviceProvider));
+  router.get('/mcp-servers', ...getMcpServersHandler(serviceProvider));
+  router.get('/mcp-servers/:serverName', ...getAgentsByMcpServerHandler(serviceProvider));
   router.get('/:owner/:name', ...getAgentHandler(serviceProvider));
   router.get('/:owner/:name/versions', ...getAgentVersionsHandler(serviceProvider));
   router.get('/:owner/:name/versions/:version', ...getAgentVersionHandler(serviceProvider));
@@ -38,6 +41,7 @@ export * from './delete';
 export * from './get-agent';
 export * from './get-version';
 export * from './list';
+export * from './mcp-servers';
 export * from './publish';
 export * from './search';
 export * from './update-metadata';

packages/backend/src/routes/agents/mcp-servers.ts

@@ -0,0 +1,88 @@
+import { NextFunction, Request, Response } from 'express';
+import { z } from 'zod';
+import { validateRequest } from '../../middleware/validation.middleware';
+import { AppServiceMap, ServiceProvider } from '../../services';
+import { mapAgentToListResponse } from '../../utils/agent-response.mapper';
+
+export const getMcpServersHandler = (serviceProvider: ServiceProvider<AppServiceMap>) => [
+  validateRequest({
+    query: z.object({
+      page: z.coerce.number().int().min(1).default(1),
+      limit: z.coerce.number().int().min(1).max(100).default(20),
+    }),
+    serviceProvider,
+  }),
+  async (req: Request, res: Response, next: NextFunction) => {
+    try {
+      const logger = await serviceProvider.get('logger');
+      const agentService = await serviceProvider.get('agent');
+
+      const page = Number(req.query.page) || 1;
+      const limit = Number(req.query.limit) || 20;
+      const userId = (req.user as { id: string } | undefined)?.id;
+
+      logger.info('List agents with MCP servers requested', { page, limit, userId });
+
+      const result = await agentService.findWithMcpServers(page, limit, userId);
+
+      res.json({
+        success: true,
+        data: {
+          agents: result.agents.map(mapAgentToListResponse),
+          pagination: {
+            page: result.page,
+            limit: result.limit,
+            total: result.total,
+            hasMore: result.hasMore,
+          },
+        },
+      });
+    } catch (error) {
+      next(error);
+    }
+  },
+];
+
+export const getAgentsByMcpServerHandler = (serviceProvider: ServiceProvider<AppServiceMap>) => [
+  validateRequest({
+    params: z.object({
+      serverName: z.string().min(1),
+    }),
+    query: z.object({
+      page: z.coerce.number().int().min(1).default(1),
+      limit: z.coerce.number().int().min(1).max(100).default(20),
+    }),
+    serviceProvider,
+  }),
+  async (req: Request, res: Response, next: NextFunction) => {
+    try {
+      const logger = await serviceProvider.get('logger');
+      const agentService = await serviceProvider.get('agent');
+
+      const { serverName } = req.params;
+      const page = Number(req.query.page) || 1;
+      const limit = Number(req.query.limit) || 20;
+      const userId = (req.user as { id: string } | undefined)?.id;
+
+      logger.info('List agents by MCP server requested', { serverName, page, limit, userId });
+
+      const result = await agentService.findByMcpServer(serverName, page, limit, userId);
+
+      res.json({
+        success: true,
+        data: {
+          serverName,
+          agents: result.agents.map(mapAgentToListResponse),
+          pagination: {
+            page: result.page,
+            limit: result.limit,
+            total: result.total,
+            hasMore: result.hasMore,
+          },
+        },
+      });
+    } catch (error) {
+      next(error);
+    }
+  },
+];