@elevasis/core 0.1.0

package/src/commands/queue/sse-events.ts

@@ -0,0 +1,61 @@
+/**
+ * Command Queue SSE Event Types
+ *
+ * Type-safe definitions for command queue related SSE events
+ */
+
+import type { Task } from './types/task'
+
+/**
+ * Event sent when command queue task is updated
+ */
+export interface CommandQueueTaskUpdatedEvent {
+  type: 'task_updated'
+  timestamp: number
+  data: {
+    task: Task
+  }
+}
+
+/**
+ * Connection confirmation event
+ */
+export interface CommandQueueConnectedEvent {
+  type: 'connected'
+  timestamp: number
+  data?: undefined
+}
+
+/**
+ * Event sent when action execution completes successfully
+ */
+export interface CommandQueueExecutionCompletedEvent {
+  type: 'execution_completed'
+  timestamp: number
+  data: {
+    taskId: string
+    targetExecutionId: string
+  }
+}
+
+/**
+ * Event sent when action execution fails
+ */
+export interface CommandQueueExecutionFailedEvent {
+  type: 'execution_failed'
+  timestamp: number
+  data: {
+    taskId: string
+    targetExecutionId?: string
+    error: string
+  }
+}
+
+/**
+ * Union of all command queue SSE events
+ */
+export type CommandQueueSSEEvent =
+  | CommandQueueTaskUpdatedEvent
+  | CommandQueueConnectedEvent
+  | CommandQueueExecutionCompletedEvent
+  | CommandQueueExecutionFailedEvent

package/src/commands/queue/types/action.ts

@@ -0,0 +1,52 @@
+import type { FormSchema } from '../../../forms/types'
+
+/**
+ * Action configuration for HITL tasks
+ * Defines available user actions and their behavior
+ */
+export 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
+}

package/src/commands/queue/types/checkpoint.ts

@@ -0,0 +1,44 @@
+/**
+ * Checkpoint list item for sidebar grouping
+ * The id field contains the resourceId of the human checkpoint
+ */
+export 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
+ */
+export interface StatusCounts {
+  pending: number
+  completed: number
+  expired: number
+}
+
+/**
+ * Priority counts for donut chart display
+ */
+export interface PriorityCounts {
+  critical: number
+  high: number
+  medium: number
+  low: number
+}
+
+/**
+ * Response from GET /command-queue/checkpoints endpoint
+ */
+export 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
+}

package/src/commands/queue/types/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel exports for command queue types
+ */
+
+export * from './action'
+export * from './task'
+export * from './checkpoint'

package/src/commands/queue/types/task.ts

@@ -0,0 +1,116 @@
+import type { OriginTracking } from '../../../execution/core/types'
+import type { TimeRange } from '../../../operations/observability/types'
+import type { ActionConfig } from './action'
+
+export type { TimeRange }
+
+/**
+ * Command queue task with flexible action system
+ */
+export 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
+ */
+export type TaskStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'expired'
+
+/**
+ * Parameters for creating a new HITL task
+ */
+export interface CreateTaskParams extends OriginTracking {
+  organizationId: string
+  actions: ActionConfig[]
+  context: unknown
+  description?: string
+  priority?: number
+  expiresAt?: Date
+  humanCheckpoint?: string // Optional checkpoint identifier for grouping related human approval tasks
+  metadata?: Record<string, unknown>
+  idempotencyKey?: string
+}
+
+/**
+ * Parameters for submitting an action on a task
+ */
+export interface SubmitActionParams {
+  actionId: string
+  payload?: unknown
+  notes?: string
+  userId: string
+}
+
+/**
+ * Parameters for patching mutable metadata on a task
+ */
+export 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'
+}
+
+/**
+ * Filters for listing tasks
+ */
+export interface ListTasksFilters {
+  organizationId: string
+  status?: TaskStatus
+  humanCheckpoint?: string
+  timeRange?: TimeRange
+  priorityMin?: number
+  priorityMax?: number
+  limit?: number
+  offset?: number
+}

package/src/commands/queue/types.ts

@@ -0,0 +1,14 @@
+import type { Database } from '../../supabase/database.types'
+
+/**
+ * Command Queue Types
+ *
+ * Re-exports from organized types subdirectory + database types
+ */
+
+// Re-export all types from organized subdirectory
+export * from './types/index'
+
+// Database types (for service layer only - don't use in domain code)
+export type CommandQueueRow = Database['public']['Tables']['command_queue']['Row']
+export type CommandQueueInsert = Database['public']['Tables']['command_queue']['Insert']

package/src/content/distribution-metadata.ts

@@ -0,0 +1,61 @@
+/**
+ * Platform Content Types
+ *
+ * Typed interfaces for platform-specific content stored in the
+ * `platform_content` JSONB column of `acq_content_distributions`.
+ */
+
+// =============================================================================
+// Base
+// =============================================================================
+
+/** Fields shared across all platforms */
+export interface PlatformContent {
+  title?: string
+  description?: string
+  tags?: string[]
+}
+
+// =============================================================================
+// Platform Extensions
+// =============================================================================
+
+export interface YouTubeContent extends PlatformContent {
+  timestamps?: string[]
+  endScreenVideoId?: string
+  pinnedComment?: string
+}
+
+export interface LinkedInContent extends PlatformContent {
+  hook?: string
+  hashtags?: string[]
+  firstComment?: string
+}
+
+export interface InstagramContent extends PlatformContent {
+  altText?: string
+  hashtags?: string[]
+  storyLink?: string
+}
+
+export interface XContent extends PlatformContent {
+  hookTweet?: string
+  threadTweets?: string[]
+  replyThread?: string
+}
+
+// =============================================================================
+// Union & Helpers
+// =============================================================================
+
+export type AnyPlatformContent = YouTubeContent | LinkedInContent | InstagramContent | XContent
+
+/** Map platform string to its content type */
+export interface PlatformContentMap {
+  youtube: YouTubeContent
+  linkedin: LinkedInContent
+  instagram: InstagramContent
+  x: XContent
+}
+
+export type Platform = keyof PlatformContentMap

package/src/content/index.ts

@@ -0,0 +1,10 @@
+export type {
+  PlatformContent,
+  YouTubeContent,
+  LinkedInContent,
+  InstagramContent,
+  XContent,
+  AnyPlatformContent,
+  PlatformContentMap,
+  Platform
+} from './distribution-metadata'

package/src/deployments/index.ts

@@ -0,0 +1,22 @@
+/**
+ * Deployment types — browser-safe
+ *
+ * Canonical API response types for the deployment resource.
+ * The API's transformRow converts snake_case DB columns to these camelCase fields.
+ */
+
+export type DeploymentStatus = 'deploying' | 'active' | 'failed' | 'rolled_back' | 'stopped'
+
+export interface Deployment {
+  id: string
+  organizationId: string
+  status: DeploymentStatus
+  sdkVersion: string
+  deploymentVersion: string | null
+  port: number | null
+  pid: number | null
+  tarballPath: string | null
+  errorMessage: string | null
+  createdAt: string
+  updatedAt: string
+}