Research Link Sources

{
  "description": "Provider-backed arXiv absence or artifact result.",
  "anyOf": [
    {
      "description": "Provider-backed absence of an arXiv preprint for this Paper.",
      "type": "object",
      "properties": {
        "unavailable": {
          "description": "What the provider could not supply and the only discriminator of this metadata arm, such as pdf; a provider-specific marker key in its place is banned.",
          "type": "string",
          "const": "preprint"
        },
        "reason": {
          "description": "The provider-typed cause of that absence drawn from this subject's closed vocabulary, such as closed; free text or a cause invented at the call site is banned.",
          "type": "string",
          "enum": [
            "arxiv-search-miss"
          ]
        },
        "recheck": {
          "description": "Where this absence sits in the recheck cycle: the arXiv search snapshot that last looked, such as snapshot-v298, or final once the paper is over 18 months old and is never re-checked; any other value is banned.",
          "type": "string",
          "pattern": "^(snapshot-v\\d+|final)$"
        }
      },
      "required": [
        "unavailable",
        "reason",
        "recheck"
      ],
      "additionalProperties": false
    },
    {
      "description": "Pointer to a query-arxiv-owned PDF artifact, validated when it was saved.",
      "type": "object",
      "properties": {
        "artifactPath": {
          "description": "Absolute path into that provider's own artifact store, such as <provider-store>/papers/<id>.pdf; a relative path or a record-local copy is banned.",
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "artifactPath"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "description": "Provider-backed DOI acquisition result.",
  "anyOf": [
    {
      "description": "Provider-backed absence of usable PDF bytes for a DOI Paper, whether no source was recorded, the selected host refused them, or every open-access source failed and the mirror fallback refused (mirror-refused).",
      "type": "object",
      "properties": {
        "unavailable": {
          "description": "What the provider could not supply and the only discriminator of this metadata arm, such as pdf; a provider-specific marker key in its place is banned.",
          "type": "string",
          "const": "pdf"
        },
        "reason": {
          "description": "The provider-typed cause of that absence drawn from this subject's closed vocabulary, such as closed; free text or a cause invented at the call site is banned.",
          "type": "string",
          "enum": [
            "closed",
            "no-direct-pdf",
            "doi-not-found",
            "pdf-host-http-403",
            "mirror-refused"
          ]
        }
      },
      "required": [
        "unavailable",
        "reason"
      ],
      "additionalProperties": false
    },
    {
      "description": "Pointer to the validated full text proving a DOI Paper: a query-unpaywall PDF, or a site-warc capture of the publisher's own page when provider is site-warc.",
      "type": "object",
      "properties": {
        "artifactPath": {
          "description": "Absolute path into that provider's own artifact store, such as <provider-store>/papers/<id>.pdf; a relative path or a record-local copy is banned.",
          "type": "string",
          "minLength": 1
        },
        "provider": {
          "description": "Set only when the publisher serves no PDF anywhere (Distill is the case): the pointer then names a site-warc capture of the publisher's own article page instead of a query-unpaywall PDF, accepted only after every PDF route failed. Absent means the ordinary query-unpaywall PDF proof.",
          "type": "string",
          "const": "site-warc"
        }
      },
      "required": [
        "artifactPath"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "description": "Pointer to a query-openreview-owned PDF artifact, validated when it was saved.",
  "type": "object",
  "properties": {
    "artifactPath": {
      "description": "Absolute path into that provider's own artifact store, such as <provider-store>/papers/<id>.pdf; a relative path or a record-local copy is banned.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "artifactPath"
  ],
  "additionalProperties": false
}

{
  "description": "Provider-backed absence needed to keep an affiliation-less Person visibly blocked.",
  "type": "object",
  "properties": {
    "unavailable": {
      "description": "What the provider could not supply and the only discriminator of this metadata arm, such as pdf; a provider-specific marker key in its place is banned.",
      "type": "string",
      "const": "institution"
    },
    "reason": {
      "description": "The provider-typed cause of that absence drawn from this subject's closed vocabulary, such as closed; free text or a cause invented at the call site is banned.",
      "type": "string",
      "enum": [
        "openalex-institution-absent"
      ]
    }
  },
  "required": [
    "unavailable",
    "reason"
  ],
  "additionalProperties": false
}

{
  "description": "OpenAlex-reported citation count for this paper.",
  "type": "object",
  "properties": {
    "citedByCount": {
      "description": "OpenAlex citation count observed when this surface was last read; counts differ by index, so it is never copied onto another source's row.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "citedByCount"
  ],
  "additionalProperties": false
}

{
  "description": "Semantic Scholar-reported citation count for this paper.",
  "type": "object",
  "properties": {
    "citedByCount": {
      "description": "Semantic Scholar citation count observed when this surface was last read; counts differ by index, so it is never copied onto another source's row.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "citedByCount"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "finished": {
      "description": "Apple Podcasts has counted at least one full play of this episode, read from the user's library at the row's checkedOn. Written only as true: a play count above zero never goes back down, so absent means not finished as far as anyone has looked. This flag records completion, not its date; live play counts and playheads stay in Apple's library.",
      "type": "boolean",
      "const": true
    },
    "lastPlayedAt": {
      "description": "Apple Podcasts' last-played time for this episode, as a UTC ISO-8601 instant from the user's library. Written by the listening pass alongside finished when Apple supplies it, including for an episode already marked finished. A missing provider date leaves the stored value unchanged. This is the last play, not the time the episode was first completed; the Media page shows it as Last played.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "artifactPath": {
      "description": "Absolute path into that provider's own artifact store, such as <provider-store>/papers/<id>.pdf; a relative path or a record-local copy is banned.",
      "type": "string",
      "minLength": 1
    },
    "provider": {
      "description": "Owner of the saved copy. query-lesswrong is permitted only for a LessWrong, Alignment Forum or EA Forum post and holds the full post followed by every API comment. site-warc, or an omitted provider on a historical row, names the retained page capture. A new save never overwrites historical evidence.",
      "type": "string",
      "enum": [
        "site-warc",
        "query-lesswrong"
      ]
    }
  },
  "required": [
    "artifactPath"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "artifactPath": {
      "description": "Absolute path into that provider's own artifact store, such as <provider-store>/papers/<id>.pdf; a relative path or a record-local copy is banned.",
      "type": "string",
      "minLength": 1
    },
    "provider": {
      "description": "The saved-copy owner for this LessWrong, Alignment Forum or EA Forum post. The pointer includes the complete post and comment thread and never changes the Paper's canonical full text.",
      "type": "string",
      "const": "query-lesswrong"
    }
  },
  "required": [
    "artifactPath",
    "provider"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "artifactPath": {
      "description": "Absolute path into that provider's own artifact store, such as <provider-store>/papers/<id>.pdf; a relative path or a record-local copy is banned.",
      "type": "string",
      "minLength": 1
    },
    "provider": {
      "type": "string",
      "const": "site-warc"
    }
  },
  "required": [
    "artifactPath",
    "provider"
  ],
  "additionalProperties": false
}

{
  "description": "conf-talks session identity for one Media document.",
  "type": "object",
  "properties": {
    "sessionId": {
      "description": "Stable conf-talks session identity defined by the provider skill.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "sessionId"
  ],
  "additionalProperties": false
}