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

package/lib/mcp/schemas/input-schemas.js

@@ -0,0 +1,302 @@
+/*
+ * 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.
+ */
+/* eslint-disable import/no-extraneous-dependencies -- zod is listed in dependencies */
+import { z } from 'zod';
+/* eslint-enable import/no-extraneous-dependencies */
+/**
+ * Zod schema for Salesforce 15/18 character record IDs.
+ * Mirrors the pattern in `src/services/validation.ts` for schema-level validation.
+ */
+const salesforceId = (fieldDescription) => z
+    .string()
+    .regex(/^[a-zA-Z0-9]{15}([a-zA-Z0-9]{3})?$/, 'Must be a valid Salesforce ID (15 or 18 alphanumeric characters)')
+    .describe(fieldDescription);
+/**
+ * Available sections for the org details tool.
+ */
+export const ORG_DETAILS_SECTIONS = ['identity', 'cuneiform', 'features', 'clouds', 'namespaces', 'limits'];
+/**
+ * Input schema for cuneiform_org_details tool.
+ */
+export const OrgDetailsInputSchema = z.object({
+    section: z
+        .enum(ORG_DETAILS_SECTIONS)
+        .optional()
+        .default('identity')
+        .describe('Section to retrieve. Start with identity to see all available sections.'),
+    cursor: z.string().optional().describe('Opaque cursor for paginated sections (clouds, namespaces)'),
+    limit: z.number().int().optional().describe('Page size for paginated sections (default 10, max 25)'),
+});
+/**
+ * Input schema for cuneiform_object_list tool.
+ */
+export const ObjectListInputSchema = z
+    .object({
+    filter: z.enum(['all', 'standard', 'custom']).optional().default('all').describe('Filter objects by type'),
+    namespace: z.string().optional().describe('Filter by namespace prefix'),
+    pattern: z.string().optional().describe('Filter by object name pattern (case-insensitive substring)'),
+    withRecords: z.boolean().optional().describe('Include only objects with records'),
+    withoutRecords: z.boolean().optional().describe('Include only objects without records'),
+    contactPoints: z.boolean().optional().describe('Include only contact point objects'),
+    minRecords: z.number().int().optional().default(0).describe('Minimum record count'),
+    sort: z.enum(['name', 'recordCount', 'label']).optional().describe('Sort field'),
+    limit: z.number().int().optional().describe('Maximum number of results per page (default 25, max 50)'),
+    cursor: z.string().optional().describe('Opaque cursor from a previous response to retrieve the next page'),
+})
+    .refine((data) => !(data.withRecords && data.withoutRecords), {
+    message: 'withRecords and withoutRecords are mutually exclusive',
+});
+/**
+ * Input schema for cuneiform_user_details tool.
+ */
+export const UserDetailsInputSchema = z.object({});
+/**
+ * Available sections for the object describe tool.
+ */
+export const OBJECT_DESCRIBE_SECTIONS = [
+    'summary',
+    'fields',
+    'fieldDistribution',
+    'recordTypes',
+    'relationships',
+];
+/**
+ * Input schema for cuneiform_object_describe tool.
+ */
+export const ObjectDescribeInputSchema = z.object({
+    objectName: z.string().describe('Single object API name (e.g., "Account", "Contact", "CustomObject__c")'),
+    section: z
+        .enum(OBJECT_DESCRIBE_SECTIONS)
+        .optional()
+        .default('summary')
+        .describe('Section to retrieve. Start with summary to see available sections.'),
+    fieldType: z
+        .enum(['text', 'picklist', 'lookup', 'number', 'date', 'formula', 'checkbox', 'id', 'address'])
+        .optional()
+        .describe('Filter fields by type (fields section only)'),
+    fieldPattern: z.string().optional().describe('Filter fields by name pattern (fields section only)'),
+    sort: z.enum(['name', 'type', 'label']).optional().default('name').describe('Sort fields by (fields section only)'),
+    cursor: z.string().optional().describe('Opaque cursor for paginated sections (fields, recordTypes, relationships)'),
+    limit: z.number().int().optional().describe('Page size for paginated sections'),
+});
+/**
+ * Input schema for cuneiform_user_configure tool.
+ */
+export const UserConfigureInputSchema = z.object({
+    dryRun: z.boolean().describe('Preview changes without applying them (REQUIRED to be true on first call)'),
+});
+/**
+ * Input schema for cuneiform_definition_list tool.
+ */
+export const DefinitionListInputSchema = z.object({
+    objectName: z.string().optional().describe('Filter by target object API name'),
+    status: z.enum(['NOT PROFILED', 'IN PROGRESS', 'SUCCESS', 'ERROR']).optional().describe('Filter by profiling status'),
+    isActive: z.boolean().optional().describe('Filter by active status'),
+    limit: z.number().int().min(1).max(200).optional().default(50).describe('Maximum number of results'),
+});
+/**
+ * Input schema for cuneiform_definition_get tool.
+ */
+export const DefinitionGetInputSchema = z.object({
+    definitionId: salesforceId('Salesforce ID of the profiling definition'),
+});
+/**
+ * Input schema for cuneiform_definition_get_by_key tool.
+ * Mirrors the CLI command sf cuneiform definition get.
+ */
+export const DefinitionGetByKeyInputSchema = z.object({
+    keys: z.array(z.string().min(1)).min(1).describe('Definition keys to retrieve (e.g., PD-0001)'),
+});
+/**
+ * Input schema for cuneiform_definition_update tool.
+ */
+export const DefinitionUpdateInputSchema = z
+    .object({
+    definitionId: salesforceId('Salesforce ID of the profiling definition to update'),
+    name: z.string().max(255).optional().describe('New definition name (max 255 characters)'),
+    category: z.string().max(255).optional().describe('New category label (max 255 characters)'),
+    timeCategory: z
+        .string()
+        .max(255)
+        .optional()
+        .describe('New time category label (max 255 characters, e.g. "Q1 2025", "Lifetime")'),
+    segmentCategory: z
+        .string()
+        .max(255)
+        .optional()
+        .describe('New segment category label (max 255 characters, e.g. "Closed Won", "PersonAccounts")'),
+    description: z.string().max(8192).optional().describe('New description (max 8192 characters, supports HTML)'),
+})
+    .refine((data) => data.name !== undefined ||
+    data.category !== undefined ||
+    data.timeCategory !== undefined ||
+    data.segmentCategory !== undefined ||
+    data.description !== undefined, { message: 'At least one attribute (name, category, timeCategory, segmentCategory, description) must be provided' });
+/**
+ * Input schema for cuneiform_definition_export tool.
+ */
+export const DefinitionExportInputSchema = z.object({
+    excludeIds: z.boolean().optional().default(false).describe('Exclude Salesforce IDs for VCS-friendly output'),
+});
+/**
+ * Input schema for cuneiform_definition_import tool.
+ */
+export const DefinitionImportInputSchema = z.object({
+    fileContents: z.record(z.string(), z.string()).describe('Map of filename to CSV/JSON content'),
+    operation: z.enum(['Insert', 'Upsert']).optional().default('Insert').describe('Import operation type'),
+    simulation: z.boolean().default(true).describe('Simulate import without changes (REQUIRED first)'),
+});
+/**
+ * Input schema for cuneiform_contactpoint_analyze tool.
+ */
+export const ContactPointAnalyzeInputSchema = z.object({
+    objectName: z.string().describe('Salesforce object API name (e.g., "Contact", "Account", "Custom_Object__c")'),
+});
+/**
+ * Input schema for cuneiform_definition_create tool.
+ * Mirrors the CLI command sf cuneiform definition create.
+ */
+export const DefinitionCreateInputSchema = z
+    .object({
+    type: z
+        .enum(['all', 'standard', 'custom'])
+        .optional()
+        .default('all')
+        .describe('Filter objects by type: all, standard, or custom (ignored when objects is supplied)'),
+    namespace: z.string().optional().describe('Filter objects by namespace prefix (ignored when objects is supplied)'),
+    classification: z
+        .enum(['customer', 'internal', 'all'])
+        .optional()
+        .default('customer')
+        .describe('Filter by object classification (ignored when objects is supplied)'),
+    withRecords: z
+        .boolean()
+        .optional()
+        .describe('Include only objects that have records (ignored when objects is supplied)'),
+    withoutRecords: z
+        .boolean()
+        .optional()
+        .describe('Include only objects that have no records (ignored when objects is supplied)'),
+    objects: z
+        .array(z.string())
+        .optional()
+        .describe('Explicit object API names to create definitions for. Mirrors the CLI --objects flag. ' +
+        'When supplied, overrides the filter parameters (type, namespace, classification, withRecords, withoutRecords) — ' +
+        'those values are ignored for object selection. Unknown names produce per-object warnings; ' +
+        'the run fails only if none of the supplied names resolve.'),
+    category: z.string().optional().describe('Category to assign to created definitions'),
+    description: z.string().optional().describe('Description to assign to created definitions'),
+    dryRun: z.boolean().default(true).describe('Preview what would be created without making changes (REQUIRED first)'),
+})
+    .refine((data) => !(data.withRecords && data.withoutRecords), {
+    message: 'withRecords and withoutRecords are mutually exclusive',
+});
+/**
+ * Input schema for cuneiform_definition_purge tool.
+ * Mirrors the CLI command sf cuneiform definition purge.
+ */
+export const DefinitionPurgeInputSchema = z.object({
+    objectName: z.string().optional().describe('Filter definitions by target object API name'),
+    category: z.string().optional().describe('Filter definitions by category'),
+    isActive: z.boolean().optional().describe('Filter definitions by active status'),
+});
+/**
+ * Input schema for cuneiform_summary_list tool.
+ */
+export const SummaryListInputSchema = z.object({
+    definitionId: salesforceId('Salesforce ID of the profiling definition'),
+    limit: z.number().int().min(1).max(200).optional().default(50).describe('Maximum number of results'),
+    offset: z.number().int().min(0).optional().default(0).describe('Number of records to skip for pagination'),
+});
+/**
+ * Profile request status values.
+ */
+const profileRequestStatusSchema = z.enum(['Queued', 'Canceled', 'Completed', 'Rejected']);
+/**
+ * Input schema for cuneiform_request_list tool.
+ */
+export const RequestListInputSchema = z.object({
+    status: z
+        .union([profileRequestStatusSchema, z.array(profileRequestStatusSchema).min(1)])
+        .optional()
+        .describe('Filter by status: single value (e.g. "Queued") or array (e.g. ["Queued", "Completed"]). Omit to list all.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .default(25)
+        .describe('Maximum number of results (default 25, max 200)'),
+    offset: z.number().int().min(0).optional().default(0).describe('Number of records to skip for pagination'),
+});
+/**
+ * Input schema for cuneiform_profile_execute tool.
+ */
+export const ProfileExecuteInputSchema = z.object({
+    definitionId: salesforceId('Salesforce ID of the profiling definition to execute'),
+    wait: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Wait for profiling to complete before returning (default: true)'),
+    timeoutMs: z
+        .number()
+        .int()
+        .min(10_000)
+        .max(3_600_000)
+        .optional()
+        .describe('Maximum time to wait for completion in milliseconds (10s-1hr, default: 30min)'),
+});
+/**
+ * Input schema for cuneiform_profile_status tool.
+ *
+ * Accepts one or more request IDs for batch status checks.
+ * Pass a single ID in the array for single-request status (backwards-compatible).
+ */
+export const ProfileStatusInputSchema = z.object({
+    requestIds: z
+        .array(salesforceId('Salesforce ID of a profiling request'))
+        .min(1)
+        .describe('One or more profiling request IDs to check status for. ' +
+        'Pass a single ID in the array for single-request status. ' +
+        'Not-found IDs are included in the response with status "Not Found" — no hard error.'),
+});
+/**
+ * Input schema for cuneiform_profile_cancel tool.
+ *
+ * Supports two mutually exclusive modes:
+ * - requestId: Cancel a single profiling request
+ * - definitionId: Cancel all active requests for a definition
+ *
+ * Exactly one of requestId or definitionId must be provided.
+ */
+export const ProfileCancelInputSchema = z
+    .object({
+    requestId: salesforceId('Cancel specific profiling request').optional(),
+    definitionId: salesforceId('Cancel all requests for definition').optional(),
+})
+    .refine((data) => data.requestId ?? data.definitionId, {
+    message: 'Either requestId or definitionId must be provided',
+})
+    .refine((data) => !(data.requestId && data.definitionId), {
+    message: 'Only one of requestId or definitionId should be provided',
+});
+/**
+ * Input schema for cuneiform_profile_delete tool.
+ *
+ * Only Canceled requests can be deleted — the service enforces this constraint.
+ * Maximum of 200 IDs per call matches the service-layer bulk limit.
+ */
+export const ProfileDeleteInputSchema = z.object({
+    requestIds: z
+        .array(salesforceId('Salesforce ID of a profiling request to delete'))
+        .min(1, 'At least one request ID must be provided')
+        .max(200, 'Maximum of 200 request IDs per call'),
+});
+//# sourceMappingURL=input-schemas.js.map

package/lib/mcp/schemas/input-schemas.js.map

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

package/lib/mcp/server.d.ts

@@ -0,0 +1,40 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AnySchema, ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+import type { Connection } from '@salesforce/core';
+import { type McpServerConfig } from './config/mcp-config.js';
+import type { ToolHandler } from './tools/index.js';
+/**
+ * Tool registration entry for declarative tool setup.
+ */
+type ToolRegistration = {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: AnySchema | ZodRawShapeCompat;
+    readonly handler: ToolHandler;
+};
+/**
+ * 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.
+ */
+export declare function getToolRegistrations(): ToolRegistration[];
+/**
+ * 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 declare function createMcpServer(config: McpServerConfig, connection: Connection): McpServer;
+/**
+ * Starts the MCP server with stdio transport.
+ *
+ * @param server - Configured McpServer instance
+ * @param debug - Enable debug logging
+ */
+export declare function startMcpServer(server: McpServer, debug?: boolean): Promise<void>;
+export {};