@lucern/sdk 1.0.29 → 1.0.30

package/dist/client.js

@@ -1,51 +1,51 @@
-import { createAdminClient } from "./adminClient.js";
 import { createAccessControlClient } from "./accessControl.js";
-import { createAnswersClient } from "./answersClient.js";
-import { createAudiencesClient, } from "./audiencesClient.js";
-import { createAuditClient } from "./auditClient.js";
+import { createAdminClient } from "./adminClient.js";
+import { createAnswersClient } from "./answers-client.js";
+import { createAudiencesClient } from "./audiences-client.js";
+import { createAuditClient } from "./audit-client.js";
 import { createAuthDeviceClient } from "./authDeviceClient.js";
-import { createBeliefsClient, } from "./beliefsClient.js";
+import { createBeliefsClient } from "./beliefsClient.js";
 import { createClientGraphNamespaces } from "./clientGraphNamespaces.js";
+import { buildBeliefsArchivePayload, buildBeliefsRefinePayload, requireBaseRate, requireText, requireTopicId, requireTopicOrProjectId, resolveCustomToolFullName, sdkQueryString, } from "./clientHelpers.js";
 import { createClientKnowledgeNamespaces } from "./clientKnowledgeNamespaces.js";
 import { createClientLocalHelpers } from "./clientLocalHelpers.js";
 import { createClientPlatformNamespaces } from "./clientPlatformNamespaces.js";
-import { createClientWorkflowNamespaces } from "./clientWorkflowNamespaces.js";
 import { exposeGatewayData, toGatewayConfig } from "./clientRuntime.js";
-import { createSourcesClient } from "./sourcesClient.js";
+import { createClientWorkflowNamespaces } from "./clientWorkflowNamespaces.js";
+import { createContextClient } from "./contextClient.js";
+import { createControlPlaneClient } from "./control-plane.js";
 import { createGatewayRequestClient, LucernApiError, randomIdempotencyKey, } from "./coreClient.js";
-import { buildBeliefsArchivePayload, buildBeliefsRefinePayload, requireBaseRate, requireText, requireTopicId, requireTopicOrProjectId, resolveCustomToolFullName, sdkQueryString, } from "./clientHelpers.js";
-import { createControlPlaneClient, } from "./control-plane.js";
 import { clearRegisteredCustomTools, listRegisteredCustomTools, registerCustomTool, unregisterCustomTool, } from "./customTools.js";
-import { createBeliefsFacade, createContradictionsFacade, createEdgesFacade, createEvidenceFacade, createEventsFacade, createGraphFacade, createIdentityFacade, createOntologiesFacade, createQuestionsFacade, createSearchFacade, createTasksFacade, createTopicsFacade, createWebhooksFacade, createWorktreesFacade, } from "./gatewayFacades.js";
-import { createDecisionsClient, } from "./decisionsClient.js";
-import { createEmbeddingsClient, } from "./embeddingsClient.js";
-import { createContextClient, } from "./contextClient.js";
-import { createEventingClient, } from "./eventingClient.js";
+import { createDecisionsClient } from "./decisionsClient.js";
+import { createEmbeddingsClient } from "./embeddingsClient.js";
+import { createEventingClient } from "./eventingClient.js";
 import { createEvidenceClient } from "./evidenceClient.js";
-import { createFunctionSurfaceClient, } from "./generated/functionSurface.js";
-import { createGraphAnalysisClient, } from "./graphAnalysisClient.js";
+import { createBeliefsFacade, createContradictionsFacade, createEdgesFacade, createEventsFacade, createEvidenceFacade, createGraphFacade, createIdentityFacade, createOntologiesFacade, createQuestionsFacade, createSearchFacade, createTasksFacade, createTopicsFacade, createWebhooksFacade, createWorktreesFacade, } from "./gatewayFacades.js";
+import { createFunctionSurfaceClient } from "./generated/functionSurface.js";
+import { createGraphAnalysisClient } from "./graphAnalysisClient.js";
 import { createGraphClient } from "./graphClient.js";
-import { createGraphRecommendationsClient, } from "./graphRecommendationsClient.js";
-import { createGraphStateClassifierClient, } from "./graphStateClassifierClient.js";
+import { createGraphRecommendationsClient } from "./graphRecommendationsClient.js";
+import { createGraphStateClassifierClient } from "./graphStateClassifierClient.js";
 import { createHarnessClient } from "./harnessClient.js";
-import { createIdentityClient, } from "./identityClient.js";
+import { createIdentityClient } from "./identityClient.js";
 import { createJobsClient } from "./jobsClient.js";
-import { createLearningClient, } from "./learningClient.js";
+import { createLearningClient } from "./learningClient.js";
 import { createMcpClient } from "./mcpClient.js";
-import { createModelRuntimeClient, } from "./modelRuntimeClient.js";
-import { createOntologyClient, } from "./ontologyClient.js";
-import { createOntologyLinksClient, } from "./ontologyLinksClient.js";
-import { createOrgGraphSearchClient, } from "./orgGraphSearchClient.js";
+import { createModelRuntimeClient } from "./modelRuntimeClient.js";
+import { createOntologyClient } from "./ontologyClient.js";
+import { createOntologyLinksClient } from "./ontologyLinksClient.js";
+import { createOrgGraphSearchClient } from "./orgGraphSearchClient.js";
 import { createPacksClient } from "./packsClient.js";
 import { createPolicyClient } from "./policyClient.js";
-import { createReportsClient } from "./reportsClient.js";
-import { createSchemaClient } from "./schemaClient.js";
+import { createReportsClient } from "./reports-client.js";
+import { createSchemaClient } from "./schema-client.js";
 import { resolveTopicId } from "./sdkSurface.js";
-import { createTelemetryClient, } from "./telemetryClient.js";
+import { createSourcesClient } from "./sources-client.js";
+import { createTelemetryClient } from "./telemetry-client.js";
+import { createToolRegistryClient } from "./toolRegistryClient.js";
 import { createTopicsClient } from "./topicsClient.js";
-import { createToolRegistryClient, } from "./toolRegistryClient.js";
 import { LUCERN_SDK_VERSION } from "./version.js";
-import { createWorkflowClient, } from "./workflowClient.js";
+import { createWorkflowClient } from "./workflowClient.js";
 /**
  * Create the high-level Lucern SDK client with all domain namespaces.
  *
@@ -117,8 +117,12 @@ export function createLucernClient(config = {}) {
         }
         const installPromise = (async () => {
             try {
+                const packKey = config.packKey;
+                if (!packKey) {
+                    throw new Error("packKey is required");
+                }
                 await packsClient.install({
-                    packKey: config.packKey,
+                    packKey,
                     autoEnable: true,
                 });
                 packInstalled = true;

package/dist/clientGraphNamespaces.d.ts

@@ -1,50 +1,60 @@
-import type { ClientNamespaceContext } from "./clientAssemblyTypes";
+import type { ClientNamespaceContext } from "./client-assembly-types";
 export declare function createClientGraphNamespaces(ctx: ClientNamespaceContext): {
     graph: {
-        nodes: Record<string, any>;
-        createEdge: (...args: any[]) => any;
-        neighborhood(args: Parameters<(...args: any[]) => any>[0]): any;
-        queryLineage: any;
-        getConfidenceHistory: any;
-        getOpinionHistory: any;
-        getAuditTrail: any;
+        nodes: import("./client-assembly-types").ClientNodesNamespace;
+        createEdge: (input: import("./graphClient").CreateEdgeInput, idempotencyKey?: string) => Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").PlatformGraphEdge>>;
+        neighborhood(args: Parameters<(query: import("./graphClient").NeighborhoodInput) => Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").GraphNeighborhoodResponse>>>[0]): Promise<import("./client-config").GatewayDataEnvelope<import("./types").GraphNeighborhoodResponse>>;
+        queryLineage: (args_0: string, args_1?: number | undefined) => Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        getConfidenceHistory: (args_0: string) => Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        getOpinionHistory: (args_0: string) => Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        getAuditTrail: (nodeId: string, limit?: number) => Promise<{
+            entries: import("./client-assembly-types").AuditTrailEntry[];
+        }>;
         traverse(args: {
             startNode: string;
             direction?: string;
             maxDepth?: number;
             topicId?: string;
-        }): any;
+        }): Promise<import("./client-config").GatewayDataEnvelope<Record<string, unknown>>>;
         analyze(args: {
             topicId?: string;
             limit?: number;
             metric?: string;
-        }): any;
+        }): Promise<import("./client-config").GatewayDataEnvelope<Record<string, unknown>>>;
         bias(args: {
             topicId?: string;
             threshold?: number;
             limit?: number;
-        }): any;
+        }): Promise<import("./client-config").GatewayDataEnvelope<Record<string, unknown>>>;
         gaps(args: {
             topicId?: string;
             minConfidence?: number;
-        }): any;
+        }): Promise<import("./client-config").GatewayDataEnvelope<Record<string, unknown>>>;
         falsify(args: {
             topicId?: string;
             beliefId?: string;
             beliefIds?: string[];
             minConfidence?: number;
-        }): any;
+        }): Promise<import("./client-config").GatewayDataEnvelope<import("./gatewayFacades").GatewayRecord>>;
         traceEntityImpact(args: {
             nodeId: string;
             topicId?: string;
-        }): any;
-        searchBeliefs: any;
-        findContradictions: any;
-        bisectConfidence: any;
-        listBeliefs: any;
-        detectConfirmationBias(topicId: string, threshold?: number): any;
-        getStructureAnalysis(topicId: string): any;
-        getFalsificationQuestions(topicId: string, beliefIds?: string[]): any;
+        }): Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        searchBeliefs: (args_0: import("./types").JsonObject) => Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        findContradictions: (args_0: import("./types").JsonObject) => Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        bisectConfidence: (args_0: import("./types").JsonObject) => Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        listBeliefs: (args_0: import("./types").JsonObject) => Promise<import("./coreClient").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        detectConfirmationBias(topicId: string, threshold?: number): Promise<{
+            topicId: string;
+            threshold: number;
+        }>;
+        getStructureAnalysis(topicId: string): Promise<{
+            topicId: string;
+        }>;
+        getFalsificationQuestions(topicId: string, beliefIds?: string[]): Promise<{
+            topicId: string;
+            questions: unknown;
+        }>;
     };
     themes: {
         listByTopic(input: {
@@ -53,7 +63,7 @@ export declare function createClientGraphNamespaces(ctx: ClientNamespaceContext)
             query?: string;
             limit?: number;
             cursor?: string;
-        }): Promise<any>;
+        }): Promise<import("./client-config").GatewayDataEnvelope<Record<string, unknown>>>;
     };
     graphSearch: {
         keywordSearchNodes(input: {
@@ -65,7 +75,7 @@ export declare function createClientGraphNamespaces(ctx: ClientNamespaceContext)
             nodeTypes?: string[];
             limit?: number;
             cursor?: string;
-        }): Promise<any>;
+        }): Promise<import("./client-config").GatewayDataEnvelope<Record<string, unknown>>>;
     };
     classifiers: {
         listBeliefCandidates(input: {
@@ -75,14 +85,14 @@ export declare function createClientGraphNamespaces(ctx: ClientNamespaceContext)
             query?: string;
             limit?: number;
             cursor?: string;
-        }): Promise<any>;
+        }): Promise<import("./client-config").GatewayDataEnvelope<Record<string, unknown>>>;
     };
     archetypes: {
         getJudgmentSignature(input: {
             topicId?: string;
             projectId?: string;
             principalId?: string;
-        }): Promise<any>;
+        }): Promise<import("./client-config").GatewayDataEnvelope<Record<string, unknown>>>;
     };
 };
 //# sourceMappingURL=clientGraphNamespaces.d.ts.map

package/dist/clientGraphNamespaces.js

@@ -1,5 +1,5 @@
 export function createClientGraphNamespaces(ctx) {
-    const { accessControlClient, addEvidence, adminClient, answersClient, archiveOntologyCompat, auditClient, authDeviceClient, beliefsClient, beliefsFacade, bisectConfidence, buildBeliefsArchivePayload, buildBeliefsRefinePayload, clearRegisteredCustomTools, config, contextClient, contradictionsFacade, controlPlaneClient, createContractCompat, createEvidence, createOntologyCompat, createOntologyVersionCompat, decisionsClient, deprecateOntologyVersionCompat, discoverEntityConnections, discoverTopics, edgesFacade, embeddingsClient, ensurePack, evaluateContractCompat, eventingClient, eventsFacade, evidenceClient, evidenceFacade, exposeGatewayData, extensionNamespaces, findContradictions, functionSurfaceClient, gateway, getAuditTrail, getConfidenceHistory, getContractStatusCompat, getCustomNamespace, getOpinionHistory, getPackInstalled, graphAnalysisClient, graphClient, graphFacade, graphRecommendationsClient, graphStateClassifierClient, harnessClient, identityClient, identityFacade, invokeCustomTool, jobsClient, learningClient, listBeliefs, listContractsCompat, listRegisteredCustomTools, mcpClient, modelRuntimeClient, nodesNamespace, ontologiesFacade, ontologyClient, ontologyLinksClient, ontologyLinksNamespace, orgGraphSearchClient, packsClient, policyClient, publicationNamespace, publishOntologyVersionCompat, questionsFacade, queryLineage, randomIdempotencyKey, registerCustomTool, reportsClient, requireBaseRate, requireText, requireTopicId, requireTopicOrProjectId, resolveCustomToolFullName, resolveEffectiveOntologyCompat, resolveTopicId, schemaClient, sdkQueryString, searchBeliefs, sourcesClient, tasksFacade, telemetryClient, toolRegistryClient, topicsClient, topicsFacade, traceEntityImpactCompat, triggerBeliefReview, unregisterCustomTool, updateOntologyCompat, webhooksFacade, workflowClient, worktreesFacade, } = ctx;
+    const { bisectConfidence, exposeGatewayData, findContradictions, gateway, getAuditTrail, getConfidenceHistory, getOpinionHistory, graphClient, graphFacade, listBeliefs, nodesNamespace, queryLineage, requireTopicId, requireTopicOrProjectId, sdkQueryString, searchBeliefs, traceEntityImpactCompat, } = ctx;
     return {
         graph: {
             nodes: nodesNamespace,
@@ -79,21 +79,27 @@ export function createClientGraphNamespaces(ctx) {
             bisectConfidence,
             listBeliefs,
             detectConfirmationBias(topicId, threshold) {
-                return graphFacade.bias({
+                return graphFacade
+                    .bias({
                     topicId,
                     threshold,
                     limit: 200,
-                }).then((response) => ({
+                })
+                    .then(exposeGatewayData)
+                    .then((response) => ({
                     ...response,
                     topicId,
                     threshold: threshold ?? 0.7,
                 }));
             },
             getStructureAnalysis(topicId) {
-                return graphFacade.analyze({
+                return graphFacade
+                    .analyze({
                     topicId,
                     limit: 200,
-                }).then((response) => ({
+                })
+                    .then(exposeGatewayData)
+                    .then((response) => ({
                     ...response,
                     topicId,
                 }));

package/dist/clientHelpers.js

@@ -1,3 +1,4 @@
+// biome-ignore-all lint/style/useFilenamingConvention: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the camelCase filename is intentional.
 import { asListItems, resolveText, resolveTopicId } from "./sdkSurface.js";
 export function normalizeCustomNamespace(namespace) {
     return namespace.trim() || "custom";
@@ -16,11 +17,13 @@ export function buildBeliefsRefinePayload(textOrInput, rationale) {
         : { text: textOrInput.text, rationale: textOrInput.rationale };
 }
 export function buildBeliefsArchivePayload(input) {
-    return typeof input === "string"
-        ? { reason: input }
-        : input
-            ? { reason: input.reason ?? input.rationale }
-            : undefined;
+    if (typeof input === "string") {
+        return { reason: input };
+    }
+    if (input) {
+        return { reason: input.reason ?? input.rationale };
+    }
+    return;
 }
 export function asNodeArray(data) {
     const rows = asListItems(data, "nodes");