Use current agent conversation API (#1261)

- Align MCP AI conversation tools with Sentry’s current agent
conversation API.
- Update specs and coverage for the renamed routes.

Co-authored-by: Codex CLI Agent <noreply@openai.com>

Author: ArthurKnaus

docs/specs/ai-conversations.md

@@ -113,7 +113,7 @@ Parameter behavior:
 Use the Sentry AI Conversations list endpoint:
 
 ```text
-GET /api/0/organizations/{organizationSlug}/ai-conversations/
+GET /api/0/organizations/{organizationSlug}/agents/conversations/
 ```
 
 Do not implement conversation search through
@@ -465,7 +465,7 @@ get_sentry_resource({
 Add focused tests for:
 
 1. Basic search:
-   - Calls `/organizations/{org}/ai-conversations/`.
+   - Calls `/organizations/{org}/agents/conversations/`.
    - Passes `query`, `per_page`, and time parameters.
    - Returns one structured summary per conversation.
 2. Empty results:

packages/mcp-core/src/api-client/client.ts

@@ -4597,7 +4597,7 @@ export class SentryApiService {
       }
 
       const response = await this.request(
-        apiPath`/organizations/${organizationSlug}/ai-conversations/${conversationId}/` +
+        apiPath`/organizations/${organizationSlug}/agents/conversations/${conversationId}/` +
           `?${queryParams.toString()}`,
         undefined,
         opts,
@@ -4679,7 +4679,7 @@ export class SentryApiService {
     }
 
     const response = await this.request(
-      apiPath`/organizations/${organizationSlug}/ai-conversations/` +
+      apiPath`/organizations/${organizationSlug}/agents/conversations/` +
         `?${queryParams.toString()}`,
       undefined,
       opts,

packages/mcp-core/src/server.test.ts

@@ -1403,7 +1403,7 @@ describe("buildServer", () => {
     it("execute_sentry_tool dispatches structured catalog results", async () => {
       mswServer.use(
         http.get(
-          "https://sentry.io/api/0/organizations/test-org/ai-conversations/",
+          "https://sentry.io/api/0/organizations/test-org/agents/conversations/",
           ({ request }) => {
             const url = new URL(request.url);
             expect(url.searchParams.get("query")).toBe("checkout");

packages/mcp-core/src/tools/catalog/get-ai-conversation-details.test.ts

@@ -115,7 +115,7 @@ function mockConversationEndpoint(
 ) {
   mswServer.use(
     http.get(
-      `https://sentry.io/api/0/organizations/${org}/ai-conversations/${conversationId}/`,
+      `https://sentry.io/api/0/organizations/${org}/agents/conversations/${conversationId}/`,
       ({ request }) => {
         const url = new URL(request.url);
         expect(url.searchParams.get("statsPeriod")).toBe("30d");
@@ -538,7 +538,7 @@ describe("get_ai_conversation_details", () => {
   it("preserves scoped query parameters from conversation URLs", async () => {
     mswServer.use(
       http.get(
-        "https://sentry.io/api/0/organizations/sentry-mcp-evals/ai-conversations/conv-123/",
+        "https://sentry.io/api/0/organizations/sentry-mcp-evals/agents/conversations/conv-123/",
         ({ request }) => {
           const url = new URL(request.url);
           expect(url.searchParams.get("statsPeriod")).toBeNull();
@@ -574,7 +574,7 @@ describe("get_ai_conversation_details", () => {
   it("describes explicit lookup windows when no spans are found", async () => {
     mswServer.use(
       http.get(
-        "https://sentry.io/api/0/organizations/sentry-mcp-evals/ai-conversations/conv-empty/",
+        "https://sentry.io/api/0/organizations/sentry-mcp-evals/agents/conversations/conv-empty/",
         ({ request }) => {
           const url = new URL(request.url);
           expect(url.searchParams.get("statsPeriod")).toBeNull();

packages/mcp-core/src/tools/catalog/search-ai-conversations.test.ts

@@ -52,7 +52,7 @@ describe("search_ai_conversations", () => {
   it("returns conversation-shaped search results", async () => {
     mswServer.use(
       http.get(
-        "https://sentry.io/api/0/organizations/test-org/ai-conversations/",
+        "https://sentry.io/api/0/organizations/test-org/agents/conversations/",
         ({ request }) => {
           const url = new URL(request.url);
           expect(url.searchParams.get("query")).toBe("checkout");
@@ -142,7 +142,7 @@ describe("search_ai_conversations", () => {
   it("keeps search results concise for large conversations", async () => {
     mswServer.use(
       http.get(
-        "https://sentry.io/api/0/organizations/test-org/ai-conversations/",
+        "https://sentry.io/api/0/organizations/test-org/agents/conversations/",
         () => HttpResponse.json([longConversation]),
       ),
     );
@@ -179,7 +179,7 @@ describe("search_ai_conversations", () => {
   it("defaults searches to the same 30d window as detail lookups", async () => {
     mswServer.use(
       http.get(
-        "https://sentry.io/api/0/organizations/test-org/ai-conversations/",
+        "https://sentry.io/api/0/organizations/test-org/agents/conversations/",
         ({ request }) => {
           const url = new URL(request.url);
           expect(url.searchParams.get("statsPeriod")).toBe("30d");
@@ -213,7 +213,7 @@ describe("search_ai_conversations", () => {
   it("defaults to the configured search window when period is omitted", async () => {
     mswServer.use(
       http.get(
-        "https://sentry.io/api/0/organizations/test-org/ai-conversations/",
+        "https://sentry.io/api/0/organizations/test-org/agents/conversations/",
         ({ request }) => {
           const url = new URL(request.url);
           expect(url.searchParams.get("statsPeriod")).toBe("30d");
@@ -252,12 +252,12 @@ describe("search_ai_conversations", () => {
         }),
       ),
       http.get(
-        "https://sentry.io/api/0/organizations/test-org/ai-conversations/",
+        "https://sentry.io/api/0/organizations/test-org/agents/conversations/",
         ({ request }) => {
           requestUrls.push(request.url);
           return HttpResponse.json([], {
             headers: {
-              Link: '<https://sentry.io/api/0/organizations/test-org/ai-conversations/?cursor=page-2>; rel="next"; results="true"; cursor="page-2"',
+              Link: '<https://sentry.io/api/0/organizations/test-org/agents/conversations/?cursor=page-2>; rel="next"; results="true"; cursor="page-2"',
             },
           });
         },
@@ -307,7 +307,7 @@ describe("search_ai_conversations", () => {
     let requestUrl: string | undefined;
     mswServer.use(
       http.get(
-        "https://sentry.io/api/0/organizations/test-org/ai-conversations/",
+        "https://sentry.io/api/0/organizations/test-org/agents/conversations/",
         ({ request }) => {
           requestUrl = request.url;
           return HttpResponse.json([]);