@lucern/sdk 1.0.11 → 1.0.12

package/dist/contracts/api-enums.contract.js

@@ -1,103 +1,177 @@
-// src/contracts/api-enums.contract.ts
-var BELIEF_STATUSES = [
-  "assumption",
-  "hypothesis",
-  "belief",
-  "fact"
+/**
+ * API Enum Contract Definitions
+ *
+ * Canonical enum values for all API-facing enumerations.
+ * These MUST match the kernel schema validators exactly.
+ *
+ * Source of truth: packages/contracts/src/schemas/tables/kernel/spine.ts
+ */
+// =============================================================================
+// BELIEF STATUS
+// =============================================================================
+/**
+ * Belief epistemic lifecycle — tracks maturity from raw claim to verified fact.
+ *
+ * - assumption: Untested raw claim, lowest epistemic standing
+ * - hypothesis: Under active investigation, being tested against evidence
+ * - belief: Validated through investigation, carries confidence score
+ * - fact: Resolved outcome anchored by strong evidence
+ */
+export const BELIEF_STATUSES = [
+    "assumption",
+    "hypothesis",
+    "belief",
+    "fact",
 ];
-var FORK_REASONS = [
-  "refinement",
-  "contradiction_response",
-  "scope_change",
-  "confidence_collapse",
-  "manual"
+// =============================================================================
+// FORK REASONS
+// =============================================================================
+/** Why a scored belief was branched into a new version */
+export const FORK_REASONS = [
+    "refinement",
+    "contradiction_response",
+    "scope_change",
+    "confidence_collapse",
+    "manual",
 ];
-var CONFIDENCE_TRIGGERS = [
-  "evidence_added",
-  "evidence_removed",
-  "contradiction_detected",
-  "contradiction_resolved",
-  "agent_assessment",
-  "worktree_outcome",
-  "worktree_completed",
-  "manual",
-  "decay",
-  "fusion",
-  "discount",
-  "deduction"
+// =============================================================================
+// CONFIDENCE TRIGGERS
+// =============================================================================
+/** What caused a confidence change — every modulation must declare its trigger */
+export const CONFIDENCE_TRIGGERS = [
+    "evidence_added",
+    "evidence_removed",
+    "contradiction_detected",
+    "contradiction_resolved",
+    "agent_assessment",
+    "worktree_outcome",
+    "worktree_completed",
+    "manual",
+    "decay",
+    "fusion",
+    "discount",
+    "deduction",
 ];
-var EPISTEMIC_EDGE_TYPES = [
-  "supports",
-  "informs",
-  "depends_on",
-  "derived_from",
-  "contains",
-  "tests"
+// =============================================================================
+// EDGE TYPES — The 6 canonical epistemic edge types
+// =============================================================================
+/**
+ * Core epistemic edge types — the grammar of reasoning relationships.
+ *
+ * - supports: Evidence or belief reinforces another belief (weight = strength)
+ * - informs: Evidence bears on a belief (directional, weighted)
+ * - depends_on: Belief B requires belief A to hold
+ * - derived_from: Belief was derived from another (lineage)
+ * - contains: Structural containment (topic contains beliefs)
+ * - tests: Question tests a belief (falsification link)
+ */
+export const EPISTEMIC_EDGE_TYPES = [
+    "supports",
+    "informs",
+    "depends_on",
+    "derived_from",
+    "contains",
+    "tests",
 ];
-var STRUCTURAL_EDGE_TYPES = [
-  "supersedes",
-  "responds_to",
-  "belongs_to",
-  "relates_to_thesis"
+/** Structural and lifecycle edges — required for graph integrity */
+export const STRUCTURAL_EDGE_TYPES = [
+    "supersedes",
+    "responds_to",
+    "belongs_to",
+    "relates_to_thesis",
 ];
-var EDGE_TYPES = [
-  ...EPISTEMIC_EDGE_TYPES,
-  ...STRUCTURAL_EDGE_TYPES
+/** All valid edge types (epistemic + structural) */
+export const EDGE_TYPES = [
+    ...EPISTEMIC_EDGE_TYPES,
+    ...STRUCTURAL_EDGE_TYPES,
 ];
-var REASONING_METHODS = [
-  "deductive",
-  "inductive",
-  "abductive",
-  "analogical",
-  "causal",
-  "correlational",
-  "testimonial",
-  "statistical",
-  "implicit",
-  "pattern_match"
+// =============================================================================
+// REASONING METHODS
+// =============================================================================
+/** How an edge relationship was determined */
+export const REASONING_METHODS = [
+    "deductive",
+    "inductive",
+    "abductive",
+    "analogical",
+    "causal",
+    "correlational",
+    "testimonial",
+    "statistical",
+    "implicit",
+    "pattern_match",
 ];
-var DEFEAT_TYPES = [
-  "rebuts",
-  "undercuts",
-  "undermines"
+// =============================================================================
+// CONTRADICTION ENUMS
+// =============================================================================
+/** Defeat types (Pollock taxonomy) — how a contradiction operates */
+export const DEFEAT_TYPES = [
+    "rebuts",
+    "undercuts",
+    "undermines",
 ];
-var CONTRADICTION_SEVERITIES = [
-  "low",
-  "medium",
-  "high",
-  "critical"
+/** Contradiction severity */
+export const CONTRADICTION_SEVERITIES = [
+    "low",
+    "medium",
+    "high",
+    "critical",
 ];
-var CONTRADICTION_STATUSES = [
-  "unresolved",
-  "resolved",
-  "accepted"
+/** Contradiction resolution status */
+export const CONTRADICTION_STATUSES = [
+    "unresolved",
+    "resolved",
+    "accepted",
 ];
-var MERGE_OUTCOMES = [
-  "validated",
-  "invalidated",
-  "forked",
-  "inconclusive"
+// =============================================================================
+// WORKTREE ENUMS
+// =============================================================================
+/** How a worktree investigation concluded */
+export const MERGE_OUTCOMES = [
+    "validated",
+    "invalidated",
+    "forked",
+    "inconclusive",
 ];
-var WORKTREE_PHASES = [
-  "hypothesis",
-  "investigation",
-  "evaluation",
-  "resolution"
+/** Investigation phases within a worktree */
+export const WORKTREE_PHASES = [
+    "hypothesis",
+    "investigation",
+    "evaluation",
+    "resolution",
 ];
-var EPISTEMIC_LAYERS = [
-  "L1",
-  "L2",
-  "L3",
-  "L4"
+// =============================================================================
+// EPISTEMIC LAYERS
+// =============================================================================
+/**
+ * The knowledge hierarchy — each layer builds on the one below it.
+ *
+ * - L1: Sources — raw inputs (documents, APIs, observations)
+ * - L2: Evidence — interpreted facts with context and weight
+ * - L3: Beliefs — structural claims that carry confidence
+ * - L4: Judgments — irreversible commitments based on the epistemic state
+ */
+export const EPISTEMIC_LAYERS = [
+    "L1",
+    "L2",
+    "L3",
+    "L4",
 ];
-var JUDGMENT_TYPES = [
-  "thesis",
-  "thesis_maturity",
-  "contradiction_ruling",
-  "scope_determination",
-  "confidence_ruling"
+// =============================================================================
+// JUDGMENT TYPES
+// =============================================================================
+/**
+ * Classification of L4 judgments — irreversible determinations.
+ *
+ * Judgments are evaluated against the knowledge horizon that existed
+ * when they were made. They cannot be retroactively invalidated —
+ * only new judgments can supersede old ones.
+ */
+export const JUDGMENT_TYPES = [
+    "thesis",
+    "thesis_maturity",
+    "contradiction_ruling",
+    "scope_determination",
+    "confidence_ruling",
 ];
-
-export { BELIEF_STATUSES, CONFIDENCE_TRIGGERS, CONTRADICTION_SEVERITIES, CONTRADICTION_STATUSES, DEFEAT_TYPES, EDGE_TYPES, EPISTEMIC_EDGE_TYPES, EPISTEMIC_LAYERS, FORK_REASONS, JUDGMENT_TYPES, MERGE_OUTCOMES, REASONING_METHODS, STRUCTURAL_EDGE_TYPES, WORKTREE_PHASES };
-//# sourceMappingURL=api-enums.contract.js.map
 //# sourceMappingURL=api-enums.contract.js.map

package/dist/contracts/auth-session.contract.d.ts

@@ -4,13 +4,13 @@
  * Canonical session lifecycle vocabulary shared by platform gateway auth,
  * hosted MCP auth, Master Control persistence, and SDK session tokens.
  */
-declare const SESSION_AUTH_MODES: readonly ["interactive_user", "service_principal", "tenant_api_key", "session_token"];
-type SessionAuthMode = (typeof SESSION_AUTH_MODES)[number];
-declare const SESSION_PRINCIPAL_TYPES: readonly ["human", "service", "agent", "group", "external_viewer"];
-type SessionPrincipalType = (typeof SESSION_PRINCIPAL_TYPES)[number];
-declare const SESSION_LIFECYCLE_STATUSES: readonly ["active", "expired", "revoked"];
-type SessionLifecycleStatus = (typeof SESSION_LIFECYCLE_STATUSES)[number];
-type SessionDelegationHop = {
+export declare const SESSION_AUTH_MODES: readonly ["interactive_user", "service_principal", "tenant_api_key", "session_token"];
+export type SessionAuthMode = (typeof SESSION_AUTH_MODES)[number];
+export declare const SESSION_PRINCIPAL_TYPES: readonly ["human", "service", "agent", "group", "external_viewer"];
+export type SessionPrincipalType = (typeof SESSION_PRINCIPAL_TYPES)[number];
+export declare const SESSION_LIFECYCLE_STATUSES: readonly ["active", "expired", "revoked"];
+export type SessionLifecycleStatus = (typeof SESSION_LIFECYCLE_STATUSES)[number];
+export type SessionDelegationHop = {
     principalId: string;
     principalType: SessionPrincipalType;
     authMode?: SessionAuthMode;
@@ -18,8 +18,8 @@ type SessionDelegationHop = {
     delegatedAt?: number;
     reason?: string;
 };
-type SessionAuditOutcome = "accepted" | "rejected" | "revoked" | "expired";
-type SessionAuditEnvelope = {
+export type SessionAuditOutcome = "accepted" | "rejected" | "revoked" | "expired";
+export type SessionAuditEnvelope = {
     sessionId: string;
     authMode: SessionAuthMode;
     principalId: string;
@@ -42,14 +42,13 @@ type SessionAuditEnvelope = {
         reason?: string;
     };
 };
-declare function inferSessionPrincipalType(principalId: string): SessionPrincipalType;
-declare function normalizeDelegationChain(args: {
+export declare function inferSessionPrincipalType(principalId: string): SessionPrincipalType;
+export declare function normalizeDelegationChain(args: {
     delegationChain?: readonly SessionDelegationHop[];
     delegatedBy?: string;
     delegatedByType?: SessionPrincipalType;
     delegatedAt?: number;
     reason?: string;
 }): SessionDelegationHop[] | undefined;
-declare function lastDelegator(delegationChain?: readonly SessionDelegationHop[]): string | undefined;
-
-export { SESSION_AUTH_MODES, SESSION_LIFECYCLE_STATUSES, SESSION_PRINCIPAL_TYPES, type SessionAuditEnvelope, type SessionAuditOutcome, type SessionAuthMode, type SessionDelegationHop, type SessionLifecycleStatus, type SessionPrincipalType, inferSessionPrincipalType, lastDelegator, normalizeDelegationChain };
+export declare function lastDelegator(delegationChain?: readonly SessionDelegationHop[]): string | undefined;
+//# sourceMappingURL=auth-session.contract.d.ts.map

package/dist/contracts/auth-session.contract.js

@@ -1,60 +1,63 @@
-// src/contracts/auth-session.contract.ts
-var SESSION_AUTH_MODES = [
-  "interactive_user",
-  "service_principal",
-  "tenant_api_key",
-  "session_token"
+/**
+ * Session + Delegation Contract
+ *
+ * Canonical session lifecycle vocabulary shared by platform gateway auth,
+ * hosted MCP auth, Master Control persistence, and SDK session tokens.
+ */
+export const SESSION_AUTH_MODES = [
+    "interactive_user",
+    "service_principal",
+    "tenant_api_key",
+    "session_token",
 ];
-var SESSION_PRINCIPAL_TYPES = [
-  "human",
-  "service",
-  "agent",
-  "group",
-  "external_viewer"
+export const SESSION_PRINCIPAL_TYPES = [
+    "human",
+    "service",
+    "agent",
+    "group",
+    "external_viewer",
 ];
-var SESSION_LIFECYCLE_STATUSES = [
-  "active",
-  "expired",
-  "revoked"
+export const SESSION_LIFECYCLE_STATUSES = [
+    "active",
+    "expired",
+    "revoked",
 ];
-function inferSessionPrincipalType(principalId) {
-  if (/^user_[A-Za-z0-9]+$/.test(principalId)) {
-    return "human";
-  }
-  if (principalId.startsWith("agent:")) {
-    return "agent";
-  }
-  if (principalId.startsWith("group:")) {
-    return "group";
-  }
-  if (principalId.startsWith("external:") || principalId.startsWith("external_viewer:")) {
-    return "external_viewer";
-  }
-  return "service";
+export function inferSessionPrincipalType(principalId) {
+    if (/^user_[A-Za-z0-9]+$/.test(principalId)) {
+        return "human";
+    }
+    if (principalId.startsWith("agent:")) {
+        return "agent";
+    }
+    if (principalId.startsWith("group:")) {
+        return "group";
+    }
+    if (principalId.startsWith("external:") ||
+        principalId.startsWith("external_viewer:")) {
+        return "external_viewer";
+    }
+    return "service";
 }
-function normalizeDelegationChain(args) {
-  if (args.delegationChain && args.delegationChain.length > 0) {
-    return [...args.delegationChain];
-  }
-  if (!args.delegatedBy) {
-    return;
-  }
-  return [
-    {
-      principalId: args.delegatedBy,
-      principalType: args.delegatedByType ?? inferSessionPrincipalType(args.delegatedBy),
-      delegatedAt: args.delegatedAt,
-      reason: args.reason
+export function normalizeDelegationChain(args) {
+    if (args.delegationChain && args.delegationChain.length > 0) {
+        return [...args.delegationChain];
+    }
+    if (!args.delegatedBy) {
+        return;
     }
-  ];
+    return [
+        {
+            principalId: args.delegatedBy,
+            principalType: args.delegatedByType ?? inferSessionPrincipalType(args.delegatedBy),
+            delegatedAt: args.delegatedAt,
+            reason: args.reason,
+        },
+    ];
 }
-function lastDelegator(delegationChain) {
-  if (!delegationChain || delegationChain.length === 0) {
-    return;
-  }
-  return delegationChain[delegationChain.length - 1]?.principalId;
+export function lastDelegator(delegationChain) {
+    if (!delegationChain || delegationChain.length === 0) {
+        return;
+    }
+    return delegationChain[delegationChain.length - 1]?.principalId;
 }
-
-export { SESSION_AUTH_MODES, SESSION_LIFECYCLE_STATUSES, SESSION_PRINCIPAL_TYPES, inferSessionPrincipalType, lastDelegator, normalizeDelegationChain };
-//# sourceMappingURL=auth-session.contract.js.map
 //# sourceMappingURL=auth-session.contract.js.map