Skip to content

forcedotcom/sf-skills / skills/sales-agentforce-pipeline-management-configure

sales-agentforce-pipeline-management-configure

Verified

Use to configure, set up, or repair the Sales Management agent and Agentforce Pipeline Management in a Salesforce org. Automates metadata creation for flows, prompt templates, permission sets, and data source configuration. TRIGGER when: user wants to enable Pipeline Management, configure Sales pipeline features, set up the Sales Management agent for opportunity field updates (including autonomous updates), connect enabled data sources like Einstein Conversation Insights or Einstein Activity Capture, customize opportunity stage descriptions, configure post-meeting suggestions, verify or audit configuration status, fix partially configured orgs, or troubleshoot Pipeline Management metadata issues. DO NOT TRIGGER when: user wants to build a custom agent (use agentforce-generate), configure general Agentforce tracing (use platform-tracing-agentforce-configure), work with non-Sales agents, or enable Einstein Conversation Insights or Einstein Activity Capture from scratch (provisioning is out of scope).

FileKindSize
SKILL.mdskill md29.0 KB
assets/field-completion-template.genAiPromptTemplate-meta.xmlconfig8.6 KB
assets/pipeline_management_flow.flow-meta.xmlconfig22.9 KB
assets/sales_management_agent.agentother211.7 KB
assets/sales_management_agent.bundle-meta.xmlconfig163 B
assets/sfdx-project.jsonconfig254 B
assets/stage-descriptions/bant.txtmarkdown2.7 KB
assets/stage-descriptions/meddic.txtmarkdown2.9 KB
assets/stage-descriptions/spiced.txtmarkdown2.9 KB
examples/custom-prompt-instructions.mdmarkdown10.0 KB
references/admin-communication.mdmarkdown14.6 KB
references/agent-creation.mdmarkdown22.5 KB
references/auth-and-cli.mdmarkdown6.7 KB
references/automation-matrix.mdmarkdown2.2 KB
references/autonomous-updates.mdmarkdown8.4 KB
references/canonical-agent-path.mdmarkdown6.9 KB
references/data-sources.mdmarkdown6.6 KB
references/field-completion-prompt-template.mdmarkdown6.4 KB
references/field-completion-prompts.mdmarkdown10.4 KB
references/flags.mdmarkdown3.2 KB
references/flow-clone-from-template.mdmarkdown19.5 KB
references/metadata-inventory.mdmarkdown17.1 KB
references/opportunity-stages.mdmarkdown11.9 KB
references/repair-diagnostics.mdmarkdown14.1 KB
references/setup-order.mdmarkdown12.6 KB
references/soap-api-enablement.mdmarkdown21.7 KB
scripts/CHANGES.mdmarkdown5.6 KB
scripts/README.mdmarkdown3.1 KB
scripts/add-field-suggestion.shexecutablescript35.5 KB
scripts/create-agent.shexecutablescript13.2 KB
scripts/create-flow.shexecutablescript8.5 KB
scripts/define-agent-access.shexecutablescript21.2 KB
scripts/deploy-settings.shexecutablescript1.9 KB
scripts/enable-deal-agent.shexecutablescript10.0 KB
scripts/enable-prerequisites.shexecutablescript22.9 KB
scripts/flow-debug-and-verify.shexecutablescript18.4 KB
scripts/retrieve-settings.shexecutablescript5.7 KB
scripts/setup-all.shscript146.6 KB
scripts/shared/agent-bundle-publish.shscript6.7 KB
scripts/shared/agent-detection.shscript9.7 KB
scripts/shared/flow-builder.shscript9.5 KB
scripts/shared/psg.shscript1.9 KB
scripts/shared/soap.shscript5.6 KB
scripts/shared/stage-descriptions.shscript23.3 KB
scripts/shared/test-opp.shscript9.6 KB
scripts/verify-all.shexecutablescript26.0 KB
scripts/verify-prompt-generation.shexecutablescript13.8 KB

scripts/enable-prerequisites.sh

View on GitHub
#!/bin/bash

# Enable all prerequisite settings for Pipeline Management
# Usage: ./enable-prerequisites.sh <org-alias>

set -euo pipefail

# sf CLI can emit ANSI color codes inside --json stdout, breaking jq parsing.
# 2>/dev/null only strips stderr; these env vars are the reliable fix (see PM notes).
export NO_COLOR=1
export FORCE_COLOR=0

# Source shared SOAP parsing library
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SCRIPT_DIR/shared/soap.sh"

ORG_ALIAS="${1:-}"

if [[ -z "$ORG_ALIAS" ]]; then
  echo "❌ Error: Missing org alias"
  echo "Usage: $0 <org-alias>"
  exit 1
fi

if [[ ! -f "sfdx-project.json" ]]; then
  echo "❌ Error: sfdx-project.json not found in current directory"
  echo "Copy from ../assets/sfdx-project.json first"
  exit 1
fi

echo "🚀 Enabling Pipeline Management prerequisites for org: $ORG_ALIAS"
echo ""

# Get org details
ORG_INFO=$(sf org display --target-org "$ORG_ALIAS" --json 2>/dev/null)
ORG_ID=$(echo "$ORG_INFO" | jq -r '.result.id')
INSTANCE_URL=$(echo "$ORG_INFO" | jq -r '.result.instanceUrl')
ACCESS_TOKEN=$(echo "$ORG_INFO" | jq -r '.result.accessToken')

# Newer CLI versions redact accessToken — use show-access-token fallback
if [[ -z "$ACCESS_TOKEN" || "$ACCESS_TOKEN" == "null" || "$ACCESS_TOKEN" == *"REDACTED"* ]]; then
  ACCESS_TOKEN=$(echo "y" | sf org auth show-access-token --target-org "$ORG_ALIAS" --no-prompt --json 2>/dev/null | jq -r '.result.accessToken // empty')
fi

if [[ -z "$ORG_ID" || -z "$INSTANCE_URL" || -z "$ACCESS_TOKEN" || "$ACCESS_TOKEN" == "null" ]]; then
  echo "Error: Could not retrieve org details. Is the org authenticated?"
  exit 1
fi

echo "Org ID: $ORG_ID"
echo "Instance URL: $INSTANCE_URL"
echo ""

# Function to enable setting via SOAP API
enable_via_soap() {
  local SETTING_NAME="$1"
  local DISPLAY_NAME="$2"
  local FIELD_NAME="$3"
  local API_VERSION="${4:-62.0}"

  echo -n "Enabling ${DISPLAY_NAME}... "

  # Check if already enabled
  local QUERY="SELECT ${FIELD_NAME} FROM ${SETTING_NAME}"
  local CURRENT_VALUE
  CURRENT_VALUE=$(sf data query --query "$QUERY" --target-org "$ORG_ALIAS" --json 2>/dev/null | jq -r ".result.records[0].${FIELD_NAME}")

  if [[ "$CURRENT_VALUE" == "true" ]]; then
    echo "✅ (already enabled)"
    return 0
  fi

  # Build SOAP request
  local SOAP_REQUEST
  SOAP_REQUEST=$(cat <<EOF
<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:met="http://soap.sforce.com/2006/04/metadata">
  <soapenv:Header>
    <met:SessionHeader>
      <met:sessionId>${ACCESS_TOKEN}</met:sessionId>
    </met:SessionHeader>
  </soapenv:Header>
  <soapenv:Body>
    <met:updateMetadata>
      <met:metadata xsi:type="met:${SETTING_NAME}" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <met:fullName>${SETTING_NAME}</met:fullName>
        <met:${FIELD_NAME}>true</met:${FIELD_NAME}>
      </met:metadata>
    </met:updateMetadata>
  </soapenv:Body>
</soapenv:Envelope>
EOF
)

  # Send SOAP request
  local RESPONSE
  RESPONSE=$(curl -s -X POST "${INSTANCE_URL}/services/Soap/m/${API_VERSION}" \
    -H "Content-Type: text/xml; charset=utf-8" \
    -H "SOAPAction: update" \
    -d "$SOAP_REQUEST")

  if echo "$RESPONSE" | grep -q "<success>true</success>"; then
    echo "✅"
    return 0
  else
    echo "❌"
    echo "SOAP Response: $RESPONSE"
    return 1
  fi
}

# Function to enable setting via CLI retrieve+modify+deploy
enable_via_cli() {
  local SETTING_NAME="$1"
  local DISPLAY_NAME="$2"
  local FIELD_NAME="$3"
  local FIELD_VALUE="${4:-true}"

  echo -n "Enabling ${DISPLAY_NAME}... "

  # Check if already enabled
  local QUERY="SELECT ${FIELD_NAME} FROM ${SETTING_NAME}"
  local CURRENT_VALUE
  CURRENT_VALUE=$(sf data query --query "$QUERY" --target-org "$ORG_ALIAS" --json 2>/dev/null | jq -r ".result.records[0].${FIELD_NAME}" 2>/dev/null || echo "null")

  if [[ "$CURRENT_VALUE" == "$FIELD_VALUE" || "$CURRENT_VALUE" == "true" ]]; then
    echo "✅ (already enabled)"
    return 0
  fi

  # Retrieve current settings
  local SETTINGS_DIR="force-app/main/default/settings"
  mkdir -p "$SETTINGS_DIR"

  if ! sf project retrieve start --metadata "Settings:${SETTING_NAME}" --target-org "$ORG_ALIAS" --json 2>/dev/null | jq -e '.status == 0' >/dev/null 2>&1; then
    echo "❌ (retrieve failed)"
    return 1
  fi

  local SETTINGS_FILE="${SETTINGS_DIR}/${SETTING_NAME}.settings-meta.xml"

  if [[ ! -f "$SETTINGS_FILE" ]]; then
    echo "❌ (file not found after retrieve)"
    return 1
  fi

  # Modify setting using sed (non-greedy)
  if grep -q "<${FIELD_NAME}>" "$SETTINGS_FILE"; then
    # Update existing field
    sed -i.bak "0,/<${FIELD_NAME}>[^<]*<\/${FIELD_NAME}>/s|<${FIELD_NAME}>[^<]*</${FIELD_NAME}>|<${FIELD_NAME}>${FIELD_VALUE}</${FIELD_NAME}>|" "$SETTINGS_FILE"
  else
    # Insert field before closing tag
    sed -i.bak "/<\/.*Settings>/i\\
    <${FIELD_NAME}>${FIELD_VALUE}</${FIELD_NAME}>" "$SETTINGS_FILE"
  fi

  # Deploy
  if sf project deploy start --source-dir "$SETTINGS_DIR" --target-org "$ORG_ALIAS" --json 2>/dev/null | jq -e '.status == 0' >/dev/null 2>&1; then
    echo "✅"
    rm -f "${SETTINGS_FILE}.bak"
    return 0
  else
    echo "❌ (deploy failed)"
    mv "${SETTINGS_FILE}.bak" "$SETTINGS_FILE" 2>/dev/null || true
    return 1
  fi
}

# Read a settings boolean via SOAP readMetadata and classify the response using
# the shared shared/soap.sh parser. Distinguishes a genuine "false" from an
# auth/SOAP fault or a network/service error instead of collapsing all three to
# empty (the W-23215519 bug). Captures the HTTP status so 5xx/HTML error pages
# are not mistaken for a disabled setting.
# Args: $1 = metadata type, $2 = fullName, $3 = field name
# Echoes: "true" | "false" | "AUTH_ERROR:..." | "TYPE_UNAVAILABLE:..." | "NETWORK_ERROR"
read_setting_status() {
  local type="$1"
  local full_name="$2"
  local field="$3"
  local response http_status xml
  response=$(curl -s -w "\n%{http_code}" "${INSTANCE_URL}/services/Soap/m/64.0" \
    -H "Content-Type: text/xml; charset=UTF-8" \
    -H "SOAPAction: readMetadata" \
    -d "<?xml version='1.0' encoding='utf-8'?>
<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:met='http://soap.sforce.com/2006/04/metadata'>
  <soapenv:Header><met:SessionHeader><met:sessionId>${ACCESS_TOKEN}</met:sessionId></met:SessionHeader></soapenv:Header>
  <soapenv:Body><met:readMetadata><met:type>${type}</met:type><met:fullNames>${full_name}</met:fullNames></met:readMetadata></soapenv:Body>
</soapenv:Envelope>" 2>/dev/null || echo "")
  http_status=$(echo "$response" | tail -1)
  xml=$(echo "$response" | sed '$d')
  parse_soap_response "$xml" "$field" "$http_status"
}

# Read OpportunitySettings.enableOpportunityTeam via SOAP readMetadata.
# OpportunitySettings is NOT queryable via SOQL, so SOAP is the only option
# (the fullName for OpportunitySettings is "Opportunity", not the type name).
# Echoes a classification string (see read_setting_status).
get_opp_team_status() {
  read_setting_status "OpportunitySettings" "Opportunity" "enableOpportunityTeam"
}

# Step 1: Enable EinsteinGptSettings (MUST succeed for Copilot)
# NOTE: The critical field for Pipeline Management is enableEinsteinGptPlatform.
# We enable it via SOAP with the correct fullName pattern (fullName = type name for settings).
echo "Step 1: Enabling Einstein Generative AI"
echo -n "  Checking EinsteinGptSettings... "

GENAI_CURRENT=$(read_setting_status "EinsteinGptSettings" "EinsteinGpt" "enableEinsteinGptPlatform")

if [[ "$GENAI_CURRENT" == "true" ]]; then
  echo "✅ (already enabled)"
else
  echo "enabling..."
  RESULT=$(curl -s -X POST "${INSTANCE_URL}/services/Soap/m/64.0" \
    -H "Content-Type: text/xml; charset=utf-8" \
    -H "SOAPAction: update" \
    -d "<?xml version='1.0' encoding='utf-8'?>
<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:met='http://soap.sforce.com/2006/04/metadata'>
  <soapenv:Header><met:SessionHeader><met:sessionId>${ACCESS_TOKEN}</met:sessionId></met:SessionHeader></soapenv:Header>
  <soapenv:Body><met:updateMetadata>
    <met:metadata xsi:type='met:EinsteinGptSettings' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
      <met:fullName>EinsteinGpt</met:fullName>
      <met:enableEinsteinGptPlatform>true</met:enableEinsteinGptPlatform>
    </met:metadata>
  </met:updateMetadata></soapenv:Body>
</soapenv:Envelope>")

  if echo "$RESULT" | grep -q "<success>true</success>"; then
    echo "  ✅ Einstein Generative AI enabled (SOAP)"
  else
    echo "  ⚠️  SOAP failed — trying CLI deploy fallback..."
    enable_via_cli "EinsteinGptSettings" "Einstein Generative AI (CLI)" "enableEinsteinGptPlatform"
    GENAI_VERIFY=$(read_setting_status "EinsteinGptSettings" "EinsteinGpt" "enableEinsteinGptPlatform")
    if [[ "$GENAI_VERIFY" != "true" ]]; then
      echo "  ❌ Critical failure: Cannot enable Einstein Generative AI (all approaches failed)"
      echo "$RESULT" | grep -o '<message>[^<]*</message>' | sed 's/<[^>]*>//g' | head -1 || true
      exit 1
    fi
    echo "  ✅ Einstein Generative AI enabled (CLI fallback)"
  fi
  sleep 3
fi
echo ""

# Step 2: Enable EinsteinCopilotSettings (depends on GPT)
echo "Step 2: Enabling Agentforce Agent (Einstein Copilot)"
echo -n "  Checking EinsteinCopilotSettings... "

COPILOT_CURRENT=$(read_setting_status "EinsteinCopilotSettings" "EinsteinCopilot" "enableEinsteinGptCopilot")

if [[ "$COPILOT_CURRENT" == "true" ]]; then
  echo "✅ (already enabled)"
else
  echo "enabling..."
  RESULT=$(curl -s -X POST "${INSTANCE_URL}/services/Soap/m/64.0" \
    -H "Content-Type: text/xml; charset=utf-8" \
    -H "SOAPAction: update" \
    -d "<?xml version='1.0' encoding='utf-8'?>
<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:met='http://soap.sforce.com/2006/04/metadata'>
  <soapenv:Header><met:SessionHeader><met:sessionId>${ACCESS_TOKEN}</met:sessionId></met:SessionHeader></soapenv:Header>
  <soapenv:Body><met:updateMetadata>
    <met:metadata xsi:type='met:EinsteinCopilotSettings' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
      <met:fullName>EinsteinCopilot</met:fullName>
      <met:enableEinsteinGptCopilot>true</met:enableEinsteinGptCopilot>
    </met:metadata>
  </met:updateMetadata></soapenv:Body>
</soapenv:Envelope>")

  if echo "$RESULT" | grep -q "<success>true</success>"; then
    echo "  ✅ Agentforce Agent enabled (SOAP)"
  else
    echo "  ⚠️  SOAP failed — trying CLI deploy fallback..."
    enable_via_cli "EinsteinCopilotSettings" "Agentforce Agent (CLI)" "enableEinsteinGptCopilot"
    COPILOT_VERIFY=$(read_setting_status "EinsteinCopilotSettings" "EinsteinCopilot" "enableEinsteinGptCopilot")
    if [[ "$COPILOT_VERIFY" != "true" ]]; then
      echo "  ⚠️  Warning: Agentforce Agent enable failed (all approaches — continuing)"
      echo "$RESULT" | grep -o '<message>[^<]*</message>' | sed 's/<[^>]*>//g' | head -1 || true
    else
      echo "  ✅ Agentforce Agent enabled (CLI fallback)"
    fi
  fi
  sleep 3
fi
echo ""

# Step 2b: Enable AgentPlatformSettings (Agentforce Studio — gates Deal Agent)
# AgentPlatformSettings.enableAgentPlatform (OrgPreference AgentPlatformEnabled)
# must be ON before SalesDealAgentSettings can be enabled; core rejects Deal Agent
# enablement otherwise. Depends on Einstein GPT + Copilot (Steps 1–2).
echo "Step 2b: Enabling Agentforce Studio (Agent Platform)"
echo -n "  Checking AgentPlatformSettings... "

AGENT_PLATFORM_CURRENT=$(read_setting_status "AgentPlatformSettings" "AgentPlatform" "enableAgentPlatform")

if [[ "$AGENT_PLATFORM_CURRENT" == "true" ]]; then
  echo "✅ (already enabled)"
else
  echo "enabling..."
  RESULT=$(curl -s -X POST "${INSTANCE_URL}/services/Soap/m/64.0" \
    -H "Content-Type: text/xml; charset=utf-8" \
    -H "SOAPAction: update" \
    -d "<?xml version='1.0' encoding='utf-8'?>
<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:met='http://soap.sforce.com/2006/04/metadata'>
  <soapenv:Header><met:SessionHeader><met:sessionId>${ACCESS_TOKEN}</met:sessionId></met:SessionHeader></soapenv:Header>
  <soapenv:Body><met:updateMetadata>
    <met:metadata xsi:type='met:AgentPlatformSettings' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
      <met:fullName>AgentPlatform</met:fullName>
      <met:enableAgentPlatform>true</met:enableAgentPlatform>
    </met:metadata>
  </met:updateMetadata></soapenv:Body>
</soapenv:Envelope>")

  if echo "$RESULT" | grep -q "<success>true</success>"; then
    echo "  ✅ Agentforce Studio (Agent Platform) enabled (SOAP)"
  else
    echo "  ⚠️  SOAP failed — trying CLI deploy fallback..."
    enable_via_cli "AgentPlatformSettings" "Agentforce Studio (CLI)" "enableAgentPlatform"
    AGENT_PLATFORM_VERIFY=$(read_setting_status "AgentPlatformSettings" "AgentPlatform" "enableAgentPlatform")
    if [[ "$AGENT_PLATFORM_VERIFY" != "true" ]]; then
      echo "  ⚠️  Warning: Agentforce Studio enable failed (all approaches — continuing)"
      echo "$RESULT" | grep -o '<message>[^<]*</message>' | sed 's/<[^>]*>//g' | head -1 || true
    else
      echo "  ✅ Agentforce Studio (Agent Platform) enabled (CLI fallback)"
    fi
  fi
  sleep 3
fi
echo ""

# Step 3: Enable Enhanced Notes (required for Pipeline Management data sources)
echo "Step 3: Enabling Enhanced Notes"
echo -n "  Checking EnhancedNotesSettings... "

NOTES_CURRENT=$(read_setting_status "EnhancedNotesSettings" "EnhancedNotes" "enableEnhancedNotes")

if [[ "$NOTES_CURRENT" == "true" ]]; then
  echo "✅ (already enabled)"
else
  echo "enabling..."
  RESULT=$(curl -s -X POST "${INSTANCE_URL}/services/Soap/m/64.0" \
    -H "Content-Type: text/xml; charset=utf-8" \
    -H "SOAPAction: update" \
    -d "<?xml version='1.0' encoding='utf-8'?>
<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:met='http://soap.sforce.com/2006/04/metadata'>
  <soapenv:Header><met:SessionHeader><met:sessionId>${ACCESS_TOKEN}</met:sessionId></met:SessionHeader></soapenv:Header>
  <soapenv:Body><met:updateMetadata>
    <met:metadata xsi:type='met:EnhancedNotesSettings' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
      <met:fullName>EnhancedNotes</met:fullName>
      <met:enableEnhancedNotes>true</met:enableEnhancedNotes>
    </met:metadata>
  </met:updateMetadata></soapenv:Body>
</soapenv:Envelope>")

  if echo "$RESULT" | grep -q "<success>true</success>"; then
    echo "  ✅ Enhanced Notes enabled"
  else
    echo "  ⚠️  SOAP failed — trying CLI deploy fallback..."
    enable_via_cli "EnhancedNotesSettings" "Enhanced Notes" "enableEnhancedNotes" || echo "  ❌ Enhanced Notes failed (Pipeline Management may not activate)"
  fi
  sleep 2
fi
echo ""

# Step 4: Enable Email Administration (CLI is OK, handle compliance field removal)
echo "Step 4: Enabling Email Administration"
if ! enable_via_cli "EmailAdministrationSettings" "Email Administration" "enableInternalNotesInEmailSnippet"; then
  echo "⚠️  Retrying without enableEmailSenderIdCompliance..."

  # Retrieve again
  sf project retrieve start --metadata "Settings:EmailAdministrationSettings" --target-org "$ORG_ALIAS" >/dev/null 2>&1 || true

  SETTINGS_FILE="force-app/main/default/settings/EmailAdministrationSettings.settings-meta.xml"

  if [[ -f "$SETTINGS_FILE" ]]; then
    # Remove problematic field if present
    sed -i.bak '/<enableEmailSenderIdCompliance>/d' "$SETTINGS_FILE"

    # Ensure enableInternalNotesInEmailSnippet is true
    if grep -q "<enableInternalNotesInEmailSnippet>" "$SETTINGS_FILE"; then
      sed -i.bak2 "0,/<enableInternalNotesInEmailSnippet>[^<]*<\/enableInternalNotesInEmailSnippet>/s|<enableInternalNotesInEmailSnippet>[^<]*</enableInternalNotesInEmailSnippet>|<enableInternalNotesInEmailSnippet>true</enableInternalNotesInEmailSnippet>|" "$SETTINGS_FILE"
    fi

    sf project deploy start --source-dir "force-app/main/default/settings" --target-org "$ORG_ALIAS" >/dev/null 2>&1 || true
    rm -f "${SETTINGS_FILE}.bak" "${SETTINGS_FILE}.bak2" 2>/dev/null || true
  fi
fi
echo ""

# Step 5: Enable Opportunity Team (CRITICAL — flow uses OpportunityTeamMember)
# Without this, the Pipeline Management flow deploy fails with an OppTeamMemRec error.
# OpportunitySettings is NOT queryable via SOQL, so we use SOAP readMetadata/update
# (matching Steps 1-3 and setup-all.sh). The fullName for OpportunitySettings is
# "Opportunity", not the type name.
echo "Step 5: Enabling Opportunity Team"
echo -n "  Checking OpportunitySettings.enableOpportunityTeam... "

OPP_TEAM_CURRENT=$(get_opp_team_status)

if [[ "$OPP_TEAM_CURRENT" == "true" ]]; then
  echo "✅ (already enabled)"
else
  echo "enabling..."
  RESULT=$(curl -s -X POST "${INSTANCE_URL}/services/Soap/m/64.0" \
    -H "Content-Type: text/xml; charset=utf-8" \
    -H "SOAPAction: update" \
    -d "<?xml version='1.0' encoding='utf-8'?>
<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:met='http://soap.sforce.com/2006/04/metadata'>
  <soapenv:Header><met:SessionHeader><met:sessionId>${ACCESS_TOKEN}</met:sessionId></met:SessionHeader></soapenv:Header>
  <soapenv:Body><met:updateMetadata>
    <met:metadata xsi:type='met:OpportunitySettings' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
      <met:fullName>Opportunity</met:fullName>
      <met:enableOpportunityTeam>true</met:enableOpportunityTeam>
    </met:metadata>
  </met:updateMetadata></soapenv:Body>
</soapenv:Envelope>" 2>/dev/null)

  if echo "$RESULT" | grep -q "<success>true</success>"; then
    echo "  ✅ Opportunity Team enabled"
  else
    echo "  ❌ Opportunity Team enable failed — verifying below..."
    echo "$RESULT" | grep -o '<message>[^<]*</message>' | sed 's/<[^>]*>//g' | head -1 || true
    echo "     Note: cannot coexist with Opportunity Splits — disable Splits first if enabled."
  fi
  sleep 2
fi
echo ""

# Step 6: Enable Opportunity settings (Find Similar Opportunities — optional)
echo "Step 6: Enabling Opportunity Settings"
enable_via_cli "OpportunitySettings" "Opportunity Settings" "enableFindSimilarOpportunities" || echo "⚠️  Warning: Opportunity Settings failed but continuing..."
echo ""

# Verification — use SOAP readMetadata (matches enable-deal-agent.sh pre-flight checks)
echo "🔍 Verifying prerequisites via SOAP readMetadata..."
echo ""

VERIFICATION_FAILED=false

# Report a verification status classified by shared/soap.sh. Distinguishes a
# genuine disabled setting from an auth fault or a network/service error so the
# operator knows whether to re-auth, check connectivity, or actually enable the
# setting (the W-23215519 fix). Args: $1=label, $2=status string, $3=severity
#   severity "critical" → sets VERIFICATION_FAILED on a real "false"
#   severity "warn"     → reports but never blocks
report_status() {
  local label="$1"
  local status="$2"
  local severity="$3"
  case "$status" in
    true)
      echo "  ✅ ${label}: enabled"
      ;;
    false)
      if [[ "$severity" == "critical" ]]; then
        echo "  ❌ ${label}: NOT enabled (CRITICAL)"
        VERIFICATION_FAILED=true
      else
        echo "  ⚠️  ${label}: NOT enabled"
      fi
      ;;
    AUTH_ERROR:*)
      echo "  ❌ ${label}: cannot verify — authentication/SOAP fault (${status#AUTH_ERROR:})"
      echo "     Re-authenticate: sf org login web --instance-url $INSTANCE_URL --alias $ORG_ALIAS"
      # if/then/fi (not `[[ ]] && ...`): a bare `&&` would return 1 when severity
      # is "warn", and as the case arm's last statement that makes report_status
      # return 1 — aborting the script at the bare warn call sites under set -e.
      if [[ "$severity" == "critical" ]]; then VERIFICATION_FAILED=true; fi
      ;;
    TYPE_UNAVAILABLE:*)
      echo "  ❌ ${label}: not available in this org edition (${status#TYPE_UNAVAILABLE:})"
      if [[ "$severity" == "critical" ]]; then VERIFICATION_FAILED=true; fi
      ;;
    NETWORK_ERROR)
      echo "  ❌ ${label}: cannot verify — network/service error (check instance URL and connectivity)"
      if [[ "$severity" == "critical" ]]; then VERIFICATION_FAILED=true; fi
      ;;
    *)
      echo "  ⚠️  ${label}: unknown status ($status)"
      ;;
  esac
}

# Verify Einstein GPT (critical — checked by enable-deal-agent.sh pre-flight)
VERIFY_GENAI=$(read_setting_status "EinsteinGptSettings" "EinsteinGpt" "enableEinsteinGptPlatform")
report_status "Einstein Generative AI (enableEinsteinGptPlatform)" "$VERIFY_GENAI" "critical"

# Verify Einstein Copilot (checked by enable-deal-agent.sh pre-flight)
VERIFY_COPILOT=$(read_setting_status "EinsteinCopilotSettings" "EinsteinCopilot" "enableEinsteinGptCopilot")
report_status "Agentforce Agent (enableEinsteinGptCopilot)" "$VERIFY_COPILOT" "warn"

# Verify Agentforce Studio / Agent Platform (gates Deal Agent; enable-deal-agent.sh
# pre-flight hard-blocks on this — a disabled state here explains a downstream
# Deal Agent activation failure).
VERIFY_AGENT_PLATFORM=$(read_setting_status "AgentPlatformSettings" "AgentPlatform" "enableAgentPlatform")
report_status "Agentforce Studio / Agent Platform (enableAgentPlatform)" "$VERIFY_AGENT_PLATFORM" "warn"

# Verify Enhanced Notes (checked by enable-deal-agent.sh pre-flight)
VERIFY_NOTES=$(read_setting_status "EnhancedNotesSettings" "EnhancedNotes" "enableEnhancedNotes")
report_status "Enhanced Notes (enableEnhancedNotes)" "$VERIFY_NOTES" "warn"

# Verify Opportunity Team (CRITICAL — PM flow deploy fails with OppTeamMemRec error
# without it). OpportunitySettings is not queryable via SOQL — use SOAP readMetadata.
VERIFY_OPP_TEAM=$(get_opp_team_status)
if [[ "$VERIFY_OPP_TEAM" != "true" ]]; then
  report_status "Opportunity Team (enableOpportunityTeam)" "$VERIFY_OPP_TEAM" "critical"
  echo "     The Pipeline Management flow requires OpportunityTeamMember access;"
  echo "     without it, flow deployment fails with an OppTeamMemRec error."
  echo "     Note: cannot coexist with Opportunity Splits — disable Splits first if enabled."
else
  report_status "Opportunity Team (enableOpportunityTeam)" "$VERIFY_OPP_TEAM" "critical"
fi

# Verify Email Administration (best-effort, not blocking)
VERIFY_EMAIL=$(sf data query --query "SELECT enableEnhancedEmailEnabled FROM EmailAdministrationSettings" --target-org "$ORG_ALIAS" --json 2>/dev/null | jq -r '.result.records[0].enableEnhancedEmailEnabled // "unknown"' 2>/dev/null || echo "unknown")
if [[ "$VERIFY_EMAIL" == "true" ]]; then
  echo "  ✅ Enhanced Email: enabled"
else
  echo "  ⚠️  Enhanced Email: not enabled (optional — email body indexing)"
fi

# Verify Opportunity Settings (best-effort, not blocking)
VERIFY_OPP=$(sf data query --query "SELECT enableFindSimilarOpportunities FROM OpportunitySettings" --target-org "$ORG_ALIAS" --json 2>/dev/null | jq -r '.result.records[0].enableFindSimilarOpportunities // "unknown"' 2>/dev/null || echo "unknown")
if [[ "$VERIFY_OPP" == "true" ]]; then
  echo "  ✅ Opportunity Settings: enabled"
else
  echo "  ⚠️  Opportunity Settings: not enabled (optional)"
fi

echo ""

if [[ "$VERIFICATION_FAILED" == "true" ]]; then
  echo "❌ Critical prerequisites failed. Cannot proceed to Deal Agent setup."
  exit 1
fi

echo "✅ All prerequisites enabled successfully"
echo ""
echo "Next step: Run ./enable-deal-agent.sh $ORG_ALIAS"
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall