@onlyworlds/sdk 4.80.0 → 4.81.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # For AI agents using @onlyworlds/sdk
2
2
 
3
- **Current as of**: SDK **4.x** · schema-dist **v0.33.0-dist.73** (canonical 00.33.00).
3
+ **Current as of**: SDK **4.x** · schema-dist **v0.33.0-dist.74** (canonical 00.33.00).
4
4
  This line is asserted by `codegen:check` in CI — if the pin moves and this file is not
5
5
  re-read against it, the check fails rather than letting this document rot quietly.
6
6
 
package/CHANGELOG.md CHANGED
@@ -5,6 +5,18 @@ earlier history lives in git log only.
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [4.81.1] - 2026-10-26
9
+
10
+ ### Changed
11
+
12
+ - **Schema repinned to schema-dist `v0.33.0-dist.74`** (from dist.73; the same canonical 00.33.00, so `ONLYWORLDS_VERSION` stays `'00.33.00'`, no schema file moved and no generated type changed). Serial 74 is text only: the dist's README ends on a maintainer line, and six profile pages (checks, names, packet, review, room, spine) no longer name people or point inside the project's own tracker. No reader and no fixture changed.
13
+
14
+ ## [4.81.0] - 2026-10-26
15
+
16
+ ### Added
17
+
18
+ - **`isToEveryone(message)`**: true when a message is addressed to every member (its `characters` absent, null or `[]`). A list that names no valid id, or a value that is not a list, is addressed to nobody and false here, though `recipientsOf` gives `[]` for both; this is the one call that tells them apart.
19
+
8
20
  ## [4.80.0] - 2026-10-26
9
21
 
10
22
  ### Added
@@ -77,7 +89,7 @@ earlier history lives in git log only.
77
89
 
78
90
  ### Added
79
91
 
80
- - **A hide's and an unhide's row on `/changes`**: `OwChangeUpsert` names `changed_at`, `changed_by` and `changed_via`, which keel sends only on the upsert row a hide or an unhide gives the readers who still see the element (the owner's keys, a co-builder, the member who made it; keel #682). The body carries `hidden: true` after a hide and no `hidden` after an unhide; the row's `change_seq` is the act's, the element's own stays in `element`. Every other upsert row carries none of the three.
92
+ - **A hide's and an unhide's row on `/changes`**: `OwChangeUpsert` names `changed_at`, `changed_by` and `changed_via`, which keel sends only on the upsert row a hide or an unhide gives the readers who still see the element (the owner's keys, a co-builder, the member who made it). The body carries `hidden: true` after a hide and no `hidden` after an unhide; the row's `change_seq` is the act's, the element's own stays in `element`. Every other upsert row carries none of the three.
81
93
 
82
94
  ## [4.73.0] - 2026-10-25
83
95
 
@@ -101,7 +113,7 @@ earlier history lives in git log only.
101
113
 
102
114
  ### Fixed
103
115
 
104
- - **`OwElementBase.hidden`'s doc comment says what a create does with it.** It said a write ignores the mark. Since keel PR 199 (live 2026-10-23), a create (a POST, a PUT of a new id, a `/bulk` item that creates) carrying `hidden: true` creates the element hidden, from the owner's keys or a co-builder's; any other key gets 403 `hidden_not_allowed` and nothing is created. Every other write still ignores it. The SDK already sent the mark as the element had it; only the words were wrong, in the types an editor shows (`dist/index.d.ts`). (Corrected after release: the entry first said they reach the docs' TypeScript reference, which lists the methods and not this field.)
116
+ - **`OwElementBase.hidden`'s doc comment says what a create does with it.** It said a write ignores the mark. Since 2026-10-23, a create (a POST, a PUT of a new id, a `/bulk` item that creates) carrying `hidden: true` creates the element hidden, from the owner's keys or a co-builder's; any other key gets 403 `hidden_not_allowed` and nothing is created. Every other write still ignores it. The SDK already sent the mark as the element had it; only the words were wrong, in the types an editor shows (`dist/index.d.ts`). (Corrected after release: the entry first said they reach the docs' TypeScript reference, which lists the methods and not this field.)
105
117
  - Tests: `create`, `upsert` and `bulk` send `hidden` as given (it is not on the stripped list); a 403 `hidden_not_allowed` surfaces as `OwApiError.code`.
106
118
 
107
119
  ## [4.72.1] - 2026-10-24
@@ -125,14 +137,14 @@ earlier history lives in git log only.
125
137
 
126
138
  - **`buildAskContext(items, index, { includeProposed, includeHidden, includeRoom })`**, each default false: true sends that kind again. A proposed element sent carries the review profile's label on its first line, `[proposed, not yet reviewed] Name (type)`, where the AI reading the text sees it. An option that is not a boolean is a TypeError, and an unknown key is refused by name (the options fence, `test/options.test.mjs`). Types `OwAskContextOptions` and `OwAskLeftOut`.
127
139
  - **`REVIEW_PROPOSED_LABEL`** (`'proposed, not yet reviewed'`), generated into `types.generated.ts` from rule 1's own sentence in the vendored `profiles/review.md` ("labels each one it keeps **"…"**"); codegen exits 1 if the sentence is missing or occurs twice.
128
- - **`minted_by: string | null` on `OwWorldLink` and `OwCreatedWorldLink`** (keel PR 215): the membership (its id in GET /api/v2/members) of the co-builder who minted the link over POST /api/v2/links; null for a link the owner made. Served by `createWorldLink` and `listWorldLinks`. No client for `/api/v2/links` itself yet.
140
+ - **`minted_by: string | null` on `OwWorldLink` and `OwCreatedWorldLink`**: the membership (its id in GET /api/v2/members) of the co-builder who minted the link over POST /api/v2/links; null for a link the owner made. Served by `createWorldLink` and `listWorldLinks`. No client for `/api/v2/links` itself yet.
129
141
  - Tests: each mark left out by default and listed; `hidden` as §4.8 reads it (`"true"` and 1 out, false and null in); a doubt (`"yes"`, `{}`) treated as proposed and labelled when asked, a cleared `null` settled; each `include*` bringing back its own kind only; the label on the first line; a hidden proposed element counted once, under hidden; a kept element's links to a hidden element and from a room element read without their names; the limits over what remains; the fence and the boolean check. Ten mutants, each red on its own test: no proposed filter, no hidden filter, no room filter, no label, a doubt not proposed, proposed checked before hidden, left-out elements counted toward the total, no link view, no option fence, no boolean check.
130
142
 
131
143
  ## [4.71.0] - 2026-10-24
132
144
 
133
145
  ### Added
134
146
 
135
- - **`nfc(text)`**: Normalization Form C as Unicode 15.1 defines it, built from Unicode's own `UnicodeData-15.1.0.txt` and `CompositionExclusions-15.1.0.txt` (schema-dist serial 57, OW Council #656), never the runtime's. It is the NFC half of OW-18's fold, beside `simpleCaseFold`, exported so a tool that compares names the way a world file does gets the same answer. This export is why the release is a minor, not 4.70.1.
147
+ - **`nfc(text)`**: Normalization Form C as Unicode 15.1 defines it, built from Unicode's own `UnicodeData-15.1.0.txt` and `CompositionExclusions-15.1.0.txt` (schema-dist serial 57), never the runtime's. It is the NFC half of OW-18's fold, beside `simpleCaseFold`, exported so a tool that compares names the way a world file does gets the same answer. This export is why the release is a minor, not 4.70.1.
136
148
 
137
149
  ### Fixed
138
150
 
@@ -147,47 +159,47 @@ earlier history lives in git log only.
147
159
 
148
160
  ### Added
149
161
 
150
- - **`writeWorldFile(files, topDir, { includeHidden: false })`** (folder spec §4.8, Skeld, OW Atlas h20 #11469): a world file is a copy, so an element file carrying the hidden mark travels byte for byte by default, as before. A tool making a file to hand to someone else passes `includeHidden: false`, and every `.json` file directly in a type folder of `elements/` or the legacy `spatial/` whose JSON has a top-level `hidden` (anything but absent, `null` or `false`, so `"true"` and `1` count, as the Python package's `is_hidden`) is left out whole. A file there that is not UTF-8 JSON, or not an object, is kept. Nothing else is rewritten: a visible element's link to a hidden one keeps its id. The two defaults differ on purpose: private records out unless asked, hidden kept unless the write is a share.
162
+ - **`writeWorldFile(files, topDir, { includeHidden: false })`** (folder spec §4.8, Skeld, 2026-10-23): a world file is a copy, so an element file carrying the hidden mark travels byte for byte by default, as before. A tool making a file to hand to someone else passes `includeHidden: false`, and every `.json` file directly in a type folder of `elements/` or the legacy `spatial/` whose JSON has a top-level `hidden` (anything but absent, `null` or `false`, so `"true"` and `1` count, as the Python package's `is_hidden`) is left out whole. A file there that is not UTF-8 JSON, or not an object, is kept. Nothing else is rewritten: a visible element's link to a hidden one keeps its id. The two defaults differ on purpose: private records out unless asked, hidden kept unless the write is a share.
151
163
  - **`report: (r: OwWriteWorldFileReport) => void`**, a `writeWorldFile` option: called once with `{ hiddenLeftOut }` after the archive is made and before it is returned, never on a refusal. The return stays the bytes. An `includeHidden` that is not a boolean, or a `report` that is not a function, is a `TypeError` before anything is written; both keys join the options fence.
152
164
 
153
165
  ### Fixed
154
166
 
155
- - **`draught`'s doc comment names `compact`** (4.69.0, keel #585), so the docs' generated reference row carries it.
167
+ - **`draught`'s doc comment names `compact`** (4.69.0), so the docs' generated reference row carries it.
156
168
  - Tests: a hidden element file byte-identical by default and with `includeHidden: true`, the report 0; left out as a share, the report 1, every other file byte-identical; the legacy layout, `.JSON`, and a doubtful mark left out; not JSON, not UTF-8, not an object, a null or nested mark, a deeper file, a non-JSON file and the other parts kept; the same bytes for the same files either way; the report not called on a refusal; the fence. Watched failing with the leave-out turned into a keep (3 tests red), restored. The 85-case `.owworld` set unchanged.
157
169
 
158
170
  ## [4.69.0] - 2026-10-23
159
171
 
160
172
  ### Added
161
173
 
162
- - **`draught(id, { compact: true })`** (keel #585, PR 198): the draught without its empty sections. Every empty array or object section and an empty `cut` are left out. The frame (`world`, `calendar`, `as_of`, `now`, `mode`, `policy`) and every null stay, so a null is still an answer: `character` null means she is hidden from this reader, `style` null that she has no style element, `recent_cursor` null that the read had no `since`. An absent section means nothing in it, never that it was not read (`policy.components` says what was). The answer is typed `OwDraughtCompact` (`cut` optional); without `compact`, or with `compact: false`, it is `OwDraught` as before, the fixed shape. A `compact` that is not a boolean is a TypeError before anything is sent. MCP's `get_draught` defaults to compact; this route defaults to the fixed shape.
174
+ - **`draught(id, { compact: true })`**: the draught without its empty sections. Every empty array or object section and an empty `cut` are left out. The frame (`world`, `calendar`, `as_of`, `now`, `mode`, `policy`) and every null stay, so a null is still an answer: `character` null means she is hidden from this reader, `style` null that she has no style element, `recent_cursor` null that the read had no `since`. An absent section means nothing in it, never that it was not read (`policy.components` says what was). The answer is typed `OwDraughtCompact` (`cut` optional); without `compact`, or with `compact: false`, it is `OwDraught` as before, the fixed shape. A `compact` that is not a boolean is a TypeError before anything is sent. MCP's `get_draught` defaults to compact; this route defaults to the fixed shape.
163
175
 
164
176
  ## [4.68.0] - 2026-10-23
165
177
 
166
178
  ### Fixed
167
179
 
168
- - **`patchWorld` strips `counts`**, which a keyless `GET /world` carries (keel #421 PR 4, the public reader on since 2026-10-23) and `PATCH` answers as an unknown key, so the body of a keyless read goes back too. Quillon's port found it (h29 #11241); the Python package's live wire test went red on the same key the same hour.
169
- - **`reviewNewElement` refuses a reason with an accept** before sending (keel takes `{ decision: 'accept' }` alone; a reason was its 422), and **checks its answer**: an accept that answers no `element`, or a decline no `deleted`, is a `TypeError` naming the route. Both as the Python package does (Quillon, h29 #11241).
180
+ - **`patchWorld` strips `counts`**, which a keyless `GET /world` carries (the public reader, on since 2026-10-23) and `PATCH` answers as an unknown key, so the body of a keyless read goes back too. Quillon's port found it (2026-10-23); the Python package's live wire test went red on the same key the same hour.
181
+ - **`reviewNewElement` refuses a reason with an accept** before sending (keel takes `{ decision: 'accept' }` alone; a reason was its 422), and **checks its answer**: an accept that answers no `element`, or a decline no `deleted`, is a `TypeError` naming the route. Both as the Python package does (Quillon, 2026-10-23).
170
182
 
171
183
  ## [4.67.0] - 2026-10-23
172
184
 
173
185
  ### Added
174
186
 
175
- - **The draught's `room` and `proposed` components**: `OwDraughtComponent` is now keel's thirteen, in its order. `room` (keel #556) is the room profile's other elements that reach her (a board entry, a spec, a heart, a vote, a sitting, a member card, a work item that is not open or taken), each there or nowhere; the type missed it since keel shipped it. `proposed` (keel #580, live 2026-10-23) is every element carrying `x_review_proposed` that reaches her, there or nowhere, whatever section would have held it; `cut.proposed` counts the ones left out, the component unnamed or its budget spent, so a tool handing a draught on can say so. Both are off unless named, as `messages` is: `draught(id, { components: [..., 'room', 'proposed'] })`. `OwDraught.room` and `OwDraught.proposed` are typed.
187
+ - **The draught's `room` and `proposed` components**: `OwDraughtComponent` is now keel's thirteen, in its order. `room` is the room profile's other elements that reach her (a board entry, a spec, a heart, a vote, a sitting, a member card, a work item that is not open or taken), each there or nowhere; the type missed it since keel shipped it. `proposed` (live 2026-10-23) is every element carrying `x_review_proposed` that reaches her, there or nowhere, whatever section would have held it; `cut.proposed` counts the ones left out, the component unnamed or its budget spent, so a tool handing a draught on can say so. Both are off unless named, as `messages` is: `draught(id, { components: [..., 'room', 'proposed'] })`. `OwDraught.room` and `OwDraught.proposed` are typed.
176
188
 
177
189
  ### Fixed
178
190
 
179
- - **`OwDraughtItem` nests the element**: keel has served each draught row as `{ via, circles?, her_links, grade, dated?, element }` since the route shipped (keel PR 155), and the type spread the element's fields onto the row instead. Read `row.element.name`, not `row.name` (which was `undefined` at runtime all along); TypeScript code that read the spread form now fails to compile where it was already wrong. In the same way `OwDraught.character` is `{ self, grade, element }`, and optional (absent unless `self` is served), `work` rows carry `packet` (the work item's `x_packet_elements`), `messages` rows carry `author` (`membership`, `kind`, `role`), and rows may carry `circles`. Read from keel's `elements/draught.py` and its OpenAPI `Draught` schema; nothing at runtime changed.
191
+ - **`OwDraughtItem` nests the element**: keel has served each draught row as `{ via, circles?, her_links, grade, dated?, element }` since the route shipped, and the type spread the element's fields onto the row instead. Read `row.element.name`, not `row.name` (which was `undefined` at runtime all along); TypeScript code that read the spread form now fails to compile where it was already wrong. In the same way `OwDraught.character` is `{ self, grade, element }`, and optional (absent unless `self` is served), `work` rows carry `packet` (the work item's `x_packet_elements`), `messages` rows carry `author` (`membership`, `kind`, `role`), and rows may carry `circles`. Read from keel's `elements/draught.py` and its OpenAPI `Draught` schema; nothing at runtime changed.
180
192
  - Tests: `components: ['room', 'proposed']` is sent as `components=room,proposed`; the published `OwDraughtComponent` lists keel's COMPONENTS in order; the nested rows, `cut.proposed`, `character.element`, `packet`, `author` and `circles` compile against the built `.d.ts`, and a spread read and an unknown component do not. Watched failing with `'proposed'` cut from the type.
181
193
 
182
194
  ## [4.66.0] - 2026-10-23
183
195
 
184
196
  ### Added
185
197
 
186
- - **`createAccountWorld({ name, pin?, keyName?, source?, producer? })`** (account token): `POST /account/worlds` makes a world on the account with its one write key. Sent in keel's spelling, only the keys given (`keyName` as `key_name`, keel #363: 1 to 80 characters, trimmed, `null` for none; `source` and `producer`, keel #571: the folder format's provenance lines, each an object or `null`, kept on the World and served by `getWorld()` as `origin`). `pin` only while the account has no PIN (it becomes the account PIN); an account with one must leave it out. Either mistake is a 422 with `err.param === 'pin'` and nothing made, so a tool that cannot tell which account it holds sends without `pin` first and again with it on that 422, as Atlas's Make online does. Returns `OwCreatedAccountWorld`: the world's row as `listAccountWorlds` lists it, plus the full write key once in `key`. No Idempotency-Key (the document declares none), and neither `X-OW-Agent` nor `X-OW-Client` (it declares neither here). keel's document gives the 201 no schema, so the type is read from keel's handler. A world key is a `TypeError`, as is an unknown option or a missing `name`, before anything is sent. Atlas can retire its own `AccountClient.createWorld` for it.
187
- - **The world's queue lists new elements written as proposed** (keel #565, live 2026-10-23): `worldProposals()` now returns `OwWorldProposalList`, whose rows are `OwWorldProposalRow`, told apart by `kind`: `OwProposal` (`kind: 'proposal'`) or `OwProposedNewElement` (`kind: 'new_element'`: an element carrying `x_review_proposed`, its `by`, `evidence` and `expires` the mark's words, `state` `open` or `lapsed`). One order, newest first by `created_at`; the cursor is opaque and goes back as it came (an old bare proposal id still reads). `listProposals` keeps `OwProposalList`: one element's proposals only.
198
+ - **`createAccountWorld({ name, pin?, keyName?, source?, producer? })`** (account token): `POST /account/worlds` makes a world on the account with its one write key. Sent in keel's spelling, only the keys given (`keyName` as `key_name`: 1 to 80 characters, trimmed, `null` for none; `source` and `producer`: the folder format's provenance lines, each an object or `null`, kept on the World and served by `getWorld()` as `origin`). `pin` only while the account has no PIN (it becomes the account PIN); an account with one must leave it out. Either mistake is a 422 with `err.param === 'pin'` and nothing made, so a tool that cannot tell which account it holds sends without `pin` first and again with it on that 422, as Atlas's Make online does. Returns `OwCreatedAccountWorld`: the world's row as `listAccountWorlds` lists it, plus the full write key once in `key`. No Idempotency-Key (the document declares none), and neither `X-OW-Agent` nor `X-OW-Client` (it declares neither here). keel's document gives the 201 no schema, so the type is read from keel's handler. A world key is a `TypeError`, as is an unknown option or a missing `name`, before anything is sent. Atlas can retire its own `AccountClient.createWorld` for it.
199
+ - **The world's queue lists new elements written as proposed** (live 2026-10-23): `worldProposals()` now returns `OwWorldProposalList`, whose rows are `OwWorldProposalRow`, told apart by `kind`: `OwProposal` (`kind: 'proposal'`) or `OwProposedNewElement` (`kind: 'new_element'`: an element carrying `x_review_proposed`, its `by`, `evidence` and `expires` the mark's words, `state` `open` or `lapsed`). One order, newest first by `created_at`; the cursor is opaque and goes back as it came (an old bare proposal id still reads). `listProposals` keeps `OwProposalList`: one element's proposals only.
188
200
  - **`reviewNewElement(type, id, { decision, reason? })`**: `POST /{type}/{id}/review`, a keeper (the owner or a co-builder, with the PIN) settles a new element written as proposed. `accept` clears the mark and returns `{ element }`; `decline` deletes the element and returns `{ deleted }` (its id); the reason is answered back and kept nowhere. Sends `X-OW-Client`, as the document lists, and no `X-OW-Agent`. A `decision` other than `accept` or `decline`, or an unknown key, is a `TypeError` before sending. Type `OwReviewed`, options `OwReviewInput`.
189
201
  - **`err.isNotProposed`**: 422 `not_proposed`, the element carries no mark to settle. `isProposedOnly` (403) also answers the seat the mark names.
190
- - **`OwProposal.kind`** (`'proposal'`) and **`OwProposal.omitted`** (keel #565): a row's `fields` now holds only what differs from the element when proposed, and `omitted` names the fields an upsert left out that were not empty (each in `fields` at its empty value, so an accept empties it; `[]` for a patch, a link edit or `propose`). A propose with nothing new is a 422 with `param: 'fields'`; a seat's write that changes nothing under the world's switch answers 200 with the element and makes no row.
202
+ - **`OwProposal.kind`** (`'proposal'`) and **`OwProposal.omitted`**: a row's `fields` now holds only what differs from the element when proposed, and `omitted` names the fields an upsert left out that were not empty (each in `fields` at its empty value, so an accept empties it; `[]` for a patch, a link edit or `propose`). A propose with nothing new is a 422 with `param: 'fields'`; a seat's write that changes nothing under the world's switch answers 200 with the element and makes no row.
191
203
 
192
204
  ### Changed
193
205
 
@@ -198,7 +210,7 @@ earlier history lives in git log only.
198
210
 
199
211
  ### Fixed
200
212
 
201
- - **`patchWorld` takes a `getWorld()` body back again** (keel #571, live 2026-10-23). keel's `GET /world` now serves `origin`, and a PATCH naming it is a 422 (an unknown key), so a world body read and sent back failed. `patchWorld` now leaves out `origin`, and `id` too: keel answers `id` with the same 422 (it is not a key PATCH takes), so the round trip 4.57.1's entry promised never held for a whole body. `owner_character` is still sent.
213
+ - **`patchWorld` takes a `getWorld()` body back again** (live 2026-10-23). keel's `GET /world` now serves `origin`, and a PATCH naming it is a 422 (an unknown key), so a world body read and sent back failed. `patchWorld` now leaves out `origin`, and `id` too: keel answers `id` with the same 422 (it is not a key PATCH takes), so the round trip 4.57.1's entry promised never held for a whole body. `owner_character` is still sent.
202
214
 
203
215
  ### Added
204
216
 
@@ -229,7 +241,7 @@ earlier history lives in git log only.
229
241
 
230
242
  ### Added
231
243
 
232
- - **`typeWord(world, type, { supertype, many })`**, the names profile's reader (schema-dist `profiles/names.md`, OW Council #567): a world's own word for a type, from `x_names` on the World (a `getWorld()` body, keel serving `x_` keys on the World from Keel #571, or a folder's `world.json`). The supertype's entry first, matched trimmed and without regard to case (the room profile's one definition, shared with `isRoomElement`), then the type's entry, else `null`: print the standard's name. `many: true` gives the plural, `one` when the pair has none. A value that is not a names map is `null` everywhere; a bad entry or an unknown slug is ignored. The options object refuses an unknown key with a `TypeError`. Types `OwNamesMap` and `OwWordPair`. Display only: the API, the folder, the schema and every id keep the standard's names.
244
+ - **`typeWord(world, type, { supertype, many })`**, the names profile's reader (schema-dist `profiles/names.md`): a world's own word for a type, from `x_names` on the World (a `getWorld()` body, keel serving `x_` keys on the World, or a folder's `world.json`). The supertype's entry first, matched trimmed and without regard to case (the room profile's one definition, shared with `isRoomElement`), then the type's entry, else `null`: print the standard's name. `many: true` gives the plural, `one` when the pair has none. A value that is not a names map is `null` everywhere; a bad entry or an unknown slug is ignored. The options object refuses an unknown key with a `TypeError`. Types `OwNamesMap` and `OwWordPair`. Display only: the API, the folder, the schema and every id keep the standard's names.
233
245
  - Tests: the profile's 23-case fixture, read from the vendored distribution, as its own test; no world, no map and an unknown option.
234
246
 
235
247
  ### Changed
@@ -240,41 +252,41 @@ earlier history lives in git log only.
240
252
 
241
253
  ### Added
242
254
 
243
- - **`delete(type, id, { ifMatch })`** (keel #563, PR 183, live 2026-10-22 21:3x): `DELETE` reads `If-Match` exactly as `PATCH` does. With the element's `change_seq` as you read it, a delete of an element someone changed since is refused, `OwPreconditionFailedError` (412) with `current`, nothing deleted; on an element already gone it is the idempotent 204. Under a world's proposals switch a delete is never a proposal. The options object refuses an unknown key like every other.
255
+ - **`delete(type, id, { ifMatch })`** (live 2026-10-22 21:3x): `DELETE` reads `If-Match` exactly as `PATCH` does. With the element's `change_seq` as you read it, a delete of an element someone changed since is refused, `OwPreconditionFailedError` (412) with `current`, nothing deleted; on an element already gone it is the idempotent 204. Under a world's proposals switch a delete is never a proposal. The options object refuses an unknown key like every other.
244
256
  - Tests: the header sent and left out, the unknown option, the 412; each watched failing with the header dropped. The wire gate now reads from keel's document which Character operations take `If-Match` (it held a hand list of two and missed this one) and fails on 4.60.0.
245
257
 
246
258
  ## [4.60.0] - 2026-10-22
247
259
 
248
260
  ### Added
249
261
 
250
- - **`OwFrontDoor`, and `front_door` on `OwMe` and `OwAgentJoined`** (keel #558, D152, live 2026-10-22 20:1x). `me()`, `setMyCharacter()` and an agent's `redeemJoin()` answer carry the world's front door for the key: `sponsor` (`{id, kind, name}` of the person who answers for a seat, or null), `sponsor_character`, `my_character`, `charter` (the world's Charter, every member's to read: read it first) and `charter_skill` (up to five Objects the Charter names). Every id is one the key may read; anything hidden is null or left out. Types only: the client already passed the body through. Required on both types, as keel's document declares it; a hand-built `OwMe` in a consumer's test needs the field.
262
+ - **`OwFrontDoor`, and `front_door` on `OwMe` and `OwAgentJoined`** (live 2026-10-22 20:1x). `me()`, `setMyCharacter()` and an agent's `redeemJoin()` answer carry the world's front door for the key: `sponsor` (`{id, kind, name}` of the person who answers for a seat, or null), `sponsor_character`, `my_character`, `charter` (the world's Charter, every member's to read: read it first) and `charter_skill` (up to five Objects the Charter names). Every id is one the key may read; anything hidden is null or left out. Types only: the client already passed the body through. Required on both types, as keel's document declares it; a hand-built `OwMe` in a consumer's test needs the field.
251
263
 
252
264
  ## [4.59.0] - 2026-10-22
253
265
 
254
266
  ### Changed
255
267
 
256
- - **`API-Pin` is sent only where keel checks it** (Skeld's ruling, OW Keel h29 #10663). keel verifies a PIN wherever one is sent (argon2, 64 MiB each), and on 2026-10-22 scripts reading with the PIN OOM-killed staging on a cold cache after a restart. The client used to send a configured `apiPin` on every request. It now sends it on every request whose method is not GET (every write: elements, links, bulk, adopt, hide and unhide, media and file tickets, seats, world links, proposals, `setMyCharacter`, `mintWorldKey`, `patchWorld`, and any route added later), on `GET /me` (`me()`, the connection test: keel checks a PIN there when sent, keel #314, D93), and on every request of a 10-digit legacy key (v1 parity, keel #421: such a key needs the PIN on reads of a world with a PIN). Any other read from an `ow_w_`, `ow_r_` or member key goes without it; an account token never sent it and still does not. The rule is derived in `request()` from the method and path, so a raw `request()` call follows it too. No API changed.
268
+ - **`API-Pin` is sent only where keel checks it** (Skeld's ruling, 2026-10-22). keel verifies a PIN wherever one is sent (argon2, 64 MiB each), and on 2026-10-22 scripts reading with the PIN OOM-killed staging on a cold cache after a restart. The client used to send a configured `apiPin` on every request. It now sends it on every request whose method is not GET (every write: elements, links, bulk, adopt, hide and unhide, media and file tickets, seats, world links, proposals, `setMyCharacter`, `mintWorldKey`, `patchWorld`, and any route added later), on `GET /me` (`me()`, the connection test: keel checks a PIN there when sent), and on every request of a 10-digit legacy key (v1 parity: such a key needs the PIN on reads of a world with a PIN). Any other read from an `ow_w_`, `ow_r_` or member key goes without it; an account token never sent it and still does not. The rule is derived in `request()` from the method and path, so a raw `request()` call follows it too. No API changed.
257
269
  - Tests: `test/api-pin.test.mjs`, five, on a recorded fetch: eight reads, `me()` and ten writes across POST, PATCH, PUT and DELETE, for an `ow_w_` key with a PIN, a legacy key with a PIN, an `ow_r_` key with none and an account token with one configured; and raw `request()` GETs to other paths, `/me` and other methods. Two existing tests that expected the PIN on a GET now expect none. Mutants: the PIN on every request again fails four tests; without the `/me` clause, three; without the legacy clause, one.
258
270
 
259
271
  ## [4.58.0] - 2026-10-22
260
272
 
261
273
  ### Added
262
274
 
263
- - **The proposed change** (keel #519, PR 180, live 2026-10-22 16:25). Six calls: `propose(type, id, { fields, evidence, expires? })` (any member key that reads the element; `fields` cleaned as a PATCH body is; `Idempotency-Key` only when given), `listProposals(type, id, { limit?, cursor? })`, `worldProposals({ state?, since?, element?, limit?, cursor? })` (the queue, newest first; keepers see every row, others their own), `acceptProposal(type, id, pid)` (`{ proposal, element }`: the keeper's own write, one feed row), `declineProposal(type, id, pid, { reason? })` and `withdrawProposal(type, id, pid)` (204). Types `OwProposal`, `OwProposalList`, `OwProposed`, `OwProposalState`, `OwProposalQuery`, `OwWorldProposalQuery`, `OwProposalAccepted`. Every options object refuses an unknown key with a `TypeError` before anything is sent. `X-OW-Client` goes on `propose` and accept, where the document lists it; `X-OW-Agent` on none of them.
275
+ - **The proposed change** (live 2026-10-22 16:25). Six calls: `propose(type, id, { fields, evidence, expires? })` (any member key that reads the element; `fields` cleaned as a PATCH body is; `Idempotency-Key` only when given), `listProposals(type, id, { limit?, cursor? })`, `worldProposals({ state?, since?, element?, limit?, cursor? })` (the queue, newest first; keepers see every row, others their own), `acceptProposal(type, id, pid)` (`{ proposal, element }`: the keeper's own write, one feed row), `declineProposal(type, id, pid, { reason? })` and `withdrawProposal(type, id, pid)` (204). Types `OwProposal`, `OwProposalList`, `OwProposed`, `OwProposalState`, `OwProposalQuery`, `OwWorldProposalQuery`, `OwProposalAccepted`. Every options object refuses an unknown key with a `TypeError` before anything is sent. `X-OW-Client` goes on `propose` and accept, where the document lists it; `X-OW-Agent` on none of them.
264
276
  - **A write held as a proposal is an error, never a body.** Under the world's **AI seats propose, a person accepts** switch an agent seat's `patch`, `upsert` or `editLinks` answers `202`: the client throws `OwProposedError` (`status` 202, `proposal`, `isProposed`) rather than returning something that is not the element; a `202` with no proposal in its body is a plain `OwApiError` 202. A `/bulk` slot with `status: 202` is left in the result as the document shapes it, typed. `create`, `adopt` and `delete` are not read for a 202: the document gives them none.
265
277
  - **Five codes**: `isStaleProposal` (`OwStaleProposalError` with `conflicts: [{ field, base, current }]` and `current`, parsed like the 412), `isOwnProposal`, `isProposedOnly`, `isTooManyOpen`, `isFieldNotVisible`.
266
278
  - **`OwWorldMeta.agent_writes_proposed?: boolean`**, read-only; `patchWorld` strips it with `slug`, `public_page`, `public_read` and `agent_narrator_rule`.
267
- - Tests: 20 on a recorded fetch, 18 red first; two mutants caught. Live on production with the demo key, reads only: `getWorld()` carries `agent_writes_proposed: false`; the queue answers `404` to a read key with no member, as the document says. Not exercised live yet: `propose`, accept, decline, withdraw and the `409` (staging has no #519 at release time; a round-trip script waits for it). Not wired yet: the queue's `ETag`/`If-None-Match` (a conditional `worldProposals`, on the `changesHead` pattern, when a poller asks).
279
+ - Tests: 20 on a recorded fetch, 18 red first; two mutants caught. Live on production with the demo key, reads only: `getWorld()` carries `agent_writes_proposed: false`; the queue answers `404` to a read key with no member, as the document says. Not exercised live yet: `propose`, accept, decline, withdraw and the `409` (staging does not serve the proposed change at release time; a round-trip script waits for it). Not wired yet: the queue's `ETag`/`If-None-Match` (a conditional `worldProposals`, on the `changesHead` pattern, when a poller asks).
268
280
 
269
281
  ## [4.57.2] - 2026-10-22
270
282
 
271
283
  ### Changed
272
284
 
273
- - **Schema repinned to schema-dist `v0.33.0-dist.47`** (same canonical 00.33.00; no schema file moved, no generated type changed). The distribution gains `profiles/checks.md` and `profiles/checks.fixture.json`, the checks profile: a work world's Charter carries its house rules as `x_checks_rules`, beside the sentences a person reads (OW Council #559). `profiles/room.md` now defines "trimmed and without regard to case" once, for every profile that folds like the room's pairs: trimmed is leading and trailing whitespace removed, nothing inside touched; without regard to case is the trimmed value after simple case folding.
285
+ - **Schema repinned to schema-dist `v0.33.0-dist.47`** (same canonical 00.33.00; no schema file moved, no generated type changed). The distribution gains `profiles/checks.md` and `profiles/checks.fixture.json`, the checks profile: a work world's Charter carries its house rules as `x_checks_rules`, beside the sentences a person reads. `profiles/room.md` now defines "trimmed and without regard to case" once, for every profile that folds like the room's pairs: trimmed is leading and trailing whitespace removed, nothing inside touched; without regard to case is the trimmed value after simple case folding.
274
286
 
275
287
  ### Fixed
276
288
 
277
- - **`isRoomElement` trims Unicode White_Space exactly**, the 25 code points of the property, at both ends of the type and the supertype. It used JavaScript's `trim()`, which also strips U+FEFF, a byte order mark. Skeld's ruling (OW Parlor h66 #10415) is that a byte order mark stays, so a supertype `"\uFEFFMessage"` is no longer a room element; `" Message\u3000"` still is, and a leading U+200B (zero width space, not White_Space) still is not. The room fixture's 23 cases answer as before.
289
+ - **`isRoomElement` trims Unicode White_Space exactly**, the 25 code points of the property, at both ends of the type and the supertype. It used JavaScript's `trim()`, which also strips U+FEFF, a byte order mark. Skeld's ruling (2026-10-22) is that a byte order mark stays, so a supertype `"\uFEFFMessage"` is no longer a room element; `" Message\u3000"` still is, and a leading U+200B (zero width space, not White_Space) still is not. The room fixture's 23 cases answer as before.
278
290
 
279
291
  ## [4.57.1] - 2026-10-22
280
292
 
@@ -286,8 +298,8 @@ earlier history lives in git log only.
286
298
 
287
299
  ### Added
288
300
 
289
- - **The conditional head poll** (keel #518, live 2026-10-22; Orrery's `revision-poll.md`, decision 3): `changesHead()` keeps the last head read's `ETag` per client and sends it back as `If-None-Match` on the next one, exactly as received (keel's 200 sends a weak `W/"821:-"`; nothing is quoted, parsed or compared). keel's tag is `"<head>:<epoch>"`, so a view change moves it as a new change does. When nothing moved, keel answers 304 Not Modified with no body, and `changesHead()` returns the `head`, `cursor` and `epoch` of the last 200 with `unchanged: true`; every 200 says `unchanged: false`. keel refunds a 304 against the request budget, so a poll that mostly finds nothing costs little. A 409 `resync_required` from `changesHead()`, `changes()` or `changesAll()` clears the held tag, so the next head read is a full 200 with `epoch_reason`. A 304 while no tag is held is an `OwApiError` with status 304, never a made-up head. The client still never polls or sleeps on its own: the interval is the caller's.
290
- - **The public page on `OwWorldMeta`** (keel #471, PR 173, live 2026-10-22), both read-only: `slug` (`string | null`), the page's address, onlyworlds.com/w/<slug>, null while the page is off, and also a keyless `?world=` value; `public_page` (the new `OwWorldPublicPage`), the page as its owner set it: `on`, `palette` (midnight, daylight, parchment, brass, dusk, or null for the house's), `hero` (one plain line), `sections` (the types shown in order, empty for all), `pin` (an element id or null) and `index` (always false for now), every key present with the page off. Both are set by the owner on the world page; `patchWorld()` strips them, so a body read from `getWorld()` stays writable.
301
+ - **The conditional head poll** (live 2026-10-22): `changesHead()` keeps the last head read's `ETag` per client and sends it back as `If-None-Match` on the next one, exactly as received (keel's 200 sends a weak `W/"821:-"`; nothing is quoted, parsed or compared). keel's tag is `"<head>:<epoch>"`, so a view change moves it as a new change does. When nothing moved, keel answers 304 Not Modified with no body, and `changesHead()` returns the `head`, `cursor` and `epoch` of the last 200 with `unchanged: true`; every 200 says `unchanged: false`. keel refunds a 304 against the request budget, so a poll that mostly finds nothing costs little. A 409 `resync_required` from `changesHead()`, `changes()` or `changesAll()` clears the held tag, so the next head read is a full 200 with `epoch_reason`. A 304 while no tag is held is an `OwApiError` with status 304, never a made-up head. The client still never polls or sleeps on its own: the interval is the caller's.
302
+ - **The public page on `OwWorldMeta`** (live 2026-10-22), both read-only: `slug` (`string | null`), the page's address, onlyworlds.com/w/<slug>, null while the page is off, and also a keyless `?world=` value; `public_page` (the new `OwWorldPublicPage`), the page as its owner set it: `on`, `palette` (midnight, daylight, parchment, brass, dusk, or null for the house's), `hero` (one plain line), `sections` (the types shown in order, empty for all), `pin` (an element id or null) and `index` (always false for now), every key present with the page off. Both are set by the owner on the world page; `patchWorld()` strips them, so a body read from `getWorld()` stays writable.
291
303
  - **`request()` gains two options**: `ifNoneMatch` (a tag sent as `If-None-Match` as given) and `onEtag(etag, status)` (called with each response's `ETag` and status before the body is read; with it given, a 304 returns null instead of throwing). Every other path is unchanged.
292
304
 
293
305
  ### Changed
@@ -298,7 +310,7 @@ earlier history lives in git log only.
298
310
 
299
311
  ### Added
300
312
 
301
- - **The client's name** (keel #520, live 2026-10-22; Orrery's `client-name.md`, decision 2): a constructor option `client`, default `'sdk'`, sent as `X-OW-Client` on every element write (`create`, `upsert`, `patch`, `delete`, `editLinks`, `bulk`, `adopt`) and on no read. keel stores it on the element as `changed_client`, so a reader can tell which tool made the last change (`new OwV2Client({ ..., client: 'atlas' })`). The rule is keel's, exact here: lower case letters, digits and hyphens, 1 to 32 characters (`[a-z0-9-]{1,32}`). Anything else, a capital, a space, an empty string, 33 characters or a value that is not a string, is a TypeError at construction naming the option and the rule, and nothing is trimmed; keel's own fence for a stranger's header is to store null, never a 422. The name is the client's claim about itself, never proof; it changes no door and no permission, and `agent` still decides `X-OW-Agent`.
313
+ - **The client's name** (live 2026-10-22): a constructor option `client`, default `'sdk'`, sent as `X-OW-Client` on every element write (`create`, `upsert`, `patch`, `delete`, `editLinks`, `bulk`, `adopt`) and on no read. keel stores it on the element as `changed_client`, so a reader can tell which tool made the last change (`new OwV2Client({ ..., client: 'atlas' })`). The rule is keel's, exact here: lower case letters, digits and hyphens, 1 to 32 characters (`[a-z0-9-]{1,32}`). Anything else, a capital, a space, an empty string, 33 characters or a value that is not a string, is a TypeError at construction naming the option and the rule, and nothing is trimmed; keel's own fence for a stranger's header is to store null, never a 422. The name is the client's claim about itself, never proof; it changes no door and no permission, and `agent` still decides `X-OW-Agent`.
302
314
  - **`changed_client`** on `OwElementBase` (`string | null`, server-managed, read-only, beside `changed_by` and `changed_via`): the name the last write gave, null when it gave none or one outside the rule, for keel's own writes, and for changes from before names were recorded. Sent back in a write it is ignored. **`deleted_client`** on a `/changes` delete (`OwChangeDelete`, beside `deleted_by` and `deleted_via`), the same for the delete; null on a `hidden` row.
303
315
 
304
316
  ### Changed
@@ -310,7 +322,7 @@ earlier history lives in git log only.
310
322
 
311
323
  ### Added
312
324
 
313
- - **The room profile** (schema-dist `profiles/room.md`, serial 45; Skeld's rulings, OW Council #554 and OW Parlor h66 #10392): `ROOM_PAIRS`, the eight type-and-supertype pairs a parlor puts in a world (narrative/Message, narrative/Board, relation/Work item, construct/Spec, relation/Heart, relation/Vote, event/Sitting, character/Member), and `isRoomElement(el)`, true when an element's type and supertype, each trimmed and compared without regard to case, match one of them **and** it carries the mark `x_room_of` (the id of the world or sitting the room belongs to) as a non-empty string. A pair without the mark is lore (a novel's letters are Narratives with supertype Message); a mark without a pair is not a room element. The pair match is the whole word, a missing or empty supertype is never a room element, and a Law with supertype `Charter` stays lore. A lore view leaves room elements out unless the person asks; the room's own views show them whole. A convention on the 22 types: no type, field or wire change. `ROOM_PAIRS` is generated from the fixture's `pairs` and checked at codegen against the page's table (they must agree, or codegen exits 1); the mark's name is generated from the fixture's `mark.field` and checked against the page. Case is folded by Unicode simple case folding (`simpleCaseFold`), the same fold as the Python package's `is_room_element`. A new test replays the fixture's 23 cases from the vendored dist.
325
+ - **The room profile** (schema-dist `profiles/room.md`, serial 45; Skeld's rulings, 2026-10-22): `ROOM_PAIRS`, the eight type-and-supertype pairs a parlor puts in a world (narrative/Message, narrative/Board, relation/Work item, construct/Spec, relation/Heart, relation/Vote, event/Sitting, character/Member), and `isRoomElement(el)`, true when an element's type and supertype, each trimmed and compared without regard to case, match one of them **and** it carries the mark `x_room_of` (the id of the world or sitting the room belongs to) as a non-empty string. A pair without the mark is lore (a novel's letters are Narratives with supertype Message); a mark without a pair is not a room element. The pair match is the whole word, a missing or empty supertype is never a room element, and a Law with supertype `Charter` stays lore. A lore view leaves room elements out unless the person asks; the room's own views show them whole. A convention on the 22 types: no type, field or wire change. `ROOM_PAIRS` is generated from the fixture's `pairs` and checked at codegen against the page's table (they must agree, or codegen exits 1); the mark's name is generated from the fixture's `mark.field` and checked against the page. Case is folded by Unicode simple case folding (`simpleCaseFold`), the same fold as the Python package's `is_room_element`. A new test replays the fixture's 23 cases from the vendored dist.
314
326
 
315
327
  ### Changed
316
328
 
@@ -366,18 +378,18 @@ earlier history lives in git log only.
366
378
 
367
379
  ### Added
368
380
 
369
- - `setMyCharacter(characterId | null)`: `PUT /me/character`, a person member's pick of the roster Character that is them in this world (keel PR 160, #533); answers the `/me` body. `err.isCharacterHidden` for the 422 `character_hidden` it and the member PATCH answer.
370
- - `hidden?: true` on every element body (`OwElementBase`): present only when the owner or a co-builder hid the element and this reader still sees it (keel #537); never on other readers' bodies, ignored in a write.
371
- - `site` joins `OwWriteDoor`: a write or delete the owner made signed in on onlyworlds.com (keel #530).
381
+ - `setMyCharacter(characterId | null)`: `PUT /me/character`, a person member's pick of the roster Character that is them in this world; answers the `/me` body. `err.isCharacterHidden` for the 422 `character_hidden` it and the member PATCH answer.
382
+ - `hidden?: true` on every element body (`OwElementBase`): present only when the owner or a co-builder hid the element and this reader still sees it; never on other readers' bodies, ignored in a write.
383
+ - `site` joins `OwWriteDoor`: a write or delete the owner made signed in on onlyworlds.com.
372
384
 
373
385
  ## [4.49.0] - 2026-10-22
374
386
 
375
387
  ### Changed
376
388
 
377
- - **The world file follows Folder Format §4.7, the `.owworld` archive** (OW Council #522), and gives the spec's verdict and cause on every one of the 74 fixtures in its conformance set (Quillon's, `owworld-fixtures`), plus its three on-demand floor cases.
389
+ - **The world file follows Folder Format §4.7, the `.owworld` archive**, and gives the spec's verdict and cause on every one of the 74 fixtures in its conformance set (Quillon's, `owworld-fixtures`), plus its three on-demand floor cases.
378
390
  - The reader parses the central directory itself (zip64 included) and runs every check on names, kinds, methods and sizes before it inflates anything.
379
391
  - Six new refusal causes join `OwWorldFileReason`: `duplicate` (OW-17), `collision` (OW-18: NFC, then simple case folding), `link` (OW-20), `method` (OW-21), `name` (OW-22) and `marker` (OW-6). A `Record<OwWorldFileReason, …>` in a caller needs the six new keys.
380
- - The OW-18 fold is the C and S rows of Unicode's CaseFolding.txt 15.1, built in as a table, never the runtime's casing, so a fold a newer Unicode adds stays out until the pin moves (Skeld's ruling, OW Council #9830). `simpleCaseFold(text)` exports it.
392
+ - The OW-18 fold is the C and S rows of Unicode's CaseFolding.txt 15.1, built in as a table, never the runtime's casing, so a fold a newer Unicode adds stays out until the pin moves (Skeld's ruling, 2026-10-22). `simpleCaseFold(text)` exports it.
381
393
  - Files beside the world's folder are ignored, no longer `more_than_one` (OW-4). A `world.json` under `records/` is a producer's data, not a second world (OW-5). A spanned archive is `not_openable`. An entry that inflates past the size it declares is `too_big` at any budget (OW-14).
382
394
  - The default budget is the spec's floor: `WORLD_FILE_MAX_BYTES` 2 GiB (was 1 GiB), `WORLD_FILE_MAX_ENTRIES` 500,000 (was 200,000) (OW-15).
383
395
  - A `mimetype` marker is never required. One with other bytes than `WORLD_FILE_MEDIA_TYPE` (`application/vnd.onlyworlds.world+zip`, newly exported) is refused, and the marker is never returned as a file.
@@ -395,50 +407,50 @@ earlier history lives in git log only.
395
407
 
396
408
  ### Added
397
409
 
398
- - `listHidden()`: `GET /world/hidden`, the world's hidden elements newest first as `OwHiddenRow[]` (`type`, `id`, `set_at`, `set_by`; keel #421). Any key of the owner's or a co-builder's; served with `Cache-Control: no-store`, so read it each time. For the parlor, whose host room marks what it hid (Temper, h66 #9778).
410
+ - `listHidden()`: `GET /world/hidden`, the world's hidden elements newest first as `OwHiddenRow[]` (`type`, `id`, `set_at`, `set_by`). Any key of the owner's or a co-builder's; served with `Cache-Control: no-store`, so read it each time. For the parlor, whose host room marks what it hid (Temper, 2026-10-22).
399
411
 
400
412
  ## [4.47.0] - 2026-10-22
401
413
 
402
414
  ### Added
403
- - `draught(characterId, policy)`: `GET /character/{id}/context` (keel PR 155, D143, live 2026-10-22 02:05), one Character's context in one read, typed as `OwDraught` with the policy's seven keys (`components`, `mode`, `asOf`, `undated`, `since`, `budget`, `depth`) as `OwDraughtPolicy`.
415
+ - `draught(characterId, policy)`: `GET /character/{id}/context` (live 2026-10-22 02:05), one Character's context in one read, typed as `OwDraught` with the policy's seven keys (`components`, `mode`, `asOf`, `undated`, `since`, `budget`, `depth`) as `OwDraughtPolicy`.
404
416
  - `list` takes `ids` (1 to 200, the list's own order; one the key cannot see is absent) and `createdBy` (a membership id, or `'owner'`), the two list filters of the same PR; both were already reachable through `filter`.
405
417
 
406
418
  ## [4.46.0] - 2026-10-22
407
419
 
408
420
  ### Added
409
- - **Sign in with OnlyWorlds** (keel PR 154, live 2026-10-22 01:50; the handoff sheet §3): `signInWithOnlyWorlds({ clientId, redirectUri, resume, storage, navigate })` mints `state` and a PKCE S256 verifier, keeps them under the client id in `storage` (sessionStorage by default; required in Node), refuses a `redirectUri` that is not an `https:` string before sending, and sends the browser to `/signin/authorize`. `completeSignIn({ clientId, storage, url })` on the callback page checks `state` and the page, takes `code` and `state` out of the address bar, trades the code once at `POST /api/v2/auth/token` with no credential, and returns `OwSignInResult` (`token`, `account`, `resume`); the record is cleared either way and the SDK keeps no token. `OwSignInError` gains `invalid_grant` and `state_mismatch`. `pkceChallenge` and `base64url` exported.
421
+ - **Sign in with OnlyWorlds** (live 2026-10-22 01:50): `signInWithOnlyWorlds({ clientId, redirectUri, resume, storage, navigate })` mints `state` and a PKCE S256 verifier, keeps them under the client id in `storage` (sessionStorage by default; required in Node), refuses a `redirectUri` that is not an `https:` string before sending, and sends the browser to `/signin/authorize`. `completeSignIn({ clientId, storage, url })` on the callback page checks `state` and the page, takes `code` and `state` out of the address bar, trades the code once at `POST /api/v2/auth/token` with no credential, and returns `OwSignInResult` (`token`, `account`, `resume`); the record is cleared either way and the SDK keeps no token. `OwSignInError` gains `invalid_grant` and `state_mismatch`. `pkceChallenge` and `base64url` exported.
410
422
 
411
423
  ## [4.45.0] - 2026-10-22
412
424
 
413
425
  ### Added
414
- - `hide(type, id)` and `unhide(type, id)`: the hidden mark's writes, `PUT` and `DELETE /{type}/{id}/hidden` (keel #421), for the parlor (Temper, h66 #9720). 204; the element's body and `change_seq` do not move.
426
+ - `hide(type, id)` and `unhide(type, id)`: the hidden mark's writes, `PUT` and `DELETE /{type}/{id}/hidden`, for the parlor (Temper, 2026-10-22). 204; the element's body and `change_seq` do not move.
415
427
  - `listAccountWorlds()` (`GET /account/worlds`, `OwAccountWorld[]`: owned and shared worlds with their keys by name and last four) and `mintWorldKey(worldId, { scope, name })` (`POST /account/worlds/{id}/keys`, `OwMintedKey` with the full key once), the two account routes Atlas and the parlor hand-rolled. Account token only.
416
428
 
417
429
  ## [4.44.0] - 2026-10-22
418
430
 
419
431
  ### Added
420
- - `changes({ after })` and `changesAll(since, { after })`: keel #514 (PR 152, D142, live 2026-10-22 00:55), `GET /changes?after=<ISO time>` returns only the changes made at or after that time, a filter and not a position: order, `cursor`, `has_more` and `head` are unchanged, and the window is read by passing the cursor back as `since` with the same `after`. A bad value is a 422 naming `after`.
432
+ - `changes({ after })` and `changesAll(since, { after })` (live 2026-10-22 00:55): `GET /changes?after=<ISO time>` returns only the changes made at or after that time, a filter and not a position: order, `cursor`, `has_more` and `head` are unchanged, and the window is read by passing the cursor back as `since` with the same `after`. A bad value is a 422 naming `after`.
421
433
 
422
434
  ## [4.43.0] - 2026-10-22
423
435
 
424
436
  ### Added
425
- - `adopt(type, id, member)`: change who made an element, `POST /{type}/{id}/adopt` with `{member}` (keel #427, D141, live 2026-10-22 00:43). `member` is a membership id of the world or `'owner'` (`created_by` null). The owner's key or a co-builder's with its PIN; a contributor's is 403 `not_author` (`isNotAuthor`). Returns the updated element; the write takes a new `change_seq` and the feed carries the element with its new `created_by`.
426
- - `createWorldLink`'s `maxUses` is documented for person links too (keel #390, D140, live the same hour): 2 to 50 lets in that many accounts, each joining once with the link's role. The client sent it already; the comment said player links only.
437
+ - `adopt(type, id, member)`: change who made an element, `POST /{type}/{id}/adopt` with `{member}` (live 2026-10-22 00:43). `member` is a membership id of the world or `'owner'` (`created_by` null). The owner's key or a co-builder's with its PIN; a contributor's is 403 `not_author` (`isNotAuthor`). Returns the updated element; the write takes a new `change_seq` and the feed carries the element with its new `created_by`.
438
+ - `createWorldLink`'s `maxUses` is documented for person links too (live the same hour): 2 to 50 lets in that many accounts, each joining once with the link's role. The client sent it already; the comment said player links only.
427
439
 
428
440
  ## [4.42.4] - 2026-10-21
429
441
 
430
442
  ### Fixed
431
- - **`parseDate` refuses a date the typed era does not hold**, rather than reading its number as an absolute year in another era. With a down era Before Gate turning on 6 Frost, "10 Thaw, 1 BG" read as step 39 ("10 Thaw, 2 AG") and "3 Frost, 0 BG" as "3 Frost, 1 BG"; both now answer `not a date in Before Gate`. The absolute reading stays for a step in no era, where `formatStep` prints the absolute year. No date `formatStep` prints changes how it parses: 20,826 round trips over the profile fixture's calendars read the same before and after. Found by Temper in Atlas 1.67.1 (OW Council h58 #9304).
443
+ - **`parseDate` refuses a date the typed era does not hold**, rather than reading its number as an absolute year in another era. With a down era Before Gate turning on 6 Frost, "10 Thaw, 1 BG" read as step 39 ("10 Thaw, 2 AG") and "3 Frost, 0 BG" as "3 Frost, 1 BG"; both now answer `not a date in Before Gate`. The absolute reading stays for a step in no era, where `formatStep` prints the absolute year. No date `formatStep` prints changes how it parses: 20,826 round trips over the profile fixture's calendars read the same before and after. Found by Temper in Atlas 1.67.1 (2026-10-21).
432
444
 
433
445
  ## [4.42.3] - 2026-10-21
434
446
 
435
447
  ### Fixed
436
- - **`parseDate` reads a down era's dates back to the step they were written from, with a mid-year pivot too.** 4.42.2 moved the display count to the year holding the step before the pivot, and the parse kept the old count, so with a mid-year pivot every date before it parsed back one year early ("6 Frost, 4 BG" read 20 steps early on a 20-step year). Year-boundary pivots were never affected. Found by Quillon porting 4.42.2 to the Unity SDK and confirmed on this kernel by Temper (OW Council h58 #8962, #9111); a round-trip test now holds every step on both sides of the pivot.
437
- - `redeemJoin`'s doc names a full world's refusal as 422 `world_full` (`isWorldFull`), as keel answers since the party link; it said `invalid_request` (Quillon, OW Keel h29 #9038).
448
+ - **`parseDate` reads a down era's dates back to the step they were written from, with a mid-year pivot too.** 4.42.2 moved the display count to the year holding the step before the pivot, and the parse kept the old count, so with a mid-year pivot every date before it parsed back one year early ("6 Frost, 4 BG" read 20 steps early on a 20-step year). Year-boundary pivots were never affected. Found by Quillon porting 4.42.2 to the Unity SDK and confirmed on this kernel by Temper (2026-10-20); a round-trip test now holds every step on both sides of the pivot.
449
+ - `redeemJoin`'s doc names a full world's refusal as 422 `world_full` (`isWorldFull`), as keel answers since the party link; it said `invalid_request` (Quillon, 2026-10-20).
438
450
 
439
451
  ## [4.42.2] - 2026-10-20
440
452
 
441
- Two calendar reading fixes, found writing the `atlas_calendar` profile's conformance fixture (OW Council h58 #8943, #8946).
453
+ Two calendar reading fixes, found writing the `atlas_calendar` profile's conformance fixture (2026-10-20).
442
454
 
443
455
  ### Fixed
444
456
  - **A down era has no year zero, even when its pivot falls mid-year.** Its year is now counted from the year holding the step just before the pivot, which reads `year_base` (1 by default). With the pivot mid-year, the earlier steps of the pivot's own year read year 0 ("0 BG") and every year before it one lower; with the pivot on a year's first step, nothing changes. The mirror of an up era, whose first partial year is year 1.
@@ -446,7 +458,7 @@ Two calendar reading fixes, found writing the `atlas_calendar` profile's conform
446
458
 
447
459
  ## [4.42.1] - 2026-10-20
448
460
 
449
- The calendar reader refuses what the `atlas_calendar` profile refuses (schema-dist `profiles/calendar.md`; Quillon's Unity read, OW Council h58 #8917).
461
+ The calendar reader refuses what the `atlas_calendar` profile refuses (schema-dist `profiles/calendar.md`; Quillon's Unity read, 2026-10-20).
450
462
 
451
463
  ### Fixed
452
464
  - **`readCalendarValue` / `readCalendarConfig` no longer throw on a falsy `eras` or `intercalary`** (`false`, `0`, `""`): it threw a `TypeError` where the profile says a reader refuses and shows bare numbers. It now returns `null`.
@@ -454,7 +466,7 @@ The calendar reader refuses what the `atlas_calendar` profile refuses (schema-di
454
466
 
455
467
  ## [4.42.0] - 2026-10-20
456
468
 
457
- Schema 00.32.02 (Skeld, OW Council h58 #8811): repinned to schema-dist v0.32.2-dist.29.
469
+ Schema 00.32.02 (Skeld, 2026-10-20): repinned to schema-dist v0.32.2-dist.29.
458
470
 
459
471
  ### Changed
460
472
  - **A Narrative's `start_date`** reads "Date when the narrative is first told or recorded, measured in world TIME units; the span it recounts lives on its events" (it read "Date when the narrative begins"), and **its `end_date`** reads "Date when the narrative stops being told, measured in world TIME units; empty while it is still told" (it read "Date when the narrative ends"), in the generated doc comments and `SCHEMA.md`. No field, type or link changed.
@@ -462,7 +474,7 @@ Schema 00.32.02 (Skeld, OW Council h58 #8811): repinned to schema-dist v0.32.2-d
462
474
 
463
475
  ## [4.41.0] - 2026-10-20
464
476
 
465
- A known-of stub's public fields (keel PR 117, keel #448), live in production, and schema-dist v0.32.1-dist.28, which publishes them.
477
+ A known-of stub's public fields, live in production, and schema-dist v0.32.1-dist.28, which publishes them.
466
478
 
467
479
  ### Added
468
480
  - **`PUBLIC_FIELDS`** (generated from the distribution's `presentation.json`, `types.<type>.public`): per element type,
@@ -482,7 +494,7 @@ A known-of stub's public fields (keel PR 117, keel #448), live in production, an
482
494
 
483
495
  ## [4.40.0] - 2026-10-20
484
496
 
485
- The "known of" stub's client half (keel PR 113, B16; keel #421 §7g), live in production since 2026-10-20 13:47.
497
+ The "known of" stub's client half, live in production since 2026-10-20 13:47.
486
498
 
487
499
  ### Added
488
500
  - **`known_of?: true`** on `OwElementBase` (generated; `SCHEMA.md` says it too): present, and true, only on a
@@ -501,10 +513,10 @@ The "known of" stub's client half (keel PR 113, B16; keel #421 §7g), live in pr
501
513
 
502
514
  ## [4.39.0] - 2026-10-20
503
515
 
504
- The party link (keel #422 PR 2, keel PR 110), live in production since 2026-10-20 13:15.
516
+ The party link, live in production since 2026-10-20 13:15.
505
517
 
506
518
  ### Added
507
- - The party link (keel #422 PR 2, keel PR 110; for Lantern's pick screen, Temper): one player link for a
519
+ - The party link (for Lantern's pick screen, Temper): one player link for a
508
520
  table of players. `createWorldLink(worldId, { reader: 'player', maxUses, characters })`, sent as `max_uses`
509
521
  and `characters`: 2 to 50 uses, each player picking one Character from the owner's list, in its order; no
510
522
  list, each player names a fresh Character after themselves. A table takes no `character`. A link for one
@@ -514,15 +526,15 @@ The party link (keel #422 PR 2, keel PR 110), live in production since 2026-10-2
514
526
  `redeemJoin(code, { character })` sends the pick; with `name_required`, `name` alone. A pick a live seat
515
527
  already plays is 422 `character_taken` (`err.isCharacterTaken`); a pick off the list, hidden or deleted
516
528
  since the link was made, or missing, is 422 `invalid_request` with param `character`
517
- (`err.isCharacterInvalid`, true for that param only); a world with its 50 players is 422 `world_full` (`err.isWorldFull`, its own code at my ask, Skeld h29 #8394); the last place
529
+ (`err.isCharacterInvalid`, true for that param only); a world with its 50 players is 422 `world_full` (`err.isWorldFull`, its own code at my ask, Skeld, 2026-10-20); the last place
518
530
  lost to another player is the one 404 (`err.isNotFound`).
519
531
 
520
532
  ### Changed
521
- - Repinned to schema-dist v0.32.1-dist.27: only `example/world-export.json` moved (its `schema_version` now 00.32.01, Skeld h29 #8455); no schema file moved, so the generated files change only their source lines.
533
+ - Repinned to schema-dist v0.32.1-dist.27: only `example/world-export.json` moved (its `schema_version` now 00.32.01, Skeld, 2026-10-20); no schema file moved, so the generated files change only their source lines.
522
534
 
523
535
  ## [4.38.0] - 2026-10-20
524
536
 
525
- Schema 00.32.01 (the Captain's word, h55 #8395): repinned to schema-dist v0.32.1-dist.26.
537
+ Schema 00.32.01 (Titus's word, 2026-10-20): repinned to schema-dist v0.32.1-dist.26.
526
538
 
527
539
  ### Changed
528
540
  - **An Event's `characters`** reads "Characters who know about the event: they were present, aware of it, or involved in it" (it read "Key characters relevant to the event"), in the generated doc comment and `SCHEMA.md`. No field, type or link changed.
@@ -530,22 +542,22 @@ Schema 00.32.01 (the Captain's word, h55 #8395): repinned to schema-dist v0.32.1
530
542
 
531
543
  ## [4.37.0] - 2026-10-20
532
544
 
533
- The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked on staging with the mark on, 25 of 25.
545
+ The hidden mark, live in production since 2026-10-20 09:24; walked on staging with the mark on, 25 of 25.
534
546
 
535
547
  ### Added
536
- - A `/changes` delete row's `reason` (`OwDeleteReason`: `deleted` | `hidden` | `out_of_view`; keel #421's hidden
548
+ - A `/changes` delete row's `reason` (`OwDeleteReason`: `deleted` | `hidden` | `out_of_view`; keel's hidden
537
549
  mark): an element hidden from this reader leaves its copy as a deleted one does, and a GET of it answers 404,
538
550
  not 410. `isResyncRequired`'s comment names every case keel now sends it for, not only a guest's.
539
- - `viewAs` on `get`, `list` and `listAll`, sent as `as` (keel #421 PR 3, view as): the owner's key reads as a
551
+ - `viewAs` on `get`, `list` and `listAll`, sent as `as` (view as): the owner's key reads as a
540
552
  member (a membership id), as a Character's guest (a Character id) or as the public (`'public'`). A member key
541
553
  gets 403 `view_as_owner_only` (`err.isViewAsOwnerOnly`); an element hidden from that reader is 404, never 410;
542
554
  an unknown value is 422. Until keel's hidden mark is on, keel answers 422 (an unknown parameter).
543
555
  - `err.resyncReason` (`'role'` | `'view'` | `undefined`) and `OwResyncReason`: why `/changes` answered 409
544
- `resync_required`, from the envelope's `reason` (keel #421, keel PR 103; only while keel's hidden mark is on).
556
+ `resync_required`, from the envelope's `reason` (only while keel's hidden mark is on).
545
557
  `epoch_reason` beside `epoch` on `OwChangesPage` and on `changesHead()`'s answer: why the epoch last moved.
546
558
 
547
559
  ### Changed
548
- - The resync instruction adds the hidden mark's reasons to 4.36.1's keep (the Captain, 2026-10-20): after a
560
+ - The resync instruction adds the hidden mark's reasons to 4.36.1's keep (Titus, 2026-10-20): after a
549
561
  409 `resync_required`, walk again from the start; reason `role` (the key's own role or membership moved):
550
562
  keep what the local copy holds that the walk no longer names; reason `view`, or a delete row with reason
551
563
  `hidden`: drop it; no reason (keel's hidden mark off): keep it, a reset never empties a copy. A tool never
@@ -556,37 +568,37 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
556
568
 
557
569
  ### Changed
558
570
 
559
- - `pinExpectation`'s doc comment: a legacy key that can write sends its PIN on every read of a world that has one, whether or not the world is open to read (keel #421 PR 105, the demo split). The `'required-for-private-reads'` literal keeps its name until 5.0, since renaming a literal in a published union is a type break. A demo-range key is kind `legacy` too and never needs a PIN. No code change.
571
+ - `pinExpectation`'s doc comment: a legacy key that can write sends its PIN on every read of a world that has one, whether or not the world is open to read (the demo split). The `'required-for-private-reads'` literal keeps its name until 5.0, since renaming a literal in a published union is a type break. A demo-range key is kind `legacy` too and never needs a PIN. No code change.
560
572
 
561
573
  ## [4.36.1] - 2026-10-20
562
574
 
563
575
  ### Changed
564
576
 
565
- - The reset rule in `isResyncRequired`'s and `changes`' doc comments: on a 409 `resync_required`, walk from zero and keep what the local copy holds that the new walk does not name; a reset never empties a copy. It said replace. Keel says keep since PR 104 (the Captain's ruling, 2026-10-20: sharing is forward-only). No code change.
577
+ - The reset rule in `isResyncRequired`'s and `changes`' doc comments: on a 409 `resync_required`, walk from zero and keep what the local copy holds that the new walk does not name; a reset never empties a copy. It said replace. Keel says keep (Titus's ruling, 2026-10-20: sharing is forward-only). No code change.
566
578
 
567
579
  ## [4.36.0] - 2026-10-20
568
580
 
569
581
  ### Changed
570
582
 
571
- - **`fieldLabel`** keeps a word written all in capitals as written (`STR` reads "STR", `plan_B` "Plan B"), so a custom stat block reads the same in every tool (Temper, h63 #8197; Lantern and Atlas both call it). Schema field names are all lowercase, so no schema label changes.
583
+ - **`fieldLabel`** keeps a word written all in capitals as written (`STR` reads "STR", `plan_B` "Plan B"), so a custom stat block reads the same in every tool (Temper, 2026-10-20; Lantern and Atlas both call it). Schema field names are all lowercase, so no schema label changes.
572
584
 
573
585
  ## [4.35.0] - 2026-10-20
574
586
 
575
587
  ### Added
576
588
 
577
- - **`createWorldLink(worldId, { preview })`** and `preview` on `OwWorldLink` (keel #422 PR 1, live 2026-10-20): a person or player link with `preview: true` is `/join/<world_id>#<code>`, so a chat that unfurls it shows the world's name and picture; the code stays in the fragment. Absent means off, as keel rules for the API; `true` on an agent link is 422, param `preview`. The wire gate failed on production's document until this release.
589
+ - **`createWorldLink(worldId, { preview })`** and `preview` on `OwWorldLink` (live 2026-10-20): a person or player link with `preview: true` is `/join/<world_id>#<code>`, so a chat that unfurls it shows the world's name and picture; the code stays in the fragment. Absent means off, as keel rules for the API; `true` on an agent link is 422, param `preview`. The wire gate failed on production's document until this release.
578
590
 
579
591
  ## [4.34.0] - 2026-10-20
580
592
 
581
593
  ### Added
582
594
 
583
- - **`fieldLabel(name)`** and **`FIELD_ACRONYMS`**: a field name as the words a tool shows, by the house rule (OW Style, the Captain 2026-10-20): sentence case, acronyms kept wherever they fall (`birth_date` → "Birth date", `image_url` → "Image URL"). Seeded from Atlas's `humanizeFieldName` as of 1.59.1, so Atlas, Lantern and Council read one copy (h63 #8109, #8119). The name is taken as given: a tool that hides an extension prefix drops it first.
595
+ - **`fieldLabel(name)`** and **`FIELD_ACRONYMS`**: a field name as the words a tool shows, by the house rule (Titus, 2026-10-20): sentence case, acronyms kept wherever they fall (`birth_date` → "Birth date", `image_url` → "Image URL"). Seeded from Atlas's `humanizeFieldName` as of 1.59.1, so Atlas, Lantern and Council read one copy. The name is taken as given: a tool that hides an extension prefix drops it first.
584
596
 
585
597
  ## [4.33.1] - 2026-10-19
586
598
 
587
599
  ### Fixed
588
600
  - An `agent: true` client's file uploads now declare it: `createFileTicket` (and so `uploadFile`) sends
589
- `X-OW-Agent`, the one files route keel's document lists it on (keel PR 95), so the file reads
601
+ `X-OW-Agent`, the one files route keel's document lists it on, so the file reads
590
602
  `added_by.agent: true`. The other files routes and the upload host get no such header.
591
603
 
592
604
  ## [4.33.0] - 2026-10-19
@@ -594,12 +606,12 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
594
606
  ### Added
595
607
  - `FILE_EXTENSIONS` (every extension a file on an element may end in, to its kind: keel's list, `.yml` and
596
608
  `.markdown` included) and `fileKindOf(name)` (the kind, or `undefined`), so a file picker's accept list reads
597
- the SDK's instead of a copy (Atlas, h20 #7841).
609
+ the SDK's instead of a copy (Atlas, 2026-10-19).
598
610
 
599
611
  ## [4.32.0] - 2026-10-19
600
612
 
601
613
  ### Added
602
- - **Files on elements** (keel #393), for Atlas's file list on an element:
614
+ - **Files on elements**, for Atlas's file list on an element:
603
615
  - `listFiles(type, id)`: the element's files, newest first (`OwFileRow`: `id`, `name`, `kind`,
604
616
  `size`, `label`, `added_by` with `name`, `membership` and `agent`, `added_at`), as keel sends them.
605
617
  - `uploadFile(type, id, file, { name?, kind?, label?, ticket?, onProgress? })`: a ticket from the API,
@@ -626,7 +638,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
626
638
  ## [4.31.0] — 2026-10-18
627
639
 
628
640
  ### Added
629
- - **Signing in with a password** (keel #211): `signInWithPassword({ email | username, password, tokenName })`
641
+ - **Signing in with a password**: `signInWithPassword({ email | username, password, tokenName })`
630
642
  turns an email address (or username) and password into a new account token (`ow_a_`) for this device,
631
643
  named `tokenName`, the name the account's tokens page lists it under. It signs in at keel's sign-in service
632
644
  (`{baseUrl}/auth/app/v1`), mints the token with that session at `POST /account/tokens`, then ends the
@@ -641,7 +653,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
641
653
  account's worlds, revoked and read back as `key_revoked`).
642
654
 
643
655
  ### Changed
644
- - `me()`'s doc names the player kind (keel #353).
656
+ - `me()`'s doc names the player kind.
645
657
 
646
658
  ## [4.30.1] — 2026-10-16
647
659
 
@@ -655,7 +667,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
655
667
  ## [4.30.0] — 2026-10-16
656
668
 
657
669
  ### Added
658
- - **A friend with only a link** (keel #353, D111):
670
+ - **A friend with only a link**:
659
671
  - `redeemJoin(code, { name?, agentName? })`: redeems a join code that needs no account, at `POST /join`,
660
672
  sending no credential whatever key the client holds. The answer's `kind` tells the two apart:
661
673
  `OwPlayerJoined` (a read key, `ow_r_`, no PIN, and the Character the player reads as) or
@@ -672,19 +684,19 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
672
684
  ## [4.29.0] — 2026-10-16
673
685
 
674
686
  ### Added
675
- - `rekeySeat(worldId, seatId)` (keel #355 piece 3, D108): a new key and secret for a seat whose AI lost
687
+ - `rekeySeat(worldId, seatId)`: a new key and secret for a seat whose AI lost
676
688
  its own, by its sponsor or the world's owner. The old key and secret stop at once; the answer has
677
689
  `createSeat`'s shape (`OwSeatCreated`: `key`, `pin`, `env`), shown once. No Idempotency-Key, by keel's
678
690
  rule: if the answer is lost too, ask for another.
679
691
 
680
692
  ### Changed
681
693
  - `createSeat`'s doc names `rekeySeat` as the way back from a lost answer.
682
- - `OwApiError.param`'s doc: `API-Pin` on a 401 PIN refusal (keel #357, D107), not only a 422/400's field.
694
+ - `OwApiError.param`'s doc: `API-Pin` on a 401 PIN refusal, not only a 422/400's field.
683
695
 
684
696
  ## [4.28.0] — 2026-10-16
685
697
 
686
698
  ### Added
687
- - **Seats for your own AI** (keel #355, D106), on an account token (`ow_a_`):
699
+ - **Seats for your own AI**, on an account token (`ow_a_`):
688
700
  - `createSeat(worldId, { name, role?, character? })`: a seat for your own AI in a world you own or
689
701
  belong to, with its own write key and `ow_s_` secret and no join link. You answer for it. `role` is at
690
702
  most your own; `character` is `new` (default), `none`, or `mine` (it plays the Character you play).
@@ -703,7 +715,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
703
715
  element's position in `items` (the ids the Python package mints), so the same key and items send the
704
716
  same body from either client, and a resend after keel's 24-hour replay window rewrites the same
705
717
  elements instead of creating new ones. Without a key, a fresh UUIDv7 each. Ids you pass are kept, and
706
- your items are not changed. Found by Quillon's parity audit of the Unity SDK (h37 #5794).
718
+ your items are not changed. Found by Quillon's parity audit of the Unity SDK (2026-10-16).
707
719
 
708
720
  ## [4.27.1] — 2026-10-16
709
721
 
@@ -714,12 +726,12 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
714
726
  Python package mints), so the retry sends the same body and gets the first answer back. Without a key,
715
727
  a fresh UUIDv7 as before; an id you pass is kept.
716
728
  - `create`'s doc said a keyed retry "rewrites the same element"; keel's replay writes nothing. Found by
717
- Quillon's parity audit of the Unity SDK (h37 #5764).
729
+ Quillon's parity audit of the Unity SDK (2026-10-16).
718
730
 
719
731
  ## [4.27.0] — 2026-10-16
720
732
 
721
733
  ### Added
722
- - `OwApiError.isIdempotencyInFlight` (keel #307, D105): a request with the same Idempotency-Key is still
734
+ - `OwApiError.isIdempotencyInFlight`: a request with the same Idempotency-Key is still
723
735
  running (409 `idempotency_in_flight`, `retryAfter` 1). Nothing was written by this one; send again with
724
736
  the same key and body after `retryAfter` and it replays the first answer. `isIdempotencyConflict` stays
725
737
  the different-body case only. The client still does not retry for you.
@@ -727,7 +739,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
727
739
  ## [4.26.0] — 2026-10-15
728
740
 
729
741
  ### Added
730
- - **The door of every write** (keel #299, D104; keel 7c1b493). An opt-in
742
+ - **The door of every write**. An opt-in
731
743
  `agent: true` on `OwClientConfig` sends `X-OW-Agent` on every element write (create, upsert,
732
744
  patch, delete, editLinks, bulk: the operations keel's document declares it on; never on reads,
733
745
  account routes or the image edge); keel records such writes as `declared`, agent-made, and stores only that the header was
@@ -744,10 +756,10 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
744
756
  - **`OwWorldMeta` types every field keel's `World` declares** (it named four): the description and
745
757
  picture, the calendar (`time_format_names`, `time_format_equivalents`, `time_basic_unit`, the three
746
758
  `time_range_*`), the three unit labels, `public_read`, `owner_character`, `created_at`, and new
747
- **`agent_narrator_rule`** (keel #298, D103: whether a Narrative written through an agent seat is
759
+ **`agent_narrator_rule`** (whether a Narrative written through an agent seat is
748
760
  narrated by that seat's own Character; read-only, set on the world page). Past `id` and `name`
749
761
  they stay optional so code that builds a world meta keeps compiling; keel always sends all of them.
750
- `updated_at` and `created_at` read `string | null`, as the document says. Assembly's wire gate now
762
+ `updated_at` and `created_at` read `string | null`, as the document says. The wire gate now
751
763
  holds this type to `World` (it had held only the PATCH body). Council and Lantern type-check on it.
752
764
 
753
765
  ## [4.24.0] — 2026-10-15
@@ -759,11 +771,11 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
759
771
  keel keeps a hash); `listWorldLinks(worldId)` the links without codes, each with its `status`
760
772
  and `uses`; `revokeWorldLink(worldId, linkId)`. Types `OwWorldLink`, `OwCreatedWorldLink`. A
761
773
  non-owner, and a world that doesn't exist, get 404; a world key is a TypeError before sending.
762
- For Lantern's Invite someone (Temper, h29 #5152).
774
+ For Lantern's Invite someone (Temper, 2026-10-15).
763
775
 
764
776
  ### Changed
765
- - `acceptJoin`'s doc comment and the README: accepting needs no account PIN for any role (keel
766
- #297, ed73c90), so its refusals are 404 and 409 `already_member`; `pin_required` now belongs to
777
+ - `acceptJoin`'s doc comment and the README: accepting needs no account PIN for any role,
778
+ so its refusals are 404 and 409 `already_member`; `pin_required` now belongs to
767
779
  minting a write key for the membership. `isPinRequired` stays.
768
780
  - Doc comments say "token rating" for the account's daily budget (`ask`, `sort`, `allowance`,
769
781
  `OwAllowance`, the answers' `token_rating`), as the README did in 4.23.0; the docs site's
@@ -775,14 +787,14 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
775
787
  - **`TokenResource.consume()`, `getAccessKey()`, `revokeSession()`, `revokeAllSessions()`**: keel
776
788
  serves none of these routes (each answers 404 `not_found` on production; `accounts/token_api.py`
777
789
  mounts only `status/` and `encryption-info/`). Spending is server-side, in the route that does the
778
- work (the Council's acts through keel's council proxy, keel #274, Skeld's ruling h37 #4632), and
790
+ work (the Council's acts through keel's council proxy, Skeld's ruling, 2026-10-14), and
779
791
  `OwV2Client.allowance()` reads the token rating. They stay callable and leave in 5.0. A 404 from
780
- any token route now says what keel serves instead of "an older server". Found by Assembly's wire
792
+ any token route now says what keel serves instead of "an older server". Found by the wire
781
793
  gate, which until now never drove this class (its routes are not in keel's document).
782
794
 
783
795
  ### Changed
784
- - README and docs: "token rating" is the one word for the account's daily budget (the Captain,
785
- h37 #4642, OW Infra #273). Names in the API (`allowance()`, `/account/allowance`) are unchanged.
796
+ - README and docs: "token rating" is the one word for the account's daily budget (Titus,
797
+ 2026-10-14). Names in the API (`allowance()`, `/account/allowance`) are unchanged.
786
798
 
787
799
  ## [4.22.0] — 2026-10-14
788
800
 
@@ -790,23 +802,23 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
790
802
  - **`client.me()` and `client.members()`**: GET /me (who this world key is: world, scope, kind,
791
803
  role, membership id, Character) and GET /members (the roster's rows, unwrapped from `{ data }`).
792
804
  Lantern reads a player's role from /me by hand today. Types `OwMe`, `OwMember`, typed from
793
- keel's declared schemas and held to them by Assembly's wire gate. An account token is a
805
+ keel's declared schemas and held to them by the wire gate. An account token is a
794
806
  TypeError before sending; the tests fail with that guard removed, or with the rows left
795
807
  wrapped.
796
808
 
797
809
  ### Changed
798
810
  - The calendar kernel is the SDK's own: Atlas 245aad3 deleted its `core/calendar.ts` and imports
799
- this one (Temper, h37 #4472), so the copy record (`src/calendar/SOURCES.json`) and the re-copy
811
+ this one (Temper, 2026-10-14), so the copy record (`src/calendar/SOURCES.json`) and the re-copy
800
812
  script (`codegen/atlas-calendar.mjs`) are gone. A kernel change is an SDK release now. No code
801
813
  change.
802
814
 
803
815
  ## [4.21.0] — 2026-10-14
804
816
 
805
817
  ### Added
806
- - **`client.allowance()`**: GET /account/allowance (keel 872431f, Skeld h37 #4308), the
818
+ - **`client.allowance()`**: GET /account/allowance (keel 872431f, Skeld, 2026-10-14), the
807
819
  account's daily AI allowance read without spending: `token_rating`, `tokens_used_today`,
808
820
  `tokens_remaining`, `resets_at` (the next midnight UTC). Account token only, like ask and
809
- sort. Type `OwAllowance`, held by Assembly's wire gate to the route's declared schema, as
821
+ sort. Type `OwAllowance`, held by the wire gate to the route's declared schema, as
810
822
  `OwAskAnswer`, `OwSortAnswer` and `OwJoinPreview` now are to theirs.
811
823
 
812
824
  ### Fixed
@@ -817,13 +829,13 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
817
829
 
818
830
  ### Added
819
831
  - **World calendars**, Atlas's calendar code in the SDK so Lantern can name dates (Temper,
820
- h37 #4284): `formatStep`, `formatYearLabel`, `breakdownStep`, `parseDate` and the rest of
832
+ 2026-10-14): `formatStep`, `formatYearLabel`, `breakdownStep`, `parseDate` and the rest of
821
833
  Atlas's `src/core/calendar.ts` (Atlas 02d6a6d), plus `worldCalendars`,
822
834
  `resolveCalendarLens` and `readCalendarValue` from its `calendar-lens.ts`, on any element
823
835
  shape. `CALENDAR_FIELD` is `atlas_calendar`: Atlas owns the field, its meaning and its
824
- writes, and other tools read it (Skeld, h37 #4286).
836
+ writes, and other tools read it (Skeld, 2026-10-14).
825
837
  - `src/calendar/calendar.ts` is Atlas's file byte for byte, recorded in
826
- `src/calendar/SOURCES.json` (Assembly's copy-drift); `codegen/atlas-calendar.mjs` re-copies it
838
+ `src/calendar/SOURCES.json`; `codegen/atlas-calendar.mjs` re-copies it
827
839
  and ports Atlas's 48 kernel tests (TypeScript's transpiler, a five-matcher `test/expect.mjs`
828
840
  over node:test). Watched failing: a planted `floorMod` edit failed two tests and the record
829
841
  (EDITED); a lens edit failed its test. An app that imports none of it bundles none of it.
@@ -832,7 +844,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
832
844
 
833
845
  ### Added
834
846
  - **`tokens_remaining` and `token_rating` on `OwAskAnswer` and `OwSortAnswer`**: since keel
835
- a6244db (Skeld, h37 #4233) ask and sort spend from the account's daily token rating, one
847
+ a6244db (Skeld, 2026-10-14) ask and sort spend from the account's daily token rating, one
836
848
  meter with the Council. `remaining` stays a count of answers: how many more calls of this
837
849
  size fit in what is left today (keel 504437b), never tokens. Typed from keel's code
838
850
  (`accounts/ask.py`), since its OpenAPI document gives these answers no schema.
@@ -843,10 +855,10 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
843
855
  each one by its own name: `x_eye_colour` reads `eye colour: grey`; an id in one is a link,
844
856
  by name; a long value is cut like a description. `atlas_*` machinery stays out, and so do
845
857
  object values (a tool's state). Lantern shows and edits custom fields now, so Ask can answer
846
- what find already could (Temper, h37 #4069). The trial's lookup (`dossiers/lantern-ask`)
858
+ what find already could (Temper, 2026-10-13). The trial's lookup
847
859
  still skips them; parity holds on its ten questions, whose fixture has no custom text.
848
860
  - The lookup's stopword set is an array literal, so bundlers mark it pure and drop it from
849
- apps that never call the lookup (451 bytes; Temper, h17 #4247).
861
+ apps that never call the lookup (451 bytes; Temper, 2026-10-14).
850
862
 
851
863
  ## [4.18.1] — 2026-10-12
852
864
 
@@ -860,13 +872,13 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
860
872
 
861
873
  ### Added
862
874
  - **`client.sort({ worldId, notes, slice })`**: POST /account/sort, ask's sibling (Temper for
863
- Lantern, h37 #3599; Skeld's route, #3591, #3594, #3596, #3597). Notes as words or
875
+ Lantern, 2026-10-12; Skeld's route). Notes as words or
864
876
  `{ text, image_url }`; the slice is the app's own lookup. Rows of four kinds come back to
865
877
  review (`make`, `add_to`, `link`, `ask` with an optional `then`) and `not_proposed` with
866
878
  reasons; nothing is written. One allowance with `ask`, and the same refusals. Types
867
879
  `OwSortRef`, `OwSortNote`, `OwSortRow` and its four kinds, `OwSortAnswer`. Built against
868
- keel PR #4 (90961fa, Skeld's final for the types, #3618), released once it was on keel
869
- main and in production (#3663): verify-sdk-wire PASS 1,111 against production's document.
880
+ keel PR #4 (90961fa, Skeld's final for the types), released once it was on keel
881
+ main and in production: verify-sdk-wire PASS 1,111 against production's document.
870
882
 
871
883
  ## [4.17.0] — 2026-10-12
872
884
 
@@ -875,7 +887,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
875
887
  says which view epoch it ran under (a guest's integer; `null` for other keys or a keel
876
888
  without the field) and the first poll after it needs no extra walk to learn it. Live on
877
889
  Moppetopia: a full walk of 465 changes returns `{ cursor, head: 818, epoch: null }`. The first
878
- tests of `changesAll`'s return value (Temper, h29 #3534).
890
+ tests of `changesAll`'s return value (Temper, 2026-10-12).
879
891
 
880
892
  ## [4.16.0] — 2026-10-12
881
893
 
@@ -886,7 +898,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
886
898
  `epoch` moved; nothing needs to read inside the cursor. `changesHead()` answers
887
899
  `epoch: null` from a keel without the field. Checked live on Moppetopia (the head read and a
888
900
  page both carry `epoch: null`). The wire gate now holds `OwChangesPage` and `OwBulkResponse`
889
- to keel's `ChangesPage` and `BulkResult` (keel #108), and failed on 4.15.0 for the missing
901
+ to keel's `ChangesPage` and `BulkResult`, and failed on 4.15.0 for the missing
890
902
  `epoch` before this release.
891
903
  Published from tag `v4.16.0`; the workflow's read-back gave up before npm showed the
892
904
  version, so the tarball (shasum `d08de22b`) was read back by hand against a build of the tag.
@@ -917,7 +929,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
917
929
  ## [4.13.0] — 2026-10-12
918
930
 
919
931
  ### Added
920
- - **Ask your world (keel #159).** `client.ask({ worldId, question, context })` sends a
932
+ - **Ask your world.** `client.ask({ worldId, question, context })` sends a
921
933
  question to keel's AI proxy with the account's `ow_a_` token (a world key is a `TypeError`
922
934
  before sending) and returns `OwAskAnswer` (`answer`, `model`, `stop_reason`, `usage`,
923
935
  `remaining`). The answer comes from `context` only, or is "The world doesn't say.".
@@ -929,12 +941,12 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
929
941
  New getters: `isQuotaExceeded` (429; `retryAfter` runs to midnight UTC), `isAskUnavailable`
930
942
  (503), `isAskFailed` (502). keel's document gives no request schema for `/account/ask`, so
931
943
  the body (`world_id`, `question`, `context`) is read from keel's code (`accounts/ask.py`).
932
- Not yet run live: no crew session holds an account token.
944
+ Not yet run live: no account token was at hand to run it with.
933
945
 
934
946
  ## [4.12.0] — 2026-10-12
935
947
 
936
948
  ### Added
937
- - **Joining a world by link (keel #212).** `previewJoin(code)` reads what a join code holds
949
+ - **Joining a world by link.** `previewJoin(code)` reads what a join code holds
938
950
  without using it (`OwJoinPreview`: `reader`, `world`, `invited_by`, `owner_character`,
939
951
  `role`, `with_character`, `expires_at`) and sends no credential, whatever key the client
940
952
  holds. `acceptJoin(code)` accepts an invite link as the account behind the client's `ow_a_`
@@ -955,7 +967,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
955
967
  forms first, then name words, supertype and subtype, one link step in both directions, then
956
968
  other text and numbers (always below any name hit). Each hit says why it matched.
957
969
  `renderElement` gives a compact text card with links by name, which is what a model reads
958
- when one phrases the answer. Measured on two real worlds (Assembly's Lantern Ask trial):
970
+ when one phrases the answer. Measured on two real worlds (a Lantern Ask trial):
959
971
  the answer was in the first three results for 60 of 60 questions that name their subject
960
972
  and 17 of 24 held-out questions that only describe it; this code returns the same top 8
961
973
  as the trial's on all 100 questions. Names in any script are matched (Chinese and Japanese
@@ -996,7 +1008,7 @@ The hidden mark (keel #421), live in production since 2026-10-20 09:24; walked o
996
1008
  ## [4.9.0] — 2026-10-11
997
1009
 
998
1010
  ### Added
999
- - **Only if unchanged (keel #210).** `patch(type, id, partial, { ifMatch })` and
1011
+ - **Only if unchanged.** `patch(type, id, partial, { ifMatch })` and
1000
1012
  `editLinks(type, id, field, edit, { ifMatch })` send `If-Match: "<change_seq>"`: the write
1001
1013
  lands only if the element is still at that `change_seq`. When it has moved, nothing is
1002
1014
  written and the call throws **`OwPreconditionFailedError`** (412 `precondition_failed`), an
package/README.md CHANGED
@@ -5,8 +5,6 @@
5
5
 
6
6
  OnlyWorlds is an open standard for worldbuilding data: 22 element types (characters, locations, events, laws and the rest) that any tool can read and write. This is a typed client for its API, with the schema's constants (element types, icons, colour families, field metadata) generated from the published [schema distribution](https://github.com/OnlyWorlds/schema-dist). It runs in Node 18+ and in the browser through a bundler (ESM only).
7
7
 
8
- **Who writes this repository.** The SDK is maintained by Kael, one of a crew of AI minds working with the OnlyWorlds founder, who answers for it. Kael reads and answers its issues and pull requests; until the crew posts from an identity of its own, those replies post from the founder's account, so a reply from `tmoosting` may be Kael's. `CHANGELOG.md` is the crew's record as it was written: its crew names, room references and keel items (keel #519, the API server's own tracker) point at records outside this repository.
9
-
10
8
  ## Install
11
9
 
12
10
  ```bash
@@ -422,3 +420,5 @@ Use this SDK for known operations in your own code (CRUD, sync, bulk). To let an
422
420
  ## Licence and contributions
423
421
 
424
422
  The code is MIT (`LICENSE`). Issues are welcome: a bug, a wrong word, a thing you could not do. Pull requests are read; a small fix is usually taken as is, and a change to what the package does is better opened as an issue first, since it may already be built or ruled out. A reply can take a few days. A vulnerability goes privately, never in an issue: `SECURITY.md`. What we ask at the door, and what you can expect: [the code of conduct](https://github.com/OnlyWorlds/OnlyWorlds/blob/main/CODE_OF_CONDUCT.md).
423
+
424
+ Maintained by Kael, an AI agent working for Titus. Issues and pull requests are read and answered here.
package/SCHEMA.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # OnlyWorlds Schema Reference
2
2
 
3
- **Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.33.0-dist.73** — canonical schema **00.33.00**, published 2026-10-26.
3
+ **Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.33.0-dist.74** — canonical schema **00.33.00**, published 2026-10-26.
4
4
 
5
5
  GENERATED from the canonical schema YAML — do not hand-edit (regenerate: `python codegen/generate_types.py`).
6
6
  Written for both humans and AI agents reading this package locally.
package/dist/index.d.ts CHANGED
@@ -29,7 +29,7 @@ interface OwElementBase {
29
29
  created_by?: string | null;
30
30
  /** The membership whose write last changed this element (server-managed, read-only); null for the world's owner and for anything last changed before writes recorded it. */
31
31
  changed_by?: string | null;
32
- /** The door of the last write (server-managed, read-only): `seat` (an agent seat), `mcp`, `declared` (a client that sent X-OW-Agent), then `api`, `v1`, `sync`, `server` (keel's own writes) or `site` (the owner signed in on onlyworlds.com; keel PR 160). The first three are agent-made. Null for anything last changed before writes recorded it. */
32
+ /** The door of the last write (server-managed, read-only): `seat` (an agent seat), `mcp`, `declared` (a client that sent X-OW-Agent), then `api`, `v1`, `sync`, `server` (keel's own writes) or `site` (the owner signed in on onlyworlds.com). The first three are agent-made. Null for anything last changed before writes recorded it. */
33
33
  changed_via?: 'seat' | 'mcp' | 'declared' | 'api' | 'v1' | 'sync' | 'server' | 'site' | null;
34
34
  /** The name the client gave in the X-OW-Client header on the last write (server-managed, read-only): lower case letters, digits and hyphens, 1 to 32 characters, such as `sdk` or `atlas`. It is the client's claim about itself, never proof, and says nothing about whether an agent drove the write (that is `changed_via`). Null when the last write sent no name or one outside the rule, for keel's own writes, and for anything last changed before names were recorded. Sent in a write it is ignored. This SDK sends its `client` option, `sdk` by default. */
35
35
  changed_client?: string | null;
@@ -57,7 +57,7 @@ declare const ELEMENT_ICONS: Record<ElementType, string>;
57
57
  /** The fields onlyworlds.com shows on a known-of element (`known_of: true`, see isKnownOf)
58
58
  * besides the base fields, with their values; every other field of a stub reads unset.
59
59
  * Platform behaviour, not a default to override. Source: the distribution's
60
- * `presentation.json` sidecar, `types.<type>.public` (keel PR 117). */
60
+ * `presentation.json` sidecar, `types.<type>.public`. */
61
61
  declare const PUBLIC_FIELDS: {
62
62
  readonly ability: readonly [];
63
63
  readonly character: readonly ["physicality", "height", "weight", "species", "reputation"];
@@ -2662,7 +2662,7 @@ interface OwWorldLink {
2662
2662
  uses: number;
2663
2663
  /** A table is `pending` while `uses < max_uses` (and neither revoked nor expired), `used` once full. */
2664
2664
  status: 'pending' | 'used' | 'revoked' | 'expired';
2665
- /** The membership (its id in GET /api/v2/members) of the co-builder who minted the link over POST /api/v2/links; null for a link the owner made (keel PR 215). */
2665
+ /** The membership (its id in GET /api/v2/members) of the co-builder who minted the link over POST /api/v2/links; null for a link the owner made. */
2666
2666
  minted_by: string | null;
2667
2667
  /** Whether the link shows the world's name and picture when it is pasted into a chat: then the link is `/join/<world_id>#<code>`, else `/join#<code>`. Never on an agent link. */
2668
2668
  preview?: boolean;
@@ -2761,7 +2761,7 @@ interface OwSignedIn {
2761
2761
  * (`'collaborator'`, with `member_role` the membership's role). Keys by name and last four only,
2762
2762
  * never the key; on a shared world only the member's own keys.
2763
2763
  */
2764
- /** The draught's policy (keel PR 155): what GET /character/{id}/context serves and how. */
2764
+ /** The draught's policy: what GET /character/{id}/context serves and how. */
2765
2765
  interface OwDraughtPolicy {
2766
2766
  /** Sections to serve; default every one but `messages`, `room` and `proposed`, each served only when named. */
2767
2767
  components?: OwDraughtComponent[];
@@ -2808,7 +2808,7 @@ interface OwDraughtItem {
2808
2808
  /** The element's body exactly as the list route serves it to the same reader. */
2809
2809
  element: OwElement;
2810
2810
  }
2811
- /** One Character's context in one read, GET /character/{id}/context (keel PR 155; the draught). */
2811
+ /** One Character's context in one read, GET /character/{id}/context (the draught). */
2812
2812
  /** The draught under `compact`: every section may be absent, and so may `cut` (nothing was cut). */
2813
2813
  type OwDraughtCompact = Omit<OwDraught, 'cut'> & {
2814
2814
  cut?: Record<string, number>;
@@ -3122,9 +3122,9 @@ interface OwFileDownload {
3122
3122
  interface ListParams {
3123
3123
  limit?: number;
3124
3124
  cursor?: string;
3125
- /** Only these ids (1 to 200), in the list's own order; one this key cannot see is simply absent (keel PR 155). */
3125
+ /** Only these ids (1 to 200), in the list's own order; one this key cannot see is simply absent. */
3126
3126
  ids?: string[];
3127
- /** A membership id, or `'owner'` for the owner's own writes: only what that member created (keel PR 155). */
3127
+ /** A membership id, or `'owner'` for the owner's own writes: only what that member created. */
3128
3128
  createdBy?: string;
3129
3129
  /** One-level stub expansion, e.g. ['friends', 'location']. */
3130
3130
  expand?: string[];
@@ -3308,8 +3308,8 @@ declare class OwApiError extends Error {
3308
3308
  */
3309
3309
  get isViewAsOwnerOnly(): boolean;
3310
3310
  /**
3311
- * An element write carried `known_of` (422 `known_of_not_writable`, `param` known_of; keel
3312
- * PR 117), true or false: the key marks a stub and is never written. Drop it and send only
3311
+ * An element write carried `known_of` (422 `known_of_not_writable`, `param` known_of),
3312
+ * true or false: the key marks a stub and is never written. Drop it and send only
3313
3313
  * the fields you mean. This client never sends it (`known_of` is stripped, a stub is a
3314
3314
  * TypeError before sending), so it reaches you only through `request()`. `/bulk` never
3315
3315
  * throws for it: the item's slot carries the code, and its siblings apply.
@@ -3546,7 +3546,7 @@ declare function pinExpectation(kind: OwKeyKind): 'never' | 'optional' | 'requir
3546
3546
 
3547
3547
  /**
3548
3548
  * Sign in with OnlyWorlds: OAuth 2.1's authorization code with PKCE (S256) for public clients
3549
- * (keel PR 154, live 2026-10-22).
3549
+ * (live 2026-10-22).
3550
3550
  *
3551
3551
  * Two calls. `beginSignIn` mints `state` and a PKCE verifier, keeps them under the client id in a
3552
3552
  * storage the page shares with its callback (sessionStorage by default), and hands back the
@@ -3677,7 +3677,7 @@ declare class OwV2Client {
3677
3677
  /** GET /{type}/ -- one cursor page. */
3678
3678
  list(type: ElementType | string, params?: ListParams): Promise<OwPage>;
3679
3679
  /**
3680
- * GET /character/{id}/context -- the draught (keel PR 155): what one Character knows, as the
3680
+ * GET /character/{id}/context -- the draught: what one Character knows, as the
3681
3681
  * recorded world holds it, in one read: her element, what she holds and sits in, her open work,
3682
3682
  * how she works, the Events she was in, the Narratives she knows, everything else that names
3683
3683
  * her, her sheet, what changed around her (`since`), and who plays whom; the world's name and
@@ -3812,7 +3812,7 @@ declare class OwV2Client {
3812
3812
  * the cursor and walk from zero. For what the local copy holds that the walk no longer names,
3813
3813
  * read err.resyncReason (while keel's hidden mark is on): `role`, keep it; `view`,
3814
3814
  * drop it (as for a delete row with reason `hidden`). Without a reason, keep it (keel's own
3815
- * words since PR 104; sharing is forward-only). Never empty a copy on your own.
3815
+ * words; sharing is forward-only). Never empty a copy on your own.
3816
3816
  * Citizenship: heaviest route on the platform; default page size is polite.
3817
3817
  * keel sends the cursor of a page at the head as a number (an empty page, for a key
3818
3818
  * whose cursor carries no epoch); it is handed back as a string, like every cursor here.
@@ -4586,6 +4586,12 @@ declare function recipientsOf(message: object | null | undefined): string[];
4586
4586
  * the text, not any other link. A sender is not addressed by sending.
4587
4587
  */
4588
4588
  declare function isAddressedTo(message: object | null | undefined, characterId: string): boolean;
4589
+ /**
4590
+ * True when the message is addressed to every member: its `characters` is absent, null or `[]`.
4591
+ * A list that names no valid id (`['']`) or a value that is not a list is addressed to nobody,
4592
+ * so it is false here, though `recipientsOf` gives `[]` for both.
4593
+ */
4594
+ declare function isToEveryone(message: object | null | undefined): boolean;
4589
4595
  /** True when the message's `narrator` is the Character: the claim, whether or not `senderStatus` proves it. */
4590
4596
  declare function isSentBy(message: object | null | undefined, characterId: string): boolean;
4591
4597
  /**
@@ -5671,4 +5677,4 @@ declare class TokenResource {
5671
5677
  getEncryptionInfo(): Promise<EncryptionInfo>;
5672
5678
  }
5673
5679
 
5674
- export { AGENT_DOORS, ASK_LIMITS, type AccessKeyResponse, CALENDAR_FIELD, CALENDAR_SUPERTYPE, type CalendarConfig, type CalendarEra, type CalendarIntercalary, type CalendarMonths, type CalendarWeek, ELEMENT_FAMILIES, ELEMENT_ICONS, ELEMENT_LABELS, ELEMENT_SECTIONS, ELEMENT_TYPES, type ElementFamily, type ElementType, type EncryptionInfo, type EraDomain, FAMILY_COLORS, FAMILY_ORDER, FIELD_ACRONYMS, FIELD_SCHEMA, FILE_EXTENSIONS, type FieldInfo, type FieldType, GameTier, type ListParams, MESSAGE_PAIR, ONLYWORLDS_VERSION, type OwAccountWorld, type OwAgentJoined, type OwAllowance, OwApiError, type OwAskAnswer, type OwAskContext, type OwAskContextOptions, type OwAskLeftOut, type OwAuthErrorCode, type OwBulkItem, type OwBulkItemResult, type OwBulkResponse, type OwCalendarElement, type OwChange, type OwChangeDelete, type OwChangeUpsert, type OwChangesPage, type OwClientConfig, type OwCreateAccountWorldInput, type OwCreatedAccountWorld, type OwCreatedWorldLink, type OwDeleteReason, type OwDraught, type OwDraughtCompact, type OwDraughtComponent, type OwDraughtItem, type OwDraughtPolicy, type OwElement, type OwElementBase, type OwErrorBody, type OwFileAddedBy, type OwFileDownload, type OwFileKind, type OwFileRow, type OwFileTicket, type OwFrontDoor, type OwHiddenRow, type OwJoinPreview, type OwJoined, type OwJoinedMembership, type OwKeyKind, type OwLinkEdit, type OwLookupElement, type OwLookupHit, type OwLookupLink, type OwLookupOptions, type OwLookupReason, type OwMe, type OwMediaTicket, type OwMember, type OwMemberRole, type OwMessageMember, type OwMintedKey, type OwNamesMap, OwNetworkError, type OwPage, type OwPhotoOptions, type OwPhotoPlan, type OwPlayerJoined, OwPreconditionFailedError, type OwPreparedPhoto, type OwProposal, type OwProposalAccepted, type OwProposalConflict, type OwProposalList, type OwProposalQuery, type OwProposalState, type OwProposeInput, type OwProposed, OwProposedError, type OwProposedNewElement, type OwReadWorldFile, type OwReadWorldFileOptions, type OwRemovalTicket, type OwRemovedImage, type OwRenderOptions, type OwResyncReason, type OwReviewInput, type OwReviewed, type OwSeat, type OwSeatCreated, type OwSender, type OwSenderStatus, type OwSignInBegin, type OwSignInBegun, type OwSignInComplete, OwSignInError, type OwSignInReason, type OwSignInResult, type OwSignInStorage, type OwSignedIn, type OwSortAddToRow, type OwSortAnswer, type OwSortAskRow, type OwSortLinkRow, type OwSortMakeRow, type OwSortNote, type OwSortRef, type OwSortRow, OwStaleProposalError, type OwUploadedFile, type OwUploadedImage, OwV2Client, type OwWordPair, type OwWorldFileEntry, OwWorldFileError, type OwWorldFileReason, type OwWorldFileRow, type OwWorldFiles, type OwWorldIndex, type OwWorldLink, type OwWorldMeta, type OwWorldOrigin, type OwWorldProducer, type OwWorldProposalList, type OwWorldProposalQuery, type OwWorldProposalRow, type OwWorldPublicPage, type OwWorldSource, type OwWriteDoor, type OwWriteWorldFileOptions, type OwWriteWorldFileReport, PHOTO_MAX_BYTES, PHOTO_TYPES, PUBLIC_FIELDS, type ParseError, type ParseOptions, type ParseResult, REVIEW_PROPOSED_LABEL, ROOM_PAIRS, type RevokeAllSessionsResponse, type RevokeSessionResponse, SPATIAL_TYPES, type SectionInfo, type StepBreakdown, type TokenConsumeParams, type TokenConsumeResponse, TokenResource, type TokenStatus, type TokenTransport, WORLD_FILE_MAX_BYTES, WORLD_FILE_MAX_ENTRIES, WORLD_FILE_MEDIA_TYPE, type WorldCalendar, absYearForEraYear, absoluteYear, approxYearLength, base64url, breakdownStep, buildAskContext, buildWorldIndex, detectKeyKind, displayYear, elementColor, eraForStep, errorFromResponse, familyOf, fieldLabel, fileKindOf, floorDiv, floorMod, formatDuration, formatMidLabel, formatStep, formatYearLabel, getElementIcon, getElementLabel, intercalaryInYear, isAddressedTo, isAgentDoor, isDemoKey, isKnownOf, isLeapYear, isMessage, isParseError, isRoomElement, isSentBy, kindCanWrite, lookupWorld, monthStartSteps, nfc, parseDate, parseErrorEnvelope, pinExpectation, pkceChallenge, planPhoto, preparePhoto, readCalendarConfig, readCalendarValue, readMarkOf, readWorldFile, recipientsOf, renderElement, resolveCalendarLens, resolveEraDomains, senderStatus, simpleCaseFold, threadOf, typeWord, unreadFor, validateCalendarConfig, weekdayForStep, worldCalendars, writeWorldFile, yearLength, yearStartStep };
5680
+ export { AGENT_DOORS, ASK_LIMITS, type AccessKeyResponse, CALENDAR_FIELD, CALENDAR_SUPERTYPE, type CalendarConfig, type CalendarEra, type CalendarIntercalary, type CalendarMonths, type CalendarWeek, ELEMENT_FAMILIES, ELEMENT_ICONS, ELEMENT_LABELS, ELEMENT_SECTIONS, ELEMENT_TYPES, type ElementFamily, type ElementType, type EncryptionInfo, type EraDomain, FAMILY_COLORS, FAMILY_ORDER, FIELD_ACRONYMS, FIELD_SCHEMA, FILE_EXTENSIONS, type FieldInfo, type FieldType, GameTier, type ListParams, MESSAGE_PAIR, ONLYWORLDS_VERSION, type OwAccountWorld, type OwAgentJoined, type OwAllowance, OwApiError, type OwAskAnswer, type OwAskContext, type OwAskContextOptions, type OwAskLeftOut, type OwAuthErrorCode, type OwBulkItem, type OwBulkItemResult, type OwBulkResponse, type OwCalendarElement, type OwChange, type OwChangeDelete, type OwChangeUpsert, type OwChangesPage, type OwClientConfig, type OwCreateAccountWorldInput, type OwCreatedAccountWorld, type OwCreatedWorldLink, type OwDeleteReason, type OwDraught, type OwDraughtCompact, type OwDraughtComponent, type OwDraughtItem, type OwDraughtPolicy, type OwElement, type OwElementBase, type OwErrorBody, type OwFileAddedBy, type OwFileDownload, type OwFileKind, type OwFileRow, type OwFileTicket, type OwFrontDoor, type OwHiddenRow, type OwJoinPreview, type OwJoined, type OwJoinedMembership, type OwKeyKind, type OwLinkEdit, type OwLookupElement, type OwLookupHit, type OwLookupLink, type OwLookupOptions, type OwLookupReason, type OwMe, type OwMediaTicket, type OwMember, type OwMemberRole, type OwMessageMember, type OwMintedKey, type OwNamesMap, OwNetworkError, type OwPage, type OwPhotoOptions, type OwPhotoPlan, type OwPlayerJoined, OwPreconditionFailedError, type OwPreparedPhoto, type OwProposal, type OwProposalAccepted, type OwProposalConflict, type OwProposalList, type OwProposalQuery, type OwProposalState, type OwProposeInput, type OwProposed, OwProposedError, type OwProposedNewElement, type OwReadWorldFile, type OwReadWorldFileOptions, type OwRemovalTicket, type OwRemovedImage, type OwRenderOptions, type OwResyncReason, type OwReviewInput, type OwReviewed, type OwSeat, type OwSeatCreated, type OwSender, type OwSenderStatus, type OwSignInBegin, type OwSignInBegun, type OwSignInComplete, OwSignInError, type OwSignInReason, type OwSignInResult, type OwSignInStorage, type OwSignedIn, type OwSortAddToRow, type OwSortAnswer, type OwSortAskRow, type OwSortLinkRow, type OwSortMakeRow, type OwSortNote, type OwSortRef, type OwSortRow, OwStaleProposalError, type OwUploadedFile, type OwUploadedImage, OwV2Client, type OwWordPair, type OwWorldFileEntry, OwWorldFileError, type OwWorldFileReason, type OwWorldFileRow, type OwWorldFiles, type OwWorldIndex, type OwWorldLink, type OwWorldMeta, type OwWorldOrigin, type OwWorldProducer, type OwWorldProposalList, type OwWorldProposalQuery, type OwWorldProposalRow, type OwWorldPublicPage, type OwWorldSource, type OwWriteDoor, type OwWriteWorldFileOptions, type OwWriteWorldFileReport, PHOTO_MAX_BYTES, PHOTO_TYPES, PUBLIC_FIELDS, type ParseError, type ParseOptions, type ParseResult, REVIEW_PROPOSED_LABEL, ROOM_PAIRS, type RevokeAllSessionsResponse, type RevokeSessionResponse, SPATIAL_TYPES, type SectionInfo, type StepBreakdown, type TokenConsumeParams, type TokenConsumeResponse, TokenResource, type TokenStatus, type TokenTransport, WORLD_FILE_MAX_BYTES, WORLD_FILE_MAX_ENTRIES, WORLD_FILE_MEDIA_TYPE, type WorldCalendar, absYearForEraYear, absoluteYear, approxYearLength, base64url, breakdownStep, buildAskContext, buildWorldIndex, detectKeyKind, displayYear, elementColor, eraForStep, errorFromResponse, familyOf, fieldLabel, fileKindOf, floorDiv, floorMod, formatDuration, formatMidLabel, formatStep, formatYearLabel, getElementIcon, getElementLabel, intercalaryInYear, isAddressedTo, isAgentDoor, isDemoKey, isKnownOf, isLeapYear, isMessage, isParseError, isRoomElement, isSentBy, isToEveryone, kindCanWrite, lookupWorld, monthStartSteps, nfc, parseDate, parseErrorEnvelope, pinExpectation, pkceChallenge, planPhoto, preparePhoto, readCalendarConfig, readCalendarValue, readMarkOf, readWorldFile, recipientsOf, renderElement, resolveCalendarLens, resolveEraDomains, senderStatus, simpleCaseFold, threadOf, typeWord, unreadFor, validateCalendarConfig, weekdayForStep, worldCalendars, writeWorldFile, yearLength, yearStartStep };
package/dist/index.js CHANGED
@@ -174,8 +174,8 @@ var OwApiError = class extends Error {
174
174
  return this.status === 403 && this.code === "view_as_owner_only";
175
175
  }
176
176
  /**
177
- * An element write carried `known_of` (422 `known_of_not_writable`, `param` known_of; keel
178
- * PR 117), true or false: the key marks a stub and is never written. Drop it and send only
177
+ * An element write carried `known_of` (422 `known_of_not_writable`, `param` known_of),
178
+ * true or false: the key marks a stub and is never written. Drop it and send only
179
179
  * the fields you mean. This client never sends it (`known_of` is stripped, a stub is a
180
180
  * TypeError before sending), so it reaches you only through `request()`. `/bulk` never
181
181
  * throws for it: the item's slot carries the code, and its siblings apply.
@@ -889,7 +889,7 @@ var OwV2Client = class {
889
889
  * the cursor and walk from zero. For what the local copy holds that the walk no longer names,
890
890
  * read err.resyncReason (while keel's hidden mark is on): `role`, keep it; `view`,
891
891
  * drop it (as for a delete row with reason `hidden`). Without a reason, keep it (keel's own
892
- * words since PR 104; sharing is forward-only). Never empty a copy on your own.
892
+ * words; sharing is forward-only). Never empty a copy on your own.
893
893
  * Citizenship: heaviest route on the platform; default page size is polite.
894
894
  * keel sends the cursor of a page at the head as a number (an empty page, for a key
895
895
  * whose cursor carries no epoch); it is handed back as a string, like every cursor here.
@@ -1748,7 +1748,7 @@ var OwV2Client = class {
1748
1748
  if (opts.keepalive !== void 0) send.keepalive = opts.keepalive;
1749
1749
  await this.request("DELETE", `/account/worlds/${encodeURIComponent(worldId)}/keys/${encodeURIComponent(keyId)}`, send);
1750
1750
  }
1751
- // -- Sign in with OnlyWorlds (OAuth 2.1 code + PKCE, keel PR 154) ---------
1751
+ // -- Sign in with OnlyWorlds (OAuth 2.1 code + PKCE) ----------------------
1752
1752
  /**
1753
1753
  * Start Sign in with OnlyWorlds from a tool's page: mint `state` and a PKCE verifier, keep them
1754
1754
  * under `clientId` in `storage` (sessionStorage by default; in Node pass one), and send the
@@ -3712,10 +3712,15 @@ function recipientsOf(message) {
3712
3712
  }
3713
3713
  function isAddressedTo(message, characterId) {
3714
3714
  if (!isBody(message) || typeof characterId !== "string" || characterId === "") return false;
3715
+ if (isToEveryone(message)) return true;
3715
3716
  const list = message.characters;
3716
- if (list === void 0 || list === null || Array.isArray(list) && list.length === 0) return true;
3717
3717
  return Array.isArray(list) && list.includes(characterId);
3718
3718
  }
3719
+ function isToEveryone(message) {
3720
+ if (!isBody(message)) return false;
3721
+ const list = message.characters;
3722
+ return list === void 0 || list === null || Array.isArray(list) && list.length === 0;
3723
+ }
3719
3724
  function isSentBy(message, characterId) {
3720
3725
  return isBody(message) && typeof characterId === "string" && characterId !== "" && message.narrator === characterId;
3721
3726
  }
@@ -5199,6 +5204,7 @@ export {
5199
5204
  isParseError,
5200
5205
  isRoomElement,
5201
5206
  isSentBy,
5207
+ isToEveryone,
5202
5208
  kindCanWrite,
5203
5209
  lookupWorld,
5204
5210
  monthStartSteps,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@onlyworlds/sdk",
3
- "version": "4.80.0",
3
+ "version": "4.81.1",
4
4
  "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
5
5
  "type": "module",
6
6
  "exports": {