@acquis-consulting/asm 1.0.5

package/dist/tools/deployMetadata.d.ts

@@ -0,0 +1,60 @@
+import type { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const deployMetadataTool: {
+    name: "salesforce_deploy_metadata";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            sourceDir: {
+                type: string;
+                description: string;
+            };
+            dryRun: {
+                type: string;
+                description: string;
+            };
+            testLevel: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface DeployMetadataArgs {
+    sourceDir: string;
+    dryRun?: boolean;
+    testLevel?: 'NoTestRun' | 'RunLocalTests' | 'RunAllTestsInOrg';
+}
+export declare function handleDeployMetadata(conn: Connection, args: DeployMetadataArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const deployMetadataSchema: {
+    sourceDir: z.ZodString;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    testLevel: z.ZodOptional<z.ZodEnum<{
+        NoTestRun: "NoTestRun";
+        RunLocalTests: "RunLocalTests";
+        RunAllTestsInOrg: "RunAllTestsInOrg";
+    }>>;
+};
+export declare const deployMetadataDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        sourceDir: z.ZodString;
+        dryRun: z.ZodOptional<z.ZodBoolean>;
+        testLevel: z.ZodOptional<z.ZodEnum<{
+            NoTestRun: "NoTestRun";
+            RunLocalTests: "RunLocalTests";
+            RunAllTestsInOrg: "RunAllTestsInOrg";
+        }>>;
+    };
+    handler: typeof handleDeployMetadata;
+};

package/dist/tools/deployMetadata.js

@@ -0,0 +1,106 @@
+import { z } from 'zod/v4';
+import { existsSync, statSync } from 'fs';
+import { toolResponse } from '../utils/index.js';
+import { authenticateOrg, runSfCli, ensureSfCli, createSfdxProjectJson, resolveBaseOutputDir, createJobDir } from '../utils/sfCli.js';
+export const deployMetadataTool = {
+    name: 'salesforce_deploy_metadata',
+    description: 'Deploy Salesforce metadata from a local DX source directory using the sf CLI (async). ' +
+        'Returns a job ID immediately — use salesforce_deploy_job_status to poll progress and get results. ' +
+        'Use after retrieving and modifying metadata with salesforce_retrieve_metadata. ' +
+        'Requires the Salesforce CLI (sf) to be installed.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            sourceDir: {
+                type: 'string',
+                description: 'Path to the DX source directory to deploy (from a previous retrieve)',
+            },
+            dryRun: {
+                type: 'boolean',
+                description: 'If true, performs validation-only deploy without making changes (default: false)',
+            },
+            testLevel: {
+                type: 'string',
+                enum: ['NoTestRun', 'RunLocalTests', 'RunAllTestsInOrg'],
+                description: 'Test level for the deployment (default: NoTestRun)',
+            },
+        },
+        required: ['sourceDir'],
+    },
+};
+export async function handleDeployMetadata(conn, args) {
+    try {
+        await ensureSfCli();
+    }
+    catch (err) {
+        return toolResponse(err.message, true);
+    }
+    const { sourceDir, dryRun = false, testLevel = 'NoTestRun' } = args;
+    // Validate sourceDir
+    if (!existsSync(sourceDir)) {
+        return toolResponse(`Source directory does not exist: ${sourceDir}`, true);
+    }
+    if (!statSync(sourceDir).isDirectory()) {
+        return toolResponse(`Path is not a directory: ${sourceDir}`, true);
+    }
+    // Authenticate the org
+    let alias;
+    try {
+        alias = await authenticateOrg(conn);
+    }
+    catch (err) {
+        return toolResponse(`Authentication failed: ${err.message}`, true);
+    }
+    // Create a temp project context for sf CLI
+    let projectDir;
+    try {
+        projectDir = createJobDir(resolveBaseOutputDir());
+        createSfdxProjectJson(projectDir);
+    }
+    catch (err) {
+        return toolResponse(`Failed to create project directory: ${err.message}`, true);
+    }
+    // Build deploy command (async mode)
+    const cliArgs = [
+        'project', 'deploy', 'start',
+        '--source-dir', sourceDir,
+        '--target-org', alias,
+        '--test-level', testLevel,
+        '--async',
+        '--json',
+    ];
+    if (dryRun) {
+        cliArgs.push('--dry-run');
+    }
+    const result = await runSfCli(cliArgs, { timeout: 60 * 1000, cwd: projectDir });
+    if (result.exitCode !== 0) {
+        const msg = result.jsonOutput?.message || result.stderr || 'Unknown error';
+        return toolResponse(`Deploy failed (exit ${result.exitCode}): ${msg}`, true);
+    }
+    const jobId = result.jsonOutput?.result?.id;
+    if (!jobId) {
+        return toolResponse('Deploy started but no job ID was returned. Raw output: ' + result.stdout, true);
+    }
+    const summary = [
+        `Deploy started (async).`,
+        `Job ID: ${jobId}`,
+        `Project directory: ${projectDir}`,
+        '',
+        'Use salesforce_deploy_job_status every 5 seconds with:',
+        `  jobId: "${jobId}"`,
+        `  projectDir: "${projectDir}"`,
+    ].join('\n');
+    return toolResponse(summary);
+}
+export const deployMetadataSchema = {
+    sourceDir: z.string().describe('Path to the DX source directory to deploy (from a previous retrieve)'),
+    dryRun: z.boolean().describe('If true, performs validation-only deploy without making changes (default: false)').optional(),
+    testLevel: z.enum(['NoTestRun', 'RunLocalTests', 'RunAllTestsInOrg']).describe('Test level for the deployment (default: NoTestRun)').optional(),
+};
+export const deployMetadataDescriptor = {
+    name: 'salesforce_deploy_metadata',
+    description: deployMetadataTool.description,
+    schema: deployMetadataSchema,
+    handler: handleDeployMetadata,
+};
+//# sourceMappingURL=deployMetadata.js.map

package/dist/tools/deployMetadata.js.map

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

package/dist/tools/deployPackage.d.ts

@@ -0,0 +1,49 @@
+import type { Connection } from 'jsforce';
+export declare const deployPackageTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            packageDirectory: {
+                type: string;
+                description: string;
+            };
+            checkOnly: {
+                type: string;
+                description: string;
+            };
+            testLevel: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            runTests: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            rollbackOnError: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface DeployPackageArgs {
+    packageDirectory: string;
+    checkOnly?: boolean;
+    testLevel?: 'NoTestRun' | 'RunSpecifiedTests' | 'RunLocalTests' | 'RunAllTestsInOrg';
+    runTests?: string[];
+    rollbackOnError?: boolean;
+}
+export declare function handleDeployPackage(conn: Connection, args: DeployPackageArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/dist/tools/deployPackage.js

@@ -0,0 +1 @@
+import{readdir as e,readFile as t,stat as a}from"node:fs/promises";import{join as o,relative as n}from"node:path";import{toolResponse as s}from"../utils/index.js";import{registerJob as r}from"../utils/packageJobs.js";export const deployPackageTool={name:"salesforce_deploy_package",description:"Start an asynchronous metadata deploy from a local directory containing package.xml and metadata files. Returns a job ID immediately — use salesforce_package_status to poll for completion. Defaults to checkOnly (validation-only) for safety. Switch orgs via salesforce_select_org before deploying to a different org.",inputSchema:{type:"object",properties:{packageDirectory:{type:"string",description:"Absolute path to the directory containing package.xml and metadata files."},checkOnly:{type:"boolean",description:"If true (default), performs a validation-only deploy without committing changes. Set to false for an actual deploy."},testLevel:{type:"string",enum:["NoTestRun","RunSpecifiedTests","RunLocalTests","RunAllTestsInOrg"],description:"Test level for the deployment. Default varies by org type."},runTests:{type:"array",items:{type:"string"},description:"Specific test class names to run (only used with testLevel: RunSpecifiedTests)."},rollbackOnError:{type:"boolean",description:"If true (default), rolls back all components on any error."}},required:["packageDirectory"]}};async function i(a,s,r){const l=await e(s,{withFileTypes:!0});for(const e of l){const l=o(s,e.name),c=n(r,l);if(e.isDirectory())await i(a,l,r);else{const e=await t(l);a.file(c,e)}}}export async function handleDeployPackage(e,t){const{packageDirectory:n,checkOnly:l=!0,testLevel:c,runTests:p,rollbackOnError:d=!0}=t;try{const t=o(n,"package.xml");try{await a(t)}catch{return s(`package.xml not found in ${n}. The directory must contain a valid package.xml file.`,!0)}const y=new(0,(await import("jszip")).default);await i(y,n,n);const f=await y.generateAsync({type:"nodebuffer"}),u={checkOnly:l,rollbackOnError:d,singlePackage:!0};c&&(u.testLevel=c),p&&p.length>0&&(u.runTests=p);const m=(await e.metadata.deploy(f,u)).id;return m?(r({type:"deploy",id:m,conn:e,startedAt:Date.now()}),s(`Metadata deploy started.\n\nJob ID: ${m}\nMode: ${l?"Validation only (checkOnly)":"ACTUAL DEPLOY"}\nSource: ${n}\nRollback on error: ${d}\n`+(c?`Test level: ${c}\n`:"")+(p?.length?`Run tests: ${p.join(", ")}\n`:"")+`\nNext step: Use salesforce_package_status with jobId "${m}" to check progress.`)):s("Deploy request did not return a job ID.",!0)}catch(e){return s(`Failed to start metadata deploy: ${e.message}`,!0)}}

package/dist/tools/dml.d.ts

@@ -0,0 +1,70 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const dmlTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            operation: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            objectName: {
+                type: string;
+                description: string;
+            };
+            records: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            externalIdField: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface DmlArgs {
+    operation: 'insert' | 'update' | 'upsert';
+    objectName: string;
+    records: Record<string, any>[];
+    externalIdField?: string;
+}
+export declare function handleDml(conn: Connection, args: DmlArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const dmlSchema: {
+    operation: z.ZodEnum<{
+        insert: "insert";
+        update: "update";
+        upsert: "upsert";
+    }>;
+    objectName: z.ZodString;
+    records: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    externalIdField: z.ZodOptional<z.ZodString>;
+};
+export declare const dmlDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        operation: z.ZodEnum<{
+            insert: "insert";
+            update: "update";
+            upsert: "upsert";
+        }>;
+        objectName: z.ZodString;
+        records: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        externalIdField: z.ZodOptional<z.ZodString>;
+    };
+    handler: typeof handleDml;
+};

package/dist/tools/dml.js

@@ -0,0 +1,105 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const dmlTool = {
+    name: 'salesforce_dml',
+    description: 'Insert, update, or upsert Salesforce records. For upsert, provide the externalIdField parameter.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['insert', 'update', 'upsert'],
+                description: 'The DML operation to perform.',
+            },
+            objectName: {
+                type: 'string',
+                description: 'The Salesforce object API name.',
+            },
+            records: {
+                type: 'array',
+                items: { type: 'object' },
+                description: 'Array of record objects. For update, include "Id" field. For upsert, include the external ID field.',
+            },
+            externalIdField: {
+                type: 'string',
+                description: 'Required for upsert. The external ID field API name.',
+            },
+        },
+        required: ['operation', 'objectName', 'records'],
+    },
+};
+function formatDmlResults(results, operation) {
+    const resultArray = Array.isArray(results) ? results : [results];
+    let successCount = 0;
+    let failureCount = 0;
+    const errors = [];
+    for (let i = 0; i < resultArray.length; i++) {
+        const r = resultArray[i];
+        if (r.success) {
+            successCount++;
+        }
+        else {
+            failureCount++;
+            const errList = Array.isArray(r.errors) ? r.errors : [r.errors];
+            for (const err of errList) {
+                if (err) {
+                    const fields = err.fields ? ` (fields: ${Array.isArray(err.fields) ? err.fields.join(', ') : err.fields})` : '';
+                    errors.push(`Record ${i + 1}: [${err.statusCode || 'ERROR'}] ${err.message}${fields}`);
+                }
+            }
+        }
+    }
+    let msg = `${operation} results: ${successCount} succeeded, ${failureCount} failed`;
+    if (operation === 'insert' || operation === 'upsert') {
+        const ids = resultArray.filter(r => r.success && r.id).map(r => r.id);
+        if (ids.length > 0)
+            msg += `\nCreated/Updated IDs: ${ids.join(', ')}`;
+    }
+    if (errors.length > 0) {
+        msg += `\n\nErrors:\n${errors.join('\n')}`;
+    }
+    return msg;
+}
+export async function handleDml(conn, args) {
+    const { operation, objectName, records, externalIdField } = args;
+    if (records.length === 0) {
+        return toolResponse('No records provided.', true);
+    }
+    try {
+        let results;
+        const sobj = conn.sobject(objectName);
+        switch (operation) {
+            case 'insert':
+                results = await sobj.create(records);
+                break;
+            case 'update':
+                results = await sobj.update(records);
+                break;
+            case 'upsert':
+                if (!externalIdField) {
+                    return toolResponse('Upsert requires "externalIdField" parameter.', true);
+                }
+                results = await sobj.upsert(records, externalIdField);
+                break;
+        }
+        const msg = formatDmlResults(results, operation);
+        const hasFailures = msg.includes('Errors:');
+        return toolResponse(msg, hasFailures);
+    }
+    catch (error) {
+        return toolResponse(`DML ${operation} failed: ${error.message}`, true);
+    }
+}
+export const dmlSchema = {
+    operation: z.enum(['insert', 'update', 'upsert']).describe('The DML operation to perform.'),
+    objectName: z.string().describe('The Salesforce object API name.'),
+    records: z.array(z.record(z.string(), z.any())).describe('Array of record objects. For update, include "Id" field. For upsert, include the external ID field.'),
+    externalIdField: z.string().describe('Required for upsert. The external ID field API name.').optional(),
+};
+export const dmlDescriptor = {
+    name: 'salesforce_dml',
+    description: dmlTool.description,
+    schema: dmlSchema,
+    handler: handleDml,
+};
+//# sourceMappingURL=dml.js.map

package/dist/tools/dml.js.map

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

package/dist/tools/dmlDelete.d.ts

@@ -0,0 +1,51 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const dmlDeleteTool: {
+    name: string;
+    description: string;
+    annotations: {
+        destructiveHint: boolean;
+        readOnlyHint: boolean;
+    };
+    inputSchema: {
+        type: "object";
+        properties: {
+            objectName: {
+                type: string;
+                description: string;
+            };
+            recordIds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface DmlDeleteArgs {
+    objectName: string;
+    recordIds: string[];
+}
+export declare function handleDmlDelete(conn: Connection, args: DmlDeleteArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const dmlDeleteSchema: {
+    objectName: z.ZodString;
+    recordIds: z.ZodArray<z.ZodString>;
+};
+export declare const dmlDeleteDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        objectName: z.ZodString;
+        recordIds: z.ZodArray<z.ZodString>;
+    };
+    handler: typeof handleDmlDelete;
+};

package/dist/tools/dmlDelete.js

@@ -0,0 +1,71 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const dmlDeleteTool = {
+    name: 'salesforce_delete_records',
+    description: 'Delete Salesforce records by their IDs. This is a destructive operation.',
+    annotations: { destructiveHint: true, readOnlyHint: false },
+    inputSchema: {
+        type: 'object',
+        properties: {
+            objectName: {
+                type: 'string',
+                description: 'The Salesforce object API name.',
+            },
+            recordIds: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of record IDs to delete.',
+            },
+        },
+        required: ['objectName', 'recordIds'],
+    },
+};
+export async function handleDmlDelete(conn, args) {
+    const { objectName, recordIds } = args;
+    if (recordIds.length === 0) {
+        return toolResponse('No record IDs provided.', true);
+    }
+    try {
+        const results = await conn.sobject(objectName).destroy(recordIds);
+        const resultArray = Array.isArray(results) ? results : [results];
+        let successCount = 0;
+        let failureCount = 0;
+        const errors = [];
+        for (let i = 0; i < resultArray.length; i++) {
+            const r = resultArray[i];
+            if (r.success) {
+                successCount++;
+            }
+            else {
+                failureCount++;
+                const errList = Array.isArray(r.errors) ? r.errors : [r.errors];
+                for (const err of errList) {
+                    if (err) {
+                        const fields = err.fields ? ` (fields: ${Array.isArray(err.fields) ? err.fields.join(', ') : err.fields})` : '';
+                        errors.push(`Record ${i + 1}: [${err.statusCode || 'ERROR'}] ${err.message}${fields}`);
+                    }
+                }
+            }
+        }
+        let msg = `delete results: ${successCount} succeeded, ${failureCount} failed`;
+        if (errors.length > 0) {
+            msg += `\n\nErrors:\n${errors.join('\n')}`;
+        }
+        const hasFailures = errors.length > 0;
+        return toolResponse(msg, hasFailures);
+    }
+    catch (error) {
+        return toolResponse(`DML delete failed: ${error.message}`, true);
+    }
+}
+export const dmlDeleteSchema = {
+    objectName: z.string().describe('The Salesforce object API name.'),
+    recordIds: z.array(z.string()).describe('Array of record IDs to delete.'),
+};
+export const dmlDeleteDescriptor = {
+    name: 'salesforce_delete_records',
+    description: dmlDeleteTool.description,
+    schema: dmlDeleteSchema,
+    handler: handleDmlDelete,
+};
+//# sourceMappingURL=dmlDelete.js.map

package/dist/tools/dmlDelete.js.map

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

package/dist/tools/executeAnonymous.d.ts

@@ -0,0 +1,63 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const executeAnonymousTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            apexCode: {
+                type: string;
+                description: string;
+            };
+            logLevel: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface ExecuteAnonymousArgs {
+    apexCode: string;
+    logLevel?: string;
+}
+export declare function handleExecuteAnonymous(conn: Connection, args: ExecuteAnonymousArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const executeAnonymousSchema: {
+    apexCode: z.ZodString;
+    logLevel: z.ZodOptional<z.ZodEnum<{
+        ERROR: "ERROR";
+        NONE: "NONE";
+        WARN: "WARN";
+        INFO: "INFO";
+        DEBUG: "DEBUG";
+        FINE: "FINE";
+        FINER: "FINER";
+        FINEST: "FINEST";
+    }>>;
+};
+export declare const executeAnonymousDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        apexCode: z.ZodString;
+        logLevel: z.ZodOptional<z.ZodEnum<{
+            ERROR: "ERROR";
+            NONE: "NONE";
+            WARN: "WARN";
+            INFO: "INFO";
+            DEBUG: "DEBUG";
+            FINE: "FINE";
+            FINER: "FINER";
+            FINEST: "FINEST";
+        }>>;
+    };
+    handler: typeof handleExecuteAnonymous;
+};