gentropic.org

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "The search query"
    },
    "feed": {
      "type": "string",
      "description": "Scope to a source (id or display name)"
    },
    "category": {
      "type": "string",
      "description": "Scope to a folder (\"\" = ungrouped)"
    },
    "type": {
      "type": "string",
      "description": "Scope to an item type (e.g. \"doc\" for repo/project docs)"
    },
    "view": {
      "type": "string",
      "enum": [
        "inbox",
        "saved",
        "archived"
      ],
      "description": "Scope to a view"
    },
    "unread": {
      "type": "boolean",
      "description": "Only unread"
    },
    "saved": {
      "type": "boolean",
      "description": "Only saved"
    },
    "curated": {
      "type": "boolean",
      "description": "Hard-scope to the curated tier only (books/notes/repo docs/saved links) — excludes the feed firehose"
    },
    "rerank": {
      "type": "boolean",
      "description": "Curation-aware reranking (default true); pass false for raw BM25 relevance"
    },
    "expand": {
      "type": "boolean",
      "description": "Vocab-synonym query expansion (default true): a query term that is a controlled-vocabulary prefLabel/altLabel also matches its synonyms — bridges curated + cross-lingual pairs (kriging↔krigagem) lexically. Pass false for the literal query. When it fires, the response carries `expanded:{term→[synonyms]}`."
    },
    "weights": {
      "type": "object",
      "description": "PER-CALL rerank weight override (ephemeral — for tuning; defaults are curated 2.5 / neutral 1.0 / firehose 0.6 / facet 0.2). Clamped 0–10. Sweep these against the eval queries, then report the winning set to bake as the default.",
      "properties": {
        "curated": {
          "type": "number"
        },
        "neutral": {
          "type": "number"
        },
        "firehose": {
          "type": "number"
        },
        "facet": {
          "type": "number",
          "description": "per-matched-facet-term bonus increment"
        }
      }
    },
    "explain": {
      "type": "boolean",
      "description": "Surface the raw lexical `lex` score per hit + the `weights` used, so you can SEE why each item ranked where it did while tuning"
    },
    "includeArchived": {
      "type": "boolean",
      "description": "Include archived items (default TRUE — the reference desk sees the whole archive; pass false to limit to active)"
    },
    "limit": {
      "type": "integer",
      "description": "Max hits (default 20, cap 100)"
    }
  },
  "required": [
    "q"
  ]
}