@elevasis/ui 1.19.0 → 1.20.1

package/dist/features/dashboard/index.d.ts

@@ -0,0 +1,244 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * Time range selector for dashboard metrics
+ */
+type TimeRange = '1h' | '24h' | '7d' | '30d';
+/**
+ * Execution health metrics response
+ * Success rate, P95 duration, execution counts, and trend data
+ * trendData includes executionCount for throughput visualization (eliminates separate API call)
+ */
+interface ExecutionHealthMetrics {
+    successRate: number;
+    p95Duration: number;
+    totalExecutions: number;
+    trendData: Array<{
+        time: string;
+        rate: number;
+        successCount: number;
+        errorCount: number;
+        warningCount: number;
+        executionCount: number;
+    }>;
+    statusCounts: {
+        success: number;
+        failed: number;
+        pending: number;
+        warning: number;
+    };
+    peakPeriod: string;
+    granularity: 'hour' | 'day';
+}
+/**
+ * Business impact metrics response
+ * ROI, labor savings, and cost analysis
+ */
+interface BusinessImpactMetrics {
+    totalSavingsUsd: number;
+    totalCostUsd: number;
+    netSavingsUsd: number;
+    roi: number;
+}
+/**
+ * Cost breakdown metrics response
+ * Per-resource cost analysis
+ */
+interface CostBreakdownMetrics {
+    resources: Array<{
+        resourceId: string;
+        totalCostUsd: number;
+        executionCount: number;
+        avgCostUsd: number;
+    }>;
+}
+/**
+ * Dashboard metrics response
+ * Aggregates core observability metrics in a single response
+ * Note: Throughput data is now included in executionHealth.trendData.executionCount
+ */
+interface DashboardMetrics {
+    executionHealth: ExecutionHealthMetrics;
+    costBreakdown: CostBreakdownMetrics;
+    businessImpact: BusinessImpactMetrics;
+    /** ISO timestamp of the currently active deployment, or null if none */
+    activeDeploymentDate: string | null;
+    /** Deployment version of the active deployment, or null if none */
+    activeDeploymentVersion: string | null;
+}
+/**
+ * Summary of executions for a single resource
+ * Used by RecentExecutionsByResource dashboard component
+ */
+interface ResourceExecutionSummary {
+    resourceId: string;
+    resourceType: string;
+    resourceName: string | null;
+    lastExecution: string;
+    totalExecutions: number;
+    successCount: number;
+    failureCount: number;
+    warningCount: number;
+    successRate: number;
+}
+
+/**
+ * Resource Registry type definitions
+ */
+
+/**
+ * Environment/deployment status for resources
+ */
+type ResourceStatus = 'dev' | 'prod';
+/**
+ * All resource types in the platform
+ * Used as the discriminator field in ResourceDefinition
+ */
+type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human';
+/**
+ * Base interface for ALL platform resources
+ * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
+ */
+interface ResourceDefinition {
+    /** Unique resource identifier */
+    resourceId: string;
+    /** Display name */
+    name: string;
+    /** Purpose and functionality description */
+    description: string;
+    /** Version for change tracking and evolution */
+    version: string;
+    /** Resource type discriminator */
+    type: ResourceType;
+    /** Environment/deployment status */
+    status: ResourceStatus;
+    /** Domain tags for filtering and organization */
+    domains?: ResourceDomain[];
+    /** Whether the agent supports multi-turn sessions (agents only) */
+    sessionCapable?: boolean;
+    /** Whether the resource is local (monorepo) or remote (externally deployed) */
+    origin?: 'local' | 'remote';
+    /** Whether this resource is archived and should be excluded from registration and deployment */
+    archived?: boolean;
+}
+
+/**
+ * Standard Domain Definitions
+ * Centralized domain constants and definitions for all organization resources.
+ */
+
+declare const DOMAINS: {
+    readonly INBOUND_PIPELINE: "inbound-pipeline";
+    readonly LEAD_GEN_PIPELINE: "lead-gen-pipeline";
+    readonly SUPPORT: "support";
+    readonly CLIENT_SUPPORT: "client-support";
+    readonly DELIVERY: "delivery";
+    readonly OPERATIONS: "operations";
+    readonly FINANCE: "finance";
+    readonly EXECUTIVE: "executive";
+    readonly INSTANTLY: "instantly";
+    readonly TESTING: "testing";
+    readonly INTERNAL: "internal";
+    readonly INTEGRATION: "integration";
+    readonly UTILITY: "utility";
+    readonly DIAGNOSTIC: "diagnostic";
+};
+/**
+ * ResourceDomain - Strongly typed domain identifier
+ * Use this type for all domain references to ensure compile-time validation.
+ */
+type ResourceDomain = (typeof DOMAINS)[keyof typeof DOMAINS];
+
+interface DashboardProps {
+    /**
+     * Active time range for all metrics queries.
+     */
+    timeRange: TimeRange;
+    /**
+     * Business-impact metrics computed by the CC wrapper.
+     * Stays CC-local per decision lock #4.
+     * TODO(Wave 2): thread to HeroStatsRow once the CC wrapper wires it through.
+     */
+    businessImpact?: ReturnType<() => {
+        data: BusinessImpactMetrics | undefined;
+        isLoading: boolean;
+    }>;
+    /**
+     * Cost breakdown metrics computed by the CC wrapper.
+     * Stays CC-local per decision lock #4.
+     * TODO(Wave 2): thread to HeroStatsRow once the CC wrapper wires it through.
+     */
+    costBreakdown?: ReturnType<() => {
+        data: CostBreakdownMetrics | undefined;
+        isLoading: boolean;
+    }>;
+    /**
+     * Called when the user clicks a resource card.
+     */
+    onResourceClick?: (params: {
+        resourceId: string;
+        resourceType?: string;
+    }) => void;
+    /**
+     * Called when the user wants to drill into the unresolved errors view.
+     */
+    onErrorsNavigate?: () => void;
+    /**
+     * Called when the user wants to navigate to the command queue.
+     * Minor refinement over locked props shape — OperationalOverview has this link target.
+     */
+    onCommandQueueNavigate?: () => void;
+    /**
+     * Called when the user wants to navigate to the task scheduler.
+     * Minor refinement over locked props shape — OperationalOverview has this link target.
+     */
+    onScheduledTasksNavigate?: () => void;
+    /**
+     * Custom render function for the execution trend chart.
+     * The wrapper owns the chart implementation (CC uses its monitoring-local CombinedTrendChart).
+     * Receives executionHealth data, loading state, and error from useDashboardMetrics.
+     * If omitted, the trend chart section is not rendered.
+     */
+    renderTrendChart?: (data: DashboardMetrics['executionHealth'] | undefined, isLoading: boolean, error?: Error) => ReactNode;
+}
+declare function Dashboard({ timeRange, onResourceClick, onErrorsNavigate, onCommandQueueNavigate, onScheduledTasksNavigate, renderTrendChart }: DashboardProps): react_jsx_runtime.JSX.Element;
+
+interface DisplayResource {
+    resourceId: string;
+    name: string;
+    type: string;
+    status: string;
+    active: boolean;
+    execution?: ResourceExecutionSummary;
+}
+interface ResourceOverviewProps {
+    recentExecutions?: ResourceExecutionSummary[];
+    allResources?: {
+        workflows: ResourceDefinition[];
+        agents: ResourceDefinition[];
+    };
+    isLoading: boolean;
+    limit?: number;
+    onResourceClick?: (resource: DisplayResource) => void;
+}
+declare function ResourceOverview({ recentExecutions, allResources, isLoading, limit, onResourceClick }: ResourceOverviewProps): react_jsx_runtime.JSX.Element;
+
+interface RecentExecutionsByResourceProps {
+    timeRange: TimeRange;
+    limit?: number;
+    onResourceClick?: (params: {
+        resourceType: string;
+        resourceId: string;
+    }) => void;
+}
+declare function RecentExecutionsByResource({ timeRange, limit, onResourceClick }: RecentExecutionsByResourceProps): react_jsx_runtime.JSX.Element;
+
+interface UnresolvedErrorsTeaserProps {
+    timeRange: TimeRange;
+    onNavigateToAllErrors?: () => void;
+}
+declare function UnresolvedErrorsTeaser({ timeRange, onNavigateToAllErrors }: UnresolvedErrorsTeaserProps): react_jsx_runtime.JSX.Element;
+
+export { Dashboard, RecentExecutionsByResource, ResourceOverview, UnresolvedErrorsTeaser };
+export type { DashboardProps, DisplayResource, RecentExecutionsByResourceProps, ResourceOverviewProps, UnresolvedErrorsTeaserProps };