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

package/dist/sdk-methods.contract.d.ts

@@ -39,6 +39,7 @@ type CreateBeliefInput = {
     layer?: EpistemicLayer;
     domain?: string;
     nodeType?: string;
+    baseRate: number;
 };
 /** Result of createBelief() */
 type BeliefResult = {
@@ -314,6 +315,19 @@ type LucernGraphMethods = {
             userId: string;
         }>;
     }>;
+    getOpinionHistory(client: LucernClient, nodeId: string): Promise<Array<{
+        t: number;
+        b: number;
+        d: number;
+        u: number;
+        a: number;
+        P: number;
+        trigger: string;
+        triggeringRef?: {
+            kind: "evidence" | "worktree";
+            id: string;
+        };
+    }>>;
     getAuditTrail(client: LucernClient, nodeId: string, limit?: number): Promise<{
         entries: Array<{
             action: string;

package/dist/sdk-tools.contract.js

@@ -10,13 +10,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."
@@ -26,7 +30,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: {
@@ -89,17 +93,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"
       ]
@@ -109,7 +139,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: {
@@ -751,7 +781,7 @@ var RECORD_JUDGMENT = {
       status: "string \u2014 'issued'"
     }
   },
-  ownerModule: "decision-state",
+  ownerModule: "decisions",
   ontologyPrimitive: "judgment",
   tier: "showcase"
 };
@@ -2020,7 +2050,7 @@ var INGEST_OBSERVATION = {
       contextResourceUri: "string"
     }
   },
-  ownerModule: "agent-harness",
+  ownerModule: "agent-frameworks",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2050,7 +2080,7 @@ var GET_OBSERVATION_CONTEXT = {
       generatedAt: "number"
     }
   },
-  ownerModule: "agent-harness",
+  ownerModule: "agent-frameworks",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -3548,7 +3578,7 @@ var CREATE_BELIEF_CONDITIONAL = {
       targetBeliefId: "string"
     }
   },
-  ownerModule: "graph-primitives",
+  ownerModule: "edges",
   ontologyPrimitive: "edge",
   tier: "sdk-only"
 };