@onlyworlds/sdk 4.153.0 → 4.155.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # For AI agents using @onlyworlds/sdk
2
2
 
3
- **Current as of**: SDK **4.x** · schema-dist **v0.34.0-dist.115** (canonical 00.34.00).
3
+ **Current as of**: SDK **4.x** · schema-dist **v0.34.0-dist.116** (canonical 00.34.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,20 @@ earlier history lives in git log only.
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [4.155.0] - 2026-11-11
9
+
10
+ ### Changed
11
+
12
+ - **`proposedMarkOf`'s `by` is read as stored, never trimmed** (the review profile's Who `by` names, schema-dist serial 116): a `by` that is not a string, or is White_Space alone, names nobody (`null`), and White_Space around a word or an id makes it neither. 4.154.0 trimmed it, so `" owner "` came back as `owner`. `OwProposedMark.by` says how a reader shows it: as the mark's word ("the mark names Ada"), never as a fact ("proposed by Ada"); a name in its place only where the platform resolves it to a member on its roster or to the owner, comparing ids as ids, or where it is the id of a Character of the same world this reader is served, said as that Character; otherwise the raw value, apart.
13
+ - **`OwProposedNewElement.by`'s words**: the mark's own `by`, the writer's word for who proposed it, a claim, null when it names nobody; never a record of who wrote the element or the mark.
14
+ - **Schema repinned to schema-dist v0.34.0-dist.116** (from dist.115; same canonical 00.34.00, no schema file and no fixture moved; only `profiles/review.md`).
15
+
16
+ ## [4.154.0] - 2026-11-11
17
+
18
+ ### Added
19
+
20
+ - **`OwFileAddedBy.owner`**: true when the world's current owner added the file, through any door (the site, the API, or an agent with the owner's own keys; a seat the owner sponsors is the seat's, false); false for everyone else, on every file of a world with no owner, and on a past owner's files once the world has another owner. onlyworlds.com serves it on every row of `listFiles` and `worldFiles`. `membership` is null both for the owner's files and for a file whose membership no longer exists, and `owner` tells the two apart: a null `membership` with `owner` false is a former member, and such a file's `name` is "a former member" (it was an empty string for a member whose account was deleted).
21
+
8
22
  ## [4.153.0] - 2026-11-11
9
23
 
10
24
  ### Changed
package/SCHEMA.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # OnlyWorlds Schema Reference
2
2
 
3
- **Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.34.0-dist.115** — canonical schema **00.34.00**, published 2026-11-11.
3
+ **Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.34.0-dist.116** — canonical schema **00.34.00**, published 2026-11-11.
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.
@@ -1178,7 +1178,7 @@ function proposedMarkOf(element, today) {
1178
1178
  const v = element[PROPOSED_MARK];
1179
1179
  if (!isPresent(v) || typeof v !== "object" || Array.isArray(v)) return null;
1180
1180
  const m = v;
1181
- const by = typeof m.by === "string" && trimWhiteSpace(m.by) ? trimWhiteSpace(m.by) : null;
1181
+ const by = typeof m.by === "string" && trimWhiteSpace(m.by) ? m.by : null;
1182
1182
  const expires = typeof m.expires === "string" && DAY.test(trimWhiteSpace(m.expires)) ? trimWhiteSpace(m.expires) : null;
1183
1183
  return { by, expires, lapsed: expires !== null && expires <= (today ?? todayDay()) };
1184
1184
  }
package/dist/index.d.ts CHANGED
@@ -2789,7 +2789,7 @@ interface OwProposedNewElement {
2789
2789
  element_id: string;
2790
2790
  /** open; lapsed once the mark's `expires` has passed (it may still be accepted or declined). Never accepted or declined: a settled mark leaves the queue. */
2791
2791
  state: 'open' | 'lapsed';
2792
- /** The mark's `by`: the membership id of the seat that wrote it. */
2792
+ /** The mark's own `by`, the writer's word for who proposed it: a claim, never a record of who wrote the element or the mark (show it as `OwProposedMark.by` says); null when it names nobody. */
2793
2793
  by: string | null;
2794
2794
  evidence: string | null;
2795
2795
  /** The mark's `expires`, as written (a date, YYYY-MM-DD). */
@@ -3930,14 +3930,23 @@ interface OwUploadedImage {
3930
3930
  * picture (that is `image_url`).
3931
3931
  */
3932
3932
  type OwFileKind = 'pdf' | 'txt' | 'md' | 'json' | 'csv' | 'yaml' | 'toml' | 'zip' | 'png' | 'jpg' | 'webp' | 'avif';
3933
- /** Who added a file. */
3933
+ /**
3934
+ * Who added a file. A removed member's file keeps its membership id and name; a file whose member's account was
3935
+ * deleted keeps its membership id and is named "a former member".
3936
+ */
3934
3937
  interface OwFileAddedBy {
3935
- /** A member's or a seat's name; the owner's username for the owner's keys. */
3938
+ /** A member's or a seat's name; the owner's username for the owner's keys; "a former member" where no one is left to name. */
3936
3939
  name: string;
3937
- /** Their membership id; null for the owner's keys. */
3940
+ /** Their membership id; null for the owner's files and for a file whose membership no longer exists (`owner` tells the two apart). */
3938
3941
  membership: string | null;
3939
3942
  /** True when an agent added it: an agent seat, the MCP surface, or a key that declared an agent. */
3940
3943
  agent: boolean;
3944
+ /**
3945
+ * True when the world's current owner added the file, through any door (the site, the API, or an agent with the
3946
+ * owner's own keys; a seat the owner sponsors is the seat's, false). False for everyone else, on every file of a world
3947
+ * with no owner, and on a past owner's files once the world has another owner. Since 4.154.0.
3948
+ */
3949
+ owner: boolean;
3941
3950
  }
3942
3951
  /** One file on an element, as listFiles returns it. */
3943
3952
  interface OwFileRow {
@@ -5063,8 +5072,8 @@ declare class OwV2Client {
5063
5072
  }): Promise<OwRemovedImage>;
5064
5073
  /**
5065
5074
  * GET /{type}/{id}/files -- the element's files, newest first: each with its name, kind,
5066
- * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did)
5067
- * and when. Any key that may read the element; a file is seen by whoever may see its
5075
+ * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did,
5076
+ * `added_by.owner` when the world's current owner did) and when. Any key that may read the element; a file is seen by whoever may see its
5068
5077
  * element, and an element the key cannot see answers 404 `not_found`. Returns the rows
5069
5078
  * (keel sends them as `{ data }`, with no paging). Files never ride on the element: they
5070
5079
  * are not in its body, its `change_seq` or /changes.
@@ -5993,7 +6002,17 @@ declare function recordsOf(characterId: string, elements: readonly unknown[]): O
5993
6002
  declare const PROPOSED_MARK = "x_review_proposed";
5994
6003
  /** A proposed element's mark as a reader shows it. */
5995
6004
  interface OwProposedMark {
5996
- /** The membership or seat that proposed it, trimmed of Unicode White_Space as the room profile trims, when the mark names one. */
6005
+ /**
6006
+ * Who made the mark, in the writer's own word: a claim, with no format to rely on, and never proof of who wrote the
6007
+ * mark or the element. Read as stored, never trimmed: a `by` that is not a string, or is White_Space alone, names
6008
+ * nobody (null); White_Space around a word or an id makes it neither. Show it as the mark's word (for example "the
6009
+ * mark names Ada"), in a form that keeps the name visibly the mark's, never as a fact ("proposed by Ada"). Put a
6010
+ * name in its place in two cases only: your platform resolves it to a member on its roster or to the world's owner,
6011
+ * comparing ids as ids, with the name it serves this reader (the id where it serves none) and the owner, an AI's seat
6012
+ * or a player's seat said beside it; otherwise, it is the id of a Character of the same world this reader is served,
6013
+ * said as that Character with its type, never as the member who plays it. Every other `by` is shown only as the raw
6014
+ * value, apart, never where a name stands.
6015
+ */
5997
6016
  by: string | null;
5998
6017
  /** The day it lapses (YYYY-MM-DD), trimmed, when the mark gives one in that shape. */
5999
6018
  expires: string | null;
package/dist/index.js CHANGED
@@ -45,7 +45,7 @@ import {
45
45
  trimWhiteSpace,
46
46
  typeWord,
47
47
  unknownKey
48
- } from "./chunk-YWFXL4Z6.js";
48
+ } from "./chunk-Y4KVAIDS.js";
49
49
 
50
50
  // src/v2/keyed-id.ts
51
51
  var KEYED_IDS = "0199b6a0-6f0e-7c2a-9d1e-3b5c7a8e4f21";
@@ -1382,8 +1382,8 @@ var OwV2Client = class {
1382
1382
  // -- Files on elements ---------------------------------------------
1383
1383
  /**
1384
1384
  * GET /{type}/{id}/files -- the element's files, newest first: each with its name, kind,
1385
- * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did)
1386
- * and when. Any key that may read the element; a file is seen by whoever may see its
1385
+ * size in bytes, label (or null), who added it (`added_by.agent` is true when an agent did,
1386
+ * `added_by.owner` when the world's current owner did) and when. Any key that may read the element; a file is seen by whoever may see its
1387
1387
  * element, and an element the key cannot see answers 404 `not_found`. Returns the rows
1388
1388
  * (keel sends them as `{ data }`, with no paging). Files never ride on the element: they
1389
1389
  * are not in its body, its `change_seq` or /changes.
package/dist/waymark.js CHANGED
@@ -6,7 +6,7 @@ import {
6
6
  openersFor,
7
7
  refuseUnknownOptions,
8
8
  typeWord
9
- } from "./chunk-YWFXL4Z6.js";
9
+ } from "./chunk-Y4KVAIDS.js";
10
10
 
11
11
  // src/waymark/glyphs.ts
12
12
  var MARK_PATH = "M48.8 0.0 43.8 0.4 39.0 1.2 36.0 2.0 33.2 2.9 29.3 4.5 24.8 6.8 20.6 9.5 17.0 12.4 13.6 15.7 10.4 19.4 7.8 23.1 5.8 26.6 4.5 29.3 3.3 32.1 1.8 36.8 0.8 41.2 0.1 46.3 0.0 51.1 0.4 56.2 1.2 61.0 2.0 63.9 2.9 66.8 4.5 70.7 6.8 75.2 9.5 79.4 12.4 82.9 15.7 86.3 19.4 89.5 23.1 92.1 26.6 94.2 29.3 95.5 32.1 96.7 36.8 98.2 41.2 99.2 46.3 99.8 51.1 100.0 56.2 99.6 61.0 98.8 63.9 98.0 66.8 97.1 70.7 95.5 75.2 93.2 79.4 90.4 82.9 87.6 86.3 84.3 89.5 80.5 92.1 76.9 94.2 73.4 95.5 70.7 96.7 67.9 98.2 63.2 99.2 58.7 99.8 53.7 100.0 48.8 99.6 43.8 98.6 38.4 97.1 33.2 95.5 29.3 93.2 24.8 90.4 20.6 87.6 17.0 84.3 13.6 80.5 10.4 76.9 7.8 73.4 5.8 70.7 4.5 67.9 3.3 63.2 1.8 58.7 0.8 53.7 0.1ZM77.5 80.7 74.1 83.4 70.7 85.7 67.0 87.5 64.5 88.6 64.1 88.7 65.7 86.3 67.1 83.9 68.7 80.7 69.9 77.6 72.7 78.5 73.0 78.4ZM22.5 80.7 25.6 79.0 27.3 78.3 30.0 77.6 31.3 80.7 32.8 83.9 34.2 86.3 35.9 88.7 32.9 87.5 29.3 85.7 25.8 83.4ZM51.2 74.5 55.1 74.7 59.9 75.2 64.2 76.0 67.5 76.9 66.0 80.5 64.2 84.0 62.0 87.4 59.6 90.1 55.1 90.9 52.2 91.2 51.2 91.1ZM48.7 74.5 48.8 91.1 47.7 91.2 44.9 90.9 40.3 90.1 38.2 87.8 36.3 85.0 34.2 81.2 32.5 77.0 35.8 76.0 40.5 75.2 44.5 74.7ZM91.1 51.2 91.1 52.9 90.8 56.3 90.1 59.7 89.3 62.5 88.5 64.8 87.2 67.7 85.7 70.7 83.9 73.4 82.0 75.9 79.4 78.9 76.3 77.2 73.8 76.1 76.2 68.8 77.8 62.7 78.7 56.8 79.0 51.2ZM55.8 51.2 67.7 51.2 67.6 55.1 67.2 59.0 66.7 61.5 65.7 65.0 61.0 64.2 55.7 63.6ZM32.5 51.2 44.5 51.2 44.4 63.6 39.7 64.1 34.5 65.0 33.5 61.3 32.9 58.1 32.5 54.2ZM8.8 51.2 21.0 51.2 21.0 53.3 21.4 56.6 22.7 64.0 23.8 68.4 25.0 72.1 26.6 75.9 23.7 77.2 20.6 78.9 18.5 76.7 16.5 74.1 14.8 71.5 13.4 69.1 12.1 66.3 11.0 63.6 10.1 60.5 9.4 57.3 8.9 53.5 8.8 51.3ZM36.2 27.0 39.5 27.5 44.5 28.2 44.4 48.8 32.4 48.7 32.8 44.5 33.6 39.1 35.0 32.0ZM63.9 26.9 65.2 32.1 66.6 39.2 67.4 44.8 67.7 48.7 55.8 48.8 55.7 28.1 60.5 27.5ZM74.8 23.4 76.9 22.5 79.4 21.1 82.0 24.0 84.8 27.8 86.2 30.3 87.5 32.9 88.6 35.4 89.5 38.1 90.3 41.2 90.8 44.0 91.1 47.0 91.1 48.8 79.0 48.7 78.7 44.6 78.0 39.3 76.5 31.2 74.7 23.5ZM25.5 23.5 25.5 23.7 24.5 26.8 23.7 30.2 22.4 36.6 21.5 42.5 21.1 48.7 8.8 48.8 8.8 47.0 9.2 43.7 9.8 40.8 10.5 38.1 11.5 35.2 12.4 32.9 13.8 30.2 15.2 27.8 17.9 24.0 20.6 21.1 23.1 22.5ZM64.1 11.3 67.0 12.4 70.7 14.3 74.1 16.5 77.5 19.3 75.6 20.3 73.2 21.5 70.0 22.6 68.7 19.2 67.1 16.1 65.7 13.6ZM35.9 11.3 34.2 13.6 32.8 16.1 31.3 19.2 30.0 22.5 27.9 21.9 26.4 21.3 22.5 19.3 25.8 16.5 29.3 14.3 32.9 12.4 35.4 11.4ZM51.2 8.8 52.2 8.8 55.1 9.0 59.6 9.9 61.7 12.2 64.2 16.0 66.0 19.5 67.6 23.3 64.3 24.3 59.4 25.2 56.2 25.6 51.2 25.5ZM48.8 8.8 48.7 25.5 44.2 25.6 40.6 25.2 36.4 24.5 32.4 23.2 33.9 19.5 35.7 16.0 38.2 12.2 40.3 9.9 44.9 9.0 47.7 8.8Z";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@onlyworlds/sdk",
3
- "version": "4.153.0",
3
+ "version": "4.155.0",
4
4
  "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
5
5
  "type": "module",
6
6
  "exports": {