@lucern/sdk 0.3.0-alpha.1 → 0.3.0-alpha.10

package/dist/graphAnalysisClient.d.ts

@@ -0,0 +1,192 @@
+import { GatewayClientConfig, PlatformGatewaySuccess } from './coreClient.js';
+import { JsonObject, ListResult } from './types.js';
+import { GraphIntelligenceQueryMode, GraphIntelligenceQueryWithTools } from '@lucern/contracts';
+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;
+    minimumCreatedAt?: number;
+    since?: number;
+    createdAt?: number;
+    analysisCreatedAt?: number;
+    nodeId?: string;
+    edgeId?: string;
+    sourceNodeIds?: string[];
+    sourceEdgeIds?: string[];
+    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">;
+type ListGraphIntelligenceQueriesInput = {
+    categoryId?: string;
+    mode?: GraphIntelligenceQueryMode;
+};
+type RunGraphIntelligenceQueryInput = TopicProjectAliasInput & {
+    queryId?: string;
+    prompt?: string;
+    input?: string;
+    mode?: GraphIntelligenceQueryMode;
+    limit?: number;
+    nodeId?: string;
+    startNode?: string;
+    maxDepth?: number;
+    beliefIds?: string[];
+};
+type GraphIntelligenceQueryCatalogResponse = {
+    schemaVersion: string;
+    catalogVersion: string;
+    categories: unknown[];
+    modes: readonly GraphIntelligenceQueryMode[];
+    queries: GraphIntelligenceQueryWithTools[];
+    quickQueries: unknown[];
+    publicToolNamesByMode: Record<string, readonly string[]>;
+    totalQueries: number;
+};
+type GraphIntelligenceQueryRunResponse = {
+    schemaVersion: string;
+    catalogVersion: string;
+    topicId: string;
+    requestedTopicId?: string;
+    query: GraphIntelligenceQueryWithTools | JsonObject;
+    mode: GraphIntelligenceQueryMode;
+    prompt: string;
+    input: string | null;
+    toolPlan: Array<{
+        toolName: string;
+        args: JsonObject;
+    }>;
+    analysis: JsonObject;
+    context: JsonObject;
+    guidance: JsonObject;
+};
+declare function createGraphAnalysisClient(config?: GraphAnalysisClientConfig): {
+    listGraphIntelligenceQueries(input?: ListGraphIntelligenceQueriesInput): Promise<PlatformGatewaySuccess<GraphIntelligenceQueryCatalogResponse>>;
+    runGraphIntelligenceQuery(input: RunGraphIntelligenceQueryInput): Promise<PlatformGatewaySuccess<GraphIntelligenceQueryRunResponse>>;
+    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 GraphIntelligenceQueryCatalogResponse, type GraphIntelligenceQueryRunResponse, type ListGraphAnalysesInput, type ListGraphChangesInput, type ListGraphIntelligenceQueriesInput, type ListGraphSuggestionsInput, type RunGraphIntelligenceQueryInput, type SaveGraphAnalysisInput, type SaveGraphSuggestionsInput, type TopicProjectAliasInput, type UpdateGraphSuggestionStatusInput, createGraphAnalysisClient };