@acquis-consulting/asm 1.0.5

package/dist/tools/retrieveMetadata.d.ts

@@ -0,0 +1,79 @@
+import type { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const retrieveMetadataTool: {
+    name: "salesforce_retrieve_metadata";
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            metadata: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            packageNames: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            outputDir: {
+                type: string;
+                description: string;
+            };
+            targetFolderId: {
+                type: string;
+                description: string;
+            };
+            tag: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export interface RetrieveMetadataArgs {
+    metadata?: string[];
+    packageNames?: string[];
+    outputDir?: string;
+    targetFolderId?: string;
+    tag?: 'source' | 'target';
+}
+export declare function walkDir(dir: string): string[];
+export declare function handleRetrieveMetadata(conn: Connection, args: RetrieveMetadataArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const retrieveMetadataSchema: {
+    metadata: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    packageNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    targetFolderId: z.ZodOptional<z.ZodString>;
+    tag: z.ZodDefault<z.ZodEnum<{
+        source: "source";
+        target: "target";
+    }>>;
+};
+export declare const retrieveMetadataDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        metadata: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        packageNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        outputDir: z.ZodOptional<z.ZodString>;
+        targetFolderId: z.ZodOptional<z.ZodString>;
+        tag: z.ZodDefault<z.ZodEnum<{
+            source: "source";
+            target: "target";
+        }>>;
+    };
+    handler: typeof handleRetrieveMetadata;
+};

package/dist/tools/retrieveMetadata.js

@@ -0,0 +1,225 @@
+import { z } from 'zod/v4';
+import { readdirSync, openSync, readFileSync, existsSync, writeFileSync } from 'fs';
+import { mkdirSync } from 'fs';
+import { spawn } from 'child_process';
+import { join, isAbsolute } from 'path';
+import { toolResponse } from '../utils/index.js';
+import { resolveBaseOutputDir, createJobDir, createSfdxProjectJson, authenticateOrg, ensureSfCli, runSfCli, } from '../utils/sfCli.js';
+export const retrieveMetadataTool = {
+    name: 'salesforce_retrieve_metadata',
+    description: 'Retrieve Salesforce metadata in DX source format using the sf CLI (async background process). ' +
+        'Returns immediately with an output directory path — use salesforce_retrieve_job_status to poll progress. ' +
+        'Ideal for Profiles, Permission Sets, Custom Objects, etc. ' +
+        'Use tag="target" for the baseline org and tag="source" for the org to compare against. ' +
+        'To refresh metadata already in an existing directory, pass only targetFolderId (no metadata or packageNames) — only the exact components tracked locally will be retrieved. ' +
+        'Requires the Salesforce CLI (sf) to be installed.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            metadata: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Metadata components to retrieve, e.g. ["Profile:Admin", "PermissionSet:*", "CustomObject:Account"]',
+            },
+            packageNames: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Named packages to retrieve',
+            },
+            outputDir: {
+                type: 'string',
+                description: 'Override output directory (defaults to SALESFORCE_EXPORT_DIR or system temp)',
+            },
+            targetFolderId: {
+                type: 'string',
+                description: 'The output directory path from a previous retrieve (the "Output directory" value). When provided, files are written to the same directory instead of creating a new one. Pass targetFolderId alone (without metadata or packageNames) to refresh all metadata already in that directory.',
+            },
+            tag: {
+                type: 'string',
+                enum: ['source', 'target'],
+                description: 'Tag for the retrieve subfolder. Use "target" for baseline org, "source" for comparison org. Defaults to "source".',
+            },
+        },
+        required: [],
+    },
+};
+export function walkDir(dir) {
+    const files = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...walkDir(full));
+        }
+        else {
+            files.push(full);
+        }
+    }
+    return files;
+}
+export async function handleRetrieveMetadata(conn, args) {
+    try {
+        await ensureSfCli();
+    }
+    catch (err) {
+        return toolResponse(err.message, true);
+    }
+    const { metadata, packageNames, outputDir, targetFolderId, tag = 'source' } = args;
+    const isRefresh = !!targetFolderId &&
+        (!metadata || metadata.length === 0) &&
+        (!packageNames || packageNames.length === 0);
+    if (!isRefresh && (!metadata || metadata.length === 0) && (!packageNames || packageNames.length === 0)) {
+        return toolResponse('At least one of "metadata" or "packageNames" must be provided.', true);
+    }
+    // Set up job directory (UUID-level) and tagged subfolder
+    const baseDir = outputDir || resolveBaseOutputDir();
+    let jobDir;
+    try {
+        if (targetFolderId) {
+            jobDir = isAbsolute(targetFolderId) ? targetFolderId : join(baseDir, targetFolderId);
+            mkdirSync(jobDir, { recursive: true });
+        }
+        else {
+            jobDir = createJobDir(baseDir);
+        }
+    }
+    catch (err) {
+        return toolResponse(`Failed to create output directory: ${err.message}`, true);
+    }
+    // Create the tagged subfolder (source/ or target/) and its .metadata-diff/ subdir
+    const taggedDir = join(jobDir, tag);
+    try {
+        mkdirSync(taggedDir, { recursive: true });
+        mkdirSync(join(taggedDir, '.metadata-diff'), { recursive: true });
+    }
+    catch (err) {
+        return toolResponse(`Failed to create tagged subfolder: ${err.message}`, true);
+    }
+    // Write .gitignore so the per-tag git repo ignores operational files
+    try {
+        const gitignorePath = join(taggedDir, '.gitignore');
+        if (!existsSync(gitignorePath)) {
+            writeFileSync(gitignorePath, '.metadata-diff/\n', 'utf-8');
+        }
+    }
+    catch { /* best-effort */ }
+    // For refresh, verify sfdx-project.json already exists in tagged subfolder; otherwise create it
+    if (isRefresh) {
+        if (!existsSync(join(taggedDir, 'sfdx-project.json'))) {
+            return toolResponse('Cannot refresh: no sfdx-project.json found in the target directory. ' +
+                'This directory does not appear to contain a previous retrieve.', true);
+        }
+    }
+    else {
+        // sf requires a project context
+        createSfdxProjectJson(taggedDir);
+    }
+    // Authenticate the org
+    let alias;
+    try {
+        alias = await authenticateOrg(conn);
+    }
+    catch (err) {
+        return toolResponse(`Authentication failed: ${err.message}`, true);
+    }
+    // Persist org identity info (best-effort)
+    try {
+        const identity = await conn.identity();
+        const orgInfo = {
+            instanceUrl: conn.instanceUrl,
+            orgId: identity.organization_id,
+            username: identity.username,
+            apiVersion: conn.version,
+            retrievedAt: new Date().toISOString(),
+        };
+        writeFileSync(join(taggedDir, '.metadata-diff', 'org-info.json'), JSON.stringify(orgInfo, null, 2), 'utf-8');
+    }
+    catch { /* best-effort — don't fail the retrieve */ }
+    // Build retrieve command
+    const cliArgs = [
+        'project', 'retrieve', 'start',
+        '--target-org', alias,
+        '--json',
+    ];
+    if (isRefresh) {
+        const projectJson = JSON.parse(readFileSync(join(taggedDir, 'sfdx-project.json'), 'utf-8'));
+        const srcPath = projectJson?.packageDirectories?.[0]?.path || '.';
+        const resolvedSourceDir = join(taggedDir, srcPath);
+        // Generate manifest scoped to only local components
+        const manifestResult = await runSfCli([
+            'project', 'generate', 'manifest',
+            '--source-dir', resolvedSourceDir,
+            '--name', 'package.xml',
+            '--output-dir', taggedDir,
+        ], { cwd: taggedDir });
+        if (manifestResult.exitCode !== 0) {
+            const msg = manifestResult.jsonOutput?.message || manifestResult.stderr || 'Unknown error';
+            return toolResponse(`Failed to generate manifest for refresh: ${msg}`, true);
+        }
+        const manifestPath = join(taggedDir, 'package.xml');
+        if (!existsSync(manifestPath)) {
+            return toolResponse('Failed to generate package.xml manifest from local source.', true);
+        }
+        cliArgs.push('--manifest', manifestPath);
+    }
+    else {
+        if (metadata && metadata.length > 0) {
+            for (const m of metadata) {
+                cliArgs.push('--metadata', m);
+            }
+        }
+        if (packageNames && packageNames.length > 0) {
+            for (const pkg of packageNames) {
+                cliArgs.push('--package-name', pkg);
+            }
+        }
+    }
+    // Spawn detached — writes results to files in tagged subfolder, returns immediately
+    const ts = Date.now();
+    const stdoutFd = openSync(join(taggedDir, '.metadata-diff', `.retrieve-result-${ts}.json`), 'w');
+    const stderrFd = openSync(join(taggedDir, '.metadata-diff', `.retrieve-log-${ts}.txt`), 'w');
+    const child = spawn('sf', cliArgs, {
+        stdio: ['ignore', stdoutFd, stderrFd],
+        detached: true,
+        cwd: taggedDir,
+    });
+    child.unref();
+    // Return immediately
+    const nextStep = tag === 'target'
+        ? [
+            `Next: retrieve source org metadata with:`,
+            `  salesforce_retrieve_metadata with tag: "source", targetFolderId: "${jobDir}"`,
+        ]
+        : [
+            `Next: run salesforce_metadata_diff with:`,
+            `  workingDir: "${jobDir}"`,
+        ];
+    const summary = [
+        `Retrieve started (background) into ${tag}/ subfolder.`,
+        `Output directory: ${jobDir}`,
+        `Tagged subfolder: ${taggedDir}`,
+        '',
+        'Use salesforce_retrieve_job_status every 5-10 seconds with:',
+        `  jobDir: "${jobDir}"`,
+        `  tag: "${tag}"`,
+        '',
+        ...nextStep,
+        '',
+        `To refresh later, call salesforce_retrieve_metadata with:`,
+        `  targetFolderId: "${jobDir}", tag: "${tag}"`,
+    ].join('\n');
+    return toolResponse(summary);
+}
+export const retrieveMetadataSchema = {
+    metadata: z.array(z.string()).describe('Metadata components to retrieve, e.g. ["Profile:Admin", "PermissionSet:*", "CustomObject:Account"]').optional(),
+    packageNames: z.array(z.string()).describe('Named packages to retrieve').optional(),
+    outputDir: z.string().describe('Override output directory (defaults to SALESFORCE_EXPORT_DIR or system temp)').optional(),
+    targetFolderId: z.string().describe('The output directory path from a previous retrieve (the "Output directory" value). When provided, files are written to the same directory instead of creating a new one. Pass targetFolderId alone (without metadata or packageNames) to refresh all metadata already in that directory.').optional(),
+    tag: z.enum(['source', 'target']).describe('Tag for the retrieve subfolder. Use "target" for baseline org, "source" for comparison org.').default('source'),
+};
+export const retrieveMetadataDescriptor = {
+    name: 'salesforce_retrieve_metadata',
+    description: retrieveMetadataTool.description,
+    schema: retrieveMetadataSchema,
+    handler: handleRetrieveMetadata,
+};
+//# sourceMappingURL=retrieveMetadata.js.map

package/dist/tools/retrieveMetadata.js.map

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

package/dist/tools/retrievePackage.d.ts

@@ -0,0 +1,37 @@
+import type { Connection } from 'jsforce';
+import { type ComponentMap } from '../utils/packageXml.js';
+export declare const retrievePackageTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            componentMap: {
+                type: string;
+                description: string;
+                additionalProperties: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+            };
+            apiVersion: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface RetrievePackageArgs {
+    componentMap: ComponentMap;
+    apiVersion?: string;
+}
+export declare function handleRetrievePackage(conn: Connection, args: RetrievePackageArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;

package/dist/tools/retrievePackage.js

@@ -0,0 +1 @@
+import{constants as e}from"node:fs";import{mkdir as t,access as a}from"node:fs/promises";import{tmpdir as o}from"node:os";import{join as r}from"node:path";import{toolResponse as s}from"../utils/index.js";import{componentMapToPackageTypes as n}from"../utils/packageXml.js";import{registerJob as i}from"../utils/packageJobs.js";export const retrievePackageTool={name:"salesforce_retrieve_package",description:"Start an asynchronous metadata retrieve using a component map. Returns a job ID immediately — use salesforce_package_status to poll for completion. When done, files are extracted to disk (bypassing the conversation context). Output directory is controlled by the SALESFORCE_EXPORT_DIR env var, falling back to a temp directory. Ideal for bulk metadata operations like reviewing many Apex classes or org-to-org migrations.",inputSchema:{type:"object",properties:{componentMap:{type:"object",description:'JSON map of metadata type to member names. Example: { "ApexClass": ["MyClass", "*"], "CustomObject": ["Account"] }. Use "*" to retrieve all members of a type.',additionalProperties:{type:"array",items:{type:"string"}}},apiVersion:{type:"string",description:'Salesforce API version. Default: "62.0".'}},required:["componentMap"]}};export async function handleRetrievePackage(p,c){const{componentMap:m,apiVersion:d}=c,l=process.env.SALESFORCE_EXPORT_DIR||r(o(),"salesforce-retrieve");try{const o=n(m),c=(await p.metadata.retrieve({singlePackage:!0,unpackaged:{types:o,version:d||"62.0"}})).id;if(!c)return s("Retrieve request did not return a job ID.",!0);const u=r(l,c);try{await t(u,{recursive:!0}),await a(u,e.W_OK)}catch(e){return s(`Output directory "${u}" cannot be created or is not writable: ${e.message}`,!0)}i({type:"retrieve",id:c,conn:p,startedAt:Date.now(),outputDirectory:u,componentMap:m});const g=Object.entries(m).map(([e,t])=>`  ${e}: ${t.join(", ")}`).join("\n");return s(`Metadata retrieve started.\n\nJob ID: ${c}\nOutput: ${u}\nComponents:\n${g}\n\nNext step: Use salesforce_package_status with jobId "${c}" to check progress.`)}catch(e){return s(`Failed to start metadata retrieve: ${e.message}`,!0)}}

package/dist/tools/salesforceLogin.d.ts

@@ -0,0 +1,36 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod/v4';
+export declare const salesforceLoginTool: Tool;
+export interface SalesforceLoginArgs {
+    environment: 'production' | 'sandbox' | 'custom';
+    custom_domain?: string;
+}
+export declare function handleSalesforceLogin(args: SalesforceLoginArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const salesforceLoginSchema: {
+    environment: z.ZodEnum<{
+        custom: "custom";
+        production: "production";
+        sandbox: "sandbox";
+    }>;
+    custom_domain: z.ZodOptional<z.ZodString>;
+};
+export declare const salesforceLoginDescriptor: {
+    name: string;
+    description: string | undefined;
+    schema: {
+        environment: z.ZodEnum<{
+            custom: "custom";
+            production: "production";
+            sandbox: "sandbox";
+        }>;
+        custom_domain: z.ZodOptional<z.ZodString>;
+    };
+    handler: typeof handleSalesforceLogin;
+    noConnection: boolean;
+};

package/dist/tools/salesforceLogin.js

@@ -0,0 +1,75 @@
+import { z } from 'zod/v4';
+import { startOAuthWebFlow } from '../utils/oauthWebFlow.js';
+import { toolResponse } from '../utils/errors.js';
+const ACQUIS_CONNECTED_APP_CLIENT_ID = '3MVG9p1Q1BCe9GmCr_ATVWfyCxRkeY5yCTFwBifYdiG5GzP5VK7BPNK5d0QxAhZJVhyqV7I3vVwpXHo.87Rpv';
+export const salesforceLoginTool = {
+    name: 'salesforce_login',
+    description: 'REQUIRED FIRST STEP — call this before any other Salesforce tool when starting a new session. ' +
+        'Authenticates to Salesforce via browser OAuth2 web flow. ' +
+        'Opens a browser tab where the user logs in and authorizes the Acquis MCP Connected App. ' +
+        'Select the environment (production, sandbox, or custom domain) to target the correct Salesforce login page. ',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            environment: {
+                type: 'string',
+                enum: ['production', 'sandbox', 'custom'],
+                description: 'The Salesforce environment to log in to.',
+            },
+            custom_domain: {
+                type: 'string',
+                description: 'Required when environment is "custom". Your org\'s My Domain, e.g. mycompany.my.salesforce.com',
+            },
+        },
+        required: ['environment'],
+    },
+};
+export async function handleSalesforceLogin(args) {
+    try {
+        let loginUrl;
+        let environmentDomain;
+        if (args.environment === 'production') {
+            loginUrl = 'https://login.salesforce.com';
+            environmentDomain = 'login.salesforce.com';
+        }
+        else if (args.environment === 'sandbox') {
+            loginUrl = 'https://test.salesforce.com';
+            environmentDomain = 'test.salesforce.com';
+        }
+        else {
+            if (!args.custom_domain) {
+                return toolResponse('custom_domain is required when environment is "custom". ' +
+                    'Provide your org\'s My Domain, e.g. mycompany.my.salesforce.com', true);
+            }
+            const domain = args.custom_domain.replace(/^https?:\/\//, '').replace(/\/$/, '');
+            loginUrl = `https://${domain}`;
+            environmentDomain = domain;
+        }
+        const clientId = process.env.SALESFORCE_CLIENT_ID ?? ACQUIS_CONNECTED_APP_CLIENT_ID;
+        const callbackPort = parseInt(process.env.SALESFORCE_OAUTH_CALLBACK_PORT ?? '7654', 10);
+        const { instanceUrl } = await startOAuthWebFlow(loginUrl, clientId, callbackPort);
+        return toolResponse(`Successfully authenticated to Salesforce.\n` +
+            `  Instance URL: ${instanceUrl}\n\n` +
+            `You can now use all Salesforce tools.`);
+    }
+    catch (err) {
+        return toolResponse(`salesforce_login failed: ${err.message}`, true);
+    }
+}
+export const salesforceLoginSchema = {
+    environment: z
+        .enum(['production', 'sandbox', 'custom'])
+        .describe('The Salesforce environment to log in to.'),
+    custom_domain: z
+        .string()
+        .describe('Required when environment is "custom". Your org\'s My Domain, e.g. mycompany.my.salesforce.com')
+        .optional(),
+};
+export const salesforceLoginDescriptor = {
+    name: 'salesforce_login',
+    description: salesforceLoginTool.description,
+    schema: salesforceLoginSchema,
+    handler: handleSalesforceLogin,
+    noConnection: true,
+};
+//# sourceMappingURL=salesforceLogin.js.map

package/dist/tools/salesforceLogin.js.map

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

package/dist/tools/selectOrg.d.ts

@@ -0,0 +1,25 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod/v4';
+export declare const selectOrgTool: Tool;
+export interface SelectOrgArgs {
+    org_id?: string;
+}
+export declare function handleSelectOrg(args: SelectOrgArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const selectOrgSchema: {
+    org_id: z.ZodOptional<z.ZodString>;
+};
+export declare const selectOrgDescriptor: {
+    name: string;
+    description: string | undefined;
+    schema: {
+        org_id: z.ZodOptional<z.ZodString>;
+    };
+    handler: typeof handleSelectOrg;
+    noConnection: boolean;
+};

package/dist/tools/selectOrg.js

@@ -0,0 +1,91 @@
+import { z } from 'zod/v4';
+import { listOrgs, getSelectedOrgId, setSelectedOrgId } from '../utils/tokenBroker.js';
+import { toolResponse } from '../utils/errors.js';
+export const selectOrgTool = {
+    name: 'salesforce_select_org',
+    description: 'DEPRECATED — do not use. Use salesforce_login instead to authenticate. ' +
+        'This tool is for legacy access_token (broker) authentication only and will be removed in a future version.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            org_id: {
+                type: 'string',
+                description: 'The ID of the org to select. Omit to list all available orgs.',
+            },
+        },
+        required: [],
+    },
+};
+export async function handleSelectOrg(args) {
+    try {
+        const currentOrgId = getSelectedOrgId();
+        // No org_id provided — list available orgs and show current selection if any
+        if (!args.org_id) {
+            let orgs;
+            try {
+                orgs = await listOrgs();
+            }
+            catch (err) {
+                return toolResponse(`Failed to list orgs: ${err.message}`, true);
+            }
+            if (orgs.length === 0) {
+                return toolResponse('No orgs available for this API key.', true);
+            }
+            const lines = [];
+            if (currentOrgId) {
+                lines.push(`Current session org: ${currentOrgId}\n`);
+            }
+            else {
+                lines.push('No org selected yet for this session.\n');
+            }
+            lines.push('Available orgs:');
+            for (const org of orgs) {
+                lines.push(`  id:           ${org.id}`);
+                lines.push(`  name:         ${org.name}`);
+                lines.push(`  environment:  ${org.environment}`);
+                lines.push(`  instance_url: ${org.instance_url}`);
+                lines.push('');
+            }
+            if (!currentOrgId) {
+                lines.push('Call salesforce_select_org with org_id to select an org for this session.');
+            }
+            return toolResponse(lines.join('\n').trimEnd());
+        }
+        // org_id provided — attempt to select it
+        const requestedOrgId = args.org_id.trim();
+        // Validate the requested org exists
+        let orgs;
+        try {
+            orgs = await listOrgs();
+        }
+        catch (err) {
+            return toolResponse(`Failed to validate org: ${err.message}`, true);
+        }
+        const org = orgs.find((o) => o.id === requestedOrgId);
+        if (!org) {
+            const available = orgs.map((o) => `  ${o.id}  (${o.name})`).join('\n');
+            return toolResponse(`Org "${requestedOrgId}" not found. Available orgs:\n${available}`, true);
+        }
+        const switched = currentOrgId !== null && currentOrgId !== requestedOrgId;
+        setSelectedOrgId(requestedOrgId);
+        return toolResponse(`Org ${switched ? 'switched' : 'selected'}:\n` +
+            `  id:           ${org.id}\n` +
+            `  name:         ${org.name}\n` +
+            `  environment:  ${org.environment}\n` +
+            `  instance_url: ${org.instance_url}`);
+    }
+    catch (err) {
+        return toolResponse(`salesforce_select_org failed: ${err.message}`, true);
+    }
+}
+export const selectOrgSchema = {
+    org_id: z.string().describe('The ID of the org to select. Omit to list all available orgs.').optional(),
+};
+export const selectOrgDescriptor = {
+    name: 'salesforce_select_org',
+    description: selectOrgTool.description,
+    schema: selectOrgSchema,
+    handler: handleSelectOrg,
+    noConnection: true,
+};
+//# sourceMappingURL=selectOrg.js.map

package/dist/tools/selectOrg.js.map

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

package/dist/tools/toolingQuery.d.ts

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