@lucern/sdk 1.0.28 → 1.0.30

package/dist/gatewayFacades.js

@@ -1,13 +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.
+// 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 { createGatewayRequestClient, randomIdempotencyKey, toQueryString, } from "./coreClient.js";
 import { createTopicsClient, } from "./topicsClient.js";
-function serializeTypes(types) {
-    return Array.isArray(types) && types.length > 0 ? types.join(",") : undefined;
-}
-export { createBeliefsFacade, createContradictionsFacade, createEdgesFacade, createEvidenceFacade, createEventsFacade, createGraphFacade, createIdentityFacade, createOntologiesFacade, createQuestionsFacade } from "./gatewayFacades.factories.js";
+export { createBeliefsFacade, createContradictionsFacade, createEdgesFacade, createEventsFacade, createEvidenceFacade, createGraphFacade, createIdentityFacade, createOntologiesFacade, createQuestionsFacade, } from "./gatewayFacades.factories.js";
 export function createSearchFacade(config = {}) {
     const gateway = createGatewayRequestClient(config);
     return {
-        async query(input) {
+        query(input) {
             return gateway.request({
                 path: "/api/platform/v1/search",
                 method: "POST",
@@ -19,7 +18,7 @@ export function createSearchFacade(config = {}) {
 export function createTasksFacade(config = {}) {
     const gateway = createGatewayRequestClient(config);
     return {
-        async create(input, idempotencyKey = randomIdempotencyKey()) {
+        create(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/tasks",
                 method: "POST",
@@ -27,7 +26,7 @@ export function createTasksFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async update(input, idempotencyKey = randomIdempotencyKey()) {
+        update(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/tasks/${encodeURIComponent(input.id)}`,
                 method: "PATCH",
@@ -46,7 +45,7 @@ export function createTasksFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async complete(input, idempotencyKey = randomIdempotencyKey()) {
+        complete(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/tasks/${encodeURIComponent(input.id)}/complete`,
                 method: "POST",
@@ -56,7 +55,7 @@ export function createTasksFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async list(query) {
+        list(query) {
             return gateway.request({
                 path: `/api/platform/v1/tasks${toQueryString({
                     topicId: query.topicId,
@@ -74,16 +73,16 @@ export function createTopicsFacade(config = {}) {
         create: topicsClient.create,
         get: topicsClient.get,
         list: topicsClient.list,
-        async update(input, idempotencyKey) {
+        update(input, idempotencyKey) {
             const { id, ...rest } = input;
             return topicsClient.update(id, rest, idempotencyKey);
         },
-        async tree(input) {
+        tree(input) {
             return topicsClient.getTree(input.id, {
                 maxDepth: input.maxDepth,
             });
         },
-        async coverage(input) {
+        coverage(input) {
             return topicsClient.getCoverage(input.id, {
                 includeDescendants: input.includeDescendants,
                 maxDepth: input.maxDepth,
@@ -96,7 +95,7 @@ export function createTopicsFacade(config = {}) {
 export function createWebhooksFacade(config = {}) {
     const gateway = createGatewayRequestClient(config);
     return {
-        async create(input, idempotencyKey = randomIdempotencyKey()) {
+        create(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/webhooks",
                 method: "POST",
@@ -104,19 +103,19 @@ export function createWebhooksFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async list(query = {}) {
+        list(query = {}) {
             return gateway.request({
                 path: `/api/platform/v1/webhooks${toQueryString({
                     topicId: query.topicId,
                 })}`,
             });
         },
-        async get(id) {
+        get(id) {
             return gateway.request({
                 path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}`,
             });
         },
-        async update(id, input, idempotencyKey = randomIdempotencyKey()) {
+        update(id, input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}`,
                 method: "PATCH",
@@ -124,14 +123,14 @@ export function createWebhooksFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async delete(id, idempotencyKey = randomIdempotencyKey()) {
+        delete(id, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}`,
                 method: "DELETE",
                 idempotencyKey,
             });
         },
-        async test(id, input = {}, idempotencyKey = randomIdempotencyKey()) {
+        test(id, input = {}, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}/test`,
                 method: "POST",
@@ -139,14 +138,14 @@ export function createWebhooksFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async deliveries(id, query = {}) {
+        deliveries(id, query = {}) {
             return gateway.request({
                 path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}/deliveries${toQueryString({
                     limit: query.limit,
                 })}`,
             });
         },
-        async health(id) {
+        health(id) {
             return gateway.request({
                 path: `/api/platform/v1/webhooks/${encodeURIComponent(id)}/health`,
             });
@@ -156,7 +155,7 @@ export function createWebhooksFacade(config = {}) {
 export function createWorktreesFacade(config = {}) {
     const gateway = createGatewayRequestClient(config);
     return {
-        async create(input, idempotencyKey = randomIdempotencyKey()) {
+        create(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees",
                 method: "POST",
@@ -164,7 +163,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async list(query) {
+        list(query) {
             return gateway.request({
                 path: `/api/platform/v1/worktrees${toQueryString({
                     topicId: query.topicId,
@@ -176,7 +175,7 @@ export function createWorktreesFacade(config = {}) {
                 })}`,
             });
         },
-        async listCampaigns(query = {}) {
+        listCampaigns(query = {}) {
             return gateway.request({
                 path: `/api/platform/v1/worktrees/campaigns${toQueryString({
                     topicId: query.topicId,
@@ -185,7 +184,7 @@ export function createWorktreesFacade(config = {}) {
                 })}`,
             });
         },
-        async activate(input, idempotencyKey = randomIdempotencyKey()) {
+        activate(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/worktrees/${encodeURIComponent(input.id)}/activate`,
                 method: "POST",
@@ -193,7 +192,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async update(input, idempotencyKey = randomIdempotencyKey()) {
+        update(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/worktrees/${encodeURIComponent(input.id)}`,
                 method: "PATCH",
@@ -220,7 +219,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async merge(input, idempotencyKey = randomIdempotencyKey()) {
+        merge(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/worktrees/${encodeURIComponent(input.id)}/merge`,
                 method: "POST",
@@ -231,7 +230,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async updateTargets(input, idempotencyKey = randomIdempotencyKey()) {
+        updateTargets(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: `/api/platform/v1/worktrees/${encodeURIComponent(input.id)}/targets`,
                 method: "POST",
@@ -244,7 +243,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async complete(input, idempotencyKey = randomIdempotencyKey()) {
+        complete(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/complete",
                 method: "POST",
@@ -252,7 +251,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async advancePhase(input, idempotencyKey = randomIdempotencyKey()) {
+        advancePhase(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/advance-phase",
                 method: "POST",
@@ -260,7 +259,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async setPhase(input, idempotencyKey = randomIdempotencyKey()) {
+        setPhase(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/set-phase",
                 method: "POST",
@@ -268,7 +267,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async patchState(input, idempotencyKey = randomIdempotencyKey()) {
+        patchState(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/patch-state",
                 method: "POST",
@@ -276,7 +275,7 @@ export function createWorktreesFacade(config = {}) {
                 idempotencyKey,
             });
         },
-        async bulkCreate(input, idempotencyKey = randomIdempotencyKey()) {
+        bulkCreate(input, idempotencyKey = randomIdempotencyKey()) {
             return gateway.request({
                 path: "/api/platform/v1/worktrees/bulk",
                 method: "POST",

package/dist/graphAnalysisClient.d.ts

@@ -1,67 +1,67 @@
+import type { GraphIntelligenceQueryMode, GraphIntelligenceQueryWithTools } from "@lucern/contracts";
 import { type GatewayClientConfig } from "./coreClient";
 import type { JsonObject, ListResult } from "./types";
-import type { GraphIntelligenceQueryMode, GraphIntelligenceQueryWithTools } from "@lucern/contracts";
 export type GraphAnalysisClientConfig = GatewayClientConfig;
 export declare const GRAPH_ANALYSIS_ANALYSIS_FIELDS: readonly ["topicId", "projectId", "workspaceId", "analysisType", "healthScore", "findings", "suggestions", "sourceNodeIds", "sourceEdgeIds", "detectorVersions", "metadata"];
 export declare const GRAPH_ANALYSIS_SUGGESTION_FIELDS: readonly ["topicId", "projectId", "workspaceId", "analysisId", "suggestions", "metadata"];
 export declare const GRAPH_ANALYSIS_COMPUTE_FIELDS: readonly ["topicId", "projectId", "workspaceId", "analysisType", "sourceNodeIds", "sourceEdgeIds", "detectorVersions", "metadata"];
-export type GraphAnalysisFinding = {
-    id?: string;
-    severity?: "critical" | "warning" | "info" | string;
+export interface GraphAnalysisFinding {
     category?: string;
-    title: string;
     description?: string;
-    nodeIds?: string[];
-    nodeLabels?: string[];
     detector?: string;
+    id?: string;
     importance?: number;
-    totalCount?: number;
     metadata?: JsonObject;
-};
-export type GraphAnalysisSuggestion = {
-    suggestionId?: string;
-    findingId?: string;
+    nodeIds?: string[];
+    nodeLabels?: string[];
+    severity?: "critical" | "warning" | "info" | string;
+    title: string;
+    totalCount?: number;
+}
+export interface GraphAnalysisSuggestion {
     actionType: string;
-    targetNodeIds?: string[];
+    findingId?: string;
+    healthScore?: number;
+    metadata?: JsonObject;
     priority?: "P0" | "P1" | "P2" | "P3" | string;
     rationale?: string;
     status?: GraphAnalysisSuggestionStatus;
-    healthScore?: number;
-    metadata?: JsonObject;
-};
+    suggestionId?: string;
+    targetNodeIds?: string[];
+}
 export type GraphAnalysisSuggestionStatus = "open" | "accepted" | "dismissed" | "applied" | "superseded";
-export type GraphAnalysisRecord = {
+export interface GraphAnalysisRecord {
     analysisId?: string;
-    topicId: string;
-    workspaceId: string;
     analysisType: string;
-    healthScore?: number;
-    findings?: GraphAnalysisFinding[];
-    suggestions?: GraphAnalysisSuggestion[];
-    sourceNodeIds?: string[];
-    sourceEdgeIds?: string[];
+    createdAt?: number;
     detectorVersions?: Record<string, string>;
+    findings?: GraphAnalysisFinding[];
+    healthScore?: number;
     metadata?: JsonObject | null;
-    createdAt?: number;
+    sourceEdgeIds?: string[];
+    sourceNodeIds?: string[];
+    suggestions?: GraphAnalysisSuggestion[];
+    topicId: string;
     updatedAt?: number;
-};
-export type GraphAnalysisChangeRecord = {
-    changeId?: string;
+    workspaceId: string;
+}
+export interface GraphAnalysisChangeRecord {
     analysisId?: string;
-    topicId?: string;
-    workspaceId?: string;
+    changeId?: string;
     changeType?: string;
-    nodeIds?: string[];
+    createdAt?: number;
     edgeIds?: string[];
-    summary?: string;
     metadata?: JsonObject | null;
-    createdAt?: number;
-};
-export type TopicProjectAliasInput = {
+    nodeIds?: string[];
+    summary?: string;
     topicId?: string;
+    workspaceId?: string;
+}
+export interface TopicProjectAliasInput {
     /** @deprecated Use topicId. */
     projectId?: string;
-};
+    topicId?: string;
+}
 export type SaveGraphAnalysisInput = TopicProjectAliasInput & {
     workspaceId: string;
     analysisType: string;
@@ -89,12 +89,12 @@ export type SaveGraphSuggestionsInput = TopicProjectAliasInput & {
     suggestions: GraphAnalysisSuggestion[];
     metadata?: JsonObject;
 };
-export type UpdateGraphSuggestionStatusInput = {
-    suggestionId: string;
-    status: GraphAnalysisSuggestionStatus;
-    rationale?: string;
+export interface UpdateGraphSuggestionStatusInput {
     metadata?: JsonObject;
-};
+    rationale?: string;
+    status: GraphAnalysisSuggestionStatus;
+    suggestionId: string;
+}
 export type ListGraphSuggestionsInput = TopicProjectAliasInput & {
     workspaceId?: string;
     analysisId?: string;
@@ -128,10 +128,10 @@ export type ComputeOrRequestGraphAnalysisInput = TopicProjectAliasInput & {
 export type GraphAnalysisListResponse = ListResult<GraphAnalysisRecord, "analyses">;
 export type GraphAnalysisSuggestionsResponse = ListResult<GraphAnalysisSuggestion, "suggestions">;
 export type GraphAnalysisChangesResponse = ListResult<GraphAnalysisChangeRecord, "changes">;
-export type ListGraphIntelligenceQueriesInput = {
+export interface ListGraphIntelligenceQueriesInput {
     categoryId?: string;
     mode?: GraphIntelligenceQueryMode;
-};
+}
 export type RunGraphIntelligenceQueryInput = TopicProjectAliasInput & {
     queryId?: string;
     prompt?: string;
@@ -143,43 +143,43 @@ export type RunGraphIntelligenceQueryInput = TopicProjectAliasInput & {
     maxDepth?: number;
     beliefIds?: string[];
 };
-export type GraphIntelligenceQueryCatalogResponse = {
-    schemaVersion: string;
+export interface GraphIntelligenceQueryCatalogResponse {
     catalogVersion: string;
     categories: unknown[];
     modes: readonly GraphIntelligenceQueryMode[];
+    publicToolNamesByMode: Record<string, readonly string[]>;
     queries: GraphIntelligenceQueryWithTools[];
     quickQueries: unknown[];
-    publicToolNamesByMode: Record<string, readonly string[]>;
-    totalQueries: number;
-};
-export type GraphIntelligenceQueryRunResponse = {
     schemaVersion: string;
+    totalQueries: number;
+}
+export interface GraphIntelligenceQueryRunResponse {
+    analysis: JsonObject;
     catalogVersion: string;
-    topicId: string;
-    requestedTopicId?: string;
-    query: GraphIntelligenceQueryWithTools | JsonObject;
+    context: JsonObject;
+    guidance: JsonObject;
+    input: string | null;
     mode: GraphIntelligenceQueryMode;
     prompt: string;
-    input: string | null;
+    query: GraphIntelligenceQueryWithTools | JsonObject;
+    requestedTopicId?: string;
+    schemaVersion: string;
     toolPlan: Array<{
         toolName: string;
         args: JsonObject;
     }>;
-    analysis: JsonObject;
-    context: JsonObject;
-    guidance: JsonObject;
-};
+    topicId: string;
+}
 export declare function createGraphAnalysisClient(config?: GraphAnalysisClientConfig): {
     listGraphIntelligenceQueries(input?: ListGraphIntelligenceQueriesInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphIntelligenceQueryCatalogResponse>>;
     runGraphIntelligenceQuery(input: RunGraphIntelligenceQueryInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphIntelligenceQueryRunResponse>>;
     saveAnalysis(input: SaveGraphAnalysisInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalysisRecord>>;
-    listAnalyses(input: ListGraphAnalysesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<any, "analyses">>>;
+    listAnalyses(input: ListGraphAnalysesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<GraphAnalysisRecord, "analyses">>>;
     getLatestAnalysis(input: GetLatestGraphAnalysisInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalysisRecord>>;
     saveSuggestions(input: SaveGraphSuggestionsInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalysisSuggestionsResponse>>;
     updateSuggestionStatus(input: UpdateGraphSuggestionStatusInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalysisSuggestion>>;
-    listSuggestions(input: ListGraphSuggestionsInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<any, "suggestions">>>;
-    listGraphChanges(input: ListGraphChangesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<any, "changes">>>;
+    listSuggestions(input: ListGraphSuggestionsInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<GraphAnalysisSuggestion, "suggestions">>>;
+    listGraphChanges(input: ListGraphChangesInput): Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<GraphAnalysisChangeRecord, "changes">>>;
     computeOrRequestAnalysis(input: ComputeOrRequestGraphAnalysisInput, idempotencyKey?: string): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalysisRecord>>;
 };
 //# sourceMappingURL=graphAnalysisClient.d.ts.map

package/dist/graphAnalysisClient.js

@@ -88,6 +88,13 @@ function normalizeRunQueryPayload(input) {
         projectId: undefined,
     };
 }
+function readGatewayList(data, key) {
+    if (data && typeof data === "object" && key in data) {
+        const candidate = data[key];
+        return Array.isArray(candidate) ? candidate : [];
+    }
+    return Array.isArray(data) ? data : [];
+}
 export function createGraphAnalysisClient(config = {}) {
     const gateway = createGatewayRequestClient(config);
     return {
@@ -117,13 +124,11 @@ export function createGraphAnalysisClient(config = {}) {
             });
         },
         listAnalyses(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/graph-analysis/analyses${toQueryString(graphAnalysisQuery(input))}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data.analyses)
-                ? (data.analyses)
-                : Array.isArray(data)
-                    ? data
-                    : [], "analyses")));
+            })
+                .then((response) => mapGatewayData(response, (data) => createListResult(readGatewayList(data, "analyses"), "analyses")));
         },
         getLatestAnalysis(input) {
             return gateway.request({
@@ -155,7 +160,8 @@ export function createGraphAnalysisClient(config = {}) {
             });
         },
         listSuggestions(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/graph-analysis/suggestions${toQueryString({
                     topicId: requireTopicId(input),
                     workspaceId: input.workspaceId,
@@ -165,14 +171,12 @@ export function createGraphAnalysisClient(config = {}) {
                     limit: input.limit,
                     cursor: input.cursor,
                 })}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data.suggestions)
-                ? (data.suggestions)
-                : Array.isArray(data)
-                    ? data
-                    : [], "suggestions")));
+            })
+                .then((response) => mapGatewayData(response, (data) => createListResult(readGatewayList(data, "suggestions"), "suggestions")));
         },
         listGraphChanges(input) {
-            return gateway.request({
+            return gateway
+                .request({
                 path: `/api/platform/v1/graph-analysis/changes${toQueryString({
                     topicId: requireTopicId(input),
                     workspaceId: input.workspaceId,
@@ -188,11 +192,8 @@ export function createGraphAnalysisClient(config = {}) {
                     limit: input.limit,
                     cursor: input.cursor,
                 })}`,
-            }).then((response) => mapGatewayData(response, (data) => createListResult(Array.isArray(data.changes)
-                ? (data.changes)
-                : Array.isArray(data)
-                    ? data
-                    : [], "changes")));
+            })
+                .then((response) => mapGatewayData(response, (data) => createListResult(readGatewayList(data, "changes"), "changes")));
         },
         computeOrRequestAnalysis(input, idempotencyKey) {
             return gateway.request({

package/dist/graphClient.d.ts

@@ -1,8 +1,8 @@
 import { type GatewayClientConfig, LucernApiError } from "./coreClient";
 import type { DeleteEdgeResponse, GraphAnalyticsMetric, GraphAnalyticsResponse, GraphNeighborhoodResponse, GraphPathResponse, JsonObject, ListResult, PlatformGraphEdge, PlatformGraphNode, TextAliasInput, TopicIdentifierInput } from "./types";
-export { LucernApiError };
 export type { GatewayScope, PlatformGatewaySuccess } from "./coreClient";
 export type { CreateEdgeResponse, CreateNodeResponse, DeleteEdgeResponse, GraphAnalyticsMetric, GraphAnalyticsResponse, GraphNeighborhoodResponse, GraphPathResponse, ListResult, QueryEdgesResponse, QueryNodesResponse, UpdateNodeResponse, } from "./types";
+export { LucernApiError };
 /** Configuration for the graph client. */
 export type GraphClientConfig = GatewayClientConfig;
 /** Filter parameters for listing graph nodes. */
@@ -52,10 +52,10 @@ export type UpdateNodeInput = {
     verificationStatus?: string;
 } & TextAliasInput;
 /** Input for retrieving a single graph node by canonical identifier. */
-export type GetNodeInput = {
-    nodeId?: string;
+export interface GetNodeInput {
     globalId?: string;
-};
+    nodeId?: string;
+}
 /** Filter parameters for listing graph edges. */
 export type ListEdgesInput = {
     edgeId?: string;
@@ -83,58 +83,58 @@ export type CreateEdgeInput = {
     derivationType?: string;
 } & TopicIdentifierInput;
 /** Filter for selecting edges to delete. */
-export type DeleteEdgeInput = {
+export interface DeleteEdgeInput {
     edgeId?: string;
+    edgeType?: string;
     fromNodeId?: string;
     toNodeId?: string;
-    edgeType?: string;
-};
+}
 /** Input for batch-creating multiple graph nodes. */
-export type BatchCreateNodesInput = {
-    nodes: Array<CreateNodeInput>;
-};
+export interface BatchCreateNodesInput {
+    nodes: CreateNodeInput[];
+}
 /** Input for superseding an existing graph node with a new version. */
-export type SupersedeNodeInput = {
-    oldNodeId?: string;
-    nodeId?: string;
-    newGlobalId?: string;
-    newCanonicalText?: string;
-    text?: string;
+export interface SupersedeNodeInput {
     canonicalText?: string;
+    newCanonicalText?: string;
     newContentHash?: string;
+    newGlobalId?: string;
+    nodeId?: string;
+    oldNodeId?: string;
     reason?: string;
-};
+    text?: string;
+}
 /** Input for updating a node's verification state. */
-export type VerifyNodeInput = {
-    nodeId?: string;
+export interface VerifyNodeInput {
+    confidence?: number;
     id?: string;
+    nodeId?: string;
     verificationStatus: string;
-    confidence?: number;
-};
+}
 /** Input for permanently deleting a node via admin-only API. */
-export type HardDeleteNodeInput = {
-    nodeId?: string;
+export interface HardDeleteNodeInput {
+    allowBeliefHardDelete?: boolean;
     id?: string;
+    nodeId?: string;
     reason: string;
-    allowBeliefHardDelete?: boolean;
-};
+}
 /** Input for retrieving the local neighborhood around a graph node. */
-export type NeighborhoodInput = {
+export interface NeighborhoodInput {
     globalId?: string;
     globalIds?: string;
     maxDepth?: number;
-};
+}
 /** Input for finding the shortest path between two graph nodes. */
-export type PathInput = {
+export interface PathInput {
     fromGlobalId: string;
-    toGlobalId: string;
     maxDepth?: number;
-};
+    toGlobalId: string;
+}
 /** Input for retrieving a specific graph analytics metric. */
-export type AnalyticsInput = {
-    metric?: GraphAnalyticsMetric;
+export interface AnalyticsInput {
     limit?: number;
-};
+    metric?: GraphAnalyticsMetric;
+}
 /** Input for traversing the graph from a starting node. */
 export type TraverseInput = {
     startNode: string;
@@ -251,7 +251,7 @@ export declare function createGraphClient(config?: GraphClientConfig): {
     /**
      * Retrieve graph analytics for the requested metric.
      */
-    getAnalytics(query?: AnalyticsInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalyticsResponse>>;
+    getAnalytics(query?: AnalyticsInput): Promise<import("./coreClient").PlatformGatewaySuccess<GraphAnalyticsResponse<GraphAnalyticsMetric>>>;
 } & {
     queryNodes: (query: ListNodesInput) => Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphNode, "nodes">>>;
     queryEdges: (query: ListEdgesInput) => Promise<import("./coreClient").PlatformGatewaySuccess<ListResult<PlatformGraphEdge, "edges">>>;