pub.chive.actor.getDiscoverySettings

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Get the authenticated user's discovery settings from their PDS",
      "errors": [
        {
          "name": "AuthenticationRequired"
        },
        {
          "name": "PDSNotFound"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "citationNetworkDisplay": {
              "description": "How to display citation network",
              "knownValues": [
                "hidden",
                "preview",
                "expanded"
              ],
              "type": "string"
            },
            "enablePersonalization": {
              "description": "Enable personalized recommendations based on profile",
              "type": "boolean"
            },
            "followedFieldUris": {
              "description": "Field URIs the user follows for discovery",
              "items": {
                "format": "at-uri",
                "type": "string"
              },
              "type": "array"
            },
            "followingTabIncludesWorkFields": {
              "description": "Whether the Following tab also includes the user's work fields",
              "type": "boolean"
            },
            "minimumEndorsementThreshold": {
              "description": "Minimum number of endorsements for a paper to appear in recommendations",
              "type": "integer"
            },
            "recommendationDiversity": {
              "description": "How diverse recommendations should be relative to user's fields",
              "knownValues": [
                "low",
                "medium",
                "high"
              ],
              "type": "string"
            },
            "relatedPapersSignals": {
              "description": "Signals to use for related papers",
              "ref": "#relatedPapersSignals",
              "type": "ref"
            },
            "relatedPapersThresholds": {
              "description": "Thresholds for related papers filtering",
              "ref": "#relatedPapersThresholds",
              "type": "ref"
            },
            "relatedPapersWeights": {
              "description": "Relative weights for related papers signals",
              "ref": "#relatedPapersWeights",
              "type": "ref"
            },
            "showRecommendationReasons": {
              "description": "Show explanations for why papers are recommended",
              "type": "boolean"
            },
            "trendingPreferences": {
              "description": "Preferences for the trending feed",
              "ref": "#trendingPreferences",
              "type": "ref"
            }
          },
          "required": [
            "enablePersonalization",
            "relatedPapersSignals",
            "citationNetworkDisplay",
            "showRecommendationReasons"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {},
        "type": "params"
      },
      "type": "query"
    },
    "relatedPapersSignals": {
      "description": "Configuration for related papers panel signals",
      "properties": {
        "authors": {
          "description": "Show papers by overlapping authors",
          "type": "boolean"
        },
        "bibliographicCoupling": {
          "description": "Show papers that cite the same references",
          "type": "boolean"
        },
        "citations": {
          "description": "Show citation-based relationships",
          "type": "boolean"
        },
        "coCitation": {
          "description": "Show papers frequently cited together",
          "type": "boolean"
        },
        "collaborative": {
          "description": "Show collaborative filtering recommendations",
          "type": "boolean"
        },
        "semantic": {
          "description": "Show semantically similar papers (SPECTER2 / MLT)",
          "type": "boolean"
        },
        "topics": {
          "description": "Show topic/concept-based relationships",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "relatedPapersThresholds": {
      "description": "Thresholds for related papers filtering",
      "properties": {
        "maxResults": {
          "description": "Maximum number of related papers to show",
          "maximum": 50,
          "minimum": 1,
          "type": "integer"
        },
        "minScore": {
          "description": "Minimum combined score to include a paper (0-100, maps to 0.0-1.0)",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "relatedPapersWeights": {
      "description": "Relative importance of each related papers signal (0-100, auto-normalized)",
      "properties": {
        "authorNetwork": {
          "description": "Weight for co-author network proximity",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "coCitation": {
          "description": "Weight for co-citation and bibliographic coupling",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "collaborative": {
          "description": "Weight for collaborative filtering signal",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "conceptOverlap": {
          "description": "Weight for OpenAlex concept/topic overlap",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "semantic": {
          "description": "Weight for SPECTER2 / MLT semantic similarity",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "trendingPreferences": {
      "description": "Preferences for the trending feed",
      "properties": {
        "defaultLimit": {
          "description": "Default number of trending results to show",
          "maximum": 100,
          "minimum": 5,
          "type": "integer"
        },
        "defaultWindow": {
          "description": "Default time window for trending",
          "knownValues": [
            "24h",
            "7d",
            "30d"
          ],
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "id": "pub.chive.actor.getDiscoverySettings",
  "lexicon": 1,
  "revision": 1
}