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 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 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 {
	ID       string `json:"id" jsonschema:"OpenAlex ID; pass it to 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 `json:"stub" jsonschema:"true when only the ID is known: the library has not fetched this work, so it has no title yet"`

	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"`
}