@elevasis/core 0.7.1 → 0.8.0

package/src/commands/queue/schemas.ts

@@ -1,125 +1,125 @@
-import { z } from 'zod'
-import type { ActionConfig } from './types'
-import { FormFieldSchema, FormSchemaSchema } from '../../forms/schemas'
-
-/**
- * Zod validation schemas for HITL types
- * Provides runtime validation for action configs and task creation
- * Note: Form validation schemas are imported from shared forms module
- */
-
-/**
- * Action configuration schema validation
- */
-export const ActionConfigSchema = z.object({
-  id: z
-    .string()
-    .min(1, 'Action ID is required')
-    .regex(/^[a-z0-9-]+$/, 'Action ID must be lowercase alphanumeric with hyphens'),
-  label: z.string().min(1, 'Action label is required'),
-  type: z.enum(['primary', 'secondary', 'danger', 'outline']),
-  icon: z.string().optional(),
-  color: z.string().optional(),
-  variant: z.string().optional(),
-  target: z
-    .object({
-      resourceType: z.enum(['agent', 'workflow']),
-      resourceId: z.string().min(1, 'Resource ID is required')
-    })
-    .optional(),
-  form: FormSchemaSchema.optional(),
-  payloadTemplate: z.unknown().optional(),
-  requiresConfirmation: z.boolean().optional(),
-  confirmationMessage: z.string().optional(),
-  description: z.string().optional()
-})
-
-/**
- * Create task parameters schema validation
- */
-export const CreateTaskParamsSchema = z.object({
-  organizationId: z.string().uuid('Organization ID must be a valid UUID'),
-  originExecutionId: z.string().min(1, 'Origin execution ID is required'),
-  originResourceType: z.string().min(1, 'Origin resource type is required'),
-  originResourceId: z.string().min(1, 'Origin resource ID is required'),
-  actions: z.array(ActionConfigSchema).min(1, 'At least one action is required').max(20, 'Maximum 20 actions allowed'),
-  context: z.unknown().refine((val) => val !== null && val !== undefined, { message: 'Context is required' }),
-  description: z.string().optional(),
-  priority: z
-    .number()
-    .int('Priority must be an integer')
-    .min(1, 'Priority must be at least 1')
-    .max(10, 'Priority must be at most 10')
-    .optional(),
-  expiresAt: z.date().optional(),
-  idempotencyKey: z.string().min(1).max(255).optional()
-})
-
-/**
- * Submit action parameters schema validation
- */
-export const SubmitActionParamsSchema = z.object({
-  actionId: z.string().min(1, 'Action ID is required'),
-  payload: z.unknown().optional(),
-  notes: z.string().optional(),
-  userId: z.string().min(1, 'User ID is required')
-})
-
-/**
- * Validates an array of action configs
- * Checks bounds, per-item schema, and duplicate IDs
- * @throws ZodError if validation fails
- * @throws Error if duplicate action IDs are found
- */
-export function validateActions(actions: unknown): ActionConfig[] {
-  const validated = z
-    .array(ActionConfigSchema)
-    .min(1, 'At least one action is required')
-    .max(20, 'Maximum 20 actions allowed')
-    .parse(actions)
-
-  // Check for duplicate IDs
-  const ids = new Set<string>()
-  for (const action of validated) {
-    if (ids.has(action.id)) {
-      throw new Error(`Duplicate action id: ${action.id}`)
-    }
-    ids.add(action.id)
-  }
-
-  return validated
-}
-
-/**
- * Validates a single action config
- * @throws ZodError if validation fails
- */
-export function validateActionConfig(action: unknown): ActionConfig {
-  return ActionConfigSchema.parse(action)
-}
-
-/**
- * Patch task parameters schema validation
- * All fields optional, but at least one must be provided
- */
-export const PatchTaskRequestSchema = z
-  .object({
-    humanCheckpoint: z.string().min(1).nullable().optional(),
-    description: z.string().min(1).optional(),
-    priority: z.number().int().min(1).max(10).optional(),
-    context: z.record(z.string(), z.unknown()).optional(),
-    actions: z.array(z.unknown()).optional()
-  })
-  .refine((data) => Object.keys(data).length > 0, {
-    message: 'At least one field must be provided'
-  })
-
-/**
- * Re-export form validation schemas for backwards compatibility
- */
-export { FormFieldSchema, FormSchemaSchema }
-
-/**
- * Re-export form validation functions for backwards compatibility
- */
-export { validateFormSchema, validateFormField } from '../../forms/schemas'
+import { z } from 'zod'
+import type { ActionConfig } from './types'
+import { FormFieldSchema, FormSchemaSchema } from '../../forms/schemas'
+
+/**
+ * Zod validation schemas for HITL types
+ * Provides runtime validation for action configs and task creation
+ * Note: Form validation schemas are imported from shared forms module
+ */
+
+/**
+ * Action configuration schema validation
+ */
+export const ActionConfigSchema = z.object({
+  id: z
+    .string()
+    .min(1, 'Action ID is required')
+    .regex(/^[a-z0-9-]+$/, 'Action ID must be lowercase alphanumeric with hyphens'),
+  label: z.string().min(1, 'Action label is required'),
+  type: z.enum(['primary', 'secondary', 'danger', 'outline']),
+  icon: z.string().optional(),
+  color: z.string().optional(),
+  variant: z.string().optional(),
+  target: z
+    .object({
+      resourceType: z.enum(['agent', 'workflow']),
+      resourceId: z.string().min(1, 'Resource ID is required')
+    })
+    .optional(),
+  form: FormSchemaSchema.optional(),
+  payloadTemplate: z.unknown().optional(),
+  requiresConfirmation: z.boolean().optional(),
+  confirmationMessage: z.string().optional(),
+  description: z.string().optional()
+})
+
+/**
+ * Create task parameters schema validation
+ */
+export const CreateTaskParamsSchema = z.object({
+  organizationId: z.string().uuid('Organization ID must be a valid UUID'),
+  originExecutionId: z.string().min(1, 'Origin execution ID is required'),
+  originResourceType: z.string().min(1, 'Origin resource type is required'),
+  originResourceId: z.string().min(1, 'Origin resource ID is required'),
+  actions: z.array(ActionConfigSchema).min(1, 'At least one action is required').max(20, 'Maximum 20 actions allowed'),
+  context: z.unknown().refine((val) => val !== null && val !== undefined, { message: 'Context is required' }),
+  description: z.string().optional(),
+  priority: z
+    .number()
+    .int('Priority must be an integer')
+    .min(1, 'Priority must be at least 1')
+    .max(10, 'Priority must be at most 10')
+    .optional(),
+  expiresAt: z.date().optional(),
+  idempotencyKey: z.string().min(1).max(255).optional()
+})
+
+/**
+ * Submit action parameters schema validation
+ */
+export const SubmitActionParamsSchema = z.object({
+  actionId: z.string().min(1, 'Action ID is required'),
+  payload: z.unknown().optional(),
+  notes: z.string().optional(),
+  userId: z.string().min(1, 'User ID is required')
+})
+
+/**
+ * Validates an array of action configs
+ * Checks bounds, per-item schema, and duplicate IDs
+ * @throws ZodError if validation fails
+ * @throws Error if duplicate action IDs are found
+ */
+export function validateActions(actions: unknown): ActionConfig[] {
+  const validated = z
+    .array(ActionConfigSchema)
+    .min(1, 'At least one action is required')
+    .max(20, 'Maximum 20 actions allowed')
+    .parse(actions)
+
+  // Check for duplicate IDs
+  const ids = new Set<string>()
+  for (const action of validated) {
+    if (ids.has(action.id)) {
+      throw new Error(`Duplicate action id: ${action.id}`)
+    }
+    ids.add(action.id)
+  }
+
+  return validated
+}
+
+/**
+ * Validates a single action config
+ * @throws ZodError if validation fails
+ */
+export function validateActionConfig(action: unknown): ActionConfig {
+  return ActionConfigSchema.parse(action)
+}
+
+/**
+ * Patch task parameters schema validation
+ * All fields optional, but at least one must be provided
+ */
+export const PatchTaskRequestSchema = z
+  .object({
+    humanCheckpoint: z.string().min(1).nullable().optional(),
+    description: z.string().min(1).optional(),
+    priority: z.number().int().min(1).max(10).optional(),
+    context: z.record(z.string(), z.unknown()).optional(),
+    actions: z.array(z.unknown()).optional()
+  })
+  .refine((data) => Object.keys(data).length > 0, {
+    message: 'At least one field must be provided'
+  })
+
+/**
+ * Re-export form validation schemas for backwards compatibility
+ */
+export { FormFieldSchema, FormSchemaSchema }
+
+/**
+ * Re-export form validation functions for backwards compatibility
+ */
+export { validateFormSchema, validateFormField } from '../../forms/schemas'

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

@@ -1,61 +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
+/**
+ * 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

@@ -1,52 +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
-}
+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

@@ -1,44 +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
-}
+/**
+ * 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

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