@lucern/sdk 1.0.11 → 1.0.13

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to `@lucern/sdk` will be documented in this file.
 ## [Unreleased]
 - No unreleased changes yet.
 
+## [1.0.13] - 2026-06-01
+- Exposes the Campaign 1 closeout headless surface: MCP output-schema
+  metadata, richer retrieval receipts, synthesis narrative coverage, and
+  evidence relation fields for supporting or contradicting belief links.
+- Deprecates direct public confidence modulation in favor of evidence-backed
+  Subjective Logic accumulation.
+
+## [1.0.12] - 2026-05-31
+- Release notes pending.
+
 ## [1.0.11] - 2026-05-29
 - Release notes pending.
 

package/README.md

@@ -90,7 +90,6 @@ IA-7 closes the remaining SDK surface gaps needed for SDK-first clients:
 ```typescript
 import {
   createLucernClient,
-  opinionFromDogmatic,
   type PlatformBeliefRecord,
   type SdkPrincipalContext,
   type WorkflowWorktreeRecord,
@@ -215,12 +214,8 @@ const sqlFactEvidence = await lucern.evidence.create({
   text: "OWASP SQL Injection Prevention guidance identifies parameterized queries as the primary defense.",
   sourceUrl: "https://owasp.org/www-community/attacks/SQL_Injection",
   targetId: sqlFact.data.nodeId,
-  weight: 1,
-});
-await lucern.beliefs.modulateConfidence(sqlFact.data.nodeId, {
-  opinion: opinionFromDogmatic(0.95, 0.5),
-  trigger: "evidence_added",
-  triggeringEvidenceId: sqlFactEvidence.data.nodeId,
+  evidenceRelation: "supports",
+  confidence: 0.95,
   rationale: "OWASP verified, industry standard for 20+ years",
 });
 
@@ -234,12 +229,8 @@ const patternEvidence = await lucern.evidence.create({
   text: "Last 6 months of security audits found 14 input validation issues and 1 cryptographic issue.",
   sourceUrl: "audit://security/findings-last-6-months",
   targetId: patternBelief.data.nodeId,
-  weight: 0.82,
-});
-await lucern.beliefs.modulateConfidence(patternBelief.data.nodeId, {
-  opinion: opinionFromDogmatic(0.82, 0.5),
-  trigger: "evidence_added",
-  triggeringEvidenceId: patternEvidence.data.nodeId,
+  evidenceRelation: "supports",
+  confidence: 0.82,
   rationale: "Last 6 months of security audits: 14 input validation issues, 1 crypto issue",
 });
 
@@ -368,11 +359,13 @@ const comparisonAnswer = await lucern.questions.answer(comparisonQuestion.data.q
 The original hypothesis said "less than 30%." The data shows 53% — but the story is more nuanced. Fork the belief to capture the evolved understanding.
 
 ```typescript
-// Drop confidence on the original (it was too pessimistic about overall catch rate)
-await lucern.beliefs.modulateConfidence(hypothesis.data.nodeId, {
-  opinion: opinionFromDogmatic(0.2, 0.5),
-  trigger: "evidence_added",
-  triggeringEvidenceId: humanEvidence.data.nodeId,
+// Attach contradicting evidence to the original (it was too pessimistic about overall catch rate)
+await lucern.evidence.linkToBelief({
+  evidenceId: humanEvidence.data.nodeId,
+  beliefId: hypothesis.data.nodeId,
+  weight: -0.8,
+  evidenceRelation: "contradicts",
+  confidence: 0.8,
   rationale: "Static analysis catches 53% overall, not <30%. But the category breakdown reveals something more important.",
 });
 
@@ -382,11 +375,12 @@ const evolved = await lucern.beliefs.fork(hypothesis.data.nodeId, {
   forkReason: "refinement",
 });
 
-await lucern.beliefs.modulateConfidence(evolved.data.nodeId, {
-  opinion: opinionFromDogmatic(0.88, 0.5),
-  trigger: "evidence_added",
-  triggeringEvidenceId: humanEvidence.data.nodeId,
-  triggeringAnswerId: comparisonAnswer.data.answerId,
+await lucern.evidence.linkToBelief({
+  evidenceId: humanEvidence.data.nodeId,
+  beliefId: evolved.data.nodeId,
+  weight: 0.88,
+  evidenceRelation: "supports",
+  confidence: 0.88,
   rationale: "Direct comparison data: 0/7 business logic flaws caught, 0/2 race conditions caught, while input validation catch rate was 12/22 (55%)",
 });
 
@@ -397,10 +391,13 @@ const actionable = await lucern.beliefs.create({
   beliefType: "belief",
 });
 
-await lucern.beliefs.modulateConfidence(actionable.data.nodeId, {
-  opinion: opinionFromDogmatic(0.85, 0.5),
-  trigger: "worktree_outcome",
-  triggeringWorktreeId: investigation.data.worktreeId,
+await lucern.evidence.create({
+  topicId,
+  text: "The comparison study makes business logic and concurrency the highest-value human review targets.",
+  sourceUrl: `worktree://${investigation.data.worktreeId}`,
+  targetId: actionable.data.nodeId,
+  evidenceRelation: "supports",
+  confidence: 0.85,
   rationale: "Direct implication of the comparison study findings",
 });
 

package/dist/.generated

@@ -0,0 +1,2 @@
+generated-by:scripts/build-sdk-package.ts
+package:@lucern/sdk

package/dist/accessControl.d.ts

@@ -1,21 +1,15 @@
-import { LucernSdkAuthContextError, LucernSdkAuthFailureReason, LucernSdkAuthContextInput } from './authContext.js';
-import { GatewayClientConfig } from './coreClient.js';
-import { PolicyEvaluationInput, PolicyDecisionRecord } from './identityClient.js';
-import { SessionPrincipalType } from './contracts/auth-session.contract.js';
-import { JsonObject } from './types.js';
-import '@lucern/transport-core';
-import './control-plane.js';
-import './contracts/workflow-runtime.contract.js';
-import './contracts/lens-workflow.contract.js';
-import './contracts/lens-filter.contract.js';
-
-type ClerkIdentityAliasInput = {
+import { LucernSdkAuthContextError, type LucernSdkAuthContextInput, type LucernSdkAuthFailureReason } from "./authContext";
+import { type GatewayClientConfig } from "./coreClient";
+import { type PolicyDecisionRecord, type PolicyEvaluationInput } from "./identityClient";
+import type { SessionPrincipalType } from "./contracts/auth-session.contract";
+import type { JsonObject } from "./types";
+export type ClerkIdentityAliasInput = {
     provider?: "clerk" | string;
     providerProjectId?: string | null;
     externalSubjectId: string;
     status?: "active" | "pending" | "revoked" | string;
 };
-type CanonicalPrincipalIdentityInput = {
+export type CanonicalPrincipalIdentityInput = {
     principalId?: string | null;
     principalType?: SessionPrincipalType | "user" | "external_viewer" | null;
     canonicalClerkUserId?: string | null;
@@ -26,13 +20,13 @@ type CanonicalPrincipalIdentityInput = {
     roles?: readonly string[];
     scopes?: readonly string[];
 };
-type CanonicalPrincipalIdentityAlias = {
+export type CanonicalPrincipalIdentityAlias = {
     provider: string;
     providerProjectId?: string;
     externalSubjectId: string;
     status?: string;
 };
-type CanonicalPrincipalIdentity = {
+export type CanonicalPrincipalIdentity = {
     principalId: string;
     principalType: SessionPrincipalType;
     canonicalClerkUserId?: string;
@@ -42,12 +36,12 @@ type CanonicalPrincipalIdentity = {
     roles: string[];
     scopes: string[];
 };
-type AccessResourceType = "tenant" | "workspace" | "deployment" | "convex_table" | "secret_scope" | "agent_session" | (string & {});
-type AccessResourceDescriptor = {
+export type AccessResourceType = "tenant" | "workspace" | "deployment" | "convex_table" | "secret_scope" | "agent_session" | (string & {});
+export type AccessResourceDescriptor = {
     type: AccessResourceType;
     key: string;
 };
-type RequireAccessInput = {
+export type RequireAccessInput = {
     identity?: CanonicalPrincipalIdentityInput | LucernSdkAuthContextInput;
     observedClerkId?: string;
     tenantId?: string;
@@ -56,25 +50,24 @@ type RequireAccessInput = {
     resource: AccessResourceDescriptor | string;
     context?: JsonObject;
 };
-type AccessCheckResult = {
+export type AccessCheckResult = {
     identity: CanonicalPrincipalIdentity;
     policyInput: PolicyEvaluationInput;
     decision: PolicyDecisionRecord;
 };
-declare class LucernAccessControlError extends LucernSdkAuthContextError {
+export declare class LucernAccessControlError extends LucernSdkAuthContextError {
     readonly policyDecision?: PolicyDecisionRecord;
     constructor(reason: LucernSdkAuthFailureReason, message: string, policyDecision?: PolicyDecisionRecord);
 }
-declare function normalizeCanonicalPrincipalIdentity(input: CanonicalPrincipalIdentityInput | LucernSdkAuthContextInput, options?: {
+export declare function normalizeCanonicalPrincipalIdentity(input: CanonicalPrincipalIdentityInput | LucernSdkAuthContextInput, options?: {
     observedClerkId?: string;
 }): CanonicalPrincipalIdentity;
-declare function formatPermitResource(resource: AccessResourceDescriptor | string): string;
-declare function assertPermitAllowed(decision: PolicyDecisionRecord): void;
-declare function createAccessControlClient(config?: GatewayClientConfig): {
+export declare function formatPermitResource(resource: AccessResourceDescriptor | string): string;
+export declare function assertPermitAllowed(decision: PolicyDecisionRecord): void;
+export declare function createAccessControlClient(config?: GatewayClientConfig): {
     normalizePrincipal: typeof normalizeCanonicalPrincipalIdentity;
     checkAccess: (input: RequireAccessInput, idempotencyKey?: string) => Promise<AccessCheckResult>;
     requireAccess: (input: RequireAccessInput, idempotencyKey?: string) => Promise<AccessCheckResult>;
     canAccess: (input: RequireAccessInput, idempotencyKey?: string) => Promise<boolean>;
 };
-
-export { type AccessCheckResult, type AccessResourceDescriptor, type AccessResourceType, type CanonicalPrincipalIdentity, type CanonicalPrincipalIdentityAlias, type CanonicalPrincipalIdentityInput, type ClerkIdentityAliasInput, LucernAccessControlError, type RequireAccessInput, assertPermitAllowed, createAccessControlClient, formatPermitResource, normalizeCanonicalPrincipalIdentity };
+//# sourceMappingURL=accessControl.d.ts.map