From fbda7a37595541e4de820fb2db8871678d92535e Mon Sep 17 00:00:00 2001 From: Titus Date: Tue, 17 Nov 2026 09:16:07 +0100 Subject: [PATCH 1/2] A fields list with unknown names is refused once with all of them named; TypeScript SDK 4.179.0, Python 0.134.0, Unity SDK v0.44.0 The reads page and the errors page say what the 422 on a fields list now carries (unknown_fields, types_with_field, allowed_fields) and which package call reads it. The Unity page's producer line says 0.44.0 and names what v0.44.0 reads. The pin moves to 4.179.0 with the regenerated reference. Co-Authored-By: Claude Fable 5.2 --- package-lock.json | 8 ++++---- package.json | 2 +- src/content/docs/api/errors/index.mdx | 1 + src/content/docs/docs/changelog.md | 3 +++ src/content/docs/docs/development/api/reads.md | 2 +- src/content/docs/docs/development/typescript.md | 2 +- src/content/docs/docs/development/unity.md | 4 ++-- 7 files changed, 13 insertions(+), 9 deletions(-) diff --git a/package-lock.json b/package-lock.json index b4573daa..b7689b44 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,7 +14,7 @@ "starlight-page-actions": "0.7.1" }, "devDependencies": { - "@onlyworlds/sdk": "4.178.1", + "@onlyworlds/sdk": "4.179.0", "typescript": "5.9.3" } }, @@ -1685,9 +1685,9 @@ } }, "node_modules/@onlyworlds/sdk": { - "version": "4.178.1", - "resolved": "https://registry.npmjs.org/@onlyworlds/sdk/-/sdk-4.178.1.tgz", - "integrity": "sha512-bWC9gM+AbmvDKRqXYSml1gfzvu45pe683cqEUIvzeAPggQxy16JxAjOg1KNUBLcvWAQDWsy6XywANVkdLx/56g==", + "version": "4.179.0", + "resolved": "https://registry.npmjs.org/@onlyworlds/sdk/-/sdk-4.179.0.tgz", + "integrity": "sha512-XooaDOjZCghY4PlC+H2h17u3K+8JwF3lPdnNr1taJ1MofDT8yNPRwlghnydRbrBZnMYXiIT5ycAG05KcGkvKyw==", "dev": true, "license": "MIT", "dependencies": { diff --git a/package.json b/package.json index a4804959..6af90503 100644 --- a/package.json +++ b/package.json @@ -17,7 +17,7 @@ "starlight-page-actions": "0.7.1" }, "devDependencies": { - "@onlyworlds/sdk": "4.178.1", + "@onlyworlds/sdk": "4.179.0", "typescript": "5.9.3" }, "overrides": { diff --git a/src/content/docs/api/errors/index.mdx b/src/content/docs/api/errors/index.mdx index 1fb2b7f0..f53f6b17 100644 --- a/src/content/docs/api/errors/index.mdx +++ b/src/content/docs/api/errors/index.mdx @@ -127,6 +127,7 @@ The request body or query is malformed: an unknown field, a server-managed field - **Common cause:** a misspelled field name (`freinds`); a `_ids` or `_id` suffix carried over from the [Classic API](/docs/development/api/classic) (the current API uses bare link names); an unknown query parameter, such as a mistyped filter (`nmae__icontains`) or `?ordering=`; sending a read body back with `type`, `created_at`, `updated_at` or `change_seq` still in it; a bulk request whose `items` is not an array. - **How to fix:** read `param`: it names the field or parameter at fault. Correct the spelling, drop the suffix or the server field, or remove the parameter. The list filters are `name`, `name__icontains`, `supertype`, `subtype`, `ids` and `created_by`, plus `characters` on the six element types with that link, and each element type's single links (`?parent_location=`; the `422`'s message lists the type's own filters, [Filters](/docs/development/api/reads#filters)); the other accepted parameters are `limit`, `cursor`, `expand`, `fields`, `as` and `world`. Any other query parameter is rejected, never ignored. +- **A `fields` list with unknown names** (`param` `fields`) is refused once for the whole list, and the error carries three keys beside the usual five: `unknown_fields` (every name the element type does not have, in the order sent), `types_with_field` (for each one another element type has, those types) and `allowed_fields` (the names this type takes). Send the list again from those ([Expansion and sparse fields](/docs/development/api/reads#expansion-and-sparse-fields)). The TypeScript SDK reads the three as `err.fieldsRefusal` (from 4.179.0), the Python package as `ApiError.fields_refusal` (from 0.134.0). Unknown fields are a hard error, not a silent drop, so a mistyped field name fails loudly instead of vanishing. Fields under the extension namespaces `atlas_*`, `shadow_*` and `x_*` are the exception: they are stored as written. diff --git a/src/content/docs/docs/changelog.md b/src/content/docs/docs/changelog.md index afc5ecd6..a031feff 100644 --- a/src/content/docs/docs/changelog.md +++ b/src/content/docs/docs/changelog.md @@ -9,6 +9,9 @@ What changed on onlyworlds.com for everyone is on its own [Changelog](https://ww ## 2026-11-17 +- **[A `fields` list with unknown names](/docs/development/api/reads#expansion-and-sparse-fields) is refused once, with all of them named: TypeScript SDK 4.179.0 and [Python](/docs/development/python) 0.134.0.** A read whose `fields` names fields the element type does not have was a `422` that named the first. It is still one `422` with `param` `fields`; its message now lists every unknown name, and the error carries `unknown_fields`, `types_with_field` (for each one another element type has, those types) and `allowed_fields` (the names this type takes). `err.fieldsRefusal` and `ApiError.fields_refusal` return the three as served, and the [errors page](/api/errors/#invalid_request) says so. A list with one unknown name keeps its message. +- **[Unity SDK](/docs/development/unity) v0.44.0** follows serials 132 and 133 and the API's newer answers: each entry of the reading aids and each filled slot of the strand carries its `Type`, `OWFrontDoor.CharterElement` and `CharterSkillElements` give the Charter and its skills as elements, `OWSeat` reads whether a seat may change its Character (`MayChangeCharacter`, `MayChangeCharacterNote`, `FollowsSponsor`), and `OWApiError.IsHostBlocked` names a write the web host refused before the API saw it. A folder it writes names 0.44.0 on its producer line. + - **[TypeScript SDK](/docs/development/typescript#install) 4.178.1: installing it into a JavaScript project no longer installs TypeScript, and `@onlyworlds/sdk/waymark` has types on the older module resolution.** TypeScript was a required peer of the package, so npm placed the newest compiler beside it in every project, used or not; it is optional now. And a TypeScript project with `moduleResolution` set to `node` got "Cannot find module" for the `/waymark` import while the package's root resolved; that import now finds its types there too. Projects on `node16`, `nodenext` or `bundler` read what they read before. No call changes. - **[TypeScript SDK](/docs/development/typescript-accounts#sign-in-with-onlyworlds): on Node 18 the sign-in needs one flag.** The SDK's tests now run on Node 18 as well as 20 and 22, and the Python package's on 3.12, 3.13 and 3.14, the oldest versions each admits included. On Node 18 everything passes but Sign in with OnlyWorlds, which needs Web Crypto as a global: Node 18 has it only when started with `--experimental-global-webcrypto`, and without it `signInWithOnlyWorlds` refuses with a `TypeError` that names Web Crypto. - **[Python](/docs/development/python-import#pages) 0.133.1: the LegendKeeper importer says what each of its two roads leaves unread.** Through LegendKeeper's API an image inside a page does not come in (their API answers it as unsupported, with nothing in it), and the report now says that the export file holds it and that `--file` reads it; from the export file an image is a link to LegendKeeper's host, never copied. The file road names any key of a document's content it does not read. The message for a write the web host refused names the whole way out, in the TypeScript SDK's words. diff --git a/src/content/docs/docs/development/api/reads.md b/src/content/docs/docs/development/api/reads.md index 55da1241..9536afa5 100644 --- a/src/content/docs/docs/development/api/reads.md +++ b/src/content/docs/docs/development/api/reads.md @@ -139,7 +139,7 @@ Elements whose name matches come first, then the rest, each by element type and Both work on lists and on single elements. - **`?expand=location,friends`** replaces those links' ids with stub objects, one level deep: `{id, name, supertype, subtype, image_url}`. A field that is not a link is a `422`. -- **`?fields=id,name,description`** returns only the named keys. +- **`?fields=id,name,description`** returns only the named keys. A name the element type does not have is one `422` for the whole list, `param` `fields`. Since 2026-11-17 it names every unknown name where it named the first: the message lists them, and the error carries `unknown_fields` (each unknown name once, in the order sent), `types_with_field` (for each one another element type has, those types) and `allowed_fields` (the names this type takes), so the list can be corrected in one try. A name under an extension namespace (`atlas_*`, `shadow_*`, `x_*`) is never unknown. ```bash curl -s "https://www.onlyworlds.com/api/v2/character/{id}?expand=location,institutions" -H "API-Key: {key}" diff --git a/src/content/docs/docs/development/typescript.md b/src/content/docs/docs/development/typescript.md index 0c77f573..5616a6e3 100644 --- a/src/content/docs/docs/development/typescript.md +++ b/src/content/docs/docs/development/typescript.md @@ -397,7 +397,7 @@ The package also ships `SCHEMA.md` (every field and its meaning, generated) and ## Reference -Generated from the types of `@onlyworlds/sdk` 4.178.1, the version these docs pin. The full declarations ship in the package (`dist/index.d.ts`), with `SCHEMA.md` and `AGENTS.md` beside them. +Generated from the types of `@onlyworlds/sdk` 4.179.0, the version these docs pin. The full declarations ship in the package (`dist/index.d.ts`), with `SCHEMA.md` and `AGENTS.md` beside them. ### Client options diff --git a/src/content/docs/docs/development/unity.md b/src/content/docs/docs/development/unity.md index 7379b03d..3ddd5ef4 100644 --- a/src/content/docs/docs/development/unity.md +++ b/src/content/docs/docs/development/unity.md @@ -144,7 +144,7 @@ await edit.CommitAsync(client, "character"); // sends { "level": 12 } and nothin **Say when an agent is writing.** If an AI agent drives the client, set `Agent = true` on `OWClientConfig`: element writes then carry `X-OW-Agent`, and onlyworlds.com records them as agent-made. Leave it off in a tool people use. Every element reads `ChangedBy` and `ChangedVia`, and `OWWriteDoor.IsAgent(el.ChangedVia)` tells agent-made work apart; `OWWriteDoor.Site` (since v0.20.0) is the owner's own page on onlyworlds.com, not an agent's door. -**Name your tool, and write only on what you read** (since v0.16.0). `OWClientConfig.Client` names your tool on every element write (`X-OW-Client`, lower case letters, digits and hyphens; default `unity-sdk`), read back as `ChangedClient` and a tombstone's `DeletedClient`. `PatchAsync`, `DeleteAsync` and `EditLinksAsync` take `ifMatch` (the `change_seq` you read): a moved element is refused with `IsPreconditionFailed`, the element as it now stands in `Current`, nothing written. `ChangesAsync(headOnly: true)` sends the last tip's tag back and reads `Unchanged` on a `304`, so a quiet world costs no budget. The PIN is sent only where keel checks it (writes, `/me`, and every call of a ten-digit key). `/me` and an agent's join carry `OWFrontDoor` (who answers for the seat, its Character, the world's Charter), `OWRoom.IsRoomElement` keeps a parlor's room out of a lore view, and the six [proposal](/docs/development/api/proposals) calls are there, a `202` raised as `OWProposedError`. +**Name your tool, and write only on what you read** (since v0.16.0). `OWClientConfig.Client` names your tool on every element write (`X-OW-Client`, lower case letters, digits and hyphens; default `unity-sdk`), read back as `ChangedClient` and a tombstone's `DeletedClient`. `PatchAsync`, `DeleteAsync` and `EditLinksAsync` take `ifMatch` (the `change_seq` you read): a moved element is refused with `IsPreconditionFailed`, the element as it now stands in `Current`, nothing written. `ChangesAsync(headOnly: true)` sends the last tip's tag back and reads `Unchanged` on a `304`, so a quiet world costs no budget. The PIN is sent only where keel checks it (writes, `/me`, and every call of a ten-digit key). `/me` and an agent's join carry `OWFrontDoor` (who answers for the seat, its Character, the world's Charter), `OWRoom.IsRoomElement` keeps a parlor's room out of a lore view, and the six [proposal](/docs/development/api/proposals) calls are there, a `202` raised as `OWProposedError`. Since v0.44.0 `OWFrontDoor.CharterElement` and `CharterSkillElements` give the Charter and its skills as elements (`{type, id}`), each entry of the reading aids and each filled slot of the strand carries its `Type`, `OWSeat` reads `MayChangeCharacter`, `MayChangeCharacterNote` and `FollowsSponsor` from the seats list, and `OWApiError.IsHostBlocked` names a write the host in front of onlyworlds.com refused before the API saw it ([the Blocked page](/api/errors/)). **The world's own settings** (since v0.17.0). `PatchWorldAsync(partial)` writes to the world itself (`PATCH /world`): only the keys you send change, and it returns the world as the server now holds it. A `GetWorldAsync` body can go back whole, since the keys the server refuses there are left out (`OWPayload.WorldReadOnlyFields`). Where a world first came from is written as the plain keys `source` and `producer` and served back under `origin`; the World's own extension keys (`x_*`, `atlas_*`, `shadow_*`, 64 KB in all) go as given, and `null` removes one. A co-builder may send only `time_range_current`, `source`, `producer` and extension keys (anything more is `IsOwnerOnly`). @@ -162,7 +162,7 @@ await edit.CommitAsync(client, "character"); // sends { "level": 12 } and nothin **Other tools' data survives.** Extension fields (`x_*`) that the models don't know are kept verbatim through a read, an edit and a write, in the cache, and through Unity's serializer. The five fields the server owns (`world`, `type`, `created_at`, `updated_at`, `change_seq`) are stripped from every write, so a body you read can be written straight back. -`OWFolderWriter` writes elements and the world into a world folder, byte for byte as the format specifies, so a folder kept in git doesn't change from one machine to the next. `OWFolderExport.ExportAsync(client, folder)` writes a whole account world into a world folder, map images included, the same files the Python package's `export_world` writes. Its `world.json` says where it came from (`source`) and, when the key's `GET /me` can say, which slice it is (`exported_as`), as the [folder format](/docs/schema/folders) asks; since v0.7.0. An export declares folder format 0.3.24 (since v0.41.0; 0.3.22 from v0.39.0; 0.3.21 from v0.26.0; 0.3.20 from v0.24.0; 0.3.18 from v0.19.0; 0.3.17 from v0.18.1; 0.3.16 from v0.17.0, carrying the world's `origin` as the server serves it; 0.3.15 from v0.16.0, 0.3.14 from v0.12.0) and writes the [`producer` line](/docs/schema/folders#worldjson) as the folder's maker, `{"tool": "com.onlyworlds.sdk", "version": "0.43.1", "input": "server"}`, `version` the package's own; a file export carries keel's line as it is and writes none when the file has none. It writes a [known-of](/docs/schema/folders#known-of-elements) stub as the server hands it: the keys a stub keeps, every field it was served with a value, and `known_of: true`, never its unset fields. `OWPayload.IsKnownOf(body)` and `OWElement.IsKnownOf` tell a stub from a whole element, and the client refuses to write one back. A typed calendar era refuses a date it does not hold (the same rule as `@onlyworlds/sdk` 4.42.4). +`OWFolderWriter` writes elements and the world into a world folder, byte for byte as the format specifies, so a folder kept in git doesn't change from one machine to the next. `OWFolderExport.ExportAsync(client, folder)` writes a whole account world into a world folder, map images included, the same files the Python package's `export_world` writes. Its `world.json` says where it came from (`source`) and, when the key's `GET /me` can say, which slice it is (`exported_as`), as the [folder format](/docs/schema/folders) asks; since v0.7.0. An export declares folder format 0.3.24 (since v0.41.0; 0.3.22 from v0.39.0; 0.3.21 from v0.26.0; 0.3.20 from v0.24.0; 0.3.18 from v0.19.0; 0.3.17 from v0.18.1; 0.3.16 from v0.17.0, carrying the world's `origin` as the server serves it; 0.3.15 from v0.16.0, 0.3.14 from v0.12.0) and writes the [`producer` line](/docs/schema/folders#worldjson) as the folder's maker, `{"tool": "com.onlyworlds.sdk", "version": "0.44.0", "input": "server"}`, `version` the package's own; a file export carries keel's line as it is and writes none when the file has none. It writes a [known-of](/docs/schema/folders#known-of-elements) stub as the server hands it: the keys a stub keeps, every field it was served with a value, and `known_of: true`, never its unset fields. `OWPayload.IsKnownOf(body)` and `OWElement.IsKnownOf` tell a stub from a whole element, and the client refuses to write one back. A typed calendar era refuses a date it does not hold (the same rule as `@onlyworlds/sdk` 4.42.4). ## Common pitfalls From 40855cf9f548c983528e0e00820fdebbdc8cca84 Mon Sep 17 00:00:00 2001 From: Titus Date: Tue, 17 Nov 2026 09:18:33 +0100 Subject: [PATCH 2/2] The shapes snapshot follows the error envelope's three new keys Co-Authored-By: Claude Fable 5.2 --- contract/shapes.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/contract/shapes.json b/contract/shapes.json index 32fbed0c..8221e5b8 100644 --- a/contract/shapes.json +++ b/contract/shapes.json @@ -17,7 +17,7 @@ "GET /api/v2/character/{id}/context query": {"props":{"components":{},"mode":{},"as_of":{},"undated":{},"since":{},"budget":{},"depth":{},"lens":{},"compact":{},"world":{}},"required":[]}, "GET /api/v2/character/{id}/files": {"props":{"data":{"items":{"props":{"id":{},"name":{},"kind":{},"size":{},"label":{},"added_by":{"props":{"name":{},"membership":{},"agent":{},"owner":{}},"required":["name","membership","agent","owner"]},"added_at":{}},"required":["id","name","kind","size","label","added_by","added_at"]}}},"required":["data"]}, "GET /api/v2/collective query": {"props":{"limit":{},"cursor":{},"expand":{},"fields":{},"name":{},"name__icontains":{},"supertype":{},"subtype":{},"characters":{},"operator":{},"ids":{},"created_by":{},"as":{},"world":{}},"required":[]}, - "GET /api/v2/marker/{id} 410": {"props":{"error":{"props":{"type":{},"code":{},"message":{},"param":{},"doc_url":{},"refusals":{"items":{"props":{"word":{},"stop_reason":{},"output_tokens":{}},"required":["word","stop_reason","output_tokens"]}},"reason":{}},"required":["type","code","message","param","doc_url"]},"change_seq":{},"deleted_at":{}},"required":["error","change_seq","deleted_at"]}, + "GET /api/v2/marker/{id} 410": {"props":{"error":{"props":{"type":{},"code":{},"message":{},"param":{},"doc_url":{},"refusals":{"items":{"props":{"word":{},"stop_reason":{},"output_tokens":{}},"required":["word","stop_reason","output_tokens"]}},"unknown_fields":{"items":{}},"types_with_field":{"props":{},"required":[],"open":true},"allowed_fields":{"items":{}},"reason":{}},"required":["type","code","message","param","doc_url"]},"change_seq":{},"deleted_at":{}},"required":["error","change_seq","deleted_at"]}, "GET /api/v2/me": {"props":{"world":{"props":{"id":{},"name":{}},"required":["id","name"]},"scope":{},"kind":{},"role":{},"membership":{},"character":{},"lenses":{"items":{}},"lenses_from":{},"x_served_trimmed":{"items":{"const":"lenses"}},"name":{},"front_door":{"props":{"sponsor":{"props":{"id":{},"kind":{},"name":{}},"required":["id","kind","name"]},"sponsor_character":{},"my_character":{},"my_seats":{"items":{"props":{"id":{},"kind":{},"name":{},"character":{}},"required":["id","kind","name","character"]}},"charter":{},"charter_skill":{"items":{}},"charter_element":{"props":{"type":{"const":"law"},"id":{}},"required":["type","id"]},"charter_skill_elements":{"items":{"props":{"type":{"const":"object"},"id":{}},"required":["type","id"]}}},"required":["sponsor","sponsor_character","my_character","my_seats","charter","charter_skill","charter_element","charter_skill_elements"]},"reading_aids":{"props":{"charter":{"props":{"id":{},"type":{"const":"law"},"name":{},"rules":{"items":{}},"skill":{"items":{}}},"required":["id","type","name","rules","skill"]},"guide":{"props":{"id":{},"type":{"const":"construct"},"name":{}},"required":["id","type","name"]},"domains":{"items":{"props":{"id":{},"type":{"const":"construct"},"name":{},"sentence":{},"hubs":{"items":{"props":{"type":{},"id":{}},"required":["type","id"]}}},"required":["id","type","name","sentence","hubs"]}},"strand":{"props":{"narrative":{"props":{"id":{},"type":{"const":"narrative"},"name":{}},"required":["id","type","name"]},"event":{"props":{"id":{},"type":{"const":"event"},"name":{}},"required":["id","type","name"]},"location":{"props":{"id":{},"type":{"const":"location"},"name":{}},"required":["id","type","name"]},"character":{"props":{"id":{},"type":{"const":"character"},"name":{}},"required":["id","type","name"]},"now":{"props":{"id":{},"type":{"const":"location"},"name":{}},"required":["id","type","name"]},"same":{}},"required":["narrative","event","location","character","now","same"]}},"required":["charter","guide","domains","strand"]}},"required":["world","scope","kind","role","membership","character","lenses","lenses_from","front_door","reading_aids"]}, "GET /api/v2/members": {"props":{"data":{"items":{"props":{"id":{},"kind":{},"role":{},"character":{},"status":{},"name":{},"lenses":{"items":{}},"lenses_from":{},"sponsor_member":{},"x_served_trimmed":{"items":{"const":"lenses"}}},"required":["id","kind","role","character","status","lenses","lenses_from"]}}},"required":["data"]}, "GET /api/v2/pin query": {"props":{"limit":{},"cursor":{},"expand":{},"fields":{},"name":{},"name__icontains":{},"supertype":{},"subtype":{},"map":{},"element":{},"ids":{},"created_by":{},"as":{},"world":{}},"required":[]}, @@ -28,7 +28,7 @@ "GET /api/v2/world/files": {"props":{"data":{"items":{"props":{"id":{},"name":{},"kind":{},"size":{},"label":{},"added_by":{"props":{"name":{},"membership":{},"agent":{},"owner":{}},"required":["name","membership","agent","owner"]},"added_at":{},"element_type":{},"element_id":{}},"required":["id","name","kind","size","label","added_by","added_at","element_type","element_id"]}},"used_bytes":{},"cap_bytes":{}},"required":["data","used_bytes","cap_bytes"]}, "GET /api/v2/world/hidden": {"props":{"data":{"items":{"props":{"type":{},"id":{},"set_at":{},"set_by":{}},"required":["type","id","set_at","set_by"]}}},"required":["data"]}, "Narrative": {"$":"Narrative"}, - "PATCH /api/v2/character/{id} 412": {"props":{"error":{"props":{"type":{},"code":{},"message":{},"param":{},"doc_url":{},"refusals":{"items":{"props":{"word":{},"stop_reason":{},"output_tokens":{}},"required":["word","stop_reason","output_tokens"]}},"reason":{}},"required":["type","code","message","param","doc_url"]},"current":{"$":"Character"}},"required":["error","current"]}, + "PATCH /api/v2/character/{id} 412": {"props":{"error":{"props":{"type":{},"code":{},"message":{},"param":{},"doc_url":{},"refusals":{"items":{"props":{"word":{},"stop_reason":{},"output_tokens":{}},"required":["word","stop_reason","output_tokens"]}},"unknown_fields":{"items":{}},"types_with_field":{"props":{},"required":[],"open":true},"allowed_fields":{"items":{}},"reason":{}},"required":["type","code","message","param","doc_url"]},"current":{"$":"Character"}},"required":["error","current"]}, "PATCH /api/v2/world request": {"$":"WorldPatch"}, "POST /api/v2/account/worlds/{world_id}/seats request": {"props":{"name":{},"role":{},"character":{}},"required":["name"]}, "POST /api/v2/auth/token": {"title":"SigninToken","props":{"token":{},"token_id":{},"token_type":{"const":"bearer"},"scope":{"const":"world:read"},"expires_at":{},"account":{"props":{"id":{},"username":{}},"required":["id","username"]},"ai_token":{"props":{"token":{},"token_id":{},"token_type":{"const":"bearer"},"audience":{"const":"ai"},"ai_uses":{"items":{}},"expires_at":{}},"required":["token","token_id","token_type","audience","ai_uses","expires_at"]}},"required":["token","token_id","token_type","expires_at","account"]}, @@ -44,7 +44,7 @@ "defs": { "Ability": {"props":{"type":{"const":"ability"},"id":{},"name":{},"description":{},"supertype":{},"subtype":{},"image_url":{},"activation":{},"challenges":{},"prevalence":{},"duration":{},"potency":{},"range":{},"tradition":{},"source":{},"locus":{},"effects":{"items":{}},"talents":{"items":{}},"requisites":{"items":{}},"instruments":{"items":{}},"systems":{"items":{}},"created_at":{},"updated_at":{},"change_seq":{},"created_by":{},"changed_by":{},"changed_via":{},"changed_client":{},"doors":{"props":{},"required":[],"open":true},"known_of":{"const":true},"hidden":{"const":true}},"required":["type","id","name","description","supertype","subtype","image_url","activation","challenges","prevalence","duration","potency","range","tradition","source","locus","effects","talents","requisites","instruments","systems","created_at","updated_at","change_seq"],"patterns":["^(atlas_|shadow_|x_)"]}, "AccountInvite": {"props":{"id":{},"email":{},"role":{},"created_at":{}},"required":["id","email","role","created_at"]}, - "BulkResult": {"props":{"errors":{},"items":{"items":{"props":{"status":{},"id":{},"created_at":{},"updated_at":{},"proposal":{"$":"Proposal"},"error":{"props":{"type":{},"code":{},"message":{},"param":{},"doc_url":{},"refusals":{"items":{"props":{"word":{},"stop_reason":{},"output_tokens":{}},"required":["word","stop_reason","output_tokens"]}}},"required":["type","code","message","param","doc_url"]}},"required":["status","id"]}}},"required":["errors","items"]}, + "BulkResult": {"props":{"errors":{},"items":{"items":{"props":{"status":{},"id":{},"created_at":{},"updated_at":{},"proposal":{"$":"Proposal"},"error":{"props":{"type":{},"code":{},"message":{},"param":{},"doc_url":{},"refusals":{"items":{"props":{"word":{},"stop_reason":{},"output_tokens":{}},"required":["word","stop_reason","output_tokens"]}},"unknown_fields":{"items":{}},"types_with_field":{"props":{},"required":[],"open":true},"allowed_fields":{"items":{}}},"required":["type","code","message","param","doc_url"]}},"required":["status","id"]}}},"required":["errors","items"]}, "ChangesPage": {"props":{"cursor":{},"changes":{"items":{"oneOf":[{"props":{"op":{"const":"upsert"},"type":{},"id":{},"change_seq":{},"updated_at":{},"element":{"byType":true},"changed_at":{},"changed_by":{},"changed_via":{}},"required":["op","type","id","change_seq","updated_at","element"]},{"props":{"op":{"const":"delete"},"type":{},"id":{},"change_seq":{},"deleted_at":{},"deleted_by":{},"deleted_via":{},"deleted_client":{},"reason":{}},"required":["op","type","id","change_seq","deleted_at","reason"]}]}},"has_more":{},"head":{},"epoch":{},"epoch_reason":{}},"required":["cursor","changes","has_more","head","epoch","epoch_reason"]}, "Character": {"props":{"type":{"const":"character"},"id":{},"name":{},"description":{},"supertype":{},"subtype":{},"image_url":{},"physicality":{},"mentality":{},"background":{},"motivations":{},"reputation":{},"height":{},"weight":{},"birth_date":{},"charisma":{},"coercion":{},"competence":{},"compassion":{},"creativity":{},"courage":{},"level":{},"hit_points":{},"STR":{},"DEX":{},"CON":{},"INT":{},"WIS":{},"CHA":{},"birthplace":{},"location":{},"species":{"items":{}},"traits":{"items":{}},"abilities":{"items":{}},"languages":{"items":{}},"objects":{"items":{}},"institutions":{"items":{}},"family":{"items":{}},"friends":{"items":{}},"rivals":{"items":{}},"created_at":{},"updated_at":{},"change_seq":{},"created_by":{},"changed_by":{},"changed_via":{},"changed_client":{},"doors":{"props":{},"required":[],"open":true},"known_of":{"const":true},"hidden":{"const":true}},"required":["type","id","name","description","supertype","subtype","image_url","physicality","mentality","background","motivations","reputation","height","weight","birth_date","charisma","coercion","competence","compassion","creativity","courage","level","hit_points","STR","DEX","CON","INT","WIS","CHA","birthplace","location","species","traits","abilities","languages","objects","institutions","family","friends","rivals","created_at","updated_at","change_seq"],"patterns":["^(atlas_|shadow_|x_)"]}, "CharacterList": {"props":{"data":{"items":{"$":"Character"}},"has_more":{},"next_cursor":{}},"required":["data","has_more","next_cursor"]}, @@ -52,7 +52,7 @@ "Construct": {"props":{"type":{"const":"construct"},"id":{},"name":{},"description":{},"supertype":{},"subtype":{},"image_url":{},"rationale":{},"history":{},"status":{},"reach":{},"start_date":{},"end_date":{},"founder":{},"custodian":{},"characters":{"items":{}},"objects":{"items":{}},"locations":{"items":{}},"species":{"items":{}},"creatures":{"items":{}},"institutions":{"items":{}},"traits":{"items":{}},"collectives":{"items":{}},"zones":{"items":{}},"abilities":{"items":{}},"phenomena":{"items":{}},"languages":{"items":{}},"families":{"items":{}},"relations":{"items":{}},"titles":{"items":{}},"constructs":{"items":{}},"events":{"items":{}},"narratives":{"items":{}},"created_at":{},"updated_at":{},"change_seq":{},"created_by":{},"changed_by":{},"changed_via":{},"changed_client":{},"doors":{"props":{},"required":[],"open":true},"known_of":{"const":true},"hidden":{"const":true},"x_served_trimmed":{"items":{}}},"required":["type","id","name","description","supertype","subtype","image_url","rationale","history","status","reach","start_date","end_date","founder","custodian","characters","objects","locations","species","creatures","institutions","traits","collectives","zones","abilities","phenomena","languages","families","relations","titles","constructs","events","narratives","created_at","updated_at","change_seq"],"patterns":["^(atlas_|shadow_|x_)"]}, "Creature": {"props":{"type":{"const":"creature"},"id":{},"name":{},"description":{},"supertype":{},"subtype":{},"image_url":{},"appearance":{},"habits":{},"demeanor":{},"status":{},"weight":{},"height":{},"birth_date":{},"challenge_rating":{},"hit_points":{},"armor_class":{},"speed":{},"location":{},"zone":{},"species":{"items":{}},"traits":{"items":{}},"abilities":{"items":{}},"languages":{"items":{}},"actions":{"items":{}},"created_at":{},"updated_at":{},"change_seq":{},"created_by":{},"changed_by":{},"changed_via":{},"changed_client":{},"doors":{"props":{},"required":[],"open":true},"known_of":{"const":true},"hidden":{"const":true}},"required":["type","id","name","description","supertype","subtype","image_url","appearance","habits","demeanor","status","weight","height","birth_date","challenge_rating","hit_points","armor_class","speed","location","zone","species","traits","abilities","languages","actions","created_at","updated_at","change_seq"],"patterns":["^(atlas_|shadow_|x_)"]}, "Draught": {"props":{"world":{"props":{"id":{},"name":{},"description":{}},"required":["id","name","description"]},"calendar":{"unsaid":true},"as_of":{},"now":{},"mode":{},"reader":{},"policy":{"unsaid":true},"cut":{"props":{},"required":[],"open":true},"recent_cursor":{},"recent_more":{},"character":{"props":{"self":{"const":true},"grade":{},"element":{"unsaid":true}},"required":["self","grade","element"]},"role":{"items":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true}},"required":["via","her_links","grade","element"]}},"work":{"items":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true},"packet":{"items":{"unsaid":true}},"by_role":{"items":{}}},"required":["via","her_links","grade","element","packet","by_role"]}},"style":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true}},"required":["via","her_links","grade","element"]},"events":{"items":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true},"dated":{}},"required":["via","her_links","grade","element","dated"]}},"knowledge":{"items":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true},"dated":{},"circles":{"items":{}}},"required":["via","her_links","grade","element","dated"]}},"names":{"props":{},"required":[],"open":true},"sheet":{"items":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true}},"required":["via","her_links","grade","element"]}},"messages":{"items":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true},"author":{"props":{"membership":{},"kind":{},"role":{}},"required":["membership","kind","role"]}},"required":["via","her_links","grade","element","author"]}},"room":{"items":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true},"circles":{"items":{}}},"required":["via","her_links","grade","element"]}},"proposed":{"items":{"props":{"via":{"items":{}},"her_links":{},"grade":{},"element":{"unsaid":true},"circles":{"items":{}}},"required":["via","her_links","grade","element"]}},"recent":{"items":{"props":{"op":{},"type":{},"id":{},"when":{},"who":{},"door":{}},"required":["op","type","id","when","who","door"]}},"roster":{"items":{"props":{"id":{},"kind":{},"role":{},"character":{},"status":{},"name":{}},"required":["id","kind","role","character","status"]}},"lenses":{"items":{"props":{"id":{},"name":{},"rows":{"items":{"unsaid":true}},"cut":{"props":{},"required":[],"open":true},"mail":{"unsaid":true},"skipped":{},"unreadable":{}},"required":["id"]}}},"required":["world","calendar","as_of","now","mode","policy"]}, - "Error": {"props":{"error":{"props":{"type":{},"code":{},"message":{},"param":{},"doc_url":{},"refusals":{"items":{"props":{"word":{},"stop_reason":{},"output_tokens":{}},"required":["word","stop_reason","output_tokens"]}},"reason":{}},"required":["type","code","message","param","doc_url"]}},"required":["error"]}, + "Error": {"props":{"error":{"props":{"type":{},"code":{},"message":{},"param":{},"doc_url":{},"refusals":{"items":{"props":{"word":{},"stop_reason":{},"output_tokens":{}},"required":["word","stop_reason","output_tokens"]}},"unknown_fields":{"items":{}},"types_with_field":{"props":{},"required":[],"open":true},"allowed_fields":{"items":{}},"reason":{}},"required":["type","code","message","param","doc_url"]}},"required":["error"]}, "Event": {"props":{"type":{"const":"event"},"id":{},"name":{},"description":{},"supertype":{},"subtype":{},"image_url":{},"history":{},"challenges":{},"consequences":{},"start_date":{},"end_date":{},"triggers":{"items":{}},"characters":{"items":{}},"objects":{"items":{}},"locations":{"items":{}},"species":{"items":{}},"creatures":{"items":{}},"institutions":{"items":{}},"traits":{"items":{}},"collectives":{"items":{}},"zones":{"items":{}},"abilities":{"items":{}},"phenomena":{"items":{}},"languages":{"items":{}},"families":{"items":{}},"relations":{"items":{}},"titles":{"items":{}},"constructs":{"items":{}},"created_at":{},"updated_at":{},"change_seq":{},"created_by":{},"changed_by":{},"changed_via":{},"changed_client":{},"doors":{"props":{},"required":[],"open":true},"known_of":{"const":true},"hidden":{"const":true}},"required":["type","id","name","description","supertype","subtype","image_url","history","challenges","consequences","start_date","end_date","triggers","characters","objects","locations","species","creatures","institutions","traits","collectives","zones","abilities","phenomena","languages","families","relations","titles","constructs","created_at","updated_at","change_seq"],"patterns":["^(atlas_|shadow_|x_)"]}, "Family": {"props":{"type":{"const":"family"},"id":{},"name":{},"description":{},"supertype":{},"subtype":{},"image_url":{},"spirit":{},"history":{},"reputation":{},"traditions":{"items":{}},"traits":{"items":{}},"abilities":{"items":{}},"languages":{"items":{}},"ancestors":{"items":{}},"estates":{"items":{}},"governs":{"items":{}},"heirlooms":{"items":{}},"creatures":{"items":{}},"created_at":{},"updated_at":{},"change_seq":{},"created_by":{},"changed_by":{},"changed_via":{},"changed_client":{},"doors":{"props":{},"required":[],"open":true},"known_of":{"const":true},"hidden":{"const":true}},"required":["type","id","name","description","supertype","subtype","image_url","spirit","history","reputation","traditions","traits","abilities","languages","ancestors","estates","governs","heirlooms","creatures","created_at","updated_at","change_seq"],"patterns":["^(atlas_|shadow_|x_)"]}, "Institution": {"props":{"type":{"const":"institution"},"id":{},"name":{},"description":{},"supertype":{},"subtype":{},"image_url":{},"doctrine":{},"status":{},"founding_date":{},"parent_institution":{},"zones":{"items":{}},"objects":{"items":{}},"creatures":{"items":{}},"allies":{"items":{}},"adversaries":{"items":{}},"constructs":{"items":{}},"created_at":{},"updated_at":{},"change_seq":{},"created_by":{},"changed_by":{},"changed_via":{},"changed_client":{},"doors":{"props":{},"required":[],"open":true},"known_of":{"const":true},"hidden":{"const":true}},"required":["type","id","name","description","supertype","subtype","image_url","doctrine","status","founding_date","parent_institution","zones","objects","creatures","allies","adversaries","constructs","created_at","updated_at","change_seq"],"patterns":["^(atlas_|shadow_|x_)"]},