@salesforce/mcp 0.11.4 → 0.13.0

package/lib/tools/dynamic/sf-list-tools.js

@@ -0,0 +1,31 @@
+/*
+ * 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 { textResponse } from '../../shared/utils.js';
+import { listAllTools } from '../../shared/tools.js';
+export function registerToolListTools(server) {
+    server.tool('sf-list-tools', `List all available tools this Salesforce MCP server can offer, providing the enabled status and description of each.
+
+AGENT INSTRUCTIONS:
+Use this when a task could be achieved with a MCP tool and the currently available tools aren't enough.
+If there's a tool that can accomplish the user's request, do not use this tool.
+Once you find the tool you want to enable, call sf-enable-tool with the tool name.
+Once you have enabled the tool, you can invoke the tool to accomplish the user's request.`, {
+        title: 'List all individual tools',
+        readOnlyHint: true,
+        openWorldHint: false,
+    }, async () => textResponse(JSON.stringify(await listAllTools(), null, 2)));
+}
+//# sourceMappingURL=sf-list-tools.js.map

package/lib/tools/orgs/index.d.ts

@@ -1 +1,2 @@
 export * from './sf-list-all-orgs.js';
+export * from './sf-org-open.js';

package/lib/tools/orgs/index.js

@@ -14,4 +14,5 @@
  * limitations under the License.
  */
 export * from './sf-list-all-orgs.js';
+export * from './sf-org-open.js';
 //# sourceMappingURL=index.js.map

package/lib/tools/orgs/sf-org-open.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { SfMcpServer } from '../../sf-mcp-server.js';
+export declare const orgOpenParamsSchema: z.ZodObject<{
+    filePath: z.ZodOptional<z.ZodString>;
+    usernameOrAlias: z.ZodString;
+    directory: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    directory: string;
+    usernameOrAlias: string;
+    filePath?: string | undefined;
+}, {
+    directory: string;
+    usernameOrAlias: string;
+    filePath?: string | undefined;
+}>;
+export type OrgOpenParamsSchema = z.infer<typeof orgOpenParamsSchema>;
+export declare const registerToolOrgOpen: (server: SfMcpServer) => void;

package/lib/tools/orgs/sf-org-open.js

@@ -0,0 +1,57 @@
+/*
+ * 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 } from '@salesforce/core';
+import { MetadataResolver } from '@salesforce/source-deploy-retrieve';
+import open from 'open';
+import { textResponse } from '../../shared/utils.js';
+import { directoryParam, usernameOrAliasParam } from '../../shared/params.js';
+export const orgOpenParamsSchema = z.object({
+    filePath: z
+        .string()
+        .optional()
+        .describe('File path of the metadata to open. This should be an existent file path in the project.'),
+    usernameOrAlias: usernameOrAliasParam,
+    directory: directoryParam,
+});
+export const registerToolOrgOpen = (server) => {
+    server.tool('sf-org-open', `Open a Salesforce org in the browser.
+
+You can specify a metadata file you want to open.
+`, orgOpenParamsSchema.shape, {
+        title: 'Open Org in Browser',
+        readOnlyHint: true,
+        openWorldHint: false,
+    }, async ({ usernameOrAlias, filePath, directory }) => {
+        process.chdir(directory);
+        const org = await Org.create({
+            aliasOrUsername: usernameOrAlias,
+        });
+        if (filePath) {
+            const metadataResolver = new MetadataResolver();
+            const components = metadataResolver.getComponentsFromPath(filePath);
+            const typeName = components[0]?.type?.name;
+            const metadataBuilderUrl = await org.getMetadataUIURL(typeName, filePath);
+            await open(metadataBuilderUrl);
+            return textResponse(metadataBuilderUrl.includes('FlexiPageList')
+                ? "Opened the org in your browser. This metadata file doesn't have a builder UI, opened Lightning App Builder instead."
+                : 'Opened this metadata in your browser');
+        }
+        await open(await org.getFrontDoorUrl());
+        return textResponse('Opened the org in your browser.');
+    });
+};
+//# sourceMappingURL=sf-org-open.js.map