full diff

pub.chive.actor.getDiscoverySettings

From
bafyreihtl63unxatpntdagcmdtyuwpkr65d3eniheieylcnvc3fhbzifoq indexed 2026-06-18 13:14 UTC View this version
To
bafyreihtl63unxatpntdagcmdtyuwpkr65d3eniheieylcnvc3fhbzifoq indexed 2026-06-18 13:14 UTC View this version

Compatibility

backward compatible No changes detected.

Changes

11{
22 "$type": "com.atproto.lexicon.schema",
33 "defs": {
44 "main": {
55 "description": "Get the authenticated user's discovery settings from their PDS",
66 "errors": [
77 {
88 "name": "AuthenticationRequired"
99 },
1010 {
1111 "name": "PDSNotFound"
1212 }
1313 ],
1414 "output": {
1515 "encoding": "application/json",
1616 "schema": {
1717 "properties": {
1818 "citationNetworkDisplay": {
1919 "description": "How to display citation network",
2020 "knownValues": [
2121 "hidden",
2222 "preview",
2323 "expanded"
2424 ],
2525 "type": "string"
2626 },
2727 "enablePersonalization": {
2828 "description": "Enable personalized recommendations based on profile",
2929 "type": "boolean"
3030 },
3131 "followedFieldUris": {
3232 "description": "Field URIs the user follows for discovery",
3333 "items": {
3434 "format": "at-uri",
3535 "type": "string"
3636 },
3737 "type": "array"
3838 },
3939 "followingTabIncludesWorkFields": {
4040 "description": "Whether the Following tab also includes the user's work fields",
4141 "type": "boolean"
4242 },
4343 "minimumEndorsementThreshold": {
4444 "description": "Minimum number of endorsements for a paper to appear in recommendations",
4545 "type": "integer"
4646 },
4747 "recommendationDiversity": {
4848 "description": "How diverse recommendations should be relative to user's fields",
4949 "knownValues": [
5050 "low",
5151 "medium",
5252 "high"
5353 ],
5454 "type": "string"
5555 },
5656 "relatedPapersSignals": {
5757 "description": "Signals to use for related papers",
5858 "ref": "#relatedPapersSignals",
5959 "type": "ref"
6060 },
6161 "relatedPapersThresholds": {
6262 "description": "Thresholds for related papers filtering",
6363 "ref": "#relatedPapersThresholds",
6464 "type": "ref"
6565 },
6666 "relatedPapersWeights": {
6767 "description": "Relative weights for related papers signals",
6868 "ref": "#relatedPapersWeights",
6969 "type": "ref"
7070 },
7171 "showRecommendationReasons": {
7272 "description": "Show explanations for why papers are recommended",
7373 "type": "boolean"
7474 },
7575 "trendingPreferences": {
7676 "description": "Preferences for the trending feed",
7777 "ref": "#trendingPreferences",
7878 "type": "ref"
7979 }
8080 },
8181 "required": [
8282 "enablePersonalization",
8383 "relatedPapersSignals",
8484 "citationNetworkDisplay",
8585 "showRecommendationReasons"
8686 ],
8787 "type": "object"
8888 }
8989 },
9090 "parameters": {
9191 "properties": {},
9292 "type": "params"
9393 },
9494 "type": "query"
9595 },
9696 "relatedPapersSignals": {
9797 "description": "Configuration for related papers panel signals",
9898 "properties": {
9999 "authors": {
100100 "description": "Show papers by overlapping authors",
101101 "type": "boolean"
102102 },
103103 "bibliographicCoupling": {
104104 "description": "Show papers that cite the same references",
105105 "type": "boolean"
106106 },
107107 "citations": {
108108 "description": "Show citation-based relationships",
109109 "type": "boolean"
110110 },
111111 "coCitation": {
112112 "description": "Show papers frequently cited together",
113113 "type": "boolean"
114114 },
115115 "collaborative": {
116116 "description": "Show collaborative filtering recommendations",
117117 "type": "boolean"
118118 },
119119 "semantic": {
120120 "description": "Show semantically similar papers (SPECTER2 / MLT)",
121121 "type": "boolean"
122122 },
123123 "topics": {
124124 "description": "Show topic/concept-based relationships",
125125 "type": "boolean"
126126 }
127127 },
128128 "type": "object"
129129 },
130130 "relatedPapersThresholds": {
131131 "description": "Thresholds for related papers filtering",
132132 "properties": {
133133 "maxResults": {
134134 "description": "Maximum number of related papers to show",
135135 "maximum": 50,
136136 "minimum": 1,
137137 "type": "integer"
138138 },
139139 "minScore": {
140140 "description": "Minimum combined score to include a paper (0-100, maps to 0.0-1.0)",
141141 "maximum": 100,
142142 "minimum": 0,
143143 "type": "integer"
144144 }
145145 },
146146 "type": "object"
147147 },
148148 "relatedPapersWeights": {
149149 "description": "Relative importance of each related papers signal (0-100, auto-normalized)",
150150 "properties": {
151151 "authorNetwork": {
152152 "description": "Weight for co-author network proximity",
153153 "maximum": 100,
154154 "minimum": 0,
155155 "type": "integer"
156156 },
157157 "coCitation": {
158158 "description": "Weight for co-citation and bibliographic coupling",
159159 "maximum": 100,
160160 "minimum": 0,
161161 "type": "integer"
162162 },
163163 "collaborative": {
164164 "description": "Weight for collaborative filtering signal",
165165 "maximum": 100,
166166 "minimum": 0,
167167 "type": "integer"
168168 },
169169 "conceptOverlap": {
170170 "description": "Weight for OpenAlex concept/topic overlap",
171171 "maximum": 100,
172172 "minimum": 0,
173173 "type": "integer"
174174 },
175175 "semantic": {
176176 "description": "Weight for SPECTER2 / MLT semantic similarity",
177177 "maximum": 100,
178178 "minimum": 0,
179179 "type": "integer"
180180 }
181181 },
182182 "type": "object"
183183 },
184184 "trendingPreferences": {
185185 "description": "Preferences for the trending feed",
186186 "properties": {
187187 "defaultLimit": {
188188 "description": "Default number of trending results to show",
189189 "maximum": 100,
190190 "minimum": 5,
191191 "type": "integer"
192192 },
193193 "defaultWindow": {
194194 "description": "Default time window for trending",
195195 "knownValues": [
196196 "24h",
197197 "7d",
198198 "30d"
199199 ],
200200 "type": "string"
201201 }
202202 },
203203 "type": "object"
204204 }
205205 },
206206 "id": "pub.chive.actor.getDiscoverySettings",
207207 "lexicon": 1,
208208 "revision": 1
209209}