@salesforce/afv-skills 1.65.0 → 1.65.1

package/skills/agentforce-gpt-email-generation-configure/SKILL.md

@@ -1,312 +0,0 @@
----
-name: agentforce-gpt-email-generation-configure
-description: "Use this skill when users want to manage the GPT Email Generation (Sales Email Assistant) setup page. Trigger when users mention gptemail, generation, gptemail generation."
-metadata:
-  version: "1.0"
----
-
-# Managing Gpt Email Generation
-
-## When to Use This Skill
-
-Manage the GPT Email Generation (Sales Email Assistant) setup page. Reads/writes the EinsteinGPTSalesEmails master pref plus 8 related ECI/Sales-Signals/Coaching feature toggles. Also exposes a composite getState aggregator (28+ keys: pref values, feature-access flags, Hawking ML-platform tenant provisioning status, Conversation Mining provisioning status, CDP/Genie status, Signals2DC status, computed UI-state enum ENABLED/DISABLED/IN_PROGRESS/HAWKING_TENANT_ERROR) and a refresh action that kicks off Conversation Mining background work. All toggles return Boolean (resulting pref/perm value); some have value-add behavior agents must know about — sales-email enable atomically also flips OnlyUseBuilderPrompts so open-prompt is on by default; open-prompt's enabled=true means OnlyUseBuilderPrompts=false (semantic inversion).
-
-## Workflow
-
-Read get-state first to discover current pref/perm/provisioning state and the computed UI-state enum (ENABLED/DISABLED/IN_PROGRESS/HAWKING_TENANT_ERROR). Toggle ordering: when enabling Sales Email Assistant via toggle-sales-email-pref, run toggle-open-prompt AFTER if you want explicit open-prompt control (enabling sales-email auto-flips OnlyUseBuilderPrompts to false in legacy-discovery-off orgs). For Conversation Mining: toggle-sales-conversation-mining-pref must run before toggle-sales-conversation-mining-apd360-perm and refresh-sales-mining (the perm and refresh sit on top of the feature pref). Each write returns Boolean (the resulting pref/perm value); follow with the paired verify-* step to read back via get-state and confirm. Note that toggle-sales-email-pref's enable path performs an atomic dual-pref bulk write (EinsteinGPTSalesEmails=true + OnlyUseBuilderPrompts=false); a single failure rolls back both. Hawking ML-platform tenant must be ready (getState.isHawkingTenantReady) before the UI state reaches ENABLED.
-
-## Critical Constraints
-
-**Preconditions:**
-
-- User must have ConversationalIntelligence AccessConversationMiningSettings access (gates conversation-mining/signals2dc/refresh-sales-mining toggles). (check: `Conversation Mining Settings access`)
-- User must have SalesEmailAssistant ModifyOpenPromptAccess access (gates toggle-open-prompt only). (check: `Modify Sales Email prompt access`)
-- User must have SfaGenerative AccessSalesRecordSummaries access (gates call-explorer / APD360-perm / sales-rep-feedback / generative-insights toggles). (check: `Sales Record Summaries access`)
-- Setup admin permission (View Setup + Setup admin) is required ONLY on the single-pref and perm writes — a non-admin gets NoAccessException on those. That covers: signals2dc, sales-rep-feedback, generative-insights, the APD360 perm, and the discovery-framework-OFF single-pref writes (call-summarization / call-explorer / conversation-mining, and sales-email DISABLE). It does NOT cover the sales-email ENABLE bulk-pref path (no admin check) or ANY discovery-framework-ON path (no admin check) — those enforce their own feature-scoped access instead.
-- Einstein GPT platform must be enabled at the org level — getState surfaces this as hasEinsteinGPTSetupDisabled (true means the platform is OFF and the page renders disabled).
-- For sales-email enablement to reach UI state ENABLED: the Hawking ML-platform tenant must be in PROVISION_SUCCESS — getState surfaces this as isHawkingTenantReady. PROVISION_FAILED resets the pref to false; PROVISIONING surfaces UI state IN_PROGRESS.
-- Einstein Conversation Insights (ECI) must be enabled — call-summarization, call-explorer, and conversation-mining feature access requires hasECIEnabled = ORG_PERMISSION_CONVERSATION_PILOT + ORG_PREFERENCE_CONVERSATION_PILOT_PREF + ORG_PERMISSION_CALL_COACHING_READY (getState computes this combined flag).
-- For Signals2DC: CDP/Genie must be enabled (Data Cloud enabled) for the salesConversationMiningDataCloudStatus to reflect a real provisioning state; otherwise getState returns -1 indicating CDP/Genie unavailable.
-
-## Verification Checklist
-
-After every write operation, confirm the effect by re-reading state:
-
-- After `toggle-sales-email-pref`: call `verify-toggle-sales-email-pref` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `toggle-open-prompt`: call `verify-toggle-open-prompt` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `toggle-sales-call-summarization-pref`: call `verify-toggle-sales-call-summarization-pref` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `toggle-sales-call-explorer-pref`: call `verify-toggle-sales-call-explorer-pref` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `toggle-sales-conversation-mining-pref`: call `verify-toggle-sales-conversation-mining-pref` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `toggle-signals2dc-pref`: call `verify-toggle-signals2dc-pref` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `toggle-sales-conversation-mining-apd360-perm`: call `verify-toggle-sales-conversation-mining-apd360-perm` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `toggle-sales-rep-feedback-pref`: call `verify-toggle-sales-rep-feedback-pref` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `toggle-sales-call-generative-insights-pref`: call `verify-toggle-sales-call-generative-insights-pref` (`GET /headless/invoke/platform/gptemail-generation`)
-- After `refresh-sales-mining`: call `verify-refresh-sales-mining` (`GET /headless/invoke/platform/gptemail-generation`)
-
-## Operations Reference
-
-Operations grouped by purpose. Use these as the building blocks for the workflows above.
-
-### Summary
-
-| Operation | Purpose | Status | Call | Depends on |
-|-----------|---------|--------|------|------------|
-| `toggle-sales-email-pref` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-email-pref-toggle` | — |
-| `toggle-open-prompt` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-open-prompt-toggle` | `toggle-sales-email-pref` |
-| `toggle-sales-call-summarization-pref` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-call-summarization-pref-toggle` | — |
-| `toggle-sales-call-explorer-pref` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-call-explorer-pref-toggle` | — |
-| `toggle-sales-conversation-mining-pref` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-conversation-mining-pref-toggle` | — |
-| `toggle-signals2dc-pref` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-signals2-dcpref-toggle` | — |
-| `toggle-sales-conversation-mining-apd360-perm` | write | implemented | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-conversation-mining-apd360-perm-toggle` | `toggle-sales-conversation-mining-pref` |
-| `toggle-sales-rep-feedback-pref` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-rep-feedback-pref-toggle` | — |
-| `toggle-sales-call-generative-insights-pref` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-call-generative-insights-pref-toggle` | — |
-| `get-state` | read | implemented | `GET /headless/invoke/platform/gptemail-generation` | — |
-| `refresh-sales-mining` | write | proposed | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-mining-refresh` | `toggle-sales-conversation-mining-pref` |
-| `verify-toggle-sales-email-pref` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-sales-email-pref` |
-| `verify-toggle-open-prompt` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-open-prompt` |
-| `verify-toggle-sales-call-summarization-pref` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-sales-call-summarization-pref` |
-| `verify-toggle-sales-call-explorer-pref` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-sales-call-explorer-pref` |
-| `verify-toggle-sales-conversation-mining-pref` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-sales-conversation-mining-pref` |
-| `verify-toggle-signals2dc-pref` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-signals2dc-pref` |
-| `verify-toggle-sales-conversation-mining-apd360-perm` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-sales-conversation-mining-apd360-perm` |
-| `verify-toggle-sales-rep-feedback-pref` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-sales-rep-feedback-pref` |
-| `verify-toggle-sales-call-generative-insights-pref` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `toggle-sales-call-generative-insights-pref` |
-| `verify-refresh-sales-mining` | verify | — | `GET /headless/invoke/platform/gptemail-generation` | `refresh-sales-mining` |
-
-### Dependency graph
-
-```mermaid
-graph TD
-  toggle_sales_email_pref["toggle-sales-email-pref (write)"]
-  toggle_open_prompt["toggle-open-prompt (write)"]
-  toggle_sales_call_summarization_pref["toggle-sales-call-summarization-pref (write)"]
-  toggle_sales_call_explorer_pref["toggle-sales-call-explorer-pref (write)"]
-  toggle_sales_conversation_mining_pref["toggle-sales-conversation-mining-pref (write)"]
-  toggle_signals2dc_pref["toggle-signals2dc-pref (write)"]
-  toggle_sales_conversation_mining_apd360_perm["toggle-sales-conversation-mining-apd360-perm (write)"]
-  toggle_sales_rep_feedback_pref["toggle-sales-rep-feedback-pref (write)"]
-  toggle_sales_call_generative_insights_pref["toggle-sales-call-generative-insights-pref (write)"]
-  get_state["get-state (read)"]
-  refresh_sales_mining["refresh-sales-mining (write)"]
-  verify_toggle_sales_email_pref["verify-toggle-sales-email-pref (verify)"]
-  verify_toggle_open_prompt["verify-toggle-open-prompt (verify)"]
-  verify_toggle_sales_call_summarization_pref["verify-toggle-sales-call-summarization-pref (verify)"]
-  verify_toggle_sales_call_explorer_pref["verify-toggle-sales-call-explorer-pref (verify)"]
-  verify_toggle_sales_conversation_mining_pref["verify-toggle-sales-conversation-mining-pref (verify)"]
-  verify_toggle_signals2dc_pref["verify-toggle-signals2dc-pref (verify)"]
-  verify_toggle_sales_conversation_mining_apd360_perm["verify-toggle-sales-conversation-mining-apd360-perm (verify)"]
-  verify_toggle_sales_rep_feedback_pref["verify-toggle-sales-rep-feedback-pref (verify)"]
-  verify_toggle_sales_call_generative_insights_pref["verify-toggle-sales-call-generative-insights-pref (verify)"]
-  verify_refresh_sales_mining["verify-refresh-sales-mining (verify)"]
-  toggle_sales_email_pref --> toggle_open_prompt
-  toggle_sales_conversation_mining_pref --> toggle_sales_conversation_mining_apd360_perm
-  toggle_sales_conversation_mining_pref --> refresh_sales_mining
-  toggle_sales_email_pref --> verify_toggle_sales_email_pref
-  toggle_open_prompt --> verify_toggle_open_prompt
-  toggle_sales_call_summarization_pref --> verify_toggle_sales_call_summarization_pref
-  toggle_sales_call_explorer_pref --> verify_toggle_sales_call_explorer_pref
-  toggle_sales_conversation_mining_pref --> verify_toggle_sales_conversation_mining_pref
-  toggle_signals2dc_pref --> verify_toggle_signals2dc_pref
-  toggle_sales_conversation_mining_apd360_perm --> verify_toggle_sales_conversation_mining_apd360_perm
-  toggle_sales_rep_feedback_pref --> verify_toggle_sales_rep_feedback_pref
-  toggle_sales_call_generative_insights_pref --> verify_toggle_sales_call_generative_insights_pref
-  refresh_sales_mining --> verify_refresh_sales_mining
-```
-
-### Read operations
-
-#### `get-state`
-
-Read the composite Sales Email Assistant + Conversation Intelligence setup state. Returns a Map<String,Object> aggregating: the computed UI-state enum (ENABLED/DISABLED/IN_PROGRESS/HAWKING_TENANT_ERROR), per-feature access flags, every controller-managed pref/perm value, Hawking ML-platform tenant provisioning status, conversation-mining provisioning status, CDP/Genie status, signalsDC status + details, and a SIQ-in-migration flag. The UI-state enum derives from sales-email pref + Hawking provisioning status; on PROVISION_FAILED with the pref enabled, getState ALSO resets the pref to false (side-effect). Read this first for state discovery and for verify-* steps confirming pref/perm writes.
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`   — status: `implemented`
-
-**Output:** Map<String,Object> with ~28 keys: state (computed UI-state enum: ENABLED/DISABLED/IN_PROGRESS/HAWKING_TENANT_ERROR), hasSalesEmailAssistant (boolean), isSalesEmailAssistantPrefEnabled (boolean), isOpenPromptEnabled (boolean — already-inverted; true means open-prompt allowed), hasSalesCallSummarization, isSalesCallSummarizationPrefEnabled, hasSalesCallExplorer, isSalesCallExplorerPrefEnabled, hawkingTenantStatus (ProvisioningStatusEnum: PROVISION_SUCCESS/PROVISIONING/PROVISION_FAILED), isHawkingTenantReady, hasEinsteinGPTSetupDisabled (true means Einstein GPT platform pref is OFF), hasSalesRepFeedback, isSalesRepFeedbackPrefEnabled, hasSalesCallGenerativeInsights, isSalesCallGenerativeInsightsPrefEnabled, isSIQInMigration, isECIToCoreMigrationInProgress, isSalesConversationMiningPermEnabled, isSalesConversationMiningPrefEnabled, isSalesConversationMiningAPD360PermEnabled, salesConversationMiningProvisioningStatus (ConversationMiningProvisioningStatusEnum stringified), salesConversationMiningDataCloudStatus (number; -1 indicates CDP/Genie unavailable), salesConversationMiningAPD360ECIStatus (string), salesConversationMiningStatus (ConversationMiningStatus object — populated only when conversation-mining pref is on), eciSignals2DCFeatureAccess (boolean), eciSignals2DCPref (boolean), signalsDCStatus (string), signalsDCDetails (string).
-
-### Write operations
-
-#### `toggle-sales-email-pref`
-
-Toggle the EinsteinGPTSalesEmails org pref. On enable in legacy-discovery-off orgs performs an atomic dual-pref bulk write that also flips OnlyUseBuilderPrompts=false (open-prompt on by default); a SaveResult failure on either pref returns false and rolls back. On enable in discovery-on orgs the write routes through the Discovery Framework path for the Sales Email feature, which runs pre-enablement validation. Returns the resulting EinsteinGPTSalesEmails value. No public Connect/Tooling/Metadata alternative replicates the dual-pref atomic batch.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-email-pref-toggle`   — status: `proposed`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-#### `toggle-open-prompt`
-
-Toggle open-prompt mode for Sales Email Assistant by writing the OnlyUseBuilderPrompts org pref to the INVERSE of `enabled` (enabled=true → OnlyUseBuilderPrompts=false → open prompts allowed). Returns whether open-prompt is enabled after the write (also inverted). Gated by Modify Sales Email prompt access. No public Connect/Tooling alternative; raw OrgPreferences write of OnlyUseBuilderPrompts is technically possible but semantic inversion makes substitution error-prone.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-open-prompt-toggle`   — status: `proposed`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-**Depends on:** `toggle-sales-email-pref`
-
-#### `toggle-sales-call-summarization-pref`
-
-Toggle the CallSummarization org pref (Conversational Intelligence). Dual-mode: legacy-discovery-off orgs do a direct pref write; discovery-on orgs route through the Discovery Framework path for the Call Summarization feature. Returns the resulting pref value. Public alternative `POST /connect/setup/discovery/feature/sales-cloud-call-summaries/{enable,disable}` exists but splits one toggle into two endpoints — substituting changes SOR shape; controller is the unified-toggle public surface.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-call-summarization-pref-toggle`   — status: `proposed`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-#### `toggle-sales-call-explorer-pref`
-
-Toggle the CallExplorerEnabled org pref (Conversational Intelligence). Dual-mode: legacy direct pref write, or discovery-on orgs route through the Discovery Framework path for the Call Explorer feature. Returns the resulting pref value. Gated by Sales Record Summaries access. Public alternative `POST /connect/setup/discovery/feature/sales-cloud-call-explorer/{enable,disable}` (Connect API SetupDiscovery) exists with shape mismatch.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-call-explorer-pref-toggle`   — status: `proposed`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-#### `toggle-sales-conversation-mining-pref`
-
-Toggle the ConversationMining org pref (Sales Signals). Dual-mode: legacy direct pref write, or discovery-on orgs route through the Discovery Framework path for the Sales Signals feature. Returns the resulting pref value. Gated by Conversation Mining Settings access. Prerequisite step for the APD360-perm and refresh-sales-mining toggles. Public alternative `POST /connect/setup/discovery/feature/sales-cloud-sales-signals/{enable,disable}` exists with shape mismatch.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-conversation-mining-pref-toggle`   — status: `proposed`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-#### `toggle-signals2dc-pref`
-
-Toggle the ECISignals2DC org pref (Signals to DataCloud). Single direct pref write (no discovery-framework branch for this pref). Returns the resulting pref value. Gated by Conversation Mining Settings access. CDP/Genie should be enabled for the resulting signalsDCStatus to reflect a real provisioning state. No public Connect/Tooling/Metadata alternative for this specific pref.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-signals2-dcpref-toggle`   — status: `proposed`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-#### `toggle-sales-conversation-mining-apd360-perm`
-
-Toggle the aPD360ForECI org-permission bit. Direct org-permission write (NOT a pref). Returns the resulting perm value. Gated by Sales Record Summaries access. Should run AFTER toggle-sales-conversation-mining-pref — the perm sits on top of the conversation-mining feature pref. No public Metadata/Tooling alternative for org-permission bits at this level.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-conversation-mining-apd360-perm-toggle`   — status: `implemented`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-**Depends on:** `toggle-sales-conversation-mining-pref`
-
-#### `toggle-sales-rep-feedback-pref`
-
-Toggle the EinsteinSalesRepFdbkEnab org pref (Enablement Coaching). Single direct pref write. Returns the resulting pref value. Gated by Sales Record Summaries access. No public Connect/Tooling/Metadata Settings type covers this specific pref.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-rep-feedback-pref-toggle`   — status: `proposed`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-#### `toggle-sales-call-generative-insights-pref`
-
-Toggle the GenerativeConvInsights org pref (Conversational Intelligence). Single direct pref write, plus a server-side info log. Returns the resulting pref value. Gated by Sales Record Summaries access. No public Metadata Settings type covers this specific pref.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-call-generative-insights-pref-toggle`   — status: `proposed`
-
-**Inputs:**
-
-- `enabled` *(`boolean`)* — Whether d is enabled.
-
-#### `refresh-sales-mining`
-
-Kick off a Sales Conversation Mining refresh and return the resulting ConversationMiningStatus (typically PROCESSING immediately after start). An imperative service trigger, not a pref/perm write. Gated by Conversation Mining Settings access. Should run after toggle-sales-conversation-mining-pref enables the feature. No public Connect/Tooling alternative — service-action without CRUD equivalent.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-mining-refresh`   — status: `proposed`
-
-**Depends on:** `toggle-sales-conversation-mining-pref`
-
-**Output:** ConversationMiningStatus object — the conversation-mining state immediately after the refresh kicks off. Typically PROCESSING when refresh just started; contains status enum + status details. Inspect getState.salesConversationMiningStatus or re-call refresh-sales-mining to poll for completion.
-
-### Verify operations
-
-#### `verify-toggle-sales-email-pref`
-
-Read getState; confirm isSalesEmailAssistantPrefEnabled equals the value passed to toggle-sales-email-pref. On enable, also confirm isOpenPromptEnabled=true (the dual-pref atomic batch flips OnlyUseBuilderPrompts in legacy-discovery-off orgs). Inspect the state UI-enum: ENABLED if Hawking is ready, IN_PROGRESS if PROVISIONING, HAWKING_TENANT_ERROR if PROVISION_FAILED (in which case getState resets the pref to false — re-toggle if needed).
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-sales-email-pref`
-
-#### `verify-toggle-open-prompt`
-
-Read getState; confirm isOpenPromptEnabled equals the value passed to toggle-open-prompt (already inverted server-side; getState returns !OnlyUseBuilderPrompts so true means open-prompt allowed).
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-open-prompt`
-
-#### `verify-toggle-sales-call-summarization-pref`
-
-Read getState; confirm isSalesCallSummarizationPrefEnabled equals the value passed to toggle-sales-call-summarization-pref.
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-sales-call-summarization-pref`
-
-#### `verify-toggle-sales-call-explorer-pref`
-
-Read getState; confirm isSalesCallExplorerPrefEnabled equals the value passed to toggle-sales-call-explorer-pref.
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-sales-call-explorer-pref`
-
-#### `verify-toggle-sales-conversation-mining-pref`
-
-Read getState; confirm isSalesConversationMiningPrefEnabled equals the value passed to toggle-sales-conversation-mining-pref. Optionally inspect salesConversationMiningProvisioningStatus and salesConversationMiningStatus (only populated when pref is on).
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-sales-conversation-mining-pref`
-
-#### `verify-toggle-signals2dc-pref`
-
-Read getState; confirm eciSignals2DCPref equals the value passed to toggle-signals2dc-pref. Inspect signalsDCStatus / signalsDCDetails for the underlying provisioning state when CDP/Genie is enabled.
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-signals2dc-pref`
-
-#### `verify-toggle-sales-conversation-mining-apd360-perm`
-
-Read getState; confirm isSalesConversationMiningAPD360PermEnabled equals the value passed to toggle-sales-conversation-mining-apd360-perm.
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-sales-conversation-mining-apd360-perm`
-
-#### `verify-toggle-sales-rep-feedback-pref`
-
-Read getState; confirm isSalesRepFeedbackPrefEnabled equals the value passed to toggle-sales-rep-feedback-pref.
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-sales-rep-feedback-pref`
-
-#### `verify-toggle-sales-call-generative-insights-pref`
-
-Read getState; confirm isSalesCallGenerativeInsightsPrefEnabled equals the value passed to toggle-sales-call-generative-insights-pref.
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `toggle-sales-call-generative-insights-pref`
-
-#### `verify-refresh-sales-mining`
-
-Read getState; inspect salesConversationMiningStatus (the ConversationMiningStatus object) for the post-refresh state. Refresh kicked from PROCESSING to a terminal status (success/failure) over time — re-poll if still PROCESSING. Also surfaces salesConversationMiningProvisioningStatus.
-
-**Call:** `GET /headless/invoke/platform/gptemail-generation`
-
-**Depends on:** `refresh-sales-mining`

package/skills/agentforce-wizard-ui-forecasting-analytics-components-configure/SKILL.md

@@ -1,64 +0,0 @@
----
-name: agentforce-wizard-ui-forecasting-analytics-components-configure
-description: "Use this skill when users want to einstein Forecasting Prediction Tuner setup (ForecastingPredictive AI application type). Trigger when users mention wizard, ui, forecasting, analytics, components."
-metadata:
-  version: "1.0"
----
-
-# Managing Wizard Ui Forecasting Analytics Components
-
-## When to Use This Skill
-
-Einstein Forecasting Prediction Tuner setup (ForecastingPredictive AI application type). Three Aura ops — get-tuner-setup-state reads whether the predictor's AI application is provisioned; load-tuner-metadata returns the Opportunity field catalog plus the saved prediction configuration; save-tuner-metadata upserts the prediction configuration and returns the AI application id. All gate on Predictive Forecasting + Customize Application + Modify All Data. No public Connect/Tooling/Metadata alternative — the AI application record is tooling-internal.
-
-## Critical Constraints
-
-**Preconditions:**
-
-- Org has Predictive Forecasting (Einstein Forecasting Prediction) enabled. (check: `Predictive Forecasting enabled`)
-- Running user has the Customize Application user permission. (check: `USER_PERMISSION_CUSTOMIZE_APPLICATION`)
-- Running user has the Modify All Data user permission. (check: `USER_PERMISSION_MODIFY_ALL_DATA`)
-
-## Operations Reference
-
-Operations grouped by purpose. Use these as the building blocks for the workflows above.
-
-### Summary
-
-| Operation | Purpose | Status | Call | Depends on |
-|-----------|---------|--------|------|------------|
-| `forecasting-prediction-tuner-setup-flow-controller-get-tuner-setup-state` | read | implemented | `GET /headless/invoke/analytics/forecasting-analytics/get-tuner-setup-state` | — |
-| `forecasting-prediction-tuner-setup-flow-controller-load-tuner-metadata` | read | implemented | `GET /headless/invoke/analytics/forecasting-analytics/load-tuner-metadata` | `forecasting-prediction-tuner-setup-flow-controller-get-tuner-setup-state` |
-| `forecasting-prediction-tuner-setup-flow-controller-save-tuner-metadata` | write | implemented | `PATCH /headless/invoke/analytics/forecasting-analytics/save-tuner-metadata` | `forecasting-prediction-tuner-setup-flow-controller-load-tuner-metadata` |
-
-### Read operations
-
-#### `forecasting-prediction-tuner-setup-flow-controller-get-tuner-setup-state`
-
-Read whether the ForecastingPredictive AI application is provisioned. Returns hasAIApplication=true when the AI application exists with a valid id; false blocks downstream tuner steps until upstream Einstein/AI application setup runs.
-
-**Call:** `GET /headless/invoke/analytics/forecasting-analytics/get-tuner-setup-state`   — status: `implemented`
-
-**Output:** A single boolean field hasAIApplication. True when a ForecastingPredictive AI application exists in the org with a valid id; false otherwise.
-
-#### `forecasting-prediction-tuner-setup-flow-controller-load-tuner-metadata`
-
-Load Opportunity custom fields, picklist fields paired with their values (CurrencyIsoCode excluded), the RecordTypeId field with RecordTypeInfo entries when custom record types exist, and the org's saved prediction configuration (null on a fresh org).
-
-**Call:** `GET /headless/invoke/analytics/forecasting-analytics/load-tuner-metadata`   — status: `implemented`
-
-**Depends on:** `forecasting-prediction-tuner-setup-flow-controller-get-tuner-setup-state`
-
-**Output:** Carries availableOppFields (Opportunity custom field list), oppPicklistFieldsAndValues (picklist fields + values plus RecordTypeId+RecordTypeInfo when custom record types exist), and predictionConfig (current saved prediction configuration or null on a fresh org).
-
-### Write operations
-
-#### `forecasting-prediction-tuner-setup-flow-controller-save-tuner-metadata`
-
-Upsert the org's prediction configuration. Accepts a Map<String,Object> under key `predictionConfig`, but the controller first re-serializes it through a string-valued map type — every value is string-coerced — before deserializing into the prediction-config object, so send string-valued fields (e.g. `excludedFields` as a JSON-encoded string, not a native array). Updates when the config carries both AIApplicationId and PredictionDefinitionId, else creates the ForecastingPredictive AI application. Returns the AI application id. Round-trip predictionConfig from the load-tuner-metadata read on partial mutations to preserve unset fields.
-
-**Call:** `PATCH /headless/invoke/analytics/forecasting-analytics/save-tuner-metadata`   — status: `implemented`
-
-**Depends on:** `forecasting-prediction-tuner-setup-flow-controller-load-tuner-metadata`
-
-**Output:** String — the AI application id (aiAppId) of the upserted ForecastingPredictive AI application record. Use as evidence the predictor is now provisioned (a subsequent get-tuner-setup-state read should return hasAIApplication=true).

package/skills/agentforce-wizard-ui-sales-einstein-components-configure/SKILL.md

@@ -1,46 +0,0 @@
----
-name: agentforce-wizard-ui-sales-einstein-components-configure
-description: "Use this skill when users want to wizard subset of the Sales Email Assistant setup and filter-row picklist operations. Trigger when users mention wizard, ui, sales, einstein, components."
-metadata:
-  version: "1.0"
----
-
-# Managing Wizard Ui Sales Einstein Components
-
-## When to Use This Skill
-
-Wizard subset of the Sales Email Assistant setup and filter-row picklist operations. Two boolean org-pref toggles (EinsteinGPTSalesEmailsPref and ORG_PREFERENCE_CALL_SUMMARIZATION) plus a filter-row picklist read for the filter-row UI. The sales-email toggle, when Discovery Framework is off and enabled=true, performs an atomic bulk pref write flipping OnlyUseBuilderPrompts to false alongside the pref write; both toggles echo the saved Boolean. The picklist read returns {label, value} pairs; fieldApiName='RecordTypeId' branches to return the object's record types instead (label = record-type label, value = record-type id). Sibling SOR GPTEmailGeneration covers the remaining 7 toggles + composite getState read on this setup page.
-
-## Operations Reference
-
-Operations grouped by purpose. Use these as the building blocks for the workflows above.
-
-### Summary
-
-| Operation | Purpose | Status | Call | Depends on |
-|-----------|---------|--------|------|------------|
-| `filter-row-picklist-controller-get-picklist-values` | read | implemented | `GET /headless/invoke/einstein/sales-einstein/filter-row-picklist/get-picklist-values` | — |
-| `sales-email-assistant-setup-controller-handle-sales-email-pref-toggle` | write | implemented | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-email-pref-toggle` | — |
-| `sales-email-assistant-setup-controller-handle-sales-call-summarization-pref-toggle` | write | implemented | `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-call-summarization-pref-toggle` | — |
-
-### Read operations
-
-#### `filter-row-picklist-controller-get-picklist-values`
-
-Returns the available picklist values as {label, value} pairs for a field on an object, used to populate filter-row options. When the field is 'RecordTypeId', returns the object's record types instead (label = record-type label, value = record-type id). Returns an empty list when the object or field is not supplied. Requires View Setup access.
-
-**Call:** `GET /headless/invoke/einstein/sales-einstein/filter-row-picklist/get-picklist-values`   — status: `implemented`
-
-### Write operations
-
-#### `sales-email-assistant-setup-controller-handle-sales-email-pref-toggle`
-
-Sets EinsteinGPTSalesEmailsPref to `enabled`. When Discovery Framework is off and enabled=true, an atomic bulk pref write also flips OnlyUseBuilderPrompts to false (open-prompt defaults on); otherwise the write routes through the Discovery Framework path for the Sales Email feature. Returns Boolean. AURA-IS-CANONICAL: pref absent from Metadata Settings types and from Tooling Organization columns (source-verified).
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-email-pref-toggle`   — status: `implemented`
-
-#### `sales-email-assistant-setup-controller-handle-sales-call-summarization-pref-toggle`
-
-Enables or disables the Sales Call Summarization org preference. Writing the preference requires Setup administrator access, and the saved boolean value is returned.
-
-**Call:** `PATCH /headless/invoke/platform/gptemail-generation/handle-sales-call-summarization-pref-toggle`   — status: `implemented`

package/skills/automation-company-profile-info-query/SKILL.md

@@ -1,51 +0,0 @@
----
-name: automation-company-profile-info-query
-description: "Use this skill when users want to read the org's company profile — name, address, primary contact, default locale, language, time zone, fiscal year start, and org type — by querying the Organization singleton sObject (read_company_profile step). Trigger when users mention company, profile, info, company profile info."
-metadata:
-  version: "1.0"
----
-
-# Querying Company Profile Info
-
-## When to Use This Skill
-
-Read the org's company profile — name, address, primary contact, default locale, language, time zone, fiscal year start, and org type — by querying the Organization singleton sObject (read_company_profile step). An agent can report these settings without the admin opening the Setup page, provided the user has the "View Setup and Configuration" (ViewSetup) permission. To CHANGE any company-profile value, navigate to the Setup page via view_url and edit in the UI; write automation is intentionally out of scope for this skill.
-
-## Critical Constraints
-
-**Preconditions:**
-
-- Reading the company profile requires the "View Setup and Configuration" (ViewSetup) user permission. Without it the running user cannot access Setup and the company-profile context is not meaningfully retrievable.
- (check: `USER_HAS_VIEW_SETUP`)
-
-## Operations Reference
-
-Operations grouped by purpose. Use these as the building blocks for the workflows above.
-
-### Summary
-
-| Operation | Purpose | Status | Call | Depends on |
-|-----------|---------|--------|------|------------|
-| `view_CompanyProfileInfo_1` | read | — | `CompanyProfileInfo.view` | — |
-| `read_company_profile` | read | — | `GET /services/data/v66.0/query` | — |
-
-### Read operations
-
-#### `view_CompanyProfileInfo_1`
-
-Navigate to the CompanyProfileInfo Setup page (no programmatic API). The agent should open view_url for the user to configure manually.
-
-**Call:** `CompanyProfileInfo.view`
-
-#### `read_company_profile`
-
-Read the org's company profile — name, address, primary contact, default locale, language, time zone, fiscal year start, and org type — by querying the `Organization` singleton sObject via SOQL. The org has exactly one Organization record, so the query returns a single row. This lets an agent report company-profile settings WITHOUT the admin opening the Setup page. The `FROM Organization` clause is fixed by this step — only the SELECT field list is variable — so the read is always scoped to the Organization entity. Read-only: to CHANGE any of these values, navigate to the Setup page (view_CompanyProfileInfo_1) and edit in the UI — write automation for the company profile is intentionally out of scope for this skill.
-
-
-**Call:** `GET /services/data/v66.0/query`
-
-**Inputs:**
-
-- `fields` *(`String`)* — Comma-separated SELECT field list for the Organization query. The `FROM Organization` clause is fixed by the step and is NOT part of this input — you choose the fields, never the object. Omit to use the default full company-profile field set below. Add or drop fields as the admin's question requires; note single-currency orgs do not expose DefaultCurrencyIsoCode (querying it errors on such orgs).
-
-- `q` *(`string`)*