@lucern/sdk 1.0.29 → 1.0.30

package/dist/{telemetryClient.d.ts → telemetry-client.d.ts}

@@ -2,28 +2,28 @@ import { type GatewayClientConfig } from "./coreClient";
 import type { JsonObject, ListResult } from "./types";
 export type TelemetryClientConfig = GatewayClientConfig;
 export declare const TELEMETRY_FIELDS: readonly ["tenantId", "workspaceId", "principalId", "topicId", "worktreeId", "eventLevel", "eventType", "message", "toolName", "toolCalls", "decision", "policySubject", "policyAction", "policyResource", "runId", "runType", "status", "durationMs", "error", "metadata", "limit", "cursor"];
-export type TelemetryRunRecord = {
+export interface TelemetryRunRecord {
+    finishedAt?: number;
+    metadata?: JsonObject | null;
+    principalId?: string;
     runId: string;
+    runType?: string;
+    startedAt?: number;
+    status?: string;
     tenantId: string;
     workspaceId?: string;
+}
+export interface TelemetryScope {
+    cursor?: string;
+    limit?: number;
     principalId?: string;
     runType?: string;
     status?: string;
-    metadata?: JsonObject | null;
-    startedAt?: number;
-    finishedAt?: number;
-};
-export type TelemetryScope = {
     tenantId: string;
-    workspaceId?: string;
-    principalId?: string;
     topicId?: string;
+    workspaceId?: string;
     worktreeId?: string;
-    runType?: string;
-    status?: string;
-    limit?: number;
-    cursor?: string;
-};
+}
 export type LogSystemEventInput = TelemetryScope & {
     eventLevel: "debug" | "info" | "warn" | "error" | string;
     eventType: string;
@@ -84,4 +84,4 @@ export declare function createTelemetryClient(config?: TelemetryClientConfig): {
     finishRun(input: FinishTelemetryRunInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<TelemetryRunRecord>>;
     listRuns(input: TelemetryScope): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<TelemetryRunRecord, "runs">>>;
 };
-//# sourceMappingURL=telemetryClient.d.ts.map
+//# sourceMappingURL=telemetry-client.d.ts.map

package/dist/{telemetryClient.js → telemetry-client.js}

@@ -1,5 +1,5 @@
+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 TELEMETRY_FIELDS = [
     "tenantId",
@@ -105,10 +105,12 @@ export function createTelemetryClient(config = {}) {
             });
         },
         listRuns(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/telemetry/runs${toQueryString(query(input))}`,
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "runs")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "runs")));
         },
     };
 }
-//# sourceMappingURL=telemetryClient.js.map
+//# sourceMappingURL=telemetry-client.js.map

package/dist/toolRegistryClient.d.ts

@@ -3,43 +3,43 @@ import type { JsonObject, ListResult } from "./types";
 export type ToolRegistryClientConfig = GatewayClientConfig;
 export declare const TOOL_REGISTRY_FIELDS: readonly ["tenantId", "workspaceId", "principalId", "toolName", "packKey", "packVersion", "status", "permissions", "role", "surface", "parameterSchema", "returnSchema", "handlerRef", "executionAdapter", "safetyMetadata", "aclId", "metadata", "limit", "cursor"];
 export type ToolRegistryStatus = "enabled" | "disabled" | "deprecated" | "blocked";
-export type ToolCatalogEntry = {
-    toolName: string;
+export interface ToolCatalogEntry {
+    executionAdapter?: string;
+    handlerRef?: string;
+    metadata?: JsonObject | null;
     packKey?: string;
     packVersion?: string;
-    status?: ToolRegistryStatus | string;
-    permissions?: string[];
-    role?: string;
-    surface?: string;
     parameterSchema?: JsonObject | null;
+    permissions?: string[];
     returnSchema?: JsonObject | null;
-    handlerRef?: string;
-    executionAdapter?: string;
+    role?: string;
     safetyMetadata?: JsonObject | null;
-    metadata?: JsonObject | null;
-};
-export type ToolAclRecord = {
-    aclId?: string;
-    tenantId: string;
-    workspaceId?: string;
-    principalId?: string;
+    status?: ToolRegistryStatus | string;
+    surface?: string;
     toolName: string;
+}
+export interface ToolAclRecord {
+    aclId?: string;
+    createdAt?: number;
+    metadata?: JsonObject | null;
     packKey?: string;
     permissions?: string[];
+    principalId?: string;
     status?: ToolRegistryStatus | string;
-    metadata?: JsonObject | null;
-    createdAt?: number;
-    updatedAt?: number;
-};
-export type ToolRegistryQuery = {
     tenantId: string;
+    toolName: string;
+    updatedAt?: number;
     workspaceId?: string;
-    principalId?: string;
+}
+export interface ToolRegistryQuery {
+    cursor?: string;
+    limit?: number;
     packKey?: string;
+    principalId?: string;
     status?: ToolRegistryStatus;
-    limit?: number;
-    cursor?: string;
-};
+    tenantId: string;
+    workspaceId?: string;
+}
 export type EffectiveToolsSessionType = "agent" | "user";
 export type EffectiveToolsQuery = ToolRegistryQuery & {
     callerRole?: string;
@@ -48,48 +48,48 @@ export type EffectiveToolsQuery = ToolRegistryQuery & {
     permittedToolNames?: string[];
     executableOnly?: boolean;
 };
-export type UpsertCoreToolsInput = {
-    tenantId: string;
-    workspaceId?: string;
-    tools: ToolCatalogEntry[];
+export interface UpsertCoreToolsInput {
     metadata?: JsonObject;
-};
-export type SetPackToolsStatusInput = {
     tenantId: string;
+    tools: ToolCatalogEntry[];
     workspaceId?: string;
+}
+export interface SetPackToolsStatusInput {
+    metadata?: JsonObject;
     packKey: string;
     status: ToolRegistryStatus;
-    metadata?: JsonObject;
-};
-export type CreateToolAclInput = {
     tenantId: string;
     workspaceId?: string;
-    principalId: string;
-    toolName: string;
+}
+export interface CreateToolAclInput {
+    metadata?: JsonObject;
     packKey?: string;
     permissions?: string[];
+    principalId: string;
     status?: ToolRegistryStatus;
-    metadata?: JsonObject;
-};
-export type DeleteToolAclInput = {
     tenantId: string;
+    toolName: string;
     workspaceId?: string;
+}
+export interface DeleteToolAclInput {
     aclId: string;
     metadata?: JsonObject;
-};
-export type RegisterCustomToolInput = {
     tenantId: string;
     workspaceId?: string;
-    toolName: string;
+}
+export interface RegisterCustomToolInput {
+    executionAdapter?: string;
+    handlerRef?: string;
+    metadata?: JsonObject;
     packKey?: string;
     parameterSchema?: JsonObject;
+    permissions?: string[];
     returnSchema?: JsonObject;
-    handlerRef?: string;
-    executionAdapter?: string;
     safetyMetadata?: JsonObject;
-    permissions?: string[];
-    metadata?: JsonObject;
-};
+    tenantId: string;
+    toolName: string;
+    workspaceId?: string;
+}
 export type ToolCatalogResponse = ListResult<ToolCatalogEntry, "tools">;
 export type ToolAclResponse = ListResult<ToolAclRecord, "acls">;
 export declare function createToolRegistryClient(config?: ToolRegistryClientConfig): {

package/dist/toolRegistryClient.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 TOOL_REGISTRY_FIELDS = [
     "tenantId",
@@ -52,23 +53,30 @@ export function createToolRegistryClient(config = {}) {
     const gateway = createGatewayRequestClient(config);
     return {
         listCatalog(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/tools/catalog${toQueryString(query(input))}`,
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
         },
         listExecutable(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/tools/executable${toQueryString(query(input))}`,
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
         },
         listEffectiveTools(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/tools/effective${toQueryString(effectiveToolsQuery(input))}`,
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
         },
         upsertCoreTools(input, idempotencyKey) {
             cleanRequiredString(input.tenantId, "tenantId");
-            return gateway.request({
+            return gateway
+                .request({
                 path: "/api/platform/v1/tools/core",
                 method: "PUT",
                 body: {
@@ -78,17 +86,20 @@ export function createToolRegistryClient(config = {}) {
                     tools: input.tools,
                 },
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
         },
         setPackToolsStatus(input, idempotencyKey) {
             cleanRequiredString(input.tenantId, "tenantId");
             cleanRequiredString(input.packKey, "packKey");
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/tools/packs/${encodeURIComponent(input.packKey)}/status`,
                 method: "PATCH",
                 body: writeBody(input, "tools.setPackToolsStatus"),
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
+            })
+                .then((response) => mapGatewayData(response, (data) => listResultFromEnvelope(data, "tools")));
         },
         createAcl(input, idempotencyKey) {
             cleanRequiredString(input.tenantId, "tenantId");

package/dist/topics/index.d.ts

@@ -1,38 +1,38 @@
 import { type LucernClientConfig } from "../client";
-export * as topicContracts from "@lucern/contracts/topics/v1";
 export * as toolSchemas from "@lucern/contracts/tool-contracts";
+export * as topicContracts from "@lucern/contracts/topics/v1";
 export type TopicsClientConfig = LucernClientConfig;
 export type TopicsClient = ReturnType<typeof createTopicsClient>;
 export declare function createTopicsClient(config?: TopicsClientConfig): {
-    createTopic: (input: Parameters<(...args: any[]) => any>[0]) => any;
-    getTopic: (...args: any[]) => any;
-    listTopics: (input?: Parameters<(...args: any[]) => any>[0]) => any;
-    updateTopic: (topicId: string, input: Parameters<(...args: any[]) => any>[1]) => any;
+    createTopic: (input: Parameters<(input: import("..").TopicCreateInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicRecord>>>[0]) => Promise<import("../client-config").GatewayDataEnvelope<unknown>>;
+    getTopic: (topicId: string) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicRecord>>;
+    listTopics: (input?: Parameters<(query?: import("..").TopicListInput) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicListResponse>>>[0]) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicListResponse>>;
+    updateTopic: (topicId: string, input: Parameters<(topicId: string, input: import("..").TopicUpdateInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicRecord>>>[1]) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicRecord>>;
     getTopicTree: (input: {
         rootId: string;
         maxDepth?: number;
-    }) => any;
-    getTopicCoverage: (topicId: string, query?: Parameters<(...args: any[]) => any>[1]) => any;
-    materializeTopicGraph: (input?: import("..").FunctionSurfaceInput, idempotencyKey?: string) => any;
-    getTopicGraphSpine: (input?: import("..").FunctionSurfaceInput) => any;
-    removeTopic: (...args: any[]) => any;
+    }) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicTreeResponse>>;
+    getTopicCoverage: (topicId: string, query?: Parameters<(topicId: string, query?: import("..").TopicCoverageQuery) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicCoverageResponse>>>[1]) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicCoverageResponse>>;
+    materializeTopicGraph: (input?: import("..").FunctionSurfaceInput, idempotencyKey?: string) => Promise<import("../client-config").GatewayDataEnvelope<unknown>>;
+    getTopicGraphSpine: (input?: import("..").FunctionSurfaceInput) => Promise<import("../client-config").GatewayDataEnvelope<unknown>>;
+    removeTopic: (topicId: string, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<Record<string, unknown>>>;
     raw: {
-        list(input?: Parameters<(...args: any[]) => any>[0]): any;
-        get: (...args: any[]) => any;
-        create(input: Parameters<(...args: any[]) => any>[0]): any;
-        update(topicId: string, input: Parameters<(...args: any[]) => any>[1]): any;
-        tree(topicId: string, query?: Parameters<(...args: any[]) => any>[1]): any;
+        list(input?: Parameters<(query?: import("..").TopicListInput) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicListResponse>>>[0]): Promise<import("..").PlatformGatewaySuccess<import("..").TopicListResponse>>;
+        get: (topicId: string) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicRecord>>;
+        create(input: Parameters<(input: import("..").TopicCreateInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicRecord>>>[0]): Promise<import("../client-config").GatewayDataEnvelope<unknown>>;
+        update(topicId: string, input: Parameters<(topicId: string, input: import("..").TopicUpdateInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicRecord>>>[1]): Promise<import("..").PlatformGatewaySuccess<import("..").TopicRecord>>;
+        tree(topicId: string, query?: Parameters<(topicId: string, query?: import("..").TopicTreeQuery) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicTreeResponse>>>[1]): Promise<import("..").PlatformGatewaySuccess<import("..").TopicTreeResponse>>;
         getTree(input: {
             rootId: string;
             maxDepth?: number;
-        }): any;
-        coverage(topicId: string, query?: Parameters<(...args: any[]) => any>[1]): any;
-        remove: (...args: any[]) => any;
-        bulkCreate: (...args: any[]) => any;
-        materializeGraph(input?: import("..").FunctionSurfaceInput, idempotencyKey?: string): any;
-        materializeTopicGraph(input?: import("..").FunctionSurfaceInput, idempotencyKey?: string): any;
-        graphSpine(input?: import("..").FunctionSurfaceInput): any;
-        getTopicGraphSpine(input?: import("..").FunctionSurfaceInput): any;
+        }): Promise<import("..").PlatformGatewaySuccess<import("..").TopicTreeResponse>>;
+        coverage(topicId: string, query?: Parameters<(topicId: string, query?: import("..").TopicCoverageQuery) => Promise<import("..").PlatformGatewaySuccess<import("..").TopicCoverageResponse>>>[1]): Promise<import("..").PlatformGatewaySuccess<import("..").TopicCoverageResponse>>;
+        remove: (topicId: string, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<Record<string, unknown>>>;
+        bulkCreate: (input: import("..").TopicBulkCreateInput, idempotencyKey?: string) => Promise<import("..").PlatformGatewaySuccess<Record<string, unknown>>>;
+        materializeGraph(input?: import("..").FunctionSurfaceInput, idempotencyKey?: string): Promise<import("../client-config").GatewayDataEnvelope<unknown>>;
+        materializeTopicGraph(input?: import("..").FunctionSurfaceInput, idempotencyKey?: string): Promise<import("../client-config").GatewayDataEnvelope<unknown>>;
+        graphSpine(input?: import("..").FunctionSurfaceInput): Promise<import("../client-config").GatewayDataEnvelope<unknown>>;
+        getTopicGraphSpine(input?: import("..").FunctionSurfaceInput): Promise<import("../client-config").GatewayDataEnvelope<unknown>>;
     };
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/topics/index.js

@@ -1,6 +1,7 @@
+// 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 topicContracts from "@lucern/contracts/topics/v1";
 export * as toolSchemas from "@lucern/contracts/tool-contracts";
+export * as topicContracts from "@lucern/contracts/topics/v1";
 export function createTopicsClient(config = {}) {
     const topics = createLucernClient(config).topics;
     return {

package/dist/topicsClient.d.ts

@@ -35,16 +35,16 @@ export type TopicUpdateInput = TopicIdentifierInput & {
     visibility?: "private" | "team" | "firm" | "external" | "public";
 };
 /** Options for retrieving the topic hierarchy. */
-export type TopicTreeQuery = {
+export interface TopicTreeQuery {
     maxDepth?: number;
-};
+}
 /** Options for retrieving belief/question/evidence coverage across a topic tree. */
-export type TopicCoverageQuery = {
+export interface TopicCoverageQuery {
     includeDescendants?: boolean;
     maxDepth?: number;
-};
+}
 /** Input for batch-creating topics. */
-export type TopicBulkCreateInput = {
+export interface TopicBulkCreateInput {
     topics: Array<TopicIdentifierInput & {
         globalId?: string;
         name: string;
@@ -61,7 +61,7 @@ export type TopicBulkCreateInput = {
         metadata?: JsonObject;
         createdBy?: string;
     }>;
-};
+}
 /**
  * Create the topics client for managing hierarchical knowledge containers.
  *

package/dist/topicsClient.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 { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
 import { asRecord, createListResult, mapGatewayData, resolveTopicId, withTopicAlias, } from "./sdkSurface.js";
 function cleanString(value) {
@@ -27,9 +28,10 @@ function normalizeTopicTreeNode(value) {
 export function createTopicsClient(config = {}) {
     const gateway = createGatewayRequestClient(config);
     return {
-        async list(query = {}) {
+        list(query = {}) {
             const topicId = resolveTopicId(query);
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/topics${toQueryString({
                     ...(topicId ? { topicId } : {}),
                     ontologyId: query.ontologyId,
@@ -37,7 +39,8 @@ export function createTopicsClient(config = {}) {
                     status: query.status,
                     type: query.type,
                 })}`,
-            }).then((response) => mapGatewayData(response, (data) => {
+            })
+                .then((response) => mapGatewayData(response, (data) => {
                 const record = asRecord(data);
                 const items = Array.isArray(record.topics)
                     ? record.topics.map(normalizeTopicRecord)
@@ -50,14 +53,17 @@ export function createTopicsClient(config = {}) {
                 };
             }));
         },
-        async get(topicId) {
-            return gateway.request({
+        get(topicId) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}`,
-            }).then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(asRecord(data).topic ?? data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(asRecord(data).topic ?? data)));
         },
-        async create(input, idempotencyKey) {
+        create(input, idempotencyKey) {
             const topicId = resolveTopicId(input);
-            return gateway.request({
+            return gateway
+                .request({
                 path: "/api/platform/v1/topics",
                 method: "POST",
                 body: {
@@ -66,20 +72,25 @@ export function createTopicsClient(config = {}) {
                     type: input.type ?? "theme",
                 },
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(data)));
         },
-        async update(topicId, input, idempotencyKey) {
-            return gateway.request({
+        update(topicId, input, idempotencyKey) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}`,
                 method: "PATCH",
                 body: input,
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
-            }).then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(data)));
+            })
+                .then((response) => mapGatewayData(response, (data) => normalizeTopicRecord(data)));
         },
-        async getTree(topicId, query = {}) {
-            return gateway.request({
+        getTree(topicId, query = {}) {
+            return gateway
+                .request({
                 path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}/tree${toQueryString(query)}`,
-            }).then((response) => mapGatewayData(response, (data) => {
+            })
+                .then((response) => mapGatewayData(response, (data) => {
                 const record = asRecord(data);
                 return {
                     tree: Array.isArray(record.tree)
@@ -88,12 +99,12 @@ export function createTopicsClient(config = {}) {
                 };
             }));
         },
-        async getCoverage(topicId, query = {}) {
+        getCoverage(topicId, query = {}) {
             return gateway.request({
                 path: `/api/platform/v1/topics/${encodeURIComponent(topicId)}/coverage${toQueryString(query)}`,
             });
         },
-        async remove(topicId, idempotencyKey) {
+        remove(topicId, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/topics/remove",
                 method: "POST",
@@ -101,7 +112,7 @@ export function createTopicsClient(config = {}) {
                 idempotencyKey: idempotencyKey ?? randomIdempotencyKey(),
             });
         },
-        async bulkCreate(input, idempotencyKey) {
+        bulkCreate(input, idempotencyKey) {
             return gateway.request({
                 path: "/api/platform/v1/topics/bulk",
                 method: "POST",