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

package/dist/lenses/index.d.ts

@@ -1,4 +1,4 @@
-import { L as LucernClientConfig, a as FunctionSurfaceInput, b as FunctionSurfaceResult } from '../client-DAuKnDlx.js';
+import { L as LucernClientConfig, a as FunctionSurfaceInput, b as FunctionSurfaceResult } from '../client-B6aWUUwp.js';
 import { PlatformGatewaySuccess } from '../coreClient.js';
 import { JsonObject, TopicIdentifierInput, WorkflowLensRecord, ListResult, WorkflowLensBindingRecord, WorkflowBranchRecord, WorkflowWorktreeRecord, ListWorktreesResponse, PushWorktreeResponse, OpenPullRequestResponse } from '../types.js';
 import { LensPromptTemplateReference, LensWorkflowTemplate, LensTaskTemplate } from '../contracts/lens-workflow.contract.js';
@@ -108,8 +108,9 @@ declare function createLensesClient(config?: LensesClientConfig): {
             topicId?: string;
             branchId?: string;
             status?: WorkflowWorktreeStatus;
-            track?: string;
-            executionBand?: number;
+            groupBy?: "campaign" | "lane" | "flat";
+            lane?: string;
+            campaign?: number;
             limit?: number;
         } & TopicIdentifierInput) => Promise<PlatformGatewaySuccess<ListResult<WorkflowWorktreeRecord, "worktrees">>>>[0]): Promise<PlatformGatewaySuccess<{
             [x: string]: unknown;
@@ -135,8 +136,9 @@ declare function createLensesClient(config?: LensesClientConfig): {
         }>>;
         listAll(query?: Parameters<(query?: {
             status?: WorkflowWorktreeStatus;
-            track?: string;
-            executionBand?: number;
+            groupBy?: "campaign" | "lane" | "flat";
+            lane?: string;
+            campaign?: number;
             limit?: number;
         }) => Promise<PlatformGatewaySuccess<ListWorktreesResponse>>>[0]): Promise<PlatformGatewaySuccess<ListWorktreesResponse>>;
         merge(worktreeId: string, input: MergeInput): Promise<PlatformGatewaySuccess<{

package/dist/lenses/index.js

@@ -1003,38 +1003,6 @@ function createAuditClient(config = {}) {
   };
 }
 
-// src/opinion.ts
-function clamp01(value) {
-  if (!Number.isFinite(value)) {
-    return 0;
-  }
-  return Math.max(0, Math.min(1, value));
-}
-function vacuous(baseRate = 0.5) {
-  return { b: 0, d: 0, u: 1, a: clamp01(baseRate) };
-}
-function dogmatic(probability, baseRate = 0.5) {
-  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) {
-  return dogmatic(clamp01(probability), clamp01(baseRate));
-}
-function opinionFromProjected(probability, uncertainty, baseRate = 0.5) {
-  const p = clamp01(probability);
-  const u = clamp01(uncertainty);
-  const remainingMass = 1 - u;
-  return {
-    b: p * remainingMass,
-    d: (1 - p) * remainingMass,
-    u,
-    a: clamp01(baseRate)
-  };
-}
-
 // src/beliefsClient.ts
 function asRecord2(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
@@ -1049,7 +1017,7 @@ function readString(value) {
 function readNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
-function clamp012(value) {
+function clamp01(value) {
   return Math.max(0, Math.min(1, value));
 }
 function normalizeOpinionTuple(record) {
@@ -1058,20 +1026,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: clamp01(rawBelief),
+    d: clamp01(rawDisbelief),
+    u: clamp01(rawUncertainty),
+    a: clamp01(rawBaseRate)
   };
 }
 function mapOpinionHistoryEntriesFromGatewayData(payload) {
@@ -1079,28 +1043,28 @@ function mapOpinionHistoryEntriesFromGatewayData(payload) {
   return entries.map((value) => {
     const record = asRecord2(value);
     const tuple = normalizeOpinionTuple(record);
-    const projected = readNumber(record.confidence) ?? clamp012(tuple.b + tuple.a * tuple.u);
+    const projected = readNumber(record.confidence) ?? clamp01(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,
       d: tuple.d,
       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
-        }
-      } : {},
+      P: clamp01(projected),
+      trigger,
+      ...triggeringRef ? { triggeringRef } : {},
       ...readString(record.rationale) ? { rationale: readString(record.rationale) } : {},
       ...readString(record.userId) ? { userId: readString(record.userId) } : {},
       ...readString(record.slOperator) ? { slOperator: readString(record.slOperator) } : {}
@@ -1108,11 +1072,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,
@@ -1120,20 +1080,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`,
@@ -1152,7 +1115,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",
@@ -2248,11 +2211,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,
@@ -2260,6 +2219,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
   };
 }
@@ -2999,6 +2963,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
@@ -3021,10 +2997,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,
@@ -3690,6 +3666,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" },
@@ -3980,6 +3957,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);
     },
@@ -4791,10 +4771,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(
@@ -4813,8 +4794,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(
@@ -4826,12 +4808,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.
      */
@@ -5157,13 +5149,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);
@@ -5281,9 +5271,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),
@@ -5291,6 +5285,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,
@@ -6121,7 +6116,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,
@@ -6140,7 +6138,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,
@@ -6168,10 +6169,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