@lucern/sdk 1.0.29 → 1.0.31

package/dist/index.d.ts

@@ -6,24 +6,19 @@
  *
  * @packageDocumentation
  */
-export { opinionFromBaseRate, opinionFromDogmatic, opinionFromProjected, } from "./opinion";
-export type { Opinion } from "./opinion";
-export * from "./adminClient";
+export { type AxiomTelemetryExporterConfig, createAxiomTelemetryExporter, createCompositeTelemetryExporter, createHttpTelemetryExporter, createMemoryTelemetryExporter, createTelemetryExporterFromEnv, DEFAULT_AXIOM_API_URL, DEFAULT_AXIOM_EVENTS_DATASET, DEFAULT_AXIOM_LOGS_DATASET, DEFAULT_AXIOM_METRICS_DATASET, DEFAULT_AXIOM_TRACES_DATASET, emitTelemetrySignal, type LucernTelemetryEnvironment, type LucernTelemetryExporter, type LucernTelemetryExportPayload, type LucernTelemetrySignal, type ResolvedAxiomTelemetryConfig, renderTelemetryPayload, resolveAxiomTelemetryConfig, sanitizeTelemetrySignal, type TelemetryExportResult, } from "@lucern/transport-core";
 export * from "./accessControl";
-export * from "./answersClient";
-export * from "./audiencesClient";
-export * from "./auditClient";
+export * from "./adminClient";
+export * from "./answers-client";
+export * from "./audiences-client";
+export * from "./audit-client";
 export * from "./authContext";
 export * from "./authDeviceClient";
 export * from "./beliefsClient";
 export * from "./client";
+export * from "./contextClient";
 export * from "./contextFacade";
 export * from "./contextPackCompiler";
-export * from "./controlObjectOwnership";
-export * from "./coreClient";
-export { DEFAULT_AXIOM_API_URL, DEFAULT_AXIOM_EVENTS_DATASET, DEFAULT_AXIOM_LOGS_DATASET, DEFAULT_AXIOM_METRICS_DATASET, DEFAULT_AXIOM_TRACES_DATASET, createAxiomTelemetryExporter, createCompositeTelemetryExporter, createHttpTelemetryExporter, createMemoryTelemetryExporter, createTelemetryExporterFromEnv, emitTelemetrySignal, renderTelemetryPayload, resolveAxiomTelemetryConfig, sanitizeTelemetrySignal, type AxiomTelemetryExporterConfig, type LucernTelemetryEnvironment, type LucernTelemetryExportPayload, type LucernTelemetryExporter, type LucernTelemetrySignal, type ResolvedAxiomTelemetryConfig, type TelemetryExportResult, } from "@lucern/transport-core";
-export * from "./contextClient";
-export * from "./control-plane";
 export * from "./contracts/api-enums.contract";
 export * from "./contracts/auth-session.contract";
 export { MAX_ENTITY_LIMIT } from "./contracts/contextPack";
@@ -32,14 +27,18 @@ export * from "./contracts/lensWorkflow";
 export * from "./contracts/mcpTools";
 export * from "./contracts/prompt";
 export * from "./contracts/workflowRuntime";
-export * from "./domainContext";
+export * from "./control-plane";
+export * from "./controlObjectOwnership";
+export * from "./coreClient";
 export * from "./customTools";
 export * from "./decisionsClient";
+export * from "./domainContext";
 export * from "./embeddingsClient";
-export * from "./evidenceClient";
 export * from "./eventingClient";
 export * from "./events";
 export * from "./eventsCore";
+export * from "./evidenceClient";
+export * from "./generated/functionSurface";
 export * from "./graphAnalysisClient";
 export * from "./graphClient";
 export * from "./graphIntel";
@@ -51,22 +50,23 @@ export * from "./identityClient";
 export * from "./infisicalRuntime";
 export * from "./jobsClient";
 export * from "./learningClient";
-export * from "./secrets";
-export * from "./generated/functionSurface";
 export * from "./modelRuntimeClient";
 export * from "./ontologyClient";
 export * from "./ontologyLinksClient";
+export type { Opinion } from "./opinion";
+export { opinionFromBaseRate, opinionFromDogmatic, opinionFromProjected, } from "./opinion";
 export * from "./orgGraphSearchClient";
 export * from "./packRuntime";
 export * from "./packsClient";
 export * from "./policyClient";
-export * from "./reportsClient";
-export * from "./schemaClient";
+export * from "./reports-client";
+export * from "./schema-client";
 export * from "./sdkSurface";
-export * from "./sourcesClient";
-export * from "./telemetryClient";
-export * from "./topicsClient";
+export * from "./secrets";
+export * from "./sources-client";
+export * from "./telemetry-client";
 export * from "./toolRegistryClient";
+export * from "./topicsClient";
 export * from "./types";
 export * from "./version";
 export * from "./workflowClient";

package/dist/index.js

@@ -1,3 +1,4 @@
+// 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.
 /**
  * @lucern/sdk — The reasoning operating system for AI-native applications.
  *
@@ -6,24 +7,20 @@
  *
  * @packageDocumentation
  */
-export { opinionFromBaseRate, opinionFromDogmatic, opinionFromProjected, } from "./opinion.js";
-export * from "./adminClient.js";
+export { createAxiomTelemetryExporter, createCompositeTelemetryExporter, createHttpTelemetryExporter, createMemoryTelemetryExporter, createTelemetryExporterFromEnv, DEFAULT_AXIOM_API_URL, DEFAULT_AXIOM_EVENTS_DATASET, DEFAULT_AXIOM_LOGS_DATASET, DEFAULT_AXIOM_METRICS_DATASET, DEFAULT_AXIOM_TRACES_DATASET, emitTelemetrySignal, renderTelemetryPayload, resolveAxiomTelemetryConfig, sanitizeTelemetrySignal, } from "@lucern/transport-core";
 export * from "./accessControl.js";
-export * from "./answersClient.js";
-export * from "./audiencesClient.js";
-export * from "./auditClient.js";
+export * from "./adminClient.js";
+export * from "./answers-client.js";
+export * from "./audiences-client.js";
+export * from "./audit-client.js";
 export * from "./authContext.js";
 export * from "./authDeviceClient.js";
 // createBeliefsClient exposes beliefs.getOpinionHistory() and the deprecated getConfidenceHistory() alias.
 export * from "./beliefsClient.js";
 export * from "./client.js";
+export * from "./contextClient.js";
 export * from "./contextFacade.js";
 export * from "./contextPackCompiler.js";
-export * from "./controlObjectOwnership.js";
-export * from "./coreClient.js";
-export { DEFAULT_AXIOM_API_URL, DEFAULT_AXIOM_EVENTS_DATASET, DEFAULT_AXIOM_LOGS_DATASET, DEFAULT_AXIOM_METRICS_DATASET, DEFAULT_AXIOM_TRACES_DATASET, createAxiomTelemetryExporter, createCompositeTelemetryExporter, createHttpTelemetryExporter, createMemoryTelemetryExporter, createTelemetryExporterFromEnv, emitTelemetrySignal, renderTelemetryPayload, resolveAxiomTelemetryConfig, sanitizeTelemetrySignal, } from "@lucern/transport-core";
-export * from "./contextClient.js";
-export * from "./control-plane.js";
 export * from "./contracts/api-enums.contract.js";
 export * from "./contracts/auth-session.contract.js";
 export { MAX_ENTITY_LIMIT } from "./contracts/contextPack.js";
@@ -32,14 +29,18 @@ export * from "./contracts/lensWorkflow.js";
 export * from "./contracts/mcpTools.js";
 export * from "./contracts/prompt.js";
 export * from "./contracts/workflowRuntime.js";
-export * from "./domainContext.js";
+export * from "./control-plane.js";
+export * from "./controlObjectOwnership.js";
+export * from "./coreClient.js";
 export * from "./customTools.js";
 export * from "./decisionsClient.js";
+export * from "./domainContext.js";
 export * from "./embeddingsClient.js";
-export * from "./evidenceClient.js";
 export * from "./eventingClient.js";
 export * from "./events.js";
 export * from "./eventsCore.js";
+export * from "./evidenceClient.js";
+export * from "./generated/functionSurface.js";
 export * from "./graphAnalysisClient.js";
 export * from "./graphClient.js";
 export * from "./graphIntel.js";
@@ -51,22 +52,22 @@ export * from "./identityClient.js";
 export * from "./infisicalRuntime.js";
 export * from "./jobsClient.js";
 export * from "./learningClient.js";
-export * from "./secrets.js";
-export * from "./generated/functionSurface.js";
 export * from "./modelRuntimeClient.js";
 export * from "./ontologyClient.js";
 export * from "./ontologyLinksClient.js";
+export { opinionFromBaseRate, opinionFromDogmatic, opinionFromProjected, } from "./opinion.js";
 export * from "./orgGraphSearchClient.js";
 export * from "./packRuntime.js";
 export * from "./packsClient.js";
 export * from "./policyClient.js";
-export * from "./reportsClient.js";
-export * from "./schemaClient.js";
+export * from "./reports-client.js";
+export * from "./schema-client.js";
 export * from "./sdkSurface.js";
-export * from "./sourcesClient.js";
-export * from "./telemetryClient.js";
-export * from "./topicsClient.js";
+export * from "./secrets.js";
+export * from "./sources-client.js";
+export * from "./telemetry-client.js";
 export * from "./toolRegistryClient.js";
+export * from "./topicsClient.js";
 export * from "./types.js";
 export * from "./version.js";
 export * from "./workflowClient.js";

package/dist/infisicalRuntime.d.ts

@@ -1,28 +1,28 @@
 import { type InfisicalRuntimeEnvironment, type InfisicalRuntimeSurfaceId } from "@lucern/contracts";
 export type InfisicalRuntimeEnv = Record<string, string | undefined>;
 export type InfisicalRuntimeFetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
-export type InfisicalRuntimeBootstrapConfig = {
+export interface InfisicalRuntimeBootstrapConfig {
     apiUrl: string;
-    projectId: string;
     clientId: string;
     clientSecret: string;
     environment: InfisicalRuntimeEnvironment;
     organizationSlug?: string;
-};
-export type InfisicalRuntimeHydrateOptions = {
-    surfaceId: InfisicalRuntimeSurfaceId;
+    projectId: string;
+}
+export interface InfisicalRuntimeHydrateOptions {
+    bootstrap?: Partial<InfisicalRuntimeBootstrapConfig>;
     env?: InfisicalRuntimeEnv;
     fetchImpl?: InfisicalRuntimeFetch;
-    bootstrap?: Partial<InfisicalRuntimeBootstrapConfig>;
     includeGeneratedSurfaceVariables?: boolean;
-};
-export type InfisicalRuntimeHydrationResult = {
-    status: "disabled" | "hydrated";
     surfaceId: InfisicalRuntimeSurfaceId;
+}
+export interface InfisicalRuntimeHydrationResult {
     environment?: InfisicalRuntimeEnvironment;
-    values: Record<string, string>;
     sourcePaths: string[];
-};
+    status: "disabled" | "hydrated";
+    surfaceId: InfisicalRuntimeSurfaceId;
+    values: Record<string, string>;
+}
 export declare class InfisicalRuntimeError extends Error {
     readonly code: string;
     readonly status?: number;

package/dist/infisicalRuntime.js

@@ -1,4 +1,6 @@
-import { INFISICAL_RUNTIME_DEFAULT_API_URL, INFISICAL_RUNTIME_DEFAULT_PROJECT_ID, INFISICAL_RUNTIME_MANIFEST, findInfisicalRuntimePath, findInfisicalRuntimeSurface, GENERATED_INFISICAL_RUNTIME_ENV, } from "@lucern/contracts";
+// 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 { findInfisicalRuntimePath, findInfisicalRuntimeSurface, GENERATED_INFISICAL_RUNTIME_ENV, INFISICAL_RUNTIME_DEFAULT_API_URL, INFISICAL_RUNTIME_DEFAULT_PROJECT_ID, INFISICAL_RUNTIME_MANIFEST, } from "@lucern/contracts";
+const TRAILING_SLASH_PATTERN = /\/+$/u;
 export class InfisicalRuntimeError extends Error {
     code;
     status;
@@ -20,7 +22,7 @@ export function readInfisicalRuntimeBootstrap(env = {}, overrides = {}) {
     if (!hasAuthSignal) {
         return null;
     }
-    if (!clientId || !clientSecret) {
+    if (!(clientId && clientSecret)) {
         throw new InfisicalRuntimeError({
             code: "INFISICAL_BOOTSTRAP_INCOMPLETE",
             message: "Infisical runtime bootstrap requires both INFISICAL_CLIENT_ID and INFISICAL_CLIENT_SECRET.",
@@ -43,16 +45,20 @@ export function readInfisicalRuntimeBootstrap(env = {}, overrides = {}) {
 export function isInfisicalRuntimeDisabled(env = {}) {
     return INFISICAL_RUNTIME_MANIFEST.bootstrapEnv.disabled.some((name) => isTruthyEnv(env[name]));
 }
+function normalizeRuntimeBootstrap(env, overrides) {
+    const baseBootstrap = readInfisicalRuntimeBootstrap(env, overrides);
+    if (!baseBootstrap) {
+        return null;
+    }
+    return {
+        ...baseBootstrap,
+        ...Object.fromEntries(Object.entries(overrides ?? {}).filter(([, value]) => value !== undefined)),
+        apiUrl: trimTrailingSlash(overrides?.apiUrl ?? baseBootstrap.apiUrl),
+    };
+}
 export async function hydrateInfisicalRuntimeEnv(options) {
     const env = options.env ?? {};
-    const baseBootstrap = readInfisicalRuntimeBootstrap(env, options.bootstrap);
-    const bootstrap = baseBootstrap
-        ? {
-            ...baseBootstrap,
-            ...Object.fromEntries(Object.entries(options.bootstrap ?? {}).filter(([, value]) => value !== undefined)),
-            apiUrl: trimTrailingSlash(options.bootstrap?.apiUrl ?? baseBootstrap.apiUrl),
-        }
-        : null;
+    const bootstrap = normalizeRuntimeBootstrap(env, options.bootstrap);
     if (!bootstrap) {
         return {
             status: "disabled",
@@ -266,7 +272,7 @@ async function readJson(response) {
     }
     catch (error) {
         debugInfisicalRuntimeFallback("response.json", error);
-        return undefined;
+        return;
     }
 }
 function isRecord(value) {
@@ -275,7 +281,7 @@ function isRecord(value) {
 function readNestedString(value, path) {
     let current = value;
     for (const key of path) {
-        if (!isRecord(current) || !(key in current)) {
+        if (!(isRecord(current) && key in current)) {
             return null;
         }
         current = current[key];
@@ -300,13 +306,13 @@ function readFirst(env, names) {
             return value;
         }
     }
-    return undefined;
+    return;
 }
 function isTruthyEnv(value) {
     return ["1", "true", "yes", "on"].includes(value?.toLowerCase() ?? "");
 }
 function trimTrailingSlash(value) {
-    return value.replace(/\/+$/u, "");
+    return value.replace(TRAILING_SLASH_PATTERN, "");
 }
 function debugInfisicalRuntimeFallback(message, error) {
     const env = globalThis.process?.env;

package/dist/jobsClient.d.ts

@@ -3,47 +3,47 @@ import type { JsonObject, ListResult } from "./types";
 export type JobsClientConfig = GatewayClientConfig;
 export declare const JOBS_FIELDS: readonly ["tenantId", "workspaceId", "principalId", "topicId", "worktreeId", "jobId", "jobType", "payload", "status", "attempt", "runId", "queue", "priority", "error", "metadata", "limit", "cursor"];
 export type JobStatus = "queued" | "claimed" | "running" | "succeeded" | "failed" | "cancelled";
-export type JobRecord = {
+export interface JobRecord {
+    attempt?: number;
+    createdAt?: number;
+    error?: string;
     jobId: string;
-    tenantId: string;
-    workspaceId?: string;
-    principalId?: string;
-    topicId?: string;
-    worktreeId?: string;
     jobType: string;
+    metadata?: JsonObject | null;
     payload?: JsonObject | null;
-    status: JobStatus | string;
-    attempt?: number;
-    runId?: string;
-    queue?: string;
+    principalId?: string;
     priority?: string;
-    error?: string;
-    metadata?: JsonObject | null;
-    createdAt?: number;
-    updatedAt?: number;
-};
-export type JobRunRecord = {
-    runId: string;
-    jobId?: string;
+    queue?: string;
+    runId?: string;
+    status: JobStatus | string;
     tenantId: string;
+    topicId?: string;
+    updatedAt?: number;
     workspaceId?: string;
-    status: JobStatus | string;
-    startedAt?: number;
+    worktreeId?: string;
+}
+export interface JobRunRecord {
     finishedAt?: number;
+    jobId?: string;
     metadata?: JsonObject | null;
-};
-export type JobsScope = {
+    runId: string;
+    startedAt?: number;
+    status: JobStatus | string;
     tenantId: string;
     workspaceId?: string;
+}
+export interface JobsScope {
+    cursor?: string;
+    jobType?: string;
+    limit?: number;
     principalId?: string;
+    queue?: string;
+    status?: JobStatus;
+    tenantId: string;
     topicId?: string;
+    workspaceId?: string;
     worktreeId?: string;
-    jobType?: string;
-    status?: JobStatus;
-    queue?: string;
-    limit?: number;
-    cursor?: string;
-};
+}
 export type EnqueueJobInput = JobsScope & {
     jobType: string;
     payload?: JsonObject;

package/dist/jobsClient.js

@@ -1,5 +1,6 @@
+// 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 { cleanRequiredString, knownPayload, listResultFromEnvelope, } from "./boundary-client-surface.js";
 import { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
-import { cleanRequiredString, knownPayload, listResultFromEnvelope, } from "./boundaryClientSurface.js";
 import { mapGatewayData } from "./sdkSurface.js";
 export const JOBS_FIELDS = [
     "tenantId",
@@ -51,9 +52,11 @@ export function createJobsClient(config = {}) {
             });
         },
         list(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/jobs${toQueryString(query(input))}`,
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "jobs")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "jobs")));
         },
         claim(input, idempotencyKey) {
             cleanRequiredString(input.tenantId, "tenantId");

package/dist/learningClient.js

@@ -1,5 +1,12 @@
+// 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 { createGatewayRequestClient, toQueryString, } from "./coreClient.js";
-import { createListResult, mapGatewayData, normalizeTopicQuery } from "./sdkSurface.js";
+import { createListResult, mapGatewayData, normalizeTopicQuery, } from "./sdkSurface.js";
+function booleanQueryValue(value) {
+    if (typeof value !== "boolean") {
+        return;
+    }
+    return value ? "true" : "false";
+}
 /**
  * Create the learning client for execution telemetry reads.
  * @param config - Gateway transport configuration.
@@ -7,21 +14,19 @@ import { createListResult, mapGatewayData, normalizeTopicQuery } from "./sdkSurf
  */
 export function createLearningClient(config = {}) {
     const gateway = createGatewayRequestClient(config);
-    const listRecentExecutions = async (args = {}) => gateway.request({
+    const listRecentExecutions = async (args = {}) => gateway
+        .request({
         path: `/api/platform/v1/learning/executions/recent${toQueryString({
             ...normalizeTopicQuery(args),
             namespace: args.namespace,
             audienceMode: args.audienceMode,
-            success: typeof args.success === "boolean"
-                ? args.success
-                    ? "true"
-                    : "false"
-                : undefined,
+            success: booleanQueryValue(args.success),
             limit: typeof args.limit === "number" && Number.isFinite(args.limit)
                 ? String(args.limit)
                 : undefined,
         })}`,
-    }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "executions")));
+    })
+        .then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data) ? data : [], "executions")));
     const getExecutionStats = async (args = {}) => gateway.request({
         path: `/api/platform/v1/learning/executions/stats${toQueryString({
             ...normalizeTopicQuery(args),

package/dist/lenses/index.d.ts

@@ -5,40 +5,136 @@ export * as toolSchemas from "@lucern/contracts/tool-contracts";
 export type LensesClientConfig = LucernClientConfig;
 export type LensesClient = ReturnType<typeof createLensesClient>;
 export declare function createLensesClient(config?: LensesClientConfig): {
-    createLens: (...args: any[]) => any;
-    listLenses: (...args: any[]) => any;
-    applyLensToTopic: (...args: any[]) => any;
-    removeLensFromTopic: (...args: any[]) => any;
+    createLens: (input: {
+        name: string;
+        workspaceId?: string;
+        topicId?: string;
+        description?: string;
+        perspectiveType: import("..").WorkflowLensPerspectiveType;
+        promptTemplates?: import("..").LensPromptTemplateReference[];
+        workflowTemplates?: import("..").LensWorkflowTemplate[];
+        taskTemplates?: import("..").LensTaskTemplate[];
+        questionTemplates?: import("..").LensQuestionTemplate[];
+        filterCriteria?: import("..").JsonObject;
+    } & import("..").TopicIdentifierInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").WorkflowLensRecord>>;
+    listLenses: (query: {
+        workspaceId?: string;
+        topicId?: string;
+        status?: import("..").WorkflowLensStatus;
+        perspectiveType?: import("..").WorkflowLensPerspectiveType;
+    } & import("..").TopicIdentifierInput) => Promise<import("..").PlatformGatewaySuccess<import("..").ListResult<import("..").WorkflowLensRecord, "lenses">>>;
+    applyLensToTopic: (input: {
+        lensId: string;
+        topicId?: string;
+        metadata?: import("..").JsonObject;
+    } & import("..").TopicIdentifierInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").WorkflowLensBindingRecord>>;
+    removeLensFromTopic: (input: {
+        lensId: string;
+        topicId?: string;
+    } & import("..").TopicIdentifierInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").WorkflowLensBindingRecord>>;
     raw: {
-        createBranch: (...args: any[]) => any;
-        createLens: (...args: any[]) => any;
-        listLenses: (...args: any[]) => any;
-        applyLensToTopic: (...args: any[]) => any;
-        removeLensFromTopic: (...args: any[]) => any;
-        create(input: import("..").AddWorktreeInput): any;
-        add(input: import("..").AddWorktreeInput): any;
-        list(query: Parameters<(...args: any[]) => any>[0]): any;
-        listByTopic(query: Parameters<(...args: any[]) => any>[0]): any;
+        createBranch: (input: {
+            name: string;
+            topicId?: string;
+            description?: string;
+            metadata?: import("..").JsonObject;
+        } & import("..").TopicIdentifierInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").WorkflowBranchRecord>>;
+        createLens: (input: {
+            name: string;
+            workspaceId?: string;
+            topicId?: string;
+            description?: string;
+            perspectiveType: import("..").WorkflowLensPerspectiveType;
+            promptTemplates?: import("..").LensPromptTemplateReference[];
+            workflowTemplates?: import("..").LensWorkflowTemplate[];
+            taskTemplates?: import("..").LensTaskTemplate[];
+            questionTemplates?: import("..").LensQuestionTemplate[];
+            filterCriteria?: import("..").JsonObject;
+        } & import("..").TopicIdentifierInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").WorkflowLensRecord>>;
+        listLenses: (query: {
+            workspaceId?: string;
+            topicId?: string;
+            status?: import("..").WorkflowLensStatus;
+            perspectiveType?: import("..").WorkflowLensPerspectiveType;
+        } & import("..").TopicIdentifierInput) => Promise<import("..").PlatformGatewaySuccess<import("..").ListResult<import("..").WorkflowLensRecord, "lenses">>>;
+        applyLensToTopic: (input: {
+            lensId: string;
+            topicId?: string;
+            metadata?: import("..").JsonObject;
+        } & import("..").TopicIdentifierInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").WorkflowLensBindingRecord>>;
+        removeLensFromTopic: (input: {
+            lensId: string;
+            topicId?: string;
+        } & import("..").TopicIdentifierInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").WorkflowLensBindingRecord>>;
+        create(input: import("..").AddWorktreeInput): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        add(input: import("..").AddWorktreeInput): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        list(query: Parameters<(query: {
+            topicId?: string;
+            branchId?: string;
+            status?: import("..").WorkflowWorktreeStatus;
+            groupBy?: "campaign" | "lane" | "flat";
+            lane?: string;
+            campaign?: number;
+            limit?: number;
+        } & import("..").TopicIdentifierInput) => Promise<import("..").PlatformGatewaySuccess<import("..").ListResult<import("..").WorkflowWorktreeRecord, "worktrees">>>>[0]): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").WorktreesListResult>>;
+        listByTopic(query: Parameters<(query: {
+            topicId?: string;
+            branchId?: string;
+            status?: import("..").WorkflowWorktreeStatus;
+            groupBy?: "campaign" | "lane" | "flat";
+            lane?: string;
+            campaign?: number;
+            limit?: number;
+        } & import("..").TopicIdentifierInput) => Promise<import("..").PlatformGatewaySuccess<import("..").ListResult<import("..").WorkflowWorktreeRecord, "worktrees">>>>[0]): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").WorktreesListResult>>;
         findByPairedSprint(input: {
             sprintId: string;
             topicId?: string;
             projectId?: string;
             limit?: number;
-        }): Promise<any>;
-        activate(worktreeId: string): any;
-        updateMetadata(input: import("..").FunctionSurfaceInput): any;
-        update(input: import("..").FunctionSurfaceInput): any;
-        updateTargets(input: Parameters<(...args: any[]) => any>[0]): any;
-        listAll: (...args: any[]) => any;
-        merge(worktreeId: string, input: import("..").MergeInput): any;
-        push: (...args: any[]) => any;
-        openPullRequest: (...args: any[]) => any;
-        pipelineSnapshot(topicId: string): any;
-        complete: (...args: any[]) => any;
-        advancePhase(worktreeId: string, idempotencyKey?: string): any;
-        setPhase(worktreeId: string, phase: string, idempotencyKey?: string): any;
-        patchState: (...args: any[]) => any;
-        bulkCreate: (...args: any[]) => any;
+        }): Promise<import("../client-config").GatewayDataEnvelope<Record<string, unknown>>>;
+        activate(worktreeId: string): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        updateMetadata(input: import("..").FunctionSurfaceInput): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        update(input: import("..").FunctionSurfaceInput): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        updateTargets(input: Parameters<(input: import("..").UpdateWorktreeTargetsInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").WorkflowWorktreeRecord>>>[0]): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        listAll: (query?: {
+            status?: import("..").WorkflowWorktreeStatus;
+            groupBy?: "campaign" | "lane" | "flat";
+            lane?: string;
+            campaign?: number;
+            limit?: number;
+        }) => Promise<import("..").PlatformGatewaySuccess<import("..").ListWorktreesResponse>>;
+        listCampaigns: (query?: {
+            topicId?: string;
+            status?: import("..").WorkflowWorktreeStatus;
+            limit?: number;
+        } & import("..").TopicIdentifierInput) => Promise<import("..").PlatformGatewaySuccess<Record<string, unknown>>>;
+        merge(worktreeId: string, input: import("..").MergeInput): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        push: (worktreeId: string, input: {
+            targetContext: string;
+            beliefIds?: string[];
+            metadata?: import("..").JsonObject;
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").PushWorktreeResponse>>;
+        openPullRequest: (worktreeId: string, input: {
+            summary: string;
+            reviewers?: string[];
+            status?: "pending_review" | "changes_requested" | "approved" | "blocked";
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").OpenPullRequestResponse>>;
+        pipelineSnapshot(topicId: string): import("..").FunctionSurfaceResult<unknown>;
+        complete: (input: {
+            worktreeId: string;
+            keyFindings?: string[];
+            decisionsReached?: string[];
+            nextSteps?: string[];
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        advancePhase(worktreeId: string, idempotencyKey?: string): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        setPhase(worktreeId: string, phase: string, idempotencyKey?: string): Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        patchState: (input: {
+            worktreeId: string;
+            patch: import("../gatewayFacades").GatewayRecord;
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
+        bulkCreate: (input: {
+            worktrees: unknown[];
+        }, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("../gatewayFacades").GatewayRecord>>;
     };
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/lenses/index.js

@@ -1,3 +1,4 @@
+// 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 lensFilterContracts from "@lucern/contracts/lens-filter.contract";
 export * as lensWorkflowContracts from "@lucern/contracts/lens-workflow.contract";

package/dist/mcpClient.d.ts

@@ -1,4 +1,4 @@
-import type { McpGatewayBootstrapRequest, McpGatewayBootstrapResponse, McpGatewayBeginBuildSessionRequest, McpGatewayBeginBuildSessionResponse, McpGatewayContractEvaluationResponse, McpGatewayEvaluateEngineeringContractRequest, McpGatewayEvaluateResearchContractRequest, McpGatewayWritePolicyCheckRequest, McpGatewayWritePolicyCheckResponse } from "@lucern/contracts/mcp-gateway-boundary.contract";
+import type { McpGatewayBeginBuildSessionRequest, McpGatewayBeginBuildSessionResponse, McpGatewayBootstrapRequest, McpGatewayBootstrapResponse, McpGatewayContractEvaluationResponse, McpGatewayEvaluateEngineeringContractRequest, McpGatewayEvaluateResearchContractRequest, McpGatewayWritePolicyCheckRequest, McpGatewayWritePolicyCheckResponse } from "@lucern/contracts/mcp-gateway-boundary.contract";
 import { type GatewayClientConfig, type GatewayScope, type PlatformGatewaySuccess } from "./coreClient";
 export type McpClientConfig = GatewayClientConfig;
 export type McpBootstrapSessionInput = GatewayScope & McpGatewayBootstrapRequest;

package/dist/mcpClient.js

@@ -2,7 +2,7 @@ import { MCP_GATEWAY_BEGIN_BUILD_SESSION_ENDPOINT, MCP_GATEWAY_BOOTSTRAP_ENDPOIN
 import { createGatewayRequestClient, toQueryString, } from "./coreClient.js";
 function toJsonValue(value) {
     if (value === undefined) {
-        return undefined;
+        return;
     }
     const seen = new WeakSet();
     const json = JSON.stringify(value, (_key, candidate) => {
@@ -12,7 +12,7 @@ function toJsonValue(value) {
         if (typeof candidate === "function" ||
             typeof candidate === "symbol" ||
             typeof candidate === "undefined") {
-            return undefined;
+            return;
         }
         if (candidate && typeof candidate === "object") {
             if (seen.has(candidate)) {
@@ -23,7 +23,7 @@ function toJsonValue(value) {
         return candidate;
     });
     if (json === undefined) {
-        return undefined;
+        return;
     }
     return JSON.parse(json);
 }