@onlyworlds/sdk 4.132.3 → 4.132.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +6 -0
- package/SCHEMA.md +20 -20
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# For AI agents using @onlyworlds/sdk
|
|
2
2
|
|
|
3
|
-
**Current as of**: SDK **4.x** · schema-dist **v0.34.0-dist.
|
|
3
|
+
**Current as of**: SDK **4.x** · schema-dist **v0.34.0-dist.108** (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,12 @@ earlier history lives in git log only.
|
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
7
|
|
|
8
|
+
## [4.132.4] - 2026-11-05
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
|
|
12
|
+
- The schema pin moves to schema-dist `v0.34.0-dist.108` (canonical `00.34.00` unchanged, so `ONLYWORLDS_VERSION` is the same). Three description fixes across 19 fields, no field added or removed: `Event.constructs` says concepts, systems or built entities (no longer laws); the seventeen time fields say in one phrasing that they count in the World's `time_basic_unit`; `Map.hierarchy` says it is an integer to order or group the maps that share a parent, read as each tool chooses; three map descriptions lose a trailing space. The generated types' field comments and `SCHEMA.md` carry the new words.
|
|
13
|
+
|
|
8
14
|
## [4.132.3] - 2026-11-04
|
|
9
15
|
|
|
10
16
|
### 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.
|
|
3
|
+
**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.34.0-dist.108** — canonical schema **00.34.00**, published 2026-11-04.
|
|
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.
|
|
@@ -25,7 +25,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
25
25
|
### Mechanics
|
|
26
26
|
|
|
27
27
|
- `activation` (text) — Method or conditions under which the ability is activated
|
|
28
|
-
- `duration` (integer) — Length of time the ability remains active or its effects persist,
|
|
28
|
+
- `duration` (integer) — Length of time the ability remains active or its effects persist, in the world's time unit (World time_basic_unit)
|
|
29
29
|
- `potency` (integer) — Relative measure of the ability's inherent potency or force, used for scaling or comparison purposes
|
|
30
30
|
- `range` (integer) — Effective reach or distance at which the ability can be used, in the world's distance unit (World distance_unit)
|
|
31
31
|
- `effects` (multi link → phenomenon) — Phenomena that result from the ability's use, such as environmental changes or sensory effects
|
|
@@ -60,7 +60,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
60
60
|
|
|
61
61
|
- `background` (text) — History, upbringing, or formative experiences of the character
|
|
62
62
|
- `motivations` (text) — Core desires, goals, or values that drive the character's choices and behavior
|
|
63
|
-
- `birth_date` (integer) — Moment of birth,
|
|
63
|
+
- `birth_date` (integer) — Moment of birth, in the world's time unit (World time_basic_unit)
|
|
64
64
|
- `birthplace` (single link → location) — Location where the character was born
|
|
65
65
|
- `languages` (multi link → language) — Languages the character can understand, speak, or use for communication
|
|
66
66
|
|
|
@@ -105,7 +105,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
105
105
|
|
|
106
106
|
- `composition` (text) — Internal structure or demographic makeup of the collective
|
|
107
107
|
- `count` (integer) — Number of members in the collective (approximate or exact)
|
|
108
|
-
- `formation_date` (integer) — Date the collective was formed,
|
|
108
|
+
- `formation_date` (integer) — Date the collective was formed, in the world's time unit (World time_basic_unit)
|
|
109
109
|
- `operator` (single link → institution) — Institution that manages or directs the collective
|
|
110
110
|
- `equipment` (multi link → object) — Tools or gear in possession of and/or regularly used by the collective
|
|
111
111
|
|
|
@@ -134,7 +134,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
134
134
|
- `history` (text) — The historical development or ideation of the construct, and its place in wider historical contexts
|
|
135
135
|
- `status` (text) — The present condition or operational status of the construct
|
|
136
136
|
- `reach` (text) — The geographic, cultural, or political extent of the construct's influence
|
|
137
|
-
- `start_date` (integer) — The point in time when the construct began or was first established
|
|
137
|
+
- `start_date` (integer) — The point in time when the construct began or was first established, in the world's time unit (World time_basic_unit)
|
|
138
138
|
- `end_date` (integer) — The point in time when the construct ceased to function or lost its meaning
|
|
139
139
|
- `founder` (single link → character) — Character who conceived or initiated the construct
|
|
140
140
|
- `custodian` (single link → institution) — Institution maintaining, enforcing, or exploiting the construct
|
|
@@ -182,7 +182,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
182
182
|
### World
|
|
183
183
|
|
|
184
184
|
- `status` (text) — Current situation or classification of the creature
|
|
185
|
-
- `birth_date` (integer) — The time of the creature's birth,
|
|
185
|
+
- `birth_date` (integer) — The time of the creature's birth, in the world's time unit (World time_basic_unit)
|
|
186
186
|
- `location` (single link → location) — Specific location where the creature is currently found or most associated with
|
|
187
187
|
- `zone` (single link → zone) — Larger area or region commonly inhabited or currently claimed by the creature
|
|
188
188
|
|
|
@@ -224,7 +224,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
224
224
|
- `families` (multi link → family) — Families relevant to the event
|
|
225
225
|
- `relations` (multi link → relation) — Interpersonal or political relations relevant to the event
|
|
226
226
|
- `titles` (multi link → title) — Titles relevant to the event
|
|
227
|
-
- `constructs` (multi link → construct) — Concepts,
|
|
227
|
+
- `constructs` (multi link → construct) — Concepts, systems or built entities relevant to the event
|
|
228
228
|
|
|
229
229
|
|
|
230
230
|
## family · colour: blue · icon: supervisor_account
|
|
@@ -255,7 +255,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
255
255
|
### Foundation
|
|
256
256
|
|
|
257
257
|
- `doctrine` (text) — Core belief, mission, or purpose that drives the institution
|
|
258
|
-
- `founding_date` (integer) — Date when the institution was established, in the world's
|
|
258
|
+
- `founding_date` (integer) — Date when the institution was established, in the world's time unit (World time_basic_unit)
|
|
259
259
|
- `parent_institution` (single link → institution) — Institution that governs, embodies, or originated this one
|
|
260
260
|
|
|
261
261
|
### Claims
|
|
@@ -297,7 +297,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
297
297
|
|
|
298
298
|
- `declaration` (text) — The formal wording, expression, or decree of the law
|
|
299
299
|
- `purpose` (text) — The intent, motivation, or justification for the law's creation
|
|
300
|
-
- `date` (integer) — Date the law was formally established, in world
|
|
300
|
+
- `date` (integer) — Date the law was formally established, in the world's time unit (World time_basic_unit)
|
|
301
301
|
- `parent_law` (single link → law) — A law that this law derives from, modifies, or enhances
|
|
302
302
|
- `penalties` (multi link → construct) — Consequences intended to be applied when the law is contravened
|
|
303
303
|
|
|
@@ -374,7 +374,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
374
374
|
### Details
|
|
375
375
|
|
|
376
376
|
- `background_color` (text) — Color of the space around the map when zoomed out
|
|
377
|
-
- `hierarchy` (integer) —
|
|
377
|
+
- `hierarchy` (integer) — An integer to order or group the maps that share a parent; how a tool reads it is the tool's own
|
|
378
378
|
- `width` (integer) — In pixels
|
|
379
379
|
- `height` (integer) — In pixels
|
|
380
380
|
- `depth` (integer) — In pixels
|
|
@@ -402,8 +402,8 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
402
402
|
|
|
403
403
|
- `story` (text) — Content of the narrative, as told or remembered
|
|
404
404
|
- `consequences` (text) — Outcomes or legacy of the narrative
|
|
405
|
-
- `start_date` (integer) — Date when the narrative is first told or recorded,
|
|
406
|
-
- `end_date` (integer) — Date when the narrative stops being told,
|
|
405
|
+
- `start_date` (integer) — Date when the narrative is first told or recorded, in the world's time unit (World time_basic_unit); the span it recounts lives on its events
|
|
406
|
+
- `end_date` (integer) — Date when the narrative stops being told, in the world's time unit (World time_basic_unit); empty while it is still told
|
|
407
407
|
- `order` (integer) — Position of this narrative within a parent narrative's sequence
|
|
408
408
|
- `parent_narrative` (single link → narrative) — Larger narrative that this narrative takes place in
|
|
409
409
|
- `protagonist` (single link → character) — Primary character of the narrative
|
|
@@ -467,7 +467,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
467
467
|
|
|
468
468
|
- `expression` (text) — How the phenomenon manifests or takes shape in the world
|
|
469
469
|
- `effects` (text) — The primary outcomes or changes caused by the phenomenon
|
|
470
|
-
- `duration` (integer) — The amount of time the phenomenon lasts,
|
|
470
|
+
- `duration` (integer) — The amount of time the phenomenon lasts, in the world's time unit (World time_basic_unit)
|
|
471
471
|
- `catalysts` (multi link → object) — Objects or materials that initiate or enhance the phenomenon
|
|
472
472
|
- `empowerments` (multi link → ability) — Abilities that initiate or enhance the phenomenon, or are initiated or enhanced by it
|
|
473
473
|
|
|
@@ -498,8 +498,8 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
498
498
|
### Nature
|
|
499
499
|
|
|
500
500
|
- `background` (text) — History and origin of the relation
|
|
501
|
-
- `start_date` (integer) — Date when the relation began,
|
|
502
|
-
- `end_date` (integer) — Date when the relation ended if any,
|
|
501
|
+
- `start_date` (integer) — Date when the relation began, in the world's time unit (World time_basic_unit)
|
|
502
|
+
- `end_date` (integer) — Date when the relation ended if any, in the world's time unit (World time_basic_unit)
|
|
503
503
|
- `intensity` (integer) — Significance of the relation, on a relative scale of 0 to 100
|
|
504
504
|
- `actor` (single link → character) — Primary character defining the relation
|
|
505
505
|
- `events` (multi link → event) — Events where the relation is involved or relevant
|
|
@@ -530,7 +530,7 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
530
530
|
### Biology
|
|
531
531
|
|
|
532
532
|
- `appearance` (text) — Typical physical or form features of the species
|
|
533
|
-
- `life_span` (integer) — Average or typical life expectancy of an individual,
|
|
533
|
+
- `life_span` (integer) — Average or typical life expectancy of an individual, in the world's time unit (World time_basic_unit)
|
|
534
534
|
- `weight` (integer) — Average or typical adult weight, in the world's mass unit (World mass_unit)
|
|
535
535
|
- `nourishment` (multi link → species) — Other species consumed as food sources
|
|
536
536
|
- `reproduction` (multi link → construct) — Reproductive method(s) of the species
|
|
@@ -561,8 +561,8 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
561
561
|
|
|
562
562
|
- `authority` (text) — Rights or powers granted by the title
|
|
563
563
|
- `eligibility` (text) — Conditions or qualifications for receiving or holding the title
|
|
564
|
-
- `grant_date` (integer) — Date on which the title was created or first granted,
|
|
565
|
-
- `revoke_date` (integer) — Date on which the title ended or was abolished,
|
|
564
|
+
- `grant_date` (integer) — Date on which the title was created or first granted, in the world's time unit (World time_basic_unit); a holder's own span is a Relation, not this field
|
|
565
|
+
- `revoke_date` (integer) — Date on which the title ended or was abolished, in the world's time unit (World time_basic_unit); a holder's own span is a Relation, not this field
|
|
566
566
|
- `issuer` (single link → institution) — Institution that formally created or granted the title
|
|
567
567
|
- `body` (single link → institution) — Institution in which the title functions or holds relevance
|
|
568
568
|
- `superior_title` (single link → title) — Another title that has authority over this one
|
|
@@ -622,8 +622,8 @@ the group, the icon carries the type): blue · green · pink · amber.
|
|
|
622
622
|
|
|
623
623
|
- `role` (text) — The operational function or intent of the zone
|
|
624
624
|
- `shape` (text) — How the zone's markers are joined: polygon (a closed area: the last marker joins the first) or line (an open path, drawn in marker order). Lowercase. Empty, absent, or any other value means the shape is not stated, and a reader draws a polygon
|
|
625
|
-
- `start_date` (integer) — Date when the zone becomes extant or relevant,
|
|
626
|
-
- `end_date` (integer) — Date when the zone ceases to be meaningful or enforced,
|
|
625
|
+
- `start_date` (integer) — Date when the zone becomes extant or relevant, in the world's time unit (World time_basic_unit)
|
|
626
|
+
- `end_date` (integer) — Date when the zone ceases to be meaningful or enforced, in the world's time unit (World time_basic_unit)
|
|
627
627
|
- `phenomena` (multi link → phenomenon) — Phenomena that affect, define, or occur within the zone
|
|
628
628
|
- `linked_zones` (multi link → zone) — Other zones that are associated with the zone
|
|
629
629
|
|