diff --git a/package-lock.json b/package-lock.json index 5fe1bc45..f21711e9 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,7 +14,7 @@ "starlight-page-actions": "0.7.1" }, "devDependencies": { - "@onlyworlds/sdk": "4.171.1", + "@onlyworlds/sdk": "4.172.0", "typescript": "5.9.3" } }, @@ -1685,9 +1685,9 @@ } }, "node_modules/@onlyworlds/sdk": { - "version": "4.171.1", - "resolved": "https://registry.npmjs.org/@onlyworlds/sdk/-/sdk-4.171.1.tgz", - "integrity": "sha512-PPcsrUC8KevPtqKrlT1mzovrUIwh+BXxkodT4SK45m2JSlT4qUmLRvf99j4HnlZZDMpHE4yLpf/7vZGDqqPW+g==", + "version": "4.172.0", + "resolved": "https://registry.npmjs.org/@onlyworlds/sdk/-/sdk-4.172.0.tgz", + "integrity": "sha512-pzwyG76Ts8o8tEMuThnKBoMK9dn/b6NAhxnDoKDdIP6vzujRIrTUMeX7TBFkNkIp6uUwnqOFs+6eNEju5TPKoA==", "dev": true, "license": "MIT", "dependencies": { diff --git a/package.json b/package.json index a6a0d838..06b27bd2 100644 --- a/package.json +++ b/package.json @@ -17,7 +17,7 @@ "starlight-page-actions": "0.7.1" }, "devDependencies": { - "@onlyworlds/sdk": "4.171.1", + "@onlyworlds/sdk": "4.172.0", "typescript": "5.9.3" }, "overrides": { diff --git a/src/content/docs/docs/changelog.md b/src/content/docs/docs/changelog.md index aa46cf1f..1b15cea4 100644 --- a/src/content/docs/docs/changelog.md +++ b/src/content/docs/docs/changelog.md @@ -9,6 +9,7 @@ What changed on onlyworlds.com for everyone is on its own [Changelog](https://ww ## 2026-11-16 +- **[Your seat list](/docs/development/agents#making-a-seat) says whether each seat may change its Character.** `GET /api/v2/account/worlds/{world_id}/seats` serves `may_change_character`, `may_change_character_note` and `follows_sponsor` on every row, in the words of the owner's [members list](/docs/development/api/members#agent-seats). Where a seat's Character is kept from you, the row reads `character` `null`, `may_change_character` `false` and no note. TypeScript SDK 4.172.0 types the three on `listSeats()`'s rows. - **[A world laid out in 3D](/docs/development/typescript-readers#a-world-laid-out-in-3d): TypeScript SDK 4.171.1 and [Python](/docs/development/python) 0.130.1.** A Map whose width or height is under 0 no longer stops the layout: a width or height that is not over 0 makes the Map no plate, and the world is laid out by its links. A layout that hands earlier points back no longer works out the push between two elements that both stand still, so keeping a picture still costs less than laying it out from nothing; no point of any answer changes. The page now says how to count what is new: by the ids you did not hand back. - **[A world laid out in 3D](/docs/development/typescript-readers#a-world-laid-out-in-3d): TypeScript SDK 4.171.0's `layoutByLinks3d` and [Python](/docs/development/python) 0.130.0's `layout_by_links_3d`.** One method in both packages lays a whole graph out in three dimensions by its links, with the world's map as a flat plate, and held points keep a picture still as the world grows. Its word, `by-links-3d`, is the tool's own until its page in the standard is published. - **[The default layouts are a profile](/docs/schema/profiles#default-layouts) (serial 132).** The two methods that draw a world nobody has laid out, `by-kind` and `around`, are written out in the standard, with a fixture of 17, 10 and 15 cases: the same graph gives the same points in every tool and language. A method's word is its version. The [map-space profile](/docs/schema/profiles#map-space)'s rule on layout maps now ends on what reading may do: reading or drawing a layout map changes none of its Pins, and laying it out again is a write like any other. diff --git a/src/content/docs/docs/development/agents.md b/src/content/docs/docs/development/agents.md index 60511326..61f6f1be 100644 --- a/src/content/docs/docs/development/agents.md +++ b/src/content/docs/docs/development/agents.md @@ -26,7 +26,7 @@ Three ways, in the order to reach for them: | `role` | At most your own role (`co_builder` > `contributor` > `guest`); the owner may give any. Default `contributor`, or your own role when that is lower. It stays that way: when the owner lowers your role, your seats in that world above your new role are lowered to it; a promotion raises none. | | `character` | `new` (the default): a Character of its own, supertype Agent. `none`: no Character. `mine` (a member only): it plays the Character you play here, and goes on playing what you play when you pick another; the owner chooses `new` or `none`. | -The answer (`201`) carries the seat, its `key`, its secret as `pin`, and the `env` lines, shown in this answer only. There is no `Idempotency-Key` on this route, so a key is never stored for a replay. `GET .../seats` lists the seats you sponsor (the owner sees all), never with a key; `DELETE .../seats/{seat_id}` removes one. One account sponsors at most five live seats in a world, and a world holds at most 50 agents, counting agent links not yet used (`422`). +The answer (`201`) carries the seat, its `key`, its secret as `pin`, and the `env` lines, shown in this answer only. There is no `Idempotency-Key` on this route, so a key is never stored for a replay. `GET .../seats` lists the seats you sponsor (the owner sees all), never with a key; `DELETE .../seats/{seat_id}` removes one. Since 2026-11-16 each row of that list also says whether the seat may change the Character it plays, in the fields of [the owner's members list](/docs/development/api/members#agent-seats): `may_change_character`, `may_change_character_note` (a sentence saying why it may not, else `null`) and `follows_sponsor`. Where a seat's Character is kept from you, the row reads `character` `null`, `may_change_character` `false` and no note. One account sponsors at most five live seats in a world, and a world holds at most 50 agents, counting agent links not yet used (`422`). **A new key.** When a seat's key is lost, its sponsor or the owner makes a new one: `POST .../seats/{seat_id}/key`, or **New key** on the world's page. The old key and secret stop working at once (the old key answers `401` `key_revoked`, so the AI can tell a replaced key from a wrong one); the seat keeps its role, its Character and everything it wrote. A seat whose sponsor has left the world left with them, so the way back is a new seat, invited again. A person who lost their own key lists their worlds with their account and makes a new key there. The policy's [Lost your key](https://www.onlyworlds.com/agents) says the same for people who don't read code. @@ -163,7 +163,7 @@ Every seat has a human sponsor who answers for it: for a seat a member made, tha **No AI above its person.** The owner cannot give an agent seat a role above the role of the person who answers for it: `422` [`seat_above_sponsor`](/api/errors/#seat_above_sponsor) (`param: role`). A seat made for an email address is raised like any other, up to the role of the person who answers for it. A seat whose sponsor is no member of the world cannot be raised above its own role at all; the owner hands that seat to themselves first (`sponsor` `owner`), in the same request or before; the owner's own seats have no cap. A member who comes back to a world brings the seats they answer for down to the role they return with. -**A seat that follows its member.** A seat a member made with `character` `mine` plays what that member plays: when the member picks another Character, lets theirs go, has their role changed, or the Character's author changes, the seat's Character and its right to change it move with theirs. The owner cannot set such a seat's Character: `422` [`seat_follows_sponsor`](/api/errors/#seat_follows_sponsor) (`param: character`) until the seat is handed to someone else. The owner's members list says which seats follow (`follows_sponsor`). +**A seat that follows its member.** A seat a member made with `character` `mine` plays what that member plays: when the member picks another Character, lets theirs go, has their role changed, or the Character's author changes, the seat's Character and its right to change it move with theirs. The owner cannot set such a seat's Character: `422` [`seat_follows_sponsor`](/api/errors/#seat_follows_sponsor) (`param: character`) until the seat is handed to someone else. The owner's members list says which seats follow (`follows_sponsor`), and so does your own seat list. ## In-world messages diff --git a/src/content/docs/docs/development/api/members.mdx b/src/content/docs/docs/development/api/members.mdx index 86c5a308..6a3919e8 100644 --- a/src/content/docs/docs/development/api/members.mdx +++ b/src/content/docs/docs/development/api/members.mdx @@ -282,7 +282,7 @@ Invites and memberships are managed in the [account portal](https://www.onlyworl | GET | `/api/v2/account/worlds/{world_id}/links` | The world's links, newest first, never a code, each with `uses` and `status` (`pending`, `used`, `revoked`, `expired`); a table's row adds `max_uses` and `characters` (`[{id, name, taken}]`, `name` `null` if deleted), its `uses` counts the seats it made, removed ones included, and it reads `used` once full | | DELETE | `/api/v2/account/worlds/{world_id}/links/{link_id}` | Revoke a link: `204` | | POST | `/api/v2/account/worlds/{world_id}/seats` | Make a seat for your own AI ([Making a seat](/docs/development/agents#making-a-seat)): `201` with its key and secret, shown once | -| GET | `/api/v2/account/worlds/{world_id}/seats` | Your seats; the owner sees every seat; never a key | +| GET | `/api/v2/account/worlds/{world_id}/seats` | Your seats; the owner sees every seat; never a key. Each row carries `may_change_character`, `may_change_character_note` and `follows_sponsor` as an [agent row](#agent-seats) of the members list does (since 2026-11-16); a seat whose Character is kept from you reads `character` `null`, `false` and no note | | DELETE | `/api/v2/account/worlds/{world_id}/seats/{seat_id}` | Remove a seat (its sponsor or the owner) | | POST | `/api/v2/account/worlds/{world_id}/seats/{seat_id}/key` | A new key and secret for a seat; the old key answers `key_revoked` | | POST | `/api/v2/account/worlds/{world_id}/leave` | Leave a world; your keys for it are deleted, and the AI seats you made there are removed with them | diff --git a/src/content/docs/docs/development/typescript.md b/src/content/docs/docs/development/typescript.md index 5d8625a6..034ed3ee 100644 --- a/src/content/docs/docs/development/typescript.md +++ b/src/content/docs/docs/development/typescript.md @@ -395,7 +395,7 @@ The package also ships `SCHEMA.md` (every field and its meaning, generated) and ## Reference -Generated from the types of `@onlyworlds/sdk` 4.171.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.172.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