@lucern/sdk 0.3.0-alpha.2 → 0.3.0-alpha.3

package/dist/graphAnalysisClient.d.ts

@@ -0,0 +1,140 @@
+import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
+import { JsonObject, ListResult } from './types.js';
+import './authContext.js';
+import './contracts/auth-session.contract.js';
+import './contracts/workflow-runtime.contract.js';
+import './contracts/lens-workflow.contract.js';
+import './contracts/lens-filter.contract.js';
+
+type GraphAnalysisClientConfig = GatewayClientConfig;
+declare const GRAPH_ANALYSIS_ANALYSIS_FIELDS: readonly ["topicId", "projectId", "workspaceId", "analysisType", "healthScore", "findings", "suggestions", "sourceNodeIds", "sourceEdgeIds", "detectorVersions", "metadata"];
+declare const GRAPH_ANALYSIS_SUGGESTION_FIELDS: readonly ["topicId", "projectId", "workspaceId", "analysisId", "suggestions", "metadata"];
+declare const GRAPH_ANALYSIS_COMPUTE_FIELDS: readonly ["topicId", "projectId", "workspaceId", "analysisType", "sourceNodeIds", "sourceEdgeIds", "detectorVersions", "metadata"];
+type GraphAnalysisFinding = {
+    id?: string;
+    severity?: "critical" | "warning" | "info" | string;
+    category?: string;
+    title: string;
+    description?: string;
+    nodeIds?: string[];
+    nodeLabels?: string[];
+    detector?: string;
+    importance?: number;
+    totalCount?: number;
+    metadata?: JsonObject;
+};
+type GraphAnalysisSuggestion = {
+    suggestionId?: string;
+    findingId?: string;
+    actionType: string;
+    targetNodeIds?: string[];
+    priority?: "P0" | "P1" | "P2" | "P3" | string;
+    rationale?: string;
+    status?: GraphAnalysisSuggestionStatus;
+    healthScore?: number;
+    metadata?: JsonObject;
+};
+type GraphAnalysisSuggestionStatus = "open" | "accepted" | "dismissed" | "applied" | "superseded";
+type GraphAnalysisRecord = {
+    analysisId?: string;
+    topicId: string;
+    workspaceId: string;
+    analysisType: string;
+    healthScore?: number;
+    findings?: GraphAnalysisFinding[];
+    suggestions?: GraphAnalysisSuggestion[];
+    sourceNodeIds?: string[];
+    sourceEdgeIds?: string[];
+    detectorVersions?: Record<string, string>;
+    metadata?: JsonObject | null;
+    createdAt?: number;
+    updatedAt?: number;
+};
+type GraphAnalysisChangeRecord = {
+    changeId?: string;
+    analysisId?: string;
+    topicId?: string;
+    workspaceId?: string;
+    changeType?: string;
+    nodeIds?: string[];
+    edgeIds?: string[];
+    summary?: string;
+    metadata?: JsonObject | null;
+    createdAt?: number;
+};
+type TopicProjectAliasInput = {
+    topicId?: string;
+    /** @deprecated Use topicId. */
+    projectId?: string;
+};
+type SaveGraphAnalysisInput = TopicProjectAliasInput & {
+    workspaceId: string;
+    analysisType: string;
+    healthScore: number;
+    findings: GraphAnalysisFinding[];
+    suggestions?: GraphAnalysisSuggestion[];
+    sourceNodeIds?: string[];
+    sourceEdgeIds?: string[];
+    detectorVersions?: Record<string, string>;
+    metadata?: JsonObject;
+};
+type ListGraphAnalysesInput = TopicProjectAliasInput & {
+    workspaceId?: string;
+    analysisType?: string;
+    limit?: number;
+    cursor?: string;
+};
+type GetLatestGraphAnalysisInput = TopicProjectAliasInput & {
+    workspaceId?: string;
+    analysisType?: string;
+};
+type SaveGraphSuggestionsInput = TopicProjectAliasInput & {
+    workspaceId: string;
+    analysisId?: string;
+    suggestions: GraphAnalysisSuggestion[];
+    metadata?: JsonObject;
+};
+type UpdateGraphSuggestionStatusInput = {
+    suggestionId: string;
+    status: GraphAnalysisSuggestionStatus;
+    rationale?: string;
+    metadata?: JsonObject;
+};
+type ListGraphSuggestionsInput = TopicProjectAliasInput & {
+    workspaceId?: string;
+    analysisId?: string;
+    findingId?: string;
+    status?: GraphAnalysisSuggestionStatus;
+    limit?: number;
+    cursor?: string;
+};
+type ListGraphChangesInput = TopicProjectAliasInput & {
+    workspaceId?: string;
+    analysisId?: string;
+    since?: number;
+    limit?: number;
+    cursor?: string;
+};
+type ComputeOrRequestGraphAnalysisInput = TopicProjectAliasInput & {
+    workspaceId: string;
+    analysisType?: string;
+    sourceNodeIds?: string[];
+    sourceEdgeIds?: string[];
+    detectorVersions?: Record<string, string>;
+    metadata?: JsonObject;
+};
+type GraphAnalysisListResponse = ListResult<GraphAnalysisRecord, "analyses">;
+type GraphAnalysisSuggestionsResponse = ListResult<GraphAnalysisSuggestion, "suggestions">;
+type GraphAnalysisChangesResponse = ListResult<GraphAnalysisChangeRecord, "changes">;
+declare function createGraphAnalysisClient(config?: GraphAnalysisClientConfig): {
+    saveAnalysis(input: SaveGraphAnalysisInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GraphAnalysisRecord>>;
+    listAnalyses(input: ListGraphAnalysesInput): Promise<PlatformGatewaySuccess<ListResult<any, "analyses">>>;
+    getLatestAnalysis(input: GetLatestGraphAnalysisInput): Promise<PlatformGatewaySuccess<GraphAnalysisRecord>>;
+    saveSuggestions(input: SaveGraphSuggestionsInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GraphAnalysisSuggestionsResponse>>;
+    updateSuggestionStatus(input: UpdateGraphSuggestionStatusInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GraphAnalysisSuggestion>>;
+    listSuggestions(input: ListGraphSuggestionsInput): Promise<PlatformGatewaySuccess<ListResult<any, "suggestions">>>;
+    listGraphChanges(input: ListGraphChangesInput): Promise<PlatformGatewaySuccess<ListResult<any, "changes">>>;
+    computeOrRequestAnalysis(input: ComputeOrRequestGraphAnalysisInput, idempotencyKey?: string): Promise<PlatformGatewaySuccess<GraphAnalysisRecord>>;
+};
+
+export { type ComputeOrRequestGraphAnalysisInput, GRAPH_ANALYSIS_ANALYSIS_FIELDS, GRAPH_ANALYSIS_COMPUTE_FIELDS, GRAPH_ANALYSIS_SUGGESTION_FIELDS, type GetLatestGraphAnalysisInput, type GraphAnalysisChangeRecord, type GraphAnalysisChangesResponse, type GraphAnalysisClientConfig, type GraphAnalysisFinding, type GraphAnalysisListResponse, type GraphAnalysisRecord, type GraphAnalysisSuggestion, type GraphAnalysisSuggestionStatus, type GraphAnalysisSuggestionsResponse, type ListGraphAnalysesInput, type ListGraphChangesInput, type ListGraphSuggestionsInput, type SaveGraphAnalysisInput, type SaveGraphSuggestionsInput, type TopicProjectAliasInput, type UpdateGraphSuggestionStatusInput, createGraphAnalysisClient };