@lucern/contracts 0.1.1-alpha.1 → 0.1.2-alpha.2

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",
@@ -580,13 +594,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 +614,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 +677,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 +723,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 +1365,7 @@ var RECORD_JUDGMENT = {
       status: "string \u2014 'issued'"
     }
   },
-  ownerModule: "decision-state",
+  ownerModule: "decisions",
   ontologyPrimitive: "judgment",
   tier: "showcase"
 };
@@ -2590,7 +2634,7 @@ var INGEST_OBSERVATION = {
       contextResourceUri: "string"
     }
   },
-  ownerModule: "agent-harness",
+  ownerModule: "agent-frameworks",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2620,7 +2664,7 @@ var GET_OBSERVATION_CONTEXT = {
       generatedAt: "number"
     }
   },
-  ownerModule: "agent-harness",
+  ownerModule: "agent-frameworks",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -4559,7 +4603,7 @@ var CREATE_BELIEF_CONDITIONAL = {
       targetBeliefId: "string"
     }
   },
-  ownerModule: "graph-primitives",
+  ownerModule: "edges",
   ontologyPrimitive: "edge",
   tier: "sdk-only"
 };
@@ -5520,108 +5564,7 @@ var CANONICAL_WORKFLOW_DEFINITIONS = [
     integrityChecks: ["sparse_shaping"]
   }
 ];
-export {
-  BELIEF_STATUSES,
-  BELIEF_TYPE_BONUS,
-  BRANCH_STATUSES,
-  CANONICAL_WORKFLOW_DEFINITIONS,
-  CONFIDENCE_TRIGGERS,
-  CONTEXT_PACK_SCHEMA_VERSION,
-  CONTEXT_PACK_SECTION_KEYS,
-  CONTEXT_RANKING_PROFILES,
-  CONTRADICTION_SEVERITIES,
-  CONTRADICTION_STATUSES,
-  DEFAULT_BELIEF_TYPE_BONUS,
-  DEFAULT_COMPILATION_MODE,
-  DEFAULT_ENTITY_LIMIT,
-  DEFAULT_PRIORITY_SCORE,
-  DEFAULT_RANKING_PROFILE,
-  DEFAULT_SECTION_LIMIT,
-  DEFAULT_SEVERITY_SCORE,
-  DEFAULT_TIER_APPROVAL_MODE,
-  DEFAULT_TOKEN_BUDGET,
-  DEFAULT_WORKFLOW_AUTO_FIX_POLICY,
-  DEFEAT_TYPES,
-  DOMAIN_EVENT_TYPES,
-  DOMAIN_EVENT_VERSION,
-  ENTITY_RANKING_WEIGHTS,
-  EPISTEMIC_LAYERS,
-  EVENT_RETENTION_DEFAULT_DAYS,
-  FORK_REASONS,
-  INTEGRATION_EDGE_TYPES,
-  JUDGMENT_TYPES,
-  MAX_ENTITY_LIMIT,
-  MAX_SECTION_LIMIT,
-  MAX_TOKEN_BUDGET,
-  MERGE_OUTCOMES,
-  MIN_CONTRADICTION_BUDGET,
-  MIN_TOKEN_BUDGET,
-  MIN_TOKEN_ESTIMATE,
-  MORNING_BRIEF_WORKFLOW_ID,
-  NIGHTLY_RECONCILIATION_WORKFLOW_ID,
-  PRIORITY_SCORES,
-  PULL_REQUEST_STATUSES,
-  RANKING_WEIGHTS,
-  REASONING_METHODS,
-  RECENCY_HALF_LIFE_DAYS,
-  RESOLVED_QUESTION_STATUSES,
-  ROOT_TOPIC_ID,
-  SECTION_BUDGET_RATIOS,
-  SESSION_AUTH_MODES,
-  SESSION_LIFECYCLE_STATUSES,
-  SESSION_PRINCIPAL_TYPES,
-  SEVERITY_SCORES,
-  TOKENS_PER_WORD,
-  WEBHOOK_MAX_ATTEMPTS,
-  WEBHOOK_RETRY_DELAYS_MS,
-  WORKFLOW_ACTION_KINDS,
-  WORKFLOW_APPROVAL_MODES,
-  WORKFLOW_AUTO_FIX_MODES,
-  WORKFLOW_HOOK_EVENTS,
-  WORKFLOW_INTEGRITY_CHECKS,
-  WORKFLOW_MUTATION_TIERS,
-  WORKFLOW_OUTPUT_KINDS,
-  WORKFLOW_PROOF_ARTIFACT_KINDS,
-  WORKFLOW_RUNTIME_SCHEMA_VERSION,
-  WORKFLOW_RUN_STATUSES,
-  WORKFLOW_STAFFING_HINTS,
-  WORKFLOW_TRIGGER_KINDS,
-  WORKTREE_PHASES,
-  bigramTokenize,
-  buildDomainEvent,
-  collectTopicNeighborhood,
-  compareEventCursor,
-  createEventId,
-  decodeEventCursor,
-  decodePrefixedId,
-  emitDomainEvent,
-  encodeEventCursor,
-  encodePrefixedId,
-  hasPrefixedIdPrefix,
-  inferActorType,
-  inferSessionPrincipalType,
-  isAfterCursor,
-  isLucernPrompt,
-  jaccardSimilarity,
-  lastDelegator,
-  mcp_tools_contract_exports as mcpToolsContract,
-  normalizeDelegationChain,
-  normalizeRetentionDays,
-  prepareLexicalQuery,
-  rankEntityConnections,
-  rankEntityTypeMatches,
-  rankWindowScore,
-  requireActorPrincipalId,
-  rerankLexicalWindow,
-  scoreEntityConnection,
-  scoreEntityTypeMatch,
-  scoreLexicalSignal,
-  scoreLexicalSignals,
-  sdk_tools_contract_exports as sdkToolsContract,
-  sortEventsByCursor,
-  stemToken,
-  tokenOverlapScore,
-  tokenizeSearchText,
-  wordOverlapScore,
-  wordTokenize
-};
+
+export { BELIEF_STATUSES, BELIEF_TYPE_BONUS, BRANCH_STATUSES, CANONICAL_WORKFLOW_DEFINITIONS, CONFIDENCE_TRIGGERS, CONTEXT_PACK_SCHEMA_VERSION, CONTEXT_PACK_SECTION_KEYS, CONTEXT_RANKING_PROFILES, CONTRADICTION_SEVERITIES, CONTRADICTION_STATUSES, DEFAULT_BELIEF_TYPE_BONUS, DEFAULT_COMPILATION_MODE, DEFAULT_ENTITY_LIMIT, DEFAULT_PRIORITY_SCORE, DEFAULT_RANKING_PROFILE, DEFAULT_SECTION_LIMIT, DEFAULT_SEVERITY_SCORE, DEFAULT_TIER_APPROVAL_MODE, DEFAULT_TOKEN_BUDGET, DEFAULT_WORKFLOW_AUTO_FIX_POLICY, DEFEAT_TYPES, DOMAIN_EVENT_TYPES, DOMAIN_EVENT_VERSION, ENTITY_RANKING_WEIGHTS, EPISTEMIC_LAYERS, EVENT_RETENTION_DEFAULT_DAYS, FORK_REASONS, INTEGRATION_EDGE_TYPES, JUDGMENT_TYPES, MAX_ENTITY_LIMIT, MAX_SECTION_LIMIT, MAX_TOKEN_BUDGET, MERGE_OUTCOMES, MIN_CONTRADICTION_BUDGET, MIN_TOKEN_BUDGET, MIN_TOKEN_ESTIMATE, MORNING_BRIEF_WORKFLOW_ID, NIGHTLY_RECONCILIATION_WORKFLOW_ID, PRIORITY_SCORES, PULL_REQUEST_STATUSES, RANKING_WEIGHTS, REASONING_METHODS, RECENCY_HALF_LIFE_DAYS, RESOLVED_QUESTION_STATUSES, ROOT_TOPIC_ID, SECTION_BUDGET_RATIOS, SESSION_AUTH_MODES, SESSION_LIFECYCLE_STATUSES, SESSION_PRINCIPAL_TYPES, SEVERITY_SCORES, TOKENS_PER_WORD, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_RETRY_DELAYS_MS, WORKFLOW_ACTION_KINDS, WORKFLOW_APPROVAL_MODES, WORKFLOW_AUTO_FIX_MODES, WORKFLOW_HOOK_EVENTS, WORKFLOW_INTEGRITY_CHECKS, WORKFLOW_MUTATION_TIERS, WORKFLOW_OUTPUT_KINDS, WORKFLOW_PROOF_ARTIFACT_KINDS, WORKFLOW_RUNTIME_SCHEMA_VERSION, WORKFLOW_RUN_STATUSES, WORKFLOW_STAFFING_HINTS, WORKFLOW_TRIGGER_KINDS, WORKTREE_PHASES, bigramTokenize, buildDomainEvent, collectTopicNeighborhood, compareEventCursor, createEventId, decodeEventCursor, decodePrefixedId, emitDomainEvent, encodeEventCursor, encodePrefixedId, hasPrefixedIdPrefix, inferActorType, inferSessionPrincipalType, isAfterCursor, isLucernPrompt, jaccardSimilarity, lastDelegator, mcp_tools_contract_exports as mcpToolsContract, normalizeDelegationChain, normalizeRetentionDays, prepareLexicalQuery, rankEntityConnections, rankEntityTypeMatches, rankWindowScore, requireActorPrincipalId, rerankLexicalWindow, scoreEntityConnection, scoreEntityTypeMatch, scoreLexicalSignal, scoreLexicalSignals, sdk_tools_contract_exports as sdkToolsContract, sortEventsByCursor, stemToken, tokenOverlapScore, tokenizeSearchText, wordOverlapScore, wordTokenize };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map