@lucern/sdk 0.3.0-alpha.3 → 0.3.0-alpha.5

package/dist/client.js

@@ -85,14 +85,15 @@ function normalizeCanonicalLucernAuthContext(input) {
   );
   const roles = cleanStringList(input.roles);
   const scopes = cleanStringList(input.scopes);
-  if (roles.length === 0 || scopes.length === 0) {
+  const principalType = requirePrincipalType(input.principalType);
+  const authMode = requireAuthMode(input.authMode);
+  const roleBasedInteractiveAuth = authMode === "interactive_user" && roles.length > 0;
+  if (roles.length === 0 || scopes.length === 0 && !roleBasedInteractiveAuth) {
     throw new LucernSdkAuthContextError(
       "membership_missing",
       "Canonical Lucern SDK auth context requires non-empty roles and scopes."
     );
   }
-  const principalType = requirePrincipalType(input.principalType);
-  const authMode = requireAuthMode(input.authMode);
   const subject = cleanString(input.permit?.subject) ?? principalId;
   const tenant = cleanString(input.permit?.tenant) ?? tenantId;
   const workspace = cleanString(input.permit?.workspace) ?? workspaceId;
@@ -4115,9 +4116,33 @@ function graphAnalysisQuery(input) {
     cursor: input.cursor
   };
 }
+function normalizeRunQueryPayload(input) {
+  return {
+    ...input,
+    topicId: requireTopicId2(input),
+    projectId: void 0
+  };
+}
 function createGraphAnalysisClient(config = {}) {
   const gateway = createGatewayRequestClient(config);
   return {
+    listGraphIntelligenceQueries(input = {}) {
+      return gateway.request({
+        path: "/api/platform/v1/graph-intelligence/queries",
+        method: "POST",
+        body: {
+          categoryId: input.categoryId,
+          mode: input.mode
+        }
+      });
+    },
+    runGraphIntelligenceQuery(input) {
+      return gateway.request({
+        path: "/api/platform/v1/graph-intelligence/run",
+        method: "POST",
+        body: normalizeRunQueryPayload(input)
+      });
+    },
     saveAnalysis(input, idempotencyKey) {
       return gateway.request({
         path: "/api/platform/v1/graph-analysis/analyses",
@@ -4199,7 +4224,9 @@ function createGraphAnalysisClient(config = {}) {
           topicId: requireTopicId2(input),
           workspaceId: input.workspaceId,
           analysisId: input.analysisId,
-          since: input.since,
+          minimumCreatedAt: input.minimumCreatedAt ?? input.since ?? input.createdAt ?? input.analysisCreatedAt,
+          sourceNodeIds: input.sourceNodeIds?.join(",") ?? (input.nodeId ? input.nodeId : void 0),
+          sourceEdgeIds: input.sourceEdgeIds?.join(",") ?? (input.edgeId ? input.edgeId : void 0),
           limit: input.limit,
           cursor: input.cursor
         })}`
@@ -4955,6 +4982,7 @@ var CONTRACTS = {
   "archive_belief": { method: "DELETE", path: "/beliefs", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
   "archive_ontology": { method: "DELETE", path: "/ontologies", kind: "mutation", idempotent: true, surfaceIntent: "mcp_governance" },
   "archive_question": { method: "DELETE", path: "/questions", kind: "mutation", idempotent: true, surfaceIntent: "mcp_core" },
+  "begin_build_session": { method: "POST", path: "/mcp/build-session/begin", kind: "mutation", idempotent: true, surfaceIntent: "system" },
   "bisect_confidence": { method: "POST", path: "/beliefs/confidence/bisect", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "broadcast_message": { method: "POST", path: "/coordination/messages/broadcast", kind: "mutation", idempotent: true, surfaceIntent: "system" },
   "check_permission": { method: "POST", path: "/identity/check-permission", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
@@ -5017,6 +5045,7 @@ var CONTRACTS = {
   "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_graph_intelligence_queries": { method: "POST", path: "/graph-intelligence/queries", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
   "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" },
   "list_questions": { method: "GET", path: "/questions", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
@@ -5040,6 +5069,7 @@ var CONTRACTS = {
   "register_session": { method: "POST", path: "/coordination/register-session", kind: "mutation", idempotent: true, surfaceIntent: "system" },
   "remove_lens_from_topic": { method: "DELETE", path: "/lenses/apply", kind: "mutation", idempotent: true, surfaceIntent: "mcp_workflow" },
   "resolve_effective_ontology": { method: "POST", path: "/ontologies/effective", kind: "query", idempotent: false, surfaceIntent: "mcp_workflow" },
+  "run_graph_intelligence_query": { method: "POST", path: "/graph-intelligence/run", kind: "query", idempotent: false, surfaceIntent: "mcp_analysis" },
   "search_beliefs": { method: "POST", path: "/beliefs/search", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "search_evidence": { method: "POST", path: "/evidence/search", kind: "query", idempotent: false, surfaceIntent: "mcp_core" },
   "seed_belief_lattice": { method: "POST", path: "/scope/belief-lattice/seed", kind: "mutation", idempotent: true, surfaceIntent: "system" },
@@ -5126,6 +5156,9 @@ function createFunctionSurfaceClient(config = {}) {
     archiveQuestion(input = {}, idempotencyKey) {
       return execute("archive_question", input, idempotencyKey);
     },
+    beginBuildSession(input = {}, idempotencyKey) {
+      return execute("begin_build_session", input, idempotencyKey);
+    },
     bisectConfidence(input = {}, idempotencyKey) {
       return execute("bisect_confidence", input, idempotencyKey);
     },
@@ -5312,6 +5345,9 @@ function createFunctionSurfaceClient(config = {}) {
     listEvidence(input = {}, idempotencyKey) {
       return execute("list_evidence", input, idempotencyKey);
     },
+    listGraphIntelligenceQueries(input = {}, idempotencyKey) {
+      return execute("list_graph_intelligence_queries", input, idempotencyKey);
+    },
     listLenses(input = {}, idempotencyKey) {
       return execute("list_lenses", input, idempotencyKey);
     },
@@ -5381,6 +5417,9 @@ function createFunctionSurfaceClient(config = {}) {
     resolveEffectiveOntology(input = {}, idempotencyKey) {
       return execute("resolve_effective_ontology", input, idempotencyKey);
     },
+    runGraphIntelligenceQuery(input = {}, idempotencyKey) {
+      return execute("run_graph_intelligence_query", input, idempotencyKey);
+    },
     searchBeliefs(input = {}, idempotencyKey) {
       return execute("search_beliefs", input, idempotencyKey);
     },
@@ -7060,6 +7099,13 @@ function requireTopicId4(args) {
   }
   return topicId;
 }
+function requireTopicOrProjectId(args) {
+  const topicId = args.topicId?.trim() || args.projectId?.trim() || void 0;
+  if (!topicId) {
+    throw new Error("topicId is required");
+  }
+  return topicId;
+}
 var AUDIT_NODE_REFERENCE_KEY_PATTERN = /(^|_)(id|nodeid|beliefid|resourceid|targetid|sourceid|subjectid|globalid|entityid|recordid|fromnodeid|tonodeid|linkednodeid|linkedbeliefid|nodeids|beliefids|resourceids)$/i;
 function matchesAuditNodeReference(value, nodeId) {
   if (Array.isArray(value)) {
@@ -7095,6 +7141,23 @@ function requireBaseRate(args) {
 function exposeGatewayData(response) {
   return Object.assign({}, response, response.data);
 }
+function sdkQueryString(input) {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(input)) {
+    if (value === void 0 || value === null) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      if (value.length > 0) {
+        params.set(key, value.join(","));
+      }
+      continue;
+    }
+    params.set(key, String(value));
+  }
+  const serialized = params.toString();
+  return serialized ? `?${serialized}` : "";
+}
 function createLucernClient(config = {}) {
   const gatewayConfig = toGatewayConfig(config);
   const beliefsClient = createBeliefsClient(gatewayConfig);
@@ -7515,6 +7578,30 @@ function createLucernClient(config = {}) {
     batchCreate(input, idempotencyKey) {
       return graphClient.batchCreateNodes(input, idempotencyKey);
     },
+    listByTopicAndType(input) {
+      return gateway.request({
+        path: `/api/platform/v1/nodes${sdkQueryString({
+          topicId: requireTopicOrProjectId(input),
+          nodeType: input.nodeType,
+          nodeTypes: input.nodeTypes,
+          query: input.query,
+          sourceText: input.sourceText,
+          limit: input.limit,
+          cursor: input.cursor
+        })}`
+      }).then(exposeGatewayData);
+    },
+    countByTopicAndType(input) {
+      return gateway.request({
+        path: `/api/platform/v1/nodes/count${sdkQueryString({
+          topicId: requireTopicOrProjectId(input),
+          nodeType: input.nodeType,
+          nodeTypes: input.nodeTypes,
+          query: input.query,
+          limit: input.limit
+        })}`
+      }).then(exposeGatewayData);
+    },
     supersede(input, idempotencyKey) {
       return graphClient.supersedeNode(input, idempotencyKey);
     },
@@ -7525,6 +7612,78 @@ function createLucernClient(config = {}) {
       return graphClient.hardDeleteNode(input, idempotencyKey);
     }
   };
+  const publicationNamespace = {
+    create(input, idempotencyKey) {
+      return gateway.request({
+        path: "/api/platform/v1/publication",
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      }).then(exposeGatewayData);
+    },
+    update(publicationId, input, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/publication/${encodeURIComponent(
+          publicationId
+        )}`,
+        method: "PATCH",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      }).then(exposeGatewayData);
+    },
+    list(input = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/publication${sdkQueryString(input)}`
+      }).then(exposeGatewayData);
+    },
+    getByTopic(input) {
+      const topicId = typeof input === "string" ? input : input.topicId;
+      const workspaceId = typeof input === "string" ? void 0 : input.workspaceId;
+      return gateway.request({
+        path: `/api/platform/v1/publication/by-topic/${encodeURIComponent(
+          topicId
+        )}${sdkQueryString({ workspaceId })}`
+      }).then(exposeGatewayData);
+    },
+    publish(publicationId, input = {}, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/publication/${encodeURIComponent(
+          publicationId
+        )}/publish`,
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      }).then(exposeGatewayData);
+    },
+    unpublish(publicationId, input = {}, idempotencyKey) {
+      return gateway.request({
+        path: `/api/platform/v1/publication/${encodeURIComponent(
+          publicationId
+        )}/unpublish`,
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+      }).then(exposeGatewayData);
+    },
+    remove(publicationId, input = {}) {
+      return gateway.request({
+        path: `/api/platform/v1/publication/${encodeURIComponent(
+          publicationId
+        )}${sdkQueryString(input)}`,
+        method: "DELETE"
+      }).then(exposeGatewayData);
+    }
+  };
+  const ontologyLinksNamespace = {
+    ...ontologyLinksClient,
+    resolveThemeSource(input) {
+      return gateway.request({
+        path: "/api/platform/v1/ontology-links/theme-source",
+        method: "POST",
+        body: input
+      }).then(exposeGatewayData);
+    }
+  };
   return {
     config,
     version: LUCERN_SDK_VERSION,
@@ -8006,6 +8165,54 @@ function createLucernClient(config = {}) {
         }));
       }
     },
+    themes: {
+      listByTopic(input) {
+        return gateway.request({
+          path: `/api/platform/v1/themes${sdkQueryString({
+            topicId: requireTopicOrProjectId(input),
+            query: input.query,
+            limit: input.limit,
+            cursor: input.cursor
+          })}`
+        }).then(exposeGatewayData);
+      }
+    },
+    graphSearch: {
+      keywordSearchNodes(input) {
+        return gateway.request({
+          path: "/api/platform/v1/graph-search/keyword-nodes",
+          method: "POST",
+          body: {
+            ...input,
+            topicId: requireTopicOrProjectId(input),
+            projectId: void 0
+          }
+        }).then(exposeGatewayData);
+      }
+    },
+    classifiers: {
+      listBeliefCandidates(input) {
+        return gateway.request({
+          path: `/api/platform/v1/classifiers/belief-candidates${sdkQueryString({
+            topicId: requireTopicOrProjectId(input),
+            classifierKey: input.classifierKey,
+            query: input.query,
+            limit: input.limit,
+            cursor: input.cursor
+          })}`
+        }).then(exposeGatewayData);
+      }
+    },
+    archetypes: {
+      getJudgmentSignature(input) {
+        return gateway.request({
+          path: `/api/platform/v1/archetypes/judgment-signature${sdkQueryString({
+            topicId: requireTopicOrProjectId(input),
+            principalId: input.principalId
+          })}`
+        }).then(exposeGatewayData);
+      }
+    },
     judgments: {
       create(input) {
         return decisionsClient.createJudgment(input);
@@ -8047,6 +8254,52 @@ function createLucernClient(config = {}) {
         });
       }
     },
+    decisions: {
+      create(input) {
+        return decisionsClient.createJudgment(input);
+      },
+      record(input) {
+        return decisionsClient.recordJudgment(input);
+      },
+      list(query5) {
+        return decisionsClient.listJudgments(query5);
+      },
+      get(decisionId) {
+        return decisionsClient.getJudgment(decisionId);
+      },
+      recordOutcome(decisionId, input) {
+        return decisionsClient.recordJudgmentOutcome(decisionId, input);
+      },
+      lessons(decisionId, input, idempotencyKey) {
+        return gateway.request({
+          path: `/api/platform/v1/decisions/${encodeURIComponent(
+            decisionId
+          )}/lessons`,
+          method: "POST",
+          body: input,
+          idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+        }).then(exposeGatewayData);
+      },
+      archive(decisionId, input = {}, idempotencyKey) {
+        return gateway.request({
+          path: `/api/platform/v1/decisions/${encodeURIComponent(
+            decisionId
+          )}/archive`,
+          method: "POST",
+          body: input,
+          idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+        }).then(exposeGatewayData);
+      },
+      readiness(topicId) {
+        return decisionsClient.getJudgmentReadiness({ topicId });
+      },
+      calibration(topicId) {
+        return decisionsClient.getJudgmentCalibration({ topicId });
+      },
+      pendingOutcomeReview(topicId) {
+        return decisionsClient.listPendingJudgmentOutcomeReview({ topicId });
+      }
+    },
     worktrees: {
       createBranch(input) {
         return workflowClient.createBranch(input);
@@ -8069,7 +8322,21 @@ function createLucernClient(config = {}) {
           topicId: requireTopicId4(input),
           objective: input.objective,
           hypothesis: input.hypothesis,
+          rationale: input.rationale,
+          worktreeType: input.worktreeType,
+          startDate: input.startDate,
+          endDate: input.endDate,
+          durationWeeks: input.durationWeeks,
+          confidenceImpact: input.confidenceImpact,
+          beliefFocus: input.beliefFocus,
           beliefIds: input.beliefIds,
+          targetBeliefIds: input.targetBeliefIds,
+          targetQuestionIds: input.targetQuestionIds,
+          keyQuestions: input.keyQuestions,
+          evidenceSignals: input.evidenceSignals,
+          decisionGate: input.decisionGate,
+          goCriteria: input.goCriteria,
+          noGoSignals: input.noGoSignals,
           autoShape: input.autoShape,
           domainPackId: input.domainPackId,
           campaign: input.campaign,
@@ -8082,7 +8349,8 @@ function createLucernClient(config = {}) {
           proofArtifacts: input.proofArtifacts,
           staffingHint: typeof input.staffingHint === "string" ? input.staffingHint : void 0,
           lastReconciledAt: input.lastReconciledAt,
-          autoFixPolicy: input.autoFixPolicy
+          autoFixPolicy: input.autoFixPolicy,
+          lensId: input.lensId
         });
       },
       add(input) {
@@ -8091,7 +8359,21 @@ function createLucernClient(config = {}) {
           topicId: requireTopicId4(input),
           objective: input.objective,
           hypothesis: input.hypothesis,
+          rationale: input.rationale,
+          worktreeType: input.worktreeType,
+          startDate: input.startDate,
+          endDate: input.endDate,
+          durationWeeks: input.durationWeeks,
+          confidenceImpact: input.confidenceImpact,
+          beliefFocus: input.beliefFocus,
           beliefIds: input.beliefIds,
+          targetBeliefIds: input.targetBeliefIds,
+          targetQuestionIds: input.targetQuestionIds,
+          keyQuestions: input.keyQuestions,
+          evidenceSignals: input.evidenceSignals,
+          decisionGate: input.decisionGate,
+          goCriteria: input.goCriteria,
+          noGoSignals: input.noGoSignals,
           autoShape: input.autoShape,
           domainPackId: input.domainPackId,
           campaign: input.campaign,
@@ -8104,7 +8386,8 @@ function createLucernClient(config = {}) {
           proofArtifacts: input.proofArtifacts,
           staffingHint: typeof input.staffingHint === "string" ? input.staffingHint : void 0,
           lastReconciledAt: input.lastReconciledAt,
-          autoFixPolicy: input.autoFixPolicy
+          autoFixPolicy: input.autoFixPolicy,
+          lensId: input.lensId
         });
       },
       list(query5) {
@@ -8114,6 +8397,22 @@ function createLucernClient(config = {}) {
           limit: query5.limit
         });
       },
+      listByTopic(query5) {
+        return worktreesFacade.list({
+          topicId: requireTopicId4(query5),
+          status: query5.status,
+          limit: query5.limit
+        });
+      },
+      findByPairedSprint(input) {
+        return gateway.request({
+          path: `/api/platform/v1/worktrees/paired-sprint${sdkQueryString({
+            sprintId: input.sprintId,
+            topicId: input.topicId ?? input.projectId,
+            limit: input.limit
+          })}`
+        }).then(exposeGatewayData);
+      },
       activate(worktreeId) {
         return worktreesFacade.activate({ id: worktreeId });
       },
@@ -8265,6 +8564,31 @@ function createLucernClient(config = {}) {
           status: typeof input.status === "string" ? input.status : void 0,
           limit: typeof input.limit === "number" ? input.limit : void 0
         });
+      },
+      listByTopic(input) {
+        return tasksFacade.list({
+          topicId: requireTopicId4(input),
+          status: typeof input.status === "string" ? input.status : void 0,
+          limit: typeof input.limit === "number" ? input.limit : void 0
+        });
+      },
+      listByWorktree(input) {
+        return tasksFacade.list({
+          topicId: typeof input.topicId === "string" ? input.topicId : void 0,
+          worktreeId: input.worktreeId,
+          status: typeof input.status === "string" ? input.status : void 0,
+          limit: typeof input.limit === "number" ? input.limit : void 0
+        });
+      },
+      linkChat(taskId, input, idempotencyKey) {
+        return gateway.request({
+          path: `/api/platform/v1/tasks/${encodeURIComponent(
+            taskId
+          )}/link-chat`,
+          method: "POST",
+          body: input,
+          idempotencyKey: idempotencyKey ?? randomIdempotencyKey()
+        }).then(exposeGatewayData);
       }
     },
     topics: {
@@ -8549,11 +8873,13 @@ function createLucernClient(config = {}) {
     graphAnalysis: graphAnalysisClient,
     graphRecommendations: graphRecommendationsClient,
     orgGraphSearch: orgGraphSearchClient,
-    ontologyLinks: ontologyLinksClient,
+    ontologyLinks: ontologyLinksNamespace,
     graphStateClassifier: graphStateClassifierClient,
     modelRuntime: modelRuntimeClient,
     jobs: jobsClient,
     telemetry: telemetryClient,
+    publication: publicationNamespace,
+    contentPublication: publicationNamespace,
     tools: {
       listCatalog: toolRegistryClient.listCatalog,
       listExecutable: toolRegistryClient.listExecutable,