@lucern/sdk 1.0.19 → 1.0.20

package/CHANGELOG.md

@@ -5,6 +5,9 @@ All notable changes to `@lucern/sdk` will be documented in this file.
 ## [Unreleased]
 - No unreleased changes yet.
 
+## [1.0.20] - 2026-06-05
+- Release notes pending.
+
 ## [1.0.19] - 2026-06-04
 - Release notes pending.
 

package/dist/beliefsClient.d.ts

@@ -29,16 +29,14 @@ export declare function mapOpinionHistoryEntriesFromGatewayData(payload: Gateway
  *
  * Use `text` as the canonical belief statement.
  * `canonicalText` remains available as a legacy alias for backwards compatibility.
+ * `topicGlobalId` is a required UUIDv7 topic epistemic-node globalId; SDK
+ * creation no longer translates `topicId` or `topicNodeId` into a write anchor.
  * Beliefs start as drafts with a vacuous prior `(0, 0, 1, a)`. When omitted,
  * `baseRate` defaults to the canonical neutral prior `0.5`.
  */
 export type CreateBeliefInput = {
-    /** Required topic epistemicNodes globalId. */
-    topicGlobalId?: string;
-    /** Optional internal epistemicNodes _id for the topic anchor. */
-    topicNodeId?: string;
-    /** @deprecated Use topicGlobalId. Must identify a topic epistemicNode, not a legacy topics-table row. */
-    topicId?: string;
+    /** Required UUIDv7 topic epistemicNodes globalId. */
+    topicGlobalId: string;
     /** Preferred belief statement alias. */
     text?: string;
     /** @deprecated Use text. */

package/dist/beliefsClient.js

@@ -1,5 +1,6 @@
 import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, } from "./coreClient.js";
 import { normalizeNodeWriteInput } from "./sdkSurface.js";
+import { isUuidV7 } from "@lucern/contracts/ids";
 export { LucernApiError };
 function asRecord(value) {
     return value && typeof value === "object" && !Array.isArray(value)
@@ -101,6 +102,21 @@ export function createBeliefsClient(config = {}) {
         }
         return normalized;
     }
+    function normalizeCreateBeliefInput(input) {
+        const topicGlobalId = readString(input.topicGlobalId);
+        if (!topicGlobalId || !isUuidV7(topicGlobalId)) {
+            throw new Error("createBelief requires topicGlobalId to be a UUIDv7 topic epistemic-node globalId.");
+        }
+        const text = readString(input.text) ?? readString(input.canonicalText);
+        const body = { ...input, topicGlobalId };
+        delete body.topicId;
+        delete body.topicNodeId;
+        if (text) {
+            body.text = text;
+            body.canonicalText = text;
+        }
+        return body;
+    }
     const getOpinionHistory = async (beliefId) => {
         const response = await gateway.request({
             path: `/api/platform/v1/beliefs/${encodeURIComponent(beliefId)}/confidence-history`,
@@ -117,7 +133,7 @@ export function createBeliefsClient(config = {}) {
                 path: "/api/platform/v1/beliefs",
                 method: "POST",
                 body: {
-                    ...normalizeNodeWriteInput(input),
+                    ...normalizeCreateBeliefInput(input),
                     baseRate,
                 },
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),

package/dist/proof-attestation.json

@@ -41,5 +41,5 @@
     "convex-validators",
     "proof-attestation"
   ],
-  "signedAt": 1780614051827
+  "signedAt": 1780649268504
 }

package/dist/sdkSurface.d.ts

@@ -3,7 +3,6 @@ import type { JsonObject, ListResult } from "./types";
 type TopicScopedValue = {
     topicId?: string;
     topicGlobalId?: string;
-    topicNodeId?: string;
 };
 type TextScopedValue = {
     text?: string;

package/dist/sdkSurface.js

@@ -29,9 +29,7 @@ function cloneWith(value, patch) {
  * Resolve the canonical topic identifier.
  */
 export function resolveTopicId(value) {
-    return (cleanString(value.topicGlobalId) ??
-        cleanString(value.topicNodeId) ??
-        cleanString(value.topicId));
+    return cleanString(value.topicGlobalId) ?? cleanString(value.topicId);
 }
 /**
  * Resolve the canonical text field from text-first or legacy canonicalText-first inputs.

package/dist/types.d.ts

@@ -18,14 +18,11 @@ export type JsonValue = null | boolean | number | string | JsonArray | JsonObjec
  */
 export type TopicIdentifierInput = {
     /**
-     * Preferred write anchor for belief creation: the globalId of a topic
-     * epistemicNode. `topicId` remains a compatibility projection for read/query
-     * surfaces and must already refer to that same topic node when used for
-     * belief writes.
+     * Preferred write anchor for belief creation: the UUIDv7 globalId of a topic
+     * epistemicNode. `topicId` remains a read/query scope for non-belief-write
+     * surfaces.
      */
     topicGlobalId?: string;
-    /** Optional internal epistemicNodes _id for a topic node. */
-    topicNodeId?: string;
     topicId?: string;
 };
 /**

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Current SDK package version. */
-export declare const LUCERN_SDK_VERSION = "1.0.19";
+export declare const LUCERN_SDK_VERSION = "1.0.20";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Current SDK package version. */
-export const LUCERN_SDK_VERSION = "1.0.19";
+export const LUCERN_SDK_VERSION = "1.0.20";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucern/sdk",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -113,10 +113,10 @@
     "typecheck": "tsc --project tsconfig.typecheck.json --noEmit"
   },
   "dependencies": {
-    "@lucern/contracts": "1.0.19",
-    "@lucern/reasoning-kernel": "1.0.19",
-    "@lucern/secrets": "1.0.19",
-    "@lucern/transport-core": "1.0.19",
+    "@lucern/contracts": "1.0.20",
+    "@lucern/reasoning-kernel": "1.0.20",
+    "@lucern/secrets": "1.0.20",
+    "@lucern/transport-core": "1.0.20",
     "effect": "^3.21.2",
     "zod": "^3.25.76"
   },