[AI] Add PERFORMANCE_ANALYZE external request

This external request uses the full trace agent, rather than confined to
a specific insight.

No impact on PERFORMANCE_ANALYZE_INSIGHT, but it will be removed soon.

Bug: 425270067
Change-Id: I92553373618c2ed55df5464d735c45d6517d6a76
Reviewed-on: https://chromium-review.googlesource.com/c/devtools/devtools-frontend/+/6886192
Commit-Queue: Connor Clark <cjamcl@chromium.org>
Reviewed-by: Paul Irish <paulirish@chromium.org>
Auto-Submit: Connor Clark <cjamcl@chromium.org>

Author: Connor Clark

front_end/entrypoints/main/MainImpl.ts

@@ -1052,8 +1052,12 @@ type ExternalRequestInput = {
 }|{
   kind: 'PERFORMANCE_RELOAD_GATHER_INSIGHTS',
 }|{
+  // TODO(b/425270067): remove once MCP removes insight tool.
   kind: 'PERFORMANCE_ANALYZE_INSIGHT',
   args: {insightTitle: string, prompt: string},
+}|{
+  kind: 'PERFORMANCE_ANALYZE',
+  args: {prompt: string},
 }|{
   kind: 'NETWORK_DEBUGGER',
   args: {requestUrl: string, prompt: string},
@@ -1104,6 +1108,17 @@ export async function handleExternalRequestGenerator(input: ExternalRequestInput
         traceModel,
       });
     }
+    case 'PERFORMANCE_ANALYZE': {
+      const AiAssistanceModel = await import('../../models/ai_assistance/ai_assistance.js');
+      const TimelinePanel = await import('../../panels/timeline/timeline.js');
+      const traceModel = TimelinePanel.TimelinePanel.TimelinePanel.instance().model;
+      const conversationHandler = AiAssistanceModel.ConversationHandler.instance();
+      return await conversationHandler.handleExternalRequest({
+        conversationType: AiAssistanceModel.ConversationType.PERFORMANCE_FULL,
+        prompt: input.args.prompt,
+        traceModel,
+      });
+    }
     case 'NETWORK_DEBUGGER': {
       const AiAssistanceModel = await import('../../models/ai_assistance/ai_assistance.js');
       const conversationHandler = await AiAssistanceModel.ConversationHandler.instance();

front_end/models/ai_assistance/ConversationHandler.ts

@@ -50,6 +50,12 @@ export interface ExternalPerformanceInsightsRequestParameters {
   traceModel: Trace.TraceModel.Model;
 }
 
+export interface ExternalPerformanceRequestParameters {
+  conversationType: ConversationType.PERFORMANCE_FULL;
+  prompt: string;
+  traceModel: Trace.TraceModel.Model;
+}
+
 const UIStrings = {
   /**
    * @description Notification shown to the user whenever DevTools receives an external request.
@@ -178,7 +184,7 @@ export class ConversationHandler {
    */
   async handleExternalRequest(
       parameters: ExternalStylingRequestParameters|ExternalNetworkRequestParameters|
-      ExternalPerformanceInsightsRequestParameters,
+      ExternalPerformanceInsightsRequestParameters|ExternalPerformanceRequestParameters,
       ): Promise<AsyncGenerator<ExternalRequestResponse, ExternalRequestResponse>> {
     try {
       Snackbars.Snackbar.Snackbar.show({message: i18nString(UIStrings.externalRequestReceived)});
@@ -203,6 +209,8 @@ export class ConversationHandler {
           }
           return await this.#handleExternalPerformanceInsightsConversation(
               parameters.prompt, parameters.insightTitle, parameters.traceModel);
+        case ConversationType.PERFORMANCE_FULL:
+          return await this.#handleExternalPerformanceConversation(parameters.prompt, parameters.traceModel);
         case ConversationType.NETWORK:
           if (!parameters.requestUrl) {
             return this.#generateErrorResponse('The url is required for debugging a network request.');
@@ -306,6 +314,23 @@ export class ConversationHandler {
     });
   }
 
+  async #handleExternalPerformanceConversation(prompt: string, traceModel: Trace.TraceModel.Model):
+      Promise<AsyncGenerator<ExternalRequestResponse, ExternalRequestResponse>> {
+    const agent = this.createAgent(ConversationType.PERFORMANCE_FULL);
+    const focusOrError = await Tracing.ExternalRequests.getPerformanceAgentFocusToDebug(
+        traceModel,
+    );
+    if ('error' in focusOrError) {
+      return this.#generateErrorResponse(focusOrError.error);
+    }
+    return this.#doExternalConversation({
+      conversationType: ConversationType.PERFORMANCE_FULL,
+      aiAgent: agent,
+      prompt,
+      selected: new PerformanceTraceContext(focusOrError.focus),
+    });
+  }
+
   async #handleExternalNetworkConversation(prompt: string, requestUrl: string):
       Promise<AsyncGenerator<ExternalRequestResponse, ExternalRequestResponse>> {
     const networkAgent = this.createAgent(ConversationType.NETWORK);

front_end/services/tracing/ExternalRequests.ts

@@ -54,3 +54,21 @@ export async function getInsightAgentFocusToDebug(
   const focus = TimelineUtils.AIContext.AgentFocus.fromInsight(parsedTrace, insight, insights.bounds);
   return {focus};
 }
+
+export async function getPerformanceAgentFocusToDebug(model: Trace.TraceModel.Model): Promise<InsightResponse> {
+  const parsedTrace = model.parsedTrace();
+  const insights = model.traceInsights();
+  const traceMetadata = model.metadata();
+  if (!insights || !parsedTrace || !traceMetadata) {
+    return {
+      error:
+          'No trace has been recorded, so we cannot analyze the performance. Must run the devtools_performance_run_trace tool first.',
+    };
+  }
+
+  // Currently only support a single insight set.
+  const insightSet = [...insights.values()].at(0) ?? null;
+
+  const focus = TimelineUtils.AIContext.AgentFocus.full(parsedTrace, insightSet, traceMetadata);
+  return {focus};
+}