MeshArc

Previous value: -"A project, or with no project_id the settings any project can take."New value: +"A project, as get_project, create_project and update_project answer with it; get_project with no\nproject_id answers with the settings any project can take instead."

Added value: +{
+  "description": "update_project with test_webhook only: {queued, id} when a test run.finished message was queued, or {error, status} when the API refused it, e.g. with no webhook URL saved.",
+  "title": "Webhooktest"
+}

Added value: +{
+  "description": "get_project only: {url, events, deliveries}: where run and change events are POSTed, which events, and the last 10 deliveries, each {id, event, status (queued, retrying, delivered or failed), attempts, lastStatus, lastError, createdAt, deliveredAt}. The signing secret is never included.",
+  "title": "Webhooks"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Another run's id, from list_runs, to compare with directly; omit to compare with the run just before.",
+  "title": "Against"
+}

Previous value: -"A run's change record against the run before it."New value: +"A run's change record against the run before it, or against the run named in `against`."

Previous value: -"'crawl' (crawl_site), 'run' (start_run), 'batch' (scrape_urls with several URLs) or 'search' (web_search)."New value: +"'crawl' (crawl_site), 'run' (start_run), 'batch' (scrape_urls with several URLs) or 'search' (search_web)."

Previous value: -"A job's state, or its result once finished: a crawl gives crawl_site's answer, a batch scrape_urls',\na search web_search's, a run the run record, and `url` one page in full."New value: +"A job's state, or its result once finished: a crawl gives crawl_site's answer, a batch scrape_urls',\na search search_web's, a run the run record, and `url` one page in full."

Previous value: -"A search: the ranked results, as web_search returns them, with page excerpts when it scraped."New value: +"A search: the ranked results, as search_web returns them, with page excerpts when it scraped."

Previous value: -"A project, or with no project_id the settings any project can take."New value: +"A project, as get_project, create_project and update_project answer with it; get_project with no\nproject_id answers with the settings any project can take instead."

Added value: +{
+  "description": "update_project with test_webhook only: {queued, id} when a test run.finished message was queued, or {error, status} when the API refused it, e.g. with no webhook URL saved.",
+  "title": "Webhooktest"
+}

Added value: +{
+  "description": "get_project only: {url, events, deliveries}: where run and change events are POSTed, which events, and the last 10 deliveries, each {id, event, status (queued, retrying, delivered or failed), attempts, lastStatus, lastError, createdAt, deliveredAt}. The signing secret is never included.",
+  "title": "Webhooks"
+}

Previous value: -"A run's id, from list_runs; empty means the project's latest finished run."New value: +"A run's id, from list_runs; empty means the latest finished run, or with url the newest copy across the project's last 50 runs."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "One page's full URL, as a listing shows it, to read that page in full; omit to list.",
+  "title": "Url"
+}

Previous value: -"A run's pages, or with q the pages that match."New value: +"A run's pages; with q the pages that match; with url one page in full."

Added value: +{
+  "description": "With url: simplified html, when kept.",
+  "title": "Cleanhtml"
+}

Added value: +{
+  "description": "With url: when this copy was read (ISO 8601).",
+  "title": "Crawledat"
+}

Added value: +{
+  "description": "With url: fields the project's json_schema extracted, or null.",
+  "title": "Fields"
+}

Added value: +{
+  "description": "With url: {title, description, canonical, h1, ...}.",
+  "title": "Head"
+}

Added value: +{
+  "description": "With url: the raw html, when the run kept it.",
+  "title": "Html"
+}

Previous value: -"Without q: the run's link-graph summary (orphans, unlisted pages, dead ends), or null."New value: +"Listing: the run's link-graph summary (orphans, unlisted pages, dead ends), or null."

Added value: +{
+  "description": "With url: its main content as markdown, capped at 12,000 characters.",
+  "title": "Markdown"
+}

Added value: +{
+  "description": "With url: ok, blocked, captcha, missing (404/410), timeout, redirect, robots or skipped.",
+  "title": "Pagestatus"
+}

Previous value: -"Without q: up to 500 rows, shallowest first, each {url, path, status, depth, words, changed, title, crawledAt}."New value: +"Listing: up to 500 rows, shallowest first, each {url, path, status, depth, words, changed, title, crawledAt}."

Previous value: -"The run these pages are from; null when the project has no finished run."New value: +"The run these pages are from (with url, the run this copy is from); null when the project has no finished run."

Previous value: -"Only on a failure: the HTTP status code."New value: +"With url: the HTTP status the site answered. On an error, the API's status code."

Added value: +{
+  "description": "With url: plain text, when kept.",
+  "title": "Text"
+}

Added value: +{
+  "description": "With url: the page's URL as stored.",
+  "title": "Url"
+}

Added value: +{
+  "description": "With url: every stored copy across runs, newest first, each {runId, crawledAt, contentHash, words, status}; a changed contentHash is a changed page.",
+  "title": "Versions"
+}

Added value: +{
+  "description": "With url: words in its markdown.",
+  "title": "Words"
+}

Added value: +{
+  "description": "{plan, creditsLeft, creditsSpentThisMonth, oneTimeAllowance}: creditsLeft is what may still be spent, this month or, on a one-time allowance, ever; null means no limit. {note} instead when the balance could not be read.",
+  "title": "Workspace"
+}

Previous value: -"The run's id: for get_job, cancel_job and the run_id of list_pages, get_page and get_changes."New value: +"The run's id: for get_job, cancel_job and the run_id of list_pages and get_changes."

Added value: +{
+  "default": false,
+  "description": "true sends a test run.finished message to the project's webhook URL, after any changes; the URL must be saved. Default false.",
+  "title": "Test Webhook",
+  "type": "boolean"
+}

Previous value: -"A project, or with no project_id the settings any project can take."New value: +"A project, as get_project, create_project and update_project answer with it; get_project with no\nproject_id answers with the settings any project can take instead."

Added value: +{
+  "description": "update_project with test_webhook only: {queued, id} when a test run.finished message was queued, or {error, status} when the API refused it, e.g. with no webhook URL saved.",
+  "title": "Webhooktest"
+}

Added value: +{
+  "description": "get_project only: {url, events, deliveries}: where run and change events are POSTed, which events, and the last 10 deliveries, each {id, event, status (queued, retrying, delivered or failed), attempts, lastStatus, lastError, createdAt, deliveredAt}. The signing secret is never included.",
+  "title": "Webhooks"
+}

Previous value: -"'crawl' (crawl_site), 'run' (start_run) or 'batch' (scrape_urls with several URLs)."New value: +"'crawl' (crawl_site), 'run' (start_run), 'batch' (scrape_urls with several URLs) or 'search' (web_search)."

Previous value: -[
-  "crawl",
-  "run",
-  "batch"
-]New value: +[
+  "crawl",
+  "run",
+  "batch",
+  "search"
+]

Previous value: -"A job's state, or its result once finished: a crawl gives crawl_site's answer, a batch scrape_urls',\na run the run record, and `url` one page in full."New value: +"A job's state, or its result once finished: a crawl gives crawl_site's answer, a batch scrape_urls',\na search web_search's, a run the run record, and `url` one page in full."

Previous value: -"A run: its id."New value: +"A run or a search: its id."

Added value: +{
+  "description": "A search: the ranked results, as web_search returns them, with page excerpts when it scraped.",
+  "title": "Results"
+}

Previous value: -"The job's id, from that 'job' object, or a crawl_site answer's crawl_id."New value: +"The job's id."

Previous value: -"What the job is: 'crawl' (crawl_site), 'run' (start_run, recrawl_pages) or 'batch' (scrape_urls); the 'job' object a tool returned names it."New value: +"'crawl' (crawl_site), 'run' (start_run) or 'batch' (scrape_urls with several URLs)."

Previous value: -"Required for a run: the project it belongs to (the 'job' object carries it). Ignored for a crawl or a batch."New value: +"A run's project id; required for a run, ignored otherwise."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "What a cancel did.",
+  "properties": {
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "id": {
+      "description": "The job's id.",
+      "title": "Id"
+    },
+    "kind": {
+      "description": "crawl, run or batch.",
+      "title": "Kind"
+    },
+    "note": {
+      "description": "What a stop keeps and drops.",
+      "title": "Note"
+    },
+    "outcome": {
+      "description": "'cancelled' (it had not started), 'cancelling' (it stops after the page in hand), or the status of a job that had already ended.",
+      "title": "Outcome"
+    },
+    "project_id": {
+      "description": "A run: its project.",
+      "title": "Project Id"
+    },
+    "status": {
+      "description": "Only on a failure: the HTTP status code.",
+      "title": "Status"
+    }
+  },
+  "title": "CancelOut",
+  "type": "object"
+}

Previous value: -"Optional fetch settings: any subset of the keys describe_project_config lists, e.g. {\"render_js\": \"always\", \"only_main_content\": true}. Omit for the defaults."New value: +"Fetch settings to override, as {key: value}; omit for the defaults."

Previous value: -"Globs over the URL path to keep, e.g. ['/blog/*'] for a section (its index included); a bare '/blog/' matches only that one page. Omit for the whole site."New value: +"Globs over the URL path to keep; a bare '/blog/' matches that one page only. Omit for the whole site."

Previous value: -"How many links deep to follow from the start URL (0 = that page only; default 3)."New value: +"Link hops to follow from the start URL (0 = that page only; default 3)."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A crawl: the pages read, as an index plus excerpts, or a job when it is still going.",
+  "properties": {
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "counts": {
+      "description": "Pages by outcome, e.g. {ok, blocked, error}.",
+      "title": "Counts"
+    },
+    "crawl_id": {
+      "description": "This crawl's id: for get_job, cancel_job, and create_project(crawl_id=...) to keep it.",
+      "title": "Crawl Id"
+    },
+    "cursor": {
+      "description": "Present when more pages exist: pass it to get_job for the next window.",
+      "title": "Cursor"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "index": {
+      "description": "Every page read (up to 500) as {url, title, words, status}.",
+      "title": "Index"
+    },
+    "job": {
+      "description": "While it is still going: {kind: 'crawl', id} for get_job and cancel_job.",
+      "title": "Job"
+    },
+    "note": {
+      "description": "What was cut, and how to read a page in full.",
+      "title": "Note"
+    },
+    "pages": {
+      "description": "Up to 50 pages, each {url, title, words, status, links (a count), markdown excerpt}.",
+      "title": "Pages"
+    },
+    "status": {
+      "description": "'done', 'cancelled' or 'error' once finished, 'running' with a `job` while it goes on. On an error, the HTTP status code.",
+      "title": "Status"
+    },
+    "stop": {
+      "description": "Why the crawl ended early, e.g. its page limit; empty otherwise.",
+      "title": "Stop"
+    },
+    "url": {
+      "description": "The start URL.",
+      "title": "Url"
+    }
+  },
+  "title": "CrawlOut",
+  "type": "object"
+}

Previous value: -"Any subset of the settings describe_project_config lists. For one section of a site pass include_paths, e.g. {\"include_paths\": [\"/blog/*\"]}; map_site shows the site's sections first. Omit for the defaults."New value: +"Settings as {key: value}, with a seed only; omit for the defaults."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "A crawl_site answer's crawl_id, to keep that crawl as the project. Give this or seed.",
+  "title": "Crawl Id"
+}

Previous value: -"A name for the project; omit to use the site's host name."New value: +"A display name; omit for the site's host (or the crawl's own name)."

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +null

Previous value: -"Where the crawl starts: a public site's URL or bare domain, e.g. 'https://example.com/blog/' or 'example.com'. The project covers that host."New value: +"The site to watch, as a URL or bare domain, e.g. 'https://example.com/blog/' or 'example.com'; its host is fixed for good. Give this or crawl_id."

Removed value: -"string"

Removed value: -[
-  "seed"
-]

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A project, or with no project_id the settings any project can take.",
+  "properties": {
+    "changeSummary": {
+      "description": "The last compared run in words, e.g. '3 new · 2 changed · 0 removed'.",
+      "title": "Changesummary"
+    },
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "config": {
+      "description": "Its settings as {key: value}; secrets such as chat_url come back masked.",
+      "title": "Config"
+    },
+    "coverage": {
+      "description": "Percent of the site the last run reached; under 90 means removals are withheld.",
+      "title": "Coverage"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "host": {
+      "description": "The site it covers; fixed at creation.",
+      "title": "Host"
+    },
+    "id": {
+      "description": "The project's 32-character hex id.",
+      "title": "Id"
+    },
+    "lastRunAt": {
+      "description": "When the last run started (ISO 8601), or null.",
+      "title": "Lastrunat"
+    },
+    "name": {
+      "description": "Its display name.",
+      "title": "Name"
+    },
+    "nextRunAt": {
+      "description": "When the schedule runs it next, or null for manual.",
+      "title": "Nextrunat"
+    },
+    "note": {
+      "description": "No project_id only: how path globs work.",
+      "title": "Note"
+    },
+    "other_keys": {
+      "description": "No project_id only: further keys accepted but rarely needed.",
+      "title": "Other Keys"
+    },
+    "pagesN": {
+      "description": "Pages its last finished run read.",
+      "title": "Pagesn"
+    },
+    "retention": {
+      "description": "How long runs are kept, e.g. '90d'.",
+      "title": "Retention"
+    },
+    "scheduleKey": {
+      "description": "manual, hourly, daily or weekly.",
+      "title": "Schedulekey"
+    },
+    "schedules": {
+      "description": "No project_id only: the valid schedules.",
+      "title": "Schedules"
+    },
+    "seed": {
+      "description": "Where its crawls start.",
+      "title": "Seed"
+    },
+    "settings": {
+      "description": "No project_id only: every common setting as {key, meaning, default}.",
+      "title": "Settings"
+    },
+    "status": {
+      "description": "draft, crawling, healthy or failing. On an error, the HTTP status code.",
+      "title": "Status"
+    }
+  },
+  "title": "ProjectOut",
+  "type": "object"
+}

Previous value: -"The project's id, as list_projects or create_project returns it."New value: +"The project's 32-character hex id, from list_projects."

Previous value: -"A run's id, from list_runs, start_run or the runId a list_pages answer carries; leave empty for the last finished run."New value: +"A run's id, from list_runs; empty means the project's latest finished run."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A run's change record against the run before it.",
+  "properties": {
+    "change": {
+      "description": "{runId, prevRunId, baseline, rebaselined, coverage, degraded, counts {added, modified, removed}, summary, feed, fields, withheld}. feed: each changed page as {url, path, kind (added, modified or removed), added and removed (words, e.g. '+12'), wordsBefore, wordsAfter}. fields: head and extracted field changes as {url, field, before, after}. withheld: removals held back because coverage was under 90%. Each list holds up to 200.",
+      "title": "Change"
+    },
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "runs": {
+      "description": "The finished runs a record exists for, newest first, for picking another run_id.",
+      "title": "Runs"
+    },
+    "status": {
+      "description": "Only on a failure: the HTTP status code.",
+      "title": "Status"
+    }
+  },
+  "title": "ChangesOut",
+  "type": "object"
+}

Previous value: -"Crawls only: the cursor a previous crawl answer returned, to read the next window of pages."New value: +"Crawls only: the cursor the previous answer returned."

Previous value: -"The job's id, from that 'job' object, or a crawl_site answer's crawl_id."New value: +"The job's id."

Previous value: -"What the job is: 'crawl' (crawl_site), 'run' (start_run, recrawl_pages) or 'batch' (scrape_urls); the 'job' object a tool returned names it."New value: +"'crawl' (crawl_site), 'run' (start_run) or 'batch' (scrape_urls with several URLs)."

Previous value: -"Required for a run: the project it belongs to (the 'job' object carries it). Ignored for a crawl or a batch."New value: +"A run's project id; required for a run, ignored otherwise."

Previous value: -"Crawls only: one page's URL from the crawl's index, to read that page in full."New value: +"Crawls only: one page's URL from the crawl's index."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A job's state, or its result once finished: a crawl gives crawl_site's answer, a batch scrape_urls',\na run the run record, and `url` one page in full.",
+  "properties": {
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "counts": {
+      "description": "Pages by outcome so far.",
+      "title": "Counts"
+    },
+    "crawl_id": {
+      "description": "A crawl: its id.",
+      "title": "Crawl Id"
+    },
+    "cursor": {
+      "description": "A crawl with more pages: pass it back for the next window.",
+      "title": "Cursor"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "id": {
+      "description": "A run: its id.",
+      "title": "Id"
+    },
+    "index": {
+      "description": "A finished crawl or batch: every page as {url, title, words, status}.",
+      "title": "Index"
+    },
+    "job": {
+      "description": "While running: {kind, id, project_id} to call again with.",
+      "title": "Job"
+    },
+    "markdown": {
+      "description": "With url: that page's markdown, capped at 12,000 characters.",
+      "title": "Markdown"
+    },
+    "note": {
+      "description": "What to do next.",
+      "title": "Note"
+    },
+    "pages": {
+      "description": "A finished crawl or batch: pages with excerpts.",
+      "title": "Pages"
+    },
+    "status": {
+      "description": "'running' while it goes on; otherwise the finished job's status. On an error, the HTTP status code.",
+      "title": "Status"
+    }
+  },
+  "title": "JobOut",
+  "type": "object"
+}

Previous value: -"The project's id, as list_projects or create_project returns it."New value: +"The project's 32-character hex id, from list_projects."

Previous value: -"A run's id, from list_runs or start_run, to read that run's copy; leave empty for the newest copy across the project's recent runs."New value: +"A run's id, to read that run's copy; empty means the newest copy across the project's last 50 runs."

Previous value: -"The page's full URL as list_pages or search_pages shows it; the other scheme or trailing slash is matched too."New value: +"The page's full URL, as list_pages shows it."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "One stored page in full.",
+  "properties": {
+    "cleanHtml": {
+      "description": "Simplified html, when kept.",
+      "title": "Cleanhtml"
+    },
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "crawledAt": {
+      "description": "When this copy was read (ISO 8601).",
+      "title": "Crawledat"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "fields": {
+      "description": "Fields the project's json_schema extracted, or null.",
+      "title": "Fields"
+    },
+    "head": {
+      "description": "{title, description, canonical, h1, ...}.",
+      "title": "Head"
+    },
+    "html": {
+      "description": "The raw html, when the run kept it.",
+      "title": "Html"
+    },
+    "markdown": {
+      "description": "Its main content as markdown, capped at 12,000 characters.",
+      "title": "Markdown"
+    },
+    "pageStatus": {
+      "description": "ok, blocked, captcha, missing (404/410), timeout, redirect, robots or skipped.",
+      "title": "Pagestatus"
+    },
+    "runId": {
+      "description": "The run this copy is from.",
+      "title": "Runid"
+    },
+    "status": {
+      "description": "The HTTP status the site answered; on an error, the API's status code.",
+      "title": "Status"
+    },
+    "text": {
+      "description": "Plain text, when kept.",
+      "title": "Text"
+    },
+    "url": {
+      "description": "The page's URL as stored.",
+      "title": "Url"
+    },
+    "versions": {
+      "description": "Every stored copy across runs, newest first, each {runId, crawledAt, contentHash, words, status}; a changed contentHash is a changed page.",
+      "title": "Versions"
+    },
+    "words": {
+      "description": "Words in its markdown.",
+      "title": "Words"
+    }
+  },
+  "title": "PageOut",
+  "type": "object"
+}

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +null

Previous value: -"The project's id, as list_projects or create_project returns it."New value: +"The project's 32-character hex id, from list_projects; omit for the settings reference."

Removed value: -"string"

Removed value: -[
-  "project_id"
-]

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A project, or with no project_id the settings any project can take.",
+  "properties": {
+    "changeSummary": {
+      "description": "The last compared run in words, e.g. '3 new · 2 changed · 0 removed'.",
+      "title": "Changesummary"
+    },
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "config": {
+      "description": "Its settings as {key: value}; secrets such as chat_url come back masked.",
+      "title": "Config"
+    },
+    "coverage": {
+      "description": "Percent of the site the last run reached; under 90 means removals are withheld.",
+      "title": "Coverage"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "host": {
+      "description": "The site it covers; fixed at creation.",
+      "title": "Host"
+    },
+    "id": {
+      "description": "The project's 32-character hex id.",
+      "title": "Id"
+    },
+    "lastRunAt": {
+      "description": "When the last run started (ISO 8601), or null.",
+      "title": "Lastrunat"
+    },
+    "name": {
+      "description": "Its display name.",
+      "title": "Name"
+    },
+    "nextRunAt": {
+      "description": "When the schedule runs it next, or null for manual.",
+      "title": "Nextrunat"
+    },
+    "note": {
+      "description": "No project_id only: how path globs work.",
+      "title": "Note"
+    },
+    "other_keys": {
+      "description": "No project_id only: further keys accepted but rarely needed.",
+      "title": "Other Keys"
+    },
+    "pagesN": {
+      "description": "Pages its last finished run read.",
+      "title": "Pagesn"
+    },
+    "retention": {
+      "description": "How long runs are kept, e.g. '90d'.",
+      "title": "Retention"
+    },
+    "scheduleKey": {
+      "description": "manual, hourly, daily or weekly.",
+      "title": "Schedulekey"
+    },
+    "schedules": {
+      "description": "No project_id only: the valid schedules.",
+      "title": "Schedules"
+    },
+    "seed": {
+      "description": "Where its crawls start.",
+      "title": "Seed"
+    },
+    "settings": {
+      "description": "No project_id only: every common setting as {key, meaning, default}.",
+      "title": "Settings"
+    },
+    "status": {
+      "description": "draft, crawling, healthy or failing. On an error, the HTTP status code.",
+      "title": "Status"
+    }
+  },
+  "title": "ProjectOut",
+  "type": "object"
+}

Added value: +{
+  "default": "content",
+  "description": "With q: 'content' (default) searches the markdown, 'selector' the stored html.",
+  "enum": [
+    "content",
+    "selector"
+  ],
+  "title": "Mode",
+  "type": "string"
+}

Previous value: -"The project's id, as list_projects or create_project returns it."New value: +"The project's 32-character hex id, from list_projects."

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Text to find, 1 to 200 characters: words or a \"quoted phrase\", or with mode='selector' a CSS selector or an XPath starting with / or (. Omit to list every page.",
+  "title": "Q"
+}

Previous value: -"A run's id, from list_runs, start_run or the runId a list_pages answer carries; leave empty for the last finished run."New value: +"A run's id, from list_runs; empty means the project's latest finished run."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A run's pages, or with q the pages that match.",
+  "properties": {
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "hits": {
+      "description": "With q: up to 500 matches, each {url, count (matches on the page), snippet}.",
+      "title": "Hits"
+    },
+    "linkGraph": {
+      "description": "Without q: the run's link-graph summary (orphans, unlisted pages, dead ends), or null.",
+      "title": "Linkgraph"
+    },
+    "noBody": {
+      "description": "With q: pages skipped because the body the mode needs was not kept (rawHtml for selector).",
+      "title": "Nobody"
+    },
+    "pages": {
+      "description": "Without q: up to 500 rows, shallowest first, each {url, path, status, depth, words, changed, title, crawledAt}.",
+      "title": "Pages"
+    },
+    "runId": {
+      "description": "The run these pages are from; null when the project has no finished run.",
+      "title": "Runid"
+    },
+    "scanned": {
+      "description": "With q: pages searched.",
+      "title": "Scanned"
+    },
+    "status": {
+      "description": "Only on a failure: the HTTP status code.",
+      "title": "Status"
+    },
+    "truncated": {
+      "description": "With q: true when more pages matched than are listed.",
+      "title": "Truncated"
+    }
+  },
+  "title": "PagesOut",
+  "type": "object"
+}

Added value: +true

Added value: +"Every project the key can see."

Added value: +{
+  "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+  "title": "Code"
+}

Added value: +{
+  "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+  "title": "Detail"
+}

Added value: +{
+  "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+  "title": "Error"
+}

Added value: +{
+  "description": "Oldest first, each {id, name, seed, host, schedule, pages, coverage, lastRun, status}; status is draft, crawling, healthy or failing.",
+  "title": "Projects"
+}

Removed value: -{
-  "anyOf": [
-    {
-      "items": {},
-      "type": "array"
-    },
-    {
-      "additionalProperties": true,
-      "type": "object"
-    }
-  ],
-  "title": "Result"
-}

Added value: +{
+  "description": "Only on a failure: the HTTP status code.",
+  "title": "Status"
+}

Removed value: -[
-  "result"
-]

Previous value: -"list_projectsOutput"New value: +"ProjectsOut"

Previous value: -"How many runs to return, newest first: 1 to 100 (default 25)."New value: +"How many runs to return, 1 to 100 (default 25)."

Previous value: -"The project's id, as list_projects or create_project returns it."New value: +"The project's 32-character hex id, from list_projects."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A project's runs, newest first.",
+  "properties": {
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "runs": {
+      "description": "Each {id, status, trigger, scope, pagesN, changedN, counts, coverage, stop, startedAt, elapsed, baseline, rebaselined}; baseline is a first run with nothing to compare, rebaselined one whose settings changed how pages read, so it was recorded rather than compared.",
+      "title": "Runs"
+    },
+    "status": {
+      "description": "Only on a failure: the HTTP status code.",
+      "title": "Status"
+    }
+  },
+  "title": "RunsOut",
+  "type": "object"
+}

Previous value: -"The most URLs to return, 1 to 5,000 (default 1,000); totals still count them all."New value: +"The most URLs to return, 1 to 5,000 (default 1,000); totals count them all."

Previous value: -"Keep only URLs containing this text, e.g. '/blog/'; omit for all."New value: +"Keep only URLs containing this text; omit for all."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "The URLs a site's sitemaps declare.",
+  "properties": {
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "method": {
+      "description": "How the sitemaps were found, e.g. through robots.txt.",
+      "title": "Method"
+    },
+    "sections": {
+      "description": "The section names the sitemaps group URLs under, e.g. 'blog'; empty when there are none.",
+      "title": "Sections"
+    },
+    "status": {
+      "description": "Only on a failure: the HTTP status code.",
+      "title": "Status"
+    },
+    "totals": {
+      "description": "Counts over every declared URL and sitemap file, whatever `limit` returned.",
+      "title": "Totals"
+    },
+    "url": {
+      "description": "The site that was mapped.",
+      "title": "Url"
+    },
+    "urls": {
+      "description": "The declared URLs, at most `limit`, filtered by `search`.",
+      "title": "Urls"
+    }
+  },
+  "title": "MapOut",
+  "type": "object"
+}

Previous value: -"Optional fetch settings: any subset of the keys describe_project_config lists, e.g. {\"render_js\": \"always\", \"only_main_content\": true}. Omit for the defaults."New value: +"Fetch settings to override, as {key: value}; omit for the defaults."

Previous value: -"Comma-separated bodies to return per page, from markdown (default), text, cleanHtml and rawHtml, e.g. 'markdown,text'."New value: +"Bodies per page, comma-separated from markdown (default), text, cleanHtml and rawHtml. With full=true, config's formats list chooses them instead."

Added value: +{
+  "default": false,
+  "description": "true reads the one URL in full -- raw html, head and extracted fields, images, the engine used -- running config's browser actions first. Default false.",
+  "title": "Full",
+  "type": "boolean"
+}

Previous value: -"Read PDFs, Word files and spreadsheets as text (default true); false leaves their text out. A parse_documents key in config wins."New value: +"Read PDF, Word and spreadsheet URLs as text (default true). A parse_documents key in config wins."

Previous value: -"The pages to fetch: 1 to 500 absolute http(s) URLs."New value: +"Absolute http(s) URLs, 1 to 500; exactly one when full is true."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A scrape. A list: status, the pages with excerpts and an index of every url. One URL: that page in\nfull. full=true: the extraction, with the page under `page`. A batch still going: status 'running' and\na job.",
+  "properties": {
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "index": {
+      "description": "A list only: every url as {url, title, words, status}, so none is lost when excerpts are cut.",
+      "title": "Index"
+    },
+    "job": {
+      "description": "While a batch is still going: {kind: 'batch', id} for get_job and cancel_job.",
+      "title": "Job"
+    },
+    "note": {
+      "description": "What was left out and how to get it.",
+      "title": "Note"
+    },
+    "page": {
+      "description": "full=true only: the page in full -- markdown, html, head {title, description, canonical, h1}, fields, images, engine, pageStatus -- with each body capped at 12,000 characters.",
+      "title": "Page"
+    },
+    "pages": {
+      "description": "The pages read. A list: up to 50, each {url, title, words, status, links (a count), markdown excerpt}, the excerpts sharing 60,000 characters. One URL: that page in full, each body asked for capped at 12,000 characters.",
+      "title": "Pages"
+    },
+    "rest": {
+      "description": "A list past its index: {count, byStatus, notOk} for the urls not shown.",
+      "title": "Rest"
+    },
+    "status": {
+      "description": "'done' once read; 'running' with a `job` while a batch goes on; with full=true, 'blocked' when the site refused and 'error' when the read failed. On an error, the HTTP status code.",
+      "title": "Status"
+    }
+  },
+  "title": "ScrapeOut",
+  "type": "object"
+}

Previous value: -"The project's id, as list_projects or create_project returns it."New value: +"The project's 32-character hex id, from list_projects."

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Up to 500 pages of the project's site to re-read, as full URLs or paths; omit to crawl the whole site.",
+  "title": "Urls"
+}

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A run of a project, or a job when a wait ran out first.",
+  "properties": {
+    "changedN": {
+      "description": "Pages added, modified or removed against the run before; null until compared.",
+      "title": "Changedn"
+    },
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "counts": {
+      "description": "Pages by outcome, e.g. {ok, blocked, error}.",
+      "title": "Counts"
+    },
+    "coverage": {
+      "description": "Percent of the known site this run reached.",
+      "title": "Coverage"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "id": {
+      "description": "The run's id: for get_job, cancel_job and the run_id of list_pages, get_page and get_changes.",
+      "title": "Id"
+    },
+    "job": {
+      "description": "When the wait ran out first: {kind: 'run', id, project_id} for get_job and cancel_job.",
+      "title": "Job"
+    },
+    "note": {
+      "description": "What to do next when it is still going.",
+      "title": "Note"
+    },
+    "pagesN": {
+      "description": "Pages read so far.",
+      "title": "Pagesn"
+    },
+    "queued": {
+      "description": "true while it waits for a worker.",
+      "title": "Queued"
+    },
+    "scope": {
+      "description": "How many URLs a start_run with urls listed; 0 for a full run.",
+      "title": "Scope"
+    },
+    "startedAt": {
+      "description": "When it started (ISO 8601).",
+      "title": "Startedat"
+    },
+    "status": {
+      "description": "running, complete, partial (some pages refused), failed or cancelled. On an error, the HTTP status code.",
+      "title": "Status"
+    },
+    "stop": {
+      "description": "Why it ended, e.g. the credit budget; empty while running.",
+      "title": "Stop"
+    },
+    "trigger": {
+      "description": "manual, scheduled, api or recrawl.",
+      "title": "Trigger"
+    }
+  },
+  "title": "RunOut",
+  "type": "object"
+}

Previous value: -"Settings to change, e.g. {\"max_pages\": 200}; keys not given keep their values. Omit to leave them all."New value: +"Settings to change as {key: value}; omit to leave them all."

Previous value: -"The project's id, as list_projects or create_project returns it."New value: +"The project's 32-character hex id, from list_projects."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "description": "A project, or with no project_id the settings any project can take.",
+  "properties": {
+    "changeSummary": {
+      "description": "The last compared run in words, e.g. '3 new · 2 changed · 0 removed'.",
+      "title": "Changesummary"
+    },
+    "code": {
+      "description": "Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found.",
+      "title": "Code"
+    },
+    "config": {
+      "description": "Its settings as {key: value}; secrets such as chat_url come back masked.",
+      "title": "Config"
+    },
+    "coverage": {
+      "description": "Percent of the site the last run reached; under 90 means removals are withheld.",
+      "title": "Coverage"
+    },
+    "detail": {
+      "description": "Only on a failure: the API's own wording, when the error was rephrased.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Only when the call failed: what went wrong, in words an assistant can act on.",
+      "title": "Error"
+    },
+    "host": {
+      "description": "The site it covers; fixed at creation.",
+      "title": "Host"
+    },
+    "id": {
+      "description": "The project's 32-character hex id.",
+      "title": "Id"
+    },
+    "lastRunAt": {
+      "description": "When the last run started (ISO 8601), or null.",
+      "title": "Lastrunat"
+    },
+    "name": {
+      "description": "Its display name.",
+      "title": "Name"
+    },
+    "nextRunAt": {
+      "description": "When the schedule runs it next, or null for manual.",
+      "title": "Nextrunat"
+    },
+    "note": {
+      "description": "No project_id only: how path globs work.",
+      "title": "Note"
+    },
+    "other_keys": {
+      "description": "No project_id only: further keys accepted but rarely needed.",
+      "title": "Other Keys"
+    },
+    "pagesN": {
+      "description": "Pages its last finished run read.",
+      "title": "Pagesn"
+    },
+    "retention": {
+      "description": "How long runs are kept, e.g. '90d'.",
+      "title": "Retention"
+    },
+    "scheduleKey": {
+      "description": "manual, hourly, daily or weekly.",
+      "title": "Schedulekey"
+    },
+    "schedules": {
+      "description": "No project_id only: the valid schedules.",
+      "title": "Schedules"
+    },
+    "seed": {
+      "description": "Where its crawls start.",
+      "title": "Seed"
+    },
+    "settings": {
+      "description": "No project_id only: every common setting as {key, meaning, default}.",
+      "title": "Settings"
+    },
+    "status": {
+      "description": "draft, crawling, healthy or failing. On an error, the HTTP status code.",
+      "title": "Status"
+    }
+  },
+  "title": "ProjectOut",
+  "type": "object"
+}

Previous value: -"A run's id, from start_run or the runId a list_pages answer carries; leave empty for the last finished run."New value: +"A run's id, from list_runs, start_run or the runId a list_pages answer carries; leave empty for the last finished run."

Previous value: -"A run's id, from start_run or a list_pages answer, to read that run's copy; leave empty for the newest copy across the project's recent runs."New value: +"A run's id, from list_runs or start_run, to read that run's copy; leave empty for the newest copy across the project's recent runs."

Previous value: -"A run's id, from start_run or the runId a list_pages answer carries; leave empty for the last finished run."New value: +"A run's id, from list_runs, start_run or the runId a list_pages answer carries; leave empty for the last finished run."

Previous value: -"A run's id, from start_run or the runId a list_pages answer carries; leave empty for the last finished run."New value: +"A run's id, from list_runs, start_run or the runId a list_pages answer carries; leave empty for the last finished run."

Previous value: -"1 to 500 full URLs on the project's site to fetch again."New value: +"1 to 500 pages on the project's site to fetch again: full URLs, or paths such as '/pricing'."

Added value: +"Optional fetch settings: any subset of the keys describe_project_config lists, e.g. {\"render_js\": \"always\", \"only_main_content\": true}. Omit for the defaults."

Added value: +"Globs over the URL path to skip, e.g. ['/tag/*', '*.pdf']; an exclude wins over an include."

Added value: +"Globs over the URL path to keep, e.g. ['/blog/*'] for a section (its index included); a bare '/blog/' matches only that one page. Omit for the whole site."

Added value: +"The most pages to read, 1 to 5,000 (default 50); the plan's page cap also applies."

Added value: +"How many links deep to follow from the start URL (0 = that page only; default 3)."

Added value: +"The absolute http(s) URL to start from, e.g. the home page."

Added value: +"Any subset of the settings describe_project_config lists. For one section of a site pass include_paths, e.g. {\"include_paths\": [\"/blog/*\"]}; map_site shows the site's sections first. Omit for the defaults."

Added value: +"A name for the project; omit to use the site's host name."

Added value: +"How often it re-crawls on its own; 'manual' (default) runs only when start_run is called."

Added value: +[
+  "manual",
+  "hourly",
+  "daily",
+  "weekly"
+]

Added value: +"Where the crawl starts: a public site's URL or bare domain, e.g. 'https://example.com/blog/' or 'example.com'. The project covers that host."

Added value: +"Optional fetch settings: any subset of the keys describe_project_config lists, e.g. {\"render_js\": \"always\", \"only_main_content\": true}. Omit for the defaults."

Added value: +"Read PDFs, Word files and spreadsheets as text (default true); false leaves their text out. A parse_documents key in config wins."

Added value: +"The absolute http(s) URL of the page to read."

Added value: +"The project's id, as list_projects or create_project returns it."

Added value: +"A run's id, from start_run or the runId a list_pages answer carries; leave empty for the last finished run."

Added value: +"Crawls only: the cursor a previous crawl answer returned, to read the next window of pages."

Added value: +"The job's id, from that 'job' object, or a crawl_site answer's crawl_id."

Added value: +"What the job is: 'crawl' (crawl_site), 'run' (start_run, recrawl_pages) or 'batch' (scrape_urls); the 'job' object a tool returned names it."

Added value: +[
+  "crawl",
+  "run",
+  "batch"
+]

Added value: +"Required for a run: the project it belongs to (the 'job' object carries it). Ignored for a crawl or a batch."

Added value: +"Crawls only: one page's URL from the crawl's index, to read that page in full."

Added value: +"The project's id, as list_projects or create_project returns it."

Added value: +"A run's id, from start_run or a list_pages answer, to read that run's copy; leave empty for the newest copy across the project's recent runs."

Added value: +"The page's full URL as list_pages or search_pages shows it; the other scheme or trailing slash is matched too."

Added value: +"The project's id, as list_projects or create_project returns it."

Added value: +"The crawl_id a crawl_site answer (or get_job on a crawl) returned."

Added value: +"A name for the project; omit to keep the crawl's own name."

Added value: +"How often the project re-crawls on its own; 'manual' (default) runs only when start_run is called. Every run spends credits."

Added value: +[
+  "manual",
+  "hourly",
+  "daily",
+  "weekly"
+]

Added value: +"The project's id, as list_projects or create_project returns it."

Added value: +"A run's id, from start_run or the runId a list_pages answer carries; leave empty for the last finished run."

Added value: +"The most URLs to return, 1 to 5,000 (default 1,000); totals still count them all."

Added value: +"Keep only URLs containing this text, e.g. '/blog/'; omit for all."

Added value: +"Any URL on the site, usually its home page."

Added value: +"The project's id, as list_projects or create_project returns it."

Added value: +"1 to 500 full URLs on the project's site to fetch again."

Added value: +"Optional fetch settings: any subset of the keys describe_project_config lists, e.g. {\"render_js\": \"always\", \"only_main_content\": true}. Omit for the defaults."

Added value: +"Comma-separated bodies to return per page, from markdown (default), text, cleanHtml and rawHtml, e.g. 'markdown,text'."

Added value: +"Read PDFs, Word files and spreadsheets as text (default true); false leaves their text out. A parse_documents key in config wins."

Added value: +"The pages to fetch: 1 to 500 absolute http(s) URLs."

Added value: +"'content' (default) searches the extracted markdown; 'selector' searches the stored html."

Added value: +[
+  "content",
+  "selector"
+]

Added value: +"The project's id, as list_projects or create_project returns it."

Added value: +"What to look for, 1 to 200 characters. In content mode every word must appear and \"quoted phrases\" match as written; in selector mode a CSS selector, or an XPath starting with / or (."

Added value: +"A run's id, from start_run or the runId a list_pages answer carries; leave empty for the last finished run."

Added value: +"The project's id, as list_projects or create_project returns it."

Added value: +"true waits for the run to finish (minutes for a large site); false (default) returns as soon as it is queued."

Added value: +"Settings to change, e.g. {\"max_pages\": 200}; keys not given keep their values. Omit to leave them all."

Added value: +"A new name; omit to leave it."

Added value: +"The project's id, as list_projects or create_project returns it."

Previous value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "manual",
+      "hourly",
+      "daily",
+      "weekly"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +"A new schedule; omit to leave it."