@onlyworlds/sdk 4.41.0 → 4.42.1

package/AGENTS.md

@@ -1,6 +1,6 @@
 # For AI agents using @onlyworlds/sdk
 
-**Current as of**: SDK **4.x** · schema-dist **v0.32.1-dist.28** (canonical 00.32.01).
+**Current as of**: SDK **4.x** · schema-dist **v0.32.2-dist.29** (canonical 00.32.02).
 This line is asserted by `codegen:check` in CI — if the pin moves and this file is not
 re-read against it, the check fails rather than letting this document rot quietly.
 

package/CHANGELOG.md

@@ -5,6 +5,22 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.42.1] - 2026-10-20
+
+The calendar reader refuses what the `atlas_calendar` profile refuses (schema-dist `profiles/calendar.md`; Quillon's Unity read, OW Council h58 #8917).
+
+### Fixed
+- **`readCalendarValue` / `readCalendarConfig` no longer throw on a falsy `eras` or `intercalary`** (`false`, `0`, `""`): it threw a `TypeError` where the profile says a reader refuses and shows bare numbers. It now returns `null`.
+- **A step is an integer, so the reader now refuses** an era whose `start` or `end` is not a whole number, a `year_base` other than `0` or `1` (a string `"1"` printed as `"01"` before), and month or weekday names that are not strings. Atlas writes none of these; the Unity SDK refuses them the same way.
+
+## [4.42.0] - 2026-10-20
+
+Schema 00.32.02 (Skeld, OW Council h58 #8811): repinned to schema-dist v0.32.2-dist.29.
+
+### Changed
+- **A Narrative's `start_date`** reads "Date when the narrative is first told or recorded, measured in world TIME units; the span it recounts lives on its events" (it read "Date when the narrative begins"), and **its `end_date`** reads "Date when the narrative stops being told, measured in world TIME units; empty while it is still told" (it read "Date when the narrative ends"), in the generated doc comments and `SCHEMA.md`. No field, type or link changed.
+- **`ONLYWORLDS_VERSION`** is `'00.32.02'`. It is an `as const` export, so its literal type moves too, which is why this is a minor and not a patch.
+
 ## [4.41.0] - 2026-10-20
 
 A known-of stub's public fields (keel PR 117, keel #448), live in production, and schema-dist v0.32.1-dist.28, which publishes them.

package/SCHEMA.md

@@ -1,6 +1,6 @@
 # OnlyWorlds Schema Reference
 
-**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.32.1-dist.28** — canonical schema **00.32.01**, published 2026-10-20.
+**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.32.2-dist.29** — canonical schema **00.32.02**, published 2026-10-20.
 
 GENERATED from the canonical schema YAML — do not hand-edit (regenerate: `python codegen/generate_types.py`).
 Written for both humans and AI agents reading this package locally.
@@ -400,8 +400,8 @@ Families (colour semantics; icon carries the type): agents · world · abstract
 
 - `story` (text) — Content of the narrative, as told or remembered
 - `consequences` (text) — Outcomes or legacy of the narrative
-- `start_date` (integer) — Date when the narrative begins, measured in world TIME units
-- `end_date` (integer) — Date when the narrative ends, measured in world TIME units
+- `start_date` (integer) — Date when the narrative is first told or recorded, measured in world TIME units; the span it recounts lives on its events
+- `end_date` (integer) — Date when the narrative stops being told, measured in world TIME units; empty while it is still told
 - `order` (integer) — Position of this narrative within a parent narrative's sequence
 - `parent_narrative` (single link → narrative) — Larger narrative that this narrative takes place in
 - `protagonist` (single link → character) — Primary character of the narrative

package/dist/index.d.ts

@@ -40,7 +40,7 @@ type ElementType = 'ability' | 'character' | 'collective' | 'construct' | 'creat
 declare const ELEMENT_TYPES: ElementType[];
 /** Canonical OnlyWorlds schema version. Source: the `canonical:` value of the pinned
  *  distribution's VERSION file (see the provenance block at the top of this file). */
-declare const ONLYWORLDS_VERSION: "00.32.01";
+declare const ONLYWORLDS_VERSION: "00.32.02";
 /** The four semantic families (colour carries the family; ELEMENT_ICONS carries the type). */
 type ElementFamily = 'agents' | 'world' | 'abstract' | 'temporal';
 /** Per-type semantic family. Source: the distribution's `presentation.json` sidecar

package/dist/index.js

@@ -1347,7 +1347,7 @@ function buildQuery(params) {
 
 // src/v2/types.generated.ts
 var ELEMENT_TYPES = ["ability", "character", "collective", "construct", "creature", "event", "family", "institution", "language", "law", "location", "map", "marker", "narrative", "object", "phenomenon", "pin", "relation", "species", "title", "trait", "zone"];
-var ONLYWORLDS_VERSION = "00.32.01";
+var ONLYWORLDS_VERSION = "00.32.02";
 var ELEMENT_FAMILIES = {
   ability: "abstract",
   character: "agents",
@@ -3001,18 +3001,21 @@ function readCalendarConfig(value) {
   const cfg = value;
   if (cfg.version !== 1 || typeof cfg.grain !== "string") return null;
   const months = cfg.bundles?.months;
-  if (months && (!Array.isArray(months.names) || !Array.isArray(months.lengths) || months.names.length !== months.lengths.length || months.names.length === 0)) return null;
-  if (cfg.eras && !Array.isArray(cfg.eras)) return null;
-  if (cfg.eras?.some((e) => typeof e?.name !== "string" || !Number.isFinite(e?.start))) return null;
-  if (cfg.intercalary && (!Array.isArray(cfg.intercalary) || cfg.intercalary.some((i) => typeof i?.name !== "string" || !Number.isInteger(i?.after_month)))) return null;
+  if (months && (!Array.isArray(months.names) || !Array.isArray(months.lengths) || months.names.length !== months.lengths.length || months.names.length === 0 || !months.names.every(isString))) return null;
+  if (cfg.eras != null && !Array.isArray(cfg.eras)) return null;
+  if (cfg.eras?.some((e) => typeof e?.name !== "string" || !Number.isSafeInteger(e?.start) || e.end != null && !Number.isSafeInteger(e.end) || e.year_base != null && e.year_base !== 0 && e.year_base !== 1)) return null;
+  if (cfg.intercalary != null && (!Array.isArray(cfg.intercalary) || cfg.intercalary.some((i) => typeof i?.name !== "string" || !Number.isInteger(i?.after_month)))) return null;
   if (months && !months.lengths.every(isPositiveInt)) return null;
   const year = cfg.bundles?.year;
   if (year != null && !isPositiveInt(year.steps)) return null;
   const week = cfg.bundles?.week;
-  if (week != null && (!isPositiveInt(week.length) || !Array.isArray(week.names))) return null;
+  if (week != null && (!isPositiveInt(week.length) || !Array.isArray(week.names) || !week.names.every(isString))) return null;
   if (cfg.intercalary?.some((i) => i.every_years != null && !isPositiveInt(i.every_years))) return null;
   return cfg;
 }
+function isString(s) {
+  return typeof s === "string";
+}
 function isPositiveInt(n) {
   return Number.isSafeInteger(n) && n >= 1;
 }

package/package.json

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