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

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

@@ -0,0 +1,327 @@
+/*
+ * 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 { ObjectDescribeService } from '../../services/ObjectDescribeService.js';
+import { ObjectFilteringService } from '../../services/ObjectFilteringService.js';
+import { ObjectListService } from '../../services/ObjectListService.js';
+import { RecordTypeService } from '../../services/RecordTypeService.js';
+import { TabDetectionService } from '../../services/TabDetectionService.js';
+import { parseNamespaceFilter } from '../../services/namespace-filter.js';
+import { decodeCursor, clampPageSize, createPaginationMetadata, PAGE_SIZE_DEFAULTS } from '../config/pagination.js';
+import { McpErrorCodes } from '../errors.js';
+import { OBJECT_DESCRIBE_SECTIONS } from '../schemas/input-schemas.js';
+import { serviceResultToMcp, serviceResultToMcpPaginated, createMcpError, extractErrorMessage, } from './tool-factory.js';
+/**
+ * Normalizes the MCP namespace input (string | string[]) into a single
+ * comma-separated string for the shared `parseNamespaceFilter` parser, then
+ * returns the resolved NamespaceFilter or undefined.
+ *
+ * @param raw - Raw MCP namespace input from the union schema
+ * @returns Parsed NamespaceFilter result (value or error)
+ */
+function normalizeMcpNamespace(raw) {
+    if (raw === undefined)
+        return { value: undefined };
+    const stringified = Array.isArray(raw) ? raw.join(',') : raw;
+    return parseNamespaceFilter(stringified);
+}
+/**
+ * Field type mapping from user-friendly categories to Salesforce field types.
+ */
+const FIELD_TYPE_MAP = {
+    text: ['string', 'textarea', 'url', 'email', 'phone'],
+    picklist: ['picklist', 'multipicklist'],
+    lookup: ['reference'],
+    number: ['double', 'currency', 'percent', 'int'],
+    date: ['date', 'datetime', 'time'],
+    formula: ['calculated'],
+    checkbox: ['boolean'],
+    id: ['id'],
+    address: ['address'],
+};
+/**
+ * Handler for cuneiform_object_list tool invocation.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleObjectList(adapters, params) {
+    try {
+        // Parse namespace input shape (string | string[]) into the typed
+        // NamespaceFilter at the MCP boundary (CLI-3801).
+        const namespaceResult = normalizeMcpNamespace(params.namespace);
+        if (namespaceResult.error) {
+            return createMcpError(McpErrorCodes.INVALID_TOOL_INPUT, namespaceResult.error);
+        }
+        // Pagination: decode cursor and clamp page size
+        const offset = decodeCursor(params.cursor);
+        const pageSize = clampPageSize(params.limit, PAGE_SIZE_DEFAULTS.OBJECT_LIST.default, PAGE_SIZE_DEFAULTS.OBJECT_LIST.max);
+        const { soql: soqlAdapter, tooling: toolingAdapter, rest: restAdapter } = adapters;
+        const filteringService = new ObjectFilteringService({
+            restApiAdapter: restAdapter,
+            soqlAdapter,
+        });
+        const tabService = new TabDetectionService({
+            toolingAdapter,
+        });
+        const contactPointService = new ContactPointService({
+            restApiAdapter: restAdapter,
+        });
+        const objectListService = new ObjectListService({
+            objectFilteringService: filteringService,
+            tabDetectionService: tabService,
+            contactPointService,
+        });
+        // Build filter options with name pattern
+        const nameFilter = params.pattern
+            ? {
+                value: params.pattern,
+                operator: 'contains',
+            }
+            : undefined;
+        // Execute object list query with pagination
+        const result = await objectListService.listObjects({
+            type: params.filter,
+            namespace: namespaceResult.value,
+            nameFilter,
+            withRecords: params.withRecords,
+            withoutRecords: params.withoutRecords,
+            limit: pageSize,
+            offset,
+            sort: params.sort
+                ? {
+                    field: params.sort,
+                    direction: 'asc',
+                }
+                : undefined,
+            includeTabs: true,
+            withContactPoints: params.contactPoints ?? false,
+        });
+        if (!result.success) {
+            return serviceResultToMcp(result);
+        }
+        // Build pagination metadata from service result
+        const pagination = createPaginationMetadata({
+            offset,
+            pageSize,
+            totalItems: result.data.totalCount,
+            returnedItems: result.data.returnedCount,
+        });
+        return serviceResultToMcpPaginated(result, pagination);
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to list objects: ${extractErrorMessage(error, 'handleObjectList')}`);
+    }
+}
+// ============================================================================
+// Object describe section handlers
+// ============================================================================
+/**
+ * Applies field type and pattern filters, then sorts.
+ */
+function filterAndSortFields(fields, fieldType, fieldPattern, sort) {
+    let result = fields;
+    if (fieldType) {
+        const allowedTypes = FIELD_TYPE_MAP[fieldType] || [fieldType];
+        result = result.filter((f) => allowedTypes.includes(f.type.toLowerCase()));
+    }
+    if (fieldPattern) {
+        const pattern = fieldPattern.toLowerCase();
+        result = result.filter((f) => f.name.toLowerCase().includes(pattern));
+    }
+    if (sort) {
+        result = [...result].sort((a, b) => {
+            if (sort === 'type')
+                return a.type.localeCompare(b.type);
+            if (sort === 'label')
+                return a.label.localeCompare(b.label);
+            return a.name.localeCompare(b.name);
+        });
+    }
+    return result;
+}
+/**
+ * Handles the summary section — object metadata + field classification + availableSections.
+ */
+async function handleDescribeSummary(describeService, objectName) {
+    const result = await describeService.describeObject(objectName);
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const obj = result.data;
+    return serviceResultToMcp({
+        success: true,
+        data: {
+            objectName: obj.objectName,
+            label: obj.label,
+            labelPlural: obj.labelPlural,
+            isCustom: obj.isCustom,
+            isQueryable: obj.isQueryable,
+            isCreateable: obj.isCreateable,
+            isUpdateable: obj.isUpdateable,
+            isDeletable: obj.isDeletable,
+            isSearchable: obj.isSearchable,
+            fieldClassification: obj.fieldClassification,
+            availableSections: [...OBJECT_DESCRIBE_SECTIONS],
+        },
+        message: `Summary for ${obj.objectName} (${obj.fieldClassification.totalFields} fields)`,
+    });
+}
+/**
+ * Handles the fields section — paginated fields with filtering and sorting.
+ */
+async function handleDescribeFields(describeService, params) {
+    const result = await describeService.describeObject(params.objectName);
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const filtered = filterAndSortFields(result.data.fields, params.fieldType, params.fieldPattern, params.sort);
+    const offset = decodeCursor(params.cursor);
+    const pageSize = clampPageSize(params.limit, PAGE_SIZE_DEFAULTS.FIELD_LIST.default, PAGE_SIZE_DEFAULTS.FIELD_LIST.max);
+    const page = filtered.slice(offset, offset + pageSize);
+    const pagination = createPaginationMetadata({
+        offset,
+        pageSize,
+        totalItems: filtered.length,
+        returnedItems: page.length,
+    });
+    return serviceResultToMcpPaginated({
+        success: true,
+        data: page,
+        message: `Fields for ${params.objectName}`,
+    }, pagination);
+}
+/**
+ * Handles the fieldDistribution section — field type counts.
+ */
+async function handleDescribeFieldDistribution(describeService, objectName) {
+    const result = await describeService.describeObject(objectName);
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const distResult = ObjectDescribeService.getFieldTypeDistribution(result.data.fields);
+    if (!distResult.success) {
+        return serviceResultToMcp(distResult);
+    }
+    return serviceResultToMcp({
+        success: true,
+        data: {
+            objectName,
+            totalFields: result.data.fields.length,
+            distribution: distResult.data,
+        },
+        message: `Field distribution for ${objectName}`,
+    });
+}
+/**
+ * Handles the recordTypes section — record types with pagination.
+ */
+async function handleDescribeRecordTypes(soqlAdapter, params) {
+    const recordTypeService = new RecordTypeService({ soqlAdapter });
+    const result = await recordTypeService.getRecordTypes(params.objectName);
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const offset = decodeCursor(params.cursor);
+    const pageSize = clampPageSize(params.limit, PAGE_SIZE_DEFAULTS.RECORD_TYPE_LIST.default, PAGE_SIZE_DEFAULTS.RECORD_TYPE_LIST.max);
+    const page = result.data.slice(offset, offset + pageSize);
+    const pagination = createPaginationMetadata({
+        offset,
+        pageSize,
+        totalItems: result.data.length,
+        returnedItems: page.length,
+    });
+    return serviceResultToMcpPaginated({
+        success: true,
+        data: page,
+        message: `Record types for ${params.objectName}`,
+    }, pagination);
+}
+/**
+ * Handles the relationships section — lookup fields and external references with pagination.
+ */
+async function handleDescribeRelationships(describeService, params) {
+    const result = await describeService.describeObject(params.objectName);
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const relationships = result.data.relationships;
+    // If relationship data is unavailable, return success with explicit warning
+    // rather than silently synthesizing empty arrays (which masks API/permission issues)
+    if (!relationships) {
+        return serviceResultToMcpPaginated({
+            success: true,
+            data: { items: [] },
+            warnings: [
+                'Relationship metadata was not returned by the describe API. ' +
+                    'This may indicate insufficient permissions or an API limitation.',
+            ],
+            message: `Relationships for ${params.objectName} (data unavailable)`,
+        }, createPaginationMetadata({ offset: 0, pageSize: 1, totalItems: 0, returnedItems: 0 }));
+    }
+    const allItems = [
+        ...relationships.lookupFields.map((lf) => ({ kind: 'lookup', ...lf })),
+        ...relationships.referencedBy.map((rb) => ({ kind: 'referencedBy', ...rb })),
+    ];
+    const offset = decodeCursor(params.cursor);
+    const pageSize = clampPageSize(params.limit, PAGE_SIZE_DEFAULTS.RELATIONSHIP_LIST.default, PAGE_SIZE_DEFAULTS.RELATIONSHIP_LIST.max);
+    const page = allItems.slice(offset, offset + pageSize);
+    const pagination = createPaginationMetadata({
+        offset,
+        pageSize,
+        totalItems: allItems.length,
+        returnedItems: page.length,
+    });
+    return serviceResultToMcpPaginated({
+        success: true,
+        data: {
+            referencedByCount: relationships.referencedByCount,
+            lookupFieldCount: relationships.lookupFields.length,
+            items: page,
+        },
+        message: `Relationships for ${params.objectName}`,
+    }, pagination);
+}
+/**
+ * Handler for cuneiform_object_describe tool invocation.
+ *
+ * Routes by section parameter to return one section per call,
+ * keeping responses within LLM context budgets (~3 KB max).
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleObjectDescribe(adapters, params) {
+    try {
+        const { soql: soqlAdapter, rest: restAdapter } = adapters;
+        const describeService = new ObjectDescribeService({
+            restApiAdapter: restAdapter,
+            soqlAdapter,
+        });
+        switch (params.section) {
+            case 'summary':
+                return await handleDescribeSummary(describeService, params.objectName);
+            case 'fields':
+                return await handleDescribeFields(describeService, params);
+            case 'fieldDistribution':
+                return await handleDescribeFieldDistribution(describeService, params.objectName);
+            case 'recordTypes':
+                return await handleDescribeRecordTypes(soqlAdapter, params);
+            case 'relationships':
+                return await handleDescribeRelationships(describeService, params);
+            default:
+                return createMcpError(McpErrorCodes.INVALID_TOOL_INPUT, `Unknown section: ${String(params.section)}`);
+        }
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to describe object: ${extractErrorMessage(error, 'handleObjectDescribe')}`);
+    }
+}
+//# sourceMappingURL=object-tools.js.map

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

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

package/lib/mcp/tools/org-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 OrgDetailsInput } from '../schemas/input-schemas.js';
+/**
+ * Handler for cuneiform_org_details tool invocation.
+ *
+ * Routes by section parameter to return one section per call,
+ * keeping responses within LLM context budgets (~3 KB max).
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleOrgDetails(adapters: McpAdapters, params: OrgDetailsInput): Promise<CallToolResult>;

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

@@ -0,0 +1,177 @@
+/*
+ * 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 { OrgInfoService } from '../../services/OrgInfoService.js';
+import { decodeCursor, clampPageSize, createPaginationMetadata, PAGE_SIZE_DEFAULTS } from '../config/pagination.js';
+import { McpErrorCodes } from '../errors.js';
+import { ORG_DETAILS_SECTIONS } from '../schemas/input-schemas.js';
+import { serviceResultToMcp, serviceResultToMcpPaginated, createMcpError, extractErrorMessage, } from './tool-factory.js';
+/**
+ * Handles the identity section — org identity with available sections list.
+ */
+async function handleIdentitySection(orgInfoService, facade) {
+    const result = await orgInfoService.getOrgIdentity();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const identity = result.data;
+    const orgType = OrgInfoService.classifyOrgType(identity.isSandbox, identity.organizationType);
+    return serviceResultToMcp({
+        success: true,
+        data: {
+            orgId: identity.organizationId,
+            orgName: identity.organizationName ?? null,
+            orgType,
+            edition: identity.organizationType ?? null,
+            namespace: identity.namespacePrefix ?? null,
+            instanceUrl: facade.instanceUrl ?? null,
+            username: identity.username,
+            availableSections: [...ORG_DETAILS_SECTIONS],
+        },
+        message: `Org identity for ${identity.organizationName ?? identity.organizationId}`,
+    });
+}
+/**
+ * Handles the cuneiform section — package installation status.
+ */
+async function handleCuneiformSection(orgInfoService) {
+    const result = await orgInfoService.getCuneiformPackageInfo();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    return serviceResultToMcp({
+        success: true,
+        data: {
+            installed: result.data.installed,
+            version: result.data.version ?? null,
+            licenseStatus: result.data.licenseStatus,
+        },
+        message: 'Cuneiform package info retrieved',
+    });
+}
+/**
+ * Handles the features section — detected org features.
+ */
+async function handleFeaturesSection(orgInfoService) {
+    const result = await orgInfoService.getOrgFeatures();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    return serviceResultToMcp({
+        success: true,
+        data: result.data,
+        message: 'Org features retrieved',
+    });
+}
+/**
+ * Handles the clouds section — detected Salesforce clouds with pagination.
+ */
+async function handleCloudsSection(orgInfoService, cursor, limit) {
+    const offset = decodeCursor(cursor);
+    const pageSize = clampPageSize(limit, PAGE_SIZE_DEFAULTS.NAMESPACE_LIST.default, PAGE_SIZE_DEFAULTS.NAMESPACE_LIST.max);
+    const result = await orgInfoService.getDetectedClouds();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const allClouds = result.data;
+    const page = allClouds.slice(offset, offset + pageSize);
+    const pagination = createPaginationMetadata({
+        offset,
+        pageSize,
+        totalItems: allClouds.length,
+        returnedItems: page.length,
+    });
+    return serviceResultToMcpPaginated({ success: true, data: page, message: 'Detected clouds retrieved' }, pagination);
+}
+/**
+ * Handles the namespaces section — installed namespaces with pagination.
+ */
+async function handleNamespacesSection(orgInfoService, cursor, limit) {
+    const offset = decodeCursor(cursor);
+    const pageSize = clampPageSize(limit, PAGE_SIZE_DEFAULTS.NAMESPACE_LIST.default, PAGE_SIZE_DEFAULTS.NAMESPACE_LIST.max);
+    const result = await orgInfoService.getInstalledNamespaces();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const allNamespaces = result.data.namespaces;
+    const page = allNamespaces.slice(offset, offset + pageSize);
+    const pagination = createPaginationMetadata({
+        offset,
+        pageSize,
+        totalItems: allNamespaces.length,
+        returnedItems: page.length,
+    });
+    return serviceResultToMcpPaginated({
+        success: true,
+        data: { count: allNamespaces.length, namespaces: page },
+        message: `Installed namespaces retrieved (${allNamespaces.length} total)`,
+    }, pagination);
+}
+/**
+ * Handles the limits section — org API limits.
+ */
+async function handleLimitsSection(orgInfoService) {
+    const result = await orgInfoService.getOrgLimits();
+    if (!result.success) {
+        return serviceResultToMcp(result);
+    }
+    const limits = result.data;
+    return serviceResultToMcp({
+        success: true,
+        data: {
+            dailyApiRequests: limits.dailyApiRequests ?? null,
+            dataStorageMB: limits.dataStorageMB ?? null,
+            fileStorageMB: limits.fileStorageMB ?? null,
+            dailyBulkApiRequests: limits.dailyBulkApiRequests ?? null,
+            dailyBulkV2QueryJobs: limits.dailyBulkV2QueryJobs ?? null,
+            dailyAsyncApexExecutions: limits.dailyAsyncApexExecutions ?? null,
+            dailyStreamingApiEvents: limits.dailyStreamingApiEvents ?? null,
+        },
+        message: 'Org limits retrieved',
+    });
+}
+/**
+ * Handler for cuneiform_org_details tool invocation.
+ *
+ * Routes by section parameter to return one section per call,
+ * keeping responses within LLM context budgets (~3 KB max).
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export async function handleOrgDetails(adapters, params) {
+    try {
+        const { facade, soql: soqlAdapter, tooling: toolingAdapter, rest: restAdapter } = adapters;
+        const orgInfoService = new OrgInfoService({
+            connectionFacade: facade,
+            soqlAdapter,
+            toolingAdapter,
+            restAdapter,
+        });
+        switch (params.section) {
+            case 'identity':
+                return await handleIdentitySection(orgInfoService, facade);
+            case 'cuneiform':
+                return await handleCuneiformSection(orgInfoService);
+            case 'features':
+                return await handleFeaturesSection(orgInfoService);
+            case 'clouds':
+                return await handleCloudsSection(orgInfoService, params.cursor, params.limit);
+            case 'namespaces':
+                return await handleNamespacesSection(orgInfoService, params.cursor, params.limit);
+            case 'limits':
+                return await handleLimitsSection(orgInfoService);
+            default:
+                return createMcpError(McpErrorCodes.INVALID_TOOL_INPUT, `Unknown section: ${String(params.section)}`);
+        }
+    }
+    catch (error) {
+        return createMcpError(McpErrorCodes.TOOL_INVOCATION_FAILED, `Failed to get org details: ${extractErrorMessage(error, 'handleOrgDetails')}`);
+    }
+}
+//# sourceMappingURL=org-tools.js.map

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

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

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

@@ -0,0 +1,59 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { McpAdapters } from '../config/mcp-config.js';
+import type { ProfileExecuteInput, ProfileStatusInput, ProfileCancelInput, ProfileDeleteInput, RequestListInput } from '../schemas/input-schemas.js';
+/**
+ * Handler for cuneiform_request_list tool invocation.
+ *
+ * Lists profiling requests with optional status filtering and pagination.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleRequestList(adapters: McpAdapters, params: RequestListInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_profile_execute tool invocation.
+ *
+ * Executes profiling for a definition and optionally waits for completion.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleProfileExecute(adapters: McpAdapters, params: ProfileExecuteInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_profile_status tool invocation.
+ *
+ * Retrieves status for one or more profiling requests in parallel.
+ * Not-found IDs are surfaced as a "Not Found" row — no hard error.
+ * Other service errors (e.g. SOQL failure) propagate as hard errors.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult with statuses array and summary counts
+ */
+export declare function handleProfileStatus(adapters: McpAdapters, params: ProfileStatusInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_profile_cancel tool invocation.
+ *
+ * Cancels profiling jobs by request ID (single cancellation) or definition ID
+ * (bulk cancellation — queries active requests for the definition, then cancels them).
+ *
+ * Uses ProfileRequestService directly instead of the ProfilingExecutionService facade.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleProfileCancel(adapters: McpAdapters, params: ProfileCancelInput): Promise<CallToolResult>;
+/**
+ * Handler for cuneiform_profile_delete tool invocation.
+ *
+ * Deletes terminal (Canceled) profiling requests by ID. This operation is irreversible.
+ * Only requests in the Canceled state can be deleted — the service enforces this constraint.
+ *
+ * @param adapters - Session-scoped MCP adapters
+ * @param params - Validated input from MCP SDK
+ * @returns MCP CallToolResult
+ */
+export declare function handleProfileDelete(adapters: McpAdapters, params: ProfileDeleteInput): Promise<CallToolResult>;