@acquis-consulting/asm 1.0.5

package/dist/tools/fieldPermissions.js

@@ -0,0 +1,191 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const fieldPermissionsTool = {
+    name: 'salesforce_manage_field_permissions',
+    description: 'View, grant, or revoke Field Level Security (FLS) for a field across profiles and permission sets.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['grant', 'revoke', 'list'],
+                description: "'list' = show which profiles/permission sets have access. 'grant' = add read/edit access. 'revoke' = remove access.",
+            },
+            objectName: {
+                type: 'string',
+                description: 'The object API name.',
+            },
+            fieldName: {
+                type: 'string',
+                description: 'The field API name. __c suffix is added automatically if needed.',
+            },
+            profileNames: {
+                type: 'array',
+                items: { type: 'string' },
+                description: "Profile names. For grant/revoke: default ['System Administrator'] if neither profileNames nor permissionSetNames is provided. For list: optional filter.",
+            },
+            permissionSetNames: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Permission Set API names or labels to target. Supports standalone permission sets (not profile-owned).',
+            },
+            readable: {
+                type: 'boolean',
+                description: 'Grant read access. Default: true.',
+            },
+            editable: {
+                type: 'boolean',
+                description: 'Grant edit access. Default: true. Requires readable.',
+            },
+        },
+        required: ['operation', 'objectName', 'fieldName'],
+    },
+};
+function normalizeFieldName(fieldName) {
+    if (fieldName.includes('.'))
+        return fieldName;
+    if (fieldName.endsWith('__c'))
+        return fieldName;
+    return `${fieldName}__c`;
+}
+export async function handleFieldPermissions(conn, args) {
+    const { operation, objectName } = args;
+    const fieldName = normalizeFieldName(args.fieldName);
+    const fieldKey = `${objectName}.${fieldName}`;
+    try {
+        if (operation === 'list') {
+            const filterProfiles = args.profileNames || [];
+            const filterPermSets = args.permissionSetNames || [];
+            let parentIdFilter = '';
+            if (filterProfiles.length > 0 || filterPermSets.length > 0) {
+                const permSetIds = [];
+                for (const name of filterProfiles) {
+                    const profResult = await conn.query(`SELECT Id FROM Profile WHERE Name = '${name.replace(/'/g, "\\'")}'`);
+                    if (profResult.records?.length) {
+                        const profileId = profResult.records[0].Id;
+                        const psResult = await conn.query(`SELECT Id FROM PermissionSet WHERE ProfileId = '${profileId}' AND IsOwnedByProfile = true`);
+                        if (psResult.records?.length)
+                            permSetIds.push(psResult.records[0].Id);
+                    }
+                }
+                for (const name of filterPermSets) {
+                    const escaped = name.replace(/'/g, "\\'");
+                    const psResult = await conn.query(`SELECT Id FROM PermissionSet WHERE IsOwnedByProfile = false AND (Name = '${escaped}' OR Label = '${escaped}')`);
+                    if (psResult.records?.length)
+                        permSetIds.push(psResult.records[0].Id);
+                }
+                if (permSetIds.length === 0) {
+                    return toolResponse('None of the specified profiles or permission sets were found.', true);
+                }
+                parentIdFilter = ` AND ParentId IN ('${permSetIds.join("','")}')`;
+            }
+            const result = await conn.query(`SELECT Parent.Profile.Name, Parent.Label, PermissionsRead, PermissionsEdit FROM FieldPermissions WHERE SobjectType = '${objectName}' AND Field = '${fieldKey}'${parentIdFilter}`);
+            if (!result.records || result.records.length === 0) {
+                return toolResponse(`No explicit FLS grants found for ${fieldKey}. Admins have implicit access. Use operation "grant" to add access.`);
+            }
+            const lines = result.records.map((r) => {
+                const label = r.Parent?.Profile?.Name || r.Parent?.Label || '(Permission Set)';
+                const read = r.PermissionsRead ? 'Read' : '';
+                const edit = r.PermissionsEdit ? 'Edit' : '';
+                return `${label}: ${[read, edit].filter(Boolean).join(', ') || 'No access'}`;
+            });
+            return toolResponse(`Field permissions for ${fieldKey}:\n\n${lines.join('\n')}`);
+        }
+        const profileNames = args.profileNames || [];
+        const permissionSetNames = args.permissionSetNames || [];
+        // Default to System Administrator if neither provided
+        const effectiveProfiles = profileNames.length === 0 && permissionSetNames.length === 0
+            ? ['System Administrator']
+            : profileNames;
+        const readable = args.readable !== false;
+        const editable = args.editable !== false;
+        const results = [];
+        async function applyFls(permSetId, label) {
+            const existing = await conn.query(`SELECT Id FROM FieldPermissions WHERE ParentId = '${permSetId}' AND SobjectType = '${objectName}' AND Field = '${fieldKey}'`);
+            if (operation === 'grant') {
+                if (existing.records?.length) {
+                    await conn.sobject('FieldPermissions').update({
+                        Id: existing.records[0].Id,
+                        PermissionsRead: readable,
+                        PermissionsEdit: editable && readable,
+                    });
+                }
+                else {
+                    await conn.sobject('FieldPermissions').create({
+                        ParentId: permSetId,
+                        SobjectType: objectName,
+                        Field: fieldKey,
+                        PermissionsRead: readable,
+                        PermissionsEdit: editable && readable,
+                    });
+                }
+                results.push(`Granted to "${label}" (read: ${readable}, edit: ${editable && readable})`);
+            }
+            else {
+                if (existing.records?.length) {
+                    await conn.sobject('FieldPermissions').destroy(existing.records[0].Id);
+                    results.push(`Revoked from "${label}"`);
+                }
+                else {
+                    results.push(`No existing permissions for "${label}"`);
+                }
+            }
+        }
+        // Process profiles
+        for (const name of effectiveProfiles) {
+            try {
+                const profResult = await conn.query(`SELECT Id FROM Profile WHERE Name = '${name.replace(/'/g, "\\'")}'`);
+                if (!profResult.records?.length) {
+                    results.push(`Profile "${name}" not found`);
+                    continue;
+                }
+                const profileId = profResult.records[0].Id;
+                const psResult = await conn.query(`SELECT Id FROM PermissionSet WHERE ProfileId = '${profileId}' AND IsOwnedByProfile = true`);
+                if (!psResult.records?.length) {
+                    results.push(`No permission set for profile "${name}"`);
+                    continue;
+                }
+                await applyFls(psResult.records[0].Id, name);
+            }
+            catch (err) {
+                results.push(`Failed for profile "${name}": ${err.message}`);
+            }
+        }
+        // Process standalone permission sets
+        for (const name of permissionSetNames) {
+            try {
+                const escaped = name.replace(/'/g, "\\'");
+                const psResult = await conn.query(`SELECT Id FROM PermissionSet WHERE IsOwnedByProfile = false AND (Name = '${escaped}' OR Label = '${escaped}')`);
+                if (!psResult.records?.length) {
+                    results.push(`Permission Set "${name}" not found`);
+                    continue;
+                }
+                await applyFls(psResult.records[0].Id, name);
+            }
+            catch (err) {
+                results.push(`Failed for permission set "${name}": ${err.message}`);
+            }
+        }
+        const verb = operation === 'grant' ? 'grant' : 'revoke';
+        return toolResponse(`FLS ${verb} results for ${fieldKey}:\n\n${results.join('\n')}`);
+    }
+    catch (error) {
+        return toolResponse(`Field permissions ${operation} failed: ${error.message}`, true);
+    }
+}
+export const fieldPermissionsSchema = {
+    operation: z.enum(['grant', 'revoke', 'list']).describe("'list' = show access. 'grant' = add access. 'revoke' = remove access."),
+    objectName: z.string().describe('The object API name.'),
+    fieldName: z.string().describe('The field API name. __c suffix is added automatically if needed.'),
+    profileNames: z.array(z.string()).describe("Profile names. Default: ['System Administrator'] if neither profileNames nor permissionSetNames is provided.").optional(),
+    permissionSetNames: z.array(z.string()).describe('Permission Set API names or labels (standalone, not profile-owned).').optional(),
+    readable: z.boolean().describe('Grant read access. Default: true.').optional(),
+    editable: z.boolean().describe('Grant edit access. Default: true. Requires readable.').optional(),
+};
+export const fieldPermissionsDescriptor = {
+    name: 'salesforce_manage_field_permissions',
+    description: fieldPermissionsTool.description,
+    schema: fieldPermissionsSchema,
+    handler: handleFieldPermissions,
+};
+//# sourceMappingURL=fieldPermissions.js.map

package/dist/tools/fieldPermissions.js.map

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

package/dist/tools/getDependencies.d.ts

@@ -0,0 +1,58 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const getDependenciesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            componentId: {
+                type: string;
+                description: string;
+            };
+            direction: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            depth: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface GetDependenciesArgs {
+    componentId: string;
+    direction?: 'forward' | 'reverse';
+    depth?: number;
+}
+export declare function handleGetDependencies(conn: Connection, args: GetDependenciesArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const getDependenciesSchema: {
+    componentId: z.ZodString;
+    direction: z.ZodOptional<z.ZodEnum<{
+        reverse: "reverse";
+        forward: "forward";
+    }>>;
+    depth: z.ZodOptional<z.ZodNumber>;
+};
+export declare const getDependenciesDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        componentId: z.ZodString;
+        direction: z.ZodOptional<z.ZodEnum<{
+            reverse: "reverse";
+            forward: "forward";
+        }>>;
+        depth: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: typeof handleGetDependencies;
+};

package/dist/tools/getDependencies.js

@@ -0,0 +1,105 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const getDependenciesTool = {
+    name: 'salesforce_get_dependencies',
+    description: 'Analyze metadata component dependencies using the Tooling API MetadataComponentDependency object (Beta). Shows what a component depends on (forward) or what depends on it (reverse), with optional recursive traversal up to 3 levels deep. Useful for impact analysis before modifying Apex classes, triggers, fields, and other metadata.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            componentId: {
+                type: 'string',
+                description: 'The 15 or 18-character Salesforce ID of the metadata component to analyze.',
+            },
+            direction: {
+                type: 'string',
+                enum: ['forward', 'reverse'],
+                description: 'Direction of dependency lookup. "forward" = what this component depends on. "reverse" = what depends on this component. Default: "forward".',
+            },
+            depth: {
+                type: 'number',
+                description: 'Recursion depth for dependency traversal. 1 = direct dependencies only. Max 3. Default: 1.',
+            },
+        },
+        required: ['componentId'],
+    },
+};
+async function queryDependencies(conn, componentIds, direction) {
+    const idList = componentIds.map((id) => `'${id}'`).join(',');
+    const whereField = direction === 'forward' ? 'MetadataComponentId' : 'RefMetadataComponentId';
+    const soql = `SELECT MetadataComponentId, MetadataComponentName, MetadataComponentType, RefMetadataComponentId, RefMetadataComponentName, RefMetadataComponentType FROM MetadataComponentDependency WHERE ${whereField} IN (${idList})`;
+    const result = await conn.tooling.query(soql);
+    return (result.records || []);
+}
+function getTarget(record, direction) {
+    if (direction === 'forward') {
+        return { id: record.RefMetadataComponentId, name: record.RefMetadataComponentName, type: record.RefMetadataComponentType };
+    }
+    return { id: record.MetadataComponentId, name: record.MetadataComponentName, type: record.MetadataComponentType };
+}
+export async function handleGetDependencies(conn, args) {
+    const { componentId } = args;
+    const direction = args.direction || 'forward';
+    const depth = Math.min(Math.max(args.depth || 1, 1), 3);
+    if (direction !== 'forward' && direction !== 'reverse') {
+        return toolResponse('Invalid direction. Must be "forward" or "reverse".', true);
+    }
+    try {
+        const visited = new Set();
+        visited.add(componentId);
+        const allLevels = [];
+        let currentIds = [componentId];
+        let totalCount = 0;
+        for (let level = 1; level <= depth; level++) {
+            if (currentIds.length === 0)
+                break;
+            const records = await queryDependencies(conn, currentIds, direction);
+            const entryMap = new Map();
+            for (const record of records) {
+                const target = getTarget(record, direction);
+                if (!entryMap.has(target.id) && !visited.has(target.id)) {
+                    entryMap.set(target.id, target);
+                }
+            }
+            const entries = Array.from(entryMap.values());
+            if (entries.length === 0)
+                break;
+            totalCount += entries.length;
+            allLevels.push({ level, entries });
+            currentIds = [];
+            for (const entry of entries) {
+                visited.add(entry.id);
+                currentIds.push(entry.id);
+            }
+        }
+        if (totalCount === 0) {
+            const dirLabel = direction === 'forward' ? 'dependencies' : 'dependents';
+            return toolResponse(`No ${dirLabel} found for component ${componentId}.`);
+        }
+        const dirLabel = direction === 'forward' ? 'Dependencies (what it depends on)' : 'Dependents (what depends on it)';
+        const lines = [`## ${dirLabel}`, `**Component:** ${componentId}`, `**Depth:** ${depth}`, `**Total:** ${totalCount}`, ''];
+        for (const { level, entries } of allLevels) {
+            lines.push(`### Level ${level}`);
+            for (const entry of entries) {
+                const indent = '  '.repeat(level - 1);
+                lines.push(`${indent}- ${entry.name} (${entry.type}) [${entry.id}]`);
+            }
+            lines.push('');
+        }
+        return toolResponse(lines.join('\n'));
+    }
+    catch (error) {
+        return toolResponse(`Dependency query failed: ${error.message}`, true);
+    }
+}
+export const getDependenciesSchema = {
+    componentId: z.string().describe('The 15 or 18-character Salesforce ID of the metadata component to analyze.'),
+    direction: z.enum(['forward', 'reverse']).describe('Direction of dependency lookup. "forward" = what this component depends on. "reverse" = what depends on this component. Default: "forward".').optional(),
+    depth: z.number().describe('Recursion depth for dependency traversal. 1 = direct dependencies only. Max 3. Default: 1.').optional(),
+};
+export const getDependenciesDescriptor = {
+    name: 'salesforce_get_dependencies',
+    description: getDependenciesTool.description,
+    schema: getDependenciesSchema,
+    handler: handleGetDependencies,
+};
+//# sourceMappingURL=getDependencies.js.map

package/dist/tools/getDependencies.js.map

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

package/dist/tools/listUserPermissions.d.ts

@@ -0,0 +1,36 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const listUserPermissionsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            search: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export interface ListUserPermissionsArgs {
+    search?: string;
+}
+export declare function handleListUserPermissions(conn: Connection, args: ListUserPermissionsArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const listUserPermissionsSchema: {
+    search: z.ZodOptional<z.ZodString>;
+};
+export declare const listUserPermissionsDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        search: z.ZodOptional<z.ZodString>;
+    };
+    handler: typeof handleListUserPermissions;
+};

package/dist/tools/listUserPermissions.js

@@ -0,0 +1,59 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const listUserPermissionsTool = {
+    name: 'salesforce_list_user_permissions',
+    description: 'Discover all user/system permission flags that can be enabled or disabled on profiles and permission sets via salesforce_manage_user_permissions. Returns short name, full API field name, and label.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            search: {
+                type: 'string',
+                description: "Optional filter. Case-insensitive substring match against short name and label. Example: 'api'.",
+            },
+        },
+    },
+};
+export async function handleListUserPermissions(conn, args) {
+    try {
+        const describeResult = await conn.describe('PermissionSet');
+        const permFields = [];
+        for (const field of describeResult.fields) {
+            if (field.name?.startsWith('Permissions') && field.type === 'boolean') {
+                permFields.push({
+                    apiName: field.name,
+                    shortName: field.name.slice('Permissions'.length),
+                    label: field.label,
+                });
+            }
+        }
+        permFields.sort((a, b) => a.shortName.localeCompare(b.shortName));
+        const search = args.search;
+        const filtered = search
+            ? permFields.filter((p) => p.shortName.toLowerCase().includes(search.toLowerCase()) ||
+                p.label.toLowerCase().includes(search.toLowerCase()))
+            : permFields;
+        if (!filtered.length) {
+            return toolResponse(search
+                ? `No user/system permissions found matching "${search}".`
+                : 'No user/system permission fields found on PermissionSet.');
+        }
+        const lines = filtered.map((p) => `${p.shortName}  (${p.apiName})  —  ${p.label}`);
+        const header = search
+            ? `User/system permissions matching "${search}" (${filtered.length} of ${permFields.length} total):\n`
+            : `All configurable user/system permissions (${filtered.length}):\n`;
+        return toolResponse(header + '\n' + lines.join('\n'));
+    }
+    catch (error) {
+        return toolResponse(`List user permissions failed: ${error.message}`, true);
+    }
+}
+export const listUserPermissionsSchema = {
+    search: z.string().describe("Optional filter. Case-insensitive substring match against short name and label.").optional(),
+};
+export const listUserPermissionsDescriptor = {
+    name: 'salesforce_list_user_permissions',
+    description: listUserPermissionsTool.description,
+    schema: listUserPermissionsSchema,
+    handler: handleListUserPermissions,
+};
+//# sourceMappingURL=listUserPermissions.js.map

package/dist/tools/listUserPermissions.js.map

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

package/dist/tools/metadataDescribe.d.ts

@@ -0,0 +1,37 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const metadataDescribeTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            apiVersion: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export interface MetadataDescribeArgs {
+    apiVersion?: string;
+}
+export declare function handleMetadataDescribe(conn: Connection, args: MetadataDescribeArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const metadataDescribeSchema: {
+    apiVersion: z.ZodOptional<z.ZodString>;
+};
+export declare const metadataDescribeDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        apiVersion: z.ZodOptional<z.ZodString>;
+    };
+    handler: typeof handleMetadataDescribe;
+};

package/dist/tools/metadataDescribe.js

@@ -0,0 +1,35 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const metadataDescribeTool = {
+    name: 'salesforce_list_metadata_types',
+    description: 'List all metadata types available in the Salesforce org. Essential starting point for org analysis — returns every metadata type (CustomObject, ValidationRule, Flow, ApexClass, etc.) with details on child types and folder requirements. Use this to discover what types can be passed to salesforce_list_metadata and salesforce_read_metadata.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            apiVersion: {
+                type: 'string',
+                description: 'API version to describe (e.g. "59.0"). Defaults to the connection version.',
+            },
+        },
+        required: [],
+    },
+};
+export async function handleMetadataDescribe(conn, args) {
+    try {
+        const result = await conn.metadata.describe(args.apiVersion || conn.version);
+        return toolResponse(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        return toolResponse(`Metadata describe failed: ${error.message}`, true);
+    }
+}
+export const metadataDescribeSchema = {
+    apiVersion: z.string().describe('API version to describe (e.g. "59.0"). Defaults to the connection version.').optional(),
+};
+export const metadataDescribeDescriptor = {
+    name: 'salesforce_list_metadata_types',
+    description: metadataDescribeTool.description,
+    schema: metadataDescribeSchema,
+    handler: handleMetadataDescribe,
+};
+//# sourceMappingURL=metadataDescribe.js.map

package/dist/tools/metadataDescribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataDescribe.js","sourceRoot":"","sources":["../../src/tools/metadataDescribe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,qVAAqV;IAClW,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4EAA4E;aAC1F;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAgB,EAAE,IAA0B;IACvF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAO,IAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,IAAK,IAAY,CAAC,OAAO,CAAC,CAAC;QAE/F,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC,CAAC,QAAQ,EAAE;CACzH,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,oBAAoB,CAAC,WAAW;IAC7C,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,sBAAsB;CAChC,CAAC"}

package/dist/tools/metadataDiff.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod/v4';
+export declare const metadataDiffTool: {
+    name: "salesforce_metadata_diff";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            workingDir: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface MetadataDiffArgs {
+    workingDir: string;
+}
+export interface DiffChange {
+    content: string;
+    type: 'insert' | 'delete' | 'normal';
+    oldLineNumber?: number;
+    newLineNumber?: number;
+}
+export interface DiffHunk {
+    oldStart: number;
+    newStart: number;
+    changes: DiffChange[];
+}
+export interface DiffFile {
+    oldPath: string;
+    newPath: string;
+    type: 'add' | 'delete' | 'modify' | 'rename';
+    metadataType: string | null;
+    componentName: string | null;
+    hunks: DiffHunk[];
+}
+export interface DiffResult {
+    workingDir: string;
+    summary: {
+        added: number;
+        modified: number;
+        deleted: number;
+        totalFiles: number;
+    };
+    files: DiffFile[];
+}
+export declare function handleMetadataDiff(args: MetadataDiffArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const metadataDiffSchema: {
+    workingDir: z.ZodString;
+};
+export declare const metadataDiffDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        workingDir: z.ZodString;
+    };
+    handler: typeof handleMetadataDiff;
+    noConnection: boolean;
+};