@qontinui/shared-types 0.2.1

package/dist/index.js

@@ -0,0 +1,178 @@
+import {
+  DEFAULT_SUMMARY_PROMPT,
+  PHASE_INFO,
+  STEP_TYPES
+} from "./chunk-ZK5MJEGT.js";
+import {
+  ActionStatus,
+  ActionType,
+  ErrorType,
+  IssueSeverity,
+  RunStatus,
+  RunType,
+  ScreenshotType
+} from "./chunk-YXD4WCYQ.js";
+
+// src/render-log.ts
+function isComponentRenderLog(entry) {
+  return entry.type === "component";
+}
+function isDomSnapshotRenderLog(entry) {
+  return entry.type === "dom_snapshot";
+}
+
+// src/discovery.ts
+var SOURCE_TYPE_LABELS = {
+  playwright: "Web Extraction",
+  ui_bridge: "UI Bridge",
+  recording: "Recording",
+  vision: "Vision",
+  manual: "Manual"
+};
+var SOURCE_TYPE_COLORS = {
+  playwright: "bg-blue-500/20 text-blue-400 border-blue-500/30",
+  ui_bridge: "bg-purple-500/20 text-purple-400 border-purple-500/30",
+  recording: "bg-green-500/20 text-green-400 border-green-500/30",
+  vision: "bg-orange-500/20 text-orange-400 border-orange-500/30",
+  manual: "bg-gray-500/20 text-gray-400 border-gray-500/30"
+};
+function toStateDiscoveryResult(data) {
+  return {
+    id: data.id,
+    projectId: data.projectId ?? data.project_id,
+    name: data.name,
+    description: data.description,
+    sourceType: data.sourceType ?? data.source_type,
+    sourceSessionId: data.sourceSessionId ?? data.source_session_id,
+    discoveryStrategy: data.discoveryStrategy ?? data.discovery_strategy,
+    images: (data.images || []).map(toDiscoveredStateImage),
+    states: (data.states || []).map(toDiscoveredState),
+    transitions: (data.transitions || []).map(
+      toDiscoveredTransition
+    ),
+    elementToRenders: (data.elementToRenders ?? data.element_to_renders) || {},
+    imageCount: data.imageCount ?? data.image_count,
+    stateCount: data.stateCount ?? data.state_count,
+    transitionCount: data.transitionCount ?? data.transition_count,
+    renderCount: data.renderCount ?? data.render_count,
+    uniqueElementCount: data.uniqueElementCount ?? data.unique_element_count,
+    confidence: data.confidence,
+    discoveryMetadata: (data.discoveryMetadata ?? data.discovery_metadata) || {},
+    createdAt: data.createdAt ?? data.created_at,
+    updatedAt: data.updatedAt ?? data.updated_at
+  };
+}
+function toDiscoveredStateImage(data) {
+  const d = data;
+  return {
+    id: d.id,
+    screenshotId: d.screenshotId ?? d.screenshot_id,
+    screenshotUrl: d.screenshotUrl ?? d.screenshot_url,
+    bbox: d.bbox,
+    pixelHash: d.pixelHash ?? d.pixel_hash,
+    stateId: d.stateId ?? d.state_id,
+    elementType: d.elementType ?? d.element_type,
+    label: d.label,
+    confidence: d.confidence ?? 1,
+    metadata: d.metadata
+  };
+}
+function toDiscoveredState(data) {
+  const d = data;
+  return {
+    id: d.id,
+    name: d.name,
+    imageIds: (d.imageIds ?? d.image_ids) || [],
+    renderIds: (d.renderIds ?? d.render_ids) || [],
+    elementIds: (d.elementIds ?? d.element_ids) || [],
+    confidence: d.confidence ?? 1,
+    description: d.description,
+    metadata: d.metadata
+  };
+}
+function toDiscoveredTransition(data) {
+  const d = data;
+  const trigger = d.trigger;
+  return {
+    id: d.id,
+    fromStateId: d.fromStateId ?? d.from_state_id,
+    toStateId: d.toStateId ?? d.to_state_id,
+    trigger: trigger ? {
+      type: trigger.type ?? "click",
+      imageId: trigger.imageId ?? trigger.image_id,
+      elementId: trigger.elementId ?? trigger.element_id,
+      selector: trigger.selector,
+      value: trigger.value
+    } : void 0,
+    confidence: d.confidence ?? 1,
+    metadata: d.metadata
+  };
+}
+function toStateDiscoveryResultSummary(data) {
+  return {
+    id: data.id,
+    projectId: data.projectId ?? data.project_id,
+    name: data.name,
+    description: data.description,
+    sourceType: data.sourceType ?? data.source_type,
+    discoveryStrategy: data.discoveryStrategy ?? data.discovery_strategy,
+    imageCount: data.imageCount ?? data.image_count,
+    stateCount: data.stateCount ?? data.state_count,
+    transitionCount: data.transitionCount ?? data.transition_count,
+    confidence: data.confidence,
+    createdAt: data.createdAt ?? data.created_at
+  };
+}
+
+// src/known-issues/index.ts
+var ISSUE_CATEGORIES = [
+  { value: "duplication", label: "Duplication" },
+  { value: "rendering", label: "Rendering" },
+  { value: "data_integrity", label: "Data Integrity" },
+  { value: "timing", label: "Timing" },
+  { value: "layout", label: "Layout" },
+  { value: "state", label: "State" },
+  { value: "performance", label: "Performance" },
+  { value: "encoding", label: "Encoding" },
+  { value: "navigation", label: "Navigation" },
+  { value: "authentication", label: "Authentication" },
+  { value: "other", label: "Other" }
+];
+var ISSUE_SEVERITIES = [
+  { value: "critical", label: "Critical" },
+  { value: "high", label: "High" },
+  { value: "medium", label: "Medium" },
+  { value: "low", label: "Low" }
+];
+var DETECTION_METHODS = [
+  { value: "algorithmic", label: "Algorithmic (automatic)" },
+  { value: "ai_judgment", label: "AI Judgment" },
+  { value: "visual", label: "Visual (screenshot)" },
+  { value: "command", label: "Shell Command" },
+  { value: "ui_bridge", label: "UI Bridge" }
+];
+export {
+  ActionStatus,
+  ActionType,
+  DEFAULT_SUMMARY_PROMPT,
+  DETECTION_METHODS,
+  ErrorType,
+  ISSUE_CATEGORIES,
+  ISSUE_SEVERITIES,
+  IssueSeverity,
+  PHASE_INFO,
+  RunStatus,
+  RunType,
+  SOURCE_TYPE_COLORS,
+  SOURCE_TYPE_LABELS,
+  STEP_TYPES,
+  ScreenshotType,
+  isComponentRenderLog,
+  isDomSnapshotRenderLog,
+  toDiscoveredState,
+  toDiscoveredStateImage,
+  toDiscoveredTransition,
+  toStateDiscoveryResult,
+  toStateDiscoveryResultSummary
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/render-log.ts","../src/discovery.ts","../src/known-issues/index.ts"],"sourcesContent":["/**\r\n * Shared Render Log Types\r\n *\r\n * These types define the render logging schema used across:\r\n * - qontinui-runner (Tauri desktop app) - Component-level logging\r\n * - qontinui-web (Next.js web app) - Full DOM snapshot logging\r\n *\r\n * The runner reads both its own logs and web's logs for verification\r\n * in AI feedback loops.\r\n *\r\n * NOTE: Field names use snake_case to match Rust/Python JSON serialization.\r\n * This ensures compatibility across all services.\r\n */\r\n\r\n// =============================================================================\r\n// Common Types\r\n// =============================================================================\r\n\r\n/**\r\n * Trigger types for render log capture.\r\n * What caused the render log to be captured.\r\n */\r\nexport type RenderLogTrigger =\r\n  | \"mount\" // Component/page mounted\r\n  | \"navigation\" // Page navigation occurred\r\n  | \"mutation\" // DOM mutation detected (web only)\r\n  | \"data_update\" // Data changed (runner components)\r\n  | \"prop_change\" // Props changed (runner components)\r\n  | \"manual\" // Explicitly triggered capture\r\n  | \"interval\"; // Periodic capture\r\n\r\n/**\r\n * DOM mutation types (for web's MutationObserver).\r\n */\r\nexport type DomMutationType = \"childList\" | \"attributes\" | \"characterData\";\r\n\r\n// =============================================================================\r\n// Base Render Log Entry\r\n// =============================================================================\r\n\r\n/**\r\n * Base render log entry with common fields.\r\n * Extended by component logs and DOM snapshot logs.\r\n */\r\nexport interface RenderLogEntryBase {\r\n  /** Unique identifier for this log entry */\r\n  id: string;\r\n\r\n  /** Unix timestamp in milliseconds when the capture occurred */\r\n  timestamp: number;\r\n\r\n  /** What triggered this capture */\r\n  trigger: RenderLogTrigger;\r\n\r\n  /** Session ID for grouping related captures */\r\n  session_id?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Runner Component Render Log (Lightweight)\r\n// =============================================================================\r\n\r\n/**\r\n * Component-level render log entry.\r\n * Used by qontinui-runner to log what data components render.\r\n *\r\n * Components explicitly call logRender() with their rendered data.\r\n * This is lightweight and focused on verifying data display.\r\n */\r\nexport interface ComponentRenderLogEntry extends RenderLogEntryBase {\r\n  /** Type discriminator */\r\n  type: \"component\";\r\n\r\n  /** Component name (e.g., \"RunRecapTab\", \"StatusBanner\") */\r\n  component: string;\r\n\r\n  /** The data that was rendered (component-specific structure) */\r\n  data: Record<string, unknown>;\r\n\r\n  /** Sections that are visible/expanded in the component */\r\n  visible_sections?: string[];\r\n\r\n  /** Associated task run ID if applicable */\r\n  task_run_id?: number;\r\n}\r\n\r\n// =============================================================================\r\n// Web DOM Snapshot Render Log (Comprehensive)\r\n// =============================================================================\r\n\r\n/**\r\n * Bounding rectangle for an element.\r\n */\r\nexport interface ElementRect {\r\n  x: number;\r\n  y: number;\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\n/**\r\n * Single DOM element in a snapshot.\r\n * Recursive structure representing the DOM tree.\r\n */\r\nexport interface DomElementSnapshot {\r\n  /** HTML tag name (lowercase) */\r\n  tag: string;\r\n\r\n  /** Element ID if present */\r\n  id?: string;\r\n\r\n  /** CSS class list */\r\n  class_list: string[];\r\n\r\n  /** Direct text content (not from children) */\r\n  text_content?: string;\r\n\r\n  /** Length of innerHTML (for size estimation) */\r\n  inner_html_length?: number;\r\n\r\n  /** Bounding rectangle relative to viewport */\r\n  rect?: ElementRect;\r\n\r\n  /** Whether the element is visible */\r\n  is_visible: boolean;\r\n\r\n  /** Computed opacity */\r\n  opacity?: number;\r\n\r\n  /** Computed display value */\r\n  display?: string;\r\n\r\n  /** Key HTML attributes */\r\n  attributes: Record<string, string>;\r\n\r\n  /** Selected computed styles */\r\n  computed_styles?: Record<string, string>;\r\n\r\n  /** Child elements (recursive) */\r\n  children: DomElementSnapshot[];\r\n}\r\n\r\n/**\r\n * Form data extracted from the page.\r\n */\r\nexport interface FormSnapshot {\r\n  id?: string;\r\n  action?: string;\r\n  method?: string;\r\n  inputs: Array<{\r\n    type: string;\r\n    name: string;\r\n    value: string;\r\n  }>;\r\n}\r\n\r\n/**\r\n * Link data extracted from the page.\r\n */\r\nexport interface LinkSnapshot {\r\n  href: string;\r\n  text: string;\r\n}\r\n\r\n/**\r\n * Image data extracted from the page.\r\n */\r\nexport interface ImageSnapshot {\r\n  src: string;\r\n  alt?: string;\r\n  width?: number;\r\n  height?: number;\r\n}\r\n\r\n/**\r\n * Full DOM snapshot data.\r\n * Contains the entire page state for debugging.\r\n *\r\n * NOTE: The snapshot is stored as JSONB in the database, so field names\r\n * in the nested structure (root, forms, links, images) may vary by\r\n * implementation. The web frontend uses camelCase internally but that's\r\n * stored as-is in the JSONB field.\r\n */\r\nexport interface DomSnapshot {\r\n  /** Root element tree (document.body) */\r\n  root: DomElementSnapshot | null;\r\n\r\n  /** Total number of elements in the tree */\r\n  total_elements: number;\r\n\r\n  /** Concatenated visible text (truncated) */\r\n  visible_text?: string;\r\n\r\n  /** Forms on the page */\r\n  forms: FormSnapshot[];\r\n\r\n  /** Links on the page */\r\n  links: LinkSnapshot[];\r\n\r\n  /** Images on the page */\r\n  images: ImageSnapshot[];\r\n\r\n  /** JavaScript console errors captured */\r\n  errors: string[];\r\n\r\n  /** JavaScript console warnings captured */\r\n  warnings: string[];\r\n}\r\n\r\n/**\r\n * Full DOM snapshot render log entry.\r\n * Used by qontinui-web to capture entire page state.\r\n *\r\n * Automatically captured via MutationObserver on DOM changes.\r\n * Provides comprehensive debugging data.\r\n */\r\nexport interface DomSnapshotRenderLogEntry extends RenderLogEntryBase {\r\n  /** Type discriminator */\r\n  type: \"dom_snapshot\";\r\n\r\n  /** Current page URL */\r\n  page_url: string;\r\n\r\n  /** Page title */\r\n  page_title?: string;\r\n\r\n  /** Type of DOM mutation that triggered capture (if mutation trigger) */\r\n  mutation_type?: DomMutationType;\r\n\r\n  /** CSS selector of the element that was mutated */\r\n  target_selector?: string;\r\n\r\n  /** The full DOM snapshot */\r\n  snapshot: DomSnapshot;\r\n\r\n  /** Viewport dimensions */\r\n  viewport_width?: number;\r\n  viewport_height?: number;\r\n\r\n  /** Scroll position */\r\n  scroll_x?: number;\r\n  scroll_y?: number;\r\n\r\n  /** Time taken to capture the snapshot in milliseconds */\r\n  capture_duration_ms?: number;\r\n\r\n  /** Number of elements captured */\r\n  element_count?: number;\r\n\r\n  /** User ID if authenticated (web only) */\r\n  user_id?: string;\r\n}\r\n\r\n// =============================================================================\r\n// Union Type\r\n// =============================================================================\r\n\r\n/**\r\n * Any render log entry.\r\n * Use the `type` field to discriminate.\r\n */\r\nexport type RenderLogEntry =\r\n  | ComponentRenderLogEntry\r\n  | DomSnapshotRenderLogEntry;\r\n\r\n// =============================================================================\r\n// API Types (for REST endpoints)\r\n// =============================================================================\r\n\r\n/**\r\n * Request to create a render log entry (web API).\r\n */\r\nexport interface CreateRenderLogRequest {\r\n  session_id: string;\r\n  page_url: string;\r\n  page_title?: string;\r\n  trigger: RenderLogTrigger;\r\n  mutation_type?: DomMutationType;\r\n  target_selector?: string;\r\n  snapshot: DomSnapshot;\r\n  viewport_width?: number;\r\n  viewport_height?: number;\r\n  scroll_x?: number;\r\n  scroll_y?: number;\r\n  capture_duration_ms?: number;\r\n  element_count?: number;\r\n}\r\n\r\n/**\r\n * Render log response from web API.\r\n * Includes database-generated fields.\r\n */\r\nexport interface RenderLogResponse {\r\n  id: number;\r\n  session_id: string;\r\n  timestamp: string; // ISO 8601 datetime\r\n  page_url: string;\r\n  page_title?: string;\r\n  trigger: RenderLogTrigger;\r\n  mutation_type?: DomMutationType;\r\n  target_selector?: string;\r\n  snapshot: DomSnapshot;\r\n  viewport_width?: number;\r\n  viewport_height?: number;\r\n  scroll_x?: number;\r\n  scroll_y?: number;\r\n  capture_duration_ms?: number;\r\n  element_count?: number;\r\n  user_id?: string;\r\n}\r\n\r\n/**\r\n * Summary of a render log (without full snapshot).\r\n */\r\nexport interface RenderLogSummary {\r\n  id: number;\r\n  session_id: string;\r\n  timestamp: string;\r\n  page_url: string;\r\n  page_title?: string;\r\n  trigger: RenderLogTrigger;\r\n  mutation_type?: DomMutationType;\r\n  element_count?: number;\r\n  capture_duration_ms?: number;\r\n}\r\n\r\n/**\r\n * Paginated list of render logs.\r\n */\r\nexport interface RenderLogList {\r\n  items: RenderLogSummary[];\r\n  total: number;\r\n  page: number;\r\n  page_size: number;\r\n  has_more: boolean;\r\n}\r\n\r\n/**\r\n * Render logging statistics.\r\n */\r\nexport interface RenderLogStats {\r\n  enabled: boolean;\r\n  total_snapshots: number;\r\n  total_sessions: number;\r\n  oldest_snapshot?: string;\r\n  newest_snapshot?: string;\r\n  storage_used_bytes: number;\r\n  image_count: number;\r\n}\r\n\r\n// =============================================================================\r\n// Type Guards\r\n// =============================================================================\r\n\r\n/**\r\n * Check if a render log entry is a component log.\r\n */\r\nexport function isComponentRenderLog(\r\n  entry: RenderLogEntry,\r\n): entry is ComponentRenderLogEntry {\r\n  return entry.type === \"component\";\r\n}\r\n\r\n/**\r\n * Check if a render log entry is a DOM snapshot log.\r\n */\r\nexport function isDomSnapshotRenderLog(\r\n  entry: RenderLogEntry,\r\n): entry is DomSnapshotRenderLogEntry {\r\n  return entry.type === \"dom_snapshot\";\r\n}\r\n","/**\r\n * Unified State Discovery Result types.\r\n *\r\n * These types represent the output of state discovery from any source:\r\n * - Playwright (web extraction)\r\n * - UI Bridge (render log analysis)\r\n * - Recording (user session recording)\r\n * - Vision (screenshot analysis)\r\n * - Manual (user-defined)\r\n *\r\n * All types use camelCase field names to match the generated types from Rust\r\n * schemas. Converter functions are provided to transform snake_case API\r\n * responses into these typed objects.\r\n */\r\n\r\n// =============================================================================\r\n// Re-exports from generated types\r\n// =============================================================================\r\n\r\nexport type { DiscoverySourceType } from \"./generated/DiscoverySourceType\";\r\nexport type { TransitionTriggerType } from \"./generated/TransitionTriggerType\";\r\nexport type { DiscoveryBoundingBox } from \"./generated/DiscoveryBoundingBox\";\r\nexport type { DiscoveryTransitionTrigger } from \"./generated/DiscoveryTransitionTrigger\";\r\nexport type { DiscoveredStateImage } from \"./generated/DiscoveredStateImage\";\r\nexport type { DiscoveredState } from \"./generated/DiscoveredState\";\r\nexport type { DiscoveredTransition } from \"./generated/DiscoveredTransition\";\r\nexport type { StateDiscoveryResult } from \"./generated/StateDiscoveryResult\";\r\nexport type { StateDiscoveryResultSummary } from \"./generated/StateDiscoveryResultSummary\";\r\nexport type { StateDiscoveryResultListResponse } from \"./generated/StateDiscoveryResultListResponse\";\r\nexport type { StateDiscoveryResultCreate } from \"./generated/StateDiscoveryResultCreate\";\r\nexport type { StateDiscoveryResultUpdate } from \"./generated/StateDiscoveryResultUpdate\";\r\n\r\n// =============================================================================\r\n// Export/Import\r\n// =============================================================================\r\n\r\nexport type { StateMachineExport } from \"./generated/StateMachineExport\";\r\nexport type { StateMachineImport } from \"./generated/StateMachineImport\";\r\n\r\nimport type { DiscoverySourceType } from \"./generated/DiscoverySourceType\";\r\nimport type { DiscoveredStateImage } from \"./generated/DiscoveredStateImage\";\r\nimport type { DiscoveredState } from \"./generated/DiscoveredState\";\r\nimport type { DiscoveredTransition } from \"./generated/DiscoveredTransition\";\r\n\r\n// =============================================================================\r\n// Display Helpers\r\n// =============================================================================\r\n\r\nexport const SOURCE_TYPE_LABELS: Record<DiscoverySourceType, string> = {\r\n  playwright: \"Web Extraction\",\r\n  ui_bridge: \"UI Bridge\",\r\n  recording: \"Recording\",\r\n  vision: \"Vision\",\r\n  manual: \"Manual\",\r\n};\r\n\r\nexport const SOURCE_TYPE_COLORS: Record<DiscoverySourceType, string> = {\r\n  playwright: \"bg-blue-500/20 text-blue-400 border-blue-500/30\",\r\n  ui_bridge: \"bg-purple-500/20 text-purple-400 border-purple-500/30\",\r\n  recording: \"bg-green-500/20 text-green-400 border-green-500/30\",\r\n  vision: \"bg-orange-500/20 text-orange-400 border-orange-500/30\",\r\n  manual: \"bg-gray-500/20 text-gray-400 border-gray-500/30\",\r\n};\r\n\r\n// =============================================================================\r\n// Converter Functions (snake_case API responses -> camelCase typed objects)\r\n// =============================================================================\r\n\r\nimport type { StateDiscoveryResult } from \"./generated/StateDiscoveryResult\";\r\nimport type { StateDiscoveryResultSummary } from \"./generated/StateDiscoveryResultSummary\";\r\nimport type { DiscoveryBoundingBox } from \"./generated/DiscoveryBoundingBox\";\r\nimport type { DiscoveryTransitionTrigger } from \"./generated/DiscoveryTransitionTrigger\";\r\nimport type { TransitionTriggerType } from \"./generated/TransitionTriggerType\";\r\n\r\nexport function toStateDiscoveryResult(\r\n  data: Record<string, unknown>,\r\n): StateDiscoveryResult {\r\n  return {\r\n    id: data.id as string,\r\n    projectId: (data.projectId ?? data.project_id) as string,\r\n    name: data.name as string,\r\n    description: data.description as string | undefined,\r\n    sourceType: (data.sourceType ?? data.source_type) as DiscoverySourceType,\r\n    sourceSessionId: (data.sourceSessionId ?? data.source_session_id) as\r\n      | string\r\n      | undefined,\r\n    discoveryStrategy: (data.discoveryStrategy ?? data.discovery_strategy) as\r\n      | string\r\n      | undefined,\r\n    images: ((data.images as unknown[]) || []).map(toDiscoveredStateImage),\r\n    states: ((data.states as unknown[]) || []).map(toDiscoveredState),\r\n    transitions: ((data.transitions as unknown[]) || []).map(\r\n      toDiscoveredTransition,\r\n    ),\r\n    elementToRenders:\r\n      ((data.elementToRenders ?? data.element_to_renders) as Record<\r\n        string,\r\n        string[]\r\n      >) || {},\r\n    imageCount: (data.imageCount ?? data.image_count) as number,\r\n    stateCount: (data.stateCount ?? data.state_count) as number,\r\n    transitionCount: (data.transitionCount ?? data.transition_count) as number,\r\n    renderCount: (data.renderCount ?? data.render_count) as number,\r\n    uniqueElementCount: (data.uniqueElementCount ??\r\n      data.unique_element_count) as number,\r\n    confidence: data.confidence as number,\r\n    discoveryMetadata:\r\n      ((data.discoveryMetadata ?? data.discovery_metadata) as Record<\r\n        string,\r\n        unknown\r\n      >) || {},\r\n    createdAt: (data.createdAt ?? data.created_at) as string,\r\n    updatedAt: (data.updatedAt ?? data.updated_at) as string,\r\n  };\r\n}\r\n\r\nexport function toDiscoveredStateImage(data: unknown): DiscoveredStateImage {\r\n  const d = data as Record<string, unknown>;\r\n  return {\r\n    id: d.id as string,\r\n    screenshotId: (d.screenshotId ?? d.screenshot_id) as string | undefined,\r\n    screenshotUrl: (d.screenshotUrl ?? d.screenshot_url) as string | undefined,\r\n    bbox: d.bbox as DiscoveryBoundingBox,\r\n    pixelHash: (d.pixelHash ?? d.pixel_hash) as string | undefined,\r\n    stateId: (d.stateId ?? d.state_id) as string | undefined,\r\n    elementType: (d.elementType ?? d.element_type) as string | undefined,\r\n    label: d.label as string | undefined,\r\n    confidence: (d.confidence as number) ?? 1.0,\r\n    metadata: d.metadata as Record<string, unknown> | undefined,\r\n  };\r\n}\r\n\r\nexport function toDiscoveredState(data: unknown): DiscoveredState {\r\n  const d = data as Record<string, unknown>;\r\n  return {\r\n    id: d.id as string,\r\n    name: d.name as string,\r\n    imageIds: ((d.imageIds ?? d.image_ids) as string[]) || [],\r\n    renderIds: ((d.renderIds ?? d.render_ids) as string[]) || [],\r\n    elementIds: ((d.elementIds ?? d.element_ids) as string[]) || [],\r\n    confidence: (d.confidence as number) ?? 1.0,\r\n    description: d.description as string | undefined,\r\n    metadata: d.metadata as Record<string, unknown> | undefined,\r\n  };\r\n}\r\n\r\nexport function toDiscoveredTransition(data: unknown): DiscoveredTransition {\r\n  const d = data as Record<string, unknown>;\r\n  const trigger = d.trigger as Record<string, unknown> | undefined;\r\n  return {\r\n    id: d.id as string,\r\n    fromStateId: (d.fromStateId ?? d.from_state_id) as string,\r\n    toStateId: (d.toStateId ?? d.to_state_id) as string,\r\n    trigger: trigger\r\n      ? {\r\n          type: (trigger.type as TransitionTriggerType) ?? \"click\",\r\n          imageId: (trigger.imageId ?? trigger.image_id) as string | undefined,\r\n          elementId: (trigger.elementId ?? trigger.element_id) as\r\n            | string\r\n            | undefined,\r\n          selector: trigger.selector as string | undefined,\r\n          value: trigger.value as string | undefined,\r\n        }\r\n      : undefined,\r\n    confidence: (d.confidence as number) ?? 1.0,\r\n    metadata: d.metadata as Record<string, unknown> | undefined,\r\n  };\r\n}\r\n\r\nexport function toStateDiscoveryResultSummary(\r\n  data: Record<string, unknown>,\r\n): StateDiscoveryResultSummary {\r\n  return {\r\n    id: data.id as string,\r\n    projectId: (data.projectId ?? data.project_id) as string,\r\n    name: data.name as string,\r\n    description: data.description as string | undefined,\r\n    sourceType: (data.sourceType ?? data.source_type) as DiscoverySourceType,\r\n    discoveryStrategy: (data.discoveryStrategy ?? data.discovery_strategy) as\r\n      | string\r\n      | undefined,\r\n    imageCount: (data.imageCount ?? data.image_count) as number,\r\n    stateCount: (data.stateCount ?? data.state_count) as number,\r\n    transitionCount: (data.transitionCount ?? data.transition_count) as number,\r\n    confidence: data.confidence as number,\r\n    createdAt: (data.createdAt ?? data.created_at) as string,\r\n  };\r\n}\r\n","/**\r\n * Known Issues Registry Types\r\n *\r\n * Persistent known issue tracking that survives across workflow runs.\r\n * Issues are scoped to specs, URLs, components, or global.\r\n */\r\n\r\nexport type IssueCategory =\r\n  | \"duplication\"\r\n  | \"rendering\"\r\n  | \"data_integrity\"\r\n  | \"timing\"\r\n  | \"layout\"\r\n  | \"state\"\r\n  | \"performance\"\r\n  | \"encoding\"\r\n  | \"navigation\"\r\n  | \"authentication\"\r\n  | \"other\";\r\n\r\nexport type ScopeType = \"global\" | \"spec\" | \"url\" | \"component\" | \"feature\";\r\n\r\nexport type DetectionMethod =\r\n  | \"algorithmic\"\r\n  | \"ai_judgment\"\r\n  | \"visual\"\r\n  | \"command\"\r\n  | \"ui_bridge\";\r\n\r\nexport type KnownIssueSeverity = \"critical\" | \"high\" | \"medium\" | \"low\";\r\n\r\nexport type IssueStatus = \"active\" | \"resolved\" | \"monitoring\" | \"wont_fix\";\r\n\r\nexport type IssueProvenance =\r\n  | \"manual\"\r\n  | \"auto_detected\"\r\n  | \"reflection\"\r\n  | \"imported\";\r\n\r\nexport interface KnownIssue {\r\n  id: string;\r\n  title: string;\r\n  description: string;\r\n  category: IssueCategory;\r\n  scope_type: ScopeType;\r\n  scope_value: string | null;\r\n  scope_tags: string[];\r\n  detection_method: DetectionMethod;\r\n  detection_config: Record<string, unknown>;\r\n  pattern_template_id: string | null;\r\n  reproduction_context: string | null;\r\n  trigger_conditions: string[];\r\n  severity: KnownIssueSeverity;\r\n  status: IssueStatus;\r\n  confidence: number;\r\n  provenance: IssueProvenance;\r\n  source_finding_ids: string[];\r\n  source_task_run_id: string | null;\r\n  verification_hint: string | null;\r\n  verification_step_template: Record<string, unknown> | null;\r\n  times_detected: number;\r\n  times_checked: number;\r\n  last_detected_at: string | null;\r\n  last_checked_at: string | null;\r\n  resolved_at: string | null;\r\n  created_at: string;\r\n  updated_at: string;\r\n}\r\n\r\nexport interface CreateKnownIssueRequest {\r\n  title: string;\r\n  description: string;\r\n  category: IssueCategory;\r\n  scope_type: ScopeType;\r\n  scope_value?: string | null;\r\n  scope_tags?: string[];\r\n  detection_method: DetectionMethod;\r\n  detection_config?: Record<string, unknown>;\r\n  pattern_template_id?: string | null;\r\n  reproduction_context?: string | null;\r\n  trigger_conditions?: string[];\r\n  severity: KnownIssueSeverity;\r\n  provenance?: IssueProvenance;\r\n  source_finding_ids?: string[];\r\n  source_task_run_id?: string | null;\r\n  verification_hint?: string | null;\r\n  verification_step_template?: Record<string, unknown> | null;\r\n}\r\n\r\nexport interface UpdateKnownIssueRequest {\r\n  title?: string;\r\n  description?: string;\r\n  category?: IssueCategory;\r\n  scope_type?: ScopeType;\r\n  scope_value?: string | null;\r\n  scope_tags?: string[];\r\n  detection_method?: DetectionMethod;\r\n  detection_config?: Record<string, unknown>;\r\n  pattern_template_id?: string | null;\r\n  reproduction_context?: string | null;\r\n  trigger_conditions?: string[];\r\n  severity?: KnownIssueSeverity;\r\n  status?: IssueStatus;\r\n  confidence?: number;\r\n  verification_hint?: string | null;\r\n  verification_step_template?: Record<string, unknown> | null;\r\n}\r\n\r\nexport interface ListKnownIssuesQuery {\r\n  scope_type?: string;\r\n  scope_value?: string;\r\n  category?: string;\r\n  severity?: string;\r\n  status?: string;\r\n  spec_id?: string;\r\n}\r\n\r\nexport interface CreatePatternTemplateRequest {\r\n  name: string;\r\n  description: string;\r\n  category: string;\r\n  detection_type: string;\r\n  ai_prompt_template?: string | null;\r\n  parameters?: string | null;\r\n}\r\n\r\nexport interface TemplateParameter {\r\n  name: string;\r\n  type: string;\r\n  description: string;\r\n  default?: unknown;\r\n}\r\n\r\nexport interface IssuePatternTemplate {\r\n  id: string;\r\n  name: string;\r\n  description: string;\r\n  category: string;\r\n  detection_type: string;\r\n  step_template: Record<string, unknown> | null;\r\n  ai_prompt_template: string | null;\r\n  parameters: TemplateParameter[];\r\n  built_in: boolean;\r\n  status: string;\r\n  created_at: string;\r\n  updated_at: string;\r\n}\r\n\r\n/** All issue categories with display labels */\r\nexport const ISSUE_CATEGORIES: { value: IssueCategory; label: string }[] = [\r\n  { value: \"duplication\", label: \"Duplication\" },\r\n  { value: \"rendering\", label: \"Rendering\" },\r\n  { value: \"data_integrity\", label: \"Data Integrity\" },\r\n  { value: \"timing\", label: \"Timing\" },\r\n  { value: \"layout\", label: \"Layout\" },\r\n  { value: \"state\", label: \"State\" },\r\n  { value: \"performance\", label: \"Performance\" },\r\n  { value: \"encoding\", label: \"Encoding\" },\r\n  { value: \"navigation\", label: \"Navigation\" },\r\n  { value: \"authentication\", label: \"Authentication\" },\r\n  { value: \"other\", label: \"Other\" },\r\n];\r\n\r\n/** All severity levels with display labels */\r\nexport const ISSUE_SEVERITIES: { value: KnownIssueSeverity; label: string }[] = [\r\n  { value: \"critical\", label: \"Critical\" },\r\n  { value: \"high\", label: \"High\" },\r\n  { value: \"medium\", label: \"Medium\" },\r\n  { value: \"low\", label: \"Low\" },\r\n];\r\n\r\n/** All detection methods with display labels */\r\nexport const DETECTION_METHODS: { value: DetectionMethod; label: string }[] = [\r\n  { value: \"algorithmic\", label: \"Algorithmic (automatic)\" },\r\n  { value: \"ai_judgment\", label: \"AI Judgment\" },\r\n  { value: \"visual\", label: \"Visual (screenshot)\" },\r\n  { value: \"command\", label: \"Shell Command\" },\r\n  { value: \"ui_bridge\", label: \"UI Bridge\" },\r\n];\r\n"],"mappings":"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","names":[]}

package/dist/library.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/library/index.ts
+var library_exports = {};
+module.exports = __toCommonJS(library_exports);
+//# sourceMappingURL=library.cjs.map

package/dist/library.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/library/index.ts"],"sourcesContent":["export * from \"./_api\";\r\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/library.d.cts

@@ -0,0 +1,205 @@
+/**
+ * Library Types
+ *
+ * Normalized types for library items that both apps agree on.
+ * These represent the various reusable building blocks available
+ * in the workflow builder's library pickers.
+ */
+interface LibraryItem {
+    id: string;
+    name: string;
+    description?: string;
+}
+interface CheckItem extends LibraryItem {
+    check_type: string;
+    tool?: string;
+    command?: string;
+    working_directory?: string;
+    config_path?: string;
+    auto_fix?: boolean;
+    fail_on_warning?: boolean;
+    timeout_seconds?: number;
+    enabled?: boolean;
+}
+interface CheckGroup extends LibraryItem {
+    checks: string[];
+    parallel?: boolean;
+    stop_on_first_failure?: boolean;
+}
+interface ShellCommand extends LibraryItem {
+    command: string;
+    working_directory?: string;
+    timeout_seconds?: number;
+    platform?: string;
+}
+interface SavedPrompt extends LibraryItem {
+    content: string;
+    provider?: string;
+    model?: string;
+    category?: string;
+    language?: string;
+}
+interface SavedApiRequest extends LibraryItem {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: string;
+    content_type?: string;
+    auth_type?: string;
+    variables?: Record<string, string>;
+}
+interface Context extends LibraryItem {
+    content: string;
+    auto_include?: boolean;
+    priority?: number;
+}
+interface Macro extends LibraryItem {
+    actions: MacroAction[];
+    timeout_seconds?: number;
+}
+interface MacroAction {
+    type: string;
+    config: Record<string, unknown>;
+    delay_ms?: number;
+}
+type BuiltInCategoryId = "code_bug" | "todo" | "config_issue" | "already_fixed" | "expected_behavior" | "data_migration" | "runtime_issue" | "test_issue" | "enhancement" | "warning" | "documentation" | "security" | "performance";
+type FindingActionType = "auto_fix" | "needs_user_input" | "manual" | "informational";
+type FindingStatus = "detected" | "in_progress" | "needs_input" | "resolved" | "wont_fix" | "deferred";
+type FindingSeverity = "critical" | "high" | "medium" | "low" | "info";
+type UserInputType = "text" | "choice" | "boolean" | "code";
+interface FindingCategory {
+    id: string;
+    name: string;
+    description: string;
+    icon: string;
+    color: string;
+    isBuiltIn: boolean;
+    defaultActionType: FindingActionType;
+    sortOrder: number;
+}
+interface UserInputOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+interface UserInputRequest {
+    id: string;
+    findingId: string;
+    question: string;
+    context?: string;
+    inputType: UserInputType;
+    options?: UserInputOption[];
+    required: boolean;
+    defaultValue?: string;
+}
+interface CodeContext {
+    file?: string;
+    line?: number;
+    endLine?: number;
+    snippet?: string;
+}
+interface Finding {
+    id: string;
+    categoryId: string;
+    severity: FindingSeverity;
+    status: FindingStatus;
+    title: string;
+    description: string;
+    sourceSessionId?: string;
+    sourcePromptName?: string;
+    detectedAt: number;
+    actionType: FindingActionType;
+    actionable: boolean;
+    pendingQuestion?: UserInputRequest;
+    userResponse?: string;
+    resolvedAt?: number;
+    resolution?: string;
+    codeContext?: CodeContext;
+    metadata?: Record<string, unknown>;
+}
+interface CategorySummary {
+    count: number;
+    actionable: number;
+    resolved: number;
+}
+interface ReportSummary {
+    totalFindings: number;
+    byCategory: Record<string, CategorySummary>;
+    bySeverity: Record<FindingSeverity, number>;
+    byStatus: Record<FindingStatus, number>;
+    actionable: number;
+    needsUserInput: number;
+    autoFixed: number;
+    informational: number;
+}
+type ReportStatus = "running" | "completed" | "paused_for_input" | "failed" | "cancelled";
+interface PhaseInfo {
+    phase: number;
+    startedAt: number;
+    completedAt?: number;
+    findingsDetected: number;
+    findingsResolved: number;
+}
+interface ExecutionReport {
+    id: string;
+    sessionId: string;
+    promptName: string;
+    promptId?: string;
+    startedAt: number;
+    completedAt?: number;
+    duration?: number;
+    status: ReportStatus;
+    findings: Finding[];
+    summary: ReportSummary;
+    pendingInputs: UserInputRequest[];
+    phases: PhaseInfo[];
+}
+interface ParsedFinding {
+    categoryId: string;
+    severity: FindingSeverity;
+    title: string;
+    description: string;
+    needsInput: boolean;
+    question?: string;
+    options?: string[];
+    file?: string;
+    line?: number;
+    resolution?: string;
+}
+interface CategoryStore {
+    customCategories: FindingCategory[];
+    categoryOrder: string[];
+    hiddenCategories: string[];
+}
+/** @deprecated Use FindingSeverity instead */
+type SeverityLevel = FindingSeverity;
+interface SeverityColorClasses {
+    bg: string;
+    text: string;
+    border: string;
+    dot: string;
+}
+type StatusColorType = "idle" | "running" | "success" | "error" | "warning" | "pending" | "paused" | "cancelled";
+interface StatusColorClasses {
+    bg: string;
+    text: string;
+    border: string;
+    icon: string;
+    pulse?: string;
+}
+type ActionColorType = "auto_fix" | "needs_user_input" | "manual" | "informational" | "skip" | "defer";
+interface ActionColorClasses {
+    bg: string;
+    text: string;
+    border: string;
+    badge: string;
+}
+type AccentColor = "red" | "orange" | "amber" | "yellow" | "green" | "emerald" | "blue" | "cyan" | "purple" | "rose" | "slate";
+interface AccentColorClasses {
+    bg: string;
+    bgSolid: string;
+    text: string;
+    border: string;
+}
+
+export type { AccentColor, AccentColorClasses, ActionColorClasses, ActionColorType, BuiltInCategoryId, CategoryStore, CategorySummary, CheckGroup, CheckItem, CodeContext, Context, ExecutionReport, Finding, FindingActionType, FindingCategory, FindingSeverity, FindingStatus, LibraryItem, Macro, MacroAction, ParsedFinding, PhaseInfo, ReportStatus, ReportSummary, SavedApiRequest, SavedPrompt, SeverityColorClasses, SeverityLevel, ShellCommand, StatusColorClasses, StatusColorType, UserInputOption, UserInputRequest, UserInputType };

package/dist/library.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Library Types
+ *
+ * Normalized types for library items that both apps agree on.
+ * These represent the various reusable building blocks available
+ * in the workflow builder's library pickers.
+ */
+interface LibraryItem {
+    id: string;
+    name: string;
+    description?: string;
+}
+interface CheckItem extends LibraryItem {
+    check_type: string;
+    tool?: string;
+    command?: string;
+    working_directory?: string;
+    config_path?: string;
+    auto_fix?: boolean;
+    fail_on_warning?: boolean;
+    timeout_seconds?: number;
+    enabled?: boolean;
+}
+interface CheckGroup extends LibraryItem {
+    checks: string[];
+    parallel?: boolean;
+    stop_on_first_failure?: boolean;
+}
+interface ShellCommand extends LibraryItem {
+    command: string;
+    working_directory?: string;
+    timeout_seconds?: number;
+    platform?: string;
+}
+interface SavedPrompt extends LibraryItem {
+    content: string;
+    provider?: string;
+    model?: string;
+    category?: string;
+    language?: string;
+}
+interface SavedApiRequest extends LibraryItem {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: string;
+    content_type?: string;
+    auth_type?: string;
+    variables?: Record<string, string>;
+}
+interface Context extends LibraryItem {
+    content: string;
+    auto_include?: boolean;
+    priority?: number;
+}
+interface Macro extends LibraryItem {
+    actions: MacroAction[];
+    timeout_seconds?: number;
+}
+interface MacroAction {
+    type: string;
+    config: Record<string, unknown>;
+    delay_ms?: number;
+}
+type BuiltInCategoryId = "code_bug" | "todo" | "config_issue" | "already_fixed" | "expected_behavior" | "data_migration" | "runtime_issue" | "test_issue" | "enhancement" | "warning" | "documentation" | "security" | "performance";
+type FindingActionType = "auto_fix" | "needs_user_input" | "manual" | "informational";
+type FindingStatus = "detected" | "in_progress" | "needs_input" | "resolved" | "wont_fix" | "deferred";
+type FindingSeverity = "critical" | "high" | "medium" | "low" | "info";
+type UserInputType = "text" | "choice" | "boolean" | "code";
+interface FindingCategory {
+    id: string;
+    name: string;
+    description: string;
+    icon: string;
+    color: string;
+    isBuiltIn: boolean;
+    defaultActionType: FindingActionType;
+    sortOrder: number;
+}
+interface UserInputOption {
+    value: string;
+    label: string;
+    description?: string;
+}
+interface UserInputRequest {
+    id: string;
+    findingId: string;
+    question: string;
+    context?: string;
+    inputType: UserInputType;
+    options?: UserInputOption[];
+    required: boolean;
+    defaultValue?: string;
+}
+interface CodeContext {
+    file?: string;
+    line?: number;
+    endLine?: number;
+    snippet?: string;
+}
+interface Finding {
+    id: string;
+    categoryId: string;
+    severity: FindingSeverity;
+    status: FindingStatus;
+    title: string;
+    description: string;
+    sourceSessionId?: string;
+    sourcePromptName?: string;
+    detectedAt: number;
+    actionType: FindingActionType;
+    actionable: boolean;
+    pendingQuestion?: UserInputRequest;
+    userResponse?: string;
+    resolvedAt?: number;
+    resolution?: string;
+    codeContext?: CodeContext;
+    metadata?: Record<string, unknown>;
+}
+interface CategorySummary {
+    count: number;
+    actionable: number;
+    resolved: number;
+}
+interface ReportSummary {
+    totalFindings: number;
+    byCategory: Record<string, CategorySummary>;
+    bySeverity: Record<FindingSeverity, number>;
+    byStatus: Record<FindingStatus, number>;
+    actionable: number;
+    needsUserInput: number;
+    autoFixed: number;
+    informational: number;
+}
+type ReportStatus = "running" | "completed" | "paused_for_input" | "failed" | "cancelled";
+interface PhaseInfo {
+    phase: number;
+    startedAt: number;
+    completedAt?: number;
+    findingsDetected: number;
+    findingsResolved: number;
+}
+interface ExecutionReport {
+    id: string;
+    sessionId: string;
+    promptName: string;
+    promptId?: string;
+    startedAt: number;
+    completedAt?: number;
+    duration?: number;
+    status: ReportStatus;
+    findings: Finding[];
+    summary: ReportSummary;
+    pendingInputs: UserInputRequest[];
+    phases: PhaseInfo[];
+}
+interface ParsedFinding {
+    categoryId: string;
+    severity: FindingSeverity;
+    title: string;
+    description: string;
+    needsInput: boolean;
+    question?: string;
+    options?: string[];
+    file?: string;
+    line?: number;
+    resolution?: string;
+}
+interface CategoryStore {
+    customCategories: FindingCategory[];
+    categoryOrder: string[];
+    hiddenCategories: string[];
+}
+/** @deprecated Use FindingSeverity instead */
+type SeverityLevel = FindingSeverity;
+interface SeverityColorClasses {
+    bg: string;
+    text: string;
+    border: string;
+    dot: string;
+}
+type StatusColorType = "idle" | "running" | "success" | "error" | "warning" | "pending" | "paused" | "cancelled";
+interface StatusColorClasses {
+    bg: string;
+    text: string;
+    border: string;
+    icon: string;
+    pulse?: string;
+}
+type ActionColorType = "auto_fix" | "needs_user_input" | "manual" | "informational" | "skip" | "defer";
+interface ActionColorClasses {
+    bg: string;
+    text: string;
+    border: string;
+    badge: string;
+}
+type AccentColor = "red" | "orange" | "amber" | "yellow" | "green" | "emerald" | "blue" | "cyan" | "purple" | "rose" | "slate";
+interface AccentColorClasses {
+    bg: string;
+    bgSolid: string;
+    text: string;
+    border: string;
+}
+
+export type { AccentColor, AccentColorClasses, ActionColorClasses, ActionColorType, BuiltInCategoryId, CategoryStore, CategorySummary, CheckGroup, CheckItem, CodeContext, Context, ExecutionReport, Finding, FindingActionType, FindingCategory, FindingSeverity, FindingStatus, LibraryItem, Macro, MacroAction, ParsedFinding, PhaseInfo, ReportStatus, ReportSummary, SavedApiRequest, SavedPrompt, SeverityColorClasses, SeverityLevel, ShellCommand, StatusColorClasses, StatusColorType, UserInputOption, UserInputRequest, UserInputType };

package/dist/library.js

@@ -0,0 +1 @@
+//# sourceMappingURL=library.js.map

package/dist/library.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}