@lucern/sdk 1.0.21 → 1.0.23

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to `@lucern/sdk` will be documented in this file.
 ## [Unreleased]
 - No unreleased changes yet.
 
+## [1.0.23] - 2026-06-12
+- Activation release for the reasoning-tenant writeback surface. Carries the
+  RR.1-5 kernel write substrate and the FR lane's writeback ergonomics so
+  graph-writing agents stop fighting deployed-surface drift.
+- FR.1: one-call `record_scope_learning` accepting signed `linkedBeliefs`
+  weights in `[-1, 1]`; FR.2: CLI coherence with the fixed record-merge path;
+  FR.4: `refine_belief`, archive surface, belief-id/`text`/`globalId` aliases,
+  and `flag_contradiction` explicit `topicId`.
+- `worktreeType` is tightened to the canonical schema enum (#1303).
+
+## [1.0.22] - 2026-06-08
+- Release notes pending.
+
 ## [1.0.21] - 2026-06-06
 - Release notes pending.
 

package/dist/contextClient.d.ts

@@ -1,9 +1,10 @@
 import { type GatewayClientConfig } from "./coreClient";
-import type { CompileContextInput, PublicCompiledContext } from "./contextTypes";
+import type { CompileContextInput, GetCampaignContextInput, PublicCampaignContext, PublicCompiledContext } from "./contextTypes";
 /** Configuration for the context client. */
 export type ContextClientConfig = GatewayClientConfig;
 /** Alias for the compiled context payload returned by the gateway. */
 export type CompileContextResponse = PublicCompiledContext;
+export type GetCampaignContextResponse = PublicCampaignContext;
 /**
  * Create the context client for compiling reasoning context packs.
  * @param config - Gateway transport configuration.
@@ -18,6 +19,7 @@ export declare function createContextClient(config?: ContextClientConfig): {
      */
     compile(topicIdOrInput?: string | CompileContextInput, input?: CompileContextInput): Promise<import("./coreClient").PlatformGatewaySuccess<PublicCompiledContext>>;
     compileByQuery(input?: CompileContextInput): Promise<import("./coreClient").PlatformGatewaySuccess<PublicCompiledContext>>;
+    getCampaignContext(input: GetCampaignContextInput): Promise<import("./coreClient").PlatformGatewaySuccess<PublicCampaignContext>>;
 };
-export type { CompileContextInput, PublicCompiledContext } from "./contextTypes";
+export type { CampaignContextPurpose, CompileContextInput, ContextHeartbeatIntent, GetCampaignContextInput, PublicContextHeartbeatReceipt, PublicCampaignContext, PublicCompiledContext, } from "./contextTypes";
 //# sourceMappingURL=contextClient.d.ts.map

package/dist/contextClient.js

@@ -10,6 +10,27 @@ function cleanNumber(value) {
 function cleanBoolean(value) {
     return typeof value === "boolean" ? value : undefined;
 }
+function cleanStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const cleaned = value
+        .map((item) => cleanString(item))
+        .filter((item) => Boolean(item));
+    return cleaned.length > 0 ? cleaned : undefined;
+}
+function assignString(payload, key, value) {
+    const cleaned = cleanString(value);
+    if (cleaned) {
+        payload[key] = cleaned;
+    }
+}
+function assignNumber(payload, key, value) {
+    const cleaned = cleanNumber(value);
+    if (cleaned !== undefined) {
+        payload[key] = cleaned;
+    }
+}
 function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
     const effectiveInput = typeof topicIdOrInput === "string" ? input : topicIdOrInput;
     const payload = {};
@@ -23,10 +44,35 @@ function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
     if (query) {
         payload.query = query;
     }
-    const budget = cleanNumber(effectiveInput.budget) ?? cleanNumber(effectiveInput.tokenBudget);
+    assignString(payload, "purpose", effectiveInput.purpose);
+    assignString(payload, "purposePrompt", effectiveInput.purposePrompt);
+    assignString(payload, "topicHint", effectiveInput.topicHint);
+    const tags = cleanStringArray(effectiveInput.tags);
+    if (tags) {
+        payload.tags = tags;
+    }
+    const touchedPaths = cleanStringArray(effectiveInput.touchedPaths);
+    if (touchedPaths) {
+        payload.touchedPaths = touchedPaths;
+    }
+    assignString(payload, "sourceRef", effectiveInput.sourceRef);
+    assignString(payload, "sourceKind", effectiveInput.sourceKind);
+    assignNumber(payload, "campaign", effectiveInput.campaign);
+    assignString(payload, "lane", effectiveInput.lane);
+    assignString(payload, "status", effectiveInput.status);
+    assignString(payload, "principalId", effectiveInput.principalId);
+    assignString(payload, "workspaceId", effectiveInput.workspaceId);
+    const budget = cleanNumber(effectiveInput.budget);
     if (budget !== undefined) {
         payload.budget = budget;
     }
+    const tokenBudget = cleanNumber(effectiveInput.tokenBudget);
+    if (tokenBudget !== undefined) {
+        payload.tokenBudget = tokenBudget;
+        if (budget === undefined) {
+            payload.budget = tokenBudget;
+        }
+    }
     const ranking = cleanString(effectiveInput.ranking) ?? cleanString(effectiveInput.rankingProfile);
     if (ranking) {
         payload.ranking = ranking;
@@ -35,6 +81,7 @@ function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
     if (limit !== undefined) {
         payload.limit = limit;
     }
+    assignNumber(payload, "contentTopicLimit", effectiveInput.contentTopicLimit);
     const maxDepth = cleanNumber(effectiveInput.maxDepth);
     if (maxDepth !== undefined) {
         payload.maxDepth = maxDepth;
@@ -47,6 +94,17 @@ function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
     if (mode) {
         payload.mode = mode;
     }
+    assignString(payload, "traversalMode", effectiveInput.traversalMode);
+    assignString(payload, "requestedDepth", effectiveInput.requestedDepth);
+    const heartbeat = cleanBoolean(effectiveInput.heartbeat);
+    if (heartbeat !== undefined) {
+        payload.heartbeat = heartbeat;
+    }
+    assignString(payload, "heartbeatIntent", effectiveInput.heartbeatIntent);
+    assignNumber(payload, "heartbeatBudgetMs", effectiveInput.heartbeatBudgetMs);
+    assignString(payload, "heartbeatTraceId", effectiveInput.heartbeatTraceId);
+    assignString(payload, "invocationIntent", effectiveInput.invocationIntent);
+    assignString(payload, "receiptIntent", effectiveInput.receiptIntent);
     const includeFailures = cleanBoolean(effectiveInput.includeFailures);
     if (includeFailures !== undefined) {
         payload.includeFailures = includeFailures;
@@ -69,6 +127,25 @@ function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
         body: payload,
     };
 }
+function buildGetCampaignContextRequest(input) {
+    const payload = {};
+    assignNumber(payload, "campaign", input.campaign);
+    assignString(payload, "purpose", input.purpose);
+    assignString(payload, "purposePrompt", input.purposePrompt);
+    assignString(payload, "lane", input.lane);
+    assignString(payload, "status", input.status);
+    assignString(payload, "principalId", input.principalId);
+    assignString(payload, "workspaceId", input.workspaceId);
+    assignNumber(payload, "worktreeLimit", input.worktreeLimit);
+    assignNumber(payload, "sourceSpanLimit", input.sourceSpanLimit);
+    assignNumber(payload, "scanLimit", input.scanLimit);
+    assignNumber(payload, "tokenBudget", input.tokenBudget);
+    return {
+        path: "/api/platform/v1/context/campaign",
+        method: "POST",
+        body: payload,
+    };
+}
 /**
  * Create the context client for compiling reasoning context packs.
  * @param config - Gateway transport configuration.
@@ -97,6 +174,13 @@ export function createContextClient(config = {}) {
                 body: request.body,
             });
         },
+        async getCampaignContext(input) {
+            const request = buildGetCampaignContextRequest(input);
+            return gateway.request({
+                ...request,
+                body: request.body,
+            });
+        },
     };
 }
 //# sourceMappingURL=contextClient.js.map

package/dist/contextTypes.d.ts

@@ -1,5 +1,9 @@
+import type { PublicCompiledContext as ContractPublicCompiledContext } from "./contracts/context-pack.contract";
 export type ContextRankingProfile = "baseline_v1" | "hybrid_v1" | "weighted_v1";
 export type ContextCompilationMode = "standard" | "delta";
+export type ContextTraversalMode = "anchored_ranked" | "bounded_exploration" | "contradiction_scan" | "pattern_recall" | "forensic_replay";
+export type ContextRequestedDepth = "low" | "medium" | "high" | "extra-high";
+export type ContextHeartbeatIntent = "pre_write" | "pre_closeout" | "research_loop" | "status_check";
 export type ContextPackSectionKey = "invariants" | "activeBeliefs" | "openQuestions" | "recentEvidence" | "contradictions";
 export type RankingWeightVector = {
     query: number;
@@ -17,6 +21,18 @@ export type CompileContextInput = {
     /** Optional explicit topic. Omit to resolve by query. */
     topicId?: string;
     query?: string;
+    purpose?: CampaignContextPurpose;
+    purposePrompt?: string;
+    topicHint?: string;
+    tags?: string[];
+    touchedPaths?: string[];
+    sourceRef?: string;
+    sourceKind?: string;
+    campaign?: number;
+    lane?: string;
+    status?: string;
+    principalId?: string;
+    workspaceId?: string;
     budget?: number;
     ranking?: ContextRankingProfile;
     limit?: number;
@@ -26,6 +42,12 @@ export type CompileContextInput = {
     includeFailures?: boolean;
     worktreeId?: string;
     sessionId?: string;
+    heartbeat?: boolean;
+    heartbeatIntent?: ContextHeartbeatIntent;
+    heartbeatBudgetMs?: number;
+    heartbeatTraceId?: string;
+    invocationIntent?: string;
+    receiptIntent?: string;
     packWeightOverrides?: PackWeightOverride[];
     tokenBudget?: number;
     rankingProfile?: ContextRankingProfile;
@@ -36,6 +58,22 @@ export type CompileContextInput = {
      * enrichment in the returned pack.
      */
     contentTopicLimit?: number;
+    traversalMode?: ContextTraversalMode;
+    requestedDepth?: ContextRequestedDepth;
+};
+export type CampaignContextPurpose = "campaign_status" | "avatar_tree_foundation" | "clean_prod_reset" | "graph_v2_readiness" | "custom";
+export type GetCampaignContextInput = {
+    campaign: number;
+    purpose?: CampaignContextPurpose;
+    purposePrompt?: string;
+    lane?: string;
+    status?: string;
+    principalId?: string;
+    workspaceId?: string;
+    worktreeLimit?: number;
+    sourceSpanLimit?: number;
+    scanLimit?: number;
+    tokenBudget?: number;
 };
 export type PublicContextBelief = {
     beliefId: string;
@@ -100,6 +138,76 @@ export type PublicContextNarrativeBlock = {
     kind: string;
     text: string;
     recordsNamed?: number;
+    narrativeId?: string;
+    narrative_id?: string;
+    scope?: Record<string, unknown>;
+    childNarratives?: Array<{
+        narrativeId: string;
+        narrative_id?: string;
+        scope: Record<string, unknown>;
+        title: string;
+        summary: string;
+        recordsNamed?: number;
+    }>;
+};
+export type PublicContextNarrativeCoverage = {
+    recordsSynthesized?: number;
+    recordsNamed?: number;
+    recordsOmitted?: number;
+    topicsSynthesized?: number;
+    topicsEnriched?: number;
+    topicContentOmitted?: number;
+    enrichmentMode?: string;
+    blocksEmitted?: number;
+    [key: string]: unknown;
+};
+export type PublicContextSynthesisLint = {
+    code?: string;
+    severity?: string;
+    message?: string;
+    path?: string[];
+    [key: string]: unknown;
+};
+export type PublicContextRetrievalReceipt = {
+    candidateCounts?: Record<string, number>;
+    coverageWarning?: string | null;
+    narrativeCoverage?: PublicContextNarrativeCoverage;
+    synthesisLints?: PublicContextSynthesisLint[];
+    heartbeatReceipt?: PublicContextHeartbeatReceipt;
+    suggestedNextActions?: string[];
+    [key: string]: unknown;
+};
+export type PublicContextHeartbeatReceipt = {
+    schemaVersion: "compile_context_heartbeat.v1";
+    intent: string;
+    sessionId?: string;
+    traceId?: string;
+    startedAt?: number;
+    completedAt?: number;
+    measuredDurationMs: number;
+    requestedBudgetMs: number;
+    cachedP50BudgetMs: number;
+    synthesizedP50BudgetMs: number;
+    hardTimeoutMs?: number;
+    budgetStatus: "within_budget" | "over_budget" | string;
+    traceMetric: "context_before_write" | string;
+    contextBeforeWrite: boolean;
+    preWriteReady: boolean;
+    lintsBlockingPreWrite?: number;
+    coverageWarning?: boolean;
+    [key: string]: unknown;
+};
+export type PublicContextAssemblyReceipt = {
+    receiptVersion?: string;
+    receiptUuid?: string;
+    traceId?: string;
+    included?: Array<Record<string, unknown>>;
+    omitted?: Array<Record<string, unknown>>;
+    rankingInputs?: Record<string, unknown>;
+    policyClipping?: Record<string, unknown>;
+    synthesisLints?: PublicContextSynthesisLint[];
+    axiomTelemetry?: Record<string, unknown>;
+    [key: string]: unknown;
 };
 export type PublicContextSupportingObjects = {
     invariants?: PublicContextBelief[];
@@ -112,53 +220,35 @@ export type PublicContextSupportingObjects = {
     lanes?: string[];
     entities?: unknown[];
 };
-export type PublicCompiledContext = {
+export type PublicCompiledContext = ContractPublicCompiledContext & {
+    narrativeIndex?: Record<string, unknown>;
+};
+export type PublicCampaignContextPayload = {
+    mission?: Record<string, unknown>;
+    laneOrder?: Array<Record<string, unknown>>;
+    blockers?: Array<Record<string, unknown>>;
+    risks?: Array<Record<string, unknown>>;
+    openQuestions?: Array<Record<string, unknown>>;
+    evidencePosture?: Record<string, unknown>;
+    sourceSpans?: Array<Record<string, unknown>>;
+    purposeNarrative?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+export type PublicCampaignContext = {
     contextNarrative: Array<string | PublicContextNarrativeBlock>;
-    narrativeCoverage?: Record<string, unknown>;
-    synthesisLints?: Array<Record<string, unknown>>;
-    retrievalReceipt?: Record<string, unknown>;
-    assemblyReceipt?: Record<string, unknown>;
-    supportingObjects?: PublicContextSupportingObjects;
-    schemaVersion: string;
-    topicId: string;
-    topicName: string;
-    scopedTopicIds: string[];
+    campaignContext: PublicCampaignContextPayload;
+    purposeNarrative?: Record<string, unknown>;
+    narrativeCoverage?: PublicContextNarrativeCoverage;
+    synthesisLints?: PublicContextSynthesisLint[];
+    retrievalReceipt?: PublicContextRetrievalReceipt;
+    synthesisReceipt?: Record<string, unknown>;
+    supportingObjects?: PublicContextSupportingObjects & {
+        sourceSpans?: Array<Record<string, unknown>>;
+    };
+    schemaVersion: "campaign_context.v1" | string;
+    campaign: number;
     generatedAt: number;
-    ranking: ContextRankingProfile;
     summary: Record<string, unknown>;
-    invariants?: PublicContextBelief[];
-    activeBeliefs?: PublicContextBelief[];
-    openQuestions?: PublicContextQuestion[];
-    recentEvidence?: PublicContextEvidence[];
-    contradictions?: PublicContextContradiction[];
-    relatedEntities?: PublicContextEntity[];
-    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[];
 };
 //# sourceMappingURL=contextTypes.d.ts.map

package/dist/contracts/context-pack.contract.d.ts

@@ -13,6 +13,7 @@
  *   - Changing section budget ratios or ranking weights is NON-breaking (tuning)
  *   - Changing the version string is BREAKING (consumers check it)
  */
+import type { SynthesisQualityLint } from "@lucern/contracts";
 /** Canonical version string. Consumers MUST check this field for compatibility. */
 export declare const CONTEXT_PACK_SCHEMA_VERSION: "1.0.0";
 /**
@@ -353,6 +354,17 @@ export type PublicContextNarrativeBlock = {
     kind: string;
     text: string;
     recordsNamed?: number;
+    narrativeId?: string;
+    narrative_id?: string;
+    scope?: Record<string, unknown>;
+    childNarratives?: Array<{
+        narrativeId: string;
+        narrative_id?: string;
+        scope: Record<string, unknown>;
+        title: string;
+        summary: string;
+        recordsNamed?: number;
+    }>;
 };
 export type PublicContextSupportingObjects = {
     invariants?: PublicContextBelief[];
@@ -368,7 +380,7 @@ export type PublicContextSupportingObjects = {
 export type PublicCompiledContext = {
     contextNarrative: Array<string | PublicContextNarrativeBlock>;
     narrativeCoverage?: Record<string, unknown>;
-    synthesisLints?: Array<Record<string, unknown>>;
+    synthesisLints?: SynthesisQualityLint[];
     retrievalReceipt?: Record<string, unknown>;
     assemblyReceipt?: Record<string, unknown>;
     supportingObjects?: PublicContextSupportingObjects;
@@ -453,7 +465,7 @@ export type ContextPackV1 = {
      */
     relatedEntities?: ContextPackEntity[];
     /** Concise instructions for agent context injection. */
-    contextNarrative: string[];
+    contextNarrative: Array<string | PublicContextNarrativeBlock>;
     /** Token-budgeted injection selections. */
     injectionPolicy: ContextPackInjectionPolicy;
     /** Assembly telemetry. */

package/dist/facade/context.d.ts

@@ -1,6 +1,6 @@
-import type { CompileContextInput, PublicCompiledContext } from "../contextTypes";
+import type { CompileContextInput, GetCampaignContextInput, PublicCampaignContext, PublicCompiledContext } from "../contextTypes";
 export type ContextClientRequest = {
-    path: "/api/platform/v1/context/compile";
+    path: "/api/platform/v1/context/compile" | "/api/platform/v1/context/campaign";
     method: "POST";
     body: Record<string, unknown>;
 };
@@ -13,6 +13,7 @@ export type ContextFacadeConfig = {
 export declare function createContextFacade(config: ContextFacadeConfig): {
     compile(topicIdOrInput?: string | CompileContextInput, input?: CompileContextInput): Promise<PublicCompiledContext>;
     compileByQuery(input?: CompileContextInput): Promise<PublicCompiledContext>;
+    getCampaignContext(input: GetCampaignContextInput): Promise<PublicCampaignContext>;
 };
-export type { CompileContextInput, PublicCompiledContext };
+export type { CampaignContextPurpose, CompileContextInput, ContextHeartbeatIntent, GetCampaignContextInput, PublicContextHeartbeatReceipt, PublicCampaignContext, PublicCompiledContext, } from "../contextTypes";
 //# sourceMappingURL=context.d.ts.map

package/dist/facade/context.js

@@ -9,6 +9,27 @@ function cleanNumber(value) {
 function cleanBoolean(value) {
     return typeof value === "boolean" ? value : undefined;
 }
+function cleanStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const cleaned = value
+        .map((item) => cleanString(item))
+        .filter((item) => Boolean(item));
+    return cleaned.length > 0 ? cleaned : undefined;
+}
+function assignString(payload, key, value) {
+    const cleaned = cleanString(value);
+    if (cleaned) {
+        payload[key] = cleaned;
+    }
+}
+function assignNumber(payload, key, value) {
+    const cleaned = cleanNumber(value);
+    if (cleaned !== undefined) {
+        payload[key] = cleaned;
+    }
+}
 function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
     const effectiveInput = typeof topicIdOrInput === "string" ? input : topicIdOrInput;
     const payload = {};
@@ -22,10 +43,35 @@ function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
     if (query) {
         payload.query = query;
     }
-    const budget = cleanNumber(effectiveInput.budget) ?? cleanNumber(effectiveInput.tokenBudget);
+    assignString(payload, "purpose", effectiveInput.purpose);
+    assignString(payload, "purposePrompt", effectiveInput.purposePrompt);
+    assignString(payload, "topicHint", effectiveInput.topicHint);
+    const tags = cleanStringArray(effectiveInput.tags);
+    if (tags) {
+        payload.tags = tags;
+    }
+    const touchedPaths = cleanStringArray(effectiveInput.touchedPaths);
+    if (touchedPaths) {
+        payload.touchedPaths = touchedPaths;
+    }
+    assignString(payload, "sourceRef", effectiveInput.sourceRef);
+    assignString(payload, "sourceKind", effectiveInput.sourceKind);
+    assignNumber(payload, "campaign", effectiveInput.campaign);
+    assignString(payload, "lane", effectiveInput.lane);
+    assignString(payload, "status", effectiveInput.status);
+    assignString(payload, "principalId", effectiveInput.principalId);
+    assignString(payload, "workspaceId", effectiveInput.workspaceId);
+    const budget = cleanNumber(effectiveInput.budget);
     if (budget !== undefined) {
         payload.budget = budget;
     }
+    const tokenBudget = cleanNumber(effectiveInput.tokenBudget);
+    if (tokenBudget !== undefined) {
+        payload.tokenBudget = tokenBudget;
+        if (budget === undefined) {
+            payload.budget = tokenBudget;
+        }
+    }
     const ranking = cleanString(effectiveInput.ranking) ?? cleanString(effectiveInput.rankingProfile);
     if (ranking) {
         payload.ranking = ranking;
@@ -34,6 +80,7 @@ function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
     if (limit !== undefined) {
         payload.limit = limit;
     }
+    assignNumber(payload, "contentTopicLimit", effectiveInput.contentTopicLimit);
     const maxDepth = cleanNumber(effectiveInput.maxDepth);
     if (maxDepth !== undefined) {
         payload.maxDepth = maxDepth;
@@ -46,6 +93,17 @@ function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
     if (mode) {
         payload.mode = mode;
     }
+    assignString(payload, "traversalMode", effectiveInput.traversalMode);
+    assignString(payload, "requestedDepth", effectiveInput.requestedDepth);
+    const heartbeat = cleanBoolean(effectiveInput.heartbeat);
+    if (heartbeat !== undefined) {
+        payload.heartbeat = heartbeat;
+    }
+    assignString(payload, "heartbeatIntent", effectiveInput.heartbeatIntent);
+    assignNumber(payload, "heartbeatBudgetMs", effectiveInput.heartbeatBudgetMs);
+    assignString(payload, "heartbeatTraceId", effectiveInput.heartbeatTraceId);
+    assignString(payload, "invocationIntent", effectiveInput.invocationIntent);
+    assignString(payload, "receiptIntent", effectiveInput.receiptIntent);
     const includeFailures = cleanBoolean(effectiveInput.includeFailures);
     if (includeFailures !== undefined) {
         payload.includeFailures = includeFailures;
@@ -68,6 +126,25 @@ function buildCompileContextRequest(topicIdOrInput = {}, input = {}) {
         body: payload,
     };
 }
+function buildGetCampaignContextRequest(input) {
+    const payload = {};
+    assignNumber(payload, "campaign", input.campaign);
+    assignString(payload, "purpose", input.purpose);
+    assignString(payload, "purposePrompt", input.purposePrompt);
+    assignString(payload, "lane", input.lane);
+    assignString(payload, "status", input.status);
+    assignString(payload, "principalId", input.principalId);
+    assignString(payload, "workspaceId", input.workspaceId);
+    assignNumber(payload, "worktreeLimit", input.worktreeLimit);
+    assignNumber(payload, "sourceSpanLimit", input.sourceSpanLimit);
+    assignNumber(payload, "scanLimit", input.scanLimit);
+    assignNumber(payload, "tokenBudget", input.tokenBudget);
+    return {
+        path: "/api/platform/v1/context/campaign",
+        method: "POST",
+        body: payload,
+    };
+}
 export function createContextFacade(config) {
     return {
         compile(topicIdOrInput = {}, input = {}) {
@@ -78,6 +155,10 @@ export function createContextFacade(config) {
             const request = buildCompileContextRequest(input);
             return config.transport.request(request);
         },
+        getCampaignContext(input) {
+            const request = buildGetCampaignContextRequest(input);
+            return config.transport.request(request);
+        },
     };
 }
 //# sourceMappingURL=context.js.map

package/dist/generated/functionSurface.d.ts

@@ -3,7 +3,7 @@ import type { JsonObject } from "../types";
 export type FunctionSurfaceClientConfig = GatewayClientConfig;
 export type FunctionSurfaceInput = JsonObject;
 export type FunctionSurfaceResult<T = unknown> = Promise<PlatformGatewaySuccess<T>>;
-export declare const FUNCTION_SURFACE_METHOD_PATHS: readonly ["answers.answerQuestion", "answers.createAnswer", "answers.getAnswer", "beliefs.appendSlScoring", "beliefs.archiveBelief", "beliefs.bisectConfidence", "beliefs.createBelief", "beliefs.forkBelief", "beliefs.getBelief", "beliefs.getConfidenceHistory", "beliefs.listBeliefs", "beliefs.refineBelief", "beliefs.searchBeliefs", "bootstrap.generateSessionHandoff", "coding.getChangeHistory", "coding.getCodeContext", "coding.getFailureLog", "coding.recordAttempt", "context.analyzeTopicDensity", "context.applyAutoBranching", "context.compileContext", "context.discover", "context.discoverEntityConnections", "context.getLatticeCoverage", "context.lucernOrient", "context.recordScopeLearning", "context.seedBeliefLattice", "context.triggerBeliefReview", "contracts.createEpistemicContract", "contracts.evaluateContract", "contracts.getContractStatus", "contradictions.flagContradiction", "controlPlane.identity.resolveInteractivePrincipal", "coordination.broadcastMessage", "coordination.claimFiles", "coordination.endSession", "coordination.getAgentInbox", "coordination.heartbeatSession", "coordination.listActiveSessions", "coordination.registerSession", "coordination.sendAgentMessage", "edges.batchCreateEdges", "edges.createEdge", "edges.queryAnchorHistory", "edges.queryLineage", "edges.removeEdge", "edges.removeEdgesBetween", "edges.updateEdge", "embeddings.getByNodeIds", "embeddings.listMissingForTopic", "embeddings.markEmbeddingBackfillQueued", "embeddings.vectorSearchByTopic", "evidence.addEvidence", "evidence.archiveEvidence", "evidence.createEvidence", "evidence.getEvidence", "evidence.linkEvidence", "evidence.linkEvidenceToBelief", "evidence.linkEvidenceToQuestion", "evidence.listEvidence", "evidence.searchEvidence", "graph.detectConfirmationBias", "graph.findContradictions", "graph.getGraphGaps", "graph.getGraphNeighborhood", "graph.getGraphStructureAnalysis", "graph.getTopicCoverage", "graph.traceEntityImpact", "graph.traverseGraph", "graphAnalysis.listGraphIntelligenceQueries", "graphAnalysis.runGraphIntelligenceQuery", "hybrid.analyzeGraphImpact", "hybrid.detectGraphDrift", "hybrid.expandGraphNeighborhood", "hybrid.findRelatedNodes", "hybrid.hybridDiscover", "hybrid.resolveTopicSemantic", "identity.checkPermission", "identity.filterByPermission", "identity.whoami", "judgments.getAuditTrail", "judgments.recordJudgment", "lenses.applyLensToTopic", "lenses.createLens", "lenses.listLenses", "lenses.removeLensFromTopic", "nodes.archiveEpistemicNode", "nodes.batchCreateEpistemicNodes", "nodes.createEpistemicNode", "nodes.getEpistemicNode", "nodes.listEpistemicNodes", "nodes.supersedeEpistemicNode", "nodes.updateEpistemicNode", "nodes.verifyEpistemicNode", "observations.getObservationContext", "observations.ingestObservation", "ontologies.applyOntology", "ontologies.archiveOntology", "ontologies.createOntology", "ontologies.createOntologyVersion", "ontologies.deprecateOntologyVersion", "ontologies.getOntology", "ontologies.listOntologies", "ontologies.matchEntityType", "ontologies.publishOntologyVersion", "ontologies.resolveEffectiveOntology", "ontologies.updateOntology", "policy.compileCapabilitySlice", "policy.manageWritePolicy", "questions.archiveQuestion", "questions.createQuestion", "questions.findMissingQuestions", "questions.getFalsificationQuestions", "questions.getHighPriorityQuestions", "questions.getQuestion", "questions.listQuestions", "questions.refineQuestion", "questions.updateQuestionStatus", "tasks.completeTask", "tasks.createTask", "tasks.listTasks", "tasks.updateTask", "topics.createTopic", "topics.getTopic", "topics.getTopicGraphSpine", "topics.getTopicTree", "topics.listTopics", "topics.materializeTopicGraph", "topics.updateTopic", "worktrees.activateWorktree", "worktrees.addWorktree", "worktrees.beginBuildSession", "worktrees.getWorktree", "worktrees.listAllWorktrees", "worktrees.listCampaigns", "worktrees.listWorktrees", "worktrees.listWorktreesByBelief", "worktrees.merge", "worktrees.openPullRequest", "worktrees.pipelineSnapshot", "worktrees.push", "worktrees.updateWorktreeMetadata", "worktrees.updateWorktreeTargets"];
+export declare const FUNCTION_SURFACE_METHOD_PATHS: readonly ["answers.answerQuestion", "answers.createAnswer", "answers.getAnswer", "beliefs.appendSlScoring", "beliefs.archiveBelief", "beliefs.bisectConfidence", "beliefs.createBelief", "beliefs.forkBelief", "beliefs.getBelief", "beliefs.getConfidenceHistory", "beliefs.listBeliefs", "beliefs.refineBelief", "beliefs.searchBeliefs", "bootstrap.generateSessionHandoff", "coding.getChangeHistory", "coding.getCodeContext", "coding.getFailureLog", "coding.recordAttempt", "context.analyzeTopicDensity", "context.applyAutoBranching", "context.compileContext", "context.discover", "context.discoverEntityConnections", "context.expandNarrative", "context.getCampaignContext", "context.getLatticeCoverage", "context.getLoadBearingNodes", "context.getOperatorGauntlet", "context.getReasoningExemplars", "context.lucernOrient", "context.recordScopeLearning", "context.seedBeliefLattice", "context.triggerBeliefReview", "contracts.createEpistemicContract", "contracts.evaluateContract", "contracts.getContractStatus", "contradictions.flagContradiction", "controlPlane.identity.resolveInteractivePrincipal", "coordination.broadcastMessage", "coordination.claimFiles", "coordination.endSession", "coordination.getAgentInbox", "coordination.heartbeatSession", "coordination.listActiveSessions", "coordination.registerSession", "coordination.sendAgentMessage", "edges.batchCreateEdges", "edges.createEdge", "edges.queryAnchorHistory", "edges.queryLineage", "edges.removeEdge", "edges.removeEdgesBetween", "edges.updateEdge", "embeddings.getByNodeIds", "embeddings.listMissingForTopic", "embeddings.markEmbeddingBackfillQueued", "embeddings.vectorSearchByTopic", "evidence.addEvidence", "evidence.archiveEvidence", "evidence.createEvidence", "evidence.getEvidence", "evidence.linkEvidence", "evidence.linkEvidenceToBelief", "evidence.linkEvidenceToQuestion", "evidence.listEvidence", "evidence.searchEvidence", "graph.detectConfirmationBias", "graph.findContradictions", "graph.getGraphGaps", "graph.getGraphNeighborhood", "graph.getGraphStructureAnalysis", "graph.getTopicCoverage", "graph.traceEntityImpact", "graph.traverseGraph", "graphAnalysis.listGraphIntelligenceQueries", "graphAnalysis.runGraphIntelligenceQuery", "hybrid.analyzeGraphImpact", "hybrid.detectGraphDrift", "hybrid.expandGraphNeighborhood", "hybrid.findRelatedNodes", "hybrid.hybridDiscover", "hybrid.resolveTopicSemantic", "identity.checkPermission", "identity.filterByPermission", "identity.whoami", "judgments.getAuditTrail", "judgments.recordJudgment", "lenses.applyLensToTopic", "lenses.createLens", "lenses.listLenses", "lenses.removeLensFromTopic", "nodes.archiveEpistemicNode", "nodes.batchCreateEpistemicNodes", "nodes.createEpistemicNode", "nodes.getEpistemicNode", "nodes.listEpistemicNodes", "nodes.supersedeEpistemicNode", "nodes.updateEpistemicNode", "nodes.verifyEpistemicNode", "observations.getObservationContext", "observations.ingestObservation", "ontologies.applyOntology", "ontologies.archiveOntology", "ontologies.createOntology", "ontologies.createOntologyVersion", "ontologies.deprecateOntologyVersion", "ontologies.getOntology", "ontologies.listOntologies", "ontologies.matchEntityType", "ontologies.publishOntologyVersion", "ontologies.resolveEffectiveOntology", "ontologies.updateOntology", "policy.compileCapabilitySlice", "policy.manageWritePolicy", "questions.archiveQuestion", "questions.createQuestion", "questions.findMissingQuestions", "questions.getFalsificationQuestions", "questions.getHighPriorityQuestions", "questions.getQuestion", "questions.listQuestions", "questions.refineQuestion", "questions.updateQuestionStatus", "tasks.completeTask", "tasks.createTask", "tasks.listTasks", "tasks.updateTask", "topics.createTopic", "topics.getTopic", "topics.getTopicGraphSpine", "topics.getTopicTree", "topics.listTopics", "topics.materializeTopicGraph", "topics.updateTopic", "worktrees.activateWorktree", "worktrees.addWorktree", "worktrees.beginBuildSession", "worktrees.getWorktree", "worktrees.listAllWorktrees", "worktrees.listCampaigns", "worktrees.listWorktrees", "worktrees.listWorktreesByBelief", "worktrees.merge", "worktrees.openPullRequest", "worktrees.pipelineSnapshot", "worktrees.push", "worktrees.updateWorktreeMetadata", "worktrees.updateWorktreeTargets"];
 export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClientConfig): {
     sessionId: string;
     activateWorktree(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
@@ -51,6 +51,7 @@ export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClie
     endSession(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     evaluateContract(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     expandGraphNeighborhood(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    expandNarrative(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     filterByPermission(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     findContradictions(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     findMissingQuestions(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
@@ -62,6 +63,7 @@ export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClie
     getAnswer(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getAuditTrail(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getBelief(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    getCampaignContext(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getChangeHistory(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getCodeContext(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getConfidenceHistory(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
@@ -76,9 +78,12 @@ export declare function createFunctionSurfaceClient(config?: FunctionSurfaceClie
     getGraphStructureAnalysis(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getHighPriorityQuestions(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getLatticeCoverage(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    getLoadBearingNodes(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getObservationContext(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getOntology(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    getOperatorGauntlet(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getQuestion(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
+    getReasoningExemplars(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getTopic(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getTopicCoverage(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;
     getTopicGraphSpine(input?: FunctionSurfaceInput, idempotencyKey?: string): FunctionSurfaceResult<unknown>;

package/dist/generated/functionSurface.js

@@ -24,7 +24,12 @@ export const FUNCTION_SURFACE_METHOD_PATHS = [
     "context.compileContext",
     "context.discover",
     "context.discoverEntityConnections",
+    "context.expandNarrative",
+    "context.getCampaignContext",
     "context.getLatticeCoverage",
+    "context.getLoadBearingNodes",
+    "context.getOperatorGauntlet",
+    "context.getReasoningExemplars",
     "context.lucernOrient",
     "context.recordScopeLearning",
     "context.seedBeliefLattice",
@@ -191,6 +196,7 @@ const CONTRACTS = {
     "end_session": { method: "POST", path: "/coordination/end-session", kind: "mutation", idempotent: true, surfaceIntent: "system" },
     "evaluate_contract": { method: "POST", path: "/contracts/evaluate", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
     "expand_graph_neighborhood": { method: "POST", path: "/hybrid/neighborhood", kind: "action", idempotent: false, surfaceIntent: "mcp_analysis" },
+    "expand_narrative": { method: "POST", path: "/context/narratives/expand", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "filter_by_permission": { method: "POST", path: "/identity/filter-by-permission", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "find_contradictions": { method: "POST", path: "/graph/contradictions", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
     "find_missing_questions": { method: "POST", path: "/questions/missing", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
@@ -202,6 +208,7 @@ const CONTRACTS = {
     "get_answer": { method: "GET", path: "/answers/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "get_audit_trail": { method: "POST", path: "/judgments/audit-trail", kind: "query", idempotent: false, surfaceIntent: "system" },
     "get_belief": { method: "GET", path: "/beliefs/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
+    "get_campaign_context": { method: "POST", path: "/context/campaign", kind: "action", idempotent: false, surfaceIntent: "mcp_core" },
     "get_change_history": { method: "POST", path: "/coding/change-history", kind: "query", idempotent: false, surfaceIntent: "system" },
     "get_code_context": { method: "POST", path: "/coding/context", kind: "query", idempotent: false, surfaceIntent: "system" },
     "get_confidence_history": { method: "POST", path: "/beliefs/confidence-history", kind: "query", idempotent: false, surfaceIntent: "compatibility" },
@@ -216,9 +223,12 @@ const CONTRACTS = {
     "get_graph_structure_analysis": { method: "POST", path: "/graph/structure-analysis", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
     "get_high_priority_questions": { method: "POST", path: "/questions/high-priority", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "get_lattice_coverage": { method: "POST", path: "/scope/belief-lattice/coverage", kind: "query", idempotent: false, surfaceIntent: "system" },
+    "get_load_bearing_nodes": { method: "POST", path: "/context/load-bearing-nodes", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "get_observation_context": { method: "POST", path: "/observations/context", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
     "get_ontology": { method: "GET", path: "/ontologies/get", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
+    "get_operator_gauntlet": { method: "POST", path: "/context/operator-gauntlet", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "get_question": { method: "GET", path: "/questions/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
+    "get_reasoning_exemplars": { method: "POST", path: "/context/reasoning-exemplars", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "get_topic": { method: "GET", path: "/topics/get", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
     "get_topic_coverage": { method: "POST", path: "/graph/topic-coverage", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
     "get_topic_graph_spine": { method: "GET", path: "/topics/graph-spine", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
@@ -470,6 +480,9 @@ export function createFunctionSurfaceClient(config = {}) {
         expandGraphNeighborhood(input = {}, idempotencyKey) {
             return execute("expand_graph_neighborhood", input, idempotencyKey);
         },
+        expandNarrative(input = {}, idempotencyKey) {
+            return execute("expand_narrative", input, idempotencyKey);
+        },
         filterByPermission(input = {}, idempotencyKey) {
             return execute("filter_by_permission", input, idempotencyKey);
         },
@@ -503,6 +516,9 @@ export function createFunctionSurfaceClient(config = {}) {
         getBelief(input = {}, idempotencyKey) {
             return execute("get_belief", input, idempotencyKey);
         },
+        getCampaignContext(input = {}, idempotencyKey) {
+            return execute("get_campaign_context", input, idempotencyKey);
+        },
         getChangeHistory(input = {}, idempotencyKey) {
             return execute("get_change_history", input, idempotencyKey);
         },
@@ -545,15 +561,24 @@ export function createFunctionSurfaceClient(config = {}) {
         getLatticeCoverage(input = {}, idempotencyKey) {
             return execute("get_lattice_coverage", input, idempotencyKey);
         },
+        getLoadBearingNodes(input = {}, idempotencyKey) {
+            return execute("get_load_bearing_nodes", input, idempotencyKey);
+        },
         getObservationContext(input = {}, idempotencyKey) {
             return execute("get_observation_context", input, idempotencyKey);
         },
         getOntology(input = {}, idempotencyKey) {
             return execute("get_ontology", input, idempotencyKey);
         },
+        getOperatorGauntlet(input = {}, idempotencyKey) {
+            return execute("get_operator_gauntlet", input, idempotencyKey);
+        },
         getQuestion(input = {}, idempotencyKey) {
             return execute("get_question", input, idempotencyKey);
         },
+        getReasoningExemplars(input = {}, idempotencyKey) {
+            return execute("get_reasoning_exemplars", input, idempotencyKey);
+        },
         getTopic(input = {}, idempotencyKey) {
             return execute("get_topic", input, idempotencyKey);
         },

package/dist/proof-attestation.json

@@ -41,5 +41,5 @@
     "convex-validators",
     "proof-attestation"
   ],
-  "signedAt": 1780730291153
+  "signedAt": 1781239176051
 }

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Current SDK package version. */
-export declare const LUCERN_SDK_VERSION = "1.0.21";
+export declare const LUCERN_SDK_VERSION = "1.0.23";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Current SDK package version. */
-export const LUCERN_SDK_VERSION = "1.0.21";
+export const LUCERN_SDK_VERSION = "1.0.23";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucern/sdk",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -113,10 +113,10 @@
     "typecheck": "tsc --project tsconfig.typecheck.json --noEmit"
   },
   "dependencies": {
-    "@lucern/contracts": "1.0.21",
-    "@lucern/reasoning-kernel": "1.0.21",
-    "@lucern/secrets": "1.0.21",
-    "@lucern/transport-core": "1.0.21",
+    "@lucern/contracts": "1.0.23",
+    "@lucern/reasoning-kernel": "1.0.23",
+    "@lucern/secrets": "1.0.23",
+    "@lucern/transport-core": "1.0.23",
     "effect": "^3.21.2",
     "zod": "^3.25.76"
   },