@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.8

package/lib/mcp/server.js

@@ -0,0 +1,316 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { DebugLogger } from '../debug/debug-logger.js';
+import { createMcpAdapters } from './config/mcp-config.js';
+import { CUNEIFORM_SYSTEM_PROMPT } from './config/system-prompts.js';
+import { McpErrorCodes } from './errors.js';
+import { createMcpError, extractErrorMessage, typedHandler } from './tools/tool-factory.js';
+// Input schemas — single source of truth for validation
+import { OrgDetailsInputSchema, ObjectListInputSchema, ObjectDescribeInputSchema, UserDetailsInputSchema, UserConfigureInputSchema, DefinitionListInputSchema, DefinitionGetInputSchema, DefinitionGetByKeyInputSchema, DefinitionCreateInputSchema, DefinitionUpdateInputSchema, DefinitionPurgeInputSchema, DefinitionExportInputSchema, DefinitionImportInputSchema, ContactPointAnalyzeInputSchema, SummaryListInputSchema, RequestListInputSchema, ProfileExecuteInputSchema, ProfileStatusInputSchema, ProfileCancelInputSchema, ProfileDeleteInputSchema, } from './schemas/input-schemas.js';
+// Handler functions
+import { handleOrgDetails } from './tools/org-tools.js';
+import { handleObjectList, handleObjectDescribe } from './tools/object-tools.js';
+import { handleUserDetails, handleUserConfigure } from './tools/user-tools.js';
+import { handleDefinitionList, handleDefinitionGet, handleDefinitionGetByKey, handleDefinitionCreate, handleDefinitionUpdate, handleDefinitionPurge, } from './tools/definition-tools.js';
+import { handleDefinitionExport, handleDefinitionImport } from './tools/definition-io-tools.js';
+import { handleContactPointAnalyze } from './tools/contactpoint-tools.js';
+import { handleSummaryList } from './tools/summary-tools.js';
+import { handleRequestList, handleProfileExecute, handleProfileStatus, handleProfileCancel, handleProfileDelete, } from './tools/profile-tools.js';
+/**
+ * Wraps a handler with debug logging (timing, params, result size).
+ *
+ * @param toolName - Tool name for log output
+ * @param adapters - Session-scoped MCP adapters
+ * @param handler - Handler function
+ * @param args - Validated input arguments
+ * @param debug - Whether debug logging is enabled
+ * @returns CallToolResult from the handler
+ */
+async function invokeWithLogging(toolName, adapters, handler, args, debug) {
+    if (debug) {
+        DebugLogger.setEnabled(true);
+    }
+    if (debug) {
+        DebugLogger.log('MCP', toolName, 'params', JSON.stringify(args));
+    }
+    const start = Date.now();
+    try {
+        const result = await handler(adapters, args);
+        const duration = Date.now() - start;
+        const success = !result.isError;
+        if (debug) {
+            try {
+                const resultStr = JSON.stringify(result);
+                const sizeBytes = new TextEncoder().encode(resultStr).length;
+                DebugLogger.logResult('MCP', toolName, success, duration, sizeBytes);
+            }
+            catch (serializeError) {
+                /* eslint-disable-next-line no-console -- MCP uses stderr for logging */
+                console.error(`[MCP] Warning: Result for ${toolName} is not JSON-serializable: ` +
+                    `${serializeError instanceof Error ? serializeError.message : String(serializeError)}. ` +
+                    'This may cause a transport error.');
+                DebugLogger.logResult('MCP', toolName, success, duration);
+            }
+        }
+        else {
+            DebugLogger.logResult('MCP', toolName, success, duration);
+        }
+        return result;
+    }
+    catch (error) {
+        const errorMessage = extractErrorMessage(error, `invokeWithLogging:${toolName}`);
+        DebugLogger.log('MCP', toolName, 'error', errorMessage);
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, errorMessage);
+    }
+}
+/**
+ * Complete tool registry with descriptions, schemas, and handlers.
+ *
+ * Handlers accept typed params — casts at this boundary are safe because
+ * the McpServer SDK validates input via Zod schemas before calling handlers.
+ */
+/* eslint-disable camelcase -- MCP tool names use underscores */
+export function getToolRegistrations() {
+    return [
+        // --- Org & Metadata ---
+        {
+            name: 'cuneiform_org_details',
+            description: 'Get Salesforce org configuration by section. Returns ONE section per call. ' +
+                'Start with section=identity to see available sections, then request specific sections as needed. ' +
+                'Sections: identity (org info), cuneiform (package status), features (enabled features), ' +
+                'clouds (detected clouds, paginated), namespaces (installed namespaces, paginated), limits (API limits). ' +
+                'Pass nextCursor from _pagination envelope as cursor for paginated sections.',
+            inputSchema: OrgDetailsInputSchema,
+            handler: typedHandler(handleOrgDetails),
+        },
+        {
+            name: 'cuneiform_object_list',
+            description: 'List Salesforce objects with record counts, type filtering (standard/custom), namespace filtering, ' +
+                'and pattern matching. Returns up to 25 objects per page (max 50). Apply filters first to narrow results ' +
+                'before paginating. Pass nextCursor from the _pagination envelope as cursor to retrieve the next page. ' +
+                'Use to discover which objects exist in the org before profiling.',
+            inputSchema: ObjectListInputSchema,
+            handler: typedHandler(handleObjectList),
+        },
+        {
+            name: 'cuneiform_object_describe',
+            description: 'Get detailed metadata for a single Salesforce object by section. Accepts exactly ONE object API name. ' +
+                'Start with section=summary to see available sections. Sections: summary (object info + field counts), ' +
+                'fields (paginated field list with filtering), fieldDistribution (field type breakdown), recordTypes ' +
+                '(paginated record types), relationships (paginated lookups and references). Do NOT loop through all ' +
+                'objects from object_list — describe only the objects the user is interested in.',
+            inputSchema: ObjectDescribeInputSchema,
+            handler: typedHandler(handleObjectDescribe),
+        },
+        // --- User Management ---
+        {
+            name: 'cuneiform_user_details',
+            description: 'Confirm that Cuneiform for Salesforce is installed and the current user is configured for remote profiling. ' +
+                'Returns org context, user identity, prerequisite checks (Cuneiform installed, admin access), permission set ' +
+                'assignments, configuration profile status, and actionable resolution guidance when the user is not ready. ' +
+                'Call this FIRST before any other Cuneiform tool to verify the user can run profiling.',
+            inputSchema: UserDetailsInputSchema,
+            handler: typedHandler(handleUserDetails),
+        },
+        {
+            name: 'cuneiform_user_configure',
+            description: 'Configure the current user for Cuneiform profiling access. Assigns required permission sets and ' +
+                'enables API-only profiling. ALWAYS call cuneiform_user_details first to check prerequisites. ' +
+                'ALWAYS use dryRun=true first to preview changes, then call again with dryRun=false to apply.',
+            inputSchema: UserConfigureInputSchema,
+            handler: typedHandler(handleUserConfigure),
+        },
+        // --- Definition Lifecycle ---
+        {
+            name: 'cuneiform_definition_list',
+            description: 'List profiling definitions with optional filtering by object name, status, and active state. ' +
+                'Returns definition keys, target objects, field counts, and profiling status.',
+            inputSchema: DefinitionListInputSchema,
+            handler: typedHandler(handleDefinitionList),
+        },
+        {
+            name: 'cuneiform_definition_get',
+            description: 'Get a profiling definition by its Salesforce ID. Returns full definition details.',
+            inputSchema: DefinitionGetInputSchema,
+            handler: typedHandler(handleDefinitionGet),
+        },
+        {
+            name: 'cuneiform_definition_get_by_key',
+            description: 'Get profiling definitions by their human-readable keys (e.g., PD-0001). ' +
+                'Supports retrieving multiple definitions in a single call.',
+            inputSchema: DefinitionGetByKeyInputSchema,
+            handler: typedHandler(handleDefinitionGetByKey),
+        },
+        {
+            name: 'cuneiform_definition_create',
+            description: 'Create profiling definitions for objects matching the specified criteria. ' +
+                'ALWAYS use dryRun=true first to preview what will be created.',
+            inputSchema: DefinitionCreateInputSchema,
+            handler: typedHandler(handleDefinitionCreate),
+        },
+        {
+            name: 'cuneiform_definition_update',
+            description: 'Update metadata attributes (name, category, timeCategory, segmentCategory, description) on an existing ' +
+                'profiling definition. Supply one or more attributes; untouched attributes are preserved.',
+            inputSchema: DefinitionUpdateInputSchema,
+            handler: typedHandler(handleDefinitionUpdate),
+        },
+        {
+            name: 'cuneiform_definition_purge',
+            description: 'Delete profiling definitions that have never been profiled. ' +
+                'Use to clean up unused definitions after scope changes.',
+            inputSchema: DefinitionPurgeInputSchema,
+            handler: typedHandler(handleDefinitionPurge),
+        },
+        // --- Definition I/O ---
+        {
+            name: 'cuneiform_definition_export',
+            description: 'Export all profiling definitions as VCS-friendly files. ' +
+                'Returns file contents (CSV/JSON) for version control or cross-org portability.',
+            inputSchema: DefinitionExportInputSchema,
+            handler: typedHandler(handleDefinitionExport),
+        },
+        {
+            name: 'cuneiform_definition_import',
+            description: 'Import profiling definitions from exported files. ALWAYS use simulation=true first to preview changes.',
+            inputSchema: DefinitionImportInputSchema,
+            handler: typedHandler(handleDefinitionImport),
+        },
+        // --- Analysis ---
+        {
+            name: 'cuneiform_contactpoint_analyze',
+            description: 'Identify and classify contact point fields in a Salesforce object. ' +
+                'Detects email, phone, address, and social media fields.',
+            inputSchema: ContactPointAnalyzeInputSchema,
+            handler: typedHandler(handleContactPointAnalyze),
+        },
+        // --- Results ---
+        {
+            name: 'cuneiform_summary_list',
+            description: 'List profiling summaries for a specific definition. ' +
+                'Returns summary-level records including overall status, total records profiled, fields profiled, last profiled date, and whether each summary is the latest run.',
+            inputSchema: SummaryListInputSchema,
+            handler: typedHandler(handleSummaryList),
+        },
+        // --- Profiling ---
+        {
+            name: 'cuneiform_request_list',
+            description: 'List profiling requests with optional status filtering and offset-based pagination. ' +
+                'Filter by a single status (e.g. "Queued") or multiple statuses (e.g. ["Queued", "Completed"]). ' +
+                'Returns id, name, definitionId, definitionName, objectName, status, createdDate, lastModifiedDate, and submittedBy per request. ' +
+                'Use to monitor in-progress requests, audit completed profiling, or find requests eligible for cancellation or deletion.',
+            inputSchema: RequestListInputSchema,
+            handler: typedHandler(handleRequestList),
+        },
+        {
+            name: 'cuneiform_profile_execute',
+            description: 'Execute a profiling definition. Triggers Apex processing to analyze field values and data quality. ' +
+                'Can optionally wait for completion.',
+            inputSchema: ProfileExecuteInputSchema,
+            handler: typedHandler(handleProfileExecute),
+        },
+        {
+            name: 'cuneiform_profile_status',
+            description: 'Check the status of a profiling execution request.',
+            inputSchema: ProfileStatusInputSchema,
+            handler: typedHandler(handleProfileStatus),
+        },
+        {
+            name: 'cuneiform_profile_cancel',
+            description: 'Cancel an active profiling execution. Supports cancelling by request ID or by definition ID ' +
+                '(cancels all active requests for that definition).',
+            inputSchema: ProfileCancelInputSchema,
+            handler: typedHandler(handleProfileCancel),
+        },
+        {
+            name: 'cuneiform_profile_delete',
+            description: 'Delete terminal profiling requests by ID. Only Canceled requests can be deleted. This operation is irreversible.',
+            inputSchema: ProfileDeleteInputSchema,
+            handler: typedHandler(handleProfileDelete),
+        },
+    ];
+}
+/* eslint-enable camelcase */
+/**
+ * Creates and configures the Cuneiform MCP server using McpServer.
+ *
+ * Registers all 18 tools via `registerTool()` with native Zod schema support,
+ * eliminating the manual dispatch layer and JSON Schema duplication.
+ *
+ * @param config - MCP server configuration
+ * @param connection - Salesforce connection
+ * @returns Configured McpServer instance
+ */
+export function createMcpServer(config, connection) {
+    const server = new McpServer({
+        name: config.name,
+        version: config.version,
+    }, {
+        capabilities: {
+            tools: {},
+            prompts: {},
+        },
+    });
+    // Construct adapters once — shared across all tool invocations in this session.
+    // LRU caches (e.g., RestApiAdapter describe cache) persist across paginated calls.
+    const adapters = createMcpAdapters(connection);
+    // Register all tools with native Zod schemas
+    const tools = getToolRegistrations();
+    for (const tool of tools) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }, async (args) => invokeWithLogging(tool.name, adapters, tool.handler, args, config.debug));
+    }
+    // Register system prompt
+    server.registerPrompt('cuneiform_system', { description: 'Cuneiform CLI system prompt' }, () => Promise.resolve({
+        description: 'Cuneiform CLI system prompt',
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: CUNEIFORM_SYSTEM_PROMPT,
+                },
+            },
+        ],
+    }));
+    return server;
+}
+/**
+ * Starts the MCP server with stdio transport.
+ *
+ * @param server - Configured McpServer instance
+ * @param debug - Enable debug logging
+ */
+/* eslint-disable no-console -- MCP uses stderr for logging */
+export async function startMcpServer(server, debug) {
+    const transport = new StdioServerTransport();
+    if (debug) {
+        console.error('[MCP] Starting server...');
+    }
+    try {
+        await server.connect(transport);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[MCP] Server failed to start: ${message}`);
+        if (error instanceof Error && error.stack) {
+            console.error(error.stack);
+        }
+        throw new Error(`MCP server failed to connect to stdio transport: ${message}. ` +
+            'Ensure the process has stdin/stdout available and is not running in a detached context.');
+    }
+    if (debug) {
+        console.error('[MCP] Server started and connected to stdio transport');
+    }
+}
+/* eslint-enable no-console */
+//# sourceMappingURL=server.js.map

package/lib/mcp/server.js.map

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

package/lib/mcp/tools/contactpoint-tools.d.ts

@@ -0,0 +1,14 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpAdapters } from '../config/mcp-config.js';
+import type { ContactPointAnalyzeInput } from '../schemas/input-schemas.js';
+/**
+ * Handler for cuneiform_contactpoint_analyze tool invocation.
+ *
+ * Analyzes a Salesforce object's fields to identify contact point fields
+ * such as email addresses, phone numbers, names, and social media identifiers.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleContactPointAnalyze(adapters: McpAdapters, params: ContactPointAnalyzeInput): Promise<CallToolResult>;

package/lib/mcp/tools/contactpoint-tools.js

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { ContactPointService } from '../../services/ContactPointService.js';
+import { McpErrorCodes } from '../errors.js';
+import { createMcpError, serviceResultToMcp, extractErrorMessage } from './tool-factory.js';
+/**
+ * Handler for cuneiform_contactpoint_analyze tool invocation.
+ *
+ * Analyzes a Salesforce object's fields to identify contact point fields
+ * such as email addresses, phone numbers, names, and social media identifiers.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleContactPointAnalyze(adapters, params) {
+    try {
+        const contactPointService = new ContactPointService({
+            restApiAdapter: adapters.rest,
+        });
+        // Execute contact point analysis
+        const result = await contactPointService.analyzeContactPoints(params.objectName);
+        return serviceResultToMcp(result);
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to analyze contact points: ${extractErrorMessage(error, 'handleContactPointAnalyze')}`);
+    }
+}
+//# sourceMappingURL=contactpoint-tools.js.map

package/lib/mcp/tools/contactpoint-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactpoint-tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/contactpoint-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE5F;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,QAAqB,EACrB,MAAgC;IAEhC,IAAI,CAAC;QACH,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,CAAC;YAClD,cAAc,EAAE,QAAQ,CAAC,IAAI;SAC9B,CAAC,CAAC;QAEH,iCAAiC;QACjC,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAEjF,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,cAAc,CACnB,aAAa,CAAC,sBAAsB,EACpC,qCAAqC,mBAAmB,CAAC,KAAK,EAAE,2BAA2B,CAAC,EAAE,CAC/F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/mcp/tools/definition-io-tools.d.ts

@@ -0,0 +1,19 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpAdapters } from '../config/mcp-config.js';
+import type { DefinitionExportInput, DefinitionImportInput } from '../schemas/input-schemas.js';
+/**
+ * Handler for cuneiform_definition_export tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult with file contents
+ */
+export declare function handleDefinitionExport(adapters: McpAdapters, params: DefinitionExportInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_definition_import tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleDefinitionImport(adapters: McpAdapters, params: DefinitionImportInput): Promise<CallToolResult>;

package/lib/mcp/tools/definition-io-tools.js

@@ -0,0 +1,152 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { SFDMUService } from '../../services/SFDMUService.js';
+import { DefinitionExportOperation, ExportErrorCodes } from '../../operations/DefinitionExportOperation.js';
+import { DefinitionImportOperation } from '../../operations/DefinitionImportOperation.js';
+import { McpErrorCodes } from '../errors.js';
+import { serviceResultToMcp, createMcpError, extractErrorMessage } from './tool-factory.js';
+/**
+ * Handler for cuneiform_definition_export tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult with file contents
+ */
+export async function handleDefinitionExport(adapters, params) {
+    let tempDir;
+    try {
+        // Generate a unique path without pre-creating the directory.
+        // Using a path-string-only approach (not mkdtempSync) so that DefinitionExportOperation
+        // can create the directory itself — it guards against accidental overwrites via existsSync,
+        // which would false-positive if mkdtempSync had already created the dir (F37).
+        tempDir = path.join(os.tmpdir(), `cuneiform-export-${crypto.randomBytes(3).toString('hex')}`);
+        // Initialize service and operation
+        const sfdmuService = new SFDMUService();
+        const exportOperation = new DefinitionExportOperation(sfdmuService);
+        // Get target org username
+        const targetOrg = adapters.connection.getUsername();
+        if (!targetOrg) {
+            return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, 'Could not determine target org username');
+        }
+        // Execute export to temp directory
+        const result = await exportOperation.execute({
+            targetOrg,
+            outputDir: tempDir,
+            excludeIds: params.excludeIds,
+        });
+        if (!result.success) {
+            // OUTPUT_DIR_EXISTS guidance ("Use a different path") is not actionable through the MCP
+            // interface — callers have no outputDir parameter. Rewrite it to a retry instruction.
+            if (result.errorCode === ExportErrorCodes.OUTPUT_DIR_EXISTS) {
+                return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, 'Export failed due to a temporary directory conflict. Retry the operation to generate a new unique path.');
+            }
+            return serviceResultToMcp(result);
+        }
+        // Read all exported files into memory and return them inline.
+        // MCP clients cannot access server-local filesystem paths, so file contents must be
+        // returned in the response payload rather than as disk paths (F36).
+        const files = [];
+        for (const filename of result.data.files) {
+            const filePath = path.join(tempDir, filename);
+            if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+                const ext = path.extname(filename).toLowerCase().slice(1);
+                files.push({ filename, content: fs.readFileSync(filePath, 'utf8'), format: ext || 'text' });
+            }
+        }
+        // Return success with inline file contents.
+        // Override the operation message — it references the server-local temp path, which is
+        // cleaned up in finally and is not meaningful to an MCP caller.
+        return serviceResultToMcp({
+            success: true,
+            data: {
+                definitionsExported: result.data.definitionsExported,
+                files,
+            },
+            message: `Successfully exported ${result.data.definitionsExported} definitions. ${files.length} file(s) returned inline in data.files.`,
+            warnings: result.warnings,
+        });
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to export definitions: ${extractErrorMessage(error, 'handleDefinitionExport')}`);
+    }
+    finally {
+        // Clean up temp directory
+        if (tempDir && fs.existsSync(tempDir)) {
+            try {
+                fs.rmSync(tempDir, { recursive: true, force: true });
+            }
+            catch (cleanupError) {
+                /* eslint-disable-next-line no-console -- MCP uses stderr for logging */
+                console.error(`[MCP] Warning: Failed to clean up temp directory ${tempDir}: ` +
+                    `${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`);
+            }
+        }
+    }
+}
+/**
+ * Handler for cuneiform_definition_import tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleDefinitionImport(adapters, params) {
+    let tempDir;
+    try {
+        // Generate a unique path then create the directory explicitly — consistent with the export
+        // handler pattern (path-string-only generation, not mkdtempSync).
+        tempDir = path.join(os.tmpdir(), `cuneiform-import-${crypto.randomBytes(3).toString('hex')}`);
+        fs.mkdirSync(tempDir, { recursive: true });
+        // Write file contents to temp directory with path traversal guard
+        for (const [filename, content] of Object.entries(params.fileContents)) {
+            const sanitized = path.basename(filename);
+            if (sanitized !== filename || filename.includes('..')) {
+                return createMcpError(McpErrorCodes.INVALID_TOOL_INPUT, `Invalid filename '${filename}': filenames must not contain path separators or '..' components`);
+            }
+            const filePath = path.join(tempDir, sanitized);
+            fs.writeFileSync(filePath, content, 'utf8');
+        }
+        // Initialize service and operation
+        const sfdmuService = new SFDMUService();
+        const importOperation = new DefinitionImportOperation(sfdmuService);
+        // Get target org username
+        const targetOrg = adapters.connection.getUsername();
+        if (!targetOrg) {
+            return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, 'Could not determine target org username');
+        }
+        // Execute import from temp directory
+        const result = await importOperation.execute({
+            targetOrg,
+            sourceDir: tempDir,
+            operation: params.operation,
+            simulation: params.simulation,
+        });
+        return serviceResultToMcp(result);
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to import definitions: ${extractErrorMessage(error, 'handleDefinitionImport')}`);
+    }
+    finally {
+        // Clean up temp directory
+        if (tempDir && fs.existsSync(tempDir)) {
+            try {
+                fs.rmSync(tempDir, { recursive: true, force: true });
+            }
+            catch (cleanupError) {
+                /* eslint-disable-next-line no-console -- MCP uses stderr for logging */
+                console.error(`[MCP] Warning: Failed to clean up temp directory ${tempDir}: ` +
+                    `${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=definition-io-tools.js.map

package/lib/mcp/tools/definition-io-tools.js.map

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

package/lib/mcp/tools/definition-tools.d.ts

@@ -0,0 +1,51 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpAdapters } from '../config/mcp-config.js';
+import type { DefinitionListInput, DefinitionGetInput, DefinitionGetByKeyInput, DefinitionCreateInput, DefinitionUpdateInput, DefinitionPurgeInput } from '../schemas/input-schemas.js';
+/**
+ * Handler for cuneiform_definition_list tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleDefinitionList(adapters: McpAdapters, params: DefinitionListInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_definition_get tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleDefinitionGet(adapters: McpAdapters, params: DefinitionGetInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_definition_get_by_key tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleDefinitionGetByKey(adapters: McpAdapters, params: DefinitionGetByKeyInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_definition_create tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleDefinitionCreate(adapters: McpAdapters, params: DefinitionCreateInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_definition_update tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleDefinitionUpdate(adapters: McpAdapters, params: DefinitionUpdateInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_definition_purge tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleDefinitionPurge(adapters: McpAdapters, params: DefinitionPurgeInput): Promise<CallToolResult>;