@onlyworlds/sdk 4.67.0 → 4.69.0

package/CHANGELOG.md

@@ -5,6 +5,19 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.69.0] - 2026-10-23
+
+### Added
+
+- **`draught(id, { compact: true })`** (keel #585, PR 198): the draught without its empty sections. Every empty array or object section and an empty `cut` are left out. The frame (`world`, `calendar`, `as_of`, `now`, `mode`, `policy`) and every null stay, so a null is still an answer: `character` null means she is hidden from this reader, `style` null that she has no style element, `recent_cursor` null that the read had no `since`. An absent section means nothing in it, never that it was not read (`policy.components` says what was). The answer is typed `OwDraughtCompact` (`cut` optional); without `compact`, or with `compact: false`, it is `OwDraught` as before, the fixed shape. A `compact` that is not a boolean is a TypeError before anything is sent. MCP's `get_draught` defaults to compact; this route defaults to the fixed shape.
+
+## [4.68.0] - 2026-10-23
+
+### Fixed
+
+- **`patchWorld` strips `counts`**, which a keyless `GET /world` carries (keel #421 PR 4, the public reader on since 2026-10-23) and `PATCH` answers as an unknown key, so the body of a keyless read goes back too. Quillon's port found it (h29 #11241); the Python package's live wire test went red on the same key the same hour.
+- **`reviewNewElement` refuses a reason with an accept** before sending (keel takes `{ decision: 'accept' }` alone; a reason was its 422), and **checks its answer**: an accept that answers no `element`, or a decline no `deleted`, is a `TypeError` naming the route. Both as the Python package does (Quillon, h29 #11241).
+
 ## [4.67.0] - 2026-10-23
 
 ### Added

package/dist/index.d.ts

@@ -2748,6 +2748,15 @@ interface OwDraughtPolicy {
     budget?: number;
     /** The sheet's reach: 1 (default) what her own element links to, 0 none. */
     depth?: 0 | 1;
+    /**
+     * `true` (keel #585) leaves out every empty section (an empty array or object) and an empty `cut`;
+     * the frame (`world`, `calendar`, `as_of`, `now`, `mode`, `policy`) and every null stay, so a null
+     * is still an answer (`character`: she is hidden from this reader; `style`: she has no style
+     * element; `recent_cursor`: this read had no `since`). An absent section means nothing in it, never
+     * that it was not read (`policy.components` says what was read). Default `false`, the fixed shape;
+     * with `compact` the answer is typed `OwDraughtCompact`.
+     */
+    compact?: boolean;
 }
 /**
  * A section of the draught, in the packet's order (keel's COMPONENTS). `messages`, `room` (keel #556:
@@ -2771,6 +2780,10 @@ interface OwDraughtItem {
     element: OwElement;
 }
 /** One Character's context in one read, GET /character/{id}/context (keel PR 155, D143; the draught). */
+/** The draught under `compact` (keel #585): every section may be absent, and so may `cut` (nothing was cut). */
+type OwDraughtCompact = Omit<OwDraught, 'cut'> & {
+    cut?: Record<string, number>;
+};
 interface OwDraught {
     world: {
         id: string;
@@ -2862,8 +2875,8 @@ interface OwCreateAccountWorldInput {
 }
 /**
  * createAccountWorld's 201: the world's row as listAccountWorlds lists it, plus the full write key
- * once in `key` (never shown again). keel's document gives this answer no schema; the keys are
- * keel's handler's (`accounts/api.py`, `create_world`: the list row plus `key`).
+ * once in `key` (never shown again). keel's document names it `AccountWorldCreated` (keel #579), and
+ * Assembly's verify-sdk-wire holds this type to it key for key.
  */
 interface OwCreatedAccountWorld {
     id: string;
@@ -3633,7 +3646,10 @@ declare class OwV2Client {
      * empty means the serving is partial (`cut.proposed` also counts proposed elements left out because
      * the component was not named). Served `Cache-Control: private, no-store`.
      */
-    draught(characterId: string, policy?: OwDraughtPolicy): Promise<OwDraught>;
+    draught(characterId: string, policy?: OwDraughtPolicy & {
+        compact?: false;
+    }): Promise<OwDraught>;
+    draught(characterId: string, policy: OwDraughtPolicy): Promise<OwDraughtCompact>;
     /** Cursor-walk every page of a type. Politeness: uses config pageSize. */
     listAll(type: ElementType | string, params?: Omit<ListParams, 'cursor'>): AsyncGenerator<OwElement>;
     /**
@@ -5428,4 +5444,4 @@ declare class TokenResource {
     getEncryptionInfo(): Promise<EncryptionInfo>;
 }
 
-export { AGENT_DOORS, ASK_LIMITS, type AccessKeyResponse, CALENDAR_FIELD, CALENDAR_SUPERTYPE, type CalendarConfig, type CalendarEra, type CalendarIntercalary, type CalendarMonths, type CalendarWeek, ELEMENT_FAMILIES, ELEMENT_ICONS, ELEMENT_LABELS, ELEMENT_SECTIONS, ELEMENT_TYPES, type ElementFamily, type ElementType, type EncryptionInfo, type EraDomain, FAMILY_COLORS, FAMILY_ORDER, FIELD_ACRONYMS, FIELD_SCHEMA, FILE_EXTENSIONS, type FieldInfo, type FieldType, GameTier, type ListParams, ONLYWORLDS_VERSION, type OwAccountWorld, type OwAgentJoined, type OwAllowance, OwApiError, type OwAskAnswer, type OwAskContext, type OwAuthErrorCode, type OwBulkItem, type OwBulkItemResult, type OwBulkResponse, type OwCalendarElement, type OwChange, type OwChangeDelete, type OwChangeUpsert, type OwChangesPage, type OwClientConfig, type OwCreateAccountWorldInput, type OwCreatedAccountWorld, type OwCreatedWorldLink, type OwDeleteReason, type OwDraught, type OwDraughtComponent, type OwDraughtItem, type OwDraughtPolicy, type OwElement, type OwElementBase, type OwErrorBody, type OwFileAddedBy, type OwFileDownload, type OwFileKind, type OwFileRow, type OwFileTicket, type OwFrontDoor, type OwHiddenRow, type OwJoinPreview, type OwJoined, type OwJoinedMembership, type OwKeyKind, type OwLinkEdit, type OwLookupElement, type OwLookupHit, type OwLookupLink, type OwLookupOptions, type OwLookupReason, type OwMe, type OwMediaTicket, type OwMember, type OwMemberRole, type OwMintedKey, type OwNamesMap, OwNetworkError, type OwPage, type OwPhotoOptions, type OwPhotoPlan, type OwPlayerJoined, OwPreconditionFailedError, type OwPreparedPhoto, type OwProposal, type OwProposalAccepted, type OwProposalConflict, type OwProposalList, type OwProposalQuery, type OwProposalState, type OwProposeInput, type OwProposed, OwProposedError, type OwProposedNewElement, type OwReadWorldFile, type OwReadWorldFileOptions, type OwRemovalTicket, type OwRemovedImage, type OwRenderOptions, type OwResyncReason, type OwReviewInput, type OwReviewed, type OwSeat, type OwSeatCreated, type OwSignInBegin, type OwSignInBegun, type OwSignInComplete, OwSignInError, type OwSignInReason, type OwSignInResult, type OwSignInStorage, type OwSignedIn, type OwSortAddToRow, type OwSortAnswer, type OwSortAskRow, type OwSortLinkRow, type OwSortMakeRow, type OwSortNote, type OwSortRef, type OwSortRow, OwStaleProposalError, type OwUploadedFile, type OwUploadedImage, OwV2Client, type OwWordPair, type OwWorldFileEntry, OwWorldFileError, type OwWorldFileReason, type OwWorldFileRow, type OwWorldFiles, type OwWorldIndex, type OwWorldLink, type OwWorldMeta, type OwWorldOrigin, type OwWorldProducer, type OwWorldProposalList, type OwWorldProposalQuery, type OwWorldProposalRow, type OwWorldPublicPage, type OwWorldSource, type OwWriteDoor, type OwWriteWorldFileOptions, PHOTO_MAX_BYTES, PHOTO_TYPES, PUBLIC_FIELDS, type ParseError, type ParseOptions, type ParseResult, ROOM_PAIRS, type RevokeAllSessionsResponse, type RevokeSessionResponse, SPATIAL_TYPES, type SectionInfo, type StepBreakdown, type TokenConsumeParams, type TokenConsumeResponse, TokenResource, type TokenStatus, type TokenTransport, WORLD_FILE_MAX_BYTES, WORLD_FILE_MAX_ENTRIES, WORLD_FILE_MEDIA_TYPE, type WorldCalendar, absYearForEraYear, absoluteYear, approxYearLength, base64url, breakdownStep, buildAskContext, buildWorldIndex, detectKeyKind, displayYear, elementColor, eraForStep, errorFromResponse, familyOf, fieldLabel, fileKindOf, floorDiv, floorMod, formatDuration, formatMidLabel, formatStep, formatYearLabel, getElementIcon, getElementLabel, isAgentDoor, isDemoKey, isKnownOf, isLeapYear, isParseError, isRoomElement, kindCanWrite, lookupWorld, monthStartSteps, parseDate, parseErrorEnvelope, pinExpectation, pkceChallenge, planPhoto, preparePhoto, readCalendarConfig, readCalendarValue, readWorldFile, renderElement, resolveCalendarLens, resolveEraDomains, simpleCaseFold, typeWord, validateCalendarConfig, weekdayForStep, worldCalendars, writeWorldFile, yearLength, yearStartStep };
+export { AGENT_DOORS, ASK_LIMITS, type AccessKeyResponse, CALENDAR_FIELD, CALENDAR_SUPERTYPE, type CalendarConfig, type CalendarEra, type CalendarIntercalary, type CalendarMonths, type CalendarWeek, ELEMENT_FAMILIES, ELEMENT_ICONS, ELEMENT_LABELS, ELEMENT_SECTIONS, ELEMENT_TYPES, type ElementFamily, type ElementType, type EncryptionInfo, type EraDomain, FAMILY_COLORS, FAMILY_ORDER, FIELD_ACRONYMS, FIELD_SCHEMA, FILE_EXTENSIONS, type FieldInfo, type FieldType, GameTier, type ListParams, ONLYWORLDS_VERSION, type OwAccountWorld, type OwAgentJoined, type OwAllowance, OwApiError, type OwAskAnswer, type OwAskContext, type OwAuthErrorCode, type OwBulkItem, type OwBulkItemResult, type OwBulkResponse, type OwCalendarElement, type OwChange, type OwChangeDelete, type OwChangeUpsert, type OwChangesPage, type OwClientConfig, type OwCreateAccountWorldInput, type OwCreatedAccountWorld, type OwCreatedWorldLink, type OwDeleteReason, type OwDraught, type OwDraughtCompact, type OwDraughtComponent, type OwDraughtItem, type OwDraughtPolicy, type OwElement, type OwElementBase, type OwErrorBody, type OwFileAddedBy, type OwFileDownload, type OwFileKind, type OwFileRow, type OwFileTicket, type OwFrontDoor, type OwHiddenRow, type OwJoinPreview, type OwJoined, type OwJoinedMembership, type OwKeyKind, type OwLinkEdit, type OwLookupElement, type OwLookupHit, type OwLookupLink, type OwLookupOptions, type OwLookupReason, type OwMe, type OwMediaTicket, type OwMember, type OwMemberRole, type OwMintedKey, type OwNamesMap, OwNetworkError, type OwPage, type OwPhotoOptions, type OwPhotoPlan, type OwPlayerJoined, OwPreconditionFailedError, type OwPreparedPhoto, type OwProposal, type OwProposalAccepted, type OwProposalConflict, type OwProposalList, type OwProposalQuery, type OwProposalState, type OwProposeInput, type OwProposed, OwProposedError, type OwProposedNewElement, type OwReadWorldFile, type OwReadWorldFileOptions, type OwRemovalTicket, type OwRemovedImage, type OwRenderOptions, type OwResyncReason, type OwReviewInput, type OwReviewed, type OwSeat, type OwSeatCreated, type OwSignInBegin, type OwSignInBegun, type OwSignInComplete, OwSignInError, type OwSignInReason, type OwSignInResult, type OwSignInStorage, type OwSignedIn, type OwSortAddToRow, type OwSortAnswer, type OwSortAskRow, type OwSortLinkRow, type OwSortMakeRow, type OwSortNote, type OwSortRef, type OwSortRow, OwStaleProposalError, type OwUploadedFile, type OwUploadedImage, OwV2Client, type OwWordPair, type OwWorldFileEntry, OwWorldFileError, type OwWorldFileReason, type OwWorldFileRow, type OwWorldFiles, type OwWorldIndex, type OwWorldLink, type OwWorldMeta, type OwWorldOrigin, type OwWorldProducer, type OwWorldProposalList, type OwWorldProposalQuery, type OwWorldProposalRow, type OwWorldPublicPage, type OwWorldSource, type OwWriteDoor, type OwWriteWorldFileOptions, PHOTO_MAX_BYTES, PHOTO_TYPES, PUBLIC_FIELDS, type ParseError, type ParseOptions, type ParseResult, ROOM_PAIRS, type RevokeAllSessionsResponse, type RevokeSessionResponse, SPATIAL_TYPES, type SectionInfo, type StepBreakdown, type TokenConsumeParams, type TokenConsumeResponse, TokenResource, type TokenStatus, type TokenTransport, WORLD_FILE_MAX_BYTES, WORLD_FILE_MAX_ENTRIES, WORLD_FILE_MEDIA_TYPE, type WorldCalendar, absYearForEraYear, absoluteYear, approxYearLength, base64url, breakdownStep, buildAskContext, buildWorldIndex, detectKeyKind, displayYear, elementColor, eraForStep, errorFromResponse, familyOf, fieldLabel, fileKindOf, floorDiv, floorMod, formatDuration, formatMidLabel, formatStep, formatYearLabel, getElementIcon, getElementLabel, isAgentDoor, isDemoKey, isKnownOf, isLeapYear, isParseError, isRoomElement, kindCanWrite, lookupWorld, monthStartSteps, parseDate, parseErrorEnvelope, pinExpectation, pkceChallenge, planPhoto, preparePhoto, readCalendarConfig, readCalendarValue, readWorldFile, renderElement, resolveCalendarLens, resolveEraDomains, simpleCaseFold, typeWord, validateCalendarConfig, weekdayForStep, worldCalendars, writeWorldFile, yearLength, yearStartStep };

package/dist/index.js

@@ -690,22 +690,11 @@ var OwV2Client = class {
     });
     return this.request("GET", `/${type}/`, { query });
   }
-  /**
-   * GET /character/{id}/context -- the draught (keel PR 155, D143): what one Character knows, as the
-   * recorded world holds it, in one read: her element, what she holds and sits in, her open work,
-   * how she works, the Events she was in, the Narratives she knows, everything else that names
-   * her, her sheet, what changed around her (`since`), and who plays whom; the world's name and
-   * calendar beside; the room's messages (`messages`), its other elements (`room`, keel #556) and
-   * elements written as proposed (`proposed`, keel #580) only when `components` names them. Each
-   * row carries the list route's body for the same reader as `element`, beside `via`, `her_links`
-   * and `grade`; nothing is inferred. The owner's keys, co-builders and contributors for any
-   * Character they can see; a player seat or a guest for its own Character only (another id is
-   * 404). `asOf` is a filter on the elements' own dates, not time travel. A `cut` that is not
-   * empty means the serving is partial (`cut.proposed` also counts proposed elements left out because
-   * the component was not named). Served `Cache-Control: private, no-store`.
-   */
   async draught(characterId, policy = {}) {
-    only("draught", policy, ["components", "mode", "asOf", "undated", "since", "budget", "depth"]);
+    only("draught", policy, ["components", "mode", "asOf", "undated", "since", "budget", "depth", "compact"]);
+    if (policy.compact !== void 0 && typeof policy.compact !== "boolean") {
+      throw new TypeError("draught: compact is true or false. Nothing was sent.");
+    }
     const query = buildQuery({
       components: policy.components?.join(","),
       mode: policy.mode,
@@ -713,7 +702,8 @@ var OwV2Client = class {
       undated: policy.undated,
       since: policy.since,
       budget: policy.budget,
-      depth: policy.depth
+      depth: policy.depth,
+      compact: policy.compact
     });
     return this.request("GET", `/character/${characterId}/context`, { query });
   }
@@ -1653,9 +1643,18 @@ var OwV2Client = class {
     if (opts?.decision !== "accept" && opts?.decision !== "decline") {
       throw new TypeError(`reviewNewElement: decision must be 'accept' or 'decline', got ${JSON.stringify(opts?.decision) ?? String(opts?.decision)}. Nothing was sent.`);
     }
+    if (opts.reason !== void 0 && opts.decision !== "decline") {
+      throw new TypeError("reviewNewElement: a reason goes with a decline only. Nothing was sent.");
+    }
     const body = { decision: opts.decision };
     if (opts.reason !== void 0) body.reason = opts.reason;
-    return this.request("POST", `/${type}/${encodeURIComponent(id)}/review`, { elementWrite: true, body });
+    const path = `/${type}/${encodeURIComponent(id)}/review`;
+    const answer = await this.request("POST", path, { elementWrite: true, body });
+    const settled = opts.decision === "accept" ? "element" : "deleted";
+    if (answer === null || typeof answer !== "object" || !(settled in answer)) {
+      throw new TypeError(`reviewNewElement: POST ${path} answered no ${settled}: ${JSON.stringify(answer)?.slice(0, 200)}`);
+    }
+    return answer;
   }
   // -- The account's worlds and keys (account token) -----------------------
   /**
@@ -1870,7 +1869,7 @@ var HeadPollState = class {
   }
 };
 var READ_ONLY_FIELDS = ["world", "type", "created_at", "updated_at", "change_seq", "known_of"];
-var WORLD_READ_ONLY_FIELDS = ["id", "slug", "public_page", "public_read", "agent_narrator_rule", "agent_writes_proposed", "origin"];
+var WORLD_READ_ONLY_FIELDS = ["id", "slug", "public_page", "public_read", "agent_narrator_rule", "agent_writes_proposed", "origin", "counts"];
 function proposalsPath(type, id) {
   return `/${type}/${encodeURIComponent(id)}/proposals`;
 }

package/package.json

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