pub.chive.eprint.searchSubmissions

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