salesforce-metadata-mcp 2.1.3 → 2.2.0

package/dist/schemas/index.js

@@ -862,6 +862,8 @@ export const CreateAgentSchema = z.object({
     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)."),
 }).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."),
@@ -870,6 +872,8 @@ export const CreateAgentTopicSchema = z.object({
     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'"),
@@ -882,15 +886,64 @@ 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'"),
-    flowApiName: z.string().min(1).max(255).describe("API name of the AutoLaunchedFlow to invoke, e.g. 'Create_Account_Record'. The flow must be Active and have runInMode=SystemModeWithoutSharing."),
-    inputs: z.array(AgentParamSchema).optional().describe("Flow input variables. Each input becomes a parameter the LLM collects from the user. Type MUST match the flow variable's data type."),
-    outputs: z.array(AgentParamSchema.omit({ required: true })).optional().describe("Flow output variables returned to the agent after execution, e.g. the created record ID"),
+    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)"),
 }).strict();
 // ─── MCP SERVER MANAGEMENT ───────────────────────────────────────────────────
 export const CreateMcpServerSchema = z.object({
@@ -985,11 +1038,379 @@ 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"),
 }).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"),
+    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'"),
+    label: z.string().optional().describe("New singular label"),
+    pluralLabel: z.string().optional().describe("New plural label"),
+    description: z.string().optional().describe("New description"),
+    enableHistory: z.boolean().optional().describe("Enable field history tracking"),
+    enableReports: z.boolean().optional().describe("Allow in reports"),
+    enableSearch: z.boolean().optional().describe("Allow in search"),
+    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'"),
+    label: z.string().optional().describe("New field label"),
+    description: z.string().optional().describe("New description"),
+    helpText: z.string().optional().describe("New inline help text"),
+    required: z.boolean().optional().describe("Make field required"),
+    unique: z.boolean().optional().describe("Enforce uniqueness"),
+    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'"),
+    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'"),
+    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)"),
+    required: z.boolean().default(false).describe("Make field required (Lookup only; MasterDetail is always required)"),
+    description: z.string().optional().describe("Field description"),
+}).strict();
+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"),
+    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"),
+}).strict();
+// ─── SECURITY & PERMISSIONS (v2.2.0) ─────────────────────────────────────────
+export const AssignPermissionSetSchema = z.object({
+    permissionSetName: z.string().min(1).describe("Permission Set API name, e.g. 'Sales_Rep_PS'"),
+    username: z.string().optional().describe("Username (email) of the user to assign to. Provide username OR userId."),
+    userId: z.string().optional().describe("Salesforce User ID (15 or 18 char). Provide username OR userId."),
+}).strict();
+export const CreatePermissionSetGroupSchema = z.object({
+    groupName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Permission Set Group API name"),
+    label: z.string().min(1).describe("Display label"),
+    description: z.string().optional().describe("Description"),
+    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'"),
+    read: z.boolean().default(false),
+    create: z.boolean().default(false),
+    edit: z.boolean().default(false),
+    delete: z.boolean().default(false),
+    viewAll: z.boolean().default(false),
+    modifyAll: z.boolean().default(false),
+});
+const FldPermSchema = z.object({
+    field: z.string().min(1).describe("Field in Object.Field format, e.g. 'Account.AnnualRevenue'"),
+    readable: z.boolean().default(true),
+    editable: z.boolean().default(false),
+});
+export const UpdatePermissionSetSchema = z.object({
+    permissionSetName: z.string().min(1).describe("Existing Permission Set API name to update"),
+    objectPermissions: z.array(ObjPermSchema).optional().describe("Object permissions to set. Replaces existing permissions for specified objects."),
+    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"),
+    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'"),
+    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)"),
+}).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)"),
+}).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'"),
+}).strict();
+const ProfileObjPermSchema = z.object({
+    object: z.string().min(1).describe("Object API name"),
+    allowCreate: z.boolean().default(false),
+    allowDelete: z.boolean().default(false),
+    allowEdit: z.boolean().default(false),
+    allowRead: z.boolean().default(true),
+    viewAllRecords: z.boolean().default(false),
+    modifyAllRecords: z.boolean().default(false),
+});
+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"),
+    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"),
+    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"),
+}).strict();
+export const AssignPageLayoutSchema = z.object({
+    objectApiName: z.string().min(1).describe("Object API name, e.g. 'Account'"),
+    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"),
+    recordTypeName: z.string().optional().describe("Record type developer name (if assigning to a specific record type)"),
+}).strict();
+const FlexiComponentSchema = z.object({
+    componentName: z.string().describe("LWC or Aura component API name, e.g. 'flexipage:recordDetail'"),
+    region: z.string().describe("Page region, e.g. 'main', 'sidebar', 'left', 'center', 'right'"),
+    order: z.number().int().optional().describe("Component order within region (0-based)"),
+    properties: z.record(z.unknown()).optional().describe("Component property values"),
+});
+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"),
+    components: z.array(FlexiComponentSchema).optional().describe("Components to add to the page"),
+}).strict();
+export const CreateLightningHomePageSchema = 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"),
+    template: z.string().default("Home").describe("Page template name"),
+    components: z.array(FlexiComponentSchema).optional().describe("Components to add to the page"),
+}).strict();
+export const UpdateLightningPageSchema = z.object({
+    pageApiName: z.string().min(1).describe("FlexiPage API name to update"),
+    componentsToAdd: z.array(FlexiComponentSchema).optional().describe("Components to add"),
+    componentsToRemove: z.array(z.string()).optional().describe("Component names to remove"),
+}).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"),
+    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'"),
+    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"),
+    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"),
+    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"),
+    description: z.string().optional().describe("Action description"),
+}).strict();
+// ─── APEX & LWC (v2.2.0) ─────────────────────────────────────────────────────
+export const UpdateApexClassSchema = z.object({
+    className: z.string().min(1).describe("Apex class API name (without .cls extension)"),
+    body: z.string().min(1).describe("Full updated Apex class source code"),
+    apiVersion: z.string().default("66.0").describe("API version for the class"),
+}).strict();
+export const GetApexClassSchema = z.object({
+    className: z.string().min(1).describe("Apex class name to retrieve"),
+}).strict();
+export const GetCodeCoverageSchema = z.object({
+    className: z.string().optional().describe("Apex class or trigger name to get coverage for. Omit to get all classes."),
+}).strict();
+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)"),
+    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"),
+    sidebar: z.boolean().default(true).describe("Show sidebar"),
+    standardStylesheets: z.boolean().default(true).describe("Include standard Salesforce stylesheets"),
+}).strict();
+export const CreateAuraComponentSchema = z.object({
+    componentName: z.string().min(1).max(40).regex(/^[A-Za-z][A-Za-z0-9]*$/).describe("Aura component name (camelCase, no underscores)"),
+    description: z.string().optional().describe("Component description"),
+    markup: z.string().min(1).describe("Component markup (.cmp file content, must include <aura:component> tag)"),
+    controller: z.string().optional().describe("Controller JavaScript content"),
+    helper: z.string().optional().describe("Helper JavaScript content"),
+    style: z.string().optional().describe("CSS styles"),
+    isExposed: z.boolean().default(false).describe("Expose component for use in Lightning App Builder"),
+    targets: z.array(z.string()).optional().describe("App Builder targets, e.g. ['lightning__RecordPage', 'lightning__AppPage']"),
+}).strict();
+// ─── 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"),
+    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"),
+    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"),
+}).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"),
+        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"),
+}).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"),
+}).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"),
+        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"),
+}).strict();
+// ─── USERS & DATA (v2.2.0) ───────────────────────────────────────────────────
+export const CreateUserSchema = z.object({
+    firstName: z.string().min(1).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)"),
+    alias: z.string().min(1).max(8).describe("User alias (max 8 chars, shown in list views)"),
+    profileName: z.string().min(1).describe("Profile name, e.g. 'Standard User', 'System Administrator'"),
+    roleName: z.string().optional().describe("Role name to assign, e.g. 'CEO'"),
+    timeZone: z.string().default("America/Los_Angeles").describe("Timezone, e.g. 'America/New_York'"),
+    locale: z.string().default("en_US").describe("Locale, e.g. 'en_US'"),
+    emailEncoding: z.string().default("UTF-8").describe("Email encoding"),
+    languageLocale: z.string().default("en_US").describe("Language and locale, e.g. 'en_US'"),
+}).strict();
+export const UpdateUserSchema = z.object({
+    username: z.string().min(1).describe("Username to identify the user to update"),
+    profileName: z.string().optional().describe("New profile name"),
+    roleName: z.string().optional().describe("New role name (or empty string to remove role)"),
+    isActive: z.boolean().optional().describe("Activate or deactivate the user"),
+    additionalFields: z.record(z.unknown()).optional().describe("Additional User SObject fields to update, e.g. {Department: 'Sales', Title: 'Manager'}"),
+}).strict();
+export const AssignQueueMemberSchema = z.object({
+    queueDeveloperName: z.string().min(1).describe("Queue developer name (DeveloperName field on Group), e.g. 'Support_Tier1'"),
+    users: z.array(z.string()).optional().describe("Usernames to add to the queue"),
+    roles: z.array(z.string()).optional().describe("Role API names to add to the queue (adds all users in the role)"),
+}).strict();
+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"),
+        name: z.string().describe("Username, role name, or group developer name"),
+    })).optional().describe("Initial group members"),
+}).strict();
+export const QueryRecordsSchema = z.object({
+    query: z.string().min(1).describe("Full SOQL query string, e.g. 'SELECT Id, Name FROM Account WHERE Industry = \\'Technology\\' LIMIT 10'"),
+    limit: z.number().int().min(1).max(2000).default(200).describe("Maximum records to return (default 200)"),
+}).strict();
+export const CreateRecordSchema = z.object({
+    objectApiName: z.string().min(1).describe("SObject API name, e.g. 'Account', 'Contact', 'My_Object__c'"),
+    fields: z.record(z.unknown()).describe("Key-value pairs of field API names to values, e.g. {Name: 'Acme', Industry: 'Technology'}"),
+}).strict();
+export const UpdateRecordSchema = z.object({
+    objectApiName: z.string().min(1).describe("SObject API name"),
+    recordId: z.string().min(15).max(18).describe("Salesforce record ID (15 or 18 chars)"),
+    fields: z.record(z.unknown()).describe("Key-value pairs of field API names to update values"),
+}).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"),
+    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();
+// ─── INTEGRATION (v2.2.0) ─────────────────────────────────────────────────────
+export const CreateOutboundMessageSchema = z.object({
+    messageName: z.string().min(1).max(80).regex(/^[A-Za-z][A-Za-z0-9_]*$/).describe("Outbound message API name"),
+    label: z.string().min(1).describe("Display label"),
+    objectName: z.string().min(1).describe("Object API name this message fires from, e.g. 'Account'"),
+    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"),
+    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"),
+    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"),
+}).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"),
+    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();
+export const ListMetadataSchema = z.object({
+    metadataType: z.string().min(1).describe("Metadata type to list, e.g. 'ApexClass', 'Flow', 'CustomObject', 'PermissionSet'"),
+}).strict();
+// ─── EXPERIENCE CLOUD (v2.2.0) ────────────────────────────────────────────────
+export const PublishExperienceSiteSchema = z.object({
+    siteName: z.string().min(1).describe("Experience Cloud site API name"),
+}).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"),
+    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"),
+    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"),
+        position: z.number().int().optional().describe("Position (1-based)"),
+    })).min(1).describe("Navigation menu items"),
+}).strict();
+export const CreateExperienceSiteMemberSchema = z.object({
+    siteName: z.string().min(1).describe("Experience Cloud site API name"),
+    profiles: z.array(z.string()).min(1).describe("Profile names to add as site members"),
+}).strict();
+export const SetExperienceSiteBrandingSchema = z.object({
+    siteName: z.string().min(1).describe("Experience Cloud site API name"),
+    primaryColor: z.string().optional().describe("Primary brand color as hex, e.g. '#0176D3'"),
+    secondaryColor: z.string().optional().describe("Secondary brand color as hex"),
+    backgroundColor: z.string().optional().describe("Page background color as hex"),
+    headerBackgroundColor: z.string().optional().describe("Header background color as hex"),
+    logoUrl: z.string().url().optional().describe("Logo image URL"),
 }).strict();
 //# sourceMappingURL=index.js.map

package/dist/services/deployment.js

@@ -86,11 +86,14 @@ export async function buildGenAiActionZip(params, apiVersion) {
         <parameterName>${escapeXml(out.name)}</parameterName>
         <parameterType>output</parameterType>
     </mappingAttributes>`).join("\n");
+    const isApex = params.invocationTargetType === "ApexClass";
+    const invocationTarget = isApex ? (params.apexClassName ?? "") : (params.flowApiName ?? "");
+    const invocationTargetType = isApex ? "apexClass" : "flow";
     const functionXml = `<?xml version="1.0" encoding="UTF-8"?>
 <GenAiFunction xmlns="http://soap.sforce.com/2006/04/metadata">
     <description>${escapeXml(params.description)}</description>
-    <invocationTarget>${escapeXml(params.flowApiName)}</invocationTarget>
-    <invocationTargetType>flow</invocationTargetType>
+    <invocationTarget>${escapeXml(invocationTarget)}</invocationTarget>
+    <invocationTargetType>${invocationTargetType}</invocationTargetType>
     <isConfirmationRequired>false</isConfirmationRequired>
     <masterLabel>${escapeXml(params.label)}</masterLabel>
     ${inputsXml}
@@ -160,6 +163,28 @@ function lightningTypeFor(sfType) {
         return "lightning__textAreaType";
     return "lightning__textType";
 }
+export async function buildVFPageZip(pageName, markup, apiVersion) {
+    const zip = new JSZip();
+    const packageXml = buildPackageXml([{ name: "ApexPage", members: [pageName] }], apiVersion);
+    zip.file("package.xml", packageXml);
+    zip.file(`pages/${pageName}.page`, markup);
+    zip.file(`pages/${pageName}.page-meta.xml`, `<?xml version="1.0" encoding="UTF-8"?>\n<ApexPage xmlns="http://soap.sforce.com/2006/04/metadata">\n  <apiVersion>${apiVersion}</apiVersion>\n  <availableInTouch>true</availableInTouch>\n  <confirmationTokenRequired>false</confirmationTokenRequired>\n  <label>${pageName}</label>\n</ApexPage>`);
+    const buffer = await zip.generateAsync({ type: "nodebuffer" });
+    return buffer.toString("base64");
+}
+export async function buildAuraZip(componentName, markup, controller, helper, style, apiVersion) {
+    const zip = new JSZip();
+    const packageXml = buildPackageXml([{ name: "AuraDefinitionBundle", members: [componentName] }], apiVersion);
+    zip.file("package.xml", packageXml);
+    const dir = `aura/${componentName}`;
+    zip.file(`${dir}/${componentName}.cmp`, markup || `<aura:component>\n</aura:component>`);
+    zip.file(`${dir}/${componentName}.cmp-meta.xml`, `<?xml version="1.0" encoding="UTF-8"?>\n<AuraDefinitionBundle xmlns="http://soap.sforce.com/2006/04/metadata">\n  <apiVersion>${apiVersion}</apiVersion>\n  <description>${componentName}</description>\n</AuraDefinitionBundle>`);
+    if (controller) zip.file(`${dir}/${componentName}Controller.js`, controller);
+    if (helper) zip.file(`${dir}/${componentName}Helper.js`, helper);
+    if (style) zip.file(`${dir}/${componentName}.css`, style);
+    const buffer = await zip.generateAsync({ type: "nodebuffer" });
+    return buffer.toString("base64");
+}
 export async function buildGenericDeployZip(components, apiVersion) {
     const zip = new JSZip();
     const typeMap = new Map();
@@ -190,7 +215,8 @@ export async function deployZip(auth, base64Zip, options = {}) {
         <met:allowMissingFiles>false</met:allowMissingFiles>
         <met:autoUpdatePackage>false</met:autoUpdatePackage>
         <met:checkOnly>${options.checkOnly === true}</met:checkOnly>
-        <met:runAllTests>false</met:runAllTests>
+        <met:runAllTests>${options.testLevel === "RunAllTestsInOrg" ? "true" : "false"}</met:runAllTests>
+        ${options.testLevel && options.testLevel !== "RunAllTestsInOrg" ? `<met:testLevel>${options.testLevel}</met:testLevel>` : ""}
         ${testsXml}
         <met:rollbackOnError>${options.rollbackOnError !== false}</met:rollbackOnError>
         <met:singlePackage>true</met:singlePackage>