salesforce-metadata-mcp 2.5.2 → 2.5.4

package/dist/schemas/index.js

@@ -858,92 +858,37 @@ export const CreateExperiencePageSchema = z.object({
 }).strict();
 // ─── AGENTFORCE ───────────────────────────────────────────────────────────────
 export const CreateAgentSchema = z.object({
-    agentName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Agent API name, e.g. 'CRM_Record_Creator'. IMMUTABLE after creation."),
-    label: z.string().min(1).max(255).describe("Agent display label, e.g. 'CRM Record Creator'"),
-    description: z.string().max(1000).optional().describe("Agent description"),
-    type: z.enum(["EinsteinCopilot", "ExternalCopilot"]).default("EinsteinCopilot").describe("Bot type: 'EinsteinCopilot' for internal employee agents (shown in Lightning sidebar), 'ExternalCopilot' for customer-facing Agentforce Service Agents. CANNOT be changed after creation."),
-    systemPrompt: z.string().max(32000).optional().describe("Custom system prompt to override the agent's default behavior and persona. Injected into the agent's context before every conversation."),
-    openingMessage: z.string().max(2000).optional().describe("Welcome message shown to users when they first open the agent (set as welcomeMessage on the Bot)."),
+    agentName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Agent API name, e.g. 'SupportAgent'"),
+    label: z.string().min(1).max(255).describe("Agent display name"),
+    description: z.string().max(1000).optional().describe("Agent description shown to users"),
+    type: z.enum(["Default", "EinsteinCopilot"]).default("EinsteinCopilot").describe("Agent type"),
+    company: z.string().max(255).optional().describe("Company name for the agent's context"),
+    persona: z.string().max(5000).optional().describe("Agent persona description, e.g. 'A helpful customer service representative'"),
+    tone: z.enum(["Formal", "Neutral", "Casual"]).default("Neutral").describe("Communication tone"),
+    instructions: z.string().max(10000).optional().describe("System-level instructions for the agent"),
 }).strict();
 export const CreateAgentTopicSchema = z.object({
-    topicName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Topic API name, e.g. 'Create_Account_Topic'. Used as the GenAiPlugin developer name."),
-    label: z.string().min(1).max(255).describe("Topic display label, e.g. 'Create Account Topic'"),
-    description: z.string().min(1).max(5000).describe("Routing description — the LLM uses this to decide which topic handles a user request. Be specific, e.g. 'Use this topic when the user wants to create, add, or make a new Account or company record'"),
-    scope: z.string().min(1).max(5000).describe("What this topic covers in detail, e.g. 'Create new Account records with company name, industry, phone, and website'"),
-    instructions: z.array(z.string().max(2000)).optional().describe("Ordered step-by-step instructions for the agent, e.g. ['Ask the user for the account name', 'Call the Create Account action', 'Confirm success to the user']"),
-    actions: z.array(z.string().max(80)).optional().describe("Action API names (GenAiFunction developer names) to associate, e.g. ['Create_Account']. Create actions first with sf_create_agent_action."),
-    escalationEnabled: z.boolean().optional().describe("Whether this topic can escalate to a human agent (sets canEscalate on GenAiPlugin). Default: false."),
-    fallbackTopic: z.string().max(80).optional().describe("API name of another GenAiPlugin topic to fall back to if this topic cannot handle the request."),
-}).strict();
-const AgentParamSchema = z.object({
-    name: z.string().max(80).describe("Parameter API name matching the flow variable name, e.g. 'AccountName'"),
-    label: z.string().max(255).describe("Human-readable label, e.g. 'Account Name'"),
-    description: z.string().max(1000).optional().describe("Description shown to the LLM, e.g. 'The name of the company or organization'"),
-    type: z.enum(["Text", "Number", "Currency", "Boolean", "Date", "DateTime", "TextArea"]).default("Text").describe("Data type — must match the flow variable type: 'Currency'/'Number' for numeric fields, 'Date' for date fields, 'Boolean' for checkboxes, 'Text' for everything else"),
-    required: z.boolean().default(true).describe("Whether this input is required"),
-});
+    agentName: z.string().min(1).max(80).describe("Parent agent API name"),
+    topicName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Topic API name, e.g. 'OrderManagement'"),
+    label: z.string().min(1).max(255).describe("Topic label"),
+    description: z.string().min(1).max(5000).describe("What this topic covers"),
+    scope: z.string().min(1).max(5000).describe("Scope of this topic — what kind of requests it handles"),
+    instructions: z.string().max(10000).optional().describe("Step-by-step instructions for handling this topic"),
+    actions: z.array(z.string().max(80)).optional().describe("Action API names to associate with this topic"),
+}).strict();
 export const CreateAgentActionSchema = z.object({
-    actionName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Action API name (GenAiFunction developer name), e.g. 'Create_Account'. Used to reference this action from topics."),
-    label: z.string().min(1).max(255).describe("Action display label, e.g. 'Create Account'"),
-    description: z.string().min(1).max(5000).describe("What this action does — the LLM uses this to decide when to invoke it. Be specific, e.g. 'Creates a new Account record in Salesforce with the given company name, industry, phone, and website'"),
-    invocationTargetType: z.enum(["Flow", "ApexClass"]).default("Flow").describe("Type of backend to invoke: 'Flow' for AutoLaunchedFlow (most common), 'ApexClass' for an Apex class implementing InvocableMethod."),
-    flowApiName: z.string().max(255).optional().describe("API name of the AutoLaunchedFlow to invoke (required when invocationTargetType is Flow). Must be Active with runInMode=SystemModeWithoutSharing."),
-    apexClassName: z.string().max(255).optional().describe("API name of the Apex class to invoke (required when invocationTargetType is ApexClass). Class must have an @InvocableMethod."),
-    inputs: z.array(AgentParamSchema).optional().describe("Input parameters. Each becomes a parameter the LLM collects from the user. Type MUST match the flow variable / Apex param type."),
-    outputs: z.array(AgentParamSchema.omit({ required: true })).optional().describe("Output parameters returned to the agent after execution, e.g. the created record ID"),
-}).strict();
-export const CreateAgentPlannerSchema = z.object({
-    plannerName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Planner API name, e.g. 'CRM_Creator_Planner'. NOTE: Names are permanently reserved even after deletion — use a unique name."),
-    label: z.string().min(1).max(255).describe("Planner display label, e.g. 'CRM Creator Planner'"),
-    description: z.string().max(1000).optional().describe("Planner description"),
-    topicNames: z.array(z.string().min(1).max(80)).min(1).describe("Topic API names (GenAiPlugin developer names) to include, e.g. ['Create_Account_Topic', 'Create_Lead_Topic']. Topics must already exist."),
-    dataLibraryName: z.string().max(80).optional().describe("API name of a Data Library (Knowledge Base) to attach to this planner for Knowledge-grounded agents."),
-}).strict();
-export const ActivateAgentSchema = z.object({
-    agentApiName: z.string().min(1).max(80).describe("API name of the agent to activate, e.g. 'CRM_Record_Creator'"),
-}).strict();
-export const DeactivateAgentSchema = z.object({
-    agentApiName: z.string().min(1).max(80).describe("API name of the agent to deactivate, e.g. 'CRM_Record_Creator'"),
-}).strict();
-export const GetAgentSchema = z.object({
-    agentApiName: z.string().min(1).max(80).describe("Agent API name, e.g. 'CRM_Record_Creator'"),
-}).strict();
-export const UpdateAgentTopicSchema = z.object({
-    agentApiName: z.string().min(1).max(80).describe("API name of the agent that owns this topic. The agent is automatically deactivated before the update and reactivated after."),
-    topicName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Topic API name to update (GenAiPlugin developer name)"),
-    label: z.string().min(1).max(255).describe("Updated topic display label"),
-    description: z.string().min(1).max(5000).describe("Updated routing description"),
-    scope: z.string().min(1).max(5000).describe("Updated scope"),
-    instructions: z.array(z.string().max(2000)).optional().describe("Updated step-by-step instructions (replaces existing)"),
-    actions: z.array(z.string().max(80)).optional().describe("Updated action API names (replaces existing)"),
-    escalationEnabled: z.boolean().optional().describe("Whether this topic can escalate to a human agent"),
-    fallbackTopic: z.string().max(80).optional().describe("API name of fallback topic"),
-}).strict();
-export const UpdateAgentActionSchema = z.object({
-    actionName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Action API name to update (GenAiFunction developer name)"),
-    label: z.string().min(1).max(255).describe("Updated action display label"),
-    description: z.string().min(1).max(5000).describe("Updated action description"),
-    invocationTargetType: z.enum(["Flow", "ApexClass"]).default("Flow").describe("Type of backend to invoke"),
-    flowApiName: z.string().max(255).optional().describe("API name of the AutoLaunchedFlow (required if invocationTargetType is Flow)"),
-    apexClassName: z.string().max(255).optional().describe("API name of the Apex class (required if invocationTargetType is ApexClass)"),
-    inputs: z.array(AgentParamSchema).optional().describe("Updated input parameters (replaces existing)"),
-    outputs: z.array(AgentParamSchema.omit({ required: true })).optional().describe("Updated output parameters (replaces existing)"),
-}).strict();
-export const DeleteAgentSchema = z.object({
-    agentApiName: z.string().min(1).max(80).describe("API name of the agent to delete, e.g. 'CRM_Record_Creator'"),
-    deleteTopics: z.boolean().default(false).describe("If true, also deletes the agent's GenAiPlugin topics (identified via its GenAiPlannerBundle)"),
-    deleteActions: z.boolean().default(false).describe("If true, also deletes the GenAiFunction actions referenced by the agent's topics"),
-}).strict();
-export const ListAgentsSchema = z.object({}).strict();
-export const TestAgentSchema = z.object({
-    agentApiName: z.string().min(1).max(80).describe("API name of the agent to test, e.g. 'CRM_Record_Creator'"),
-    message: z.string().min(1).max(5000).describe("Test message to send to the agent, e.g. 'Create an account called Acme Corp'"),
-    orgUrl: z.string().url().optional().describe("Override the Agentforce bootstrap URL (defaults to SF_INSTANCE_URL). Required only if your My Domain URL differs from the instance URL."),
-}).strict();
-export const GetAgentLogsSchema = z.object({
-    agentApiName: z.string().max(80).optional().describe("Filter logs by agent API name (optional — omit to see all agent activity in the org)"),
-    limit: z.number().int().min(1).max(200).default(20).describe("Maximum number of log entries to return (default: 20)"),
-    hoursBack: z.number().min(0.1).max(24).default(1).describe("How many hours back to look (default: 1 hour)"),
+    agentName: z.string().min(1).max(80).describe("Parent agent API name"),
+    topicName: z.string().min(1).max(80).describe("Parent topic API name"),
+    actionName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Action API name"),
+    label: z.string().min(1).max(255).describe("Action label"),
+    description: z.string().min(1).max(5000).describe("What this action does"),
+    type: z.enum(["Flow", "ApexClass", "PromptTemplate", "DataCategoryGroup", "ExternalService"])
+        .describe("Action type"),
+    reference: z.string().min(1).max(255).describe("API name of the Flow, Apex class, or Prompt Template to invoke"),
+    inputs: z.array(z.object({
+        name: z.string().max(255).describe("Input parameter name"),
+        value: z.string().max(1000).describe("Value or reference, e.g. '{!Agent.Topic.Entities.accountName}'"),
+    })).optional().describe("Input parameter mappings"),
 }).strict();
 // ─── MCP SERVER MANAGEMENT ───────────────────────────────────────────────────
 export const CreateMcpServerSchema = z.object({
@@ -1038,18 +983,21 @@ export const DeployMetadataSchema = z.object({
     runTests: z.array(z.string()).optional().describe("Test classes to run during deployment"),
     rollbackOnError: z.boolean().default(true).describe("Roll back all changes if any component fails"),
     waitMinutes: z.number().int().min(1).max(60).default(10).describe("Max minutes to wait for deploy to complete"),
-    testLevel: z.enum(["NoTestRun","RunSpecifiedTests","RunLocalTests","RunAllTestsInOrg"]).optional().describe("Test level: NoTestRun, RunSpecifiedTests, RunLocalTests, or RunAllTestsInOrg"),
+    testLevel: z.enum(["NoTestRun", "RunSpecifiedTests", "RunLocalTests", "RunAllTestsInOrg"]).optional().describe("Test level: NoTestRun, RunSpecifiedTests, RunLocalTests, or RunAllTestsInOrg"),
 }).strict();
 export const CheckDeployStatusSchema = z.object({
     deployId: z.string().min(1).describe("Deploy async job ID returned from sf_deploy_metadata"),
 }).strict();
 export const RetrieveMetadataSchema = z.object({
-    components: z.array(ComponentRefSchema).min(1).describe("Metadata components to retrieve"),
+    components: z.array(ComponentRefSchema).optional().describe("Metadata components to retrieve"),
+    metadataType: z.string().optional().describe("Single metadata type (alternative to components array)"),
+    componentName: z.string().optional().describe("Single component name (used with metadataType)"),
     packageXml: z.string().optional().describe("Raw package.xml content for selective retrieve. If provided, components list is ignored."),
 }).strict();
 // ─── OBJECTS & FIELDS (v2.2.0) ───────────────────────────────────────────────
 export const UpdateCustomObjectSchema = z.object({
-    objectApiName: z.string().min(1).describe("Custom object API name, e.g. 'MyObject__c'"),
+    objectApiName: z.string().optional().describe("Custom object API name, e.g. 'MyObject__c'"),
+    fullName: z.string().optional().describe("Alias for objectApiName"),
     label: z.string().optional().describe("New singular label"),
     pluralLabel: z.string().optional().describe("New plural label"),
     description: z.string().optional().describe("New description"),
@@ -1059,8 +1007,10 @@ export const UpdateCustomObjectSchema = z.object({
     enableActivities: z.boolean().optional().describe("Enable activities (tasks and events)"),
 }).strict();
 export const UpdateCustomFieldSchema = z.object({
-    objectApiName: z.string().min(1).describe("Object API name, e.g. 'Account'"),
-    fieldApiName: z.string().min(1).describe("Field API name, e.g. 'MyField__c'"),
+    objectApiName: z.string().optional().describe("Object API name, e.g. 'Account'"),
+    objectName: z.string().optional().describe("Alias for objectApiName"),
+    fieldApiName: z.string().optional().describe("Field API name, e.g. 'MyField__c'"),
+    fieldName: z.string().optional().describe("Alias for fieldApiName"),
     label: z.string().optional().describe("New field label"),
     description: z.string().optional().describe("New description"),
     helpText: z.string().optional().describe("New inline help text"),
@@ -1069,13 +1019,16 @@ export const UpdateCustomFieldSchema = z.object({
     defaultValue: z.string().optional().describe("New default value"),
 }).strict();
 export const CreateRelationshipFieldSchema = z.object({
-    objectApiName: z.string().min(1).describe("Object API name to create the field on, e.g. 'Contact'"),
+    objectApiName: z.string().optional().describe("Object API name to create the field on, e.g. 'Contact'"),
+    objectName: z.string().optional().describe("Alias for objectApiName"),
     fieldName: z.string().min(1).max(40).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Field name without __c suffix, e.g. 'Account'"),
     label: z.string().min(1).describe("Field label"),
-    relationshipType: z.enum(["Lookup","MasterDetail"]).describe("Lookup: optional reference field. MasterDetail: required parent-child relationship (child deleted with parent)."),
-    relatedObject: z.string().min(1).describe("API name of the related (parent) object, e.g. 'Account'"),
+    relationshipType: z.enum(["Lookup", "MasterDetail"]).optional().describe("Lookup: optional reference field. MasterDetail: required parent-child relationship (child deleted with parent)."),
+    relationType: z.enum(["Lookup", "MasterDetail"]).optional().describe("Alias for relationshipType"),
+    relatedObject: z.string().optional().describe("API name of the related (parent) object, e.g. 'Account'"),
+    referenceTo: z.string().optional().describe("Alias for relatedObject"),
     relationshipName: z.string().min(1).describe("Relationship API name used in SOQL, e.g. 'Account' (no spaces or double underscores)"),
-    onDelete: z.enum(["SetNull","Restrict"]).default("SetNull").describe("Lookup only — what happens to child when parent is deleted: SetNull (clears field) or Restrict (blocks deletion)"),
+    onDelete: z.enum(["SetNull", "Restrict"]).default("SetNull").describe("Lookup only — what happens to child when parent is deleted: SetNull (clears field) or Restrict (blocks deletion)"),
     required: z.boolean().default(false).describe("Make field required (Lookup only; MasterDetail is always required)"),
     description: z.string().optional().describe("Field description"),
 }).strict();
@@ -1083,7 +1036,7 @@ export const CreateFormulaFieldSchema = z.object({
     objectApiName: z.string().min(1).describe("Object API name, e.g. 'Opportunity'"),
     fieldName: z.string().min(1).max(40).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Field name without __c suffix"),
     label: z.string().min(1).describe("Field label"),
-    returnType: z.enum(["Text","Number","Currency","Date","DateTime","Checkbox","Percent"]).describe("Formula return type"),
+    returnType: z.enum(["Text", "Number", "Currency", "Date", "DateTime", "Checkbox", "Percent"]).describe("Formula return type"),
     formula: z.string().min(1).describe("Salesforce formula expression, e.g. 'MONTH(TODAY())' or 'Price__c * Quantity__c'"),
     scale: z.number().int().min(0).max(18).optional().describe("Decimal places for Number/Currency/Percent return types"),
     description: z.string().optional().describe("Field description"),
@@ -1101,7 +1054,7 @@ export const CreatePermissionSetGroupSchema = z.object({
     permissionSets: z.array(z.string().min(1)).min(1).describe("Array of Permission Set API names to include in this group"),
 }).strict();
 const ObjPermSchema = z.object({
-    object: z.string().min(1).describe("Object API name, e.g. 'Account'"),
+    object: z.string().optional().describe("Object API name, e.g. 'Account'"),
     read: z.boolean().default(false),
     create: z.boolean().default(false),
     edit: z.boolean().default(false),
@@ -1120,31 +1073,46 @@ export const UpdatePermissionSetSchema = z.object({
     fieldPermissions: z.array(FldPermSchema).optional().describe("Field-level security to set. Replaces existing FLS for specified fields."),
 }).strict();
 export const CreateMutingPermissionSetSchema = z.object({
-    mutingPermSetName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Muting Permission Set API name"),
+    mutingPermSetName: z.string().optional().describe("Muting Permission Set API name"),
+    permissionSetName: z.string().optional().describe("Alias for mutingPermSetName"),
+    description: z.string().optional().describe("Description"),
     label: z.string().min(1).describe("Display label"),
     permissionSetGroup: z.string().optional().describe("Permission Set Group API name to add this muting perm set to"),
     objectPermissions: z.array(ObjPermSchema).optional().describe("Object permissions to mute (suppress)"),
     fieldPermissions: z.array(FldPermSchema).optional().describe("Field permissions to mute"),
 }).strict();
 export const SetFieldLevelSecuritySchema = z.object({
-    fieldApiName: z.string().min(1).describe("Field in Object.Field format, e.g. 'Account.AnnualRevenue'"),
+    fieldApiName: z.string().optional().describe("Field in Object.Field format, e.g. 'Account.AnnualRevenue'"),
+    permissionSetName: z.string().optional().describe("Single permission set name"),
+    objectName: z.string().optional().describe("Object API name (informational)"),
+    fields: z.array(z.object({
+        field: z.string().describe("Field API name"),
+        readable: z.boolean().optional(),
+        editable: z.boolean().optional(),
+    })).optional().describe("Array of field FLS settings"),
     profiles: z.array(z.string()).optional().describe("Profile API names to update FLS for"),
     permissionSets: z.array(z.string()).optional().describe("Permission Set API names to update FLS for"),
-    readable: z.boolean().describe("Grant read access to this field"),
-    editable: z.boolean().describe("Grant edit access to this field (read is implied if editable)"),
+    readable: z.boolean().optional().describe("Grant read access to this field"),
+    editable: z.boolean().optional().describe("Grant edit access to this field (read is implied if editable)"),
 }).strict();
 export const SetOrgWideDefaultsSchema = z.object({
-    objectApiName: z.string().min(1).describe("Object API name, e.g. 'Opportunity__c'. For standard objects like Account, use the object API name."),
-    defaultInternal: z.enum(["Private","PublicRead","PublicReadWrite","ControlledByParent"]).describe("Internal org-wide default sharing model"),
-    defaultExternal: z.enum(["Private","PublicRead","PublicReadWrite","ControlledByParent"]).optional().describe("External org-wide default (for orgs with external sharing model enabled)"),
+    objectApiName: z.string().optional().describe("Object API name, e.g. 'Opportunity__c'. For standard objects like Account, use the object API name."),
+    objectName: z.string().optional().describe("Alias for objectApiName"),
+    defaultInternal: z.enum(["Private", "PublicRead", "PublicReadWrite", "ControlledByParent"]).optional().describe("Internal org-wide default sharing model"),
+    defaultAccess: z.string().optional().describe("Alias for defaultInternal: Private, PublicRead, PublicReadWrite"),
+    externalAccess: z.string().optional().describe("External org-wide default sharing"),
+    defaultExternal: z.enum(["Private", "PublicRead", "PublicReadWrite", "ControlledByParent"]).optional().describe("External org-wide default (for orgs with external sharing model enabled)"),
 }).strict();
 export const CreateProfileSchema = z.object({
-    profileName: z.string().min(1).max(80).describe("New profile API name"),
-    label: z.string().min(1).describe("New profile display label"),
-    cloneFrom: z.string().min(1).describe("API name of existing profile to clone, e.g. 'Standard User'"),
+    profileName: z.string().optional().describe("New profile API name"),
+    newProfileName: z.string().optional().describe("Alias for profileName"),
+    label: z.string().optional().describe("New profile display label"),
+    cloneFrom: z.string().optional().describe("API name of existing profile to clone, e.g. 'Standard User'"),
+    sourceProfileName: z.string().optional().describe("Alias for cloneFrom"),
+    description: z.string().optional().describe("Profile description"),
 }).strict();
 const ProfileObjPermSchema = z.object({
-    object: z.string().min(1).describe("Object API name"),
+    object: z.string().optional().describe("Object API name"),
     allowCreate: z.boolean().default(false),
     allowDelete: z.boolean().default(false),
     allowEdit: z.boolean().default(false),
@@ -1156,22 +1124,29 @@ export const UpdateProfileSchema = z.object({
     profileName: z.string().min(1).describe("Profile API name to update"),
     objectPermissions: z.array(ProfileObjPermSchema).optional().describe("Object permissions to set"),
     fieldPermissions: z.array(FldPermSchema).optional().describe("Field-level security to set"),
-    tabVisibilities: z.array(z.object({ tab: z.string(), visibility: z.enum(["DefaultOn","DefaultOff","Hidden"]) })).optional().describe("Tab visibility settings"),
+    tabVisibilities: z.array(z.object({ tab: z.string(), visibility: z.enum(["DefaultOn", "DefaultOff", "Hidden"]) })).optional().describe("Tab visibility settings"),
     applicationVisibilities: z.array(z.object({ application: z.string(), visible: z.boolean(), default: z.boolean().default(false) })).optional().describe("App visibility settings"),
 }).strict();
 // ─── PAGE LAYOUTS & UI (v2.2.0) ──────────────────────────────────────────────
 export const UpdatePageLayoutSchema = z.object({
     layoutName: z.string().min(1).describe("Layout full name in 'Object-Layout Name' format, e.g. 'Account-Account Layout'"),
-    fieldsToAdd: z.array(z.object({ field: z.string(), section: z.string().optional(), column: z.number().int().min(0).max(1).default(0) })).optional().describe("Fields to add to the layout"),
+    fieldsToAdd: z.array(z.union([
+        z.string().transform((s) => ({ field: s })),
+        z.object({ field: z.string(), section: z.string().optional(), column: z.number().int().min(0).max(1).default(0) }),
+    ])).optional().describe("Fields to add: field API name strings or {field, section?, column?} objects"),
     fieldsToRemove: z.array(z.string()).optional().describe("Field API names to remove from the layout"),
     relatedListsToAdd: z.array(z.string()).optional().describe("Related list API names to add, e.g. 'Contacts'"),
     relatedListsToRemove: z.array(z.string()).optional().describe("Related list API names to remove"),
     buttonsToAdd: z.array(z.string()).optional().describe("Custom button names to add to the layout"),
+    objectName: z.string().optional().describe("Object API name (informational)"),
+    sections: z.array(z.any()).optional().describe("Page layout sections"),
 }).strict();
 export const AssignPageLayoutSchema = z.object({
-    objectApiName: z.string().min(1).describe("Object API name, e.g. 'Account'"),
+    objectApiName: z.string().optional().describe("Object API name, e.g. 'Account'"),
+    objectName: z.string().optional().describe("Alias for objectApiName"),
     layoutName: z.string().min(1).describe("Layout name (without object prefix), e.g. 'Account Layout'"),
-    profileName: z.string().min(1).describe("Profile API name to assign the layout to"),
+    profileName: z.string().optional().describe("Profile API name to assign the layout to"),
+    profiles: z.array(z.string()).optional().describe("Array of profile names (alternative to profileName)"),
     recordTypeName: z.string().optional().describe("Record type developer name (if assigning to a specific record type)"),
 }).strict();
 const FlexiComponentSchema = z.object({
@@ -1184,7 +1159,7 @@ export const CreateLightningRecordPageSchema = z.object({
     pageName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("FlexiPage API name"),
     label: z.string().min(1).describe("Page display label"),
     objectApiName: z.string().min(1).describe("Object API name for the record page"),
-    template: z.enum(["HeaderAndRightSidebar","HeaderAndThreeRegions","MosaicTemplate","FullWidth","LeftSidebar"]).default("HeaderAndRightSidebar").describe("Page template"),
+    template: z.enum(["HeaderAndRightSidebar", "HeaderAndThreeRegions", "MosaicTemplate", "FullWidth", "LeftSidebar"]).default("HeaderAndRightSidebar").describe("Page template"),
     components: z.array(FlexiComponentSchema).optional().describe("Components to add to the page"),
 }).strict();
 export const CreateLightningHomePageSchema = z.object({
@@ -1200,30 +1175,33 @@ export const UpdateLightningPageSchema = z.object({
 }).strict();
 export const AssignLightningPageSchema = z.object({
     pageApiName: z.string().min(1).describe("FlexiPage API name to assign"),
-    assignmentType: z.enum(["org","app","recordType"]).describe("Assignment scope"),
+    assignmentType: z.enum(["org", "app", "recordType"]).describe("Assignment scope"),
     appName: z.string().optional().describe("Lightning App API name (required for app assignment)"),
     recordTypeName: z.string().optional().describe("Record Type developer name (for recordType assignment)"),
     objectApiName: z.string().optional().describe("Object API name (for record page assignments)"),
 }).strict();
 export const AssignCompactLayoutSchema = z.object({
-    objectApiName: z.string().min(1).describe("Object API name, e.g. 'Account'"),
+    objectApiName: z.string().optional().describe("Object API name, e.g. 'Account'"),
+    objectName: z.string().optional().describe("Alias for objectApiName"),
     compactLayoutName: z.string().min(1).describe("Compact layout API name to assign as default"),
     recordTypeName: z.string().optional().describe("Record type developer name (if assigning to a specific record type)"),
 }).strict();
 // ─── AUTOMATION (v2.2.0) ─────────────────────────────────────────────────────
 export const ActivateFlowSchema = z.object({
     flowApiName: z.string().min(1).describe("Flow API name (DeveloperName), e.g. 'My_Flow'"),
-    action: z.enum(["activate","deactivate"]).describe("Whether to activate or deactivate the flow"),
+    action: z.enum(["activate", "deactivate"]).default("activate").describe("Whether to activate or deactivate the flow"),
     versionNumber: z.number().int().optional().describe("Specific version number to activate. Defaults to latest version."),
 }).strict();
 export const CreateQuickActionSchema = z.object({
     actionName: z.string().min(1).describe("Full API name. For object-specific: 'Object.ActionName'. For global: 'ActionName'."),
     label: z.string().min(1).describe("Action display label"),
-    actionType: z.enum(["Create","Update","LogACall","CustomVF","LightningComponent"]).describe("Action type"),
+    actionType: z.enum(["Create", "Update", "LogACall", "CustomVF", "LightningComponent"]).describe("Action type"),
     targetObject: z.string().optional().describe("Target object API name for Create/Update actions, e.g. 'Contact'"),
     targetFields: z.array(z.object({ field: z.string(), value: z.string() })).optional().describe("Pre-populated field values"),
-    standardLabel: z.enum(["None","New","NewEvent","NewTask","LogACall","SendEmail","NewCase","NewOpportunity","NewContact","NewLead","NewNote","NewAccount","ScreenPop"]).optional().describe("Standard action label type"),
+    standardLabel: z.enum(["None", "New", "NewEvent", "NewTask", "LogACall", "SendEmail", "NewCase", "NewOpportunity", "NewContact", "NewLead", "NewNote", "NewAccount", "ScreenPop"]).optional().describe("Standard action label type"),
     description: z.string().optional().describe("Action description"),
+    objectName: z.string().optional().describe("Object API name (informational prefix)"),
+    fields: z.array(z.any()).optional().describe("Alias for targetFields"),
 }).strict();
 // ─── APEX & LWC (v2.2.0) ─────────────────────────────────────────────────────
 export const UpdateApexClassSchema = z.object({
@@ -1240,7 +1218,8 @@ export const GetCodeCoverageSchema = z.object({
 export const CreateVisualforcePageSchema = z.object({
     pageName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Visualforce page API name"),
     label: z.string().min(1).describe("Page label"),
-    markup: z.string().min(1).describe("Full Visualforce page markup (including <apex:page> tag)"),
+    markup: z.string().optional().describe("Full Visualforce page markup (including <apex:page> tag)"),
+    body: z.string().optional().describe("Alias for markup"),
     apiVersion: z.string().default("66.0").describe("API version"),
     availableInTouch: z.boolean().default(false).describe("Make available in Salesforce mobile"),
     showHeader: z.boolean().default(true).describe("Show Salesforce header"),
@@ -1260,48 +1239,52 @@ export const CreateAuraComponentSchema = z.object({
 // ─── REPORTS & DASHBOARDS (v2.2.0) ───────────────────────────────────────────
 const ReportFilterSchema = z.object({
     field: z.string().describe("Field API name, e.g. 'ACCOUNT_NAME'"),
-    operator: z.enum(["equals","notEqual","lessThan","greaterThan","lessOrEqual","greaterOrEqual","contains","notContain","startsWith","includes","excludes"]).describe("Filter operator"),
+    operator: z.enum(["equals", "notEqual", "lessThan", "greaterThan", "lessOrEqual", "greaterOrEqual", "contains", "notContain", "startsWith", "includes", "excludes"]).describe("Filter operator"),
     value: z.string().describe("Filter value"),
 });
 export const CreateReportSchema = z.object({
     reportName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Report API name"),
     label: z.string().min(1).describe("Report display name"),
     reportType: z.string().min(1).describe("Report type API name, e.g. 'Account', 'Opportunity', 'AccountList'"),
-    format: z.enum(["Tabular","Summary","Matrix","Joined"]).default("Tabular").describe("Report format"),
+    format: z.enum(["Tabular", "Summary", "Matrix", "Joined"]).default("Tabular").describe("Report format"),
     groupByField: z.string().optional().describe("Field to group by (Summary/Matrix formats)"),
     columns: z.array(z.string()).min(1).describe("Field API names to include as columns, e.g. ['ACCOUNT_NAME', 'ANNUAL_REVENUE']"),
     filters: z.array(ReportFilterSchema).optional().describe("Report filters"),
     description: z.string().optional().describe("Report description"),
+    folderName: z.string().optional().describe("Folder API name for the report"),
 }).strict();
 export const UpdateDashboardSchema = z.object({
     dashboardName: z.string().min(1).describe("Dashboard API name"),
     componentsToAdd: z.array(z.object({
         reportName: z.string().describe("Report API name to add as component"),
-        chartType: z.enum(["Donut","Bar","Line","Column","Table","Metric","Gauge","HorizontalBar","Funnel"]).default("Table").describe("Chart type"),
+        chartType: z.enum(["Donut", "Bar", "Line", "Column", "Table", "Metric", "Gauge", "HorizontalBar", "Funnel"]).default("Table").describe("Chart type"),
         title: z.string().describe("Component title"),
         row: z.number().int().default(0).describe("Row position (0-based)"),
         column: z.number().int().default(0).describe("Column position (0-based)"),
     })).optional().describe("Dashboard components to add"),
     componentsToRemove: z.array(z.string()).optional().describe("Component titles to remove"),
+    label: z.string().optional().describe("New dashboard title/label"),
+    runningUser: z.string().optional().describe("Username to run dashboard as"),
 }).strict();
 export const CreateReportFolderSchema = z.object({
     folderName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Folder API name"),
     label: z.string().min(1).describe("Folder display name"),
-    folderType: z.enum(["Report","Dashboard"]).describe("Whether this is a report or dashboard folder"),
-    accessType: z.enum(["Hidden","Shared","Public"]).default("Shared").describe("Folder access type"),
+    folderType: z.enum(["Report", "Dashboard"]).default("Report").describe("Whether this is a report or dashboard folder"),
+    accessType: z.enum(["Hidden", "Shared", "Public"]).default("Shared").describe("Folder access type"),
 }).strict();
 export const ShareReportFolderSchema = z.object({
     folderName: z.string().min(1).describe("Folder API name to share"),
-    folderType: z.enum(["Report","Dashboard"]).describe("Whether this is a report or dashboard folder"),
-    shareWith: z.array(z.object({
-        type: z.enum(["Role","Group","User","RoleAndSubordinates"]).describe("Sharing target type"),
+    folderType: z.enum(["Report", "Dashboard"]).default("Report").describe("Whether this is a report or dashboard folder"),
+    accessLevel: z.string().optional().describe("Access level shorthand: View, Edit, Manage"),
+    shareWith: z.preprocess((v) => typeof v === 'string' ? [{ type: "Group", name: v, accessLevel: "View" }] : v, z.array(z.object({
+        type: z.enum(["Role", "Group", "User", "RoleAndSubordinates"]).describe("Sharing target type"),
         name: z.string().describe("API name/username of the role, group, or user"),
-        accessLevel: z.enum(["View","Edit","Manage"]).default("View").describe("Access level"),
-    })).min(1).describe("Who to share the folder with"),
+        accessLevel: z.enum(["View", "Edit", "Manage"]).default("View").describe("Access level"),
+    })).min(1)).describe("Who to share the folder with"),
 }).strict();
 // ─── USERS & DATA (v2.2.0) ───────────────────────────────────────────────────
 export const CreateUserSchema = z.object({
-    firstName: z.string().min(1).describe("First name"),
+    firstName: z.string().optional().describe("First name"),
     lastName: z.string().min(1).describe("Last name"),
     email: z.string().email().describe("Email address (also used for notifications)"),
     username: z.string().email().describe("Unique username (must be email format and unique across all Salesforce orgs)"),
@@ -1329,7 +1312,7 @@ export const CreatePublicGroupSchema = z.object({
     groupName: z.string().min(1).max(80).describe("Group developer name (no spaces)"),
     label: z.string().min(1).describe("Group display name"),
     members: z.array(z.object({
-        type: z.enum(["User","Role","RoleAndSubordinates","Group"]).describe("Member type"),
+        type: z.enum(["User", "Role", "RoleAndSubordinates", "Group"]).describe("Member type"),
         name: z.string().describe("Username, role name, or group developer name"),
     })).optional().describe("Initial group members"),
 }).strict();
@@ -1348,7 +1331,7 @@ export const UpdateRecordSchema = z.object({
 }).strict();
 export const BulkImportRecordsSchema = z.object({
     objectApiName: z.string().min(1).describe("SObject API name, e.g. 'Account'"),
-    operation: z.enum(["insert","upsert","update","delete"]).describe("Bulk operation type"),
+    operation: z.enum(["insert", "upsert", "update", "delete"]).describe("Bulk operation type"),
     records: z.array(z.record(z.unknown())).min(1).describe("Array of record objects with field API name to value mappings"),
     externalIdField: z.string().optional().describe("External ID field for upsert operations, e.g. 'External_Id__c'"),
 }).strict();
@@ -1360,21 +1343,24 @@ export const CreateOutboundMessageSchema = z.object({
     endpointUrl: z.string().url().describe("HTTPS endpoint URL to send the SOAP message to"),
     fields: z.array(z.string()).min(1).describe("Field API names to include in the outbound message payload"),
     useCallout: z.boolean().default(false).describe("Whether to use a named credential callout"),
+    integrationUser: z.string().optional().describe("Username of the integration user (defaults to current user)"),
     description: z.string().optional().describe("Description"),
 }).strict();
 export const CreateAuthProviderSchema = z.object({
     providerName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Auth provider API name"),
     friendlyName: z.string().optional().describe("Display label (defaults to providerName)"),
-    providerType: z.enum(["Salesforce","Google","Facebook","OpenIdConnect","MicrosoftAad","LinkedIn","Custom"]).describe("Provider type"),
+    providerType: z.enum(["Salesforce", "Google", "Facebook", "OpenIdConnect", "MicrosoftAad", "LinkedIn", "Custom"]).describe("Provider type"),
     consumerKey: z.string().min(1).describe("OAuth consumer key / client ID"),
     consumerSecret: z.string().min(1).describe("OAuth consumer secret / client secret"),
     defaultScopes: z.string().optional().describe("Default OAuth scopes, e.g. 'openid email profile'"),
     customErrorUrl: z.string().url().optional().describe("Custom error page URL"),
+    authorizeEndpointUrl: z.string().optional().describe("Authorization endpoint URL"),
+    tokenEndpointUrl: z.string().optional().describe("Token endpoint URL"),
 }).strict();
 // ─── DEPLOYMENT (v2.2.0) ──────────────────────────────────────────────────────
 export const ValidateDeploymentSchema = z.object({
     components: z.array(ComponentRefSchema).min(1).describe("Metadata components to validate"),
-    testLevel: z.enum(["NoTestRun","RunLocalTests","RunAllTestsInOrg"]).default("RunLocalTests").describe("Test level for validation"),
+    testLevel: z.enum(["NoTestRun", "RunLocalTests", "RunAllTestsInOrg"]).default("RunLocalTests").describe("Test level for validation"),
     runTests: z.array(z.string()).optional().describe("Specific test classes to run"),
     waitMinutes: z.number().int().min(1).max(60).default(10).describe("Max minutes to wait for validation result"),
 }).strict();
@@ -1387,19 +1373,21 @@ export const PublishExperienceSiteSchema = z.object({
 }).strict();
 export const UpdateExperienceSiteSchema = z.object({
     siteName: z.string().min(1).describe("Experience Cloud site API name"),
-    status: z.enum(["Active","Inactive","UnderConstruction"]).optional().describe("Site status"),
+    status: z.enum(["Active", "Inactive", "UnderConstruction"]).optional().describe("Site status"),
     description: z.string().optional().describe("Site description"),
     guestUserProfile: z.string().optional().describe("Guest user profile name"),
 }).strict();
 export const CreateNavigationMenuSchema = z.object({
     menuName: z.string().min(1).max(80).describe("Navigation menu API name"),
     label: z.string().min(1).describe("Menu label"),
+    networkName: z.string().optional().describe("Experience site name (informational)"),
+    items: z.array(z.any()).optional().describe("Alias for menuItems"),
     menuItems: z.array(z.object({
         label: z.string().describe("Menu item label"),
-        type: z.enum(["SalesforceObject","ExternalUrl","NavigationalTopic","Event","MenuLabel","GlobalAction","ContentPage"]).describe("Menu item type"),
-        target: z.string().describe("Target: object API name, URL, topic name, or event name"),
+        type: z.enum(["SalesforceObject", "ExternalUrl", "NavigationalTopic", "Event", "MenuLabel", "GlobalAction", "ContentPage"]).describe("Menu item type"),
+        target: z.string().optional().describe("Target: object API name, URL, topic name, or event name"),
         position: z.number().int().optional().describe("Position (1-based)"),
-    })).min(1).describe("Navigation menu items"),
+    })).optional().describe("Navigation menu items"),
 }).strict();
 export const CreateExperienceSiteMemberSchema = z.object({
     siteName: z.string().min(1).describe("Experience Cloud site API name"),
@@ -1416,14 +1404,14 @@ export const SetExperienceSiteBrandingSchema = z.object({
 }).strict();
 // ─── OMNISTUDIO (v2.3.0) ──────────────────────────────────────────────────────
 const OmniCardFieldSchema = z.object({ fieldName: z.string().min(1), label: z.string().min(1), type: z.string().default("Text") });
-const OmniCardActionSchema = z.object({ label: z.string().min(1), type: z.enum(["omniscript","url","flow","navigation"]).default("navigation"), target: z.string().min(1) });
+const OmniCardActionSchema = z.object({ label: z.string().min(1), type: z.enum(["omniscript", "url", "flow", "navigation"]).default("navigation"), target: z.string().min(1) });
 const OmniCardStateConditionSchema = z.object({ field: z.string().min(1), operator: z.string().default("=="), value: z.string() });
-const OmniCardStateSchema = z.object({ name: z.string().min(1), conditionType: z.enum(["ALL","ANY","CUSTOM"]).default("ALL"), conditions: z.array(OmniCardStateConditionSchema).optional() });
+const OmniCardStateSchema = z.object({ name: z.string().min(1), conditionType: z.enum(["ALL", "ANY", "CUSTOM"]).default("ALL"), conditions: z.array(OmniCardStateConditionSchema).optional() });
 export const CreateFlexCardSchema = z.object({
     cardName: z.string().min(1).max(80).describe("API name of the FlexCard (OmniUiCard)"),
     label: z.string().min(1).max(255).describe("Human-readable label"),
     objectApiName: z.string().optional().describe("Primary SObject, e.g. 'Account'"),
-    dataSourceType: z.enum(["SOQL","DataRaptor","Integration Procedure","Apex","None"]).default("SOQL"),
+    dataSourceType: z.enum(["SOQL", "DataRaptor", "Integration Procedure", "Apex", "None"]).default("SOQL"),
     dataSourceName: z.string().optional().describe("SOQL query, DataRaptor name, or Integration Procedure name"),
     fields: z.array(OmniCardFieldSchema).optional().describe("Fields to display on the card"),
     actions: z.array(OmniCardActionSchema).optional().describe("Card actions"),
@@ -1433,7 +1421,7 @@ export const CreateFlexCardSchema = z.object({
 export const UpdateFlexCardSchema = z.object({
     cardName: z.string().min(1).max(80).describe("API name of the FlexCard to update"),
     label: z.string().optional(),
-    dataSourceType: z.enum(["SOQL","DataRaptor","Integration Procedure","Apex","None"]).optional(),
+    dataSourceType: z.enum(["SOQL", "DataRaptor", "Integration Procedure", "Apex", "None"]).optional(),
     dataSourceName: z.string().optional(),
     fields: z.array(OmniCardFieldSchema).optional(),
     actions: z.array(OmniCardActionSchema).optional(),
@@ -1448,12 +1436,12 @@ export const GetFlexCardSchema = z.object({
 }).strict();
 const OmniElementSchema = z.object({
     name: z.string().min(1),
-    type: z.enum(["Text","Input","Select","Radio","Checkbox","Step","Group","TypeAhead","Formula","RemoteAction","DataRaptor","IntegrationProcedure","Disclosure","Navigation","Block"]),
+    type: z.enum(["Text", "Input", "Select", "Radio", "Checkbox", "Step", "Group", "TypeAhead", "Formula", "RemoteAction", "DataRaptor", "IntegrationProcedure", "Disclosure", "Navigation", "Block"]),
     label: z.string().min(1),
     properties: z.record(z.unknown()).optional().describe("Element-specific configuration properties"),
 });
 export const CreateOmniScriptSchema = z.object({
-    scriptName: z.string().min(1).max(80).describe("API name identifier portion (used in fullName as Type_SubType_Language)"),
+    scriptName: z.string().min(1).max(80).optional().describe("Ignored — fullName is derived from type_subType_language"),
     label: z.string().min(1).max(255),
     type: z.string().min(1).describe("OmniScript type, e.g. 'Account', 'Claims'"),
     subType: z.string().min(1).describe("OmniScript sub-type, e.g. 'Create', 'Edit'"),
@@ -1484,13 +1472,13 @@ export const GetOmniScriptSchema = z.object({
 const DataRaptorFieldMappingSchema = z.object({
     sourceField: z.string().min(1).describe("Source field path, e.g. 'Account.Name' or JSONPath '$.Name'"),
     targetField: z.string().min(1).describe("Target field or JSON key"),
-    dataType: z.enum(["String","Number","Boolean","Date","Object","Array"]).default("String"),
+    dataType: z.enum(["String", "Number", "Boolean", "Date", "Object", "Array"]).default("String"),
     formula: z.string().optional().describe("Optional formula or transformation expression"),
 });
 export const CreateDataRaptorSchema = z.object({
     dataRaptorName: z.string().min(1).max(80).describe("API name of the DataRaptor"),
     label: z.string().min(1).max(255),
-    interfaceType: z.enum(["Extract","Transform","Load"]).describe("DataRaptor type: Extract reads from SF, Transform maps data, Load writes to SF"),
+    interfaceType: z.enum(["Extract", "Transform", "Load"]).describe("DataRaptor type: Extract reads from SF, Transform maps data, Load writes to SF"),
     objectApiName: z.string().optional().describe("Primary SObject for Extract or Load (e.g. 'Account')"),
     fields: z.array(DataRaptorFieldMappingSchema).optional().describe("Field mappings"),
     filterCriteria: z.string().optional().describe("SOQL WHERE clause for Extract, e.g. 'Id = :recordId'"),
@@ -1501,7 +1489,7 @@ export const GetDataRaptorSchema = z.object({
 }).strict();
 const IPElementSchema = z.object({
     name: z.string().min(1),
-    type: z.enum(["DataRaptor","HTTPAction","Response","Loop","Conditional","SetValues","ExceptionBlock","Matrix","OmniScript","Aggregate"]),
+    type: z.enum(["DataRaptor", "HTTPAction", "Response", "Loop", "Conditional", "SetValues", "ExceptionBlock", "Matrix", "OmniScript", "Aggregate"]),
     properties: z.record(z.unknown()).optional().describe("Element configuration (DataRaptor name, HTTP method/endpoint, etc.)"),
     inputMap: z.record(z.string()).optional().describe("Input parameter mappings {targetKey: 'sourceExpression'}"),
     outputMap: z.record(z.string()).optional().describe("Output parameter mappings {sourceKey: 'targetPath'}"),
@@ -1528,7 +1516,7 @@ export const ActivateIntegrationProcedureSchema = z.object({
     procedureName: z.string().min(1).max(80),
     subType: z.string().min(1),
 }).strict();
-const CalcVariableSchema = z.object({ name: z.string().min(1), dataType: z.enum(["String","Number","Boolean","Date"]).default("String") });
+const CalcVariableSchema = z.object({ name: z.string().min(1), dataType: z.enum(["String", "Number", "Boolean", "Date"]).default("String") });
 export const CreateCalculationMatrixSchema = z.object({
     matrixName: z.string().min(1).max(80).describe("API name of the Calculation Matrix"),
     label: z.string().min(1).max(255),
@@ -1539,7 +1527,7 @@ export const CreateCalculationMatrixSchema = z.object({
 }).strict();
 const CalcStepSchema = z.object({
     name: z.string().min(1),
-    type: z.enum(["Matrix","Expression","Loop","Condition"]).default("Expression"),
+    type: z.enum(["Matrix", "Expression", "Loop", "Condition"]).default("Expression"),
     matrixName: z.string().optional().describe("For Matrix steps: CalculationMatrix API name"),
     expression: z.string().optional().describe("For Expression steps: formula string"),
     inputMap: z.record(z.string()).optional(),
@@ -1555,17 +1543,20 @@ export const CreateCalculationProcedureSchema = z.object({
 export const CreateServiceChannelSchema = z.object({
     channelName: z.string().min(1).max(80).describe("API name / DeveloperName of the Service Channel"),
     label: z.string().min(1).max(255),
-    channelType: z.enum(["Case","Chat","Messaging","Voice","Email","SocialPost","Custom"]).default("Case"),
+    channelType: z.enum(["Case", "Chat", "Messaging", "Voice", "Email", "SocialPost", "Custom", "Standard"]).default("Case"),
     relatedObjectApiName: z.string().optional().describe("SObject routed via this channel, default 'Case'"),
     capacity: z.number().int().min(1).max(100).default(1).describe("Capacity weight for this channel"),
+    relatedObject: z.string().optional().describe("Alias for relatedObjectApiName"),
 }).strict();
 export const CreateRoutingConfigurationSchema = z.object({
-    configName: z.string().min(1).max(80).describe("API name of the RoutingConfiguration"),
+    configName: z.string().optional().describe("API name of the RoutingConfiguration"),
+    routingConfigName: z.string().optional().describe("Alias for configName"),
+    routingPriority: z.number().int().optional().describe("Alias for priority"),
     label: z.string().min(1).max(255),
-    routingModel: z.enum(["LeastActive","MostAvailable","ExternalRouting"]).default("LeastActive"),
+    routingModel: z.enum(["LeastActive", "MostAvailable", "ExternalRouting"]).default("LeastActive"),
     capacity: z.number().min(0).max(100).default(100).describe("Capacity percentage or item count"),
     priority: z.number().int().min(1).default(1).describe("Routing priority (lower number = higher priority)"),
-    unitType: z.enum(["Percentage","Items"]).default("Percentage"),
+    unitType: z.enum(["Percentage", "Items"]).default("Percentage"),
     pushTimeout: z.number().int().min(0).optional().describe("Seconds before push routing times out (0 = no timeout)"),
     description: z.string().optional(),
 }).strict();
@@ -1577,14 +1568,17 @@ export const CreatePresenceConfigurationSchema = z.object({
     configName: z.string().min(1).max(80).describe("API name of the PresenceUserConfig"),
     label: z.string().min(1).max(255),
     capacity: z.number().int().min(1).max(100).default(10).describe("Maximum concurrent work items per agent"),
-    serviceChannels: z.array(z.object({ channelName: z.string().min(1), capacity: z.number().int().min(1).optional() })).optional(),
+    serviceChannels: z.array(z.union([
+        z.string().transform((s) => ({ channelName: s })),
+        z.object({ channelName: z.string().min(1), capacity: z.number().int().min(1).optional() }),
+    ])).optional(),
     allowAgentsToChangeStatus: z.boolean().default(true),
     description: z.string().optional(),
 }).strict();
 export const CreatePresenceStatusSchema = z.object({
     statusName: z.string().min(1).max(80).describe("API name / DeveloperName of the Presence Status"),
     label: z.string().min(1).max(255),
-    statusType: z.enum(["Online","Busy","Offline"]).default("Online"),
+    statusType: z.enum(["Online", "Busy", "Offline"]).default("Online"),
     serviceChannels: z.array(z.string()).optional().describe("ServiceChannel API names to associate"),
 }).strict();
 export const AssignPresenceStatusSchema = z.object({
@@ -1617,7 +1611,7 @@ export const CreateWorkTypeSchema = z.object({
     workTypeName: z.string().min(1).max(80).describe("Name of the Work Type"),
     label: z.string().min(1).max(255).describe("Display label (used as Name field)"),
     estimatedDuration: z.number().min(1).describe("Estimated work duration value"),
-    durationType: z.enum(["Minutes","Hours"]).default("Minutes"),
+    durationType: z.enum(["Minutes", "Hours"]).default("Minutes"),
     blockTimeBeforeWork: z.number().min(0).default(0).describe("Buffer time before work in minutes"),
     blockTimeAfterWork: z.number().min(0).default(0).describe("Buffer time after work in minutes"),
     skillRequirements: z.array(z.string()).optional().describe("Required Skill DeveloperNames"),
@@ -1626,10 +1620,10 @@ export const CreateWorkTypeSchema = z.object({
 export const CreateMessagingChannelSchema = z.object({
     channelName: z.string().min(1).max(80).describe("API name / MasterLabel for the Messaging Channel"),
     label: z.string().min(1).max(255),
-    channelType: z.enum(["SMS","WhatsApp","Facebook","AppleMessages","GoogleBusinessMessages","LINE","Voice"]),
+    channelType: z.enum(["SMS", "WhatsApp", "Facebook", "AppleMessages", "GoogleBusinessMessages", "LINE", "Voice", "EmbeddedMessaging"]),
     phoneNumber: z.string().optional().describe("Phone number for SMS/WhatsApp channels"),
     pageId: z.string().optional().describe("Facebook Page ID for Facebook Messenger"),
-    routingType: z.enum(["Queue","Bot","None"]).default("Queue"),
+    routingType: z.enum(["Queue", "Bot", "None"]).default("Queue"),
     queueName: z.string().optional().describe("Queue DeveloperName to route work items to"),
     botName: z.string().optional().describe("Bot API name for bot-first routing"),
     description: z.string().optional(),
@@ -1637,7 +1631,7 @@ export const CreateMessagingChannelSchema = z.object({
 export const CreateChatButtonSchema = z.object({
     buttonName: z.string().min(1).max(80).describe("API name / DeveloperName of the chat button"),
     label: z.string().min(1).max(255),
-    routingType: z.enum(["Queue","Bot"]).default("Queue"),
+    routingType: z.enum(["Queue", "Bot"]).default("Queue"),
     queueName: z.string().optional().describe("Queue DeveloperName for queue-based routing"),
     botName: z.string().optional().describe("Bot name for bot-first routing"),
     windowLanguage: z.string().default("en").describe("Chat window language code, e.g. 'en', 'fr', 'de'"),
@@ -1647,10 +1641,11 @@ export const CreateChatButtonSchema = z.object({
     description: z.string().optional(),
 }).strict();
 export const CreateEmbeddedServiceSchema = z.object({
-    deploymentName: z.string().min(1).max(80).describe("API name of the Embedded Service deployment"),
+    deploymentName: z.string().optional().describe("API name of the Embedded Service deployment"),
+    serviceName: z.string().optional().describe("Alias for deploymentName"),
     label: z.string().min(1).max(255),
     site: z.string().min(1).describe("Experience Cloud site name or 'none' for non-community deployment"),
-    channelType: z.enum(["LiveAgent","MessagingChannel"]).default("LiveAgent"),
+    channelType: z.enum(["LiveAgent", "MessagingChannel", "EmbeddedMessaging"]).default("LiveAgent"),
     chatButtonName: z.string().optional().describe("LiveChatButton API name (for LiveAgent)"),
     messagingChannelName: z.string().optional().describe("MessagingChannel API name (for MessagingChannel)"),
     primaryColor: z.string().optional().describe("Primary brand color hex, e.g. '#0070D2'"),
@@ -1663,8 +1658,8 @@ export const CreateBotRoutingSchema = z.object({
     transferToQueueName: z.string().min(1).describe("Queue DeveloperName to transfer conversation to"),
     transferMessage: z.string().optional().describe("Message shown to customer when transferring to agent"),
     escalationConditions: z.array(z.object({
-        trigger: z.enum(["agentRequested","unrecognized","maxErrorCount","custom"]).describe("Trigger condition for escalation"),
-        action: z.enum(["TransferToQueue","EndChat","SetVariable"]).default("TransferToQueue"),
+        trigger: z.enum(["agentRequested", "unrecognized", "maxErrorCount", "custom"]).describe("Trigger condition for escalation"),
+        action: z.enum(["TransferToQueue", "EndChat", "SetVariable"]).default("TransferToQueue"),
     })).optional().describe("Conditions that trigger transfer to human agent"),
 }).strict();
 // ─── v2.4.0 — NEW TOOLS ──────────────────────────────────────────────────────
@@ -1680,50 +1675,54 @@ export const DeleteRecordSchema = z.object({
     recordId: z.string().min(15).max(18).describe("15 or 18 character Salesforce record ID"),
 }).strict();
 export const GetSetupAuditTrailSchema = z.object({
-    startDate: z.string().describe("Start date in ISO format, e.g. '2025-01-01'"),
-    endDate: z.string().describe("End date in ISO format, e.g. '2025-12-31'"),
+    startDate: z.string().optional().describe("Start date in ISO format, e.g. '2025-01-01'"),
+    endDate: z.string().optional().describe("End date in ISO format, e.g. '2025-12-31'"),
     createdByUsername: z.string().optional().describe("Filter by the username who made the change"),
     section: z.string().optional().describe("Filter by section, e.g. 'Custom Fields', 'Profiles', 'Flows', 'Apex Classes'"),
     limit: z.number().int().min(1).max(2000).default(100).describe("Maximum records to return"),
 }).strict();
 export const GetLoginHistorySchema = z.object({
-    startDate: z.string().describe("Start date in ISO format, e.g. '2025-01-01'"),
-    endDate: z.string().describe("End date in ISO format, e.g. '2025-12-31'"),
+    startDate: z.string().optional().describe("Start date in ISO format, e.g. '2025-01-01'"),
+    endDate: z.string().optional().describe("End date in ISO format, e.g. '2025-12-31'"),
     username: z.string().optional().describe("Filter by Salesforce username"),
     status: z.string().optional().describe("Filter by login status, e.g. 'Success', 'Failed'"),
     limit: z.number().int().min(1).max(2000).default(100).describe("Maximum records to return"),
 }).strict();
 export const GetEventLogsSchema = z.object({
     eventType: z.string().describe("Event type, e.g. 'Login', 'API', 'Report', 'Flow', 'ApexExecution', 'LightningPageView', 'RestApi'"),
-    startDate: z.string().describe("Start date in ISO format, e.g. '2025-01-01'"),
-    endDate: z.string().describe("End date in ISO format, e.g. '2025-12-31'"),
+    startDate: z.string().optional().describe("Start date in ISO format, e.g. '2025-01-01'"),
+    endDate: z.string().optional().describe("End date in ISO format, e.g. '2025-12-31'"),
     limit: z.number().int().min(1).max(50).default(10).describe("Maximum log files to fetch"),
 }).strict();
 export const GetFieldHistorySchema = z.object({
     objectApiName: z.string().min(1).describe("Object API name, e.g. 'Account', 'Case', 'Opportunity'"),
-    recordId: z.string().min(15).max(18).describe("Record ID to fetch history for"),
+    recordId: z.string().min(15).describe("Record ID to fetch history for (15 or 18 characters)"),
     fields: z.array(z.string()).optional().describe("Optional field names to filter — returns all tracked fields if omitted"),
     limit: z.number().int().min(1).max(500).default(100).describe("Maximum history records to return"),
 }).strict();
 export const CompareOrgsSchema = z.object({
-    sourceAlias: z.string().min(1).regex(/^[A-Za-z0-9_-]+$/).describe("SF CLI alias for the source org (run: sf org list to see aliases)"),
-    targetAlias: z.string().min(1).regex(/^[A-Za-z0-9_-]+$/).describe("SF CLI alias for the target org"),
-    metadataTypes: z.array(z.string()).default(["ApexClass","Flow","CustomObject","PermissionSet","LightningComponentBundle"]).describe("Metadata types to compare"),
+    sourceAlias: z.string().optional().describe("SF CLI alias for the source org (run: sf org list to see aliases)"),
+    targetAlias: z.string().optional().describe("SF CLI alias for the target org"),
+    metadataType: z.string().optional().describe("Single metadata type to compare"),
+    limit: z.number().int().optional().describe("Maximum results to return"),
+    metadataTypes: z.array(z.string()).default(["ApexClass", "Flow", "CustomObject", "PermissionSet", "LightningComponentBundle"]).describe("Metadata types to compare"),
 }).strict();
 export const CreateCertificateSchema = z.object({
     certName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Certificate API name"),
     label: z.string().min(1).describe("Certificate display label"),
-    keySize: z.enum(["2048","4096"]).default("2048").describe("Key size in bits"),
+    keySize: z.preprocess((v) => typeof v === 'number' ? String(v) : v, z.enum(["2048", "4096"]).default("2048")).describe("Key size in bits: 2048 or 4096 (number or string)"),
     expirationDate: z.string().optional().describe("Expiration date in ISO format, e.g. '2030-01-01'"),
     privateKeyExportable: z.boolean().default(false).describe("Whether the private key can be exported"),
 }).strict();
 export const CreateEventRelaySchema = z.object({
     relayName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Event relay API name"),
-    label: z.string().min(1).describe("Display label"),
-    eventChannel: z.string().min(1).describe("Platform event or CDC channel API name, e.g. 'My_Event__e' or 'AccountChangeEvent'"),
-    destinationType: z.enum(["AmazonEventBridge","EventBus"]).describe("Destination type for the relay"),
-    destinationResourceName: z.string().min(1).describe("ARN or event bus name for the destination"),
-    state: z.enum(["RUN","STOP","PAUSE"]).default("RUN").describe("Initial relay state"),
+    label: z.string().optional().describe("Display label"),
+    eventChannel: z.string().optional().describe("Platform event or CDC channel API name, e.g. 'My_Event__e' or 'AccountChangeEvent'"),
+    platformEventName: z.string().optional().describe("Alias for eventChannel"),
+    relayChannel: z.string().optional().describe("Channel name for relay"),
+    destinationType: z.enum(["AmazonEventBus", "AmazonEventBridge", "EventBus"]).optional().describe("Destination type for the relay"),
+    destinationResourceName: z.string().optional().describe("ARN or event bus name for the destination"),
+    state: z.enum(["RUN", "STOP", "PAUSE"]).default("RUN").describe("Initial relay state"),
     description: z.string().optional().describe("Relay description"),
 }).strict();
 export const CreateLetterheadSchema = z.object({
@@ -1739,6 +1738,7 @@ export const CreateLetterheadSchema = z.object({
     footerText: z.string().optional().describe("Footer text content"),
     topLineColor: z.string().default("#0070D2").describe("Top separator line color"),
     bottomLineColor: z.string().default("#0070D2").describe("Bottom separator line color"),
+    backgroundColor: z.string().optional().describe("Alias for bodyColor"),
 }).strict();
 export const SendEmailSchema = z.object({
     toAddresses: z.array(z.string()).min(1).describe("Recipient email addresses"),
@@ -1755,8 +1755,9 @@ export const SendEmailSchema = z.object({
 export const CreateEinsteinPredictionSchema = z.object({
     predictionName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Prediction API name"),
     label: z.string().min(1).describe("Prediction display label"),
-    objectApiName: z.string().min(1).describe("Salesforce object to run predictions on, e.g. 'Opportunity'"),
-    predictionType: z.enum(["BinaryClassification","Regression"]).describe("BinaryClassification for yes/no, Regression for numeric"),
+    objectApiName: z.string().optional().describe("Salesforce object to run predictions on, e.g. 'Opportunity'"),
+    objectName: z.string().optional().describe("Alias for objectApiName"),
+    predictionType: z.preprocess((v) => v === 'Classification' ? 'BinaryClassification' : v, z.enum(["BinaryClassification", "Regression", "Classification"])).describe("BinaryClassification/Classification for yes/no, Regression for numeric"),
     targetField: z.string().min(1).describe("Field API name to predict"),
     positiveLabel: z.string().default("Yes").describe("Label for positive outcome (BinaryClassification only)"),
     negativeLabel: z.string().default("No").describe("Label for negative outcome (BinaryClassification only)"),
@@ -1766,7 +1767,7 @@ export const CreateEinsteinPredictionSchema = z.object({
 export const CreateNextBestActionSchema = z.object({
     strategyName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Strategy API name"),
     label: z.string().min(1).describe("Strategy display label"),
-    contextObjectApiName: z.string().min(1).describe("Object that provides context, e.g. 'Account', 'Case'"),
+    contextObjectApiName: z.string().optional().describe("Object that provides context, e.g. 'Account', 'Case'"),
     recommendations: z.array(z.object({
         name: z.string().min(1).describe("Recommendation developer name"),
         label: z.string().min(1).describe("Label shown to users"),
@@ -1784,7 +1785,7 @@ export const CreateEinsteinBotSchema = z.object({
     dialogs: z.array(z.object({
         name: z.string().min(1).describe("Dialog developer name"),
         label: z.string().min(1).describe("Dialog display label"),
-        type: z.enum(["Main","System","Rule"]).default("Main").describe("Dialog type"),
+        type: z.enum(["Main", "System", "Rule"]).default("Main").describe("Dialog type"),
         isGoalStep: z.boolean().default(false).describe("Whether this dialog represents goal completion"),
         utterances: z.array(z.string()).optional().describe("Training utterances that trigger this dialog"),
         messages: z.array(z.string()).optional().describe("Bot messages to show"),
@@ -1795,10 +1796,10 @@ export const CreateUserRoleHierarchySchema = z.object({
     roleName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Role API name"),
     label: z.string().min(1).describe("Role display label"),
     parentRoleName: z.string().optional().describe("Parent role API name (omit for top-level)"),
-    caseAccessLevel: z.enum(["None","Read","Edit","ReadWrite"]).default("ReadWrite").describe("Case access for subordinates"),
-    contactAccessLevel: z.enum(["None","Read","Edit","ReadWrite"]).default("ReadWrite").describe("Contact access for subordinates"),
-    opportunityAccessLevel: z.enum(["None","Read","Edit","ReadWrite"]).default("ReadWrite").describe("Opportunity access for subordinates"),
-    accountAccessLevel: z.enum(["None","Read","Edit","ReadWrite"]).default("ReadWrite").describe("Account access for subordinates"),
+    caseAccessLevel: z.enum(["None", "Read", "Edit", "ReadWrite"]).default("ReadWrite").describe("Case access for subordinates"),
+    contactAccessLevel: z.enum(["None", "Read", "Edit", "ReadWrite"]).default("ReadWrite").describe("Contact access for subordinates"),
+    opportunityAccessLevel: z.enum(["None", "Read", "Edit", "ReadWrite"]).default("ReadWrite").describe("Opportunity access for subordinates"),
+    accountAccessLevel: z.enum(["None", "Read", "Edit", "ReadWrite"]).default("ReadWrite").describe("Account access for subordinates"),
     mayForecastManagerShare: z.boolean().default(true).describe("Grant manager forecast sharing"),
     description: z.string().optional().describe("Role description"),
 }).strict();
@@ -1813,20 +1814,21 @@ export const FreezeUserSchema = z.object({
 export const CreateETMTerritorySchema = z.object({
     territoryName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Territory API name"),
     label: z.string().min(1).describe("Territory display label"),
-    territoryType: z.string().min(1).describe("Territory2Type API name (must exist in org)"),
-    parentTerritoryName: z.string().optional().describe("Parent territory name for hierarchy"),
-    accountAccessLevel: z.enum(["View","Edit","All","None"]).default("View").describe("Account access for territory members"),
-    opportunityAccessLevel: z.enum(["View","Edit","All","None"]).default("View").describe("Opportunity access"),
-    caseAccessLevel: z.enum(["View","Edit","All","None"]).default("View").describe("Case access"),
+    territoryType: z.string().optional().describe("Territory2Type API name (must exist in org)"),
+    parentTerritoryName: z.union([z.string(), z.null()]).optional().describe("Parent territory name for hierarchy"),
+    accountAccessLevel: z.enum(["View", "Edit", "All", "None"]).default("View").describe("Account access for territory members"),
+    opportunityAccessLevel: z.enum(["View", "Edit", "All", "None"]).default("View").describe("Opportunity access"),
+    caseAccessLevel: z.enum(["View", "Edit", "All", "None"]).default("View").describe("Case access"),
     description: z.string().optional().describe("Territory description"),
 }).strict();
 export const AssignTerritoryToUserSchema = z.object({
     territoryName: z.string().min(1).describe("Territory API name to assign user to"),
     username: z.string().min(1).describe("Salesforce username to assign"),
-    roleInTerritory: z.enum(["Salesperson","AccountManager","Owner"]).default("Salesperson").describe("User role within the territory"),
+    roleInTerritory: z.enum(["Salesperson", "AccountManager", "Owner"]).default("Salesperson").describe("User role within the territory"),
 }).strict();
 export const CreateForecastHierarchySchema = z.object({
-    forecastingType: z.enum(["OpportunityRevenue","OpportunityQuantity","OverlayRevenue","OverlayQuantity","ProductFamily"]).describe("Forecasting type"),
+    forecastingType: z.enum(["OpportunityRevenue", "OpportunityQuantity", "OverlayRevenue", "OverlayQuantity", "ProductFamily"]).default("OpportunityRevenue").describe("Forecasting type"),
+    roleName: z.string().optional().describe("Role name (informational)"),
     displayCurrency: z.string().default("USD").describe("Currency code for display (e.g. 'USD', 'EUR')"),
     isActive: z.boolean().default(true).describe("Enable this forecasting type"),
 }).strict();
@@ -1840,24 +1842,30 @@ export const DeleteCustomFieldSchema = z.object({
     confirmDelete: z.boolean().describe("Must be true to confirm deletion — this is permanent"),
 }).strict();
 export const CreateRollupSummaryFieldSchema = z.object({
-    objectApiName: z.string().min(1).describe("Master object API name to add the rollup field to"),
+    objectApiName: z.string().optional().describe("Master object API name to add the rollup field to"),
+    objectName: z.string().optional().describe("Alias for objectApiName"),
     fieldName: z.string().min(1).max(40).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Field API name (without __c)"),
     label: z.string().min(1).describe("Field display label"),
     summaryObject: z.string().min(1).describe("Child (detail) object API name, e.g. 'Opportunity'"),
-    summaryType: z.enum(["COUNT","SUM","MIN","MAX"]).describe("Aggregation type"),
+    summaryType: z.enum(["COUNT", "SUM", "MIN", "MAX"]).optional().describe("Aggregation type"),
+    summaryOperation: z.enum(["COUNT", "SUM", "MIN", "MAX"]).optional().describe("Alias for summaryType"),
+    relationshipField: z.string().optional().describe("Relationship field on child object"),
     aggregatedField: z.string().optional().describe("Child field to aggregate (required for SUM/MIN/MAX, e.g. 'Amount')"),
-    filterCriteria: z.array(z.object({
-        field: z.string().describe("Child field API name"),
-        operator: z.enum(["equals","notEqual","lessThan","greaterThan","lessOrEqual","greaterOrEqual","contains","notContain","startsWith"]).describe("Filter operator"),
-        value: z.string().describe("Filter value"),
-    })).optional().describe("Filter criteria to limit which child records are included"),
+    filterCriteria: z.union([
+        z.string(),
+        z.array(z.object({
+            field: z.string().describe("Child field API name"),
+            operator: z.enum(["equals", "notEqual", "lessThan", "greaterThan", "lessOrEqual", "greaterOrEqual", "contains", "notContain", "startsWith"]).describe("Filter operator"),
+            value: z.string().describe("Filter value"),
+        })),
+    ]).optional().describe("Filter criteria: string SOQL-like expression or array of {field,operator,value} objects"),
     description: z.string().optional().describe("Field description"),
 }).strict();
 export const CreateExternalIdFieldSchema = z.object({
     objectApiName: z.string().min(1).describe("Object API name to add the field to"),
     fieldName: z.string().min(1).max(40).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Field API name (without __c)"),
     label: z.string().min(1).describe("Field display label"),
-    fieldType: z.enum(["Text","Number","Email","AutoNumber"]).default("Text").describe("Field data type"),
+    fieldType: z.enum(["Text", "Number", "Email", "AutoNumber"]).default("Text").describe("Field data type"),
     isUnique: z.boolean().default(true).describe("Enforce unique values"),
     isCaseSensitive: z.boolean().default(false).describe("Case-sensitive uniqueness enforcement (Text only)"),
     length: z.number().int().default(80).describe("Field length (Text fields only)"),
@@ -1878,23 +1886,27 @@ export const UpdateFlowSchema = z.object({
     newDescription: z.string().optional().describe("New description for the flow"),
     variablesToAdd: z.array(z.object({
         name: z.string().min(1).describe("Variable API name"),
-        dataType: z.enum(["String","Number","Currency","Boolean","Date","DateTime","SObject","Apex","Multipicklist","Picklist"]).describe("Variable data type"),
+        dataType: z.enum(["String", "Number", "Currency", "Boolean", "Date", "DateTime", "SObject", "Apex", "Multipicklist", "Picklist"]).describe("Variable data type"),
         isInput: z.boolean().default(false).describe("Available for input"),
         isOutput: z.boolean().default(false).describe("Available for output"),
         objectType: z.string().optional().describe("SObject API name (for SObject dataType)"),
         defaultValue: z.string().optional().describe("Default value expression"),
     })).optional().describe("Variables to add to the flow"),
+    label: z.string().optional().describe("Alias for newLabel"),
+    description: z.string().optional().describe("Alias for newDescription"),
 }).strict();
 export const CloneFlowSchema = z.object({
-    sourceFlowApiName: z.string().min(1).describe("Source flow API name to clone"),
-    newFlowApiName: z.string().min(1).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("New flow API name"),
-    newLabel: z.string().min(1).describe("New flow display label"),
+    sourceFlowApiName: z.string().optional().describe("Source flow API name to clone"),
+    sourceFlowName: z.string().optional().describe("Alias for sourceFlowApiName"),
+    newFlowApiName: z.string().optional().describe("New flow API name"),
+    newFlowName: z.string().optional().describe("Alias for newFlowApiName"),
+    newLabel: z.string().optional().describe("New flow display label"),
     activateImmediately: z.boolean().default(false).describe("Activate the cloned flow immediately"),
 }).strict();
 export const CreateFlowTestSchema = z.object({
     flowApiName: z.string().min(1).describe("Flow API name to test"),
     testName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Test definition API name"),
-    label: z.string().min(1).describe("Test display label"),
+    label: z.string().optional().describe("Test display label"),
     description: z.string().optional().describe("Test description"),
     inputs: z.array(z.object({
         name: z.string().describe("Variable name"),
@@ -1913,22 +1925,30 @@ export const CreateInvocableActionSchema = z.object({
     inputs: z.array(z.object({
         name: z.string().min(1).describe("Input variable name"),
         label: z.string().min(1).describe("Input variable label"),
-        dataType: z.enum(["String","Integer","Long","Double","Boolean","Date","Datetime","Id","sObject"]).describe("Data type"),
+        dataType: z.enum(["String", "Integer", "Long", "Double", "Boolean", "Date", "Datetime", "Id", "sObject"]).describe("Data type"),
         required: z.boolean().default(false).describe("Is input required"),
         sObjectType: z.string().optional().describe("SObject API name if dataType=sObject"),
     })).default([]).describe("Input parameters"),
     outputs: z.array(z.object({
         name: z.string().min(1).describe("Output variable name"),
         label: z.string().min(1).describe("Output variable label"),
-        dataType: z.enum(["String","Integer","Long","Double","Boolean","Date","Datetime","Id","sObject"]).describe("Data type"),
+        dataType: z.enum(["String", "Integer", "Long", "Double", "Boolean", "Date", "Datetime", "Id", "sObject"]).describe("Data type"),
         sObjectType: z.string().optional().describe("SObject API name if dataType=sObject"),
     })).default([]).describe("Output parameters"),
+    className: z.string().optional().describe("Apex class name (informational)"),
+    method: z.string().optional().describe("Method name (informational)"),
 }).strict();
 export const SearchApexSchema = z.object({
     searchTerm: z.string().min(1).describe("Text to search for in Apex code"),
-    searchIn: z.enum(["Classes","Triggers","Both"]).default("Both").describe("Where to search"),
+    searchIn: z.preprocess((v) => {
+        if (typeof v !== 'string')
+            return v;
+        const map = { classes: 'Classes', triggers: 'Triggers', both: 'Both', body: 'Both', all: 'Both' };
+        return map[v.toLowerCase()] ?? v;
+    }, z.enum(["Classes", "Triggers", "Both"]).default("Both")).describe("Where to search: 'Classes', 'Triggers', or 'Both' (also accepts lowercase)"),
     caseSensitive: z.boolean().default(false).describe("Case-sensitive search"),
     limit: z.number().int().default(50).describe("Maximum number of results"),
+    searchType: z.string().optional().describe("Alias for searchIn: class/classes/trigger/triggers/both"),
 }).strict();
 export const GetApexLogsSchema = z.object({
     username: z.string().optional().describe("Filter logs by Salesforce username"),
@@ -1940,7 +1960,9 @@ export const GetApexLogBodySchema = z.object({
 }).strict();
 export const CreateApexBatchSchema = z.object({
     className: z.string().min(1).max(40).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Apex batch class name"),
-    sObjectType: z.string().min(1).describe("SObject type to query and process, e.g. 'Account'"),
+    sObjectType: z.string().optional().describe("SObject type to query and process, e.g. 'Account'"),
+    objectApiName: z.string().optional().describe("Alias for sObjectType"),
+    queryFields: z.array(z.string()).optional().describe("Fields to include in query"),
     queryFilter: z.string().optional().describe("SOQL WHERE clause for start method, e.g. \"CreatedDate = TODAY\""),
     batchSize: z.number().int().default(200).describe("Batch size (records per execute call, 1-2000)"),
     description: z.string().optional().describe("Class description / what the batch does"),
@@ -1949,7 +1971,8 @@ export const CreateApexBatchSchema = z.object({
 }).strict();
 export const CreateApexSchedulerSchema = z.object({
     className: z.string().min(1).max(40).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Apex schedulable class name"),
-    jobName: z.string().min(1).describe("Default schedule job name"),
+    jobName: z.string().optional().describe("Default schedule job name"),
+    batchClass: z.string().optional().describe("Batch class to schedule (alias for batchClassName)"),
     cronExpression: z.string().default("0 0 2 * * ?").describe("Default cron expression, e.g. '0 0 2 * * ?' (daily at 2am)"),
     batchClassName: z.string().optional().describe("Batch class to execute (if this scheduler runs a batch)"),
     description: z.string().optional().describe("Class description"),
@@ -1962,13 +1985,13 @@ export const CreateScratchOrgSchema = z.object({
     devHubAlias: z.string().default("DevHub").describe("SF CLI alias for the Dev Hub org"),
     duration: z.number().int().min(1).max(30).default(7).describe("Scratch org lifetime in days (1–30)"),
     features: z.array(z.string()).default([]).describe("Scratch org features, e.g. ['Communities', 'ServiceCloud']"),
-    edition: z.enum(["Developer","Enterprise","Group","Professional"]).default("Developer").describe("Scratch org edition"),
+    edition: z.enum(["Developer", "Enterprise", "Group", "Professional"]).default("Developer").describe("Scratch org edition"),
     adminEmail: z.string().optional().describe("Admin email for the scratch org"),
     description: z.string().optional().describe("Description for the scratch org"),
 }).strict();
 export const CreateSandboxSchema = z.object({
     sandboxName: z.string().min(1).max(10).regex(/^[A-Za-z][A-Za-z0-9]*$/).describe("Sandbox name (max 10 chars, alphanumeric)"),
-    sandboxType: z.enum(["Developer","Developer_Pro","Partial","Full"]).describe("Sandbox type/license"),
+    sandboxType: z.enum(["Developer", "Developer_Pro", "Partial", "Full"]).describe("Sandbox type/license"),
     description: z.string().optional().describe("Sandbox description"),
     autoActivate: z.boolean().default(true).describe("Auto-activate after creation"),
     apexClassId: z.string().optional().describe("Apex class ID to run after sandbox copy (post-copy script)"),
@@ -1980,9 +2003,10 @@ export const RefreshSandboxSchema = z.object({
     apexClassId: z.string().optional().describe("Apex class ID to run after refresh (post-copy script)"),
 }).strict();
 export const ExportPackageXmlSchema = z.object({
-    metadataTypes: z.array(z.string()).default([]).describe("Metadata types to include. Empty array = all common types (ApexClass, CustomObject, Flow, PermissionSet, etc.)"),
+    metadataTypes: z.preprocess((v) => Array.isArray(v) ? v.map((item) => typeof item === 'object' && item !== null ? (item.type || item.name || String(item)) : item) : v, z.array(z.string()).default([])).describe("Metadata types to include: strings or {type, name} objects. Empty = all common types."),
     includeManaged: z.boolean().default(false).describe("Include managed package components"),
     apiVersion: z.string().optional().describe("API version for the package.xml (defaults to current API_VERSION)"),
+    components: z.any().optional().describe("Alias: array of {type, members} objects"),
 }).strict();
 export const CreateExperienceContainerSchema = z.object({
     pageName: z.string().min(1).describe("FlexiPage API name to add the container to"),
@@ -1996,20 +2020,26 @@ export const SetExperienceSiteLoginSchema = z.object({
     selfRegistrationEnabled: z.boolean().default(false).describe("Allow users to self-register"),
     selfRegistrationProfileName: z.string().optional().describe("Default profile for self-registered users"),
     forgotPasswordEnabled: z.boolean().default(true).describe("Show forgot password link"),
-    loginPageType: z.enum(["Standard","Custom"]).default("Standard").describe("Standard Salesforce login or custom login page"),
+    loginPageType: z.enum(["Standard", "Custom"]).default("Standard").describe("Standard Salesforce login or custom login page"),
     customLoginUrl: z.string().optional().describe("Custom login page URL (for Custom loginPageType)"),
 }).strict();
 export const CreateCmsContentSchema = z.object({
     contentName: z.string().min(1).max(255).describe("CMS content name"),
-    contentType: z.enum(["News","Document","Image","custom"]).describe("CMS content type"),
+    contentType: z.preprocess((v) => typeof v === 'string' ? v.charAt(0).toUpperCase() + v.slice(1).toLowerCase() : v, z.enum(["News", "Document", "Image", "Custom", "custom"])).describe("CMS content type: 'News', 'Document', 'Image', or 'custom' (case-insensitive)"),
     language: z.string().default("en_US").describe("Content language locale, e.g. 'en_US'"),
-    fields: z.record(z.string()).describe("Content field key-value pairs, e.g. {title: 'My Title', body: 'Content...'}"),
+    fields: z.union([
+        z.record(z.string()),
+        z.array(z.object({ name: z.string(), value: z.string() })).transform((arr) => Object.fromEntries(arr.map((f) => [f.name, f.value]))),
+    ]).describe("Content field key-value pairs, e.g. {title: 'My Title', body: 'Content...'}"),
     channelNames: z.array(z.string()).optional().describe("Experience Cloud site names to publish content to"),
+    title: z.string().optional().describe("Content title (mapped to fields.title)"),
+    body: z.string().optional().describe("Content body (mapped to fields.body)"),
 }).strict();
 export const ExportRecordsSchema = z.object({
     query: z.string().min(1).describe("Full SOQL query string"),
     includeHeaders: z.boolean().default(true).describe("Include CSV header row"),
     limit: z.number().int().default(2000).describe("Maximum records to export"),
+    format: z.string().optional().describe("Export format: json or csv"),
 }).strict();
 export const UpsertRecordSchema = z.object({
     objectApiName: z.string().min(1).describe("SObject API name, e.g. 'Account'"),
@@ -2019,36 +2049,45 @@ export const UpsertRecordSchema = z.object({
 }).strict();
 export const GetRecordSchema = z.object({
     objectApiName: z.string().min(1).describe("SObject API name, e.g. 'Account'"),
-    recordId: z.string().min(15).max(18).describe("Record ID"),
+    recordId: z.string().min(15).describe("Record ID (15 or 18 characters)"),
     fields: z.array(z.string()).optional().describe("Field API names to retrieve. Empty = all available fields"),
 }).strict();
 export const SearchRecordsSchema = z.object({
     searchTerm: z.string().min(1).describe("Search term (SOSL FIND clause value, no quotes needed)"),
-    objects: z.array(z.object({
+    objectTypes: z.array(z.string()).optional().describe("Alias for objects: array of object API name strings"),
+    objects: z.preprocess((v) => Array.isArray(v) ? v.map((item) => typeof item === 'string' ? { objectName: item, fields: ["Id", "Name"] } : item) : v, z.array(z.object({
         objectName: z.string().describe("SObject API name"),
         fields: z.array(z.string()).describe("Fields to return"),
-    })).default([{ objectName: "Account", fields: ["Id","Name"] }, { objectName: "Contact", fields: ["Id","Name","Email"] }]).describe("Objects to search across"),
+    })).default([{ objectName: "Account", fields: ["Id", "Name"] }, { objectName: "Contact", fields: ["Id", "Name", "Email"] }])).describe("Objects to search across: strings or {objectName, fields} objects"),
     limit: z.number().int().default(20).describe("Maximum results per object"),
 }).strict();
 export const CreatePlatformEventSubscriptionSchema = z.object({
-    eventApiName: z.string().min(1).describe("Platform event API name, e.g. 'My_Event__e'"),
-    subscriptionType: z.enum(["Trigger","Flow"]).describe("Subscribe via Apex trigger or Flow"),
-    subscriberName: z.string().min(1).describe("API name of the trigger or flow to create/reference"),
+    eventApiName: z.string().optional().describe("Platform event API name, e.g. 'My_Event__e'"),
+    platformEventName: z.string().optional().describe("Alias for eventApiName"),
+    subscriptionType: z.enum(["Trigger", "Flow"]).default("Flow").describe("Subscribe via Apex trigger or Flow"),
+    subscriberName: z.string().optional().describe("API name of the trigger or flow to create/reference"),
+    subscriberFlowName: z.string().optional().describe("Alias for subscriberName"),
+    description: z.string().optional().describe("Description"),
     apexCode: z.string().optional().describe("Apex trigger body (for Trigger type). Auto-generated if omitted."),
 }).strict();
 export const CreateChangedDataCaptureSchema = z.object({
-    objectApiName: z.string().min(1).describe("Object API name to enable CDC for, e.g. 'Account', 'Contact', 'My_Object__c'"),
+    objectApiName: z.string().optional().describe("Object API name to enable CDC for, e.g. 'Account', 'Contact', 'My_Object__c'"),
+    objectName: z.string().optional().describe("Alias for objectApiName"),
     enabled: z.boolean().default(true).describe("Enable or disable CDC for this object"),
 }).strict();
 export const CreateRestResourceSchema = z.object({
-    resourceName: z.string().min(1).max(40).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Apex class name for the REST resource"),
+    resourceName: z.string().optional().describe("Apex class name for the REST resource"),
+    className: z.string().optional().describe("Alias for resourceName"),
     urlMapping: z.string().min(1).describe("URL mapping, e.g. '/myresource/*' or '/accounts/:id'"),
     description: z.string().optional().describe("Resource description"),
-    methods: z.array(z.object({
-        httpMethod: z.enum(["GET","POST","PUT","DELETE","PATCH"]).describe("HTTP method"),
-        description: z.string().optional().describe("Method description"),
-        apexCode: z.string().optional().describe("Method body code (returns empty implementation if omitted)"),
-    })).min(1).describe("HTTP methods to implement"),
+    methods: z.array(z.union([
+        z.string().transform((s) => ({ httpMethod: s })),
+        z.object({
+            httpMethod: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH"]).describe("HTTP method"),
+            description: z.string().optional().describe("Method description"),
+            apexCode: z.string().optional().describe("Method body code (returns empty implementation if omitted)"),
+        }),
+    ])).min(1).describe("HTTP methods to implement (array of method names or {httpMethod, description?, apexCode?} objects)"),
 }).strict();
 export const GetOrgLimitsSchema = z.object({
     filter: z.string().optional().describe("Optional filter string — return only limits whose name contains this text (e.g. 'Api', 'Storage', 'Scratch')"),
@@ -2061,37 +2100,43 @@ export const GetFlowErrorsSchema = z.object({
 export const GetApexTestResultsSchema = z.object({
     testRunId: z.string().optional().describe("Specific test run ID (from sf_run_apex_tests). Omit to get latest run."),
     className: z.string().optional().describe("Filter to a specific Apex test class"),
-    outcomeFilter: z.enum(["Pass","Fail","CompileFail","Skip","all"]).default("all").describe("Filter by outcome"),
+    outcomeFilter: z.enum(["Pass", "Fail", "CompileFail", "Skip", "all"]).default("all").describe("Filter by outcome"),
+    limit: z.number().int().min(1).max(2000).default(200).optional().describe("Maximum results to return"),
 }).strict();
 export const GetDeploymentHistorySchema = z.object({
     limit: z.number().int().default(10).describe("Maximum deployments to return"),
-    status: z.enum(["Succeeded","Failed","Pending","InProgress","Canceling","all"]).default("all").describe("Filter by deployment status"),
+    status: z.enum(["Succeeded", "Failed", "Pending", "InProgress", "Canceling", "all"]).default("all").describe("Filter by deployment status"),
 }).strict();
 export const CreateAgentChannelSchema = z.object({
-    agentApiName: z.string().min(1).describe("Agentforce agent (Bot) API name"),
-    channelType: z.enum(["Messaging","Chat","Embedded","Voice"]).describe("Channel type to configure"),
+    agentApiName: z.string().optional().describe("Agentforce agent (Bot) API name"),
+    agentName: z.string().optional().describe("Alias for agentApiName"),
+    channelType: z.enum(["Messaging", "Chat", "Embedded", "Voice", "Web"]).describe("Channel type to configure"),
     channelName: z.string().min(1).describe("Existing channel API name (MessagingChannel for Messaging, LiveChatButton for Chat)"),
-    routingType: z.enum(["Queue","Agent","Bot"]).default("Bot").describe("Routing type — Bot routes to agent first, then escalates"),
+    routingType: z.enum(["Queue", "Agent", "Bot"]).default("Bot").describe("Routing type — Bot routes to agent first, then escalates"),
     queueName: z.string().optional().describe("Queue name for escalation (recommended when routingType=Bot)"),
+    label: z.string().optional().describe("Channel display label"),
 }).strict();
 export const CloneAgentSchema = z.object({
-    sourceAgentApiName: z.string().min(1).describe("Source agent (Bot) API name to clone"),
-    newAgentApiName: z.string().min(1).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("New agent API name"),
-    newLabel: z.string().min(1).describe("New agent display label"),
+    sourceAgentApiName: z.string().optional().describe("Source agent (Bot) API name to clone"),
+    sourceAgentName: z.string().optional().describe("Alias for sourceAgentApiName"),
+    newAgentApiName: z.string().optional().describe("New agent API name"),
+    newAgentName: z.string().optional().describe("Alias for newAgentApiName"),
+    newLabel: z.string().optional().describe("New agent display label"),
     includeTopics: z.boolean().default(true).describe("Clone the agent's topics (GenAiPlugins)"),
     includeActions: z.boolean().default(true).describe("Clone the agent's actions (GenAiFunctions) — requires includeTopics=true"),
 }).strict();
 export const ExportAgentSchema = z.object({
-    agentApiName: z.string().min(1).describe("Agent (Bot) API name to export"),
+    agentApiName: z.string().optional().describe("Agent (Bot) API name to export"),
+    agentName: z.string().optional().describe("Alias for agentApiName"),
 }).strict();
 export const ExportOmniStudioComponentSchema = z.object({
-    componentType: z.enum(["FlexCard","OmniScript","DataRaptor","IntegrationProcedure"]).describe("Component type to export"),
+    componentType: z.enum(["FlexCard", "OmniScript", "DataRaptor", "IntegrationProcedure"]).describe("Component type to export"),
     componentName: z.string().min(1).describe("Component API name"),
     subType: z.string().optional().describe("Sub-type (required for OmniScript and IntegrationProcedure: the subType portion of the fullName)"),
     language: z.string().default("English").describe("Language (for OmniScript, e.g. 'English')"),
 }).strict();
 export const ImportOmniStudioComponentSchema = z.object({
-    componentType: z.enum(["FlexCard","OmniScript","DataRaptor","IntegrationProcedure"]).describe("Component type to import"),
+    componentType: z.enum(["FlexCard", "OmniScript", "DataRaptor", "IntegrationProcedure"]).describe("Component type to import"),
     newName: z.string().min(1).describe("New API name for the imported component (must differ from source)"),
     jsonDefinition: z.string().min(1).describe("JSON string exported by sf_export_omnistudio_component"),
     activate: z.boolean().default(false).describe("Activate the component after import"),
@@ -2100,8 +2145,8 @@ export const CreateDocumentGenerationSchema = z.object({
     templateName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Template API name"),
     label: z.string().min(1).describe("Template display label"),
     objectApiName: z.string().min(1).describe("Context object API name, e.g. 'Account'"),
-    templateType: z.enum(["Word","PDF","Excel"]).default("Word").describe("Output document format"),
-    dataSourceType: z.enum(["DataRaptor","IntegrationProcedure"]).default("DataRaptor").describe("Data source type"),
+    templateType: z.enum(["Word", "PDF", "Excel"]).default("Word").describe("Output document format"),
+    dataSourceType: z.enum(["DataRaptor", "IntegrationProcedure"]).default("DataRaptor").describe("Data source type"),
     dataSourceName: z.string().min(1).describe("DataRaptor or Integration Procedure API name to feed data"),
     description: z.string().optional().describe("Template description"),
 }).strict();