@onlyworlds/sdk 4.72.1 → 4.72.3

package/dist/index.js

@@ -98,8 +98,8 @@ var OwApiError = class extends Error {
     return this.status === 409 && this.code === "idempotency_error";
   }
   /**
-   * A request with this Idempotency-Key is still running (409 `idempotency_in_flight`, keel
-   * #307, D105): two sends of one create or bulk overlapped. Nothing was written by this one.
+   * A request with this Idempotency-Key is still running (409 `idempotency_in_flight`):
+   * two sends of one create or bulk overlapped. Nothing was written by this one.
    * Wait `retryAfter` seconds (keel sends 1) and send again with the SAME key and body: once
    * the first has answered, that retry replays its answer. Not a key conflict (see above).
    */
@@ -108,7 +108,7 @@ var OwApiError = class extends Error {
   }
   /**
    * The id is already taken (409 `id_conflict`): a create with an id that exists
-   * (keel D39), or a PUT whose id belongs to another world (D70). Retrying will not
+   * or a PUT whose id belongs to another world. Retrying will not
    * help; the id is the problem. `/bulk` never throws for this: it answers 200 with a
    * per-item slot `{status: 409, error: {code: 'id_conflict'}}` — check the slot.
    */
@@ -118,18 +118,18 @@ var OwApiError = class extends Error {
   /**
    * `/changes` refused the cursor (409 `resync_required`): what this key may see changed
    * (a guest's slice moved; an element hidden from a contributor was unhidden; the key's role
-   * moved to or from guest or contributor, whose cursors have other shapes; keel #421). Drop
+   * moved to or from guest or contributor, whose cursors have other shapes). Drop
    * the stored cursor and walk again from the start. What to do with what the local copy holds
    * that the new walk does not name is `resyncReason`'s: `role`, keep it; `view`, drop it.
    * Without a reason (keel's hidden mark off), keep it: a reset never empties a copy (keel PR
-   * 104, the Captain's ruling: sharing is forward-only). Never empty the copy on your own.
+   * 104, ruled by Titus: sharing is forward-only). Never empty the copy on your own.
    */
   get isResyncRequired() {
     return this.status === 409 && this.code === "resync_required";
   }
   /**
    * Why `/changes` refused the cursor, from the 409 `resync_required` envelope's `reason`
-   * (keel #421, only while keel's hidden mark is on): `role` (this key's own role or
+   * (only while keel's hidden mark is on): `role` (this key's own role or
    * membership moved: keep what the local copy holds that the new walk does not name; it is
    * out of view now, not gone) or `view` (something left this key's view: a delete, a hide, an
    * unhide, a Character change; drop what the new walk does not name). When both happened
@@ -149,7 +149,7 @@ var OwApiError = class extends Error {
   }
   /**
    * A contributor tried to change, replace, relink or delete an element someone else
-   * created (403 `not_author`, keel D72 membership phase 2). Retrying will not help; the
+   * created (403 `not_author`). Retrying will not help; the
    * element is not theirs. `/bulk` never throws for this: it answers 200 with a per-item
    * slot `{status: 403, error: {code: 'not_author'}}`. Owners and co-builders never see it.
    */
@@ -158,7 +158,7 @@ var OwApiError = class extends Error {
   }
   /**
    * A member key tried what only the owner may do: `patchWorld`, even with a co-builder's
-   * key (403 `owner_only`, keel D72; sharing's publish, republish and revoke answer
+   * key (403 `owner_only`; sharing's publish, republish and revoke answer
    * contributors and guests with the same code). Retrying will not help. The owner's own
    * key never sees it.
    */
@@ -166,7 +166,7 @@ var OwApiError = class extends Error {
     return this.status === 403 && this.code === "owner_only";
   }
   /**
-   * A member key sent `viewAs` (403 `view_as_owner_only`, keel #421): reading as another
+   * A member key sent `viewAs` (403 `view_as_owner_only`): reading as another
    * reader is the owner's, from a key with no member. Retrying will not help. Only while
    * keel's hidden mark is on; until then `viewAs` is an unknown parameter (422).
    */
@@ -185,7 +185,7 @@ var OwApiError = class extends Error {
   }
   /**
    * A `patch` or `editLinks` sent with `ifMatch` found the element moved past that
-   * `change_seq` (412 `precondition_failed`, keel #210): nothing was written and nothing
+   * `change_seq` (412 `precondition_failed`): nothing was written and nothing
    * merged. The error is an OwPreconditionFailedError; its `current` is the element as it
    * is now, so no second read is needed.
    */
@@ -197,7 +197,7 @@ var OwApiError = class extends Error {
     return this.status === 404 && this.code === "not_found";
   }
   /**
-   * redeemJoin on a table (keel #422 PR 2): the picked Character is one a live seat in the
+   * redeemJoin on a table: the picked Character is one a live seat in the
    * world already plays (422 `character_taken`, `param` character). Pick another from a fresh
    * previewJoin, whose `characters` mark each `taken`. The code is not spent.
    */
@@ -205,7 +205,7 @@ var OwApiError = class extends Error {
     return this.status === 422 && this.code === "character_taken";
   }
   /**
-   * setMyCharacter, or the member PATCH's `character` (keel #421, PR 160): the picked Character is
+   * setMyCharacter, or the member PATCH's `character`: the picked Character is
    * hidden (422 `character_hidden`, `param` character). Unhide it first, or pick another.
    */
   get isCharacterHidden() {
@@ -213,7 +213,7 @@ var OwApiError = class extends Error {
   }
   /**
    * The `character` sent was refused (422 `invalid_request`, `param` character). On redeemJoin
-   * at a table (keel #422 PR 2): the pick is off the link's list, hidden or deleted since the
+   * at a table: the pick is off the link's list, hidden or deleted since the
    * link was made, or missing, or sent to a table with no list (send `name` instead); one
    * answer for all, so read previewJoin again and pick from its `characters`. The code is not
    * spent. On createWorldLink: a `character` keel refused (not a Character of the world, a
@@ -224,7 +224,7 @@ var OwApiError = class extends Error {
     return this.status === 422 && this.code === "invalid_request" && this.param === "character";
   }
   /**
-   * redeemJoin (keel #422 PR 2): the world already has its 50 live players (422 `world_full`),
+   * redeemJoin: the world already has its 50 live players (422 `world_full`),
    * at any player link, a table's or a link for one's. Nothing is spent; a place frees when the
    * owner removes a player.
    */
@@ -241,14 +241,14 @@ var OwApiError = class extends Error {
   }
   /**
    * A daily allowance is used up (429 `quota_exceeded`): the world's image tickets, its file
-   * tickets (200 a day, keel #393), or the account's asks. See retryAfter.
+   * tickets (200 a day), or the account's asks. See retryAfter.
    */
   get isQuotaExceeded() {
     return this.status === 429 && this.code === "quota_exceeded";
   }
   /**
    * createFileTicket / uploadFile: the file is over the 25 MB a file may be (413
-   * `file_too_large`, `param` size, keel #393); the message gives both sizes. Nothing was
+   * `file_too_large`, `param` size); the message gives both sizes. Nothing was
    * issued. Not the upload host's 413 `too_large` (bytes past a ticket's `max_bytes`).
    */
   get isFileTooLarge() {
@@ -256,7 +256,7 @@ var OwApiError = class extends Error {
   }
   /**
    * createFileTicket / uploadFile: the world's files have no room for this one (403
-   * `files_full`, keel #393: 250 MB a world); the message gives the world's use, its cap and
+   * `files_full`: 250 MB a world); the message gives the world's use, its cap and
    * the file's size. Remove a file, or ask the owner. Nothing was issued.
    */
   get isFilesFull() {
@@ -271,7 +271,7 @@ var OwApiError = class extends Error {
     return this.status === 502 && this.code === "ask_failed";
   }
   /**
-   * patch, upsert or editLinks became a proposal (202, keel #519): the world takes an agent seat's
+   * patch, upsert or editLinks became a proposal (202): the world takes an agent seat's
    * writes as proposals (`agent_writes_proposed`), so the element did not change. The error is an
    * OwProposedError; its `proposal` is the row a keeper accepts or declines. Not a failure to retry:
    * the write is waiting for a person.
@@ -281,7 +281,7 @@ var OwApiError = class extends Error {
   }
   /**
    * propose named a field the proposer's own view of the element does not hold (422
-   * `field_not_visible`, `param` names it, keel #519): the element reaches this key only as a
+   * `field_not_visible`, `param` names it): the element reaches this key only as a
    * stub (known_of), and a proposal changes only what its proposer can read.
    */
   get isFieldNotVisible() {
@@ -289,7 +289,7 @@ var OwApiError = class extends Error {
   }
   /**
    * propose: this proposer already has 5 open proposals on the element, or 50 in the world (422
-   * `too_many_open`, keel #519). Wait for a keeper to decide, or withdraw one; a lapsed proposal
+   * `too_many_open`). Wait for a keeper to decide, or withdraw one; a lapsed proposal
    * no longer counts.
    */
   get isTooManyOpen() {
@@ -297,7 +297,7 @@ var OwApiError = class extends Error {
   }
   /**
    * acceptProposal found a proposed field moved since the proposal was made (409
-   * `stale_proposal`, keel #519). Nothing was written and the proposal stays open. The error is an
+   * `stale_proposal`). Nothing was written and the proposal stays open. The error is an
    * OwStaleProposalError: `conflicts` lists each moved field with its `base` and `current` values,
    * and `current` is the element as it is now. A change to a field the proposal does not name
    * does not count. The proposer proposes again on the current text.
@@ -306,24 +306,24 @@ var OwApiError = class extends Error {
     return this.status === 409 && this.code === "stale_proposal";
   }
   /**
-   * While the world takes agent seats' writes as proposals (keel #519), an agent seat's key tried
+   * While the world takes agent seats' writes as proposals, an agent seat's key tried
    * what it may not: delete an element it did not create, or accept or decline a proposal (403
-   * `proposed_only`). On any world, reviewNewElement by the member the mark names is the same 403
-   * (keel #565). Retrying will not help; a person decides.
+   * `proposed_only`). On any world, reviewNewElement by the member the mark names is the same 403.
+   * Retrying will not help; a person decides.
    */
   get isProposedOnly() {
     return this.status === 403 && this.code === "proposed_only";
   }
   /**
-   * acceptProposal or declineProposal on the key's own proposal (403 `own_proposal`, keel #519):
+   * acceptProposal or declineProposal on the key's own proposal (403 `own_proposal`):
    * another keeper (the owner or a co-builder) decides it. Retrying will not help.
    */
   get isOwnProposal() {
     return this.status === 403 && this.code === "own_proposal";
   }
   /**
-   * reviewNewElement on an element that carries no `x_review_proposed` mark (422 `not_proposed`,
-   * keel #565): nothing to settle. Someone settled it already, or it was never written as proposed.
+   * reviewNewElement on an element that carries no `x_review_proposed` mark (422 `not_proposed`):
+   * nothing to settle. Someone settled it already, or it was never written as proposed.
    */
   get isNotProposed() {
     return this.status === 422 && this.code === "not_proposed";
@@ -593,7 +593,7 @@ var DEFAULT_PAGE_SIZE = 100;
 var DEFAULT_CHANGES_PAGE_SIZE = 100;
 var OwV2Client = class {
   constructor(config = {}) {
-    /** The conditional head poll's state (keel #518), per instance. */
+    /** The conditional head poll's state, per instance. */
     this.headPoll = new HeadPollState();
     only("new OwV2Client", config, CLIENT_CONFIG_KEYS);
     this.clientName = clientNameOf(config.client);
@@ -625,9 +625,9 @@ var OwV2Client = class {
   /**
    * PATCH /world -- partial world-meta update. The element write's server-managed keys are
    * stripped, and so are the world's own read-only ones (WORLD_READ_ONLY_FIELDS: `slug` and
-   * `public_page`, keel #471; `agent_writes_proposed`, keel #519; set on the world page, not here;
-   * `origin`, keel #571; `id`), so a `getWorld()` body can be sent back. The world's origin is
-   * written as `source` and `producer` (keel #571, each an object or null, served under `origin`);
+   * `public_page`; `agent_writes_proposed`; set on the world page, not here;
+   * `origin`; `id`), so a `getWorld()` body can be sent back. The world's origin is
+   * written as `source` and `producer` (each an object or null, served under `origin`);
    * extension keys (`x_*`, `atlas_*`, `shadow_*`) are sent as given, and `null` removes one.
    */
   async patchWorld(partial) {
@@ -643,8 +643,8 @@ var OwV2Client = class {
    * token is a TypeError before sending.
    */
   /**
-   * PUT /me/character -- pick the roster Character that is you in this world, or none (keel PR 160,
-   * #533). A person member's write key with its PIN; answers GET /me's body. 422 for a hidden
+   * PUT /me/character -- pick the roster Character that is you in this world, or none.
+   * A person member's write key with its PIN; answers GET /me's body. 422 for a hidden
    * Character (`character_hidden`, `err.isCharacterHidden`), a guest's pick it did not make, or a
    * taken Character (`invalid_request`, `param` character); 404 for one this key cannot see; 403 for
    * an agent seat, a player, the owner (whose own is the world's `owner_character`, set with
@@ -718,8 +718,8 @@ var OwV2Client = class {
     } while (cursor);
   }
   /**
-   * GET /{type}/{id}/ -- optional one-level stub expansion / sparse fields, and `viewAs` (keel
-   * #421: the owner reads as another reader; see ListParams.viewAs).
+   * GET /{type}/{id}/ -- optional one-level stub expansion / sparse fields, and `viewAs` (the owner reads as
+   * another reader; see ListParams.viewAs).
    */
   async get(type, id, opts = {}) {
     only("get", opts, ["expand", "fields", "viewAs"]);
@@ -754,8 +754,8 @@ var OwV2Client = class {
    * PUT /{type}/{id}/ -- upsert-by-client-id. The local-first write primitive. A known-of
    * stub (`known_of: true`, see isKnownOf) is a TypeError before sending, here and on every
    * element write: a PUT of one would blank every field it does not keep.
-   * An agent seat's PUT on an existing element, in a world that takes its writes as proposals
-   * (keel #519), answers 202 and is thrown as an OwProposedError: the element did not change.
+   * An agent seat's PUT on an existing element, in a world that takes its writes as proposals,
+   * answers 202 and is thrown as an OwProposedError: the element did not change.
    */
   async upsert(type, id, element) {
     refuseKnownOf(element, "upsert");
@@ -766,12 +766,12 @@ var OwV2Client = class {
    * replace wholesale, omitted fields stay untouched. For link arrays prefer
    * editLinks() -- atomic server-side merge, no read-before-write.
    *
-   * `ifMatch` (keel #210): the element's `change_seq` as you read it. The update lands
+   * `ifMatch`: the element's `change_seq` as you read it. The update lands
    * only if nobody changed the element since; otherwise nothing is written and this throws
    * an OwPreconditionFailedError (412) whose `current` is the element as it is now. Omit
    * it for today's unconditional write.
    *
-   * In a world that takes an agent seat's writes as proposals (keel #519, the world's
+   * In a world that takes an agent seat's writes as proposals (the world's
    * `agent_writes_proposed`), a seat's patch answers 202 with `{proposal}`, never an element:
    * this throws an OwProposedError (`err.isProposed`, the row under `err.proposal`) and the
    * element did not change. If-Match is checked first: a stale one is still a 412.
@@ -786,7 +786,7 @@ var OwV2Client = class {
    * tombstone AND scrubs the id from every other element's links in the same
    * transaction -- no client-side unlink pass needed, ever.
    *
-   * `ifMatch` (keel #563, as on patch()): the element's `change_seq` as you read it. The delete
+   * `ifMatch` (as on patch()): the element's `change_seq` as you read it. The delete
    * lands only if nothing changed since; otherwise an OwPreconditionFailedError (412) whose
    * `current` is the element as it is now, and nothing is deleted. On an element already gone it
    * is the idempotent 204. Under a world's proposals switch a delete is never a proposal.
@@ -800,8 +800,8 @@ var OwV2Client = class {
    * Dedupes, tolerates already-present/already-absent ids. Returns the FULL
    * updated element (fixture P5). Use this for all relationship editing; it
    * retires the read-merge-PATCH dance. `ifMatch` works as on patch(): a link write
-   * moves the element too. A 202 (an agent seat's link edit that became a proposal, keel
-   * #519) is thrown as an OwProposedError, as on patch().
+   * moves the element too. A 202 (an agent seat's link edit that became a proposal)
+   * is thrown as an OwProposedError, as on patch().
    */
   async editLinks(type, id, field, edit, opts = {}) {
     only("editLinks", opts, ["ifMatch"]);
@@ -809,7 +809,7 @@ var OwV2Client = class {
     return this.request("POST", `/${type}/${id}/links/${field}`, { write: true, elementWrite: true, proposable: true, body: edit, ifMatch: opts.ifMatch });
   }
   /**
-   * POST /{type}/{id}/adopt with {member} -- change who made an element (keel #427, D141).
+   * POST /{type}/{id}/adopt with {member} -- change who made an element.
    * `member` is a membership id of this world (a person or an AI seat, as `members()` lists
    * them) or `'owner'`, which sets `created_by` to null. The world's owner key or a
    * co-builder's (a person's or a seat's) with its PIN; a contributor's is 403 `not_author`
@@ -837,7 +837,7 @@ var OwV2Client = class {
    * the items that would have succeeded still say 201 with the ids and timestamps they
    * would have had (keel's "counterfactual 201s"): do not record those ids as created.
    * An agent seat's item on an existing element, in a world that takes its writes as
-   * proposals (keel #519), answers a slot `{status: 202, id, proposal}`: never thrown, the
+   * proposals, answers a slot `{status: 202, id, proposal}`: never thrown, the
    * element unchanged, the slot's `proposal` the row a keeper decides.
    * An element without an id gets one, as `create` mints it, by its position in `items`: with an
    * `idempotencyKey`, derived from the key and the position (the ids the Python package mints),
@@ -869,18 +869,18 @@ var OwV2Client = class {
   /**
    * GET /changes -- one page of the world's ordered change feed.
    * Cursor is OPAQUE: persist verbatim, never parse or build one (a guest's and a
-   * contributor's carry their view's epoch, since keel #421 for a contributor).
+   * contributor's carry their view's epoch, since 2026-10-20 for a contributor).
    * Zero/absent cursor = full export (byte-aligned with the Folder Format).
    * Reset rule: a 409 `resync_required` (err.isResyncRequired) means the key's
    * view changed (a guest's slice, an element unhidden from a contributor, or its role): drop
    * the cursor and walk from zero. For what the local copy holds that the walk no longer names,
-   * read err.resyncReason (keel #421, while keel's hidden mark is on): `role`, keep it; `view`,
+   * read err.resyncReason (while keel's hidden mark is on): `role`, keep it; `view`,
    * drop it (as for a delete row with reason `hidden`). Without a reason, keep it (keel's own
    * words since PR 104; sharing is forward-only). Never empty a copy on your own.
    * Citizenship: heaviest route on the platform; default page size is polite.
    * keel sends the cursor of a page at the head as a number (an empty page, for a key
    * whose cursor carries no epoch); it is handed back as a string, like every cursor here.
-   * `after` (keel #514, D142): only the changes made at or after an ISO 8601 time (`updated_at` of an
+   * `after`: only the changes made at or after an ISO 8601 time (`updated_at` of an
    * upsert, `deleted_at` of a delete; no offset means UTC). A filter, not a position: the order,
    * `cursor`, `has_more` and `head` are as without it, so to read the whole window pass the cursor
    * back as `since` with the same `after` until `has_more` is false (`changesAll` does). "Since
@@ -901,12 +901,12 @@ var OwV2Client = class {
    * poll's, so a missed tick never drops a change) and walk changesAll only when it moved;
    * a head below yours means the server rewound: walk again from zero. `epoch` is a
    * guest's or a contributor's view epoch (null for other keys): it can move with `head` unchanged, so walk on
-   * either move. `epoch_reason` (keel #421, while keel's hidden mark is on; absent otherwise)
+   * either move. `epoch_reason` (while keel's hidden mark is on; absent otherwise)
    * says why the epoch last moved, `role` or `view` (see OwChangesPage.epoch_reason).
    * keel returns the owner's cursor as a number; it is handed back as a
    * string, like every cursor here.
    *
-   * Conditional (keel #518, 4.57.0): keel tags the answer with an ETag that covers the head and
+   * Conditional (4.57.0): keel tags the answer with an ETag that covers the head and
    * the epoch, so a view change moves it too. The client keeps the last tag and sends it as
    * If-None-Match on its next head read. When nothing moved, keel answers 304 with no body, and
    * this returns the `head`, `cursor` and `epoch` from the last 200 with `unchanged: true`
@@ -1052,7 +1052,7 @@ var OwV2Client = class {
     if (!res.ok) throw await errorFromResponse(res);
     return await res.json();
   }
-  // -- Files on elements (keel #393) ---------------------------------------------
+  // -- Files on elements ---------------------------------------------
   /**
    * GET /{type}/{id}/files -- the element's files, newest first: each with its name, kind,
    * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did)
@@ -1193,14 +1193,14 @@ var OwV2Client = class {
   async removeFile(type, id, fileId) {
     await this.request("DELETE", `/${type}/${encodeURIComponent(id)}/files/${encodeURIComponent(fileId)}`);
   }
-  // -- Joining a world by link (keel #212) ----------------------------------
+  // -- Joining a world by link ----------------------------------
   /**
    * POST /join/preview -- what a join code holds, without using it: who invites, to
    * which world, in what role, and `reader` (`person`: accept it with acceptJoin;
    * `agent`: an AI agent redeems it at POST /join). Sends no credential, whatever key
    * this client holds. Every bad code (unknown, used, revoked, expired) is the same
    * 404 `not_found` (`err.isNotFound`). `code` is the part of the link after `#`. A table
-   * (keel #422 PR 2) adds `max_uses`, `uses_left`, `name_required` and `characters`, the
+   * adds `max_uses`, `uses_left`, `name_required` and `characters`, the
    * pick screen's list; a link for one answers without them.
    */
   async previewJoin(code) {
@@ -1208,7 +1208,7 @@ var OwV2Client = class {
   }
   /**
    * POST /join -- redeem a join code that needs no account: a player's (a friend reading as
-   * a guest, keel #353) or an AI agent's. Sends no credential, whatever key this client holds.
+   * a guest) or an AI agent's. Sends no credential, whatever key this client holds.
    * 201 with `kind` telling the two answers apart: `player` gives a read key (`ow_r_`, no PIN)
    * and the Character it reads as; `agent` gives a seat's write key, secret and `.env` lines.
    * Both are shown once, and the code is spent: a lost answer cannot be replayed (the owner
@@ -1217,7 +1217,7 @@ var OwV2Client = class {
    * agent code). Every bad code is the same 404 `not_found`; a person's code is redeemed with
    * acceptJoin instead.
    *
-   * A table (a player code whose preview carries `max_uses`, keel #422 PR 2) seats one player
+   * A table (a player code whose preview carries `max_uses`) seats one player
    * per redeem, until `uses_left` is 0. With a list, `character` is the player's pick, the `id`
    * of one of the preview's `characters` not `taken`: a Character a live seat already plays is
    * 422 `character_taken` (`err.isCharacterTaken`; pick another), one off the list, hidden or
@@ -1236,7 +1236,7 @@ var OwV2Client = class {
     if (opts.character !== void 0) body.character = opts.character;
     return this.request("POST", "/join", { auth: false, body });
   }
-  // -- Signing in with a password (keel #211) --------------------------------
+  // -- Signing in with a password --------------------------------
   /**
    * Sign in with an email address (or a username) and password, and get a new account token
    * (`ow_a_`) for this device, named `tokenName` (say, "Lantern on iPhone"): the name the
@@ -1366,8 +1366,7 @@ var OwV2Client = class {
    * POST /account/join -- accept an invite link's code as the account this client's
    * `ow_a_` token belongs to: 201 with the new membership. Refusals: 404 `not_found`
    * (every bad code, and a code made for an AI agent) and 409 `already_member`
-   * (`err.isAlreadyMember`). Accepting needs no account PIN, for any role (keel #297,
-   * ed73c90); a write key for the membership waits for one (`pin_required`). A refusal
+   * (`err.isAlreadyMember`). Accepting needs no account PIN, for any role; a write key for the membership waits for one (`pin_required`). A refusal
    * never spends the code. A world key here is a TypeError before anything is sent.
    */
   async acceptJoin(code) {
@@ -1378,18 +1377,18 @@ var OwV2Client = class {
   }
   /**
    * POST /account/worlds/{worldId}/links -- a new invite link for a world this client's
-   * `ow_a_` token owns (keel C1): `reader` is required (`person`, accepted with acceptJoin;
+   * `ow_a_` token owns: `reader` is required (`person`, accepted with acceptJoin;
    * `agent`, redeemed at POST /join; `player`, a friend with no account, redeemed with
-   * redeemJoin for a read key, keel #353); `role`, when left out, is keel's default: guest for a
+   * redeemJoin for a read key); `role`, when left out, is keel's default: guest for a
    * person link, contributor for an agent link (a player link is guest, and refuses any other), `days` (1, 7 or 30) to 7; `withCharacter` (agent links
    * only) to true; `character` (player links only) a Character's id or `new` (the default):
-   * whoever opens the link first reads as it, until removed. `preview` (person and player links,
-   * keel #422) to false: true puts the world's id in the link's path, so a chat that unfurls it
+   * whoever opens the link first reads as it, until removed. `preview` (person and player links)
+   * to false: true puts the world's id in the link's path, so a chat that unfurls it
    * shows the world's name and picture (the code stays after `#`); true on an agent link is
    * 422, param `preview`. `maxUses` (person and player links; an agent link takes none) to 1, a
-   * link for one. On a person link (keel #390, D140) 2 to 50 lets in that many accounts, each
+   * link for one. On a person link 2 to 50 lets in that many accounts, each
    * joining once with the link's role, until every use is taken, it expires or it is revoked;
-   * who already joined stays. On a player link (keel #422 PR 2) 2 to 50 makes a table, one
+   * who already joined stays. On a player link 2 to 50 makes a table, one
    * link that seats that many players, each picking one of
    * `characters` (Character ids of the world, in the order a pick screen shows them; a hidden
    * one is 422, param `characters`). `characters` empty or left out: each player names a fresh
@@ -1440,7 +1439,7 @@ var OwV2Client = class {
     }
     await this.request("DELETE", `/account/worlds/${encodeURIComponent(worldId)}/links/${encodeURIComponent(linkId)}`);
   }
-  // -- Seats for your own AI (keel #355, D106) ------------------------------
+  // -- Seats for your own AI ------------------------------
   /**
    * POST /account/worlds/{worldId}/seats -- a seat for your own AI in a world you own or are a
    * member of: its own membership, write key and `ow_s_` secret, no join link. You answer for
@@ -1497,9 +1496,9 @@ var OwV2Client = class {
     }
     await this.request("DELETE", `/account/worlds/${encodeURIComponent(worldId)}/seats/${encodeURIComponent(seatId)}`);
   }
-  // -- The hidden mark (keel #421) ------------------------------------------
+  // -- The hidden mark ------------------------------------------
   /**
-   * PUT /{type}/{id}/hidden -- hide an element (keel #421). The owner's key or a co-builder's
+   * PUT /{type}/{id}/hidden -- hide an element. The owner's key or a co-builder's
    * (a person's or a seat's) with its PIN; hiding a hidden element again changes nothing, and
    * the element's body and `change_seq` do not move. Hidden, it is seen only by the owner, the
    * co-builders and the member who created it; to every other key it is a 404, left out of
@@ -1521,7 +1520,7 @@ var OwV2Client = class {
     const page = await this.request("GET", "/world/hidden");
     return page.data;
   }
-  // -- The proposed change (keel #519) ---------------------------------------
+  // -- The proposed change ---------------------------------------
   //
   // A proposal is a record kept beside an element, never in its body: the element does not
   // change until the world's owner or a co-builder accepts it. A proposal is seen by the owner,
@@ -1573,7 +1572,7 @@ var OwV2Client = class {
   }
   /**
    * GET /world/proposals -- the world's queue, newest first by created_at, two kinds of row told
-   * apart by `kind` (keel #565): `proposal`, a proposed change to an element (OwProposal), and
+   * apart by `kind`: `proposal`, a proposed change to an element (OwProposal), and
    * `new_element`, an element written as proposed, carrying `x_review_proposed`
    * (OwProposedNewElement: settle it with reviewNewElement). A marked element is listed under
    * `open`, `lapsed` and `all`, never `accepted` or `declined`; keel reads at most the 500 newest.
@@ -1628,7 +1627,7 @@ var OwV2Client = class {
   }
   /**
    * POST /{type}/{id}/review -- settle a new element written as proposed, one carrying
-   * `x_review_proposed` (the queue's `new_element` row, keel #565). The owner's key or a
+   * `x_review_proposed` (the queue's `new_element` row). The owner's key or a
    * co-builder's, with its PIN. `{ decision: 'accept' }` clears the mark (a write by you: a new
    * change_seq, one /changes row) and answers `{ element }`; `{ decision: 'decline', reason? }`
    * deletes the element (a tombstone, the links to it scrubbed, its open proposals dropped) and
@@ -1723,7 +1722,7 @@ var OwV2Client = class {
    * `navigate: false`). `redirectUri` is the registered return address as a string, `https:`
    * only, never built from `location.origin`: a tool's registration is read at
    * `GET /api/v2/auth/clients`. `resume` is small JSON handed back by `completeSignIn`. No request
-   * is sent; any client, keyless included. The handoff sheet: Orrery `keel/signin-handoff.md` §3.
+   * is sent; any client, keyless included.
    */
   async signInWithOnlyWorlds(opts) {
     only("signInWithOnlyWorlds", opts, ["clientId", "redirectUri", "resume", "storage", "navigate"]);
@@ -1742,7 +1741,7 @@ var OwV2Client = class {
     only("completeSignIn", opts, ["clientId", "storage", "url"]);
     return completeSignIn(this.baseUrl, this.fetchImpl, opts);
   }
-  // -- Ask your world (keel #159) -------------------------------------------
+  // -- Ask your world -------------------------------------------
   /**
    * POST /account/ask -- a question about a world the account owns or is in, answered by
    * keel's AI proxy from `context` only (build it with buildAskContext from the elements
@@ -4781,7 +4780,7 @@ var TokenResource = class {
    * Consume tokens for service usage
    *
    * @deprecated keel serves no consume route (404 on production since 2026-10;
-   * no client decides what its act costs, Skeld's ruling, keel #274): spending
+   * no client decides what its act costs, ruled 2026-10-14): spending
    * happens server-side in the route that does the work. Removed in 5.0.
    *
    * Reports token consumption to track daily usage. Allows consumption even if

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlyworlds/sdk",
-  "version": "4.72.1",
+  "version": "4.72.3",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "type": "module",
   "exports": {