mcpsrv

type Candidate struct {
	Work
	TitleMatch bool `json:"title_match,omitempty" jsonschema:"the title matches the one given, allowing for case, punctuation and a typo"`
}

type DuplicateGroup struct {
	Title string `json:"title"`
	Works []Work `json:"works"`
}

type NoTextPaper struct {
	Paper  Work   `json:"paper"`
	Status string `json:"status" jsonschema:"no-text (a scan), gibberish, unreadable or timed-out"`
	Reason string `json:"reason,omitempty"`
}

type Page struct {
	Total   int    `json:"total" jsonschema:"how many there are in the library"`
	Fetched int    `json:"fetched" jsonschema:"how many of them have been fetched; the rest are stubs"`
	Omitted int    `json:"omitted" jsonschema:"how many were left out of works; raise limit to see more"`
	Works   []Work `json:"works"`
}

type Passage struct {
	Paper   Work   `json:"paper"`
	Page    int    `json:"page" jsonschema:"the page of the PDF it is on, from 1"`
	Text    string `json:"text" jsonschema:"the matching stretch of the passage; matched words are between [[ and ]]"`
	InRefs  bool   `json:"in_reference_list,omitempty" jsonschema:"the passage is from the paper's reference list"`
	PDFPath string `json:"pdf_path" jsonschema:"the PDF on the user's disk"`
}

type Sentence struct {
	Cited    Work   `json:"cited"`
	Page     int    `json:"page"`
	Sentence string `json:"sentence"`
	Section  string `json:"section,omitempty"`
}

type Step struct {
	Work
	Next string `json:"next,omitempty" jsonschema:"cites: this paper cites the next one; cited_by: the next one cites this paper"`
}

type Work struct {
	FilID    string `json:"fil_id" jsonschema:"the library's own ID for this paper, which never changes; pass it to any other tool"`
	ID       string `json:"id,omitempty" jsonschema:"OpenAlex ID; also accepted by any other tool"`
	OAStatus string `json:"oa_status" jsonschema:"diamond, gold, green, hybrid or bronze are free to read; closed is not; unknown until fetched"`

	// Stub marks a work known only by its ID: something in the library cites
	// it, but its metadata has not been fetched. It must never be presented as
	// if the library knew what it is (§6, rule 3).
	Stub bool `` /* 133-byte string literal not displayed */

	Title string `json:"title,omitempty"`

	// Authors is the byline, so that an answer can credit a paper from the
	// library rather than from the model's memory. Capped like every list.
	Authors     []string `json:"authors,omitempty" jsonschema:"the first authors, in byline order; absent when not recorded"`
	MoreAuthors int      `json:"more_authors,omitempty" jsonschema:"how many further authors the byline has (et al.)"`

	Year         int    `json:"year,omitempty"`
	Type         string `json:"type,omitempty"`
	Venue        string `json:"venue,omitempty"`
	DOI          string `json:"doi,omitempty"`
	OAURL        string `json:"oa_url,omitempty" jsonschema:"a free-to-read copy, when OpenAlex knows one"`
	CitedByCount int    `` /* 133-byte string literal not displayed */
	Seed         bool   `json:"seed,omitempty" jsonschema:"the user added this paper themselves"`
	Unresolved   bool   `json:"unresolved,omitempty" jsonschema:"OpenAlex has no record of this ID; it will never be fetched"`
}