@lucern/contracts 1.0.19 → 1.0.20

package/dist/function-registry/topics.js

@@ -2,6 +2,12 @@ import { z } from 'zod';
 
 // src/function-registry/helpers.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",
@@ -13,15 +19,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",
@@ -5312,6 +5310,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);
@@ -5597,7 +5596,9 @@ var topicVisibilitySchema = z.enum([
 ]);
 var topicStatusSchema = z.enum(["active", "archived", "watching"]);
 var createTopicArgs = z.object({
-  globalId: z.string().optional().describe("Optional idempotent topic global ID."),
+  globalId: uuidV7StringSchema.optional().describe(
+    "Optional idempotent UUIDv7 topic global ID. When omitted, the kernel mints UUIDv7."
+  ),
   name: z.string().describe("Topic name."),
   description: z.string().optional().describe("Topic description."),
   type: z.string().describe("Topic type."),
@@ -5663,7 +5664,8 @@ var topicsContracts = [
       kind: "mutation",
       inputProjection: withCreatedBy
     },
-    args: createTopicArgs
+    args: createTopicArgs,
+    input: createTopicArgs
   }),
   surfaceContract({
     name: "get_topic",