@echothink-ui/task 0.1.0

package/src/types.ts

@@ -0,0 +1,289 @@
+import type * as React from "react";
+import type {
+  EthAction,
+  EthDensity,
+  EthIntent,
+  EthOperationalStatus,
+  SurfaceComponentProps
+} from "@echothink-ui/core";
+import type { BulkAction, DataColumn } from "@echothink-ui/data";
+
+export type TaskPriority = "low" | "medium" | "high" | "critical";
+
+export interface TaskDependency extends Record<string, unknown> {
+  id: string;
+  title: string;
+  status: EthOperationalStatus;
+  relationship?: "blocks" | "blocked-by";
+}
+
+export interface TaskTimelineEvent extends Record<string, unknown> {
+  id: string;
+  timestamp: string | Date;
+  actor?: string;
+  kind: "status_change" | "comment" | "assignment" | "attachment" | "system";
+  summary: React.ReactNode;
+  details?: React.ReactNode;
+}
+
+export interface Task extends Record<string, unknown> {
+  id: string;
+  title: string;
+  assignee?: React.ReactNode;
+  dueAt?: string | Date;
+  status: EthOperationalStatus;
+  priority?: TaskPriority;
+  tags?: string[];
+  description?: React.ReactNode;
+  dependencies?: TaskDependency[];
+  history?: TaskTimelineEvent[];
+  order?: number;
+  durationMs?: number;
+  dependencyIds?: string[];
+  dependencyCount?: number;
+}
+
+export interface TaskWave extends Record<string, unknown> {
+  id: string;
+  label: string;
+  totalTasks: number;
+  statuses: Partial<Record<EthOperationalStatus, number>>;
+  startedAt?: string | Date;
+  eta?: string | Date;
+}
+
+export interface TaskStep {
+  id: string;
+  label: string;
+  status: EthOperationalStatus;
+}
+
+export interface DAGNodeModel extends Record<string, unknown> {
+  id: string;
+  label: string;
+  status: EthOperationalStatus;
+  x?: number;
+  y?: number;
+}
+
+export interface PositionedDAGNode extends DAGNodeModel {
+  x: number;
+  y: number;
+}
+
+export interface DAGEdgeModel extends Record<string, unknown> {
+  from: string;
+  to: string;
+  status?: EthOperationalStatus;
+  label?: string;
+}
+
+export type DAGEdgeLegendVariant = "dependency" | "critical" | "conditional";
+
+export interface DAGEdgeLegendItem {
+  id: string;
+  label: React.ReactNode;
+  status?: EthOperationalStatus;
+  variant?: DAGEdgeLegendVariant;
+}
+
+export interface DecisionEvidence {
+  id: string;
+  label: string;
+  href?: string;
+  preview?: React.ReactNode;
+}
+
+export interface DecisionOption {
+  id: string;
+  label: string;
+  intent?: EthIntent;
+  description?: string;
+}
+
+export type RiskLevel = "low" | "medium" | "high" | "critical";
+
+export interface BackendThinkingStep {
+  id: string;
+  title: string;
+  status: EthOperationalStatus;
+  summary?: string;
+  toolName?: string;
+  durationMs?: number;
+  redacted?: boolean;
+  children?: BackendThinkingStep[];
+}
+
+export interface TaskRunLogEntry extends Record<string, unknown> {
+  id: string;
+  timestamp: string | Date;
+  level: "info" | "warn" | "error" | "debug";
+  message: string;
+  redacted?: boolean;
+}
+
+export interface TaskCardProps
+  extends Omit<React.HTMLAttributes<HTMLElement>, "title" | "onSelect"> {
+  task: Task;
+  actions?: EthAction[];
+  onSelect?: (task: Task) => void;
+}
+
+export interface TaskTableProps extends Omit<SurfaceComponentProps, "children"> {
+  tasks?: Task[];
+  density?: EthDensity;
+  selectable?: boolean;
+  selectedRows?: React.Key[];
+  onSelectionChange?: (keys: React.Key[]) => void;
+  rowActions?: (task: Task) => EthAction[];
+  bulkActions?: BulkAction<Task>[];
+  columns?: DataColumn<Task>[];
+  showFilters?: boolean;
+  statusFilter?: EthOperationalStatus | "all";
+  onStatusFilterChange?: (status: EthOperationalStatus | "all") => void;
+}
+
+export interface TaskDetailPanelProps extends Omit<SurfaceComponentProps, "children"> {
+  task?: Task;
+  dependencies?: TaskDependency[];
+  events?: TaskTimelineEvent[];
+  actions?: EthAction[];
+}
+
+export interface TaskStatusBadgeProps
+  extends Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> {
+  status: EthOperationalStatus;
+  label?: string;
+}
+
+export interface TaskProgressIndicatorProps
+  extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+  value?: number;
+  total?: number;
+  steps?: TaskStep[];
+  label?: string;
+}
+
+export interface TaskDependencyListProps
+  extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+  dependencies?: TaskDependency[];
+  blocks?: TaskDependency[];
+  blockedBy?: TaskDependency[];
+  emptyTitle?: React.ReactNode;
+}
+
+export interface TaskTimelineProps
+  extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+  events?: TaskTimelineEvent[];
+}
+
+export interface TaskWaveHeaderProps extends Omit<SurfaceComponentProps, "children"> {
+  wave?: TaskWave;
+  actions?: EthAction[];
+}
+
+export interface TaskWaveTableProps extends Omit<SurfaceComponentProps, "children"> {
+  wave?: TaskWave;
+  tasks?: Task[];
+  onTaskSelect?: (task: Task) => void;
+  rowActions?: (task: Task) => EthAction[];
+}
+
+export interface TaskWaveDAGProps extends Omit<SurfaceComponentProps, "children"> {
+  nodes?: DAGNodeModel[];
+  edges?: DAGEdgeModel[];
+  layout?: "lr" | "tb";
+  onNodeSelect?: (node: DAGNodeModel) => void;
+  selectedNodeId?: string;
+}
+
+export interface DAGNodeProps
+  extends Omit<React.SVGAttributes<SVGGElement>, "children" | "onSelect"> {
+  node: PositionedDAGNode;
+  selected?: boolean;
+  onSelect?: (node: PositionedDAGNode) => void;
+}
+
+export interface DAGEdgeProps extends Omit<React.SVGAttributes<SVGPathElement>, "from" | "to"> {
+  from: { x: number; y: number };
+  to: { x: number; y: number };
+  status?: EthOperationalStatus;
+  label?: string;
+}
+
+export interface DAGLegendProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+  statuses?: EthOperationalStatus[];
+  edgeTypes?: DAGEdgeLegendItem[];
+}
+
+export interface DecisionRequiredPanelProps extends Omit<SurfaceComponentProps, "children"> {
+  title: React.ReactNode;
+  summary?: React.ReactNode;
+  riskLevel?: RiskLevel;
+  evidence?: DecisionEvidence[];
+  options?: DecisionOption[];
+  onDecide?: (optionId: string) => void;
+  decidedOptionId?: string;
+}
+
+export interface TaskApprovalPanelProps extends Omit<SurfaceComponentProps, "children"> {
+  taskRef?: React.ReactNode;
+  diffRef?: React.ReactNode;
+  policyRef?: React.ReactNode;
+  summary?: React.ReactNode;
+  evidence?: DecisionEvidence[];
+  onApprove?: (reason: string) => void;
+  onReject?: (reason: string) => void;
+  onRequestChanges?: (reason: string) => void;
+  state?: "idle" | "pending" | "approved" | "rejected";
+}
+
+export interface BackendThinkingChainProps
+  extends Omit<React.HTMLAttributes<HTMLElement>, "children"> {
+  steps?: BackendThinkingStep[];
+  streaming?: boolean;
+}
+
+export interface HumanInterventionPanelProps extends Omit<SurfaceComponentProps, "children"> {
+  reason?: React.ReactNode;
+  affectedTask?: Pick<Task, "id" | "title">;
+  actions?: EthAction[];
+  urgency?: "low" | "medium" | "high";
+}
+
+export interface BlockingReasonPanelProps extends Omit<SurfaceComponentProps, "children"> {
+  blockers?: Array<{
+    id: string;
+    reason: React.ReactNode;
+    ownerActor?: string;
+    resolveAction?: EthAction;
+  }>;
+}
+
+export interface TaskHandoffPanelProps extends Omit<SurfaceComponentProps, "children"> {
+  assigneeOptions?: Array<{ id: string; label: string; kind: "user" | "team" | "agent" }>;
+  currentAssigneeId?: string;
+  onHandoff?: (toId: string, reason: string) => void;
+  reasonRequired?: boolean;
+}
+
+export interface TaskRunLogProps extends Omit<SurfaceComponentProps, "children"> {
+  entries?: TaskRunLogEntry[];
+  streaming?: boolean;
+  onPauseToggle?: () => void;
+  onFilter?: (level: TaskRunLogEntry["level"]) => void;
+  levelFilter?: string[];
+  windowSize?: number;
+}
+
+export interface TaskRetryPanelProps extends Omit<SurfaceComponentProps, "children"> {
+  taskRef?: React.ReactNode;
+  failureSummary?: React.ReactNode;
+  retryPolicy?: {
+    maxRetries: number;
+    backoff: "linear" | "exponential";
+    intervalMs: number;
+  };
+  attemptCount?: number;
+  onRetry?: (reason: string) => void;
+}