@acquis-consulting/asm 1.0.5

package/dist/tools/metadataDiffGeneratePackage.js

@@ -0,0 +1,122 @@
+import { z } from 'zod/v4';
+import { writeFileSync } from 'fs';
+import { join } from 'path';
+import { toolResponse } from '../utils/index.js';
+export const metadataDiffGeneratePackageTool = {
+    name: 'salesforce_generate_diff_package',
+    description: 'Generate package.xml from selected metadata components for deployment. ' +
+        'Used by the metadata diff UI to create a deployment manifest from user-selected components.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workingDir: {
+                type: 'string',
+                description: 'The working directory containing source/ and target/ subdirs from a metadata diff',
+            },
+            selectedComponents: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        metadataType: { type: 'string' },
+                        componentName: { type: 'string' },
+                    },
+                    required: ['metadataType', 'componentName'],
+                },
+                description: 'Components to include in the package.xml',
+            },
+            apiVersion: {
+                type: 'string',
+                description: 'Salesforce API version (default: 62.0)',
+            },
+        },
+        required: ['workingDir', 'selectedComponents'],
+    },
+};
+// Maps decomposed permission types back to their parent Metadata API type.
+// Selecting individual permissions still deploys the whole parent Profile/PermissionSet.
+const DECOMPOSED_PARENT_TYPES = {
+    ProfileFieldPermission: 'Profile', ProfileObjectPermission: 'Profile',
+    ProfileClassAccess: 'Profile', ProfilePageAccess: 'Profile',
+    ProfileRecordTypeVisibility: 'Profile', ProfileTabVisibility: 'Profile',
+    ProfileUserPermission: 'Profile', ProfileApplicationVisibility: 'Profile',
+    ProfileFlowAccess: 'Profile', ProfileLayoutAssignment: 'Profile',
+    ProfileCustomPermission: 'Profile',
+    PermissionSetFieldPermission: 'PermissionSet', PermissionSetObjectPermission: 'PermissionSet',
+    PermissionSetClassAccess: 'PermissionSet', PermissionSetPageAccess: 'PermissionSet',
+    PermissionSetRecordTypeVisibility: 'PermissionSet', PermissionSetTabVisibility: 'PermissionSet',
+    PermissionSetUserPermission: 'PermissionSet', PermissionSetApplicationVisibility: 'PermissionSet',
+    PermissionSetFlowAccess: 'PermissionSet', PermissionSetCustomPermission: 'PermissionSet',
+};
+export async function handleMetadataDiffGeneratePackage(args) {
+    const { workingDir, selectedComponents, apiVersion = '62.0' } = args;
+    if (!selectedComponents || selectedComponents.length === 0) {
+        return toolResponse('No components selected for package generation.', true);
+    }
+    // Group by metadata type, using Sets to deduplicate (important for decomposed types where
+    // multiple permissions from the same Profile/PermissionSet roll up to the same parent name)
+    const grouped = new Map();
+    for (const comp of selectedComponents) {
+        const parentType = DECOMPOSED_PARENT_TYPES[comp.metadataType];
+        if (parentType) {
+            // Roll up: extract parent name (e.g. "Admin/Account.Name" → "Admin")
+            const parentName = comp.componentName.split('/')[0];
+            if (!grouped.has(parentType))
+                grouped.set(parentType, new Set());
+            grouped.get(parentType).add(parentName);
+        }
+        else {
+            if (!grouped.has(comp.metadataType))
+                grouped.set(comp.metadataType, new Set());
+            grouped.get(comp.metadataType).add(comp.componentName);
+        }
+    }
+    // Build package.xml
+    const xmlLines = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<Package xmlns="http://soap.sforce.com/2006/04/metadata">',
+    ];
+    for (const [type, memberSet] of [...grouped].sort((a, b) => a[0].localeCompare(b[0]))) {
+        xmlLines.push('  <types>');
+        for (const member of [...memberSet].sort()) {
+            xmlLines.push(`    <members>${escapeXml(member)}</members>`);
+        }
+        xmlLines.push(`    <name>${escapeXml(type)}</name>`);
+        xmlLines.push('  </types>');
+    }
+    xmlLines.push(`  <version>${escapeXml(apiVersion)}</version>`);
+    xmlLines.push('</Package>');
+    const xml = xmlLines.join('\n');
+    const outputPath = join(workingDir, 'source', 'package.xml');
+    try {
+        writeFileSync(outputPath, xml, 'utf-8');
+    }
+    catch (err) {
+        return toolResponse(`Failed to write package.xml: ${err.message}`, true);
+    }
+    return toolResponse(`Package.xml written to ${outputPath}\n\n${xml}`);
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+export const metadataDiffGeneratePackageSchema = {
+    workingDir: z.string().describe('The working directory containing source/ and target/ subdirs from a metadata diff'),
+    selectedComponents: z.array(z.object({
+        metadataType: z.string().describe('Metadata API type name'),
+        componentName: z.string().describe('Component full name'),
+    })).describe('Components to include in the package.xml'),
+    apiVersion: z.string().describe('Salesforce API version (default: 62.0)').optional(),
+};
+export const metadataDiffGeneratePackageDescriptor = {
+    name: 'salesforce_generate_diff_package',
+    description: metadataDiffGeneratePackageTool.description,
+    schema: metadataDiffGeneratePackageSchema,
+    handler: handleMetadataDiffGeneratePackage,
+    noConnection: true,
+};
+//# sourceMappingURL=metadataDiffGeneratePackage.js.map

package/dist/tools/metadataDiffGeneratePackage.js.map

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

package/dist/tools/metadataImport.d.ts

@@ -0,0 +1,63 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const metadataImportTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            operation: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            metadataType: {
+                type: string;
+                description: string;
+            };
+            metadata: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface MetadataImportArgs {
+    operation: 'create' | 'update' | 'upsert';
+    metadataType: string;
+    metadata: Record<string, unknown>[];
+}
+export declare function handleMetadataImport(conn: Connection, args: MetadataImportArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const metadataImportSchema: {
+    operation: z.ZodEnum<{
+        update: "update";
+        upsert: "upsert";
+        create: "create";
+    }>;
+    metadataType: z.ZodString;
+    metadata: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+};
+export declare const metadataImportDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        operation: z.ZodEnum<{
+            update: "update";
+            upsert: "upsert";
+            create: "create";
+        }>;
+        metadataType: z.ZodString;
+        metadata: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    };
+    handler: typeof handleMetadataImport;
+};

package/dist/tools/metadataImport.js

@@ -0,0 +1,122 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const metadataImportTool = {
+    name: 'salesforce_metadata_import',
+    description: 'Create, update, or upsert Salesforce metadata components. Use salesforce_get_metadata_type_schema first to understand the required payload structure for the metadata type. Supports single or batch operations.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            operation: {
+                type: 'string',
+                enum: ['create', 'update', 'upsert'],
+                description: 'The operation to perform on the metadata components.',
+            },
+            metadataType: {
+                type: 'string',
+                description: 'The metadata type (e.g. "CustomObject", "ValidationRule", "Flow").',
+            },
+            metadata: {
+                type: 'array',
+                items: { type: 'object' },
+                description: 'Array of metadata payloads matching the type\'s schema. Each object must include fullName.',
+            },
+        },
+        required: ['operation', 'metadataType', 'metadata'],
+    },
+};
+function formatImportResults(operation, results) {
+    const successes = results.filter(r => r.success);
+    const failures = results.filter(r => !r.success);
+    const isUpsert = operation === 'upsert';
+    let createdCount = 0;
+    let updatedCount = 0;
+    if (isUpsert) {
+        for (const r of successes) {
+            if (r.created)
+                createdCount++;
+            else
+                updatedCount++;
+        }
+    }
+    const parts = [];
+    // Summary line
+    let summary = `${operation} results: ${successes.length} succeeded`;
+    if (isUpsert && successes.length > 0) {
+        summary += ` (${createdCount} created, ${updatedCount} updated)`;
+    }
+    summary += `, ${failures.length} failed`;
+    parts.push(summary);
+    // Successes
+    if (successes.length > 0) {
+        parts.push('\nSuccesses:');
+        for (const r of successes) {
+            let line = `  - ${r.fullName}`;
+            if (isUpsert) {
+                line += r.created ? ' (created)' : ' (updated)';
+            }
+            parts.push(line);
+        }
+    }
+    // Failures
+    if (failures.length > 0) {
+        parts.push('\nErrors:');
+        for (const r of failures) {
+            const errorDetails = formatResultErrors(r);
+            parts.push(`  - ${r.fullName}: ${errorDetails}`);
+        }
+    }
+    return parts.join('\n');
+}
+function formatResultErrors(result) {
+    if (!result.errors)
+        return 'Unknown error';
+    const errors = Array.isArray(result.errors) ? result.errors : [result.errors];
+    return errors.map((err) => {
+        if (typeof err === 'string')
+            return err;
+        const fields = err.fields ? ` (fields: ${Array.isArray(err.fields) ? err.fields.join(', ') : err.fields})` : '';
+        const code = err.statusCode ? `[${err.statusCode}] ` : '';
+        return `${code}${err.message || 'Unknown error'}${fields}`;
+    }).join('; ');
+}
+export async function handleMetadataImport(conn, args) {
+    const { operation, metadataType, metadata } = args;
+    if (!metadata || !Array.isArray(metadata) || metadata.length === 0) {
+        return toolResponse('metadata must be a non-empty array', true);
+    }
+    try {
+        let result;
+        switch (operation) {
+            case 'create':
+                result = await conn.metadata.create(metadataType, metadata);
+                break;
+            case 'update':
+                result = await conn.metadata.update(metadataType, metadata);
+                break;
+            case 'upsert':
+                result = await conn.metadata.upsert(metadataType, metadata);
+                break;
+            default:
+                return toolResponse(`Invalid operation: ${operation}. Must be create, update, or upsert.`, true);
+        }
+        const results = Array.isArray(result) ? result : [result];
+        const output = formatImportResults(operation, results);
+        const hasFailures = results.some(r => !r.success);
+        return toolResponse(output, hasFailures);
+    }
+    catch (error) {
+        return toolResponse(`Metadata ${operation} failed: ${error.message}`, true);
+    }
+}
+export const metadataImportSchema = {
+    operation: z.enum(['create', 'update', 'upsert']).describe('The operation to perform on the metadata components.'),
+    metadataType: z.string().describe('The metadata type (e.g. "CustomObject", "ValidationRule", "Flow").'),
+    metadata: z.array(z.record(z.string(), z.any())).describe('Array of metadata payloads matching the type\'s schema. Each object must include fullName.'),
+};
+export const metadataImportDescriptor = {
+    name: 'salesforce_metadata_import',
+    description: metadataImportTool.description,
+    schema: metadataImportSchema,
+    handler: handleMetadataImport,
+};
+//# sourceMappingURL=metadataImport.js.map

package/dist/tools/metadataImport.js.map

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

package/dist/tools/metadataJobStatus.d.ts

@@ -0,0 +1,44 @@
+import type { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const deployJobStatusTool: {
+    name: "salesforce_deploy_job_status";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            jobId: {
+                type: string;
+                description: string;
+            };
+            projectDir: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface DeployJobStatusArgs {
+    jobId: string;
+    projectDir: string;
+}
+export declare function handleDeployJobStatus(conn: Connection, args: DeployJobStatusArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const deployJobStatusSchema: {
+    jobId: z.ZodString;
+    projectDir: z.ZodString;
+};
+export declare const deployJobStatusDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        jobId: z.ZodString;
+        projectDir: z.ZodString;
+    };
+    handler: typeof handleDeployJobStatus;
+};

package/dist/tools/metadataJobStatus.js

@@ -0,0 +1,101 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+import { authenticateOrg, runSfCli, ensureSfCli, } from '../utils/sfCli.js';
+export const deployJobStatusTool = {
+    name: 'salesforce_deploy_job_status',
+    description: 'Check the status of an async metadata deploy job. ' +
+        'Use after salesforce_deploy_metadata returns a job ID.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            jobId: {
+                type: 'string',
+                description: 'The job ID returned by the deploy command',
+            },
+            projectDir: {
+                type: 'string',
+                description: 'The project directory from the original deploy command',
+            },
+        },
+        required: ['jobId', 'projectDir'],
+    },
+};
+export async function handleDeployJobStatus(conn, args) {
+    try {
+        await ensureSfCli();
+    }
+    catch (err) {
+        return toolResponse(err.message, true);
+    }
+    const { jobId, projectDir } = args;
+    // Authenticate the org
+    let alias;
+    try {
+        alias = await authenticateOrg(conn);
+    }
+    catch (err) {
+        return toolResponse(`Authentication failed: ${err.message}`, true);
+    }
+    // Build report command
+    const cliArgs = [
+        'project', 'deploy', 'report',
+        '--job-id', jobId,
+        '--target-org', alias,
+        '--json',
+    ];
+    const result = await runSfCli(cliArgs, { timeout: 60 * 1000, cwd: projectDir });
+    const json = result.jsonOutput;
+    const status = json?.result?.status || json?.status;
+    // Terminal success
+    if (status === 'Succeeded' || status === 'SucceededPartial') {
+        const deployed = json?.result?.files || json?.result?.details?.componentSuccesses || [];
+        const deployedCount = Array.isArray(deployed) ? deployed.length : 0;
+        const testResults = json?.result?.details?.runTestResult;
+        const lines = [
+            `Deploy ${status === 'SucceededPartial' ? 'partially completed' : 'completed successfully'}.`,
+            `Status: ${status}`,
+            `Components deployed: ${deployedCount}`,
+        ];
+        if (testResults) {
+            const passed = testResults.numTestsRun ?? 0;
+            const failed = testResults.numFailures ?? 0;
+            lines.push(`Tests run: ${passed}, Failures: ${failed}`);
+        }
+        return toolResponse(lines.join('\n'));
+    }
+    // Terminal failure
+    if (status === 'Failed') {
+        const lines = [`Deploy failed.`, `Status: ${status}`];
+        const failures = json?.result?.details?.componentFailures;
+        if (Array.isArray(failures) && failures.length > 0) {
+            lines.push('', 'Component failures:');
+            for (const f of failures.slice(0, 50)) {
+                lines.push(`  ${f.componentType}/${f.fullName}: ${f.problem}`);
+            }
+        }
+        const testFailures = json?.result?.details?.runTestResult?.failures;
+        if (Array.isArray(testFailures) && testFailures.length > 0) {
+            lines.push('', 'Test failures:');
+            for (const t of testFailures.slice(0, 50)) {
+                lines.push(`  ${t.name}.${t.methodName}: ${t.message}`);
+            }
+        }
+        if (lines.length === 2) {
+            lines.push(json?.result?.message || json?.message || result.stderr || 'Unknown error');
+        }
+        return toolResponse(lines.join('\n'), true);
+    }
+    // Still in progress
+    return toolResponse(`Deploy in progress.\nStatus: ${status || 'Unknown'}\n\nPoll again with salesforce_deploy_job_status to check progress.`);
+}
+export const deployJobStatusSchema = {
+    jobId: z.string().describe('The job ID returned by the deploy command'),
+    projectDir: z.string().describe('The project directory from the original deploy command'),
+};
+export const deployJobStatusDescriptor = {
+    name: 'salesforce_deploy_job_status',
+    description: deployJobStatusTool.description,
+    schema: deployJobStatusSchema,
+    handler: handleDeployJobStatus,
+};
+//# sourceMappingURL=metadataJobStatus.js.map

package/dist/tools/metadataJobStatus.js.map

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

package/dist/tools/metadataList.d.ts

@@ -0,0 +1,44 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const metadataListTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            metadataType: {
+                type: string;
+                description: string;
+            };
+            folder: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface MetadataListArgs {
+    metadataType: string;
+    folder?: string;
+}
+export declare function handleMetadataList(conn: Connection, args: MetadataListArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const metadataListSchema: {
+    metadataType: z.ZodString;
+    folder: z.ZodOptional<z.ZodString>;
+};
+export declare const metadataListDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        metadataType: z.ZodString;
+        folder: z.ZodOptional<z.ZodString>;
+    };
+    handler: typeof handleMetadataList;
+};

package/dist/tools/metadataList.js

@@ -0,0 +1,49 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const metadataListTool = {
+    name: 'salesforce_list_metadata',
+    description: 'List metadata components of a given type in the Salesforce org. Useful for org analysis — discover all validation rules, flows, approval processes, custom labels, triggers, and more. Returns summary info (fullName, id, dates) for every component of the requested type.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            metadataType: {
+                type: 'string',
+                description: 'The metadata type to list (e.g. "ValidationRule", "Flow", "ApexClass").',
+            },
+            folder: {
+                type: 'string',
+                description: 'Folder name, required for folder-based types like Report, Dashboard, EmailTemplate.',
+            },
+        },
+        required: ['metadataType'],
+    },
+};
+export async function handleMetadataList(conn, args) {
+    const { metadataType, folder } = args;
+    try {
+        const query = { type: metadataType };
+        if (folder) {
+            query.folder = folder;
+        }
+        const results = await conn.metadata.list([query], conn.version);
+        const items = Array.isArray(results) ? results : results ? [results] : [];
+        if (items.length === 0) {
+            return toolResponse(`No metadata components found for type: ${metadataType}`);
+        }
+        return toolResponse(`${items.length} component(s) found for type ${metadataType}:\n\n${JSON.stringify(items, null, 2)}`);
+    }
+    catch (error) {
+        return toolResponse(`Metadata list failed: ${error.message}`, true);
+    }
+}
+export const metadataListSchema = {
+    metadataType: z.string().describe('The metadata type to list (e.g. "ValidationRule", "Flow", "ApexClass").'),
+    folder: z.string().describe('Folder name, required for folder-based types like Report, Dashboard, EmailTemplate.').optional(),
+};
+export const metadataListDescriptor = {
+    name: 'salesforce_list_metadata',
+    description: metadataListTool.description,
+    schema: metadataListSchema,
+    handler: handleMetadataList,
+};
+//# sourceMappingURL=metadataList.js.map

package/dist/tools/metadataList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataList.js","sourceRoot":"","sources":["../../src/tools/metadataList.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,0BAA0B;IAChC,WAAW,EAAE,8QAA8Q;IAC3R,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yEAAyE;aACvF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qFAAqF;aACnG;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,CAAC;KAC3B;CACF,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAgB,EAAE,IAAsB;IAC/E,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEtC,IAAI,CAAC;QACH,MAAM,KAAK,GAAsC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QACxE,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACxB,CAAC;QAED,MAAM,OAAO,GAAG,MAAO,IAAY,CAAC,QAAQ,CAAC,IAAI,CAC/C,CAAC,KAAK,CAAC,EACN,IAAY,CAAC,OAAO,CACtB,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,YAAY,CAAC,0CAA0C,YAAY,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,YAAY,CACjB,GAAG,KAAK,CAAC,MAAM,gCAAgC,YAAY,QAAQ,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACpG,CAAC;IACJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC,yBAAyB,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;IAC5G,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC,CAAC,QAAQ,EAAE;CAC9H,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,gBAAgB,CAAC,WAAW;IACzC,MAAM,EAAE,kBAAkB;IAC1B,OAAO,EAAE,kBAAkB;CAC5B,CAAC"}

package/dist/tools/metadataRead.d.ts

@@ -0,0 +1,47 @@
+import { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const metadataReadTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            metadataType: {
+                type: string;
+                description: string;
+            };
+            fullNames: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface MetadataReadArgs {
+    metadataType: string;
+    fullNames: string[];
+}
+export declare function handleMetadataRead(conn: Connection, args: MetadataReadArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const metadataReadSchema: {
+    metadataType: z.ZodString;
+    fullNames: z.ZodArray<z.ZodString>;
+};
+export declare const metadataReadDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        metadataType: z.ZodString;
+        fullNames: z.ZodArray<z.ZodString>;
+    };
+    handler: typeof handleMetadataRead;
+};