full diff

pub.chive.graph.browseFaceted

From
bafyreid2xmpuwhsndmx4plxk26smguo7uaelzwbtiww6s5k72w3c25rioa indexed 2026-06-18 13:14 UTC View this version
To
bafyreid2xmpuwhsndmx4plxk26smguo7uaelzwbtiww6s5k72w3c25rioa 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 "authorRef": {
55 "description": "Author reference with contributions",
66 "properties": {
77 "affiliations": {
88 "description": "Author affiliations",
99 "items": {
1010 "ref": "pub.chive.defs#affiliation",
1111 "type": "ref"
1212 },
1313 "type": "array"
1414 },
1515 "avatarUrl": {
1616 "description": "Avatar image URL",
1717 "type": "string"
1818 },
1919 "contributions": {
2020 "description": "CRediT contributions",
2121 "items": {
2222 "ref": "#contributionRef",
2323 "type": "ref"
2424 },
2525 "type": "array"
2626 },
2727 "did": {
2828 "description": "Author DID",
2929 "format": "did",
3030 "type": "string"
3131 },
3232 "email": {
3333 "description": "Contact email",
3434 "type": "string"
3535 },
3636 "handle": {
3737 "description": "ATProto handle",
3838 "type": "string"
3939 },
4040 "isCorrespondingAuthor": {
4141 "description": "Whether this is the corresponding author",
4242 "type": "boolean"
4343 },
4444 "isHighlighted": {
4545 "description": "Whether this author should be highlighted",
4646 "type": "boolean"
4747 },
4848 "name": {
4949 "description": "Display name",
5050 "type": "string"
5151 },
5252 "orcid": {
5353 "description": "ORCID identifier",
5454 "type": "string"
5555 },
5656 "order": {
5757 "description": "Author order (1-based)",
5858 "type": "integer"
5959 }
6060 },
6161 "required": [
6262 "name",
6363 "order",
6464 "affiliations",
6565 "contributions"
6666 ],
6767 "type": "object"
6868 },
6969 "contributionRef": {
7070 "description": "CRediT contribution",
7171 "properties": {
7272 "degree": {
7373 "description": "Degree of contribution",
7474 "knownValues": [
7575 "lead",
7676 "equal",
7777 "supporting"
7878 ],
7979 "type": "string"
8080 },
8181 "typeId": {
8282 "description": "Contribution type identifier",
8383 "type": "string"
8484 },
8585 "typeLabel": {
8686 "description": "Contribution type label",
8787 "type": "string"
8888 },
8989 "typeUri": {
9090 "description": "AT-URI of contribution type node",
9191 "format": "at-uri",
9292 "type": "string"
9393 }
9494 },
9595 "required": [
9696 "typeUri",
9797 "typeId",
9898 "typeLabel"
9999 ],
100100 "type": "object"
101101 },
102102 "eprintSummary": {
103103 "description": "Eprint summary for faceted browse results",
104104 "properties": {
105105 "abstract": {
106106 "description": "Rich abstract with text, formatting, and entity references",
107107 "items": {
108108 "refs": [
109109 "pub.chive.richtext.defs#textItem",
110110 "pub.chive.richtext.defs#nodeRefItem",
111111 "pub.chive.richtext.defs#wikidataRefItem",
112112 "pub.chive.richtext.defs#fieldRefItem",
113113 "pub.chive.richtext.defs#facetRefItem",
114114 "pub.chive.richtext.defs#eprintRefItem",
115115 "pub.chive.richtext.defs#annotationRefItem",
116116 "pub.chive.richtext.defs#authorRefItem",
117117 "pub.chive.richtext.defs#mentionItem",
118118 "pub.chive.richtext.defs#linkItem",
119119 "pub.chive.richtext.defs#tagItem",
120120 "pub.chive.richtext.defs#latexItem",
121121 "pub.chive.richtext.defs#codeBlockItem",
122122 "pub.chive.richtext.defs#headingItem",
123123 "pub.chive.richtext.defs#listItem",
124124 "pub.chive.richtext.defs#blockquoteItem"
125125 ],
126126 "type": "union"
127127 },
128128 "maxLength": 500,
129129 "type": "array"
130130 },
131131 "authors": {
132132 "description": "All authors with contributions",
133133 "items": {
134134 "ref": "#authorRef",
135135 "type": "ref"
136136 },
137137 "type": "array"
138138 },
139139 "cid": {
140140 "description": "CID of indexed version",
141141 "type": "string"
142142 },
143143 "createdAt": {
144144 "description": "Creation timestamp",
145145 "format": "datetime",
146146 "type": "string"
147147 },
148148 "fields": {
149149 "description": "Subject fields",
150150 "items": {
151151 "ref": "#fieldRef",
152152 "type": "ref"
153153 },
154154 "type": "array"
155155 },
156156 "highlights": {
157157 "description": "Search highlights keyed by field",
158158 "type": "unknown"
159159 },
160160 "indexedAt": {
161161 "description": "Index timestamp",
162162 "format": "datetime",
163163 "type": "string"
164164 },
165165 "keywords": {
166166 "description": "Keywords",
167167 "items": {
168168 "type": "string"
169169 },
170170 "type": "array"
171171 },
172172 "license": {
173173 "description": "License identifier",
174174 "type": "string"
175175 },
176176 "paperDid": {
177177 "description": "Paper DID if paper has its own PDS",
178178 "format": "did",
179179 "type": "string"
180180 },
181181 "score": {
182182 "description": "Relevance score (scaled by 1000 for 0.0-1.0 range)",
183183 "maximum": 1000,
184184 "minimum": 0,
185185 "type": "integer"
186186 },
187187 "source": {
188188 "description": "Source PDS information",
189189 "ref": "#sourceInfo",
190190 "type": "ref"
191191 },
192192 "submittedBy": {
193193 "description": "DID of human user who submitted",
194194 "format": "did",
195195 "type": "string"
196196 },
197197 "title": {
198198 "description": "Eprint title",
199199 "type": "string"
200200 },
201201 "uri": {
202202 "description": "Eprint AT-URI",
203203 "format": "at-uri",
204204 "type": "string"
205205 }
206206 },
207207 "required": [
208208 "uri",
209209 "cid",
210210 "title",
211211 "abstract",
212212 "authors",
213213 "submittedBy",
214214 "license",
215215 "createdAt",
216216 "indexedAt",
217217 "source"
218218 ],
219219 "type": "object"
220220 },
221221 "facetDefinition": {
222222 "description": "Facet definition from the knowledge graph",
223223 "properties": {
224224 "description": {
225225 "description": "Facet description",
226226 "type": "string"
227227 },
228228 "label": {
229229 "description": "Display label",
230230 "type": "string"
231231 },
232232 "slug": {
233233 "description": "Facet slug identifier",
234234 "type": "string"
235235 },
236236 "values": {
237237 "description": "Available values with counts",
238238 "items": {
239239 "ref": "#facetValue",
240240 "type": "ref"
241241 },
242242 "type": "array"
243243 }
244244 },
245245 "required": [
246246 "slug",
247247 "label",
248248 "values"
249249 ],
250250 "type": "object"
251251 },
252252 "facetValue": {
253253 "description": "Facet value with count",
254254 "properties": {
255255 "count": {
256256 "description": "Number of eprints with this value",
257257 "type": "integer"
258258 },
259259 "label": {
260260 "description": "Display label",
261261 "type": "string"
262262 },
263263 "value": {
264264 "description": "Facet value",
265265 "type": "string"
266266 }
267267 },
268268 "required": [
269269 "value",
270270 "count"
271271 ],
272272 "type": "object"
273273 },
274274 "fieldRef": {
275275 "description": "Subject field reference",
276276 "properties": {
277277 "id": {
278278 "description": "Field identifier",
279279 "type": "string"
280280 },
281281 "label": {
282282 "description": "Field label",
283283 "type": "string"
284284 },
285285 "parentUri": {
286286 "description": "Parent field AT-URI",
287287 "format": "at-uri",
288288 "type": "string"
289289 },
290290 "uri": {
291291 "description": "Field AT-URI",
292292 "format": "at-uri",
293293 "type": "string"
294294 }
295295 },
296296 "required": [
297297 "uri",
298298 "label"
299299 ],
300300 "type": "object"
301301 },
302302 "main": {
303303 "description": "Browse eprints using dynamic faceted classification from the knowledge graph",
304304 "output": {
305305 "encoding": "application/json",
306306 "schema": {
307307 "properties": {
308308 "cursor": {
309309 "description": "Pagination cursor for next page",
310310 "type": "string"
311311 },
312312 "facets": {
313313 "description": "Available facet refinements",
314314 "items": {
315315 "ref": "#facetDefinition",
316316 "type": "ref"
317317 },
318318 "type": "array"
319319 },
320320 "hasMore": {
321321 "description": "Whether more results exist",
322322 "type": "boolean"
323323 },
324324 "hits": {
325325 "description": "Matching eprints",
326326 "items": {
327327 "ref": "#eprintSummary",
328328 "type": "ref"
329329 },
330330 "type": "array"
331331 },
332332 "impressionId": {
333333 "description": "Impression ID for click tracking",
334334 "type": "string"
335335 },
336336 "total": {
337337 "description": "Total count of matching eprints",
338338 "type": "integer"
339339 }
340340 },
341341 "required": [
342342 "hits",
343343 "facets",
344344 "hasMore",
345345 "total"
346346 ],
347347 "type": "object"
348348 }
349349 },
350350 "parameters": {
351351 "properties": {
352352 "cursor": {
353353 "description": "Pagination cursor",
354354 "type": "string"
355355 },
356356 "facets": {
357357 "description": "JSON-encoded facet filters keyed by facet slug (e.g., {\"methodology\":[\"meta-analysis\"]})",
358358 "type": "string"
359359 },
360360 "limit": {
361361 "default": 20,
362362 "description": "Maximum results to return",
363363 "maximum": 100,
364364 "minimum": 1,
365365 "type": "integer"
366366 },
367367 "q": {
368368 "description": "Optional text query",
369369 "type": "string"
370370 }
371371 },
372372 "type": "params"
373373 },
374374 "type": "query"
375375 },
376376 "sourceInfo": {
377377 "description": "Source PDS information",
378378 "properties": {
379379 "blobUrl": {
380380 "description": "Blob URL",
381381 "type": "string"
382382 },
383383 "lastVerifiedAt": {
384384 "description": "Last verification timestamp",
385385 "format": "datetime",
386386 "type": "string"
387387 },
388388 "pdsEndpoint": {
389389 "description": "PDS endpoint URL",
390390 "type": "string"
391391 },
392392 "recordUrl": {
393393 "description": "Direct record URL",
394394 "type": "string"
395395 },
396396 "stale": {
397397 "description": "Whether data is potentially stale",
398398 "type": "boolean"
399399 }
400400 },
401401 "required": [
402402 "pdsEndpoint"
403403 ],
404404 "type": "object"
405405 }
406406 },
407407 "id": "pub.chive.graph.browseFaceted",
408408 "lexicon": 1,
409409 "revision": 2
410410}