@lucern/contracts 0.1.2-alpha.1 → 0.1.2-alpha.3

package/dist/index.js

@@ -20,14 +20,28 @@ var FORK_REASONS = [
 var CONFIDENCE_TRIGGERS = [
   "evidence_added",
   // New evidence bore on the belief
+  "evidence_removed",
+  // Evidence was removed or invalidated
   "contradiction_detected",
   // A contradiction was flagged involving this belief
-  "merge_outcome",
-  // Merge scoring determined this confidence
+  "contradiction_resolved",
+  // A contradiction was resolved
   "manual",
   // User manually adjusted confidence
-  "decay"
+  "decay",
   // Time-based confidence erosion
+  "agent_assessment",
+  // An agent provided a structured assessment
+  "worktree_outcome",
+  // Worktree outcome determined this confidence
+  "worktree_completed",
+  // Worktree completed and closed this scoring loop
+  "fusion",
+  // Confidence came from subjective-logic fusion
+  "discount",
+  // Confidence came from trust discounting
+  "deduction"
+  // Confidence came from conditional deduction
 ];
 var BELIEF_STATUSES = [
   "unscored",
@@ -352,15 +366,16 @@ var DOMAIN_EVENT_TYPES = [
   "identity.key_revoked",
   "webhook.test"
 ];
+var RUNTIME_BUFFER = globalThis.Buffer;
 function toBase64(value) {
-  if (typeof Buffer !== "undefined") {
-    return Buffer.from(value, "utf8").toString("base64url");
+  if (typeof RUNTIME_BUFFER !== "undefined") {
+    return RUNTIME_BUFFER.from(value, "utf8").toString("base64url");
   }
   return btoa(unescape(encodeURIComponent(value))).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
 }
 function fromBase64(value) {
-  if (typeof Buffer !== "undefined") {
-    return Buffer.from(value, "base64url").toString("utf8");
+  if (typeof RUNTIME_BUFFER !== "undefined") {
+    return RUNTIME_BUFFER.from(value, "base64url").toString("utf8");
   }
   const normalized = value.replace(/-/g, "+").replace(/_/g, "/");
   return decodeURIComponent(escape(atob(normalized)));
@@ -580,13 +595,17 @@ var LENS_PERSPECTIVE_TYPES = [
 // src/mcp-tools.contract.ts
 var CREATE_BELIEF = {
   name: "create_belief",
-  description: "Commit a new belief (knowledge unit) to the reasoning graph. Like `git commit` \u2014 creates an atomic, traceable knowledge object. The belief starts as unscored (draft). Score it with modulate_confidence to freeze the formulation.",
+  description: "Commit a new belief (knowledge unit) to the reasoning graph. Like `git commit` \u2014 creates an atomic, traceable knowledge object with a mandatory prior. Creation stores the vacuous opinion `(0, 0, 1, a)`; use modulate_confidence to record the first evidential update.",
   parameters: {
     canonicalText: {
       type: "string",
       description: "The belief statement \u2014 what the agent holds to be true"
     },
     topicId: { type: "string", description: "Topic scope for the belief" },
+    baseRate: {
+      type: "number",
+      description: "Required prior probability used to seed the vacuous opinion `(0, 0, 1, a)` at creation time."
+    },
     beliefType: {
       type: "string",
       description: "Belief type (e.g., hypothesis, belief, principle, invariant, tenet, forecast). Validated against schemaEnumConfig."
@@ -596,7 +615,7 @@ var CREATE_BELIEF = {
       description: "Optional extra metadata merged into the node (e.g., { codeAnchors: ['path/to/file.ts'] } for coding intelligence)"
     }
   },
-  required: ["canonicalText", "topicId"],
+  required: ["canonicalText", "topicId", "baseRate"],
   response: {
     description: "The created canonical belief record",
     fields: {
@@ -659,17 +678,43 @@ var REFINE_BELIEF = {
 };
 var MODULATE_CONFIDENCE = {
   name: "modulate_confidence",
-  description: "Record a confidence change for a belief. Like `git commit` to the credence log \u2014 an atomic, append-only write. Each modulation is a new entry in the history, not an overwrite. Scoring happens via merge; this tool records the individual data points. Triggers: evidence_added, contradiction_detected, merge_outcome, manual, decay.",
+  description: "Record a confidence change for a belief. Like `git commit` to the credence log \u2014 an atomic, append-only write. Each modulation is a new entry in the history, not an overwrite. Scoring happens via merge; this tool records the individual data points. Pass the full subjective-logic tuple (`belief`, `disbelief`, `uncertainty`, `baseRate`) directly. If a caller only has a scalar probability, use `@lucern/sdk` helpers `opinionFromBaseRate`, `opinionFromDogmatic`, or `opinionFromProjected` to name the intended interpretation before calling this tool. Triggers: evidence_added, evidence_removed, contradiction_detected, contradiction_resolved, agent_assessment, worktree_outcome, worktree_completed, fusion, discount, deduction, manual, decay.",
   parameters: {
     nodeId: { type: "string", description: "The belief to score" },
-    confidence: { type: "number", description: "Confidence level in [0, 1]" },
+    belief: {
+      type: "number",
+      description: "Subjective-logic belief mass `b` in [0, 1]"
+    },
+    disbelief: {
+      type: "number",
+      description: "Subjective-logic disbelief mass `d` in [0, 1]"
+    },
+    uncertainty: {
+      type: "number",
+      description: "Subjective-logic uncertainty mass `u` in [0, 1]"
+    },
+    baseRate: {
+      type: "number",
+      description: "Subjective-logic base rate `a` in [0, 1]. Required for tuple payloads."
+    },
+    confidence: {
+      type: "number",
+      description: "Deprecated scalar confidence value in [0, 1]. Scalar-only payloads are rejected as AMBIGUOUS_SCALAR."
+    },
     trigger: {
       type: "string",
       description: "What caused this confidence change",
       enum: [
         "evidence_added",
+        "evidence_removed",
         "contradiction_detected",
-        "merge_outcome",
+        "contradiction_resolved",
+        "agent_assessment",
+        "worktree_outcome",
+        "worktree_completed",
+        "fusion",
+        "discount",
+        "deduction",
         "manual",
         "decay"
       ]
@@ -679,7 +724,7 @@ var MODULATE_CONFIDENCE = {
       description: "Human-readable explanation of why confidence changed"
     }
   },
-  required: ["nodeId", "confidence", "trigger", "rationale"],
+  required: ["nodeId", "trigger", "rationale"],
   response: {
     description: "Confidence modulation result",
     fields: {
@@ -1321,7 +1366,7 @@ var RECORD_JUDGMENT = {
       status: "string \u2014 'issued'"
     }
   },
-  ownerModule: "decision-state",
+  ownerModule: "decisions",
   ontologyPrimitive: "judgment",
   tier: "showcase"
 };
@@ -2590,7 +2635,7 @@ var INGEST_OBSERVATION = {
       contextResourceUri: "string"
     }
   },
-  ownerModule: "agent-harness",
+  ownerModule: "agent-frameworks",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2620,7 +2665,7 @@ var GET_OBSERVATION_CONTEXT = {
       generatedAt: "number"
     }
   },
-  ownerModule: "agent-harness",
+  ownerModule: "agent-frameworks",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -4559,7 +4604,7 @@ var CREATE_BELIEF_CONDITIONAL = {
       targetBeliefId: "string"
     }
   },
-  ownerModule: "graph-primitives",
+  ownerModule: "edges",
   ontologyPrimitive: "edge",
   tier: "sdk-only"
 };