@salesforce/mcp 0.17.1 → 0.17.2-dev.1

package/lib/modules/platform-cli/sf-create-scratch-org.js

@@ -1,132 +0,0 @@
-/*
- * Copyright 2025, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { join } from 'node:path';
-import * as fs from 'node:fs';
-import { z } from 'zod';
-import { Org, scratchOrgCreate } from '@salesforce/core';
-import { Duration } from '@salesforce/kit';
-import { textResponse } from '../../shared/utils.js';
-import { directoryParam, usernameOrAliasParam } from '../../shared/params.js';
-/*
- * Create a new scratch org
- *
- * Parameters:
- * - directory: directory to change to before running the command
- * - usernameOrAlias: Username or alias of the Salesforce DevHub org to use to create from
- * - duration: Duration in days of the scratch org to exist, default 7
- * - edition: Edition of the scratch org
- * - definitionFile: path to the scratch org definition file, default config/project-scratch-def.json
- * - alias: Alias to use for the scratch org
- * - async: Wait for the scratch org creation process to finish, default false
- * - setDefault: set the newly created org as default-target-org
- * - snapshot: The snapshot name to use when creating a scratch org
- * - sourceOrg: 15-character ID of the org shape that the new scratch org is based on
- * - username: Username of the scratch org admin user
- * - description: a description given to the scratch org
- * - orgName: Name of the scratch org
- * - adminEmail: Email address that will be applied to the org's admin user.
- * Returns:
- * - textResponse:
- */
-export const createScratchOrgParams = z.object({
-    directory: directoryParam,
-    devHub: usernameOrAliasParam.describe('The default devhub username, use the #sf-get-username tool to get the default devhub if unsure'),
-    duration: z.number().default(7).describe('number of days before the org expires'),
-    edition: z
-        .enum([
-        'developer',
-        'enterprise',
-        'group',
-        'professional',
-        'partner-developer',
-        'partner-enterprise',
-        'partner-group',
-        'partner-professional',
-    ])
-        .optional(),
-    definitionFile: z
-        .string()
-        .default(join('config', 'project-scratch-def.json'))
-        .describe('a normalized path to a scratch definition json file'),
-    alias: z.string().describe('the alias to be used for the scratch org').optional(),
-    async: z
-        .boolean()
-        .default(false)
-        .describe('Whether to wait for the org creation process to finish (false) or just quickly return the ID (true)'),
-    setDefault: z
-        .boolean()
-        .optional()
-        .describe('If true, will set the newly created scratch org to be the default-target-org'),
-    snapshot: z.string().describe('The snapshot name to use when creating a scratch org').optional(),
-    sourceOrg: z
-        .string()
-        .length(15)
-        .describe('15-character ID of the org shape that the new scratch org is based on')
-        .optional(),
-    username: z.string().describe('Username of the scratch org admin user').optional(),
-    description: z.string().describe('a description given to the scratch org').optional(),
-    orgName: z.string().describe('Name of the scratch org').optional(),
-    adminEmail: z.string().describe("Email address that will be applied to the org's admin user.").optional(),
-});
-export const createScratchOrg = (server) => {
-    server.tool('sf-create-scratch-org', `Creates a scratch org with the specified parameters.
-
-AGENT INSTRUCTIONS:
-
-Example usage:
-Create a scratch org
-create a scratch org with the definition file myDefinition.json that lasts 3 days
-create a scratch org aliased as MyNewOrg and set as default and don't wait for it to finish
-`, createScratchOrgParams.shape, {
-        title: 'Create a scratch org',
-    }, async ({ directory, devHub, orgName, adminEmail, description, snapshot, sourceOrg, username, edition, setDefault, async, duration, alias, definitionFile, }) => {
-        try {
-            process.chdir(directory);
-            const hubOrProd = await Org.create({ aliasOrUsername: devHub });
-            const requestParams = {
-                hubOrg: hubOrProd,
-                durationDays: duration,
-                wait: async ? Duration.minutes(0) : Duration.minutes(10),
-                orgConfig: {
-                    ...(definitionFile
-                        ? JSON.parse(await fs.promises.readFile(definitionFile, 'utf-8'))
-                        : {}),
-                    ...(edition ? { edition } : {}),
-                    ...(snapshot ? { snapshot } : {}),
-                    ...(username ? { username } : {}),
-                    ...(description ? { description } : {}),
-                    ...(orgName ? { orgName } : {}),
-                    ...(sourceOrg ? { sourceOrg } : {}),
-                    ...(adminEmail ? { adminEmail } : {}),
-                },
-                alias,
-                setDefault,
-                tracksSource: true,
-            };
-            const result = await scratchOrgCreate(requestParams);
-            if (async) {
-                return textResponse(`Successfully enqueued scratch org with job Id: ${JSON.stringify(result.scratchOrgInfo?.Id)} use the #sf-resume tool to resume this operation`);
-            }
-            else {
-                return textResponse(`Successfully created scratch org  ${JSON.stringify(result)}`);
-            }
-        }
-        catch (e) {
-            return textResponse(`Failed to create org: ${e instanceof Error ? e.message : 'Unknown error'}`, true);
-        }
-    });
-};
-//# sourceMappingURL=sf-create-scratch-org.js.map

package/lib/modules/platform-cli/sf-delete-org.d.ts

@@ -1,14 +0,0 @@
-import { z } from 'zod';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare const deleteOrgParams: z.ZodObject<{
-    directory: z.ZodEffects<z.ZodString, string, string>;
-    usernameOrAlias: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    usernameOrAlias: string;
-    directory: string;
-}, {
-    usernameOrAlias: string;
-    directory: string;
-}>;
-export type DeleteOrgOptions = z.infer<typeof deleteOrgParams>;
-export declare const deleteOrg: (server: McpServer) => void;

package/lib/modules/platform-cli/sf-delete-org.js

@@ -1,65 +0,0 @@
-/*
- * Copyright 2025, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { z } from 'zod';
-import { AuthRemover, Org } from '@salesforce/core';
-import { textResponse } from '../../shared/utils.js';
-import { directoryParam, usernameOrAliasParam } from '../../shared/params.js';
-/*
- * Delete a locally authorized Salesforce org
- *
- * Parameters:
- * - directory: directory to change to before running the command
- * - usernameOrAlias: Username or alias of the Salesforce org to delete.
- *
- * Returns:
- * - textResponse: Deletion request response
- */
-export const deleteOrgParams = z.object({
-    directory: directoryParam,
-    usernameOrAlias: usernameOrAliasParam,
-});
-export const deleteOrg = (server) => {
-    server.tool('sf-delete-org', `Deletes specified salesforce org.
-
-AGENT INSTRUCTIONS:
-ALWAYS confirm with the user before deleting an org
-
-Example usage:
-Can you delete my org
-Can you delete MyAliasedOrg
-Can you delete test-fe2n4tc8pgku@example.com
-`, deleteOrgParams.shape, {
-        title: 'Delete an Org',
-    }, async ({ directory, usernameOrAlias }) => {
-        try {
-            process.chdir(directory);
-            const org = await Org.create({ aliasOrUsername: usernameOrAlias });
-            await org.delete();
-            return textResponse(`Successfully deleted ${usernameOrAlias}`);
-        }
-        catch (e) {
-            if (e instanceof Error && e.name === 'DomainNotFoundError') {
-                // the org has expired, so remote operations won't work
-                // let's clean up the files locally
-                const authRemover = await AuthRemover.create();
-                await authRemover.removeAuth(usernameOrAlias);
-                return textResponse(`Successfully deleted ${usernameOrAlias}`);
-            }
-            return textResponse(`Failed to delete org: ${e instanceof Error ? e.message : 'Unknown error'}`, true);
-        }
-    });
-};
-//# sourceMappingURL=sf-delete-org.js.map

package/lib/modules/platform-cli/sf-deploy-metadata.d.ts

@@ -1,27 +0,0 @@
-import { z } from 'zod';
-import { SfMcpServer } from '../../sf-mcp-server.js';
-declare const deployMetadataParams: z.ZodObject<{
-    sourceDir: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    manifest: z.ZodOptional<z.ZodString>;
-    apexTestLevel: z.ZodOptional<z.ZodEnum<["NoTestRun", "RunLocalTests", "RunAllTestsInOrg"]>>;
-    apexTests: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    usernameOrAlias: z.ZodString;
-    directory: z.ZodEffects<z.ZodString, string, string>;
-}, "strip", z.ZodTypeAny, {
-    usernameOrAlias: string;
-    directory: string;
-    sourceDir?: string[] | undefined;
-    manifest?: string | undefined;
-    apexTestLevel?: "NoTestRun" | "RunLocalTests" | "RunAllTestsInOrg" | undefined;
-    apexTests?: string[] | undefined;
-}, {
-    usernameOrAlias: string;
-    directory: string;
-    sourceDir?: string[] | undefined;
-    manifest?: string | undefined;
-    apexTestLevel?: "NoTestRun" | "RunLocalTests" | "RunAllTestsInOrg" | undefined;
-    apexTests?: string[] | undefined;
-}>;
-export type DeployMetadata = z.infer<typeof deployMetadataParams>;
-export declare const deployMetadata: (server: SfMcpServer) => void;
-export {};

package/lib/modules/platform-cli/sf-deploy-metadata.js

@@ -1,164 +0,0 @@
-/*
- * Copyright 2025, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { z } from 'zod';
-import { Org, SfError, SfProject } from '@salesforce/core';
-import { SourceTracking } from '@salesforce/source-tracking';
-import { ComponentSet, ComponentSetBuilder } from '@salesforce/source-deploy-retrieve';
-import { ensureString } from '@salesforce/ts-types';
-import { Duration } from '@salesforce/kit';
-import { directoryParam, usernameOrAliasParam } from '../../shared/params.js';
-import { textResponse } from '../../shared/utils.js';
-import { getConnection } from '../../shared/auth.js';
-const deployMetadataParams = z.object({
-    sourceDir: z
-        .array(z.string())
-        .describe('Path to the local source files to deploy. Leave this unset if the user is vague about what to deploy.')
-        .optional(),
-    manifest: z.string().describe('Full file path for manifest (XML file) of components to deploy.').optional(),
-    // `RunSpecifiedTests` is excluded on purpose because the tool sets this level when Apex tests to run are passed in.
-    //
-    // Can be left unset to let the org decide which test level to use:
-    // https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_running_tests.htm
-    apexTestLevel: z
-        .enum(['NoTestRun', 'RunLocalTests', 'RunAllTestsInOrg'])
-        .optional()
-        .describe(`Apex test level to use during deployment.
-
-AGENT INSTRUCTIONS
-Set this only if the user specifically ask to run apex tests in some of these ways:
-
-NoTestRun="No tests are run"
-RunLocalTests="Run all tests in the org, except the ones that originate from installed managed and unlocked packages."
-RunAllTestsInOrg="Run all tests in the org, including tests of managed packages"
-
-Don't set this param if "apexTests" is also set.
-`),
-    apexTests: z
-        .array(z.string())
-        .describe(`Apex tests classes to run.
-
-Set this param if the user ask an Apex test to be run during deployment.
-`)
-        .optional(),
-    usernameOrAlias: usernameOrAliasParam,
-    directory: directoryParam,
-});
-/*
- * Deploy metadata to a Salesforce org.
- *
- * Parameters:
- * - sourceDir: Path to the local source files to deploy.
- * - manifest: Full file path for manifest (XML file) of components to deploy.
- * - apexTestLevel: Apex test level to use during deployment.
- * - apexTests: Apex tests classes to run.
- * - usernameOrAlias: Username or alias of the Salesforce org to deploy to.
- * - directory: Directory of the local project.
- *
- * Returns:
- * - textResponse: Deploy result.
- */
-export const deployMetadata = (server) => {
-    server.tool('sf-deploy-metadata', `Deploy metadata to an org from your local project.
-
-AGENT INSTRUCTIONS:
-If the user doesn't specify what to deploy exactly ("deploy my changes"), leave the "sourceDir" and "manifest" params empty so the tool calculates which files to deploy.
-
-EXAMPLE USAGE:
-Deploy changes to my org
-Deploy this file to my org
-Deploy the manifest
-Deploy X metadata to my org
-Deploy X to my org and run A,B and C apex tests.
-`, deployMetadataParams.shape, {
-        title: 'Deploy Metadata',
-        destructiveHint: true,
-        openWorldHint: false,
-    }, async ({ sourceDir, usernameOrAlias, apexTests, apexTestLevel, directory, manifest }) => {
-        if (apexTests && apexTestLevel) {
-            return textResponse("You can't specify both `apexTests` and `apexTestLevel` parameters.", true);
-        }
-        if (sourceDir && manifest) {
-            return textResponse("You can't specify both `sourceDir` and `manifest` parameters.", true);
-        }
-        if (!usernameOrAlias)
-            return textResponse('The usernameOrAlias parameter is required, if the user did not specify one use the #sf-get-username tool', true);
-        // needed for org allowlist to work
-        process.chdir(directory);
-        const connection = await getConnection(usernameOrAlias);
-        const project = await SfProject.resolve(directory);
-        const org = await Org.create({ connection });
-        if (!sourceDir && !manifest && !(await org.tracksSource())) {
-            return textResponse('This org does not have source-tracking enabled or does not support source-tracking. You should specify the files or a manifest to deploy.', true);
-        }
-        let jobId = '';
-        try {
-            const stl = await SourceTracking.create({
-                org,
-                project,
-                subscribeSDREvents: true,
-            });
-            const componentSet = await buildDeployComponentSet(connection, project, stl, sourceDir, manifest);
-            if (componentSet.size === 0) {
-                // STL found no changes
-                return textResponse('No local changes to deploy were found.');
-            }
-            const deploy = await componentSet.deploy({
-                usernameOrConnection: connection,
-                apiOptions: {
-                    ...(apexTests ? { runTests: apexTests, testLevel: 'RunSpecifiedTests' } : {}),
-                    ...(apexTestLevel ? { testLevel: apexTestLevel } : {}),
-                },
-            });
-            jobId = deploy.id ?? '';
-            // polling freq. is set dynamically by SDR based on the component set size.
-            const result = await deploy.pollStatus({
-                timeout: Duration.minutes(10),
-            });
-            return textResponse(`Deploy result: ${JSON.stringify(result.response)}`, !result.response.success);
-        }
-        catch (error) {
-            const err = SfError.wrap(error);
-            if (err.message.includes('timed out')) {
-                return textResponse(`
-YOU MUST inform the user that the deploy timed out and if they want to resume the deploy, they can use the #sf-resume tool
-and ${jobId} for the jobId parameter.`, true);
-            }
-            return textResponse(`Failed to deploy metadata: ${err.message}`, true);
-        }
-    });
-};
-async function buildDeployComponentSet(connection, project, stl, sourceDir, manifestPath) {
-    if (sourceDir || manifestPath) {
-        return ComponentSetBuilder.build({
-            apiversion: connection.getApiVersion(),
-            sourceapiversion: ensureString((await project.resolveProjectConfig()).sourceApiVersion),
-            sourcepath: sourceDir,
-            ...(manifestPath
-                ? {
-                    manifest: {
-                        manifestPath,
-                        directoryPaths: project.getUniquePackageDirectories().map((pDir) => pDir.fullPath),
-                    },
-                }
-                : {}),
-            projectDir: stl?.projectPath,
-        });
-    }
-    // No specific metadata requested to deploy, build component set from STL.
-    const cs = (await stl.localChangesAsComponentSet(false))[0] ?? new ComponentSet(undefined, stl.registry);
-    return cs;
-}
-//# sourceMappingURL=sf-deploy-metadata.js.map

package/lib/modules/platform-cli/sf-enable-tools.d.ts

@@ -1,2 +0,0 @@
-import { SfMcpServer } from '../../sf-mcp-server.js';
-export declare function enableTools(server: SfMcpServer): void;

package/lib/modules/platform-cli/sf-enable-tools.js

@@ -1,42 +0,0 @@
-/*
- * Copyright 2025, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { z } from 'zod';
-import { textResponse } from '../../shared/utils.js';
-import { enableTools as utilEnableTools } from './utils/tools.js';
-const enableToolsParamsSchema = z.object({
-    tools: z.array(z.string()).describe('The names of the tools to enable'),
-});
-export function enableTools(server) {
-    server.tool('sf-enable-tools', `Enable one or more of the tools the Salesforce MCP server provides.
-
-AGENT INSTRUCTIONS:
-Use sf-list-all-tools first to learn what tools are available for enabling.
-Once you have enabled the tool, you MUST invoke that tool to accomplish the user's original request - DO NOT USE A DIFFERENT TOOL OR THE COMMAND LINE.`, enableToolsParamsSchema.shape, {
-        title: 'Enable Salesforce MCP tools',
-        readOnlyHint: true,
-        openWorldHint: false,
-    }, async ({ tools }) => {
-        if (tools.length === 0) {
-            return textResponse('No tools specified to enable.', true);
-        }
-        const results = await utilEnableTools(tools);
-        server.sendToolListChanged();
-        const hasError = results.some((result) => !result.success);
-        const resultMessages = results.map((result) => result.message).join('\n');
-        return textResponse(resultMessages, hasError);
-    });
-}
-//# sourceMappingURL=sf-enable-tools.js.map

package/lib/modules/platform-cli/sf-get-username.d.ts

@@ -1,17 +0,0 @@
-import { z } from 'zod';
-import { SfMcpServer } from '../../sf-mcp-server.js';
-export declare const getUsernameParamsSchema: z.ZodObject<{
-    defaultTargetOrg: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    defaultDevHub: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    directory: z.ZodEffects<z.ZodString, string, string>;
-}, "strip", z.ZodTypeAny, {
-    directory: string;
-    defaultTargetOrg: boolean;
-    defaultDevHub: boolean;
-}, {
-    directory: string;
-    defaultTargetOrg?: boolean | undefined;
-    defaultDevHub?: boolean | undefined;
-}>;
-export type GetUsernameParamsSchema = z.infer<typeof getUsernameParamsSchema>;
-export declare const getUsername: (server: SfMcpServer) => void;

package/lib/modules/platform-cli/sf-get-username.js

@@ -1,109 +0,0 @@
-/*
- * Copyright 2025, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { z } from 'zod';
-import { textResponse } from '../../shared/utils.js';
-import { getDefaultTargetOrg, getDefaultTargetDevHub, suggestUsername } from '../../shared/auth.js';
-import { directoryParam } from '../../shared/params.js';
-/*
- * Get username for Salesforce org
- *
- * Intelligently determines the appropriate username or alias for Salesforce operations.
- *
- * Parameters:
- * - defaultTargetOrg: Force lookup of default target org (optional)
- * - defaultDevHub: Force lookup of default dev hub (optional)
- * - directory: The directory to run this tool from
- *
- * Returns:
- * - textResponse: Username/alias and org configuration
- */
-export const getUsernameParamsSchema = z.object({
-    defaultTargetOrg: z.boolean().optional().default(false).describe(`Try to find default org
-AGENT INSTRUCTIONS:
-ONLY SET TO TRUE when the user explicitly asks for the default org or default target org.
-Leave it as false when the user is vague and says something like "for my org" or "for my-alias".
-
-USAGE EXAMPLE:
-Get username for my default org
-...for my default target org`),
-    defaultDevHub: z.boolean().optional().default(false).describe(`Try to find default dev hub
-AGENT INSTRUCTIONS:
-ONLY SET TO TRUE when the user explicitly asks for the default dev hub or default target devhub.
-Leave it as false when the user is vague and says something like "for my org" or "for my-alias".
-
-USAGE EXAMPLE:
-Get username for my default dev hub
-...for my default target dev hub
-...for my default devhub`),
-    directory: directoryParam,
-});
-export const getUsername = (server) => {
-    server.tool('sf-get-username', `Intelligently determines the appropriate username or alias for Salesforce operations.
-
-AGENT/LLM INSTRUCTIONS:
-Use this tool when uncertain which username/org a user wants for Salesforce operations.
-This tool handles three distinct scenarios:
-
-1. When defaultTargetOrg=true: Fetches the default target org configuration
-   - Use when user says "for my default org" or "for my default target org"
-
-2. When defaultDevHub=true: Fetches the default dev hub configuration
-   - Use when user says "for my default dev hub" or "for my default target dev hub"
-
-3. When both are false (default): Uses suggestUsername to intelligently determine the appropriate org
-   - Use when user is vague and says something like "for my org" or doesn't specify
-
-EXAMPLE USAGE:
-- When user says "Do X for my org" → defaultTargetOrg=false, defaultDevHub=false
-- When user says "For my default org" → defaultTargetOrg=true
-- When user says "For my default dev hub" → defaultDevHub=true`, getUsernameParamsSchema.shape, {
-        title: 'Get Username',
-        readOnlyHint: true,
-        openWorldHint: false,
-    }, async ({ defaultTargetOrg, defaultDevHub, directory }) => {
-        try {
-            process.chdir(directory);
-            const generateResponse = (defaultFromConfig) => textResponse(`ALWAYS notify the user the following 3 (maybe 4) pieces of information:
-1. If it is default target-org or target-dev-hub ('.key' on the config)
-2. The value of '.location' on the config
-3. The value of '.value' on the config
-4. IF '.cached' IS TRUE, tell then we are using a cached value and if they have changed it, restart the MCP Server
-
-- Full config: ${JSON.stringify(defaultFromConfig, null, 2)}
-
-UNLESS THE USER SPECIFIES OTHERWISE, use this username for the "usernameOrAlias" parameter in future Tool calls.`);
-            // Case 1: User explicitly asked for default target org
-            if (defaultTargetOrg)
-                return generateResponse(await getDefaultTargetOrg());
-            // Case 2: User explicitly asked for default dev hub
-            if (defaultDevHub)
-                return generateResponse(await getDefaultTargetDevHub());
-            // Case 3: User was vague, so suggest a username
-            const { aliasForReference, suggestedUsername, reasoning } = await suggestUsername();
-            if (!suggestedUsername) {
-                return textResponse("No suggested username found. Please specify a username or alias explicitly. Also check the MCP server's startup args for allowlisting orgs.", true);
-            }
-            return textResponse(`
-YOU MUST inform the user that we are going to use "${suggestedUsername}" ${aliasForReference ? `(Alias: ${aliasForReference}) ` : ''}for the "usernameOrAlias" parameter.
-YOU MUST explain the reasoning for selecting this org, which is: "${reasoning}"
-UNLESS THE USER SPECIFIES OTHERWISE, use this username for the "usernameOrAlias" parameter in future Tool calls.`);
-        }
-        catch (error) {
-            return textResponse(`Failed to determine appropriate username: ${error instanceof Error ? error.message : 'Unknown error'}`, true);
-        }
-    });
-};
-//# sourceMappingURL=sf-get-username.js.map

package/lib/modules/platform-cli/sf-list-all-orgs.d.ts

@@ -1,11 +0,0 @@
-import { z } from 'zod';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare const listAllOrgsParamsSchema: z.ZodObject<{
-    directory: z.ZodEffects<z.ZodString, string, string>;
-}, "strip", z.ZodTypeAny, {
-    directory: string;
-}, {
-    directory: string;
-}>;
-export type ListAllOrgsOptions = z.infer<typeof listAllOrgsParamsSchema>;
-export declare const listAllOrgs: (server: McpServer) => void;

package/lib/modules/platform-cli/sf-list-all-orgs.js

@@ -1,59 +0,0 @@
-/*
- * Copyright 2025, Salesforce, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { z } from 'zod';
-import { getAllAllowedOrgs } from '../../shared/auth.js';
-import { textResponse } from '../../shared/utils.js';
-import { directoryParam } from '../../shared/params.js';
-/*
- * List all Salesforce orgs
- *
- * Lists all configured Salesforce orgs.
- *
- * Parameters:
- * - directory: directory to change to before running the command
- *
- * Returns:
- * - textResponse: List of configured Salesforce orgs
- */
-export const listAllOrgsParamsSchema = z.object({
-    directory: directoryParam,
-});
-export const listAllOrgs = (server) => {
-    server.tool('sf-list-all-orgs', `Lists all configured Salesforce orgs.
-
-AGENT INSTRUCTIONS:
-DO NOT use this tool to try to determine which org a user wants, use #sf-get-username instead. Only use it if the user explicitly asks for a list of orgs.
-
-Example usage:
-Can you list all Salesforce orgs for me
-List all Salesforce orgs
-List all orgs
-`, listAllOrgsParamsSchema.shape, {
-        title: 'List All Orgs',
-        readOnlyHint: true,
-        openWorldHint: false,
-    }, async ({ directory }) => {
-        try {
-            process.chdir(directory);
-            const orgs = await getAllAllowedOrgs();
-            return textResponse(`List of configured Salesforce orgs:\n\n${JSON.stringify(orgs, null, 2)}`);
-        }
-        catch (error) {
-            return textResponse(`Failed to list orgs: ${error instanceof Error ? error.message : 'Unknown error'}`, true);
-        }
-    });
-};
-//# sourceMappingURL=sf-list-all-orgs.js.map

package/lib/modules/platform-cli/sf-list-tools.d.ts

@@ -1,2 +0,0 @@
-import { SfMcpServer } from '../../sf-mcp-server.js';
-export declare function listTools(server: SfMcpServer): void;