@elevasis/ui 1.3.5 → 1.3.7

package/dist/hooks/published.d.ts

@@ -1,5 +1,6 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import * as react from 'react';
+import { z } from 'zod';
 
 /**
  * Query key factory for executions TanStack Query hooks.
@@ -276,501 +277,6 @@ interface ExecutionLogMessage$1 {
   context?: LogContext$1
 }
 
-/**
- * Shared form field types for dynamic form generation
- * Used by: Command Queue, Execution Runner UI, future form-based features
- */
-
-/**
- * Supported form field types for action payloads
- * Maps to Mantine form components
- */
-type FormFieldType$1 =
-  | 'text'       // TextInput
-  | 'textarea'   // Textarea
-  | 'number'     // NumberInput
-  | 'select'     // Select dropdown
-  | 'checkbox'   // Checkbox
-  | 'radio'      // Radio group
-  | 'richtext'   // Rich text editor (TipTap)
-
-/**
- * Form field definition
- */
-interface FormField {
-  /** Field key in payload object */
-  name: string
-
-  /** Field label for UI */
-  label: string
-
-  /** Field type (determines UI component) */
-  type: FormFieldType$1
-
-  /** Default value */
-  defaultValue?: unknown
-
-  /** Required field */
-  required?: boolean
-
-  /** Placeholder text */
-  placeholder?: string
-
-  /** Help text */
-  description?: string
-
-  /** Options for select/radio */
-  options?: Array<{
-    label: string
-    value: string | number
-  }>
-
-  /** Min/max for number */
-  min?: number
-  max?: number
-
-  /** Path to context value for pre-filling (dot notation, e.g., 'proposal.summary') */
-  defaultValueFromContext?: string
-}
-
-/**
- * Form schema for action payload collection
- */
-interface FormSchema {
-  /** Form title */
-  title?: string
-
-  /** Form description */
-  description?: string
-
-  /** Form fields */
-  fields: FormField[]
-}
-
-/**
- * Error categories for observability grouping and classification.
- * Used to categorize errors in the execution_errors table metadata.
- */
-type ExecutionErrorCategory$1 = 'llm' | 'tool' | 'workflow' | 'agent' | 'validation' | 'system'
-
-// ============================================================================
-// API Request/Response Types (Dashboard Observability)
-// ============================================================================
-
-/**
- * Time range selector for dashboard metrics
- */
-type TimeRange$1 = '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$1 {
-  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'
-}
-
-/**
- * Error analysis metrics response
- * Error categories and top failing resources
- */
-interface ErrorAnalysisMetrics$1 {
-  totalErrors: number
-  errorsByCategory: Array<{
-    category: string
-    count: number
-    percentage: number
-  }>
-  topFailingResources: Array<{
-    resourceId: string
-    name: string
-    errorCount: number
-    failureRate: number
-  }>
-}
-
-/**
- * Business impact metrics response
- * ROI, labor savings, and cost analysis
- */
-interface BusinessImpactMetrics$2 {
-  totalSavingsUsd: number
-  totalCostUsd: number
-  netSavingsUsd: number
-  roi: number
-}
-
-/**
- * Cost breakdown metrics response
- * Per-resource cost analysis
- */
-interface CostBreakdownMetrics$1 {
-  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$1 {
-  executionHealth: ExecutionHealthMetrics$1
-  costBreakdown: CostBreakdownMetrics$1
-  businessImpact: BusinessImpactMetrics$2
-  /** 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
-}
-
-// ============================================================================
-// Error Tracking Types
-// ============================================================================
-
-/**
- * Error record for list view (ErrorBreakdownTable)
- */
-interface ErrorRecord$1 {
-  id: string // execution_errors.id
-  timestamp: string // occurred_at
-  errorType: string // error_type
-  message: string // error_message
-  executionId: string // execution_id
-  resourceId: string // execution_logs.resource_id (via JOIN)
-  resourceName: string // execution_logs.resource_id (TODO: resolve via registry)
-  severity: 'critical' | 'warning' | 'info'
-  category: ExecutionErrorCategory$1 // error_category (moved from metadata to dedicated column)
-  resolved: boolean // resolved flag (human acknowledgment, does not affect execution status)
-  resolvedAt: string | null // timestamp when resolved
-  resolvedBy: string | null // user ID who resolved
-}
-
-/**
- * Full error detail for modal view (ErrorDetailsModal)
- */
-interface ErrorDetailFull$1 extends ErrorRecord$1 {
-  stackTrace?: string // error_stack_trace
-  retryAttempt?: number // metadata.retryAttempt
-  stepName?: string // metadata.stepName
-  stepSequence?: number // metadata.stepSequence
-  errorContext?: Record<string, unknown> // metadata.errorContext
-  executionContext?: Record<string, unknown> // metadata.executionContext
-}
-
-/**
- * Error details API response (paginated)
- */
-interface ErrorDetailResponse$1 {
-  errors: ErrorRecord$1[]
-  total: number
-  page: number
-  limit: number
-}
-
-/**
- * Error trend data for time-series charts
- */
-interface ErrorTrend$1 {
-  time: string // Time bucket (ISO timestamp)
-  errorCount: number // Total errors in bucket
-  criticalCount: number // Critical errors in bucket
-  warningCount: number // Warning errors in bucket
-  infoCount: number // Info errors in bucket
-}
-
-// ============================================================================
-// Cost Analytics Types (Time-Series)
-// ============================================================================
-
-/**
- * Cost trend data point for time-series charts
- * Represents a single time bucket (hour or day)
- */
-interface CostTrendDataPoint$1 {
-  time: string // ISO timestamp (bucket start)
-  totalCostUsd: number
-  executionCount: number
-  avgCostPerExecution: number
-}
-
-/**
- * Cost trends response (time-series data)
- */
-interface CostTrendsResponse$1 {
-  trendData: CostTrendDataPoint$1[]
-  granularity: 'hour' | 'day'
-  totalCostUsd: number
-  totalExecutions: number
-}
-
-/**
- * Cost summary response with MTD and projections
- */
-interface CostSummaryResponse$1 {
-  current: {
-    totalCostUsd: number
-    executionCount: number
-  }
-  previous: {
-    totalCostUsd: number
-    executionCount: number
-  }
-  mtd: {
-    totalCostUsd: number
-    daysElapsed: number
-  }
-  projection: {
-    monthlyCostUsd: number
-    confidence: 'low' | 'medium' | 'high'
-  }
-  trend: {
-    changePercent: number
-    direction: 'up' | 'down' | 'flat'
-  }
-}
-
-/**
- * Cost by model data for model-level breakdown
- */
-interface CostByModelData$1 {
-  model: string
-  totalCostUsd: number
-  callCount: number
-  totalInputTokens: number
-  totalOutputTokens: number
-  avgCostPerCall: number
-}
-
-/**
- * Cost by model response
- */
-interface CostByModelResponse$1 {
-  models: CostByModelData$1[]
-  totalCostUsd: number
-  totalCallCount: number
-}
-
-/**
- * Action configuration for HITL tasks
- * Defines available user actions and their behavior
- */
-interface ActionConfig {
-  /** Unique action identifier (e.g., 'approve', 'retry', 'escalate') */
-  id: string
-
-  /** Display label for UI button */
-  label: string
-
-  /** Button variant/style */
-  type: 'primary' | 'secondary' | 'danger' | 'outline'
-
-  /** Tabler icon name (e.g., 'IconCheck', 'IconRefresh') */
-  icon?: string
-
-  /** Button color (Mantine theme colors) */
-  color?: string
-
-  /** Button variant (Mantine button variant, e.g., 'light', 'filled', 'outline') */
-  variant?: string
-
-  /** Execution target (agent/workflow to invoke) */
-  target?: {
-    resourceType: 'agent' | 'workflow'
-    resourceId: string
-    /**
-     * Optional session ID for agent continuation.
-     * If provided, invokes a new turn on the existing session instead of standalone execution.
-     * Only valid when resourceType is 'agent'.
-     */
-    sessionId?: string
-  }
-
-  /** Form schema for collecting action-specific data */
-  form?: FormSchema
-
-  /** Payload template for pre-filling forms */
-  payloadTemplate?: unknown
-
-  /** Requires confirmation dialog */
-  requiresConfirmation?: boolean
-
-  /** Confirmation message */
-  confirmationMessage?: string
-
-  /** Help text / tooltip */
-  description?: string
-}
-
-/**
- * Origin resource type - where an execution/task originated from.
- * Used for audit trails and tracking execution lineage.
- */
-type OriginResourceType$1 = 'agent' | 'workflow' | 'scheduler' | 'api'
-
-/**
- * Origin tracking metadata - who/what created this execution/task.
- * Used by both TaskScheduler and CommandQueue for complete audit trails.
- */
-interface OriginTracking {
-  originExecutionId: string
-  originResourceType: OriginResourceType$1
-  originResourceId: string
-}
-
-/**
- * Command queue task with flexible action system
- */
-interface Task extends OriginTracking {
-  id: string
-  organizationId: string
-
-  // NEW: Flexible action system
-  actions: ActionConfig[]
-  context: unknown
-  selectedAction?: string
-  actionPayload?: unknown
-
-  // Task metadata
-  description?: string
-  priority: number
-
-  /** Optional checkpoint identifier for grouping related human approval tasks */
-  humanCheckpoint?: string
-
-  // Status (updated to include 'completed')
-  status: TaskStatus
-
-  /**
-   * Target resource tracking — mirrors origin columns.
-   * Set when task is created; patchable to redirect execution to a different resource.
-   */
-  targetResourceId?: string
-  targetResourceType?: 'agent' | 'workflow'
-
-  /**
-   * Execution ID for the action that runs AFTER user approval.
-   * NULL until execution starts.
-   *
-   * Naming distinction:
-   * - originExecutionId = Parent execution that CREATED the HITL task
-   * - targetExecutionId = Child execution that RUNS AFTER user approval
-   */
-  targetExecutionId?: string
-
-  createdAt: Date
-  completedAt?: Date
-  completedBy?: string
-  expiresAt?: Date
-  idempotencyKey?: string | null
-}
-
-/**
- * Task status values
- * - pending: awaiting action
- * - processing: execution in progress after user approval
- * - completed: action was taken and execution succeeded
- * - failed: execution failed, task can be retried
- * - expired: timed out before action
- */
-type TaskStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'expired'
-
-/**
- * Parameters for patching mutable metadata on a task
- */
-interface PatchTaskParams {
-  humanCheckpoint?: string | null
-  description?: string
-  priority?: number
-  context?: Record<string, unknown>
-  actions?: unknown[]
-  targetResourceId?: string | null
-  targetResourceType?: 'agent' | 'workflow' | null
-  targetExecutionId?: string
-  status?: 'pending' | 'failed' | 'completed'
-}
-
-/**
- * Checkpoint list item for sidebar grouping
- * The id field contains the resourceId of the human checkpoint
- */
-interface CheckpointListItem {
-  /** Human checkpoint resourceId (or 'ungrouped' for tasks without checkpoint) */
-  id: string
-  /** Display name (same as id, or "Ungrouped" for null) */
-  name: string
-  /** Task count for this checkpoint */
-  count: number
-}
-
-/**
- * Status counts for pie chart display
- */
-interface StatusCounts {
-  pending: number
-  completed: number
-  expired: number
-}
-
-/**
- * Priority counts for donut chart display
- */
-interface PriorityCounts {
-  critical: number
-  high: number
-  medium: number
-  low: number
-}
-
-/**
- * Response from GET /command-queue/checkpoints endpoint
- */
-interface CheckpointListResponse {
-  checkpoints: CheckpointListItem[]
-  /** Total tasks across all checkpoints */
-  total: number
-  /** Breakdown by status for donut chart */
-  statusCounts: StatusCounts
-  /** Breakdown by priority for donut chart */
-  priorityCounts: PriorityCounts
-}
-
-/**
- * Wire-format DTO for notification API responses.
- * Dates are ISO 8601 strings (not Date objects like the domain Notification type).
- * Used by frontend hooks that consume /api/notifications.
- */
-interface NotificationDTO$1 {
-  id: string
-  userId: string
-  organizationId: string
-  category: string
-  title: string
-  message: string
-  actionUrl: string | null
-  read: boolean
-  readAt: string | null
-  createdAt: string
-}
-
 /**
  * Resource Registry type definitions
  */
@@ -816,7 +322,7 @@ interface APIExecutionDetail$1 extends APIExecutionSummary$1 {
 }
 
 // API request/response types
-interface APIExecutionListResponse$1 {
+interface APIExecutionListResponse {
   executions: APIExecutionSummary$1[]
 }
 
@@ -833,7 +339,7 @@ interface APIExecutionListResponse$1 {
  * // With status filter and limit
  * const { data } = useExecutions(resourceId, 'running', 20)
  */
-declare function useExecutions(resourceId: string, resourceStatus?: ResourceStatus$1 | 'all', limit?: number): _tanstack_react_query.UseQueryResult<APIExecutionListResponse$1, Error>;
+declare function useExecutions(resourceId: string, resourceStatus?: ResourceStatus$1 | 'all', limit?: number): _tanstack_react_query.UseQueryResult<APIExecutionListResponse, Error>;
 
 /**
  * Fetch a single execution detail.
@@ -3988,17 +3494,14 @@ interface APIExecutionDetail extends APIExecutionSummary {
     resourceVersion?: string | null;
     sdkVersion?: string | null;
 }
-interface APIExecutionListResponse {
-    executions: APIExecutionSummary[];
-}
 
-type ActivityType$1 = 'workflow_execution' | 'agent_run' | 'hitl_action' | 'webhook_received' | 'webhook_executed' | 'webhook_failed' | 'credential_change' | 'api_key_change' | 'deployment_change' | 'membership_change';
-type ActivityStatus$1 = 'success' | 'failure' | 'pending' | 'approved' | 'rejected' | 'completed';
-interface Activity$1 {
+type ActivityType = 'workflow_execution' | 'agent_run' | 'hitl_action' | 'webhook_received' | 'webhook_executed' | 'webhook_failed' | 'credential_change' | 'api_key_change' | 'deployment_change' | 'membership_change';
+type ActivityStatus = 'success' | 'failure' | 'pending' | 'approved' | 'rejected' | 'completed';
+interface Activity {
     id: string;
     organizationId: string;
-    activityType: ActivityType$1;
-    status: ActivityStatus$1;
+    activityType: ActivityType;
+    status: ActivityStatus;
     title: string;
     description: string | null;
     entityType: string;
@@ -4011,6 +3514,50 @@ interface Activity$1 {
     createdAt: Date;
 }
 
+/**
+ * Execution history item.
+ * Represents a single execution triggered by a schedule.
+ */
+declare const ExecutionHistoryItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodString;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        running: "running";
+        cancelled: "cancelled";
+    }>;
+    step: z.ZodNullable<z.ZodNumber>;
+    itemLabel: z.ZodNullable<z.ZodString>;
+    duration: z.ZodNullable<z.ZodNumber>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Execution history response.
+ * Returned by GET /schedules/:id/executions with pagination.
+ */
+declare const ExecutionHistoryResponseSchema: z.ZodObject<{
+    executions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        createdAt: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            running: "running";
+            cancelled: "cancelled";
+        }>;
+        step: z.ZodNullable<z.ZodNumber>;
+        itemLabel: z.ZodNullable<z.ZodString>;
+        duration: z.ZodNullable<z.ZodNumber>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, z.core.$strip>;
+type ExecutionHistoryItem = z.infer<typeof ExecutionHistoryItemSchema>;
+type ExecutionHistoryResponse = z.infer<typeof ExecutionHistoryResponseSchema>;
+
 /**
  * Fetch all available Execution Engine resources (workflows, agents, pipelines).
  *
@@ -4244,7 +3791,7 @@ declare function useDeleteSchedule(): _tanstack_react_query.UseMutationResult<vo
 interface UseActivitiesParams {
     limit?: number;
     offset?: number;
-    activityType?: ActivityType$1;
+    activityType?: ActivityType;
     entityType?: string;
     entityId?: string;
     startDate?: string;
@@ -4253,7 +3800,7 @@ interface UseActivitiesParams {
     search?: string;
 }
 interface ListActivitiesResponse {
-    activities: Activity$1[];
+    activities: Activity[];
     total: number;
 }
 /**
@@ -4979,36 +4526,5 @@ declare function useSessionWebSocket(sessionId: string, apiUrl: string): {
     lastTokenUsage: SessionTokenUsage | null;
 };
 
-type ActivityType =
-  | 'workflow_execution'
-  | 'agent_run'
-  | 'hitl_action'
-  | 'webhook_received'
-  | 'webhook_executed'
-  | 'webhook_failed'
-  | 'credential_change'
-  | 'api_key_change'
-  | 'deployment_change'
-  | 'membership_change'
-
-type ActivityStatus = 'success' | 'failure' | 'pending' | 'approved' | 'rejected' | 'completed'
-
-interface Activity {
-  id: string
-  organizationId: string
-  activityType: ActivityType
-  status: ActivityStatus
-  title: string
-  description: string | null
-  entityType: string
-  entityId: string
-  entityName: string | null
-  metadata: Record<string, unknown> | null
-  actorId: string | null
-  actorType: string | null
-  occurredAt: Date
-  createdAt: Date
-}
-
 export { OperationsService, REFETCH_INTERVAL_RUNNING, WS_MAX_RETRIES_BEFORE_ERROR, WS_RECONNECT_BASE_DELAY, WS_RECONNECT_MAX_DELAY, createUseFeatureAccess, executionsKeys, observabilityKeys, scheduleKeys, sessionsKeys, sortData, useActivities, useActivityTrend, useArchiveSession, useBatchDelete, useBulkDeleteExecutions, useBusinessImpact, useCancelExecution, useCancelSchedule, useCostBreakdown, useCostByModel, useCostSummary, useCostTrends, useCreateSchedule, useCreateSession, useDashboardMetrics, useDeleteExecution, useDeleteSchedule, useDeleteSession, useErrorAnalysis, useErrorDetail, useErrorDetails, useErrorDistribution, useErrorNotification, useErrorTrends, useExecuteAsync, useExecution, useExecutionHealth, useExecutionLogs, useExecutions, useGetExecutionHistory, useGetSchedule, useListSchedules, useMarkAllAsRead, useMarkAsRead, useNotificationCount, useNotifications, usePaginationState, usePauseSchedule, useResolveAllErrors, useResolveError, useResolveErrorsByExecution, useResourceDefinition, useResources, useResumeSchedule, useRetryExecution, useSSEConnection, useSession, useSessionExecution, useSessionExecutions, useSessionMessages, useSessionWebSocket, useSessions, useSortedData, useSuccessNotification, useTableSelection, useTableSort, useTopFailingResources, useUnresolveError, useUpdateAnchor, useUpdateSchedule, useWarningNotification };
-export type { AIResourceDefinition, APIExecutionDetail, APIExecutionListResponse, Activity, ActivityTrendResponse, ActivityType, BulkDeleteExecutionsParams, BulkDeleteExecutionsResult, BusinessImpactMetrics, CancelExecutionParams, CancelExecutionResult, ChatMessage, CheckpointListResponse, CostBreakdownItem, CostByModelResponse$1 as CostByModelResponse, CostSummaryResponse$1 as CostSummaryResponse, CostTrendsResponse$1 as CostTrendsResponse, CreateScheduleInput, CreateSessionResponse, DashboardMetrics$1 as DashboardMetrics, DeleteExecutionParams, ErrorAnalysisMetrics$1 as ErrorAnalysisMetrics, ErrorDetailFull$1 as ErrorDetailFull, ErrorDetailResponse$1 as ErrorDetailResponse, ErrorDistributionItem, ErrorDistributionParams, ErrorFilters, ErrorTrend$1 as ErrorTrend, ErrorTrendsParams, ExecuteAsyncParams, ExecuteAsyncResult, ExecutionLogsPageResponse, ExecutionStatus, FailingResource, GetMessagesResponse, ListActivitiesResponse, ListSchedulesFilters, ListSchedulesResponse, MembershipFeatureConfig, MembershipWithDetails, MessageEvent, MessageType, NotificationDTO$1 as NotificationDTO, OrgFeatureConfig, PatchTaskParams, ResourceDefinition, ResourceStatus, ResourceType, ResourcesResponse, RetryExecutionParams, SessionDTO, SessionExecution, SessionExecutionsResponse, SessionListItem, SessionTokenUsage, SortDirection, SortState, SupabaseUserProfile, Task, TaskSchedule, TaskScheduleConfig, TaskStatus, TimeRange$1 as TimeRange, TopFailingResourcesParams, UpdateScheduleInput, UseActivitiesParams, UseActivityTrendParams, UseExecutionHealthParams, UseExecutionLogsParams, UseSSEConnectionOptions, UserConfig, WebSocketState };
+export type { ActivityTrendResponse, BulkDeleteExecutionsParams, BulkDeleteExecutionsResult, BusinessImpactMetrics, CancelExecutionParams, CancelExecutionResult, ChatMessage, CostBreakdownItem, CreateScheduleInput, CreateSessionResponse, DeleteExecutionParams, ErrorDistributionItem, ErrorDistributionParams, ErrorFilters, ErrorTrendsParams, ExecuteAsyncParams, ExecuteAsyncResult, ExecutionHistoryItem, ExecutionHistoryResponse, ExecutionLogsPageResponse, FailingResource, GetMessagesResponse, ListActivitiesResponse, ListSchedulesFilters, ListSchedulesResponse, MessageEvent, MessageType, ResourcesResponse, RetryExecutionParams, SessionDTO, SessionExecution, SessionExecutionsResponse, SessionListItem, SessionTokenUsage, SortDirection, SortState, TaskSchedule, TopFailingResourcesParams, UpdateScheduleInput, UseActivitiesParams, UseActivityTrendParams, UseExecutionHealthParams, UseExecutionLogsParams, UseSSEConnectionOptions, WebSocketState };