@lucern/sdk 0.2.0-alpha.7 → 0.2.0-alpha.8

package/dist/contextPackSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contextPackSchema.ts"],"names":[],"mappings":"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","file":"contextPackSchema.js","sourcesContent":["const CONTEXT_PACK_SCHEMA_VERSION = \"1.0.0\" as const;\n\ntype ValidationResult = {\n  valid: boolean;\n  errors: string[];\n};\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isString(value: unknown): value is string {\n  return typeof value === \"string\";\n}\n\nfunction isNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nfunction isNullableNumber(value: unknown): boolean {\n  return value === null || isNumber(value);\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((entry) => isString(entry));\n}\n\nfunction requireObject(\n  parent: Record<string, unknown>,\n  key: string,\n  errors: string[]\n): Record<string, unknown> | null {\n  const value = parent[key];\n  if (!isObject(value)) {\n    errors.push(`Expected '${key}' to be an object`);\n    return null;\n  }\n  return value;\n}\n\nfunction validateBeliefArray(\n  key: string,\n  value: unknown,\n  errors: string[]\n): void {\n  if (!Array.isArray(value)) {\n    errors.push(`Expected '${key}' to be an array`);\n    return;\n  }\n  for (let index = 0; index < value.length; index += 1) {\n    const row = value[index];\n    if (!isObject(row)) {\n      errors.push(`Expected '${key}[${index}]' to be an object`);\n      continue;\n    }\n    if (!isString(row.nodeId)) {\n      errors.push(`Expected '${key}[${index}].nodeId' to be a string`);\n    }\n    if (!isString(row.canonicalText)) {\n      errors.push(`Expected '${key}[${index}].canonicalText' to be a string`);\n    }\n    if (!isNullableNumber(row.confidence)) {\n      errors.push(`Expected '${key}[${index}].confidence' to be number|null`);\n    }\n  }\n}\n\nfunction validateQuestionArray(\n  key: string,\n  value: unknown,\n  errors: string[]\n): void {\n  if (!Array.isArray(value)) {\n    errors.push(`Expected '${key}' to be an array`);\n    return;\n  }\n  for (let index = 0; index < value.length; index += 1) {\n    const row = value[index];\n    if (!isObject(row)) {\n      errors.push(`Expected '${key}[${index}]' to be an object`);\n      continue;\n    }\n    if (!isString(row.questionId)) {\n      errors.push(`Expected '${key}[${index}].questionId' to be a string`);\n    }\n    if (!isString(row.text)) {\n      errors.push(`Expected '${key}[${index}].text' to be a string`);\n    }\n    if (!isString(row.status)) {\n      errors.push(`Expected '${key}[${index}].status' to be a string`);\n    }\n  }\n}\n\nfunction validateEvidenceArray(\n  key: string,\n  value: unknown,\n  errors: string[]\n): void {\n  if (!Array.isArray(value)) {\n    errors.push(`Expected '${key}' to be an array`);\n    return;\n  }\n  for (let index = 0; index < value.length; index += 1) {\n    const row = value[index];\n    if (!isObject(row)) {\n      errors.push(`Expected '${key}[${index}]' to be an object`);\n      continue;\n    }\n    if (!isString(row.nodeId)) {\n      errors.push(`Expected '${key}[${index}].nodeId' to be a string`);\n    }\n    if (!isString(row.canonicalText)) {\n      errors.push(`Expected '${key}[${index}].canonicalText' to be a string`);\n    }\n  }\n}\n\nfunction validateEntityArray(\n  key: string,\n  value: unknown,\n  errors: string[]\n): void {\n  if (!Array.isArray(value)) {\n    errors.push(`Expected '${key}' to be an array`);\n    return;\n  }\n  for (let index = 0; index < value.length; index += 1) {\n    const row = value[index];\n    if (!isObject(row)) {\n      errors.push(`Expected '${key}[${index}]' to be an object`);\n      continue;\n    }\n    if (!isString(row.nodeId)) {\n      errors.push(`Expected '${key}[${index}].nodeId' to be a string`);\n    }\n    if (!isString(row.entityType)) {\n      errors.push(`Expected '${key}[${index}].entityType' to be a string`);\n    }\n    if (!isString(row.title)) {\n      errors.push(`Expected '${key}[${index}].title' to be a string`);\n    }\n    if (!isNumber(row.connectedBeliefCount)) {\n      errors.push(`Expected '${key}[${index}].connectedBeliefCount' to be a number`);\n    }\n    if (!isNumber(row.connectedEvidenceCount)) {\n      errors.push(`Expected '${key}[${index}].connectedEvidenceCount' to be a number`);\n    }\n    if (!isNumber(row.score)) {\n      errors.push(`Expected '${key}[${index}].score' to be a number`);\n    }\n  }\n}\n\nfunction validateContradictionArray(\n  key: string,\n  value: unknown,\n  errors: string[]\n): void {\n  if (!Array.isArray(value)) {\n    errors.push(`Expected '${key}' to be an array`);\n    return;\n  }\n  for (let index = 0; index < value.length; index += 1) {\n    const row = value[index];\n    if (!isObject(row)) {\n      errors.push(`Expected '${key}[${index}]' to be an object`);\n      continue;\n    }\n    if (!isString(row.contradictionId)) {\n      errors.push(`Expected '${key}[${index}].contradictionId' to be a string`);\n    }\n    if (!isString(row.status)) {\n      errors.push(`Expected '${key}[${index}].status' to be a string`);\n    }\n  }\n}\n\nexport function validateContextPackSchema(payload: unknown): ValidationResult {\n  const errors: string[] = [];\n\n  if (!isObject(payload)) {\n    return {\n      valid: false,\n      errors: [\"Expected context pack payload to be an object\"],\n    };\n  }\n\n  if (payload.schemaVersion !== CONTEXT_PACK_SCHEMA_VERSION) {\n    errors.push(\n      `Expected schemaVersion='${CONTEXT_PACK_SCHEMA_VERSION}', received '${String(\n        payload.schemaVersion\n      )}'`\n    );\n  }\n\n  if (!isString(payload.topicId)) {\n    errors.push(\"Expected 'topicId' to be a string\");\n  }\n  if (!isString(payload.topicName)) {\n    errors.push(\"Expected 'topicName' to be a string\");\n  }\n  if (!isStringArray(payload.scopedTopicIds)) {\n    errors.push(\"Expected 'scopedTopicIds' to be string[]\");\n  }\n  if (!isNumber(payload.generatedAt)) {\n    errors.push(\"Expected 'generatedAt' to be a number\");\n  }\n  if (!isString(payload.ranking)) {\n    errors.push(\"Expected 'ranking' to be a string\");\n  }\n\n  validateBeliefArray(\"invariants\", payload.invariants, errors);\n  validateBeliefArray(\"activeBeliefs\", payload.activeBeliefs, errors);\n  validateQuestionArray(\"openQuestions\", payload.openQuestions, errors);\n  validateEvidenceArray(\"recentEvidence\", payload.recentEvidence, errors);\n  validateContradictionArray(\"contradictions\", payload.contradictions, errors);\n\n  if (\n    payload.relatedEntities !== undefined &&\n    payload.relatedEntities !== null\n  ) {\n    validateEntityArray(\"relatedEntities\", payload.relatedEntities, errors);\n  }\n\n  if (!Array.isArray(payload.contextNarrative)) {\n    errors.push(\"Expected 'contextNarrative' to be an array\");\n  }\n\n  const injectionPolicy = requireObject(payload, \"injectionPolicy\", errors);\n  if (injectionPolicy) {\n    if (!isNumber(injectionPolicy.tokenBudget)) {\n      errors.push(\"Expected 'injectionPolicy.tokenBudget' to be a number\");\n    }\n    if (!isNumber(injectionPolicy.estimatedTokens)) {\n      errors.push(\"Expected 'injectionPolicy.estimatedTokens' to be a number\");\n    }\n  }\n\n  if (!isObject(payload.summary)) {\n    errors.push(\"Expected 'summary' to be an object\");\n  }\n  if (!isObject(payload.diagnostics)) {\n    errors.push(\"Expected 'diagnostics' to be an object\");\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n"]}

package/dist/contextTypes.d.ts

@@ -0,0 +1,135 @@
+type ContextRankingProfile = "baseline_v1" | "hybrid_v1" | "weighted_v1";
+type ContextCompilationMode = "standard" | "delta";
+type ContextPackSectionKey = "invariants" | "activeBeliefs" | "openQuestions" | "recentEvidence" | "contradictions";
+type RankingWeightVector = {
+    query: number;
+    recency: number;
+    confidence?: number;
+    beliefType?: number;
+    priority?: number;
+    severity?: number;
+};
+type PackWeightOverride = {
+    section: ContextPackSectionKey;
+    weights: Partial<RankingWeightVector>;
+};
+type CompileContextInput = {
+    query?: string;
+    budget?: number;
+    ranking?: ContextRankingProfile;
+    limit?: number;
+    maxDepth?: number;
+    includeEntities?: boolean;
+    mode?: ContextCompilationMode;
+    includeFailures?: boolean;
+    worktreeId?: string;
+    sessionId?: string;
+    packWeightOverrides?: PackWeightOverride[];
+    tokenBudget?: number;
+    rankingProfile?: ContextRankingProfile;
+};
+type PublicContextBelief = {
+    beliefId: string;
+    text: string;
+    confidence: number | null;
+    beliefType?: string | null;
+    status?: string;
+    updatedAt?: number | null;
+    score: number;
+    justification?: string;
+};
+type PublicContextQuestion = {
+    questionId: string;
+    text: string;
+    status: string;
+    priority: string;
+    updatedAt?: number | null;
+    score: number;
+    justification?: string;
+};
+type PublicContextEvidence = {
+    evidenceId: string;
+    text: string;
+    sourceUrl?: string | null;
+    kind: string;
+    createdAt?: number | null;
+    score: number;
+    justification?: string;
+};
+type PublicContextContradiction = {
+    contradictionId: string;
+    severity: string;
+    status: string;
+    description: string;
+    score: number;
+    justification?: string;
+};
+type PublicContextEntity = {
+    entityId: string;
+    entityType: string;
+    title: string;
+    text?: string;
+    connectedBeliefCount: number;
+    connectedEvidenceCount: number;
+    score: number;
+    metadata?: Record<string, unknown>;
+};
+type PublicContextInjectionPolicy = {
+    tokenBudget: number;
+    estimatedTokens: number;
+    sectionBudgets: Record<string, number>;
+    sectionUsage: Record<string, number>;
+    selected: Record<string, string[]>;
+    excludedItems?: Array<{
+        id: string;
+        section: string;
+        reason: "budget_exceeded" | "anti_repetition" | "below_threshold";
+        score: number;
+    }>;
+};
+type PublicCompiledContext = {
+    schemaVersion: string;
+    topicId: string;
+    topicName: string;
+    scopedTopicIds: string[];
+    generatedAt: number;
+    ranking: ContextRankingProfile;
+    summary: Record<string, unknown>;
+    invariants: PublicContextBelief[];
+    activeBeliefs: PublicContextBelief[];
+    openQuestions: PublicContextQuestion[];
+    recentEvidence: PublicContextEvidence[];
+    contradictions: PublicContextContradiction[];
+    relatedEntities?: PublicContextEntity[];
+    contextNarrative: string[];
+    injectionPolicy: PublicContextInjectionPolicy;
+    diagnostics: Record<string, unknown>;
+    compilationMode?: string;
+    failureContext?: {
+        failures: Array<{
+            attemptId: string;
+            approach: string;
+            outcome: string;
+            recordedAt: number;
+            score: number;
+        }>;
+        suppressedIds: string[];
+    };
+    deltaReport?: {
+        changedItems: Array<{
+            id: string;
+            section: string;
+            changeType: string;
+            summary: string;
+        }>;
+        verificationObligations: Array<{
+            description: string;
+            source: string;
+            severity: "critical" | "high" | "medium" | "low";
+        }>;
+        referencePoint: string;
+    };
+    appliedWeightOverrides?: unknown[];
+};
+
+export type { CompileContextInput, ContextCompilationMode, ContextPackSectionKey, ContextRankingProfile, PackWeightOverride, PublicCompiledContext, PublicContextBelief, PublicContextContradiction, PublicContextEntity, PublicContextEvidence, PublicContextInjectionPolicy, PublicContextQuestion, RankingWeightVector };

package/dist/contextTypes.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=contextTypes.js.map
+//# sourceMappingURL=contextTypes.js.map

package/dist/contextTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"contextTypes.js"}

package/dist/contracts/api-enums.contract.d.ts

@@ -0,0 +1,81 @@
+/**
+ * API Enum Contract Definitions
+ *
+ * Canonical enum values for all API-facing enumerations.
+ * These MUST match the kernel schema validators exactly.
+ *
+ * Source of truth: lucern/packages/reasoning-kernel/src/adapters/schema/spine/
+ */
+/**
+ * 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
+ */
+declare const BELIEF_STATUSES: readonly ["assumption", "hypothesis", "belief", "fact"];
+type BeliefStatus = (typeof BELIEF_STATUSES)[number];
+/** Why a scored belief was branched into a new version */
+declare const FORK_REASONS: readonly ["refinement", "contradiction_response", "scope_change", "confidence_collapse", "manual"];
+type ForkReason = (typeof FORK_REASONS)[number];
+/** What caused a confidence change — every modulation must declare its trigger */
+declare const CONFIDENCE_TRIGGERS: readonly ["evidence_added", "contradiction_detected", "merge_outcome", "worktree_outcome", "manual", "decay"];
+type ConfidenceTrigger = (typeof CONFIDENCE_TRIGGERS)[number];
+/**
+ * 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)
+ */
+declare const EPISTEMIC_EDGE_TYPES: readonly ["supports", "informs", "depends_on", "derived_from", "contains", "tests"];
+type EpistemicEdgeType = (typeof EPISTEMIC_EDGE_TYPES)[number];
+/** Structural and lifecycle edges — required for graph integrity */
+declare const STRUCTURAL_EDGE_TYPES: readonly ["supersedes", "responds_to", "belongs_to", "relates_to_thesis"];
+type StructuralEdgeType = (typeof STRUCTURAL_EDGE_TYPES)[number];
+/** All valid edge types (epistemic + structural) */
+declare const EDGE_TYPES: readonly ["supports", "informs", "depends_on", "derived_from", "contains", "tests", "supersedes", "responds_to", "belongs_to", "relates_to_thesis"];
+type EdgeType = EpistemicEdgeType | StructuralEdgeType;
+/** How an edge relationship was determined */
+declare const REASONING_METHODS: readonly ["deductive", "inductive", "abductive", "analogical", "empirical"];
+type ReasoningMethod = (typeof REASONING_METHODS)[number];
+/** Defeat types (Pollock taxonomy) — how a contradiction operates */
+declare const DEFEAT_TYPES: readonly ["rebuts", "undercuts", "undermines"];
+type DefeatType = (typeof DEFEAT_TYPES)[number];
+/** Contradiction severity */
+declare const CONTRADICTION_SEVERITIES: readonly ["low", "medium", "high", "critical"];
+type ContradictionSeverity = (typeof CONTRADICTION_SEVERITIES)[number];
+/** Contradiction resolution status */
+declare const CONTRADICTION_STATUSES: readonly ["unresolved", "resolved", "accepted"];
+type ContradictionStatus = (typeof CONTRADICTION_STATUSES)[number];
+/** How a worktree investigation concluded */
+declare const MERGE_OUTCOMES: readonly ["validated", "invalidated", "forked", "inconclusive"];
+type MergeOutcome = (typeof MERGE_OUTCOMES)[number];
+/** Investigation phases within a worktree */
+declare const WORKTREE_PHASES: readonly ["hypothesis", "investigation", "evaluation", "resolution"];
+type WorktreePhase = (typeof WORKTREE_PHASES)[number];
+/**
+ * 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
+ */
+declare const EPISTEMIC_LAYERS: readonly ["L1", "L2", "L3", "L4"];
+type EpistemicLayer = (typeof EPISTEMIC_LAYERS)[number];
+/**
+ * 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.
+ */
+declare const JUDGMENT_TYPES: readonly ["thesis", "thesis_maturity", "contradiction_ruling", "scope_determination", "confidence_ruling"];
+type JudgmentType = (typeof JUDGMENT_TYPES)[number];
+
+export { BELIEF_STATUSES, type BeliefStatus, CONFIDENCE_TRIGGERS, CONTRADICTION_SEVERITIES, CONTRADICTION_STATUSES, type ConfidenceTrigger, type ContradictionSeverity, type ContradictionStatus, DEFEAT_TYPES, type DefeatType, EDGE_TYPES, EPISTEMIC_EDGE_TYPES, EPISTEMIC_LAYERS, type EdgeType, type EpistemicEdgeType, type EpistemicLayer, FORK_REASONS, type ForkReason, JUDGMENT_TYPES, type JudgmentType, MERGE_OUTCOMES, type MergeOutcome, REASONING_METHODS, type ReasoningMethod, STRUCTURAL_EDGE_TYPES, type StructuralEdgeType, WORKTREE_PHASES, type WorktreePhase };

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

@@ -0,0 +1,92 @@
+// src/contracts/api-enums.contract.ts
+var BELIEF_STATUSES = [
+  "assumption",
+  "hypothesis",
+  "belief",
+  "fact"
+];
+var FORK_REASONS = [
+  "refinement",
+  "contradiction_response",
+  "scope_change",
+  "confidence_collapse",
+  "manual"
+];
+var CONFIDENCE_TRIGGERS = [
+  "evidence_added",
+  "contradiction_detected",
+  "merge_outcome",
+  "worktree_outcome",
+  "manual",
+  "decay"
+];
+var EPISTEMIC_EDGE_TYPES = [
+  "supports",
+  "informs",
+  "depends_on",
+  "derived_from",
+  "contains",
+  "tests"
+];
+var STRUCTURAL_EDGE_TYPES = [
+  "supersedes",
+  "responds_to",
+  "belongs_to",
+  "relates_to_thesis"
+];
+var EDGE_TYPES = [
+  ...EPISTEMIC_EDGE_TYPES,
+  ...STRUCTURAL_EDGE_TYPES
+];
+var REASONING_METHODS = [
+  "deductive",
+  "inductive",
+  "abductive",
+  "analogical",
+  "empirical"
+];
+var DEFEAT_TYPES = [
+  "rebuts",
+  "undercuts",
+  "undermines"
+];
+var CONTRADICTION_SEVERITIES = [
+  "low",
+  "medium",
+  "high",
+  "critical"
+];
+var CONTRADICTION_STATUSES = [
+  "unresolved",
+  "resolved",
+  "accepted"
+];
+var MERGE_OUTCOMES = [
+  "validated",
+  "invalidated",
+  "forked",
+  "inconclusive"
+];
+var WORKTREE_PHASES = [
+  "hypothesis",
+  "investigation",
+  "evaluation",
+  "resolution"
+];
+var EPISTEMIC_LAYERS = [
+  "L1",
+  "L2",
+  "L3",
+  "L4"
+];
+var 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/api-enums.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts/api-enums.contract.ts"],"names":[],"mappings":";AAqBO,IAAM,eAAA,GAAkB;AAAA,EAC7B,YAAA;AAAA,EACA,YAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF;AAQO,IAAM,YAAA,GAAe;AAAA,EAC1B,YAAA;AAAA,EACA,wBAAA;AAAA,EACA,cAAA;AAAA,EACA,qBAAA;AAAA,EACA;AACF;AAQO,IAAM,mBAAA,GAAsB;AAAA,EACjC,gBAAA;AAAA,EACA,wBAAA;AAAA,EACA,eAAA;AAAA,EACA,kBAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF;AAiBO,IAAM,oBAAA,GAAuB;AAAA,EAClC,UAAA;AAAA,EACA,SAAA;AAAA,EACA,YAAA;AAAA,EACA,cAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAIO,IAAM,qBAAA,GAAwB;AAAA,EACnC,YAAA;AAAA,EACA,aAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF;AAIO,IAAM,UAAA,GAAa;AAAA,EACxB,GAAG,oBAAA;AAAA,EACH,GAAG;AACL;AAQO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,WAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF;AAQO,IAAM,YAAA,GAAe;AAAA,EAC1B,QAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF;AAIO,IAAM,wBAAA,GAA2B;AAAA,EACtC,KAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF;AAIO,IAAM,sBAAA,GAAyB;AAAA,EACpC,YAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAQO,IAAM,cAAA,GAAiB;AAAA,EAC5B,WAAA;AAAA,EACA,aAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF;AAIO,IAAM,eAAA,GAAkB;AAAA,EAC7B,YAAA;AAAA,EACA,eAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF;AAeO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,IAAA;AAAA,EACA,IAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF;AAcO,IAAM,cAAA,GAAiB;AAAA,EAC5B,QAAA;AAAA,EACA,iBAAA;AAAA,EACA,sBAAA;AAAA,EACA,qBAAA;AAAA,EACA;AACF","file":"api-enums.contract.js","sourcesContent":["/**\n * API Enum Contract Definitions\n *\n * Canonical enum values for all API-facing enumerations.\n * These MUST match the kernel schema validators exactly.\n *\n * Source of truth: lucern/packages/reasoning-kernel/src/adapters/schema/spine/\n */\n\n// =============================================================================\n// BELIEF STATUS\n// =============================================================================\n\n/**\n * Belief epistemic lifecycle — tracks maturity from raw claim to verified fact.\n *\n * - assumption: Untested raw claim, lowest epistemic standing\n * - hypothesis: Under active investigation, being tested against evidence\n * - belief: Validated through investigation, carries confidence score\n * - fact: Resolved outcome anchored by strong evidence\n */\nexport const BELIEF_STATUSES = [\n  \"assumption\",\n  \"hypothesis\",\n  \"belief\",\n  \"fact\",\n] as const;\nexport type BeliefStatus = (typeof BELIEF_STATUSES)[number];\n\n// =============================================================================\n// FORK REASONS\n// =============================================================================\n\n/** Why a scored belief was branched into a new version */\nexport const FORK_REASONS = [\n  \"refinement\",\n  \"contradiction_response\",\n  \"scope_change\",\n  \"confidence_collapse\",\n  \"manual\",\n] as const;\nexport type ForkReason = (typeof FORK_REASONS)[number];\n\n// =============================================================================\n// CONFIDENCE TRIGGERS\n// =============================================================================\n\n/** What caused a confidence change — every modulation must declare its trigger */\nexport const CONFIDENCE_TRIGGERS = [\n  \"evidence_added\",\n  \"contradiction_detected\",\n  \"merge_outcome\",\n  \"worktree_outcome\",\n  \"manual\",\n  \"decay\",\n] as const;\nexport type ConfidenceTrigger = (typeof CONFIDENCE_TRIGGERS)[number];\n\n// =============================================================================\n// EDGE TYPES — The 6 canonical epistemic edge types\n// =============================================================================\n\n/**\n * Core epistemic edge types — the grammar of reasoning relationships.\n *\n * - supports: Evidence or belief reinforces another belief (weight = strength)\n * - informs: Evidence bears on a belief (directional, weighted)\n * - depends_on: Belief B requires belief A to hold\n * - derived_from: Belief was derived from another (lineage)\n * - contains: Structural containment (topic contains beliefs)\n * - tests: Question tests a belief (falsification link)\n */\nexport const EPISTEMIC_EDGE_TYPES = [\n  \"supports\",\n  \"informs\",\n  \"depends_on\",\n  \"derived_from\",\n  \"contains\",\n  \"tests\",\n] as const;\nexport type EpistemicEdgeType = (typeof EPISTEMIC_EDGE_TYPES)[number];\n\n/** Structural and lifecycle edges — required for graph integrity */\nexport const STRUCTURAL_EDGE_TYPES = [\n  \"supersedes\",\n  \"responds_to\",\n  \"belongs_to\",\n  \"relates_to_thesis\",\n] as const;\nexport type StructuralEdgeType = (typeof STRUCTURAL_EDGE_TYPES)[number];\n\n/** All valid edge types (epistemic + structural) */\nexport const EDGE_TYPES = [\n  ...EPISTEMIC_EDGE_TYPES,\n  ...STRUCTURAL_EDGE_TYPES,\n] as const;\nexport type EdgeType = EpistemicEdgeType | StructuralEdgeType;\n\n// =============================================================================\n// REASONING METHODS\n// =============================================================================\n\n/** How an edge relationship was determined */\nexport const REASONING_METHODS = [\n  \"deductive\",\n  \"inductive\",\n  \"abductive\",\n  \"analogical\",\n  \"empirical\",\n] as const;\nexport type ReasoningMethod = (typeof REASONING_METHODS)[number];\n\n// =============================================================================\n// CONTRADICTION ENUMS\n// =============================================================================\n\n/** Defeat types (Pollock taxonomy) — how a contradiction operates */\nexport const DEFEAT_TYPES = [\n  \"rebuts\",\n  \"undercuts\",\n  \"undermines\",\n] as const;\nexport type DefeatType = (typeof DEFEAT_TYPES)[number];\n\n/** Contradiction severity */\nexport const CONTRADICTION_SEVERITIES = [\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"critical\",\n] as const;\nexport type ContradictionSeverity = (typeof CONTRADICTION_SEVERITIES)[number];\n\n/** Contradiction resolution status */\nexport const CONTRADICTION_STATUSES = [\n  \"unresolved\",\n  \"resolved\",\n  \"accepted\",\n] as const;\nexport type ContradictionStatus = (typeof CONTRADICTION_STATUSES)[number];\n\n// =============================================================================\n// WORKTREE ENUMS\n// =============================================================================\n\n/** How a worktree investigation concluded */\nexport const MERGE_OUTCOMES = [\n  \"validated\",\n  \"invalidated\",\n  \"forked\",\n  \"inconclusive\",\n] as const;\nexport type MergeOutcome = (typeof MERGE_OUTCOMES)[number];\n\n/** Investigation phases within a worktree */\nexport const WORKTREE_PHASES = [\n  \"hypothesis\",\n  \"investigation\",\n  \"evaluation\",\n  \"resolution\",\n] as const;\nexport type WorktreePhase = (typeof WORKTREE_PHASES)[number];\n\n// =============================================================================\n// EPISTEMIC LAYERS\n// =============================================================================\n\n/**\n * The knowledge hierarchy — each layer builds on the one below it.\n *\n * - L1: Sources — raw inputs (documents, APIs, observations)\n * - L2: Evidence — interpreted facts with context and weight\n * - L3: Beliefs — structural claims that carry confidence\n * - L4: Judgments — irreversible commitments based on the epistemic state\n */\nexport const EPISTEMIC_LAYERS = [\n  \"L1\",\n  \"L2\",\n  \"L3\",\n  \"L4\",\n] as const;\nexport type EpistemicLayer = (typeof EPISTEMIC_LAYERS)[number];\n\n// =============================================================================\n// JUDGMENT TYPES\n// =============================================================================\n\n/**\n * Classification of L4 judgments — irreversible determinations.\n *\n * Judgments are evaluated against the knowledge horizon that existed\n * when they were made. They cannot be retroactively invalidated —\n * only new judgments can supersede old ones.\n */\nexport const JUDGMENT_TYPES = [\n  \"thesis\",\n  \"thesis_maturity\",\n  \"contradiction_ruling\",\n  \"scope_determination\",\n  \"confidence_ruling\",\n] as const;\nexport type JudgmentType = (typeof JUDGMENT_TYPES)[number];\n"]}

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

@@ -0,0 +1,55 @@
+/**
+ * Session + Delegation Contract
+ *
+ * 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"];
+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 = {
+    principalId: string;
+    principalType: SessionPrincipalType;
+    authMode?: SessionAuthMode;
+    sessionId?: string;
+    delegatedAt?: number;
+    reason?: string;
+};
+type SessionAuditOutcome = "accepted" | "rejected" | "revoked" | "expired";
+type SessionAuditEnvelope = {
+    sessionId: string;
+    authMode: SessionAuthMode;
+    principalId: string;
+    principalType: SessionPrincipalType;
+    tenantId: string;
+    workspaceId?: string;
+    apiKeyId?: string;
+    scopes: readonly string[];
+    roles?: readonly string[];
+    delegationChain?: readonly SessionDelegationHop[];
+    sourceSessionId?: string;
+    expiresAt?: number;
+    request?: {
+        endpoint?: string;
+        method?: string;
+        correlationId?: string;
+    };
+    result?: {
+        outcome: SessionAuditOutcome;
+        reason?: string;
+    };
+};
+declare function inferSessionPrincipalType(principalId: string): SessionPrincipalType;
+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 };

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

@@ -0,0 +1,48 @@
+// src/contracts/auth-session.contract.ts
+var SESSION_AUTH_MODES = [
+  "interactive_user",
+  "service_principal",
+  "tenant_api_key",
+  "session_token"
+];
+var SESSION_PRINCIPAL_TYPES = ["human", "service", "agent"];
+var SESSION_LIFECYCLE_STATUSES = [
+  "active",
+  "expired",
+  "revoked"
+];
+function inferSessionPrincipalType(principalId) {
+  if (principalId.startsWith("user:")) {
+    return "human";
+  }
+  if (principalId.startsWith("agent:")) {
+    return "agent";
+  }
+  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
+    }
+  ];
+}
+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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts/auth-session.contract.ts"],"names":[],"mappings":";AAOO,IAAM,kBAAA,GAAqB;AAAA,EAChC,kBAAA;AAAA,EACA,mBAAA;AAAA,EACA,gBAAA;AAAA,EACA;AACF;AAGO,IAAM,uBAAA,GAA0B,CAAC,OAAA,EAAS,SAAA,EAAW,OAAO;AAG5D,IAAM,0BAAA,GAA6B;AAAA,EACxC,QAAA;AAAA,EACA,SAAA;AAAA,EACA;AACF;AA2CO,SAAS,0BACd,WAAA,EACsB;AACtB,EAAA,IAAI,WAAA,CAAY,UAAA,CAAW,OAAO,CAAA,EAAG;AACnC,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,IAAI,WAAA,CAAY,UAAA,CAAW,QAAQ,CAAA,EAAG;AACpC,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,OAAO,SAAA;AACT;AAEO,SAAS,yBAAyB,IAAA,EAMF;AACrC,EAAA,IAAI,IAAA,CAAK,eAAA,IAAmB,IAAA,CAAK,eAAA,CAAgB,SAAS,CAAA,EAAG;AAC3D,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,eAAe,CAAA;AAAA,EACjC;AACA,EAAA,IAAI,CAAC,KAAK,WAAA,EAAa;AACrB,IAAA;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL;AAAA,MACE,aAAa,IAAA,CAAK,WAAA;AAAA,MAClB,aAAA,EACE,IAAA,CAAK,eAAA,IAAmB,yBAAA,CAA0B,KAAK,WAAW,CAAA;AAAA,MACpE,aAAa,IAAA,CAAK,WAAA;AAAA,MAClB,QAAQ,IAAA,CAAK;AAAA;AACf,GACF;AACF;AAEO,SAAS,cACd,eAAA,EACoB;AACpB,EAAA,IAAI,CAAC,eAAA,IAAmB,eAAA,CAAgB,MAAA,KAAW,CAAA,EAAG;AACpD,IAAA;AAAA,EACF;AACA,EAAA,OAAO,eAAA,CAAgB,eAAA,CAAgB,MAAA,GAAS,CAAC,CAAA,EAAG,WAAA;AACtD","file":"auth-session.contract.js","sourcesContent":["/**\n * Session + Delegation Contract\n *\n * Canonical session lifecycle vocabulary shared by platform gateway auth,\n * hosted MCP auth, Master Control persistence, and SDK session tokens.\n */\n\nexport const SESSION_AUTH_MODES = [\n  \"interactive_user\",\n  \"service_principal\",\n  \"tenant_api_key\",\n  \"session_token\",\n] as const;\nexport type SessionAuthMode = (typeof SESSION_AUTH_MODES)[number];\n\nexport const SESSION_PRINCIPAL_TYPES = [\"human\", \"service\", \"agent\"] as const;\nexport type SessionPrincipalType = (typeof SESSION_PRINCIPAL_TYPES)[number];\n\nexport const SESSION_LIFECYCLE_STATUSES = [\n  \"active\",\n  \"expired\",\n  \"revoked\",\n] as const;\nexport type SessionLifecycleStatus =\n  (typeof SESSION_LIFECYCLE_STATUSES)[number];\n\nexport type SessionDelegationHop = {\n  principalId: string;\n  principalType: SessionPrincipalType;\n  authMode?: SessionAuthMode;\n  sessionId?: string;\n  delegatedAt?: number;\n  reason?: string;\n};\n\nexport type SessionAuditOutcome =\n  | \"accepted\"\n  | \"rejected\"\n  | \"revoked\"\n  | \"expired\";\n\nexport type SessionAuditEnvelope = {\n  sessionId: string;\n  authMode: SessionAuthMode;\n  principalId: string;\n  principalType: SessionPrincipalType;\n  tenantId: string;\n  workspaceId?: string;\n  apiKeyId?: string;\n  scopes: readonly string[];\n  roles?: readonly string[];\n  delegationChain?: readonly SessionDelegationHop[];\n  sourceSessionId?: string;\n  expiresAt?: number;\n  request?: {\n    endpoint?: string;\n    method?: string;\n    correlationId?: string;\n  };\n  result?: {\n    outcome: SessionAuditOutcome;\n    reason?: string;\n  };\n};\n\nexport function inferSessionPrincipalType(\n  principalId: string\n): SessionPrincipalType {\n  if (principalId.startsWith(\"user:\")) {\n    return \"human\";\n  }\n  if (principalId.startsWith(\"agent:\")) {\n    return \"agent\";\n  }\n  return \"service\";\n}\n\nexport function normalizeDelegationChain(args: {\n  delegationChain?: readonly SessionDelegationHop[];\n  delegatedBy?: string;\n  delegatedByType?: SessionPrincipalType;\n  delegatedAt?: number;\n  reason?: string;\n}): SessionDelegationHop[] | undefined {\n  if (args.delegationChain && args.delegationChain.length > 0) {\n    return [...args.delegationChain];\n  }\n  if (!args.delegatedBy) {\n    return;\n  }\n  return [\n    {\n      principalId: args.delegatedBy,\n      principalType:\n        args.delegatedByType ?? inferSessionPrincipalType(args.delegatedBy),\n      delegatedAt: args.delegatedAt,\n      reason: args.reason,\n    },\n  ];\n}\n\nexport function lastDelegator(\n  delegationChain?: readonly SessionDelegationHop[]\n): string | undefined {\n  if (!delegationChain || delegationChain.length === 0) {\n    return;\n  }\n  return delegationChain[delegationChain.length - 1]?.principalId;\n}\n"]}