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.