@lucern/sdk 0.3.0-alpha.0 → 0.3.0-alpha.1

package/dist/index.d.ts

@@ -3,8 +3,8 @@ export { AdminClientConfig, TenantApiKeyRecord, TenantAuthPolicyMode, TenantConf
 export { AnswersClientConfig, createAnswersClient } from './answersClient.js';
 export { AudienceGrantInput, AudienceGrantRevokeInput, AudienceRegistryInput, AudiencesClientConfig, createAudiencesClient } from './audiencesClient.js';
 export { AuditClientConfig, createAuditClient } from './auditClient.js';
-export { BatchUpdateBeliefCriticalityInput, BeliefsClientConfig, CreateBeliefInput, ForkBeliefInput, LinkBeliefsInput, ModulateConfidenceInput, ModulateConfidenceOpinionInput, ModulateConfidenceScalarInput, OpinionHistoryEntry, ReassignBeliefsTopicInput, RefineBeliefInput, UnlinkBeliefEvidenceInput, UpdateBeliefCriticalityInput, UpdateBeliefRationaleInput, UpdateBeliefStatusInput, createBeliefsClient, mapOpinionHistoryEntriesFromGatewayData } from './beliefsClient.js';
-export { d as FUNCTION_SURFACE_METHOD_PATHS, F as FunctionSurfaceClientConfig, a as FunctionSurfaceInput, b as FunctionSurfaceResult, L as LucernClientConfig, e as createFunctionSurfaceClient, c as createLucernClient } from './client-DAuKnDlx.js';
+export { BatchUpdateBeliefCriticalityInput, BeliefsClientConfig, CreateBeliefInput, ForkBeliefInput, LinkBeliefsInput, ModulateConfidenceInput, ModulateConfidenceOpinionInput, OpinionHistoryEntry, ReassignBeliefsTopicInput, RefineBeliefInput, UnlinkBeliefEvidenceInput, UpdateBeliefCriticalityInput, UpdateBeliefRationaleInput, UpdateBeliefStatusInput, createBeliefsClient, mapOpinionHistoryEntriesFromGatewayData } from './beliefsClient.js';
+export { d as FUNCTION_SURFACE_METHOD_PATHS, F as FunctionSurfaceClientConfig, a as FunctionSurfaceInput, b as FunctionSurfaceResult, L as LucernClientConfig, e as createFunctionSurfaceClient, c as createLucernClient } from './client-B6aWUUwp.js';
 export { ContextFacadeConfig, ContextFacadeTransport, createContextFacade } from './facade/context.js';
 export { CompileContextPackPlan, CompileContextPackPlanInput, CompileContextPackSnapshot, ContextPackTopicRow, compileContextPackFromSnapshot, planContextPackCompilation } from './contextPackCompiler.js';
 export { CONTROL_OBJECT_BLAST_RADII, CONTROL_OBJECT_EDIT_SURFACES, CONTROL_OBJECT_INHERITANCE_RULES, CONTROL_OBJECT_KINDS, CONTROL_OBJECT_OWNERSHIP_CONTRACT, CONTROL_OBJECT_OWNERSHIP_MATRIX, CONTROL_OBJECT_OWNERSHIP_ROWS, CONTROL_OBJECT_OWNER_SCOPES, ControlObjectBlastRadius, ControlObjectEditSurface, ControlObjectInheritanceRule, ControlObjectKind, ControlObjectOwnerScope, ControlObjectOwnershipCase, ControlObjectOwnershipContract, ControlObjectOwnershipMatrix, getControlObjectOwnershipCase, listControlObjectOwnershipCases } from './controlObjectOwnership.js';

package/dist/index.js

@@ -172,20 +172,20 @@ function clamp01(value) {
   }
   return Math.max(0, Math.min(1, value));
 }
-function vacuous(baseRate = 0.5) {
+function vacuous(baseRate) {
   return { b: 0, d: 0, u: 1, a: clamp01(baseRate) };
 }
-function dogmatic(probability, baseRate = 0.5) {
+function dogmatic(probability, baseRate) {
   const p = clamp01(probability);
   return { b: p, d: 1 - p, u: 0, a: clamp01(baseRate) };
 }
 function opinionFromBaseRate(probability) {
   return vacuous(clamp01(probability));
 }
-function opinionFromDogmatic(probability, baseRate = 0.5) {
+function opinionFromDogmatic(probability, baseRate) {
   return dogmatic(clamp01(probability), clamp01(baseRate));
 }
-function opinionFromProjected(probability, uncertainty, baseRate = 0.5) {
+function opinionFromProjected(probability, uncertainty, baseRate) {
   const p = clamp01(probability);
   const u = clamp01(uncertainty);
   const remainingMass = 1 - u;
@@ -1217,20 +1217,16 @@ function normalizeOpinionTuple(record) {
   const rawDisbelief = readNumber(opinion.d) ?? readNumber(record.disbelief);
   const rawUncertainty = readNumber(opinion.u) ?? readNumber(record.uncertainty);
   const rawBaseRate = readNumber(opinion.a) ?? readNumber(record.baseRate);
-  if (rawBelief === void 0 && rawDisbelief === void 0 && rawUncertainty === void 0) {
-    const projected = clamp012(readNumber(record.confidence) ?? 0);
-    return {
-      b: projected,
-      d: 1 - projected,
-      u: 0,
-      a: 0.5
-    };
+  if (rawBelief === void 0 || rawDisbelief === void 0 || rawUncertainty === void 0 || rawBaseRate === void 0) {
+    throw new Error(
+      "Gateway opinion history entries must include belief, disbelief, uncertainty, and baseRate."
+    );
   }
   return {
-    b: clamp012(rawBelief ?? 0),
-    d: clamp012(rawDisbelief ?? 0),
-    u: clamp012(rawUncertainty ?? 0),
-    a: clamp012(rawBaseRate ?? 0.5)
+    b: clamp012(rawBelief),
+    d: clamp012(rawDisbelief),
+    u: clamp012(rawUncertainty),
+    a: clamp012(rawBaseRate)
   };
 }
 function mapOpinionHistoryEntriesFromGatewayData(payload) {
@@ -1240,7 +1236,17 @@ function mapOpinionHistoryEntriesFromGatewayData(payload) {
     const tuple = normalizeOpinionTuple(record);
     const projected = readNumber(record.confidence) ?? clamp012(tuple.b + tuple.a * tuple.u);
     const triggeringEvidenceId = readString(record.triggeringEvidenceId);
+    const triggeringQuestionId = readString(record.triggeringQuestionId);
+    const triggeringAnswerId = readString(record.triggeringAnswerId);
+    const triggeringContradictionId = readString(
+      record.triggeringContradictionId
+    );
     const triggeringWorktreeId = readString(record.triggeringWorktreeId);
+    const triggeringRef = triggeringEvidenceId ? { kind: "evidence", id: triggeringEvidenceId } : triggeringQuestionId ? { kind: "question", id: triggeringQuestionId } : triggeringAnswerId ? { kind: "answer", id: triggeringAnswerId } : triggeringContradictionId ? { kind: "contradiction", id: triggeringContradictionId } : triggeringWorktreeId ? { kind: "worktree", id: triggeringWorktreeId } : void 0;
+    const trigger = readString(record.trigger);
+    if (!trigger) {
+      throw new Error("Gateway opinion history entries must include trigger.");
+    }
     return {
       t: readNumber(record.timestamp) ?? readNumber(record.assessedAt) ?? 0,
       b: tuple.b,
@@ -1248,18 +1254,8 @@ function mapOpinionHistoryEntriesFromGatewayData(payload) {
       u: tuple.u,
       a: tuple.a,
       P: clamp012(projected),
-      trigger: readString(record.trigger) ?? "manual",
-      ...triggeringEvidenceId ? {
-        triggeringRef: {
-          kind: "evidence",
-          id: triggeringEvidenceId
-        }
-      } : triggeringWorktreeId ? {
-        triggeringRef: {
-          kind: "worktree",
-          id: triggeringWorktreeId
-        }
-      } : {},
+      trigger,
+      ...triggeringRef ? { triggeringRef } : {},
       ...readString(record.rationale) ? { rationale: readString(record.rationale) } : {},
       ...readString(record.userId) ? { userId: readString(record.userId) } : {},
       ...readString(record.slOperator) ? { slOperator: readString(record.slOperator) } : {}
@@ -1267,11 +1263,7 @@ function mapOpinionHistoryEntriesFromGatewayData(payload) {
   }).sort((left, right) => left.t - right.t);
 }
 function normalizeModulateConfidenceInput(input) {
-  const opinion = "opinion" in input ? input.opinion : input.interpretation === "base_rate" ? opinionFromBaseRate(input.confidence) : input.interpretation === "dogmatic" ? opinionFromDogmatic(input.confidence, input.baseRate) : opinionFromProjected(
-    input.confidence,
-    input.uncertainty,
-    input.baseRate
-  );
+  const opinion = input.opinion;
   return {
     belief: opinion.b,
     disbelief: opinion.d,
@@ -1279,20 +1271,23 @@ function normalizeModulateConfidenceInput(input) {
     baseRate: opinion.a,
     trigger: input.trigger,
     rationale: input.rationale,
+    triggeringEvidenceId: input.triggeringEvidenceId,
+    triggeringQuestionId: input.triggeringQuestionId,
+    triggeringAnswerId: input.triggeringAnswerId,
+    triggeringContradictionId: input.triggeringContradictionId,
+    triggeringWorktreeId: input.triggeringWorktreeId,
     maxInlinePropagationTargets: input.maxInlinePropagationTargets
   };
 }
 function createBeliefsClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
-  function requireBaseRate2(value) {
+  function normalizeBaseRate(value) {
     const baseRate = readNumber(value);
-    if (baseRate === void 0) {
-      throw new Error("baseRate is required for belief creation.");
-    }
-    if (baseRate < 0 || baseRate > 1) {
+    const normalized = baseRate ?? 0.5;
+    if (normalized < 0 || normalized > 1) {
       throw new Error("baseRate must be within [0, 1].");
     }
-    return baseRate;
+    return normalized;
   }
   const modulateConfidence = async (beliefId, input, idempotencyKey) => gateway.request({
     path: `/api/platform/v1/beliefs/${encodeURIComponent(beliefId)}/confidence`,
@@ -1311,7 +1306,7 @@ function createBeliefsClient(config = {}) {
      * Create a belief within a topic scope.
      */
     async createBelief(input, idempotencyKey) {
-      const baseRate = requireBaseRate2(input.baseRate);
+      const baseRate = normalizeBaseRate(input.baseRate);
       return gateway.request({
         path: "/api/platform/v1/beliefs",
         method: "POST",
@@ -2407,11 +2402,7 @@ function createTopicsClient(config = {}) {
 
 // src/gatewayFacades.ts
 function normalizeBeliefConfidenceInput(input) {
-  const opinion = "opinion" in input ? input.opinion : input.interpretation === "base_rate" ? opinionFromBaseRate(input.confidence) : input.interpretation === "dogmatic" ? opinionFromDogmatic(input.confidence, input.baseRate) : opinionFromProjected(
-    input.confidence,
-    input.uncertainty,
-    input.baseRate
-  );
+  const opinion = input.opinion;
   return {
     belief: opinion.b,
     disbelief: opinion.d,
@@ -2419,6 +2410,11 @@ function normalizeBeliefConfidenceInput(input) {
     baseRate: opinion.a,
     trigger: input.trigger,
     rationale: input.rationale,
+    triggeringEvidenceId: input.triggeringEvidenceId,
+    triggeringQuestionId: input.triggeringQuestionId,
+    triggeringAnswerId: input.triggeringAnswerId,
+    triggeringContradictionId: input.triggeringContradictionId,
+    triggeringWorktreeId: input.triggeringWorktreeId,
     maxInlinePropagationTargets: input.maxInlinePropagationTargets
   };
 }
@@ -3158,6 +3154,18 @@ function createWorktreesFacade(config = {}) {
     async list(query) {
       return gateway.request({
         path: `/api/platform/v1/worktrees${toQueryString({
+          topicId: query.topicId,
+          status: query.status,
+          groupBy: query.groupBy,
+          lane: query.lane,
+          campaign: query.campaign,
+          limit: query.limit
+        })}`
+      });
+    },
+    async listCampaigns(query = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/worktrees/campaigns${toQueryString({
           topicId: query.topicId,
           status: query.status,
           limit: query.limit
@@ -3180,10 +3188,10 @@ function createWorktreesFacade(config = {}) {
           objective: input.objective,
           hypothesis: input.hypothesis,
           rationale: input.rationale,
-          track: input.track,
-          trackPosition: input.trackPosition,
-          executionBand: input.executionBand,
-          executionOrder: input.executionOrder,
+          campaign: input.campaign,
+          lane: input.lane,
+          laneOrderInCampaign: input.laneOrderInCampaign,
+          orderInLane: input.orderInLane,
           dependsOn: input.dependsOn,
           blocks: input.blocks,
           gate: input.gate,
@@ -3879,6 +3887,7 @@ var FUNCTION_SURFACE_METHOD_PATHS = [
   "worktrees.activateWorktree",
   "worktrees.addWorktree",
   "worktrees.listAllWorktrees",
+  "worktrees.listCampaigns",
   "worktrees.listWorktrees",
   "worktrees.merge",
   "worktrees.openPullRequest",
@@ -3959,6 +3968,7 @@ var CONTRACTS = {
   "list_active_sessions": { method: "POST", path: "/coordination/active-sessions", kind: "query", idempotent: false, surfaceIntent: "system" },
   "list_all_worktrees": { method: "GET", path: "/worktrees/all", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
   "list_beliefs": { method: "GET", path: "/beliefs", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
+  "list_campaigns": { method: "GET", path: "/worktrees/campaigns", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
   "list_evidence": { method: "GET", path: "/evidence", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "list_lenses": { method: "GET", path: "/lenses", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
   "list_ontologies": { method: "GET", path: "/ontologies", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
@@ -4249,6 +4259,9 @@ function createFunctionSurfaceClient(config = {}) {
     listBeliefs(input = {}, idempotencyKey) {
       return execute("list_beliefs", input, idempotencyKey);
     },
+    listCampaigns(input = {}, idempotencyKey) {
+      return execute("list_campaigns", input, idempotencyKey);
+    },
     listEvidence(input = {}, idempotencyKey) {
       return execute("list_evidence", input, idempotencyKey);
     },
@@ -5060,10 +5073,11 @@ function createWorkflowClient(config = {}) {
     async listWorktrees(query) {
       const normalized = normalizeTopicQuery(query);
       return gateway.request({
-        path: `/api/platform/v1/worktrees${toQueryString({
+        path: `/api/platform/v1/worktrees/all${toQueryString({
           ...normalized,
-          track: query.track,
-          executionBand: query.executionBand
+          groupBy: query.groupBy,
+          lane: query.lane,
+          campaign: query.campaign
         })}`
       }).then(
         (response) => mapGatewayData(
@@ -5082,8 +5096,9 @@ function createWorkflowClient(config = {}) {
       return gateway.request({
         path: `/api/platform/v1/worktrees${toQueryString({
           status: query.status,
-          track: query.track,
-          executionBand: query.executionBand,
+          groupBy: query.groupBy,
+          lane: query.lane,
+          campaign: query.campaign,
           limit: query.limit
         })}`
       }).then(
@@ -5095,12 +5110,22 @@ function createWorkflowClient(config = {}) {
           );
           return {
             ...list,
-            ...record.tracks && typeof record.tracks === "object" && !Array.isArray(record.tracks) ? { tracks: record.tracks } : {},
-            ...record.bands && typeof record.bands === "object" && !Array.isArray(record.bands) ? { bands: record.bands } : {}
+            ...record.lanes && typeof record.lanes === "object" && !Array.isArray(record.lanes) ? { lanes: record.lanes } : {},
+            ...record.campaigns && typeof record.campaigns === "object" && !Array.isArray(record.campaigns) ? { campaigns: record.campaigns } : {}
           };
         })
       );
     },
+    /**
+     * List compact pipeline campaigns with nested lanes.
+     */
+    async listCampaigns(query = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/worktrees/campaigns${toQueryString(
+          normalizeTopicQuery(query)
+        )}`
+      });
+    },
     /**
      * Create a workflow worktree.
      */
@@ -5426,13 +5451,11 @@ function requireText(args) {
   return text;
 }
 function requireBaseRate(args) {
-  if (typeof args.baseRate !== "number" || !Number.isFinite(args.baseRate)) {
-    throw new Error("baseRate is required.");
-  }
-  if (args.baseRate < 0 || args.baseRate > 1) {
+  const baseRate = typeof args.baseRate === "number" && Number.isFinite(args.baseRate) ? args.baseRate : 0.5;
+  if (baseRate < 0 || baseRate > 1) {
     throw new Error("baseRate must be within [0, 1].");
   }
-  return args.baseRate;
+  return baseRate;
 }
 function exposeGatewayData(response) {
   return Object.assign({}, response, response.data);
@@ -5550,9 +5573,13 @@ function createLucernClient(config = {}) {
     if (!text) {
       throw new Error("text is required");
     }
+    const rationale = args.rationale ?? args.supports?.reasoning;
+    if (!rationale) {
+      throw new Error("rationale is required");
+    }
     const metadata = {
       ...args.metadata ?? {},
-      ...args.supports?.reasoning ? { rationale: args.supports.reasoning } : {}
+      rationale
     };
     return evidenceFacade.create({
       topicId: resolveTopicId(args),
@@ -5560,6 +5587,7 @@ function createLucernClient(config = {}) {
       source: args.source ?? args.sourceUrl,
       targetId: args.targetId ?? args.supports?.nodeId,
       weight: args.weight ?? args.supports?.weight,
+      rationale,
       metadata: Object.keys(metadata).length > 0 ? metadata : void 0,
       title: args.title,
       content: args.content,
@@ -6390,7 +6418,10 @@ function createLucernClient(config = {}) {
           beliefIds: input.beliefIds,
           autoShape: input.autoShape,
           domainPackId: input.domainPackId,
-          executionOrder: input.executionOrder,
+          campaign: input.campaign,
+          lane: input.lane,
+          laneOrderInCampaign: input.laneOrderInCampaign,
+          orderInLane: input.orderInLane,
           dependsOn: input.dependsOn,
           blocks: input.blocks,
           gate: input.gate,
@@ -6409,7 +6440,10 @@ function createLucernClient(config = {}) {
           beliefIds: input.beliefIds,
           autoShape: input.autoShape,
           domainPackId: input.domainPackId,
-          executionOrder: input.executionOrder,
+          campaign: input.campaign,
+          lane: input.lane,
+          laneOrderInCampaign: input.laneOrderInCampaign,
+          orderInLane: input.orderInLane,
           dependsOn: input.dependsOn,
           blocks: input.blocks,
           gate: input.gate,
@@ -6437,10 +6471,10 @@ function createLucernClient(config = {}) {
         return worktreesFacade.update({
           id: typeof input.worktreeId === "string" ? input.worktreeId : "",
           hypothesis: typeof input.hypothesis === "string" ? input.hypothesis : void 0,
-          track: typeof input.track === "string" ? input.track : void 0,
-          trackPosition: typeof input.trackPosition === "number" ? input.trackPosition : void 0,
-          executionBand: typeof input.executionBand === "number" ? input.executionBand : void 0,
-          executionOrder: typeof input.executionOrder === "number" ? input.executionOrder : void 0,
+          campaign: typeof input.campaign === "number" ? input.campaign : void 0,
+          lane: typeof input.lane === "string" ? input.lane : void 0,
+          laneOrderInCampaign: typeof input.laneOrderInCampaign === "number" ? input.laneOrderInCampaign : void 0,
+          orderInLane: typeof input.orderInLane === "number" ? input.orderInLane : void 0,
           dependsOn,
           blocks,
           gate: typeof input.gate === "string" ? input.gate : void 0
@@ -8730,7 +8764,7 @@ var CANONICAL_WORKFLOW_DEFINITIONS = [
         actionId: "run_integrity_checks",
         kind: "integrity_check",
         title: "Run integrity checks",
-        description: "Evaluate dependency references, blockers, execution bands, shaping coverage, and completed gates.",
+        description: "Evaluate dependency references, blockers, campaign/lane placement, shaping coverage, and completed gates.",
         mutationTier: "read_only",
         produces: ["structured_payload"],
         idempotent: true,