@acquis-consulting/asm 1.0.15 → 1.0.16

package/dist/tools/bulkImportStart.d.ts

@@ -0,0 +1,120 @@
+import type { Connection } from 'jsforce';
+import { z } from 'zod/v4';
+export declare const bulkImportStartTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            objectName: {
+                type: string;
+                description: string;
+            };
+            operation: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            externalIdFieldName: {
+                type: string;
+                description: string;
+            };
+            filePath: {
+                type: string;
+                description: string;
+            };
+            records: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            columnDelimiter: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            lineEnding: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            assignmentRuleId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface BulkImportStartArgs {
+    objectName: string;
+    operation: 'insert' | 'update' | 'upsert';
+    externalIdFieldName?: string;
+    filePath?: string;
+    records?: Record<string, unknown>[];
+    columnDelimiter?: 'COMMA' | 'SEMICOLON' | 'TAB' | 'PIPE' | 'CARET' | 'BACKQUOTE';
+    lineEnding?: 'LF' | 'CRLF';
+    assignmentRuleId?: string;
+}
+export declare function handleBulkImportStart(conn: Connection, args: BulkImportStartArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const bulkImportStartSchema: {
+    objectName: z.ZodString;
+    operation: z.ZodEnum<{
+        insert: "insert";
+        update: "update";
+        upsert: "upsert";
+    }>;
+    externalIdFieldName: z.ZodOptional<z.ZodString>;
+    filePath: z.ZodOptional<z.ZodString>;
+    records: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    columnDelimiter: z.ZodOptional<z.ZodEnum<{
+        BACKQUOTE: "BACKQUOTE";
+        CARET: "CARET";
+        COMMA: "COMMA";
+        PIPE: "PIPE";
+        SEMICOLON: "SEMICOLON";
+        TAB: "TAB";
+    }>>;
+    lineEnding: z.ZodOptional<z.ZodEnum<{
+        LF: "LF";
+        CRLF: "CRLF";
+    }>>;
+    assignmentRuleId: z.ZodOptional<z.ZodString>;
+};
+export declare const bulkImportStartDescriptor: {
+    name: string;
+    description: string;
+    schema: {
+        objectName: z.ZodString;
+        operation: z.ZodEnum<{
+            insert: "insert";
+            update: "update";
+            upsert: "upsert";
+        }>;
+        externalIdFieldName: z.ZodOptional<z.ZodString>;
+        filePath: z.ZodOptional<z.ZodString>;
+        records: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        columnDelimiter: z.ZodOptional<z.ZodEnum<{
+            BACKQUOTE: "BACKQUOTE";
+            CARET: "CARET";
+            COMMA: "COMMA";
+            PIPE: "PIPE";
+            SEMICOLON: "SEMICOLON";
+            TAB: "TAB";
+        }>>;
+        lineEnding: z.ZodOptional<z.ZodEnum<{
+            LF: "LF";
+            CRLF: "CRLF";
+        }>>;
+        assignmentRuleId: z.ZodOptional<z.ZodString>;
+    };
+    handler: typeof handleBulkImportStart;
+};

package/dist/tools/bulkImportStart.js

@@ -0,0 +1,183 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+import * as fs from 'node:fs';
+// Bulk API v2 limit is 150 MB per upload after base64 encoding; Salesforce recommends ≤100 MB raw.
+const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
+const DELIMITER_CHARS = {
+    BACKQUOTE: '`',
+    CARET: '^',
+    COMMA: ',',
+    PIPE: '|',
+    SEMICOLON: ';',
+    TAB: '\t',
+};
+export const bulkImportStartTool = {
+    name: 'salesforce_bulk_import_start',
+    description: 'Start an asynchronous bulk data import (insert, update, or upsert) using Salesforce Bulk API v2. Ideal for large datasets (10K+ records). Provide either a local CSV file (header row = field API names) or an inline array of records. Returns a job ID — use salesforce_bulk_import_status to poll for completion, then salesforce_bulk_import_results to download success/failure CSVs.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            objectName: {
+                type: 'string',
+                description: 'The Salesforce object API name to load into (e.g. Account, Contact, CustomObj__c).',
+            },
+            operation: {
+                type: 'string',
+                enum: ['insert', 'update', 'upsert'],
+                description: 'The ingest operation. update requires an Id column; upsert requires externalIdFieldName.',
+            },
+            externalIdFieldName: {
+                type: 'string',
+                description: 'External ID field used to match records. Required for upsert (use "Id" to upsert on record Id).',
+            },
+            filePath: {
+                type: 'string',
+                description: 'Absolute path to a local CSV file. Header row must contain field API names. Max 100 MB. Mutually exclusive with records.',
+            },
+            records: {
+                type: 'array',
+                items: { type: 'object' },
+                description: 'Inline array of records (field API name → value). Use for smaller loads. Mutually exclusive with filePath.',
+            },
+            columnDelimiter: {
+                type: 'string',
+                enum: ['COMMA', 'SEMICOLON', 'TAB', 'PIPE', 'CARET', 'BACKQUOTE'],
+                description: 'Column delimiter used in the CSV file (filePath only). Default: COMMA.',
+            },
+            lineEnding: {
+                type: 'string',
+                enum: ['LF', 'CRLF'],
+                description: 'Line ending used in the CSV file (filePath only). Default: LF.',
+            },
+            assignmentRuleId: {
+                type: 'string',
+                description: 'Optional assignment rule Id to apply (Case or Lead only).',
+            },
+        },
+        required: ['objectName', 'operation'],
+    },
+};
+/** Reads the CSV header row and returns the column names (unquoted). */
+function readHeader(content, delimiter) {
+    const newline = content.indexOf(0x0a);
+    const firstLine = content.subarray(0, newline === -1 ? content.length : newline).toString('utf8').replace(/\r$/, '');
+    return firstLine.split(delimiter).map((col) => col.trim().replace(/^"(.*)"$/, '$1'));
+}
+/** Validates args and loads the file; returns an error message or the CSV payload. */
+function prepareUpload(args) {
+    const { operation, externalIdFieldName, filePath, records, columnDelimiter = 'COMMA' } = args;
+    if (!filePath === !records) {
+        return { error: 'Provide exactly one data source: filePath or records.' };
+    }
+    if (operation === 'upsert' && !externalIdFieldName) {
+        return { error: 'externalIdFieldName is required for upsert.' };
+    }
+    if (records) {
+        if (records.length === 0)
+            return { error: 'records is empty — nothing to import.' };
+        if (operation === 'update' && records.some((r) => !r.Id)) {
+            return { error: 'Every record must include Id for update.' };
+        }
+        return {};
+    }
+    if (!fs.existsSync(filePath))
+        return { error: `File not found: ${filePath}` };
+    const size = fs.statSync(filePath).size;
+    if (size === 0)
+        return { error: `File is empty: ${filePath}` };
+    if (size > MAX_UPLOAD_BYTES) {
+        return { error: `File is ${(size / (1024 * 1024)).toFixed(1)} MB; the Bulk API v2 limit is 100 MB per job. Split the file and start one job per chunk.` };
+    }
+    const csv = fs.readFileSync(filePath);
+    const header = readHeader(csv, DELIMITER_CHARS[columnDelimiter]);
+    if (operation === 'update' && !header.includes('Id')) {
+        return { error: `CSV header has no Id column, which update requires. Header: ${header.join(', ')}` };
+    }
+    if (operation === 'upsert' && !header.includes(externalIdFieldName)) {
+        return { error: `CSV header has no "${externalIdFieldName}" column, which upsert requires. Header: ${header.join(', ')}` };
+    }
+    return { csv };
+}
+/**
+ * Uploads raw CSV bytes directly (bypassing jsforce's record-stream machinery, which
+ * re-serializes input) so the file's delimiter and line endings reach Salesforce unchanged.
+ */
+async function uploadCsv(conn, jobId, csv) {
+    const url = `${conn.instanceUrl}/services/data/v${conn.version}/jobs/ingest/${jobId}/batches`;
+    const response = await fetch(url, {
+        method: 'PUT',
+        headers: {
+            Authorization: `Bearer ${conn.accessToken}`,
+            'Content-Type': 'text/csv',
+        },
+        body: new Uint8Array(csv),
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Upload failed (HTTP ${response.status} ${response.statusText}): ${body}`);
+    }
+}
+export async function handleBulkImportStart(conn, args) {
+    const { objectName, operation, externalIdFieldName, filePath, records, columnDelimiter, lineEnding, assignmentRuleId } = args;
+    const prepared = prepareUpload(args);
+    if ('error' in prepared)
+        return toolResponse(prepared.error, true);
+    let job;
+    try {
+        job = conn.bulk2.createJob({
+            object: objectName,
+            operation,
+            ...(externalIdFieldName && { externalIdFieldName }),
+            ...(assignmentRuleId && { assignmentRuleId }),
+            // jsforce serializes inline records as comma-delimited LF CSV.
+            ...(filePath && columnDelimiter && { columnDelimiter }),
+            ...(filePath && lineEnding && { lineEnding }),
+        });
+        await job.open();
+    }
+    catch (error) {
+        return toolResponse(`Failed to create bulk import job: ${error.message}`, true);
+    }
+    try {
+        if (prepared.csv) {
+            await uploadCsv(conn, job.id, prepared.csv);
+        }
+        else {
+            await job.uploadData(records);
+        }
+        await job.close();
+    }
+    catch (error) {
+        try {
+            await job.abort();
+        }
+        catch {
+            // Best effort — the job may already be in a non-abortable state.
+        }
+        return toolResponse(`Failed to upload data to bulk import job ${job.id} (job aborted): ${error.message}`, true);
+    }
+    return toolResponse(`Bulk import job created and data uploaded.\n\n` +
+        `Job ID: ${job.id}\n` +
+        `State: UploadComplete\n` +
+        `Object: ${objectName}\n` +
+        `Operation: ${operation}${externalIdFieldName ? ` (external Id: ${externalIdFieldName})` : ''}\n` +
+        `Source: ${filePath ?? `${records.length} inline record(s)`}\n\n` +
+        `Next step: Use salesforce_bulk_import_status with jobId "${job.id}" to check progress.`);
+}
+export const bulkImportStartSchema = {
+    objectName: z.string().describe('The Salesforce object API name to load into (e.g. Account, Contact, CustomObj__c).'),
+    operation: z.enum(['insert', 'update', 'upsert']).describe('The ingest operation. update requires an Id column; upsert requires externalIdFieldName.'),
+    externalIdFieldName: z.string().describe('External ID field used to match records. Required for upsert (use "Id" to upsert on record Id).').optional(),
+    filePath: z.string().describe('Absolute path to a local CSV file. Header row must contain field API names. Max 100 MB. Mutually exclusive with records.').optional(),
+    records: z.array(z.record(z.string(), z.unknown())).describe('Inline array of records (field API name → value). Use for smaller loads. Mutually exclusive with filePath.').optional(),
+    columnDelimiter: z.enum(['COMMA', 'SEMICOLON', 'TAB', 'PIPE', 'CARET', 'BACKQUOTE']).describe('Column delimiter used in the CSV file (filePath only). Default: COMMA.').optional(),
+    lineEnding: z.enum(['LF', 'CRLF']).describe('Line ending used in the CSV file (filePath only). Default: LF.').optional(),
+    assignmentRuleId: z.string().describe('Optional assignment rule Id to apply (Case or Lead only).').optional(),
+};
+export const bulkImportStartDescriptor = {
+    name: 'salesforce_bulk_import_start',
+    description: bulkImportStartTool.description,
+    schema: bulkImportStartSchema,
+    handler: handleBulkImportStart,
+};
+//# sourceMappingURL=bulkImportStart.js.map

package/dist/tools/bulkImportStart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkImportStart.js","sourceRoot":"","sources":["../../src/tools/bulkImportStart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,mGAAmG;AACnG,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,eAAe,GAA2B;IAC9C,SAAS,EAAE,GAAG;IACd,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;IACT,SAAS,EAAE,GAAG;IACd,GAAG,EAAE,IAAI;CACV,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,4XAA4X;IAC9X,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oFAAoF;aAClG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;gBACpC,WAAW,EAAE,0FAA0F;aACxG;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iGAAiG;aAC/G;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0HAA0H;aACxI;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,4GAA4G;aAC1H;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC;gBACjE,WAAW,EAAE,wEAAwE;aACtF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;gBACpB,WAAW,EAAE,gEAAgE;aAC9E;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;KACtC;CACF,CAAC;AAaF,wEAAwE;AACxE,SAAS,UAAU,CAAC,OAAe,EAAE,SAAiB;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrH,OAAO,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,sFAAsF;AACtF,SAAS,aAAa,CAAC,IAAyB;IAC9C,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;IAE9F,IAAI,CAAC,QAAQ,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,uDAAuD,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;IAClE,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;QACpF,IAAI,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACzD,OAAO,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAS,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,QAAQ,EAAE,EAAE,CAAC;IAC/E,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAS,CAAC,CAAC,IAAI,CAAC;IACzC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,QAAQ,EAAE,EAAE,CAAC;IAC/D,IAAI,IAAI,GAAG,gBAAgB,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,2FAA2F,EAAE,CAAC;IAC5J,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAS,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;IACjE,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,KAAK,EAAE,+DAA+D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACvG,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAoB,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,sBAAsB,mBAAmB,4CAA4C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAC7H,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,SAAS,CAAC,IAAgB,EAAE,KAAa,EAAE,GAAW;IACnE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,mBAAoB,IAAY,CAAC,OAAO,gBAAgB,KAAK,UAAU,CAAC;IACvG,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;YAC3C,cAAc,EAAE,UAAU;SAC3B;QACD,IAAI,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC;KAC1B,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,IAAI,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAgB,EAAE,IAAyB;IACrF,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAE9H,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,OAAO,IAAI,QAAQ;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEnE,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAI,IAAY,CAAC,KAAK,CAAC,SAAS,CAAC;YAClC,MAAM,EAAE,UAAU;YAClB,SAAS;YACT,GAAG,CAAC,mBAAmB,IAAI,EAAE,mBAAmB,EAAE,CAAC;YACnD,GAAG,CAAC,gBAAgB,IAAI,EAAE,gBAAgB,EAAE,CAAC;YAC7C,+DAA+D;YAC/D,GAAG,CAAC,QAAQ,IAAI,eAAe,IAAI,EAAE,eAAe,EAAE,CAAC;YACvD,GAAG,CAAC,QAAQ,IAAI,UAAU,IAAI,EAAE,UAAU,EAAE,CAAC;SAC9C,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC,qCAAqC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,CAAC;QACH,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;YACjB,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;QACnE,CAAC;QACD,OAAO,YAAY,CAAC,4CAA4C,GAAG,CAAC,EAAE,mBAAmB,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAClH,CAAC;IAED,OAAO,YAAY,CACjB,gDAAgD;QAChD,WAAW,GAAG,CAAC,EAAE,IAAI;QACrB,yBAAyB;QACzB,WAAW,UAAU,IAAI;QACzB,cAAc,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,mBAAmB,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;QACjG,WAAW,QAAQ,IAAI,GAAG,OAAQ,CAAC,MAAM,mBAAmB,MAAM;QAClE,4DAA4D,GAAG,CAAC,EAAE,sBAAsB,CACzF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oFAAoF,CAAC;IACrH,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,0FAA0F,CAAC;IACtJ,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iGAAiG,CAAC,CAAC,QAAQ,EAAE;IACtJ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0HAA0H,CAAC,CAAC,QAAQ,EAAE;IACpK,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,4GAA4G,CAAC,CAAC,QAAQ,EAAE;IACrL,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,wEAAwE,CAAC,CAAC,QAAQ,EAAE;IAClL,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,gEAAgE,CAAC,CAAC,QAAQ,EAAE;IACxH,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC,CAAC,QAAQ,EAAE;CAC9G,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,mBAAmB,CAAC,WAAW;IAC5C,MAAM,EAAE,qBAAqB;IAC7B,OAAO,EAAE,qBAAqB;CAC/B,CAAC"}

package/dist/tools/bulkImportStatus.d.ts

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

package/dist/tools/bulkImportStatus.js

@@ -0,0 +1,56 @@
+import { z } from 'zod/v4';
+import { toolResponse } from '../utils/index.js';
+export const bulkImportStatusTool = {
+    name: 'salesforce_bulk_import_status',
+    description: 'Check the status of a bulk import job. States progress: Open → UploadComplete → InProgress → JobComplete | Failed | Aborted. Poll this until the job reaches a terminal state, then use salesforce_bulk_import_results to download success/failure CSVs.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            jobId: {
+                type: 'string',
+                description: 'The bulk import job ID returned by salesforce_bulk_import_start.',
+            },
+        },
+        required: ['jobId'],
+    },
+};
+export async function handleBulkImportStatus(conn, args) {
+    const { jobId } = args;
+    try {
+        const job = conn.bulk2.job('ingest', { id: jobId });
+        const info = await job.check();
+        const lines = [
+            `Job ID: ${info.id}`,
+            `State: ${info.state}`,
+            `Object: ${info.object}`,
+            `Operation: ${info.operation}${info.externalIdFieldName ? ` (external Id: ${info.externalIdFieldName})` : ''}`,
+            `Records Processed: ${info.numberRecordsProcessed ?? 'N/A'}`,
+            `Records Failed: ${info.numberRecordsFailed ?? 'N/A'}`,
+            `Created: ${info.createdDate}`,
+            `System Modstamp: ${info.systemModstamp}`,
+        ];
+        if (info.errorMessage) {
+            lines.push(`Error: ${info.errorMessage}`);
+        }
+        if (info.state === 'JobComplete' || info.state === 'Failed' || info.state === 'Aborted') {
+            lines.push('', `Next step: Use salesforce_bulk_import_results with jobId "${jobId}" to download success/failure CSVs.`);
+        }
+        else {
+            lines.push('', `Job is still processing. Poll again with salesforce_bulk_import_status.`);
+        }
+        return toolResponse(lines.join('\n'));
+    }
+    catch (error) {
+        return toolResponse(`Failed to check bulk import status: ${error.message}`, true);
+    }
+}
+export const bulkImportStatusSchema = {
+    jobId: z.string().describe('The bulk import job ID returned by salesforce_bulk_import_start.'),
+};
+export const bulkImportStatusDescriptor = {
+    name: 'salesforce_bulk_import_status',
+    description: bulkImportStatusTool.description,
+    schema: bulkImportStatusSchema,
+    handler: handleBulkImportStatus,
+};
+//# sourceMappingURL=bulkImportStatus.js.map

package/dist/tools/bulkImportStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkImportStatus.js","sourceRoot":"","sources":["../../src/tools/bulkImportStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,0PAA0P;IAC5P,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAgB,EAAE,IAA0B;IACvF,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAEvB,IAAI,CAAC;QACH,MAAM,GAAG,GAAI,IAAY,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAE/B,MAAM,KAAK,GAAG;YACZ,WAAW,IAAI,CAAC,EAAE,EAAE;YACpB,UAAU,IAAI,CAAC,KAAK,EAAE;YACtB,WAAW,IAAI,CAAC,MAAM,EAAE;YACxB,cAAc,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC9G,sBAAsB,IAAI,CAAC,sBAAsB,IAAI,KAAK,EAAE;YAC5D,mBAAmB,IAAI,CAAC,mBAAmB,IAAI,KAAK,EAAE;YACtD,YAAY,IAAI,CAAC,WAAW,EAAE;YAC9B,oBAAoB,IAAI,CAAC,cAAc,EAAE;SAC1C,CAAC;QAEF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,KAAK,aAAa,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACxF,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,6DAA6D,KAAK,qCAAqC,CAAC,CAAC;QAC1H,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,yEAAyE,CAAC,CAAC;QAC5F,CAAC;QAED,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,YAAY,CAAC,uCAAuC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACpF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;CAC/F,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,oBAAoB,CAAC,WAAW;IAC7C,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,sBAAsB;CAChC,CAAC"}

package/dist/tools/salesforceCliLogin.d.ts

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

package/dist/tools/salesforceCliLogin.js

@@ -0,0 +1,73 @@
+import { z } from 'zod/v4';
+import { startSfCliWebLogin } from '../utils/sfCliWebLogin.js';
+import { toolResponse } from '../utils/errors.js';
+export const salesforceCliLoginTool = {
+    name: 'salesforce_cli_login',
+    description: 'Starts a browser login to Salesforce using the locally installed Salesforce CLI (`sf org login web`), ' +
+        'the same browser login VS Code uses — but it works from any folder, including an empty one, ' +
+        'with no DX project and no Acquis Connected App required. Requires the `sf` CLI on PATH. ' +
+        'This tool returns immediately, before the user has logged in: it opens the browser and hands back a session_id. ' +
+        'You MUST then call salesforce_cli_login_status with that session_id to find out whether the login succeeded — ' +
+        'wait for the user to say they have finished logging in, or poll every few seconds. ' +
+        'This is an alternative to salesforce_login: use one or the other, not both.',
+    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 handleSalesforceCliLogin(args, sessionId) {
+    try {
+        let loginUrl;
+        if (args.environment === 'production') {
+            loginUrl = 'https://login.salesforce.com';
+        }
+        else if (args.environment === 'sandbox') {
+            loginUrl = 'https://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}`;
+        }
+        await startSfCliWebLogin(loginUrl, sessionId);
+        return toolResponse(`Browser login started — a Salesforce tab should have opened at ${loginUrl}.\n` +
+            `  Session ID: ${sessionId}\n\n` +
+            `The login is NOT finished yet. Ask the user to complete it in the browser, then call ` +
+            `salesforce_cli_login_status with session_id="${sessionId}" to confirm before using any other Salesforce tool.\n` +
+            `Leave the browser tab alone until it shows a success page — closing it cancels the login.`);
+    }
+    catch (err) {
+        return toolResponse(`salesforce_cli_login failed: ${err.message}`, true);
+    }
+}
+export const salesforceCliLoginSchema = {
+    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 salesforceCliLoginDescriptor = {
+    name: 'salesforce_cli_login',
+    description: salesforceCliLoginTool.description,
+    schema: salesforceCliLoginSchema,
+    handler: handleSalesforceCliLogin,
+    noConnection: true,
+};
+//# sourceMappingURL=salesforceCliLogin.js.map

package/dist/tools/salesforceCliLogin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"salesforceCliLogin.js","sourceRoot":"","sources":["../../src/tools/salesforceCliLogin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,sBAAsB,GAAS;IAC1C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,wGAAwG;QACxG,8FAA8F;QAC9F,0FAA0F;QAC1F,kHAAkH;QAClH,gHAAgH;QAChH,qFAAqF;QACrF,6EAA6E;IAC/E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC;gBACzC,WAAW,EAAE,0CAA0C;aACxD;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gGAAgG;aAC9G;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAA4B,EAAE,SAAiB;IAC5F,IAAI,CAAC;QACH,IAAI,QAAgB,CAAC;QAErB,IAAI,IAAI,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;YACtC,QAAQ,GAAG,8BAA8B,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAC1C,QAAQ,GAAG,6BAA6B,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,OAAO,YAAY,CACjB,0DAA0D;oBAC1D,iEAAiE,EACjE,IAAI,CACL,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACjF,QAAQ,GAAG,WAAW,MAAM,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,kBAAkB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAE9C,OAAO,YAAY,CACjB,kEAAkE,QAAQ,KAAK;YAC/E,iBAAiB,SAAS,MAAM;YAChC,uFAAuF;YACvF,gDAAgD,SAAS,wDAAwD;YACjH,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,YAAY,CAAC,gCAAgC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;SACzC,QAAQ,CAAC,0CAA0C,CAAC;IACvD,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,gGAAgG,CAAC;SAC1G,QAAQ,EAAE;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,sBAAsB,CAAC,WAAW;IAC/C,MAAM,EAAE,wBAAwB;IAChC,OAAO,EAAE,wBAAwB;IACjC,YAAY,EAAE,IAAI;CACnB,CAAC"}

package/dist/tools/salesforceCliLoginStatus.d.ts

@@ -0,0 +1,25 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod/v4';
+export declare const salesforceCliLoginStatusTool: Tool;
+export interface SalesforceCliLoginStatusArgs {
+    session_id?: string;
+}
+export declare function handleSalesforceCliLoginStatus(args: SalesforceCliLoginStatusArgs, fallbackSessionId: string): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export declare const salesforceCliLoginStatusSchema: {
+    session_id: z.ZodString;
+};
+export declare const salesforceCliLoginStatusDescriptor: {
+    name: string;
+    description: string | undefined;
+    schema: {
+        session_id: z.ZodString;
+    };
+    handler: typeof handleSalesforceCliLoginStatus;
+    noConnection: boolean;
+};

package/dist/tools/salesforceCliLoginStatus.js

@@ -0,0 +1,66 @@
+import { z } from 'zod/v4';
+import { getSfCliLoginState } from '../utils/sfCliWebLogin.js';
+import { toolResponse } from '../utils/errors.js';
+export const salesforceCliLoginStatusTool = {
+    name: 'salesforce_cli_login_status',
+    description: 'Checks whether the browser login started by salesforce_cli_login has completed. ' +
+        'Call this after salesforce_cli_login, once the user says they have finished logging in ' +
+        '(or poll every few seconds). Returns "pending" while the user is still in the browser, ' +
+        '"success" once the session is authenticated and ready for other Salesforce tools, ' +
+        'or "error" if the login failed or was cancelled.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            session_id: {
+                type: 'string',
+                description: 'The session_id returned by salesforce_cli_login.',
+            },
+        },
+        required: ['session_id'],
+    },
+};
+function formatElapsed(startedAt) {
+    return `${Math.round((Date.now() - startedAt) / 1000)}s`;
+}
+export async function handleSalesforceCliLoginStatus(args, fallbackSessionId) {
+    // The standalone registration loop does not inject session_id, so it arrives as a
+    // normal argument. Fall back to the generated one only if the caller omitted it.
+    const sessionId = args.session_id ?? fallbackSessionId;
+    const state = getSfCliLoginState(sessionId);
+    if (!state) {
+        return toolResponse(`No Salesforce CLI login found for session_id="${sessionId}". ` +
+            `Call salesforce_cli_login first, and pass the exact session_id it returned. ` +
+            `(Logins are held in memory, so they are also lost if the MCP server restarts.)`, true);
+    }
+    if (state.status === 'pending') {
+        return toolResponse(`Login still pending (${formatElapsed(state.startedAt)} elapsed).\n` +
+            `  Login URL: ${state.loginUrl}\n\n` +
+            `The user has not finished authorizing in the browser yet. Ask them to complete the login, ` +
+            `then call this tool again. Do not call other Salesforce tools with this session_id yet.`);
+    }
+    if (state.status === 'error') {
+        return toolResponse(`Login failed after ${formatElapsed(state.startedAt)}: ${state.error}\n\n` +
+            `Call salesforce_cli_login again to retry.`, true);
+    }
+    const { org } = state;
+    return toolResponse(`Successfully authenticated to Salesforce via the Salesforce CLI.\n` +
+        `  Instance URL: ${org.instanceUrl}\n` +
+        `  Username: ${org.username}\n` +
+        `  Org ID: ${org.orgId}\n` +
+        `  CLI alias: ${org.alias ?? '(could not be set — org is still usable via this session)'}\n` +
+        `  Session ID: ${sessionId}\n\n` +
+        `IMPORTANT: Pass session_id="${sessionId}" to every Salesforce tool call in this conversation.`);
+}
+export const salesforceCliLoginStatusSchema = {
+    session_id: z
+        .string()
+        .describe('The session_id returned by salesforce_cli_login.'),
+};
+export const salesforceCliLoginStatusDescriptor = {
+    name: 'salesforce_cli_login_status',
+    description: salesforceCliLoginStatusTool.description,
+    schema: salesforceCliLoginStatusSchema,
+    handler: handleSalesforceCliLoginStatus,
+    noConnection: true,
+};
+//# sourceMappingURL=salesforceCliLoginStatus.js.map

package/dist/tools/salesforceCliLoginStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"salesforceCliLoginStatus.js","sourceRoot":"","sources":["../../src/tools/salesforceCliLoginStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,4BAA4B,GAAS;IAChD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,kFAAkF;QAClF,yFAAyF;QACzF,yFAAyF;QACzF,oFAAoF;QACpF,kDAAkD;IACpD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;CACF,CAAC;AAMF,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,IAAkC,EAClC,iBAAyB;IAEzB,kFAAkF;IAClF,iFAAiF;IACjF,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAEvD,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAE5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,YAAY,CACjB,iDAAiD,SAAS,KAAK;YAC/D,8EAA8E;YAC9E,gFAAgF,EAChF,IAAI,CACL,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,YAAY,CACjB,wBAAwB,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc;YACpE,gBAAgB,KAAK,CAAC,QAAQ,MAAM;YACpC,4FAA4F;YAC5F,yFAAyF,CAC1F,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,YAAY,CACjB,sBAAsB,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,KAAK,MAAM;YAC1E,2CAA2C,EAC3C,IAAI,CACL,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IACtB,OAAO,YAAY,CACjB,oEAAoE;QACpE,mBAAmB,GAAG,CAAC,WAAW,IAAI;QACtC,eAAe,GAAG,CAAC,QAAQ,IAAI;QAC/B,aAAa,GAAG,CAAC,KAAK,IAAI;QAC1B,gBAAgB,GAAG,CAAC,KAAK,IAAI,2DAA2D,IAAI;QAC5F,iBAAiB,SAAS,MAAM;QAChC,+BAA+B,SAAS,uDAAuD,CAChG,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,4BAA4B,CAAC,WAAW;IACrD,MAAM,EAAE,8BAA8B;IACtC,OAAO,EAAE,8BAA8B;IACvC,YAAY,EAAE,IAAI;CACnB,CAAC"}

package/dist/tools/salesforceLogin.js

@@ -4,7 +4,8 @@ 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. ' +
+    description: 'Call this only the first time a Salesforce tool is used in a session, or if a later tool call fails due to an expired/invalid session or missing authentication. ' +
+        'Do not call this before every Salesforce tool — only once per session (or again after a session expires). ' +
         '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. ',

package/dist/tools/salesforceLogin.js.map

@@ -1 +1 @@
-{"version":3,"file":"salesforceLogin.js","sourceRoot":"","sources":["../../src/tools/salesforceLogin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,8BAA8B,GAAG,uFAAuF,CAAC;AAC/H,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,gGAAgG;QAChG,2DAA2D;QAC3D,0FAA0F;QAC1F,8GAA8G;IAChH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC;gBACzC,WAAW,EAAE,0CAA0C;aACxD;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gGAAgG;aAC9G;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAyB,EAAE,SAAiB;IACtF,IAAI,CAAC;QACH,IAAI,QAAgB,CAAC;QACrB,IAAI,iBAAyB,CAAC;QAE9B,IAAI,IAAI,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;YACtC,QAAQ,GAAG,8BAA8B,CAAC;YAC1C,iBAAiB,GAAG,sBAAsB,CAAC;QAC7C,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YAC1C,QAAQ,GAAG,6BAA6B,CAAC;YACzC,iBAAiB,GAAG,qBAAqB,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,OAAO,YAAY,CACjB,0DAA0D;oBAC1D,iEAAiE,EACjE,IAAI,CACL,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACjF,QAAQ,GAAG,WAAW,MAAM,EAAE,CAAC;YAC/B,iBAAiB,GAAG,MAAM,CAAC;QAC7B,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,8BAA8B,CAAC;QAEpF,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QAExF,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QAE7F,OAAO,YAAY,CACjB,6CAA6C;YAC7C,mBAAmB,WAAW,IAAI;YAClC,iBAAiB,SAAS,MAAM;YAChC,+BAA+B,SAAS,uDAAuD,CAChG,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,YAAY,CAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;SACzC,QAAQ,CAAC,0CAA0C,CAAC;IACvD,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,gGAAgG,CAAC;SAC1G,QAAQ,EAAE;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,mBAAmB,CAAC,WAAW;IAC5C,MAAM,EAAE,qBAAqB;IAC7B,OAAO,EAAE,qBAAqB;IAC9B,YAAY,EAAE,IAAI;CACnB,CAAC"}
+{"version":3,"file":"salesforceLogin.js","sourceRoot":"","sources":["../../src/tools/salesforceLogin.ts"],"names":[],"mappings":"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"}