@lucern/sdk 1.0.11 → 1.0.13

package/dist/beliefs/lifecycle.d.ts

@@ -1,24 +1,23 @@
-type BeliefLifecycleStatus = "assumption" | "hypothesis" | "belief" | "fact";
-declare function isBeliefLifecycleStatus(value: unknown): value is BeliefLifecycleStatus;
-declare function isResolvedByConfidence(confidence: unknown): boolean;
-declare function hasResolvedPredictionOutcome(predictionMeta: unknown): boolean;
-declare function shouldTreatBeliefAsFact(opts: {
+export type BeliefLifecycleStatus = "assumption" | "hypothesis" | "belief" | "fact";
+export declare function isBeliefLifecycleStatus(value: unknown): value is BeliefLifecycleStatus;
+export declare function isResolvedByConfidence(confidence: unknown): boolean;
+export declare function hasResolvedPredictionOutcome(predictionMeta: unknown): boolean;
+export declare function shouldTreatBeliefAsFact(opts: {
     confidence?: unknown;
     predictionMeta?: unknown;
     metadata?: Record<string, unknown>;
 }): boolean;
-declare function resolveBeliefLifecycleStatus(opts: {
+export declare function resolveBeliefLifecycleStatus(opts: {
     beliefStatus?: unknown;
     confidence?: unknown;
     predictionMeta?: unknown;
     metadata?: Record<string, unknown>;
 }): BeliefLifecycleStatus;
-declare function isPreValidationBeliefStatus(status: BeliefLifecycleStatus): boolean;
-declare function isPropagationEligibleBeliefStatus(status: BeliefLifecycleStatus): boolean;
-declare function promoteBeliefStatusAfterScoring(status: BeliefLifecycleStatus, opts?: {
+export declare function isPreValidationBeliefStatus(status: BeliefLifecycleStatus): boolean;
+export declare function isPropagationEligibleBeliefStatus(status: BeliefLifecycleStatus): boolean;
+export declare function promoteBeliefStatusAfterScoring(status: BeliefLifecycleStatus, opts?: {
     confidence?: unknown;
     predictionMeta?: unknown;
     metadata?: Record<string, unknown>;
 }): BeliefLifecycleStatus;
-
-export { type BeliefLifecycleStatus, hasResolvedPredictionOutcome, isBeliefLifecycleStatus, isPreValidationBeliefStatus, isPropagationEligibleBeliefStatus, isResolvedByConfidence, promoteBeliefStatusAfterScoring, resolveBeliefLifecycleStatus, shouldTreatBeliefAsFact };
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/beliefs/lifecycle.js

@@ -1,98 +1,96 @@
-// src/beliefs/lifecycle.ts
-var BELIEF_STATUS_VALUES = [
-  "assumption",
-  "hypothesis",
-  "belief",
-  "fact"
+const BELIEF_STATUS_VALUES = [
+    "assumption",
+    "hypothesis",
+    "belief",
+    "fact",
 ];
-var RESOLVED_PREDICTION_OUTCOMES = [
-  "confirmed",
-  "disconfirmed",
-  "partial",
-  "expired"
+const RESOLVED_PREDICTION_OUTCOMES = [
+    "confirmed",
+    "disconfirmed",
+    "partial",
+    "expired",
 ];
-function isBeliefLifecycleStatus(value) {
-  return typeof value === "string" && BELIEF_STATUS_VALUES.includes(value);
+export function isBeliefLifecycleStatus(value) {
+    return (typeof value === "string" &&
+        BELIEF_STATUS_VALUES.includes(value));
 }
 function normalizeBeliefConfidence(confidence) {
-  if (typeof confidence !== "number" || !Number.isFinite(confidence)) {
+    if (typeof confidence !== "number" || !Number.isFinite(confidence)) {
+        return null;
+    }
+    if (confidence >= 0 && confidence <= 1) {
+        return confidence;
+    }
+    if (confidence > 1 && confidence <= 100) {
+        return confidence / 100;
+    }
     return null;
-  }
-  if (confidence >= 0 && confidence <= 1) {
-    return confidence;
-  }
-  if (confidence > 1 && confidence <= 100) {
-    return confidence / 100;
-  }
-  return null;
 }
-function isResolvedByConfidence(confidence) {
-  const normalized = normalizeBeliefConfidence(confidence);
-  if (normalized === null) {
-    return false;
-  }
-  return normalized <= 0 || normalized >= 1;
+export function isResolvedByConfidence(confidence) {
+    const normalized = normalizeBeliefConfidence(confidence);
+    if (normalized === null) {
+        return false;
+    }
+    return normalized <= 0 || normalized >= 1;
 }
-function hasResolvedPredictionOutcome(predictionMeta) {
-  if (!predictionMeta || typeof predictionMeta !== "object") {
-    return false;
-  }
-  const outcome = predictionMeta.outcome;
-  return typeof outcome === "string" && RESOLVED_PREDICTION_OUTCOMES.includes(outcome);
+export function hasResolvedPredictionOutcome(predictionMeta) {
+    if (!predictionMeta || typeof predictionMeta !== "object") {
+        return false;
+    }
+    const outcome = predictionMeta.outcome;
+    return (typeof outcome === "string" &&
+        RESOLVED_PREDICTION_OUTCOMES.includes(outcome));
 }
 function getPredictionMetaFromMetadata(metadata) {
-  return metadata?.predictionMeta;
+    return metadata?.predictionMeta;
 }
-function shouldTreatBeliefAsFact(opts) {
-  if (isResolvedByConfidence(opts.confidence)) {
-    return true;
-  }
-  if (hasResolvedPredictionOutcome(opts.predictionMeta)) {
-    return true;
-  }
-  if (hasResolvedPredictionOutcome(getPredictionMetaFromMetadata(opts.metadata))) {
-    return true;
-  }
-  return false;
+export function shouldTreatBeliefAsFact(opts) {
+    if (isResolvedByConfidence(opts.confidence)) {
+        return true;
+    }
+    if (hasResolvedPredictionOutcome(opts.predictionMeta)) {
+        return true;
+    }
+    if (hasResolvedPredictionOutcome(getPredictionMetaFromMetadata(opts.metadata))) {
+        return true;
+    }
+    return false;
 }
-function resolveBeliefLifecycleStatus(opts) {
-  if (shouldTreatBeliefAsFact(opts)) {
-    return "fact";
-  }
-  const direct = opts.beliefStatus;
-  if (isBeliefLifecycleStatus(direct)) {
-    const normalized = normalizeBeliefConfidence(opts.confidence);
-    if (normalized !== null && isPreValidationBeliefStatus(direct)) {
-      return "belief";
+export function resolveBeliefLifecycleStatus(opts) {
+    if (shouldTreatBeliefAsFact(opts)) {
+        return "fact";
     }
-    return direct;
-  }
-  const metaStatus = opts.metadata?.beliefStatus;
-  if (isBeliefLifecycleStatus(metaStatus)) {
-    const normalized = normalizeBeliefConfidence(opts.confidence);
-    if (normalized !== null && isPreValidationBeliefStatus(metaStatus)) {
-      return "belief";
+    const direct = opts.beliefStatus;
+    if (isBeliefLifecycleStatus(direct)) {
+        const normalized = normalizeBeliefConfidence(opts.confidence);
+        if (normalized !== null && isPreValidationBeliefStatus(direct)) {
+            return "belief";
+        }
+        return direct;
     }
-    return metaStatus;
-  }
-  return "assumption";
+    const metaStatus = opts.metadata?.beliefStatus;
+    if (isBeliefLifecycleStatus(metaStatus)) {
+        const normalized = normalizeBeliefConfidence(opts.confidence);
+        if (normalized !== null && isPreValidationBeliefStatus(metaStatus)) {
+            return "belief";
+        }
+        return metaStatus;
+    }
+    return "assumption";
 }
-function isPreValidationBeliefStatus(status) {
-  return status === "assumption" || status === "hypothesis";
+export function isPreValidationBeliefStatus(status) {
+    return status === "assumption" || status === "hypothesis";
 }
-function isPropagationEligibleBeliefStatus(status) {
-  return status === "belief" || status === "fact";
+export function isPropagationEligibleBeliefStatus(status) {
+    return status === "belief" || status === "fact";
 }
-function promoteBeliefStatusAfterScoring(status, opts) {
-  if (shouldTreatBeliefAsFact({ ...opts })) {
-    return "fact";
-  }
-  if (isPreValidationBeliefStatus(status)) {
-    return "belief";
-  }
-  return status === "fact" ? "fact" : "belief";
+export function promoteBeliefStatusAfterScoring(status, opts) {
+    if (shouldTreatBeliefAsFact({ ...opts })) {
+        return "fact";
+    }
+    if (isPreValidationBeliefStatus(status)) {
+        return "belief";
+    }
+    return status === "fact" ? "fact" : "belief";
 }
-
-export { hasResolvedPredictionOutcome, isBeliefLifecycleStatus, isPreValidationBeliefStatus, isPropagationEligibleBeliefStatus, isResolvedByConfidence, promoteBeliefStatusAfterScoring, resolveBeliefLifecycleStatus, shouldTreatBeliefAsFact };
-//# sourceMappingURL=lifecycle.js.map
 //# sourceMappingURL=lifecycle.js.map

package/dist/beliefsClient.d.ts

@@ -1,18 +1,13 @@
-import { JsonObject, PlatformBeliefRecord, ModulateConfidenceResponse, ForkBeliefResponse } from './types.js';
-export { CreateBeliefResponse } from './types.js';
-import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
-export { LucernApiError } from './coreClient.js';
-import { Opinion } from './opinion.js';
-import './contracts/workflow-runtime.contract.js';
-import './contracts/lens-workflow.contract.js';
-import './contracts/lens-filter.contract.js';
-import '@lucern/transport-core';
-import './authContext.js';
-import './contracts/auth-session.contract.js';
-
+import { type GatewayClientConfig, LucernApiError, type PlatformGatewaySuccess } from "./coreClient";
+import { type Opinion } from "./opinion";
+import type { ForkBeliefResponse, JsonObject, ModulateConfidenceResponse } from "./types";
+export { LucernApiError };
+export type { PlatformGatewaySuccess } from "./coreClient";
+export type { CreateBeliefResponse, ForkBeliefResponse, ModulateConfidenceResponse, } from "./types";
+export type { Opinion } from "./opinion";
 /** Configuration for the beliefs client. Inherits gateway transport settings. */
-type BeliefsClientConfig = GatewayClientConfig;
-type OpinionHistoryEntry = {
+export type BeliefsClientConfig = GatewayClientConfig;
+export type OpinionHistoryEntry = {
     t: number;
     b: number;
     d: number;
@@ -29,7 +24,7 @@ type OpinionHistoryEntry = {
     slOperator?: string;
 };
 type GatewayRecord = Record<string, unknown>;
-declare function mapOpinionHistoryEntriesFromGatewayData(payload: GatewayRecord): OpinionHistoryEntry[];
+export declare function mapOpinionHistoryEntriesFromGatewayData(payload: GatewayRecord): OpinionHistoryEntry[];
 /**
  * Input for creating a new belief within a topic scope.
  *
@@ -38,7 +33,7 @@ declare function mapOpinionHistoryEntriesFromGatewayData(payload: GatewayRecord)
  * Beliefs start as drafts with a vacuous prior `(0, 0, 1, a)`. When omitted,
  * `baseRate` defaults to the canonical neutral prior `0.5`.
  */
-type CreateBeliefInput = {
+export type CreateBeliefInput = {
     topicId?: string;
     /** Preferred belief statement alias. */
     text?: string;
@@ -64,7 +59,7 @@ type CreateBeliefInput = {
  * Use `text` as the canonical belief statement.
  * `canonicalText` remains available as a legacy alias for backwards compatibility.
  */
-type RefineBeliefInput = {
+export type RefineBeliefInput = {
     /** Preferred belief statement alias. */
     text?: string;
     /** @deprecated Use text. */
@@ -84,24 +79,25 @@ type ModulateConfidenceInputBase = {
     maxInlinePropagationTargets?: number;
 };
 /**
- * Record an append-only confidence change using an explicit subjective-logic
- * opinion tuple.
+ * @deprecated Public callers should not submit confidence tuples directly.
+ * Attach supporting or contradicting evidence and let the kernel derive the
+ * next subjective-logic opinion.
  */
-type ModulateConfidenceOpinionInput = ModulateConfidenceInputBase & {
+export type ModulateConfidenceOpinionInput = ModulateConfidenceInputBase & {
     opinion: Opinion;
 };
-type ModulateConfidenceInput = ModulateConfidenceOpinionInput;
+export type ModulateConfidenceInput = ModulateConfidenceOpinionInput;
 /**
  * Input for forking a scored belief into a new formulation.
  * Scored beliefs are immutable — fork to evolve understanding.
  */
-type ForkBeliefInput = {
+export type ForkBeliefInput = {
     newFormulation: string;
     forkReason?: "refinement" | "contradiction_response" | "scope_change" | "confidence_collapse" | "manual";
     rationale?: string;
 };
 /** Input for changing a belief's lifecycle status. */
-type UpdateBeliefStatusInput = {
+export type UpdateBeliefStatusInput = {
     id?: string;
     nodeId?: string;
     beliefId?: string;
@@ -109,14 +105,14 @@ type UpdateBeliefStatusInput = {
     reason?: string;
 };
 /** Input for updating a belief's rationale without refining its text. */
-type UpdateBeliefRationaleInput = {
+export type UpdateBeliefRationaleInput = {
     id?: string;
     nodeId?: string;
     beliefId?: string;
     rationale?: string;
 };
 /** Input for creating a belief-to-belief reasoning edge. */
-type LinkBeliefsInput = {
+export type LinkBeliefsInput = {
     fromNodeId: string;
     toNodeId: string;
     edgeType: string;
@@ -124,7 +120,7 @@ type LinkBeliefsInput = {
     context?: string;
 };
 /** Input for unlinking a belief from an attached evidence item. */
-type UnlinkBeliefEvidenceInput = {
+export type UnlinkBeliefEvidenceInput = {
     beliefNodeId?: string;
     beliefId?: string;
     nodeId?: string;
@@ -132,14 +128,14 @@ type UnlinkBeliefEvidenceInput = {
     evidenceId?: string;
 };
 /** Input for updating a belief's criticality classification. */
-type UpdateBeliefCriticalityInput = {
+export type UpdateBeliefCriticalityInput = {
     id?: string;
     nodeId?: string;
     beliefId?: string;
     criticality: "blocking" | "important" | "supporting" | "essential" | "nice_to_have";
 };
 /** Input for bulk-updating multiple beliefs' criticality. */
-type BatchUpdateBeliefCriticalityInput = {
+export type BatchUpdateBeliefCriticalityInput = {
     updates: Array<{
         beliefId: string;
         criticality: "blocking" | "important" | "supporting" | "essential" | "nice_to_have";
@@ -151,7 +147,7 @@ type BatchUpdateBeliefCriticalityInput = {
     }>;
 };
 /** Input for moving beliefs into a different topic scope. */
-type ReassignBeliefsTopicInput = {
+export type ReassignBeliefsTopicInput = {
     beliefNodeIds?: string[];
     beliefIds?: string[];
     targetTopicId: string;
@@ -161,17 +157,17 @@ type ReassignBeliefsTopicInput = {
  * Create the beliefs client for belief lifecycle operations.
  *
  * @param config - Gateway transport configuration.
- * @returns An object with `createBelief`, `refineBelief`, `modulateConfidence`, and `forkBelief` methods.
+ * @returns An object with belief lifecycle methods. Confidence is updated by evidence writes.
  */
-declare function createBeliefsClient(config?: BeliefsClientConfig): {
+export declare function createBeliefsClient(config?: BeliefsClientConfig): {
     /**
      * Create a belief within a topic scope.
      */
-    createBelief(input: CreateBeliefInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<PlatformBeliefRecord>>;
+    createBelief(input: CreateBeliefInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<import("./types").PlatformBeliefRecord>>;
     /**
      * Refine a draft belief in place.
      */
-    refineBelief(beliefId: string, input: RefineBeliefInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<PlatformBeliefRecord>>;
+    refineBelief(beliefId: string, input: RefineBeliefInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<import("./types").PlatformBeliefRecord>>;
     /**
      * Record a confidence change for an existing belief.
      */
@@ -225,5 +221,4 @@ declare function createBeliefsClient(config?: BeliefsClientConfig): {
      */
     reassignBeliefsTopic(input: ReassignBeliefsTopicInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<Record<string, unknown>>>;
 };
-
-export { type BatchUpdateBeliefCriticalityInput, type BeliefsClientConfig, type CreateBeliefInput, type ForkBeliefInput, ForkBeliefResponse, type LinkBeliefsInput, type ModulateConfidenceInput, type ModulateConfidenceOpinionInput, ModulateConfidenceResponse, Opinion, type OpinionHistoryEntry, PlatformGatewaySuccess, type ReassignBeliefsTopicInput, type RefineBeliefInput, type UnlinkBeliefEvidenceInput, type UpdateBeliefCriticalityInput, type UpdateBeliefRationaleInput, type UpdateBeliefStatusInput, createBeliefsClient, mapOpinionHistoryEntriesFromGatewayData };
+//# sourceMappingURL=beliefsClient.d.ts.map