fix: support retrieving agent pseudo type

Author: shetzel

src/commands/project/retrieve/start.ts

@@ -423,7 +423,11 @@ const buildRetrieveAndDeleteTargets = async (
     }
     return result;
   } else {
-    const retrieveFromOrg = flags.metadata?.some(isRegexMatch) ? flags['target-org'].getUsername() : undefined;
+    const hasPseudoType = flags.metadata?.some(isPseudoType);
+    const hasRegexMatch = flags.metadata?.some(isRegexMatch);
+    // Deliberately using logical or
+    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+    const retrieveFromOrg = hasRegexMatch || hasPseudoType ? flags['target-org'].getUsername() : undefined;
     if (format === 'source' && (await flags['target-org'].supportsSourceTracking())) {
       await SourceTracking.create({
         org: flags['target-org'],
@@ -503,3 +507,5 @@ const isRegexMatch = (mdEntry: string): boolean => {
   const mdName = mdEntry.split(':')[1];
   return mdName?.includes('*') && mdName?.length > 1 && !mdName?.includes('.*');
 };
+
+const isPseudoType = (mdEntry: string): boolean => mdEntry.split(':')[0] === 'Agent';

test/commands/retrieve/start.test.ts

@@ -193,6 +193,40 @@ describe('project retrieve start', () => {
     ensureRetrieveArgs({ format: 'source' });
   });
 
+  it('should pass along metadata and org for pseudo-type matching', async () => {
+    const metadata = ['Agent:My_Agent'];
+    const result = await RetrieveMetadata.run(['--metadata', metadata[0], '--json']);
+    expect(result).to.deep.equal(expectedResults);
+    ensureCreateComponentSetArgs({
+      metadata: {
+        metadataEntries: metadata,
+        directoryPaths: [expectedDirectoryPath],
+      },
+      org: {
+        username: testOrg.username,
+        exclude: [],
+      },
+    });
+    ensureRetrieveArgs({ format: 'source' });
+  });
+
+  it('should pass along metadata and org for pseudo-type wildcard matching', async () => {
+    const metadata = ['ApexClass', 'Agent'];
+    const result = await RetrieveMetadata.run(['--metadata', metadata[0], '--metadata', metadata[1], '--json']);
+    expect(result).to.deep.equal(expectedResults);
+    ensureCreateComponentSetArgs({
+      metadata: {
+        metadataEntries: metadata,
+        directoryPaths: [expectedDirectoryPath],
+      },
+      org: {
+        username: testOrg.username,
+        exclude: [],
+      },
+    });
+    ensureRetrieveArgs({ format: 'source' });
+  });
+
   it('should pass along manifest', async () => {
     const manifest = 'package.xml';
     const result = await RetrieveMetadata.run(['--manifest', manifest, '--json']);