@lucern/sdk 1.0.29 → 1.0.31

package/dist/audiences-client.js

@@ -0,0 +1,107 @@
+import { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
+import { createListResult, mapGatewayData } from "./sdkSurface.js";
+/**
+ * Create the audiences client for registry entries and grants.
+ * @param config - Gateway transport configuration.
+ * @returns An object with methods to manage audience registry entries and grants.
+ */
+export function createAudiencesClient(config = {}) {
+    const gateway = createGatewayRequestClient(config);
+    function serializeBoolean(value) {
+        if (typeof value !== "boolean") {
+            return;
+        }
+        return value ? "true" : "false";
+    }
+    const listRegistry = (query = {}) => gateway
+        .request({
+        path: `/api/platform/v1/audiences/registry${toQueryString({
+            ...query,
+            effective: serializeBoolean(query.effective),
+            status: query.status,
+        })}`,
+    })
+        .then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "registryEntries")));
+    const createRegistryEntry = (input, idempotencyKey) => gateway.request({
+        path: "/api/platform/v1/audiences/registry",
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
+    });
+    const updateRegistryEntry = createRegistryEntry;
+    const upsertRegistry = createRegistryEntry;
+    const getRegistry = listRegistry;
+    const listGrants = (query = {}) => gateway
+        .request({
+        path: `/api/platform/v1/audiences/grants${toQueryString({
+            ...query,
+            audienceKey: query.audienceKey,
+            principalId: query.principalId,
+            groupId: query.groupId,
+            status: query.status,
+        })}`,
+    })
+        .then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "grants")));
+    const createGrant = (input, idempotencyKey) => gateway.request({
+        path: "/api/platform/v1/audiences/grants",
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
+    });
+    const getGrants = listGrants;
+    const grant = createGrant;
+    const deleteGrant = (input, idempotencyKey) => gateway.request({
+        path: "/api/platform/v1/audiences/grants/revoke",
+        method: "POST",
+        body: input,
+        idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
+    });
+    const revokeGrant = deleteGrant;
+    return {
+        /**
+         * List audience registry entries.
+         */
+        listRegistry,
+        /**
+         * @deprecated Use listRegistry.
+         */
+        getRegistry,
+        /**
+         * Create an audience registry entry.
+         */
+        createRegistryEntry,
+        /**
+         * Update an audience registry entry.
+         */
+        updateRegistryEntry,
+        /**
+         * @deprecated Use createRegistryEntry or updateRegistryEntry.
+         */
+        upsertRegistry,
+        /**
+         * List audience grants.
+         */
+        listGrants,
+        /**
+         * @deprecated Use listGrants.
+         */
+        getGrants,
+        /**
+         * Create an audience grant.
+         */
+        createGrant,
+        /**
+         * @deprecated Use createGrant.
+         */
+        grant,
+        /**
+         * Delete an audience grant by revoking it.
+         */
+        deleteGrant,
+        /**
+         * @deprecated Use deleteGrant.
+         */
+        revokeGrant,
+    };
+}
+//# sourceMappingURL=audiences-client.js.map

package/dist/{auditClient.d.ts → audit-client.d.ts}

@@ -1,6 +1,5 @@
-import { type GatewayClientConfig, type GatewayScope, LucernApiError } from "./coreClient";
+import { type GatewayClientConfig, type GatewayScope } from "./coreClient";
 import type { TopicIdentifierInput } from "./types";
-export { LucernApiError };
 export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
 /** Configuration for the audit client. */
 export type AuditClientConfig = GatewayClientConfig;
@@ -22,4 +21,4 @@ export declare function createAuditClient(config?: AuditClientConfig): {
         limit?: number;
     } & TopicIdentifierInput): Promise<import("./coreClient").PlatformGatewaySuccess<import("./types").ListResult<any, "events">>>;
 };
-//# sourceMappingURL=auditClient.d.ts.map
+//# sourceMappingURL=audit-client.d.ts.map

package/dist/{auditClient.js → audit-client.js}

@@ -1,6 +1,5 @@
-import { createGatewayRequestClient, LucernApiError, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData, normalizeTopicQuery } from "./sdkSurface.js";
-export { LucernApiError };
+import { createGatewayRequestClient, toQueryString, } from "./coreClient.js";
+import { createListResult, mapGatewayData, normalizeTopicQuery, } from "./sdkSurface.js";
 /**
  * Create the audit client for transport-level audit event reads.
  * @param config - Gateway transport configuration.
@@ -12,11 +11,13 @@ export function createAuditClient(config = {}) {
         /**
          * List audit events for the current scope.
          */
-        async listEvents(query = {}) {
-            return gateway.request({
+        listEvents(query = {}) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/audit/events${toQueryString(normalizeTopicQuery(query))}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "events")));
+            })
+                .then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "events")));
         },
     };
 }
-//# sourceMappingURL=auditClient.js.map
+//# sourceMappingURL=audit-client.js.map

package/dist/authContext.d.ts

@@ -1,47 +1,47 @@
 import type { SessionAuthMode, SessionDelegationHop, SessionPrincipalType } from "./contracts/auth-session.contract";
 import type { JsonObject } from "./types";
 export type LucernSdkAuthFailureReason = "principal_missing" | "tenant_missing" | "membership_missing" | "workspace_missing" | "clerk_alias_missing" | "clerk_alias_unrecognized" | "policy_denied" | "policy_unavailable" | "policy_unknown";
-export type PermitReadyAuthContext = {
+export interface PermitReadyAuthContext {
+    action?: string;
+    context?: JsonObject;
+    relation?: string;
+    resource?: string;
     subject: string;
     tenant: string;
     workspace: string;
-    resource?: string;
-    action?: string;
-    relation?: string;
-    context?: JsonObject;
-};
+}
 export type LucernSdkAuthPolicyDecision = "allow" | "deny" | "unknown";
-export type LucernSdkAuthContextInput = {
+export interface LucernSdkAuthContextInput {
+    authMode?: SessionAuthMode;
     clerkId?: string;
+    correlationId?: string;
+    delegationChain?: readonly SessionDelegationHop[];
+    membershipId?: string;
+    permit?: Partial<PermitReadyAuthContext>;
+    policyDecision?: LucernSdkAuthPolicyDecision;
+    policyTraceId?: string;
     principalId?: string;
-    tenantId?: string;
-    workspaceId?: string | null;
     principalType?: SessionPrincipalType;
-    authMode?: SessionAuthMode;
     roles?: readonly string[];
     scopes?: readonly string[];
-    delegationChain?: readonly SessionDelegationHop[];
-    policyTraceId?: string;
+    tenantId?: string;
+    workspaceId?: string | null;
+}
+export interface CanonicalLucernSdkAuthContext {
+    authMode: SessionAuthMode;
+    clerkId?: string;
     correlationId?: string;
+    delegationChain: SessionDelegationHop[];
     membershipId?: string;
-    policyDecision?: LucernSdkAuthPolicyDecision;
-    permit?: Partial<PermitReadyAuthContext>;
-};
-export type CanonicalLucernSdkAuthContext = {
-    clerkId?: string;
+    permit: PermitReadyAuthContext;
+    policyTraceId?: string;
     principalId: string;
-    tenantId: string;
-    workspaceId: string;
     principalType: SessionPrincipalType;
-    authMode: SessionAuthMode;
     roles: string[];
     scopes: string[];
-    delegationChain: SessionDelegationHop[];
-    policyTraceId?: string;
-    correlationId?: string;
-    membershipId?: string;
-    permit: PermitReadyAuthContext;
-};
+    tenantId: string;
+    workspaceId: string;
+}
 export declare class LucernSdkAuthContextError extends Error {
     readonly reason: LucernSdkAuthFailureReason;
     constructor(reason: LucernSdkAuthFailureReason, message: string);

package/dist/authDeviceClient.d.ts

@@ -1,29 +1,29 @@
 import type { GatewayClientConfig } from "./coreClient";
-export type DeviceCodeInput = {
+export interface DeviceCodeInput {
     clientId?: string;
     scope?: string;
-};
-export type DeviceCodeResponse = {
+}
+export interface DeviceCodeResponse {
     device_code: string;
+    expires_in: number;
+    interval: number;
     user_code: string;
     verification_uri: string;
     verification_uri_complete: string;
-    expires_in: number;
-    interval: number;
-};
-export type DeviceTokenResponse = {
+}
+export interface DeviceTokenResponse {
     access_token: string;
-    token_type: "Bearer";
     expires_in: number;
+    principal_id: string;
     scope: string;
     tenant_id: string;
-    workspace_id?: string;
-    principal_id: string;
+    token_type: "Bearer";
     user?: {
         id: string;
         principalId: string;
     };
-};
+    workspace_id?: string;
+}
 export type DeviceTokenErrorCode = "authorization_pending" | "slow_down" | "access_denied" | "expired_token" | "invalid_grant" | "invalid_request";
 export declare class DeviceAuthorizationError extends Error {
     readonly error: DeviceTokenErrorCode;

package/dist/authDeviceClient.js

@@ -1,3 +1,4 @@
+const TRAILING_SLASH_PATTERN = /\/+$/;
 export class DeviceAuthorizationError extends Error {
     error;
     interval;
@@ -9,7 +10,7 @@ export class DeviceAuthorizationError extends Error {
     }
 }
 function authBaseUrl(config) {
-    return config.baseUrl?.replace(/\/+$/, "") ?? "";
+    return config.baseUrl?.replace(TRAILING_SLASH_PATTERN, "") ?? "";
 }
 async function readJson(response) {
     try {
@@ -37,10 +38,7 @@ function assertDeviceCodeResponse(payload) {
     const verificationUriComplete = readString(payload.verification_uri_complete);
     const expiresIn = payload.expires_in;
     const interval = payload.interval;
-    if (!deviceCode ||
-        !userCode ||
-        !verificationUri ||
-        !verificationUriComplete ||
+    if (!(deviceCode && userCode && verificationUri && verificationUriComplete) ||
         typeof expiresIn !== "number" ||
         typeof interval !== "number") {
         throw new Error("Gateway returned an invalid device-code response.");
@@ -97,7 +95,7 @@ function maybeThrowDeviceError(payload) {
 export function createAuthDeviceClient(config = {}) {
     const fetchImpl = config.fetchImpl ?? fetch;
     const baseUrl = authBaseUrl(config);
-    async function post(path, body) {
+    function post(path, body) {
         return fetchImpl(`${baseUrl}${path}`, {
             method: "POST",
             headers: { "content-type": "application/json" },

package/dist/beliefs/index.d.ts

@@ -1,12 +1,12 @@
 import { type LucernClientConfig } from "../client";
 export * as beliefsContracts from "@lucern/contracts/beliefs/v1";
-export * as toolSchemas from "@lucern/contracts/tool-contracts";
 export * as methodSchemas from "@lucern/contracts/sdk-methods.contract";
+export * as toolSchemas from "@lucern/contracts/tool-contracts";
 export type BeliefsClientConfig = LucernClientConfig;
 export type BeliefsClient = ReturnType<typeof createBeliefsClient>;
 export declare function createBeliefsClient(config?: BeliefsClientConfig): {
-    createBelief: (input: import("../clientConfig").BeliefsCompatCreateInput) => any;
-    getBelief: (nodeId: string) => any;
+    createBelief: (input: import("..").CreateBeliefInput) => Promise<import("../client-config").GatewayDataEnvelope<import("..").PlatformBeliefRecord>>;
+    getBelief: (nodeId: string) => Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefRecord>>;
     listBeliefs: (args: {
         topicId?: string;
         worktreeId?: string;
@@ -14,37 +14,65 @@ export declare function createBeliefsClient(config?: BeliefsClientConfig): {
         minConfidence?: number;
         limit?: number;
         cursor?: string;
-    }) => any;
-    searchBeliefs: any;
+    }) => Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefsListResult>>;
+    searchBeliefs: (args_0: import("..").JsonObject) => Promise<import("..").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
     refineBelief: (nodeId: string, textOrInput: string | {
         text: string;
         rationale?: string;
-    }, rationale?: string) => any;
-    forkBelief: (nodeId: string, input: import("../clientConfig").BeliefsCompatForkInput) => any;
+    }, rationale?: string) => Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefRecord>>;
+    forkBelief: (nodeId: string, input: import("../client-config").BeliefsCompatForkInput) => Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefRecord>>;
     archiveBelief: (nodeId: string, input?: string | {
         reason?: string;
         rationale?: string;
-    }) => any;
-    getBeliefLineage: (nodeId: string) => any;
-    getBeliefConfidenceHistory: (nodeId: string) => any;
+    }) => Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+    getBeliefLineage: (nodeId: string) => Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefsLineageResult>>;
+    getBeliefConfidenceHistory: (nodeId: string) => Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
     raw: {
-        create(input: import("../clientConfig").BeliefsCompatCreateInput): any;
-        get(nodeId: string): any;
+        create(input: import("..").CreateBeliefInput): Promise<import("../client-config").GatewayDataEnvelope<import("..").PlatformBeliefRecord>>;
+        get(nodeId: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefRecord>>;
         refine(nodeId: string, textOrInput: string | {
             text: string;
             rationale?: string;
-        }, rationale?: string): any;
-        updateRationale(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
-        linkBeliefs(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
-        unlinkEvidence(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
-        updateCriticality(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
-        batchUpdateCriticality(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
-        reassignTopic(input: Parameters<(...args: any[]) => any>[0], idempotencyKey?: string): any;
-        fork(nodeId: string, input: import("../clientConfig").BeliefsCompatForkInput): any;
+        }, rationale?: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefRecord>>;
+        updateRationale(input: Parameters<(input: {
+            id?: string;
+            nodeId?: string;
+            beliefId?: string;
+            rationale?: string;
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>>[0], idempotencyKey?: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+        linkBeliefs(input: Parameters<(input: {
+            fromNodeId: string;
+            toNodeId: string;
+            edgeType: string;
+            weight?: number;
+            context?: string;
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>>[0], idempotencyKey?: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+        unlinkEvidence(input: Parameters<(input: {
+            beliefNodeId?: string;
+            beliefId?: string;
+            insightId?: string;
+            evidenceId?: string;
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>>[0], idempotencyKey?: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+        updateCriticality(input: Parameters<(input: {
+            id?: string;
+            nodeId?: string;
+            beliefId?: string;
+            criticality: string;
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>>[0], idempotencyKey?: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+        batchUpdateCriticality(input: Parameters<(input: {
+            updates: import("../gatewayFacades").GatewayRecord[];
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>>[0], idempotencyKey?: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+        reassignTopic(input: Parameters<(input: {
+            beliefNodeIds?: string[];
+            beliefIds?: string[];
+            targetTopicId: string;
+            reason?: string;
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>>[0], idempotencyKey?: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+        fork(nodeId: string, input: import("../client-config").BeliefsCompatForkInput): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefRecord>>;
         archive(nodeId: string, input?: string | {
             reason?: string;
             rationale?: string;
-        }): any;
+        }): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
         list(args: {
             topicId?: string;
             worktreeId?: string;
@@ -52,13 +80,13 @@ export declare function createBeliefsClient(config?: BeliefsClientConfig): {
             minConfidence?: number;
             limit?: number;
             cursor?: string;
-        }): any;
-        search: any;
-        lineage(nodeId: string): any;
-        confidenceHistory(nodeId: string): any;
-        opinionHistory: any;
-        createContract(nodeId: string, input: Parameters<(...args: any[]) => any>[1]): any;
-        bisect(nodeId: string, input: Parameters<(...args: any[]) => any>[1]): any;
+        }): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefsListResult>>;
+        search: (args_0: import("..").JsonObject) => Promise<import("..").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        lineage(nodeId: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").BeliefsLineageResult>>;
+        confidenceHistory(nodeId: string): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+        opinionHistory: (args_0: string) => Promise<import("..").PlatformGatewaySuccess<Record<string, unknown>> & Record<string, unknown>>;
+        createContract(nodeId: string, input: Parameters<(id: string, input: import("../gatewayFacades").BeliefContractInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>>[1]): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
+        bisect(nodeId: string, input: Parameters<(id: string, input: import("../gatewayFacades").BeliefBisectInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>>[1]): Promise<import("../client-config").GatewayDataEnvelope<import("../gatewayFacades").GatewayRecord>>;
     };
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/beliefs/index.js

@@ -1,7 +1,8 @@
+// biome-ignore-all lint/performance/noBarrelFile: This file is an @lucern/sdk public import ABI / package subpath compatibility surface; the facade/barrel export is intentional.
 import { createLucernClient } from "../client.js";
 export * as beliefsContracts from "@lucern/contracts/beliefs/v1";
-export * as toolSchemas from "@lucern/contracts/tool-contracts";
 export * as methodSchemas from "@lucern/contracts/sdk-methods.contract";
+export * as toolSchemas from "@lucern/contracts/tool-contracts";
 export function createBeliefsClient(config = {}) {
     const beliefs = createLucernClient(config).beliefs;
     return {