@acquis-consulting/asm 1.0.5

package/dist/tools/objectPermissions.js

@@ -0,0 +1,157 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+const PERMISSION_KEYS = ['create', 'read', 'edit', 'delete', 'viewAll', 'modifyAll'];
+const fieldMap = {
+    create: 'PermissionsCreate',
+    read: 'PermissionsRead',
+    edit: 'PermissionsEdit',
+    delete: 'PermissionsDelete',
+    viewAll: 'PermissionsViewAllRecords',
+    modifyAll: 'PermissionsModifyAllRecords',
+};
+export const objectPermissionsTool = {
+    name: 'salesforce_manage_object_permissions',
+    description: 'View, grant, or revoke object-level permissions (Create, Read, Edit, Delete, ViewAll, ModifyAll) for profiles and permission sets.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['grant', 'revoke', 'list'],
+                description: "'list' = show current permissions. 'grant' = add permissions. 'revoke' = remove all object permissions.",
+            },
+            objectName: {
+                type: 'string',
+                description: 'Object API name. Custom objects must include __c. Examples: Account, Invoice__c.',
+            },
+            profileNames: {
+                type: 'array',
+                items: { type: 'string' },
+                description: "Profile names. Default: ['System Administrator'] if neither profileNames nor permissionSetNames provided.",
+            },
+            permissionSetNames: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Permission Set API names or labels.',
+            },
+            permissions: {
+                type: 'array',
+                items: { type: 'string', enum: ['create', 'read', 'edit', 'delete', 'viewAll', 'modifyAll'] },
+                description: 'Which permissions to grant. Defaults to all. Ignored for list and revoke.',
+            },
+        },
+        required: ['operation', 'objectName'],
+    },
+};
+async function resolvePermSetIds(conn, profileNames, permSetNames) {
+    const results = [];
+    for (const name of profileNames) {
+        const profResult = await conn.query(`SELECT Id FROM Profile WHERE Name = '${name.replace(/'/g, "\\'")}'`);
+        if (!profResult.records?.length)
+            throw new Error(`Profile "${name}" not found`);
+        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)
+            throw new Error(`No owned PermissionSet found for profile "${name}"`);
+        results.push({ id: psResult.records[0].Id, label: name });
+    }
+    for (const name of permSetNames) {
+        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)
+            throw new Error(`Permission Set "${name}" not found`);
+        results.push({ id: psResult.records[0].Id, label: name });
+    }
+    return results;
+}
+export async function handleObjectPermissions(conn, args) {
+    const { operation, objectName } = args;
+    try {
+        if (operation === 'list') {
+            const filterProfiles = args.profileNames || [];
+            const filterPermSets = args.permissionSetNames || [];
+            let parentIdFilter = '';
+            if (filterProfiles.length > 0 || filterPermSets.length > 0) {
+                const resolved = await resolvePermSetIds(conn, filterProfiles, filterPermSets);
+                parentIdFilter = ` AND ParentId IN ('${resolved.map((r) => r.id).join("','")}')`;
+            }
+            const allFields = Object.values(fieldMap).join(', ');
+            const result = await conn.query(`SELECT Parent.Profile.Name, Parent.Label, ${allFields} FROM ObjectPermissions WHERE SobjectType = '${objectName}'${parentIdFilter}`);
+            if (!result.records?.length) {
+                return toolResponse(`No explicit object permissions found for ${objectName}.`);
+            }
+            const lines = result.records.map((r) => {
+                const label = r.Parent?.Profile?.Name || r.Parent?.Label || '(Permission Set)';
+                const granted = PERMISSION_KEYS.filter((k) => r[fieldMap[k]]);
+                return `${label}: ${granted.length ? granted.join(', ') : 'none'}`;
+            });
+            return toolResponse(`Object permissions for ${objectName}:\n\n${lines.join('\n')}`);
+        }
+        const profileNames = args.profileNames || [];
+        const permSetNames = args.permissionSetNames || [];
+        const effectiveProfiles = profileNames.length === 0 && permSetNames.length === 0
+            ? ['System Administrator']
+            : profileNames;
+        const targets = await resolvePermSetIds(conn, effectiveProfiles, permSetNames);
+        const results = [];
+        const requestedPerms = operation === 'grant'
+            ? (args.permissions?.length ? args.permissions : [...PERMISSION_KEYS])
+            : [];
+        for (const { id: permSetId, label } of targets) {
+            try {
+                const existing = await conn.query(`SELECT Id FROM ObjectPermissions WHERE ParentId = '${permSetId}' AND SobjectType = '${objectName}'`);
+                if (operation === 'grant') {
+                    const fieldUpdates = {};
+                    for (const perm of requestedPerms) {
+                        fieldUpdates[fieldMap[perm]] = true;
+                    }
+                    if (existing.records?.length) {
+                        await conn.sobject('ObjectPermissions').update({
+                            Id: existing.records[0].Id,
+                            ...fieldUpdates,
+                        });
+                    }
+                    else {
+                        await conn.sobject('ObjectPermissions').create({
+                            ParentId: permSetId,
+                            SobjectType: objectName,
+                            ...fieldUpdates,
+                        });
+                    }
+                    results.push(`Granted to "${label}": ${requestedPerms.join(', ')}`);
+                }
+                else {
+                    if (existing.records?.length) {
+                        await conn.sobject('ObjectPermissions').destroy(existing.records[0].Id);
+                        results.push(`Revoked from "${label}"`);
+                    }
+                    else {
+                        results.push(`No existing permissions for "${label}"`);
+                    }
+                }
+            }
+            catch (err) {
+                results.push(`Failed for "${label}": ${err.message}`);
+            }
+        }
+        const verb = operation === 'grant' ? 'grant' : 'revoke';
+        return toolResponse(`Object permissions ${verb} results for ${objectName}:\n\n${results.join('\n')}`);
+    }
+    catch (error) {
+        return toolResponse(`Object permissions ${operation} failed: ${error.message}`, true);
+    }
+}
+export const objectPermissionsSchema = {
+    operation: z.enum(['grant', 'revoke', 'list']).describe("'list' = show access. 'grant' = add access. 'revoke' = remove access."),
+    objectName: z.string().describe('Object API name. Custom objects must include __c.'),
+    profileNames: z.array(z.string()).describe("Profile names. Default: ['System Administrator'] if neither profileNames nor permissionSetNames provided.").optional(),
+    permissionSetNames: z.array(z.string()).describe('Permission Set API names or labels.').optional(),
+    permissions: z.array(z.enum(['create', 'read', 'edit', 'delete', 'viewAll', 'modifyAll'])).describe('Permissions to grant. Defaults to all. Ignored for list and revoke.').optional(),
+};
+export const objectPermissionsDescriptor = {
+    name: 'salesforce_manage_object_permissions',
+    description: objectPermissionsTool.description,
+    schema: objectPermissionsSchema,
+    handler: handleObjectPermissions,
+};
+//# sourceMappingURL=objectPermissions.js.map

package/dist/tools/objectPermissions.js.map

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

package/dist/tools/objectSchema.d.ts

@@ -0,0 +1,37 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const objectSchemaTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            objectName: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ObjectSchemaArgs {
+    objectName: string;
+}
+export declare function handleObjectSchema(conn: Connection, args: ObjectSchemaArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const objectSchemaSchema: {
+    objectName: z.ZodString;
+};
+export declare const objectSchemaDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        objectName: z.ZodString;
+    };
+    handler: typeof handleObjectSchema;
+};

package/dist/tools/objectSchema.js

@@ -0,0 +1,66 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const objectSchemaTool = {
+    name: 'salesforce_describe_object',
+    description: 'Get the complete field-level schema of a Salesforce object including all fields, their types, relationships, and picklist values. Use salesforce_search_objects first to find the correct API name.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            objectName: {
+                type: 'string',
+                description: 'The Salesforce object API name (e.g., "Account", "Contact", "MyObject__c").',
+            },
+        },
+        required: ['objectName'],
+    },
+};
+export async function handleObjectSchema(conn, args) {
+    const { objectName } = args;
+    const desc = await conn.describe(objectName);
+    const lines = [];
+    lines.push(`## ${desc.label} (${desc.name}) — ${desc.custom ? 'Custom' : 'Standard'} Object\n`);
+    lines.push('### Fields\n');
+    for (const field of desc.fields) {
+        let info = `- **${field.name}** — ${field.label} (${field.type}`;
+        if (field.length)
+            info += `, length: ${field.length}`;
+        info += `)`;
+        if (!field.nillable && field.name !== 'Id')
+            info += ' *required*';
+        if (field.referenceTo && field.referenceTo.length > 0) {
+            info += ` → ${field.referenceTo.join(', ')}`;
+        }
+        if (field.picklistValues && field.picklistValues.length > 0) {
+            const values = field.picklistValues
+                .filter((pv) => pv.active)
+                .slice(0, 200)
+                .map((pv) => pv.label || pv.value);
+            if (values.length > 0) {
+                info += `\n  Picklist: ${values.join(', ')}`;
+            }
+        }
+        if (field.defaultValue !== null && field.defaultValue !== undefined) {
+            info += ` (default: ${field.defaultValue})`;
+        }
+        lines.push(info);
+    }
+    if (desc.childRelationships && desc.childRelationships.length > 0) {
+        lines.push('\n### Child Relationships\n');
+        for (const rel of desc.childRelationships) {
+            if (rel.relationshipName) {
+                lines.push(`- **${rel.relationshipName}** → ${rel.childSObject}.${rel.field}`);
+            }
+        }
+    }
+    return toolResponse(lines.join('\n'));
+}
+export const objectSchemaSchema = {
+    objectName: z.string().describe('The Salesforce object API name (e.g., "Account", "Contact", "MyObject__c").'),
+};
+export const objectSchemaDescriptor = {
+    name: 'salesforce_describe_object',
+    description: objectSchemaTool.description,
+    schema: objectSchemaSchema,
+    handler: handleObjectSchema,
+};
+//# sourceMappingURL=objectSchema.js.map

package/dist/tools/objectSchema.js.map

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

package/dist/tools/objectSearch.d.ts

@@ -0,0 +1,37 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const objectSearchTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            searchPattern: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ObjectSearchArgs {
+    searchPattern: string;
+}
+export declare function handleObjectSearch(conn: Connection, args: ObjectSearchArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const objectSearchSchema: {
+    searchPattern: z.ZodString;
+};
+export declare const objectSearchDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        searchPattern: z.ZodString;
+    };
+    handler: typeof handleObjectSearch;
+};

package/dist/tools/objectSearch.js

@@ -0,0 +1,44 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const objectSearchTool = {
+    name: 'salesforce_search_objects',
+    description: 'Search for Salesforce objects by keyword. Matches against object API names and labels. Example: "Account Coverage" finds AccountCoverage__c. Use this to discover object API names before querying.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            searchPattern: {
+                type: 'string',
+                description: 'Space-separated search terms. All terms must match (AND logic). Matches against object name and label (case-insensitive).',
+            },
+        },
+        required: ['searchPattern'],
+    },
+};
+export async function handleObjectSearch(conn, args) {
+    const { searchPattern } = args;
+    const terms = searchPattern.toLowerCase().split(/\s+/).filter(Boolean);
+    if (terms.length === 0) {
+        return toolResponse('Please provide at least one search term.', true);
+    }
+    const globalDesc = await conn.describeGlobal();
+    const matches = globalDesc.sobjects.filter((obj) => {
+        const name = obj.name.toLowerCase();
+        const label = (obj.label || '').toLowerCase();
+        return terms.every((term) => name.includes(term) || label.includes(term));
+    });
+    if (matches.length === 0) {
+        return toolResponse(`No objects found matching "${searchPattern}".`);
+    }
+    const lines = matches.map((obj) => `${obj.name} — ${obj.label} (${obj.custom ? 'Custom' : 'Standard'})`);
+    return toolResponse(`Found ${matches.length} object(s):\n\n${lines.join('\n')}`);
+}
+export const objectSearchSchema = {
+    searchPattern: z.string().describe('Space-separated search terms. All terms must match (AND logic). Matches against object name and label (case-insensitive).'),
+};
+export const objectSearchDescriptor = {
+    name: 'salesforce_search_objects',
+    description: objectSearchTool.description,
+    schema: objectSearchSchema,
+    handler: handleObjectSearch,
+};
+//# sourceMappingURL=objectSearch.js.map

package/dist/tools/objectSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectSearch.js","sourceRoot":"","sources":["../../src/tools/objectSearch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,qMAAqM;IAClN,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2HAA2H;aACzI;SACF;QACD,QAAQ,EAAE,CAAC,eAAe,CAAC;KAC5B;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAgB,EAAE,IAAsB;IAC/E,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEvE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC,0CAA0C,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAQ,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC,8BAA8B,aAAa,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CACrC,GAAG,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,GAAG,CACrE,CAAC;IAEF,OAAO,YAAY,CAAC,SAAS,OAAO,CAAC,MAAM,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2HAA2H,CAAC;CAChK,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,gBAAgB,CAAC,WAAW;IACzC,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,kBAAkB;CAC5B,CAAC"}

package/dist/tools/packageStatus.d.ts

@@ -0,0 +1,24 @@
+export declare const packageStatusTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            jobId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface PackageStatusArgs {
+    jobId: string;
+}
+export declare function handlePackageStatus(args: PackageStatusArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/dist/tools/packageStatus.js

@@ -0,0 +1 @@
+import{mkdir as e,writeFile as t}from"node:fs/promises";import{join as o,dirname as s}from"node:path";import{toolResponse as r}from"../utils/index.js";import{getJob as n,removeJob as a}from"../utils/packageJobs.js";import{cleanProfileAndPermissionSetFiles as i}from"../utils/profileCleanup.js";export const packageStatusTool={name:"salesforce_package_status",description:'Check the status of an async metadata retrieve or deploy job. Returns progress info and a "done" boolean. When a retrieve completes successfully, files are automatically extracted to the output directory. Poll this tool until done is true.',inputSchema:{type:"object",properties:{jobId:{type:"string",description:"The async job ID returned by salesforce_retrieve_package or salesforce_deploy_package."}},required:["jobId"]}};export async function handlePackageStatus(c){const{jobId:u}=c,l=n(u);if(!l)return r(`No active job found for ID "${u}". The job may have already completed or the server may have restarted.`,!0);try{return"retrieve"===l.type?await async function(c){const u=n(c),l=await u.conn.metadata.checkRetrieveStatus(c),p=l.status;if("true"!==l.done&&!0!==l.done){const e=Math.round((Date.now()-u.startedAt)/1e3);return r(JSON.stringify({done:!1,jobId:c,type:"retrieve",status:p,elapsedSeconds:e,message:`Retrieve in progress (${p}). Poll again.`},null,2))}if("true"!==l.success&&!0!==l.success){const e=l.errorMessage||l.errorStatusCode||"Unknown error";return a(c),r(JSON.stringify({done:!0,jobId:c,type:"retrieve",success:!1,error:e},null,2),!0)}const d=l.zipFile;if(!d||!u.outputDirectory)return a(c),r(JSON.stringify({done:!0,jobId:c,type:"retrieve",success:!0,warning:"No zip data or output directory — cannot extract files."},null,2));const m=(await import("jszip")).default,y=await m.loadAsync(Buffer.from(d,"base64")),f={},b=[];for(const[r,n]of Object.entries(y.files)){if(n.dir)continue;const a=o(u.outputDirectory,r);await e(s(a),{recursive:!0});const i=await n.async("nodebuffer");await t(a,i),b.push(r);const c=r.split("/")[0]||"root";f[c]=(f[c]||0)+1}let g;if(u.componentMap&&(u.componentMap.Profile||u.componentMap.PermissionSet))try{g=await i(u.outputDirectory,u.componentMap)}catch(e){process.stderr.write(`[packageStatus] Profile/PermissionSet cleanup failed (non-fatal): ${e.message}\n`)}return a(c),r(JSON.stringify({done:!0,jobId:c,type:"retrieve",success:!0,outputDirectory:u.outputDirectory,totalFiles:b.length,fileCounts:f,files:b,...null!=g?{profilesCleanedCount:g}:{}},null,2))}(u):await async function(e){const t=n(e),o=await t.conn.metadata.checkDeployStatus(e,!0),s="true"===o.done||!0===o.done,i=o.status;if(!s){const s=null!=o.numberComponentsDeployed?`${o.numberComponentsDeployed}/${o.numberComponentsTotal} components`:i,n=Math.round((Date.now()-t.startedAt)/1e3);return r(JSON.stringify({done:!1,jobId:e,type:"deploy",status:i,progress:s,elapsedSeconds:n,message:`Deploy in progress (${s}). Poll again.`},null,2))}const c="true"===o.success||!0===o.success,u="true"===o.checkOnly||!0===o.checkOnly;if(c){const t=o.numberComponentsDeployed||0,s=function(e){const t=e.details?.runTestResult;return t?{numTestsRun:t.numTestsRun,numFailures:t.numFailures,totalTime:t.totalTime}:void 0}(o);return a(e),r(JSON.stringify({done:!0,jobId:e,type:"deploy",success:!0,checkOnly:u,componentsDeployed:t,...s?{testResults:s}:{}},null,2))}const l=function(e){const t=[],o=e.details?.componentFailures;if(o){const e=Array.isArray(o)?o:[o];for(const o of e)t.push({componentType:o.componentType,fullName:o.fullName,problem:o.problem,problemType:o.problemType,lineNumber:o.lineNumber||void 0,columnNumber:o.columnNumber||void 0})}const s=e.details?.runTestResult?.failures;if(s){const e=Array.isArray(s)?s:[s];for(const o of e)t.push({type:"testFailure",name:o.name,methodName:o.methodName,message:o.message,stackTrace:o.stackTrace})}return 0===t.length&&t.push({message:e.errorMessage||"Unknown deploy error"}),t}(o);return a(e),r(JSON.stringify({done:!0,jobId:e,type:"deploy",success:!1,checkOnly:u,errors:l},null,2),!0)}(u)}catch(e){return r(`Failed to check job status: ${e.message}`,!0)}}

package/dist/tools/permissionSetAssignment.d.ts

@@ -0,0 +1,39 @@
+import { Connection } from 'jsforce';
+export declare const permissionSetAssignmentTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            operation: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            userIdentifier: {
+                type: string;
+                description: string;
+            };
+            permissionSetNames: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface PermissionSetAssignmentArgs {
+    operation: 'view' | 'assign' | 'unassign';
+    userIdentifier?: string;
+    permissionSetNames?: string[];
+}
+export declare function handlePermissionSetAssignment(conn: Connection, args: PermissionSetAssignmentArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/dist/tools/permissionSetAssignment.js

@@ -0,0 +1 @@
+import{toolResponse as e}from"../utils/index.js";export const permissionSetAssignmentTool={name:"salesforce_manage_permission_set_assignment",description:"View, assign, or unassign permission sets to/from users. View shows assignments by user or permission set.",inputSchema:{type:"object",properties:{operation:{type:"string",enum:["view","assign","unassign"],description:"The operation to perform."},userIdentifier:{type:"string",description:"User identifier: 18-char Salesforce ID, Username, or Email."},permissionSetNames:{type:"array",items:{type:"string"},description:"Permission set DeveloperNames (not profiles). Required for assign/unassign."}},required:["operation"]}};async function s(e,s){if(/^[a-zA-Z0-9]{18}$/.test(s)||/^[a-zA-Z0-9]{15}$/.test(s))try{const n=await e.query(`SELECT Id, Username FROM User WHERE Id = '${s}'`);if(n.records?.length){const e=n.records[0];return{id:e.Id,name:e.Username}}}catch{}const n=await e.query(`SELECT Id, Username FROM User WHERE Username = '${s.replace(/'/g,"\\'")}'`);if(n.records?.length){const e=n.records[0];return{id:e.Id,name:e.Username}}const i=await e.query(`SELECT Id, Username FROM User WHERE Email = '${s.replace(/'/g,"\\'")}'`);if(i.records?.length){if(i.records.length>1)return`Multiple users found with email "${s}". Use Username or Id instead.`;const e=i.records[0];return{id:e.Id,name:e.Username}}return`User "${s}" not found by Id, Username, or Email.`}export async function handlePermissionSetAssignment(n,i){const{operation:r}=i;try{if("view"===r){if(!i.userIdentifier&&!i.permissionSetNames?.length)return e("Provide userIdentifier or permissionSetNames for view operation.",!0);if(i.userIdentifier){const r=await s(n,i.userIdentifier);if("string"==typeof r)return e(r,!0);const t=await n.query(`SELECT PermissionSet.Name, PermissionSet.Label, PermissionSet.IsOwnedByProfile FROM PermissionSetAssignment WHERE AssigneeId = '${r.id}'`);if(!t.records?.length)return e(`No permission set assignments found for ${r.name}.`);const o=[],a=[];for(const e of t.records)e.PermissionSet?.IsOwnedByProfile?o.push(e.PermissionSet.Label):a.push(`${e.PermissionSet.Label} (${e.PermissionSet.Name})`);const m=[];return o.length&&m.push(`Profiles:\n${o.map(e=>`  - ${e}`).join("\n")}`),a.length&&m.push(`Permission Sets:\n${a.map(e=>`  - ${e}`).join("\n")}`),e(`Assignments for ${r.name}:\n\n${m.join("\n\n")}`)}const r=i.permissionSetNames[0],t=await n.query(`SELECT Id, Label FROM PermissionSet WHERE Name = '${r.replace(/'/g,"\\'")}' AND IsOwnedByProfile = false`);if(!t.records?.length)return e(`Permission set "${r}" not found.`,!0);const o=t.records[0],a=await n.query(`SELECT Assignee.Username, Assignee.Name FROM PermissionSetAssignment WHERE PermissionSetId = '${o.Id}'`);if(!a.records?.length)return e(`No users assigned to "${o.Label}".`);const m=a.records.map(e=>`  - ${e.Assignee?.Name} (${e.Assignee?.Username})`);return e(`Users assigned to "${o.Label}" (${r}):\n\n${m.join("\n")}`)}if(!i.userIdentifier)return e("userIdentifier is required for assign/unassign.",!0);if(!i.permissionSetNames?.length)return e("permissionSetNames is required for assign/unassign.",!0);const t=await s(n,i.userIdentifier);if("string"==typeof t)return e(t,!0);const o=[];for(const e of i.permissionSetNames)try{const s=await n.query(`SELECT Id, Label FROM PermissionSet WHERE Name = '${e.replace(/'/g,"\\'")}' AND IsOwnedByProfile = false`);if(!s.records?.length){o.push(`Permission set "${e}" not found`);continue}const i=s.records[0];if("assign"===r){const e=await n.query(`SELECT Id FROM PermissionSetAssignment WHERE AssigneeId = '${t.id}' AND PermissionSetId = '${i.Id}'`);if(e.records?.length){o.push(`"${i.Label}" already assigned to ${t.name}`);continue}await n.sobject("PermissionSetAssignment").create({AssigneeId:t.id,PermissionSetId:i.Id}),o.push(`Assigned "${i.Label}" to ${t.name}`)}else{const e=await n.query(`SELECT Id FROM PermissionSetAssignment WHERE AssigneeId = '${t.id}' AND PermissionSetId = '${i.Id}'`);if(!e.records?.length){o.push(`"${i.Label}" is not assigned to ${t.name}`);continue}await n.sobject("PermissionSetAssignment").destroy(e.records[0].Id),o.push(`Unassigned "${i.Label}" from ${t.name}`)}}catch(s){o.push(`Failed for "${e}": ${s.message}`)}return e(`Permission set ${r} results for ${t.name}:\n\n${o.join("\n")}`)}catch(s){return e(`Permission set assignment ${r} failed: ${s.message}`,!0)}}

package/dist/tools/readApexClasses.d.ts

@@ -0,0 +1,50 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const readApexClassesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            className: {
+                type: string;
+                description: string;
+            };
+            namePattern: {
+                type: string;
+                description: string;
+            };
+            includeMetadata: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export interface ReadApexClassesArgs {
+    className?: string;
+    namePattern?: string;
+    includeMetadata?: boolean;
+}
+export declare function handleReadApexClasses(conn: Connection, args: ReadApexClassesArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const readApexClassesSchema: {
+    className: z.ZodOptional<z.ZodString>;
+    namePattern: z.ZodOptional<z.ZodString>;
+    includeMetadata: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const readApexClassesDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        className: z.ZodOptional<z.ZodString>;
+        namePattern: z.ZodOptional<z.ZodString>;
+        includeMetadata: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: typeof handleReadApexClasses;
+};

package/dist/tools/readApexClasses.js

@@ -0,0 +1,83 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const readApexClassesTool = {
+    name: 'salesforce_read_apex_class',
+    description: 'Read Apex class source code or list classes by name pattern. Use exact className to get full source code, or namePattern with wildcards (* and ?) to list matching classes.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            className: {
+                type: 'string',
+                description: 'Exact class name to retrieve full source code.',
+            },
+            namePattern: {
+                type: 'string',
+                description: 'Pattern to match class names. * = multi-char wildcard, ? = single-char wildcard. Without wildcards, does substring match.',
+            },
+            includeMetadata: {
+                type: 'boolean',
+                description: 'Include API version, length, status, last modified date. Default: false.',
+            },
+        },
+    },
+};
+function convertPattern(pattern) {
+    if (pattern.includes('*') || pattern.includes('?')) {
+        return pattern.replace(/\*/g, '%').replace(/\?/g, '_');
+    }
+    return `%${pattern}%`;
+}
+export async function handleReadApexClasses(conn, args) {
+    const { className, namePattern, includeMetadata } = args;
+    try {
+        if (className) {
+            const result = await conn.tooling.query(`SELECT Id, Name, Body, ApiVersion, LengthWithoutComments, Status, LastModifiedDate FROM ApexClass WHERE Name = '${className.replace(/'/g, "\\'")}'`);
+            if (!result.records || result.records.length === 0) {
+                return toolResponse(`Apex class "${className}" not found.`);
+            }
+            const cls = result.records[0];
+            let output = `## ${cls.Name}\n\n`;
+            if (includeMetadata) {
+                output += `API Version: ${cls.ApiVersion} | Length: ${cls.LengthWithoutComments} | Status: ${cls.Status} | Last Modified: ${cls.LastModifiedDate}\n\n`;
+            }
+            output += '```apex\n' + cls.Body + '\n```';
+            return toolResponse(output);
+        }
+        // Pattern/list mode
+        let whereClause = '';
+        if (namePattern) {
+            const likePattern = convertPattern(namePattern);
+            whereClause = ` WHERE Name LIKE '${likePattern.replace(/'/g, "\\'")}'`;
+        }
+        const fields = includeMetadata
+            ? 'Id, Name, ApiVersion, LengthWithoutComments, Status, LastModifiedDate'
+            : 'Id, Name';
+        const result = await conn.tooling.query(`SELECT ${fields} FROM ApexClass${whereClause} ORDER BY Name LIMIT 200`);
+        if (!result.records || result.records.length === 0) {
+            return toolResponse(`No Apex classes found${namePattern ? ` matching "${namePattern}"` : ''}.`);
+        }
+        if (includeMetadata) {
+            const header = '| Name | API Version | Length | Status | Last Modified |';
+            const separator = '|------|-------------|--------|--------|---------------|';
+            const rows = result.records.map((r) => `| ${r.Name} | ${r.ApiVersion} | ${r.LengthWithoutComments} | ${r.Status} | ${r.LastModifiedDate} |`);
+            return toolResponse(`${result.records.length} class(es) found:\n\n${header}\n${separator}\n${rows.join('\n')}`);
+        }
+        const names = result.records.map((r) => r.Name);
+        return toolResponse(`${names.length} class(es) found:\n\n${names.join('\n')}`);
+    }
+    catch (error) {
+        return toolResponse(`Failed to read Apex classes: ${error.message}`, true);
+    }
+}
+export const readApexClassesSchema = {
+    className: z.string().describe('Exact class name to retrieve full source code.').optional(),
+    namePattern: z.string().describe('Pattern to match class names. * = multi-char wildcard, ? = single-char wildcard. Without wildcards, does substring match.').optional(),
+    includeMetadata: z.boolean().describe('Include API version, length, status, last modified date. Default: false.').optional(),
+};
+export const readApexClassesDescriptor = {
+    name: 'salesforce_read_apex_class',
+    description: readApexClassesTool.description,
+    schema: readApexClassesSchema,
+    handler: handleReadApexClasses,
+};
+//# sourceMappingURL=readApexClasses.js.map

package/dist/tools/readApexClasses.js.map

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

package/dist/tools/readApexTriggers.d.ts

@@ -0,0 +1,50 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const readApexTriggersTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            triggerName: {
+                type: string;
+                description: string;
+            };
+            namePattern: {
+                type: string;
+                description: string;
+            };
+            includeMetadata: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export interface ReadApexTriggersArgs {
+    triggerName?: string;
+    namePattern?: string;
+    includeMetadata?: boolean;
+}
+export declare function handleReadApexTriggers(conn: Connection, args: ReadApexTriggersArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const readApexTriggersSchema: {
+    triggerName: z.ZodOptional<z.ZodString>;
+    namePattern: z.ZodOptional<z.ZodString>;
+    includeMetadata: z.ZodOptional<z.ZodBoolean>;
+};
+export declare const readApexTriggersDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        triggerName: z.ZodOptional<z.ZodString>;
+        namePattern: z.ZodOptional<z.ZodString>;
+        includeMetadata: z.ZodOptional<z.ZodBoolean>;
+    };
+    handler: typeof handleReadApexTriggers;
+};