{
"id": "pub.chive.eprint.searchSubmissions",
"defs": {
"main": {
"type": "query",
"output": {
"schema": {
"type": "object",
"required": [
"hits"
],
"properties": {
"hits": {
"type": "array",
"items": {
"ref": "#searchHit",
"type": "ref"
}
},
"total": {
"type": "integer",
"description": "Total number of matching documents"
},
"cursor": {
"type": "string"
},
"facetAggregations": {
"type": "array",
"items": {
"ref": "#facetAggregation",
"type": "ref"
}
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"properties": {
"q": {
"type": "string",
"description": "Search query. If omitted, returns recent eprints (browsing mode)"
},
"sort": {
"type": "string",
"description": "Sort order for results. 'relevance' (default) or 'recent' (newest first)",
"knownValues": [
"relevance",
"recent"
]
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1
},
"author": {
"type": "string",
"format": "did",
"description": "Filter by author DID"
},
"cursor": {
"type": "string"
},
"dateTo": {
"type": "string",
"format": "datetime",
"description": "Filter by submission date (to)"
},
"dateFrom": {
"type": "string",
"format": "datetime",
"description": "Filter by submission date (from)"
},
"facetUris": {
"type": "array",
"items": {
"type": "string",
"format": "at-uri"
},
"description": "Filter by facet node URIs (subkind=facet)"
},
"fieldUris": {
"type": "array",
"items": {
"type": "string",
"format": "at-uri"
},
"description": "Filter by field node URIs (subkind=field)"
},
"topicUris": {
"type": "array",
"items": {
"type": "string",
"format": "at-uri"
},
"description": "Filter by topic node URIs (subkind=topic)"
},
"paperTypeUri": {
"type": "string",
"format": "at-uri",
"description": "Filter by paper type node URI (subkind=paper-type)"
},
"publicationStatusUri": {
"type": "string",
"format": "at-uri",
"description": "Filter by publication status node URI (subkind=publication-status)"
}
}
},
"description": "Search preprints with faceted filters using knowledge graph dimensions"
},
"fieldRef": {
"type": "object",
"required": [
"uri",
"label"
],
"properties": {
"id": {
"type": "string",
"description": "UUID of the field node"
},
"uri": {
"type": "string",
"format": "at-uri",
"description": "AT-URI of the field node"
},
"label": {
"type": "string",
"description": "Human-readable field name"
}
},
"description": "Reference to a knowledge graph field node"
},
"searchHit": {
"type": "object",
"required": [
"uri",
"score"
],
"properties": {
"uri": {
"type": "string",
"format": "at-uri",
"description": "AT-URI of the matched eprint"
},
"score": {
"type": "integer",
"minimum": 0,
"description": "Relevance score (scaled by 1000 for precision)"
},
"title": {
"type": "string",
"description": "Eprint title for display"
},
"fields": {
"type": "array",
"items": {
"ref": "#fieldRef",
"type": "ref"
},
"description": "Knowledge graph field references"
},
"authors": {
"type": "array",
"items": {
"ref": "#authorSummary",
"type": "ref"
},
"description": "Author summaries for display"
},
"abstract": {
"type": "string",
"description": "Eprint abstract plain text for display"
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "When the eprint was created"
},
"highlight": {
"ref": "#highlightResult",
"type": "ref"
},
"indexedAt": {
"type": "string",
"format": "datetime",
"description": "When the eprint was indexed"
}
},
"description": "A search result hit"
},
"facetValue": {
"type": "object",
"required": [
"uri",
"label",
"count"
],
"properties": {
"uri": {
"type": "string",
"format": "at-uri",
"description": "AT-URI of the knowledge graph node"
},
"slug": {
"type": "string",
"description": "Node slug for URL generation"
},
"count": {
"type": "integer",
"description": "Number of documents with this facet value"
},
"label": {
"type": "string",
"description": "Display label"
}
},
"description": "A facet value with node reference"
},
"authorSummary": {
"type": "object",
"required": [
"name"
],
"properties": {
"did": {
"type": "string",
"format": "did",
"description": "Author DID if known"
},
"name": {
"type": "string",
"description": "Display name"
},
"handle": {
"type": "string",
"description": "Author handle (e.g., alice.bsky.social)"
},
"avatarUrl": {
"type": "string",
"format": "uri",
"description": "Author avatar URL"
}
},
"description": "Minimal author info for search results"
},
"highlightResult": {
"type": "object",
"properties": {
"title": {
"type": "array",
"items": {
"type": "string"
},
"description": "Title fragments with <em> highlighting"
},
"abstract": {
"type": "array",
"items": {
"type": "string"
},
"description": "Abstract fragments with <em> highlighting"
}
},
"description": "Highlighted text fragments with search matches"
},
"facetAggregation": {
"type": "object",
"required": [
"dimension",
"subkind",
"values"
],
"properties": {
"label": {
"type": "string",
"description": "Display label for the dimension"
},
"values": {
"type": "array",
"items": {
"ref": "#facetValue",
"type": "ref"
}
},
"subkind": {
"type": "string",
"description": "Subkind slug for the dimension's nodes"
},
"dimension": {
"type": "string",
"description": "Dimension identifier (e.g., 'field', 'topic', 'paperType')"
}
},
"description": "Aggregation for a facet dimension"
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1,
"revision": 1
}