@salesforce/plugin-org 5.1.5 → 5.2.0

package/README.md

@@ -110,6 +110,7 @@ the [SandboxNuts](https://github.com/salesforcecli/plugin-org/actions/workflows/
 - [`sf org list metadata`](#sf-org-list-metadata)
 - [`sf org list metadata-types`](#sf-org-list-metadata-types)
 - [`sf org open`](#sf-org-open)
+- [`sf org open agent`](#sf-org-open-agent)
 - [`sf org refresh sandbox`](#sf-org-refresh-sandbox)
 - [`sf org resume sandbox`](#sf-org-resume-sandbox)
 - [`sf org resume scratch`](#sf-org-resume-scratch)
@@ -241,7 +242,7 @@ FLAG DESCRIPTIONS
     You can specify either --source-sandbox-name or --source-id when cloning an existing sandbox, but not both.
 ```
 
-_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/create/sandbox.ts)_
+_See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/create/sandbox.ts)_
 
 ## `sf org create scratch`
 
@@ -395,7 +396,7 @@ FLAG DESCRIPTIONS
     Omit this flag to have Salesforce generate a unique username for your org.
 ```
 
-_See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/create/scratch.ts)_
+_See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/create/scratch.ts)_
 
 ## `sf org delete sandbox`
 
@@ -441,7 +442,7 @@ EXAMPLES
     $ sf org delete sandbox --target-org my-sandbox --no-prompt
 ```
 
-_See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/delete/sandbox.ts)_
+_See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/delete/sandbox.ts)_
 
 ## `sf org delete scratch`
 
@@ -485,7 +486,7 @@ EXAMPLES
     $ sf org delete scratch --target-org my-scratch-org --no-prompt
 ```
 
-_See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/delete/scratch.ts)_
+_See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/delete/scratch.ts)_
 
 ## `sf org disable tracking`
 
@@ -524,7 +525,7 @@ EXAMPLES
     $ sf org disable tracking
 ```
 
-_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/disable/tracking.ts)_
+_See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/disable/tracking.ts)_
 
 ## `sf org display`
 
@@ -569,7 +570,7 @@ EXAMPLES
     $ sf org display --target-org TestOrg1 --verbose
 ```
 
-_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/display.ts)_
+_See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/display.ts)_
 
 ## `sf org enable tracking`
 
@@ -611,7 +612,7 @@ EXAMPLES
     $ sf org enable tracking
 ```
 
-_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/enable/tracking.ts)_
+_See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/enable/tracking.ts)_
 
 ## `sf org list`
 
@@ -650,7 +651,7 @@ EXAMPLES
     $ sf org list --clean
 ```
 
-_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/list.ts)_
+_See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/list.ts)_
 
 ## `sf org list metadata`
 
@@ -717,7 +718,7 @@ FLAG DESCRIPTIONS
     Examples of metadata types that use folders are Dashboard, Document, EmailTemplate, and Report.
 ```
 
-_See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/list/metadata.ts)_
+_See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/list/metadata.ts)_
 
 ## `sf org list metadata-types`
 
@@ -772,7 +773,7 @@ FLAG DESCRIPTIONS
     Override the api version used for api requests made by this command
 ```
 
-_See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/list/metadata-types.ts)_
+_See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/list/metadata-types.ts)_
 
 ## `sf org open`
 
@@ -848,7 +849,58 @@ EXAMPLES
     $ sf org open --source-file force-app/main/default/bots/Coral_Cloud_Agent/Coral_Cloud_Agent.bot-meta.xml
 ```
 
-_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/open.ts)_
+_See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/open.ts)_
+
+## `sf org open agent`
+
+Open an agent in your org's Agent Builder UI in a browser.
+
+```
+USAGE
+  $ sf org open agent -o <value> -n <value> [--json] [--flags-dir <value>] [--api-version <value>] [--private | -r |
+    -b chrome|edge|firefox]
+
+FLAGS
+  -b, --browser=<option>     Browser where the org opens.
+                             <options: chrome|edge|firefox>
+  -n, --name=<value>         (required) API name, also known as developer name, of the agent you want to open in the
+                             org's Agent Builder UI.
+  -o, --target-org=<value>   (required) Username or alias of the target org. Not required if the `target-org`
+                             configuration variable is already set.
+  -r, --url-only             Display navigation URL, but don’t launch browser.
+      --api-version=<value>  Override the api version used for api requests made by this command
+      --private              Open the org in the default browser using private (incognito) mode.
+
+GLOBAL FLAGS
+  --flags-dir=<value>  Import flag values from a directory.
+  --json               Format output as json.
+
+DESCRIPTION
+  Open an agent in your org's Agent Builder UI in a browser.
+
+  Use the --name flag to open an agent using its API name in the Agent Builder UI of your org. To find the agent's API
+  name, go to Setup in your org and navigate to the agent's details page.
+
+  To generate the URL but not launch it in your browser, specify --url-only.
+
+  To open Agent Builder in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and
+  "firefox". If you don't specify --browser, the org opens in your default browser.
+
+EXAMPLES
+  Open the agent with API name Coral_Cloud_Agent in your default org using your default browser:
+
+    $ sf org open agent --name Coral_Cloud_Agent
+
+  Open the agent in an incognito window of your default browser:
+
+    $ sf org open agent --private --name Coral_Cloud_Agent:
+
+  Open the agent in an org with alias MyTestOrg1 using the Firefox browser:
+
+    $ sf org open agent --target-org MyTestOrg1 --browser firefox --name Coral_Cloud_Agent
+```
+
+_See code: [src/commands/org/open/agent.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/open/agent.ts)_
 
 ## `sf org refresh sandbox`
 
@@ -925,7 +977,7 @@ FLAG DESCRIPTIONS
     By default, a sandbox auto-activates after a refresh. Use this flag to control sandbox activation manually.
 ```
 
-_See code: [src/commands/org/refresh/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/refresh/sandbox.ts)_
+_See code: [src/commands/org/refresh/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/refresh/sandbox.ts)_
 
 ## `sf org resume sandbox`
 
@@ -988,7 +1040,7 @@ FLAG DESCRIPTIONS
     returns the job ID. To resume checking the sandbox creation, rerun this command.
 ```
 
-_See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/resume/sandbox.ts)_
+_See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/resume/sandbox.ts)_
 
 ## `sf org resume scratch`
 
@@ -1035,6 +1087,6 @@ FLAG DESCRIPTIONS
     The job ID is valid for 24 hours after you start the scratch org creation.
 ```
 
-_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.1.5/src/commands/org/resume/scratch.ts)_
+_See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/5.2.0/src/commands/org/resume/scratch.ts)_
 
 <!-- commandsstop -->

package/lib/commands/org/open/agent.d.ts

@@ -0,0 +1,17 @@
+import { OrgOpenCommandBase } from '../../../shared/orgOpenCommandBase.js';
+import { type OrgOpenOutput } from '../../../shared/orgTypes.js';
+export declare class OrgOpenAgent extends OrgOpenCommandBase<OrgOpenOutput> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly state = "beta";
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        private: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        browser: import("@oclif/core/interfaces").OptionFlag<"chrome" | "firefox" | "edge" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'url-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<OrgOpenOutput>;
+}

package/lib/commands/org/open/agent.js

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { buildFrontdoorUrl } from '../../../shared/orgOpenUtils.js';
+import { OrgOpenCommandBase } from '../../../shared/orgOpenCommandBase.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-org', 'open.agent');
+export class OrgOpenAgent extends OrgOpenCommandBase {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static state = 'beta';
+    static flags = {
+        ...OrgOpenCommandBase.flags,
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+        name: Flags.string({
+            char: 'n',
+            summary: messages.getMessage('flags.name.summary'),
+            required: true,
+        }),
+        private: Flags.boolean({
+            summary: messages.getMessage('flags.private.summary'),
+            exclusive: ['url-only', 'browser'],
+        }),
+        browser: Flags.option({
+            char: 'b',
+            summary: messages.getMessage('flags.browser.summary'),
+            options: ['chrome', 'edge', 'firefox'], // These are ones supported by "open" package
+            exclusive: ['url-only', 'private'],
+        })(),
+        'url-only': Flags.boolean({
+            char: 'r',
+            summary: messages.getMessage('flags.url-only.summary'),
+            aliases: ['urlonly'],
+            deprecateAliases: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(OrgOpenAgent);
+        this.org = flags['target-org'];
+        this.connection = this.org.getConnection(flags['api-version']);
+        const [frontDoorUrl, retUrl] = await Promise.all([
+            buildFrontdoorUrl(this.org, this.connection),
+            buildRetUrl(this.connection, flags.name),
+        ]);
+        return this.openOrgUI(flags, frontDoorUrl, retUrl);
+    }
+}
+// Build the URL part to the Agent Builder given a Bot API name.
+const buildRetUrl = async (conn, botName) => {
+    const query = `SELECT id FROM BotDefinition WHERE DeveloperName='${botName}'`;
+    const botId = (await conn.singleRecordQuery(query)).Id;
+    return `AiCopilot/copilotStudio.app#/copilot/builder?copilotId=${botId}`;
+};
+//# sourceMappingURL=agent.js.map

package/lib/commands/org/open/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/commands/org/open/agent.ts"],"names":[],"mappings":"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"}

package/lib/commands/org/open.d.ts

@@ -1,16 +1,16 @@
-import { SfCommand } from '@salesforce/sf-plugins-core';
-import { Org } from '@salesforce/core';
-export declare class OrgOpenCommand extends SfCommand<OrgOpenOutput> {
+import { OrgOpenCommandBase } from '../../shared/orgOpenCommandBase.js';
+import { type OrgOpenOutput } from '../../shared/orgTypes.js';
+export declare class OrgOpenCommand extends OrgOpenCommandBase<OrgOpenOutput> {
     static readonly summary: string;
     static readonly description: string;
     static readonly examples: string[];
     static readonly aliases: string[];
     static deprecateAliases: boolean;
     static readonly flags: {
-        'target-org': import("@oclif/core/interfaces").OptionFlag<Org, import("@oclif/core/interfaces").CustomOptions>;
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
         'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         private: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        browser: import("@oclif/core/interfaces").OptionFlag<"chrome" | "edge" | "firefox" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        browser: import("@oclif/core/interfaces").OptionFlag<"chrome" | "firefox" | "edge" | undefined, import("@oclif/core/interfaces").CustomOptions>;
         path: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'url-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         loglevel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -18,8 +18,3 @@ export declare class OrgOpenCommand extends SfCommand<OrgOpenOutput> {
     };
     run(): Promise<OrgOpenOutput>;
 }
-export type OrgOpenOutput = {
-    url: string;
-    username: string;
-    orgId: string;
-};

package/lib/commands/org/open.js

@@ -5,25 +5,21 @@
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
 import path from 'node:path';
-import { platform, tmpdir } from 'node:os';
-import fs from 'node:fs';
-import { execSync } from 'node:child_process';
-import { Flags, loglevel, orgApiVersionFlagWithDeprecations, requiredOrgFlagWithDeprecations, SfCommand, } from '@salesforce/sf-plugins-core';
-import isWsl from 'is-wsl';
-import { Logger, Messages, Org, SfdcUrl, SfError } from '@salesforce/core';
-import { Duration, Env, sleep } from '@salesforce/kit';
+import { Flags, loglevel, orgApiVersionFlagWithDeprecations, requiredOrgFlagWithDeprecations, } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
 import { MetadataResolver } from '@salesforce/source-deploy-retrieve';
-import { apps } from 'open';
-import utils from '../../shared/utils.js';
+import { buildFrontdoorUrl } from '../../shared/orgOpenUtils.js';
+import { OrgOpenCommandBase } from '../../shared/orgOpenCommandBase.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-org', 'open');
-export class OrgOpenCommand extends SfCommand {
+export class OrgOpenCommand extends OrgOpenCommandBase {
     static summary = messages.getMessage('summary');
     static description = messages.getMessage('description');
     static examples = messages.getMessages('examples');
     static aliases = ['force:org:open', 'force:source:open'];
     static deprecateAliases = true;
     static flags = {
+        ...OrgOpenCommandBase.flags,
         'target-org': requiredOrgFlagWithDeprecations,
         'api-version': orgApiVersionFlagWithDeprecations,
         private: Flags.boolean({
@@ -60,80 +56,15 @@ export class OrgOpenCommand extends SfCommand {
     };
     async run() {
         const { flags } = await this.parse(OrgOpenCommand);
-        const conn = flags['target-org'].getConnection(flags['api-version']);
-        const env = new Env();
+        this.org = flags['target-org'];
+        this.connection = this.org.getConnection(flags['api-version']);
         const [frontDoorUrl, retUrl] = await Promise.all([
-            buildFrontdoorUrl(flags['target-org'], conn),
-            flags['source-file'] ? generateFileUrl(flags['source-file'], conn) : flags.path,
+            buildFrontdoorUrl(this.org, this.connection),
+            flags['source-file'] ? generateFileUrl(flags['source-file'], this.connection) : flags.path,
         ]);
-        const url = `${frontDoorUrl}${retUrl ? `&retURL=${retUrl}` : ''}`;
-        const orgId = flags['target-org'].getOrgId();
-        // TODO: better typings in sfdx-core for orgs read from auth files
-        const username = flags['target-org'].getUsername();
-        const output = { orgId, url, username };
-        // NOTE: Deliberate use of `||` here since getBoolean() defaults to false, and we need to consider both env vars.
-        const containerMode = env.getBoolean('SF_CONTAINER_MODE') || env.getBoolean('SFDX_CONTAINER_MODE');
-        // security warning only for --json OR --url-only OR containerMode
-        if (flags['url-only'] || Boolean(flags.json) || containerMode) {
-            const sharedMessages = Messages.loadMessages('@salesforce/plugin-org', 'messages');
-            this.warn(sharedMessages.getMessage('SecurityWarning'));
-            this.log('');
-        }
-        if (containerMode) {
-            // instruct the user that they need to paste the URL into the browser
-            this.styledHeader('Action Required!');
-            this.log(messages.getMessage('containerAction', [orgId, url]));
-            return output;
-        }
-        if (flags['url-only']) {
-            // this includes the URL
-            this.logSuccess(messages.getMessage('humanSuccess', [orgId, username, url]));
-            return output;
-        }
-        this.logSuccess(messages.getMessage('humanSuccessNoUrl', [orgId, username]));
-        // we actually need to open the org
-        try {
-            this.spinner.start(messages.getMessage('domainWaiting'));
-            await new SfdcUrl(url).checkLightningDomain();
-            this.spinner.stop();
-        }
-        catch (err) {
-            handleDomainError(err, url, env);
-        }
-        // create a local html file that contains the POST stuff.
-        const tempFilePath = path.join(tmpdir(), `org-open-${new Date().valueOf()}.html`);
-        await fs.promises.writeFile(tempFilePath, getFileContents(conn.accessToken, conn.instanceUrl, 
-        // the path flag is URI-encoded in its `parse` func.
-        // For the form redirect to work we need it decoded.
-        flags.path ? decodeURIComponent(flags.path) : retUrl));
-        const filePathUrl = isWsl
-            ? 'file:///' + execSync(`wslpath -m ${tempFilePath}`).toString().trim()
-            : `file:///${tempFilePath}`;
-        const cp = await utils.openUrl(filePathUrl, {
-            ...(flags.browser ? { app: { name: apps[flags.browser] } } : {}),
-            ...(flags.private ? { newInstance: platform() === 'darwin', app: { name: apps.browserPrivate } } : {}),
-        });
-        cp.on('error', (err) => {
-            fileCleanup(tempFilePath);
-            throw SfError.wrap(err);
-        });
-        // so we don't delete the file while the browser is still using it
-        // open returns when the CP is spawned, but there's not way to know if the browser is still using the file
-        await sleep(platform() === 'win32' || isWsl ? 7000 : 5000);
-        fileCleanup(tempFilePath);
-        return output;
+        return this.openOrgUI(flags, frontDoorUrl, retUrl);
     }
 }
-const fileCleanup = (tempFilePath) => fs.rmSync(tempFilePath, { force: true, maxRetries: 3, recursive: true });
-const buildFrontdoorUrl = async (org, conn) => {
-    await org.refreshAuth(); // we need a live accessToken for the frontdoor url
-    const accessToken = conn.accessToken;
-    if (!accessToken) {
-        throw new SfError('NoAccessToken', 'NoAccessToken');
-    }
-    const instanceUrlClean = org.getField(Org.Fields.INSTANCE_URL).replace(/\/$/, '');
-    return `${instanceUrlClean}/secur/frontdoor.jsp?sid=${accessToken}`;
-};
 const generateFileUrl = async (file, conn) => {
     try {
         const metadataResolver = new MetadataResolver();
@@ -172,34 +103,4 @@ const flowFileNameToId = async (conn, filePath) => {
         throw messages.createError('FlowIdNotFound', [filePath]);
     }
 };
-/** builds the html file that does an automatic post to the frontdoor url */
-const getFileContents = (authToken, instanceUrl, 
-// we have to defalt this to get to Setup only on the POST version.  GET goes to Setup automatically
-retUrl = '/lightning/setup/SetupOneHome/home') => `
-<html>
-  <body onload="document.body.firstElementChild.submit()">
-    <form method="POST" action="${instanceUrl}/secur/frontdoor.jsp">
-      <input type="hidden" name="sid" value="${authToken}" />
-      <input type="hidden" name="retURL" value="${retUrl}" />
-    </form>
-  </body>
-</html>`;
-const handleDomainError = (err, url, env) => {
-    if (err instanceof Error) {
-        if (err.message.includes('timeout')) {
-            const host = /https?:\/\/([^.]*)/.exec(url)?.[1];
-            if (!host) {
-                throw new SfError('InvalidUrl', 'InvalidUrl');
-            }
-            const domain = `https://${host}.lightning.force.com`;
-            const domainRetryTimeout = env.getNumber('SF_DOMAIN_RETRY') ?? env.getNumber('SFDX_DOMAIN_RETRY', 240);
-            const timeout = new Duration(domainRetryTimeout, Duration.Unit.SECONDS);
-            const logger = Logger.childFromRoot('org:open');
-            logger.debug(`Did not find IP for ${domain} after ${timeout.seconds} seconds`);
-            throw new SfError(messages.getMessage('domainTimeoutError'), 'domainTimeoutError');
-        }
-        throw SfError.wrap(err);
-    }
-    throw err;
-};
 //# sourceMappingURL=open.js.map

package/lib/commands/org/open.js.map

@@ -1 +1 @@
-{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/commands/org/open.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/commands/org/open.ts"],"names":[],"mappings":"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"}

package/lib/shared/orgOpenCommandBase.d.ts

@@ -0,0 +1,16 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Connection, Org } from '@salesforce/core';
+import { type OrgOpenOutput } from './orgTypes.js';
+type OrgOpenFlags = {
+    'url-only': boolean;
+    browser?: 'chrome' | 'firefox' | 'edge';
+    path?: string;
+    private: boolean;
+};
+export declare abstract class OrgOpenCommandBase<T> extends SfCommand<T> {
+    static enableJsonFlag: boolean;
+    protected org: Org;
+    protected connection: Connection;
+    protected openOrgUI(flags: OrgOpenFlags, frontDoorUrl: string, retUrl?: string): Promise<OrgOpenOutput>;
+}
+export {};

package/lib/shared/orgOpenCommandBase.js

@@ -0,0 +1,83 @@
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import { platform, tmpdir } from 'node:os';
+import { execSync } from 'node:child_process';
+import isWsl from 'is-wsl';
+import { apps } from 'open';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages, SfdcUrl, SfError } from '@salesforce/core';
+import { env, sleep } from '@salesforce/kit';
+import utils, { fileCleanup, getFileContents, handleDomainError } from './orgOpenUtils.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-org', 'open');
+export class OrgOpenCommandBase extends SfCommand {
+    static enableJsonFlag = true;
+    // Set by concrete classes in `run()`
+    org;
+    connection;
+    async openOrgUI(flags, frontDoorUrl, retUrl) {
+        const orgId = this.org.getOrgId();
+        const url = `${frontDoorUrl}${retUrl ? `&retURL=${retUrl}` : ''}`;
+        // TODO: better typings in sfdx-core for orgs read from auth files
+        const username = this.org.getUsername();
+        const output = { orgId, url, username };
+        // NOTE: Deliberate use of `||` here since getBoolean() defaults to false, and we need to consider both env vars.
+        const containerMode = env.getBoolean('SF_CONTAINER_MODE') || env.getBoolean('SFDX_CONTAINER_MODE');
+        // security warning only for --json OR --url-only OR containerMode
+        if (flags['url-only'] || this.jsonEnabled() || containerMode) {
+            const sharedMessages = Messages.loadMessages('@salesforce/plugin-org', 'messages');
+            this.warn(sharedMessages.getMessage('SecurityWarning'));
+            this.log('');
+        }
+        if (containerMode) {
+            // instruct the user that they need to paste the URL into the browser
+            this.styledHeader('Action Required!');
+            this.log(messages.getMessage('containerAction', [orgId, url]));
+            return output;
+        }
+        if (flags['url-only']) {
+            // this includes the URL
+            this.logSuccess(messages.getMessage('humanSuccess', [orgId, username, url]));
+            return output;
+        }
+        this.logSuccess(messages.getMessage('humanSuccessNoUrl', [orgId, username]));
+        // we actually need to open the org
+        try {
+            this.spinner.start(messages.getMessage('domainWaiting'));
+            await new SfdcUrl(url).checkLightningDomain();
+            this.spinner.stop();
+        }
+        catch (err) {
+            handleDomainError(err, url, env);
+        }
+        // create a local html file that contains the POST stuff.
+        const tempFilePath = path.join(tmpdir(), `org-open-${new Date().valueOf()}.html`);
+        await fs.promises.writeFile(tempFilePath, getFileContents(this.connection.accessToken, this.connection.instanceUrl, 
+        // the path flag is URI-encoded in its `parse` func.
+        // For the form redirect to work we need it decoded.
+        flags.path ? decodeURIComponent(flags.path) : retUrl));
+        const filePathUrl = isWsl
+            ? 'file:///' + execSync(`wslpath -m ${tempFilePath}`).toString().trim()
+            : `file:///${tempFilePath}`;
+        const cp = await utils.openUrl(filePathUrl, {
+            ...(flags.browser ? { app: { name: apps[flags.browser] } } : {}),
+            ...(flags.private ? { newInstance: platform() === 'darwin', app: { name: apps.browserPrivate } } : {}),
+        });
+        cp.on('error', (err) => {
+            fileCleanup(tempFilePath);
+            throw SfError.wrap(err);
+        });
+        // so we don't delete the file while the browser is still using it
+        // open returns when the CP is spawned, but there's not way to know if the browser is still using the file
+        await sleep(platform() === 'win32' || isWsl ? 7000 : 5000);
+        fileCleanup(tempFilePath);
+        return output;
+    }
+}
+//# sourceMappingURL=orgOpenCommandBase.js.map

package/lib/shared/orgOpenCommandBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orgOpenCommandBase.js","sourceRoot":"","sources":["../../src/shared/orgOpenCommandBase.ts"],"names":[],"mappings":"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"}

package/lib/shared/orgOpenUtils.d.ts

@@ -0,0 +1,18 @@
+import { ChildProcess } from 'node:child_process';
+import { Options } from 'open';
+import { Connection, Org } from '@salesforce/core';
+import { Env } from '@salesforce/kit';
+export declare const openUrl: (url: string, options: Options) => Promise<ChildProcess>;
+export declare const fileCleanup: (tempFilePath: string) => void;
+export declare const buildFrontdoorUrl: (org: Org, conn: Connection) => Promise<string>;
+export declare const handleDomainError: (err: unknown, url: string, env: Env) => string;
+/** builds the html file that does an automatic post to the frontdoor url */
+export declare const getFileContents: (authToken: string, instanceUrl: string, retUrl?: string) => string;
+declare const _default: {
+    openUrl: (url: string, options: Options) => Promise<ChildProcess>;
+    fileCleanup: (tempFilePath: string) => void;
+    buildFrontdoorUrl: (org: Org, conn: Connection) => Promise<string>;
+    handleDomainError: (err: unknown, url: string, env: Env) => string;
+    getFileContents: (authToken: string, instanceUrl: string, retUrl?: string) => string;
+};
+export default _default;

package/lib/shared/orgOpenUtils.js

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import { rmSync } from 'node:fs';
+import open from 'open';
+import { Logger, Messages, Org, SfError } from '@salesforce/core';
+import { Duration } from '@salesforce/kit';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-org', 'open');
+export const openUrl = async (url, options) => open(url, options);
+export const fileCleanup = (tempFilePath) => rmSync(tempFilePath, { force: true, maxRetries: 3, recursive: true });
+export const buildFrontdoorUrl = async (org, conn) => {
+    await org.refreshAuth(); // we need a live accessToken for the frontdoor url
+    const accessToken = conn.accessToken;
+    if (!accessToken) {
+        throw new SfError('NoAccessToken', 'NoAccessToken');
+    }
+    const instanceUrlClean = org.getField(Org.Fields.INSTANCE_URL).replace(/\/$/, '');
+    return `${instanceUrlClean}/secur/frontdoor.jsp?sid=${accessToken}`;
+};
+export const handleDomainError = (err, url, env) => {
+    if (err instanceof Error) {
+        if (err.message.includes('timeout')) {
+            const host = /https?:\/\/([^.]*)/.exec(url)?.[1];
+            if (!host) {
+                throw new SfError('InvalidUrl', 'InvalidUrl');
+            }
+            const domain = `https://${host}.lightning.force.com`;
+            const domainRetryTimeout = env.getNumber('SF_DOMAIN_RETRY') ?? env.getNumber('SFDX_DOMAIN_RETRY', 240);
+            const timeout = new Duration(domainRetryTimeout, Duration.Unit.SECONDS);
+            const logger = Logger.childFromRoot('org:open');
+            logger.debug(`Did not find IP for ${domain} after ${timeout.seconds} seconds`);
+            throw new SfError(messages.getMessage('domainTimeoutError'), 'domainTimeoutError');
+        }
+        throw SfError.wrap(err);
+    }
+    throw err;
+};
+/** builds the html file that does an automatic post to the frontdoor url */
+export const getFileContents = (authToken, instanceUrl, 
+// we have to defalt this to get to Setup only on the POST version.  GET goes to Setup automatically
+retUrl = '/lightning/setup/SetupOneHome/home') => `
+<html>
+  <body onload="document.body.firstElementChild.submit()">
+    <form method="POST" action="${instanceUrl}/secur/frontdoor.jsp">
+      <input type="hidden" name="sid" value="${authToken}" />
+      <input type="hidden" name="retURL" value="${retUrl}" />
+    </form>
+  </body>
+</html>`;
+export default {
+    openUrl,
+    fileCleanup,
+    buildFrontdoorUrl,
+    handleDomainError,
+    getFileContents,
+};
+//# sourceMappingURL=orgOpenUtils.js.map

package/lib/shared/orgOpenUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orgOpenUtils.js","sourceRoot":"","sources":["../../src/shared/orgOpenUtils.ts"],"names":[],"mappings":"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"}

package/lib/shared/orgTypes.d.ts

@@ -11,6 +11,11 @@ export type OrgDisplayReturn = Partial<ScratchOrgFields> & {
     connectedStatus?: string;
     sfdxAuthUrl?: string;
 };
+export type OrgOpenOutput = {
+    url: string;
+    username: string;
+    orgId: string;
+};
 /** Convenience type for the fields that are in the auth file
  *
  * core's AuthFields has everything as optional.

package/lib/shared/orgTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"orgTypes.js","sourceRoot":"","sources":["../../src/shared/orgTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8FH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,6CAAuB,CAAA;IACvB,oDAA8B,CAAA;IAC9B,yCAAmB,CAAA;IACnB,mCAAa,CAAA;AACf,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}
+{"version":3,"file":"orgTypes.js","sourceRoot":"","sources":["../../src/shared/orgTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoGH,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,6CAAuB,CAAA;IACvB,oDAA8B,CAAA;IAC9B,yCAAmB,CAAA;IACnB,mCAAa,CAAA;AACf,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B"}

package/lib/shared/utils.d.ts

@@ -1,11 +1,7 @@
-import { ChildProcess } from 'node:child_process';
-import { Options } from 'open';
 export declare const getAliasByUsername: (username: string) => Promise<string | undefined>;
-export declare const openUrl: (url: string, options: Options) => Promise<ChildProcess>;
 export declare const lowerToUpper: (object: Record<string, unknown>) => Record<string, unknown>;
 declare const _default: {
     getAliasByUsername: (username: string) => Promise<string | undefined>;
-    openUrl: (url: string, options: Options) => Promise<ChildProcess>;
     lowerToUpper: (object: Record<string, unknown>) => Record<string, unknown>;
 };
 export default _default;

package/lib/shared/utils.js

@@ -1,20 +1,23 @@
+/*
+ * Copyright (c) 2020, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
 import { upperFirst } from '@salesforce/kit';
 import { StateAggregator } from '@salesforce/core';
-import open from 'open';
 export const getAliasByUsername = async (username) => {
     const stateAggregator = await StateAggregator.getInstance();
     const keys = stateAggregator.aliases.getAll(username);
     // use the most recently added alias for that username
     return keys?.length ? keys[keys.length - 1] : undefined;
 };
-export const openUrl = async (url, options) => open(url, options);
 export const lowerToUpper = (object) => 
 // the API has keys defined in capital camel case, while the definition schema has them as lower camel case
 // we need to convert lower camel case to upper before merging options so they will override properly
 Object.fromEntries(Object.entries(object).map(([key, value]) => [upperFirst(key), value]));
 export default {
     getAliasByUsername,
-    openUrl,
     lowerToUpper,
 };
 export const isDefined = (value) => value !== undefined && value !== null;

package/lib/shared/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,IAAiB,MAAM,MAAM,CAAC;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,QAAgB,EAA+B,EAAE;IACxF,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtD,sDAAsD;IACtD,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,GAAW,EAAE,OAAgB,EAAyB,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAE1G,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAA+B,EAA2B,EAAE;AACvF,2GAA2G;AAC3G,qGAAqG;AACrG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAE7F,eAAe;IACb,kBAAkB;IAClB,OAAO;IACP,YAAY;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,KAA2B,EAAc,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,QAAgB,EAA+B,EAAE;IACxF,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtD,sDAAsD;IACtD,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAA+B,EAA2B,EAAE;AACvF,2GAA2G;AAC3G,qGAAqG;AACrG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAE7F,eAAe;IACb,kBAAkB;IAClB,YAAY;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,KAA2B,EAAc,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC"}

package/messages/open.agent.md

@@ -0,0 +1,41 @@
+# summary
+
+Open an agent in your org's Agent Builder UI in a browser.
+
+# description
+
+Use the --name flag to open an agent using its API name in the Agent Builder UI of your org. To find the agent's API name, go to Setup in your org and navigate to the agent's details page.
+
+To generate the URL but not launch it in your browser, specify --url-only.
+
+To open Agent Builder in a specific browser, use the --browser flag. Supported browsers are "chrome", "edge", and "firefox". If you don't specify --browser, the org opens in your default browser.
+
+# examples
+
+- Open the agent with API name Coral_Cloud_Agent in your default org using your default browser:
+
+  $ <%= config.bin %> <%= command.id %> --name Coral_Cloud_Agent
+
+- Open the agent in an incognito window of your default browser:
+
+  $ <%= config.bin %> <%= command.id %> --private --name Coral_Cloud_Agent:
+
+- Open the agent in an org with alias MyTestOrg1 using the Firefox browser:
+
+  $ <%= config.bin %> <%= command.id %> --target-org MyTestOrg1 --browser firefox --name Coral_Cloud_Agent
+
+# flags.name.summary
+
+API name, also known as developer name, of the agent you want to open in the org's Agent Builder UI.
+
+# flags.private.summary
+
+Open the org in the default browser using private (incognito) mode.
+
+# flags.browser.summary
+
+Browser where the org opens.
+
+# flags.url-only.summary
+
+Display navigation URL, but don’t launch browser.

package/oclif.manifest.json

@@ -1378,6 +1378,124 @@
         "metadata:list:org"
       ]
     },
+    "org:open:agent": {
+      "aliases": [],
+      "args": {},
+      "description": "Use the --name flag to open an agent using its API name in the Agent Builder UI of your org. To find the agent's API name, go to Setup in your org and navigate to the agent's details page.\n\nTo generate the URL but not launch it in your browser, specify --url-only.\n\nTo open Agent Builder in a specific browser, use the --browser flag. Supported browsers are \"chrome\", \"edge\", and \"firefox\". If you don't specify --browser, the org opens in your default browser.",
+      "examples": [
+        "Open the agent with API name Coral_Cloud_Agent in your default org using your default browser:\n$ <%= config.bin %> <%= command.id %> --name Coral_Cloud_Agent",
+        "Open the agent in an incognito window of your default browser:\n$ <%= config.bin %> <%= command.id %> --private --name Coral_Cloud_Agent:",
+        "Open the agent in an org with alias MyTestOrg1 using the Firefox browser:\n$ <%= config.bin %> <%= command.id %> --target-org MyTestOrg1 --browser firefox --name Coral_Cloud_Agent"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "name": "name",
+          "required": true,
+          "summary": "API name, also known as developer name, of the agent you want to open in the org's Agent Builder UI.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "private": {
+          "exclusive": [
+            "url-only",
+            "browser"
+          ],
+          "name": "private",
+          "summary": "Open the org in the default browser using private (incognito) mode.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "browser": {
+          "char": "b",
+          "exclusive": [
+            "url-only",
+            "private"
+          ],
+          "name": "browser",
+          "summary": "Browser where the org opens.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "chrome",
+            "edge",
+            "firefox"
+          ],
+          "type": "option"
+        },
+        "url-only": {
+          "aliases": [
+            "urlonly"
+          ],
+          "char": "r",
+          "deprecateAliases": true,
+          "name": "url-only",
+          "summary": "Display navigation URL, but don’t launch browser.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "org:open:agent",
+      "pluginAlias": "@salesforce/plugin-org",
+      "pluginName": "@salesforce/plugin-org",
+      "pluginType": "core",
+      "state": "beta",
+      "strict": true,
+      "summary": "Open an agent in your org's Agent Builder UI in a browser.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "org",
+        "open",
+        "agent.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "org:open:agent",
+        "open:org:agent",
+        "open:agent:org",
+        "org:agent:open",
+        "agent:org:open",
+        "agent:open:org"
+      ]
+    },
     "org:refresh:sandbox": {
       "aliases": [],
       "args": {},
@@ -1698,5 +1816,5 @@
       ]
     }
   },
-  "version": "5.1.5"
+  "version": "5.2.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@salesforce/plugin-org",
     "description": "Commands to interact with Salesforce orgs",
-    "version": "5.1.5",
+    "version": "5.2.0",
     "author": "Salesforce",
     "bugs": "https://github.com/forcedotcom/cli/issues",
     "dependencies": {
@@ -24,7 +24,7 @@
         "@salesforce/dev-scripts": "^10.2.10",
         "@salesforce/plugin-command-reference": "^3.1.31",
         "@salesforce/ts-sinon": "^1.4.29",
-        "eslint-plugin-sf-plugin": "^1.20.8",
+        "eslint-plugin-sf-plugin": "^1.20.12",
         "moment": "^2.30.1",
         "oclif": "^4.15.22",
         "ts-node": "^10.9.2",
@@ -227,7 +227,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/5.1.5.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/5.1.5.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/5.2.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/5.2.0.sig"
     }
 }