{
  "title": "Kaggle Dataset Discovery – License, Size & Version Changes",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "query": {
      "title": "Dataset topic",
      "type": "string",
      "editor": "textfield",
      "default": "machine learning",
      "prefill": "machine learning",
      "description": "Literal public dataset search phrase, 1–120 characters. No file downloads or private data."
    },
    "sortBy": {
      "title": "Order the shortlist",
      "type": "string",
      "editor": "select",
      "enum": [
        "hottest",
        "votes",
        "updated",
        "active",
        "published"
      ],
      "default": "votes",
      "description": "Source-provided sort order; a bounded changing search window, not a complete catalog."
    },
    "licenseIncludes": {
      "title": "Declared license name contains",
      "type": "string",
      "editor": "textfield",
      "default": "",
      "description": "Optional case-insensitive literal text filter. Matching a name does not establish commercial-use rights. Read the actual dataset license."
    },
    "maxTotalBytes": {
      "title": "Maximum published dataset size",
      "type": "integer",
      "editor": "number",
      "minimum": 0,
      "maximum": 1000000000000,
      "default": 0,
      "description": "Bytes; zero disables this filter. Missing size is excluded when a size limit is requested."
    },
    "minDownloads": {
      "title": "Minimum published download count",
      "type": "integer",
      "editor": "number",
      "minimum": 0,
      "maximum": 1000000000,
      "default": 0,
      "description": "Activity signal only; not quality, revenue, uniqueness or licensing proof."
    },
    "maxPages": {
      "title": "Maximum search pages",
      "type": "integer",
      "editor": "number",
      "minimum": 1,
      "maximum": 3,
      "default": 1,
      "description": "Up to three API pages (normally 20 metadata entries per page). No claim to enumerate all datasets. Stop earlier when the selected result count is reached."
    },
    "maxResults": {
      "title": "Maximum saved datasets",
      "type": "integer",
      "editor": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 3,
      "prefill": 3,
      "description": "Select the first matching datasets in source order, up to this many. This intentional top-N window is not a complete catalog."
    },
    "comparePrevious": {
      "title": "Compare with saved observations",
      "type": "boolean",
      "default": false,
      "description": "Opt in to publisher metadata history scoped by all search options and snapshotName. No removals are inferred from search-window absence."
    },
    "onlyChanges": {
      "title": "Only new or changed metadata",
      "type": "boolean",
      "default": false,
      "description": "Implies comparePrevious; does not establish ownership, downloadability or rights."
    },
    "snapshotName": {
      "title": "History name",
      "type": "string",
      "editor": "textfield",
      "default": "default",
      "description": "1–80 letters, digits, underscores or hyphens. Run the same scope sequentially; avoid concurrent writers."
    },
    "maxRunSeconds": {
      "title": "Time limit in seconds",
      "type": "integer",
      "editor": "number",
      "minimum": 30,
      "maximum": 120,
      "default": 90,
      "description": "Hard request deadline. Source failures and partial work appear in SUMMARY; incomplete history is not committed."
    }
  },
  "additionalProperties": false
}
