From 4dbad3236b0d752f2ec2d57fd325a62da566f855 Mon Sep 17 00:00:00 2001 From: Titus Date: Thu, 19 Nov 2026 11:56:23 +0100 Subject: [PATCH] Changes: an element hidden while a page is read stays out of it; seat_above_sponsor and the request budget as the API document now says A contributor, a guest or the public reader is no longer served the body of an element hidden while its page was being read. The errors snapshot and its section drop the address clause from seat_above_sponsor, and the limits snapshot carries the request budget's new description of what it counts. Co-Authored-By: Claude Opus 5.5 --- contract/error-codes.json | 2 +- contract/limits.json | 4 ++-- src/content/docs/api/errors/index.mdx | 4 ++-- src/content/docs/docs/changelog.md | 1 + src/content/docs/docs/development/api/changes.md | 2 ++ 5 files changed, 8 insertions(+), 5 deletions(-) diff --git a/contract/error-codes.json b/contract/error-codes.json index e553e403..91065982 100644 --- a/contract/error-codes.json +++ b/contract/error-codes.json @@ -62,7 +62,7 @@ "seat_above_sponsor": { "type": "invalid_request", "status": 422, - "summary": "The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while it carries the address it was made for or that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it." + "summary": "The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it." }, "not_a_lens": { "type": "invalid_request", diff --git a/contract/limits.json b/contract/limits.json index 4f0ddb3f..9c96fdd8 100644 --- a/contract/limits.json +++ b/contract/limits.json @@ -1,8 +1,8 @@ { "source": "https://www.onlyworlds.com/api/v2/openapi.json: info.x-ow-limits, as served", - "read_at": "2026-10-30", + "read_at": "2026-11-19", "limits": { - "requests_per_minute": {"value":300,"unit":"requests","per":"60 seconds per key or account token","applies_to":"Every /api/v2 route but the health checks, reads and writes together; a /bulk call is one request. Over it: 429 too_many_requests.","where":null}, + "requests_per_minute": {"value":300,"unit":"requests","per":"60 seconds per key or account token","applies_to":"Every route under /api/v2 but the health checks and some of the upload service's own signed reports, reads and writes together; a /bulk call is one request. An OPTIONS request (a browser's preflight) is not counted. The request budget is also spent by a request to the MCP server at /mcp, by a request to the metadata routes (/api/metadata/, /api/worldapi/metadata/) that names a world in ?world= and sends no API-Key, when it carries a Bearer token or keyless reading is switched on, and by requests to some of the site's own pages. Over it: 429 too_many_requests.","where":null}, "requests_per_minute_keyless": {"value":60,"unit":"requests","per":"60 seconds per address","applies_to":"A request with no key and no account token.","where":null}, "changes_head_free_per_minute": {"value":120,"unit":"requests","per":"60 seconds per key or account token","applies_to":"GET /changes?head=true answered 304: given back to the request budget, up to this many.","where":null}, "server_busy_slots": {"value":6,"unit":"requests","per":"server process","applies_to":"Requests in flight at once on every route but the health checks; one past them waits for a slot.","where":null}, diff --git a/src/content/docs/api/errors/index.mdx b/src/content/docs/api/errors/index.mdx index 3d20aebf..0ecc1126 100644 --- a/src/content/docs/api/errors/index.mdx +++ b/src/content/docs/api/errors/index.mdx @@ -65,7 +65,7 @@ Each code belongs to one family, its `type`, and a family's codes do not share o | [`player_role_fixed`](#player_role_fixed) | `invalid_request` | `422` | The owner tried to change a player seat's role: a player (no account) reads as a guest, and that role can't be changed. Remove the player instead. | | [`character_hidden`](#character_hidden) | `invalid_request` | `422` | The owner tried to set a hidden Character as the one a seat or a player plays (`param` character): a played Character is on every reader's roster, so a hidden one can never be picked. Unhide it first, or pick another. | | [`seat_follows_sponsor`](#seat_follows_sponsor) | `invalid_request` | `422` | The owner tried to set the Character of an AI seat its member made to play their own (`param` character): it plays what that member plays, and may change it only while they may. Hand the seat to yourself first (`sponsor` owner), then pick. | -| [`seat_above_sponsor`](#seat_above_sponsor) | `invalid_request` | `422` | The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while it carries the address it was made for or that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it. | +| [`seat_above_sponsor`](#seat_above_sponsor) | `invalid_request` | `422` | The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it. | | [`not_a_lens`](#not_a_lens) | `invalid_request` | `422` | A seat chose a Construct that is no lens (`param` lenses): a lens is a Construct with supertype Lens (the lens profile, profiles/lens.md). | | [`lens_is_template`](#lens_is_template) | `invalid_request` | `422` | A seat chose a template (`param` lenses): a lens with subtype Template reads nothing until it is copied and pointed. Choose a lens with anchors. | | [`lens_hidden`](#lens_hidden) | `invalid_request` | `422` | A seat chose a hidden lens (`param` lenses): a seat's lenses are on the members list every reader of the world reads, so a hidden one can never be chosen. Unhide it first. | @@ -329,7 +329,7 @@ The owner tried to set the Character of an AI seat its member made to play their **Type** `invalid_request` ยท **Status** `422` -The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while it carries the address it was made for or that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it. +The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it. - **How to fix:** send `sponsor` `owner` with the `role`, in one request or before it; the sponsor is set first. To keep the seat with its person, raise that person's role instead. See [No AI above its person](/docs/development/agents#the-human-sponsor). diff --git a/src/content/docs/docs/changelog.md b/src/content/docs/docs/changelog.md index 7c6345eb..be400877 100644 --- a/src/content/docs/docs/changelog.md +++ b/src/content/docs/docs/changelog.md @@ -9,6 +9,7 @@ What changed on onlyworlds.com for everyone is on its own [Changelog](https://ww ## 2026-11-19 +- **[Changes](/docs/development/api/changes#the-feed): an element hidden while a page is read stays out of it.** A contributor, a guest or the public reader is no longer served the body of an element hidden while its page was being read. The [errors page](/api/errors/#seat_above_sponsor)'s `seat_above_sponsor` no longer mentions a seat made for an address, and the [limits](/docs/development/api-reference#limits) snapshot carries the request budget's new description of what it counts. - **[Changes](/docs/development/api/changes#the-feed): a page's `head` is read before the page.** A page now holds only the changes up to the world's change sequence as it began to be read, and its `head` is that number, so a write made while a page was being read is never skipped: it comes on a later read from the page's cursor. An element deleted while a page is read is left out of it, with its `delete` on this page or later, where such a page could answer `500` before. - **[Limits](/docs/development/api-reference#limits): what the request budget does not count.** A browser's `OPTIONS` preflight is never counted, and a read of the Classic API's metadata routes with an account token is counted, as one with no key is. diff --git a/src/content/docs/docs/development/api/changes.md b/src/content/docs/docs/development/api/changes.md index aa3f88f2..301807c7 100644 --- a/src/content/docs/docs/development/api/changes.md +++ b/src/content/docs/docs/development/api/changes.md @@ -40,6 +40,8 @@ An `upsert` carries the whole element at its latest state, in the same body a [r An element deleted while a page is being read is left out of that page, and its `delete` comes on this page or later in the feed from the cursor the page gives (since 2026-11-19; before, such a page could answer `500`). +An element hidden while a page is being read is not served on that page to a reader the hidden mark keeps it from: a contributor, a guest or the public reader (since 2026-11-19; before, such a page could carry the body of an element hidden a moment earlier). What that reader learns of the hide comes later in the feed, as [Full export](#full-export) and [Guests' cursors](#guests-cursors) describe; a contributor may miss its own creation on that page, and gets it back at the hide's row on its next read. + ## Walking the feed Pass the returned `cursor` back as `?since=` until `has_more` is `false`. Store the last cursor; next time, start from it.