@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 +1 -1
- package/CHANGELOG.md +116 -104
- package/README.md +2 -2
- package/SCHEMA.md +1 -1
- package/dist/index.d.ts +19 -13
- package/dist/index.js +11 -5
- package/package.json +1 -1
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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,
|
|
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
|
|
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 })
|
|
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 (
|
|
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,
|
|
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`
|
|
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
|
|
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
|
|
187
|
-
- **The world's queue lists new elements written as proposed** (
|
|
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
|
|
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** (
|
|
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
|
|
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 })`** (
|
|
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`** (
|
|
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,
|
|
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** (
|
|
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
|
|
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
|
|
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 (
|
|
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** (
|
|
290
|
-
- **The public page on `OwWorldMeta`** (
|
|
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** (
|
|
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,
|
|
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
|
|
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
|
|
371
|
-
- `site` joins `OwWriteDoor`: a write or delete the owner made signed in on onlyworlds.com
|
|
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
|
|
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,
|
|
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
|
|
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` (
|
|
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** (
|
|
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
|
|
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 })
|
|
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}` (
|
|
426
|
-
- `createWorldLink`'s `maxUses` is documented for person links too (
|
|
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 (
|
|
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 (
|
|
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,
|
|
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 (
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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
|
|
516
|
+
The party link, live in production since 2026-10-20 13:15.
|
|
505
517
|
|
|
506
518
|
### Added
|
|
507
|
-
- The party link (
|
|
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
|
|
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
|
|
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 (
|
|
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
|
|
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
|
|
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` (
|
|
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` (
|
|
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 (
|
|
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 (
|
|
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
|
|
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,
|
|
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` (
|
|
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 (
|
|
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
|
|
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,
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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)
|
|
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
|
|
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
|
|
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 (
|
|
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 (
|
|
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
|
|
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
|
|
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`** (
|
|
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.
|
|
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,
|
|
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
|
|
766
|
-
|
|
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,
|
|
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
|
|
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 (
|
|
785
|
-
|
|
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
|
|
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,
|
|
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
|
|
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
|
|
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
|
-
|
|
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,
|
|
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
|
|
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,
|
|
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,
|
|
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,
|
|
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,
|
|
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
|
|
869
|
-
main and in production
|
|
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,
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 (
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 (
|
|
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
|
|
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
|
|
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
|
|
3312
|
-
*
|
|
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
|
-
* (
|
|
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
|
|
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
|
|
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
|
|
178
|
-
*
|
|
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
|
|
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
|
|
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,
|