@onlyworlds/sdk 4.18.0 → 4.18.1

package/AGENTS.md

@@ -1,6 +1,6 @@
 # For AI agents using @onlyworlds/sdk
 
-**Current as of**: SDK **4.x** · schema-dist **v0.32.0-dist.20** (canonical 00.32.00).
+**Current as of**: SDK **4.x** · schema-dist **v0.32.0-dist.23** (canonical 00.32.00).
 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.
 
@@ -45,6 +45,10 @@ against live data). The v1 surface (`OnlyWorldsClient`, the `ElementType` enum)
 - Ask (since 4.13.0, account token): `buildAskContext(hits, index)` then
   `account.ask({ worldId, question, context })`; answers only from the context. 50 a day per
   account (`err.isQuotaExceeded`); `isAskUnavailable`, `isAskFailed` count nothing.
+- Sort (since 4.18.0, account token): `account.sort({ worldId, notes, slice })` turns unsorted
+  notes (text, or a picture already uploaded into the world) into rows to review: `make`,
+  `add_to`, `link`, `ask`, plus `not_proposed` with reasons. Ids come only from your `slice`
+  (up to 100 elements your own lookup found); nothing is written. Counts as one ask.
 - Invite links (since 4.12.0): `previewJoin(code)` (no credential sent) shows who invites, to
   which world, in what role; `acceptJoin(code)` with an `ow_a_` account token joins. Bad code:
   `err.isNotFound`; `err.isAlreadyMember`, `err.isPinRequired` for the two 409s.

package/CHANGELOG.md

@@ -5,6 +5,14 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.18.1] — 2026-10-12
+
+### Changed
+- **Schema repinned to schema-dist v0.32.0-dist.23** (same canonical 00.32.00). The one
+  generated change is the `id` doc comment: a UUID, new ids minted as uuidv7, earlier uuidv4
+  ids still valid. No type changes. The vendored dist gains `walk/lint_folder.py`.
+- README and AGENTS.md describe `sort()`.
+
 ## [4.18.0] — 2026-10-12
 
 ### Added

package/README.md

@@ -174,6 +174,14 @@ const reply = await account.ask({ worldId, question, context }); // account: a c
 reply.answer;                                            // from those elements only, or "The world doesn't say."
 ```
 
+The same proxy sorts loose notes into changes for the user to review. Send the elements your own lookup found for them as the `slice`; every id in a row comes from it, and nothing is written until your app applies what the user accepts. A sort counts as one question.
+
+```typescript
+const slice = hits.slice(0, 100).map(({ element: e }) => ({ id: e.id, type: e.type, name: e.name }));
+const { rows, not_proposed } = await account.sort({ worldId, notes: ['Mira moved to Ostvik.'], slice });
+// rows: make (a new element), add_to (text for a field), link (one element to another), ask (which one?)
+```
+
 ## World files
 
 A world file is one `.zip` holding a whole world folder (`world.json` and `elements/<type>/*.json`, as Atlas keeps a world on disk), the way Atlas downloads and opens one. It needs no account and works in the browser and in Node.

package/SCHEMA.md

@@ -1,6 +1,6 @@
 # OnlyWorlds Schema Reference
 
-**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.32.0-dist.20** — canonical schema **00.32.00**, published 2026-10-11.
+**Source**: https://github.com/OnlyWorlds/schema-dist @ **v0.32.0-dist.23** — canonical schema **00.32.00**, published 2026-10-12.
 
 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.

package/dist/index.d.ts

@@ -6,7 +6,7 @@
 interface OwElementBase {
     /** Element type slug (server-managed, read-only). */
     type: string;
-    /** Unique identifier for the element, uuidv7 format. */
+    /** Unique identifier for the element, a UUID. New ids are minted as uuidv7; ids minted earlier as uuidv4 remain valid. */
     id: string;
     /** Name of the element. */
     name: string;

package/package.json

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