@lucern/contracts 1.0.19 → 1.0.20

package/CHANGELOG.md

@@ -64,3 +64,6 @@ All notable changes to `@lucern/contracts` are tracked in this repository.
 
 ## [1.0.19] - 2026-06-04
 - Release notes pending.
+
+## [1.0.20] - 2026-06-05
+- Release notes pending.

package/dist/function-registry/beliefs.js

@@ -3,6 +3,12 @@ import { v } from 'convex/values';
 
 // src/function-registry/beliefs.ts
 
+// src/ids/index.ts
+var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function isUuidV7(value) {
+  return UUID_PATTERN.test(value) && value[14]?.toLowerCase() === "7";
+}
+
 // src/tool-contracts.lifecycle.ts
 var CREATE_BELIEF = {
   name: "create_belief",
@@ -14,15 +20,7 @@ var CREATE_BELIEF = {
     },
     topicGlobalId: {
       type: "string",
-      description: "Required globalId (UUID) of the topic node in epistemicNodes that anchors the belief"
-    },
-    topicNodeId: {
-      type: "string",
-      description: "Optional internal epistemicNodes _id for the topic anchor. Prefer topicGlobalId for public callers."
-    },
-    topicId: {
-      type: "string",
-      description: "Deprecated compatibility alias for topicGlobalId. Must identify a topic epistemicNode, not a legacy topics-table row."
+      description: "Required UUIDv7 globalId of the topic node in epistemicNodes that anchors the belief. Legacy topics-table ids, Convex storage locators, and UUIDv4 values are refused."
     },
     baseRate: {
       type: "number",
@@ -5313,6 +5311,7 @@ z.enum(["private", "team", "firm", "external", "public"]);
 
 // src/function-registry/helpers.ts
 var jsonObjectSchema = z.record(z.unknown());
+var uuidV7StringSchema = z.string().refine(isUuidV7, "must be UUIDv7");
 var sdkSessionIdSchema = z.string().optional();
 function mcpContractShape(contract) {
   const required = new Set(contract.required);
@@ -5793,14 +5792,8 @@ var predictionMetaSchema = z.object({
 });
 var createBeliefArgs = z.object({
   canonicalText: z.string().describe("The belief statement the agent holds to be true."),
-  topicGlobalId: z.string().describe(
-    "Required globalId of the topic epistemicNode that anchors this belief. Belief creation creates a belongs_to edge directly to that topic node."
-  ),
-  topicNodeId: z.string().optional().describe(
-    "Optional internal epistemicNodes _id for the topic anchor. Prefer topicGlobalId for public callers."
-  ),
-  topicId: z.string().optional().describe(
-    "Deprecated compatibility alias for topicGlobalId. Must identify a topic epistemicNode, not a legacy topics-table row."
+  topicGlobalId: uuidV7StringSchema.describe(
+    "Required UUIDv7 globalId of the topic epistemicNode that anchors this belief. Belief creation creates a belongs_to edge directly to that topic node."
   ),
   baseRate: z.number().optional().describe("Prior base rate used to seed the vacuous opinion."),
   beliefStatus: beliefLifecycleStatusSchema.optional().describe(
@@ -5847,9 +5840,8 @@ var createBeliefInput = (input, context) => {
   return withUserId(
     compactRecord({
       projectId: input.projectId,
-      topicId: input.topicGlobalId ?? input.topicNodeId ?? input.topicId,
+      topicId: input.topicGlobalId,
       topicGlobalId: input.topicGlobalId,
-      topicNodeId: input.topicNodeId,
       formulation: input.formulation ?? input.canonicalText,
       beliefType: input.beliefType,
       rationale: input.rationale,
@@ -5908,7 +5900,8 @@ var beliefsContracts = [
       kind: "mutation",
       inputProjection: createBeliefInput
     },
-    args: createBeliefArgs
+    args: createBeliefArgs,
+    input: createBeliefArgs
   }),
   surfaceContract({
     name: "get_belief",