Merge remote-tracking branch 'origin/main' into beta-releases

Author: github-actions[bot]

THIRD-PARTY-NOTICES.md

@@ -1,5 +1,5 @@
 The following third-party software is used by and included in **Mongodb Compass**.
-This document was automatically generated on Sun Aug 31 2025.
+This document was automatically generated on Mon Sep 01 2025.
 
 ## List of dependencies
 

docs/tracking-plan.md

@@ -6,7 +6,7 @@
 > the tracking plan for the specific Compass version you can use the following
 > URL: `https://github.com/mongodb-js/compass/blob/<compass version>/docs/tracking-plan.md`
 
-Generated on Sun, Aug 31, 2025
+Generated on Mon, Sep 1, 2025
 
 ## Table of Contents
 
@@ -1283,6 +1283,8 @@ This event is fired when user executes a query
   - Indicates whether the query includes a skip operation.
 - **has_sort** (required): `boolean`
   - Indicates whether the query includes a sort operation.
+- **default_sort** (required): `"none" | "natural" | "_id"`
+  - Indicates which default sort was set in settings
 - **has_limit** (required): `boolean`
   - Indicates whether the query includes a limit operation.
 - **has_collation** (required): `boolean`

package-lock.json

@@ -60,6 +60,7 @@
     "@mongodb-js/atlas-service": "^0.56.0",
     "@mongodb-js/compass-app-registry": "^9.4.20",
     "@mongodb-js/compass-app-stores": "^7.57.0",
+    "@mongodb-js/compass-assistant": "^1.2.0",
     "@mongodb-js/compass-collection": "^4.70.0",
     "@mongodb-js/compass-components": "^1.49.0",
     "@mongodb-js/compass-connections": "^1.71.0",

packages/compass-aggregations/package.json

@@ -50,6 +50,7 @@ describe('PipelineActions', function () {
           onUpdateView={() => {}}
           onCollectionScanInsightActionButtonClick={() => {}}
           onShowAIInputClick={() => {}}
+          stages={[]}
         />
       );
     });
@@ -115,6 +116,7 @@ describe('PipelineActions', function () {
           onExplainAggregation={() => {}}
           onCollectionScanInsightActionButtonClick={() => {}}
           onShowAIInputClick={() => {}}
+          stages={[]}
         />
       );
     });
@@ -158,6 +160,7 @@ describe('PipelineActions', function () {
             onExplainAggregation={() => {}}
             onCollectionScanInsightActionButtonClick={() => {}}
             onShowAIInputClick={() => {}}
+            stages={[]}
           />
         </PreferencesProvider>
       );
@@ -195,6 +198,7 @@ describe('PipelineActions', function () {
           onUpdateView={() => {}}
           onCollectionScanInsightActionButtonClick={() => {}}
           onShowAIInputClick={() => {}}
+          stages={[]}
         />
       );
     });

packages/compass-aggregations/src/components/pipeline-toolbar/pipeline-header/pipeline-actions.spec.tsx

@@ -27,6 +27,7 @@ import {
   useIsAIFeatureEnabled,
 } from 'compass-preferences-model/provider';
 import { showInput as showAIInput } from '../../../modules/pipeline-builder/pipeline-ai';
+import { useAssistantActions } from '@mongodb-js/compass-assistant';
 
 const containerStyles = css({
   display: 'flex',
@@ -59,6 +60,8 @@ type PipelineActionsProps = {
 
   showCollectionScanInsight?: boolean;
   onCollectionScanInsightActionButtonClick: () => void;
+
+  stages: string[];
 };
 
 export const PipelineActions: React.FunctionComponent<PipelineActionsProps> = ({
@@ -80,12 +83,14 @@ export const PipelineActions: React.FunctionComponent<PipelineActionsProps> = ({
   onExplainAggregation,
   showCollectionScanInsight,
   onCollectionScanInsightActionButtonClick,
+  stages,
 }) => {
   const enableAggregationBuilderExtraOptions = usePreference(
     'enableAggregationBuilderExtraOptions'
   );
   const showInsights = usePreference('showInsights');
   const isAIFeatureEnabled = useIsAIFeatureEnabled();
+  const { tellMoreAboutInsight } = useAssistantActions();
 
   return (
     <div className={containerStyles}>
@@ -99,6 +104,14 @@ export const PipelineActions: React.FunctionComponent<PipelineActionsProps> = ({
               ...PerformanceSignals.get('aggregation-executed-without-index'),
               onPrimaryActionButtonClick:
                 onCollectionScanInsightActionButtonClick,
+              onAssistantButtonClick:
+                tellMoreAboutInsight &&
+                (() => {
+                  tellMoreAboutInsight({
+                    id: 'aggregation-executed-without-index',
+                    stages,
+                  });
+                }),
             }}
           ></SignalPopover>
         </div>
@@ -185,6 +198,7 @@ const mapState = (state: RootState) => {
     isUpdateViewButtonDisabled:
       !state.isModified || hasSyntaxErrors || isAIFetching,
     showCollectionScanInsight: state.insights.isCollectionScan,
+    stages: resultPipeline,
   };
 };
 

packages/compass-aggregations/src/components/pipeline-toolbar/pipeline-header/pipeline-actions.tsx

@@ -9,11 +9,16 @@ import {
 import { atlasServiceLocator } from '@mongodb-js/atlas-service/provider';
 import { DocsProviderTransport } from './docs-provider-transport';
 import { useDrawerActions } from '@mongodb-js/compass-components';
-import { buildConnectionErrorPrompt, buildExplainPlanPrompt } from './prompts';
+import {
+  buildConnectionErrorPrompt,
+  buildExplainPlanPrompt,
+  buildProactiveInsightsPrompt,
+  type EntryPointMessage,
+  type ProactiveInsightsContext,
+} from './prompts';
 import { usePreference } from 'compass-preferences-model/provider';
 import { createLoggerLocator } from '@mongodb-js/compass-logging/provider';
 import type { ConnectionInfo } from '@mongodb-js/connection-info';
-import { redactConnectionString } from 'mongodb-connection-string-url';
 import { useTelemetry } from '@mongodb-js/compass-telemetry/provider';
 
 export const ASSISTANT_DRAWER_ID = 'compass-assistant-drawer';
@@ -47,11 +52,13 @@ type AssistantActionsContextType = {
     error: Error;
   }) => void;
   clearChat: () => void;
+  tellMoreAboutInsight: (context: ProactiveInsightsContext) => void;
 };
 export const AssistantActionsContext =
   createContext<AssistantActionsContextType>({
     interpretExplainPlan: () => {},
     interpretConnectionError: () => {},
+    tellMoreAboutInsight: () => {},
     clearChat: () => {},
   });
 
@@ -89,53 +96,41 @@ export const AssistantProvider: React.FunctionComponent<
     chat: Chat<AssistantMessage>;
   }>
 > = ({ chat, children }) => {
+  const { openDrawer } = useDrawerActions();
   const track = useTelemetry();
-  const assistantActionsContext = useRef<AssistantActionsContextType>({
-    interpretExplainPlan: ({ explainPlan }) => {
+  const createEntryPointHandler = useRef(function <T>(
+    entryPointName:
+      | 'explain plan'
+      | 'performance insights'
+      | 'connection error',
+    builder: (props: T) => EntryPointMessage
+  ) {
+    return (props: T) => {
       openDrawer(ASSISTANT_DRAWER_ID);
-      const { prompt, displayText } = buildExplainPlanPrompt({
-        explainPlan,
-      });
-      void chat.sendMessage(
-        {
-          text: prompt,
-          metadata: {
-            displayText,
-          },
-        },
-        {}
-      );
+      const { prompt, displayText } = builder(props);
+      void chat.sendMessage({ text: prompt, metadata: { displayText } }, {});
       track('Assistant Entry Point Used', {
-        source: 'explain plan',
+        source: entryPointName,
       });
-    },
-    interpretConnectionError: ({ connectionInfo, error }) => {
-      openDrawer(ASSISTANT_DRAWER_ID);
-
-      const connectionString = redactConnectionString(
-        connectionInfo.connectionOptions.connectionString
-      );
-      const connectionError = error.toString();
-
-      const { prompt } = buildConnectionErrorPrompt({
-        connectionString,
-        connectionError,
-      });
-      void chat.sendMessage(
-        {
-          text: prompt,
-        },
-        {}
-      );
-      track('Assistant Entry Point Used', {
-        source: 'connection error',
-      });
-    },
+    };
+  });
+  const assistantActionsContext = useRef<AssistantActionsContextType>({
+    interpretExplainPlan: createEntryPointHandler.current(
+      'explain plan',
+      buildExplainPlanPrompt
+    ),
+    interpretConnectionError: createEntryPointHandler.current(
+      'connection error',
+      buildConnectionErrorPrompt
+    ),
+    tellMoreAboutInsight: createEntryPointHandler.current(
+      'performance insights',
+      buildProactiveInsightsPrompt
+    ),
     clearChat: () => {
       chat.messages = [];
     },
   });
-  const { openDrawer } = useDrawerActions();
 
   return (
     <AssistantContext.Provider value={chat}>
@@ -165,7 +160,7 @@ export const CompassAssistantProvider = registerCompassPlugin(
         transport: new DocsProviderTransport({
           baseUrl: atlasService.assistantApiEndpoint(),
         }),
-        onError: (err: any) => {
+        onError: (err) => {
           logger.log.error(
             logger.mongoLogId(1_001_000_370),
             'Assistant',

packages/compass-assistant/src/compass-assistant-provider.tsx

@@ -5,3 +5,4 @@ export {
   compassAssistantServiceLocator,
 } from './compass-assistant-provider';
 export type { CompassAssistantService } from './compass-assistant-provider';
+export type { ProactiveInsightsContext, EntryPointMessage } from './prompts';