@qontinui/shared-types 0.2.1

package/dist/workflow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/workflow/index.ts","../src/workflow/_api.ts"],"sourcesContent":["export * from \"./_api\";\r\n","/**\r\n * Workflow Types\r\n *\r\n * Canonical type definitions for the unified Workflow Builder system.\r\n * Shared across qontinui-runner and qontinui-web.\r\n *\r\n * All automation is organized into four phases: Setup, Verification, Agentic, Completion.\r\n *\r\n * Execution Order:\r\n *   Setup (once) -> [Verification <-> Agentic]* -> Completion (once)\r\n *\r\n * Step Types (4 core types):\r\n *   command   - Shell commands, checks, check groups, tests\r\n *   ui_bridge - UI Bridge SDK interactions (navigate, execute, assert, snapshot)\r\n *   prompt    - AI task instructions\r\n *   workflow  - Run a saved workflow inline (composition)\r\n */\r\n\r\n// =============================================================================\r\n// Generated frame types — source of truth is qontinui-schemas/rust/src/workflow.rs\r\n// These are produced by the schemars -> JSON Schema -> json-schema-to-typescript\r\n// pipeline. Do NOT redeclare them here; re-export from ../generated/*.\r\n//\r\n// Step arrays on UnifiedWorkflow / WorkflowStage are typed as `unknown[]` by\r\n// the generator. Typed step arrays are part of the Wave 4 step migration and\r\n// remain hand-authored below (BaseStep, CommandStep, PromptStep, UiBridgeStep,\r\n// WorkflowStep, and the per-phase aliases).\r\n// =============================================================================\r\n\r\nexport type { LogSourceSelection } from \"../generated/LogSourceSelection\";\r\nexport type { HealthCheckUrl } from \"../generated/HealthCheckUrl\";\r\nexport type { RoutingRule } from \"../generated/RoutingRule\";\r\nexport type { ModelOverrideConfig } from \"../generated/ModelOverrideConfig\";\r\nexport type { StageCondition } from \"../generated/StageCondition\";\r\nexport type { RetryPolicy } from \"../generated/RetryPolicy\";\r\nexport type { StageOutput } from \"../generated/StageOutput\";\r\nexport type { StageInput } from \"../generated/StageInput\";\r\nexport type { WorkflowStage } from \"../generated/WorkflowStage\";\r\nexport type { UnifiedWorkflow } from \"../generated/UnifiedWorkflow\";\r\nexport type { WorkflowArchitecture } from \"../generated/WorkflowArchitecture\";\r\n\r\nexport type { BaseStepFields } from \"../generated/BaseStepFields\";\r\nexport type { RetrySpec } from \"../generated/RetrySpec\";\r\n\r\n// Step DTOs (generated from qontinui-types::workflow_step)\r\nexport type { CommandStep } from \"../generated/CommandStep\";\r\nexport type { PromptStep } from \"../generated/PromptStep\";\r\nexport type { UiBridgeStep } from \"../generated/UiBridgeStep\";\r\nexport type { WorkflowStep } from \"../generated/WorkflowStep\";\r\nexport type { UnifiedStep } from \"../generated/UnifiedStep\";\r\nexport type { CanonicalStep } from \"../generated/CanonicalStep\";\r\nexport type { HttpMethod } from \"../generated/HttpMethod\";\r\nexport type { ApiContentType } from \"../generated/ApiContentType\";\r\nexport type { ApiAssertion } from \"../generated/ApiAssertion\";\r\nexport type { ApiVariableExtraction } from \"../generated/ApiVariableExtraction\";\r\nexport type { TestType } from \"../generated/TestType\";\r\nexport type { PlaywrightExecutionMode } from \"../generated/PlaywrightExecutionMode\";\r\nexport type { CheckType } from \"../generated/CheckType\";\r\nexport type { CommandMode } from \"../generated/CommandMode\";\r\nexport type { UiBridgeAction } from \"../generated/UiBridgeAction\";\r\nexport type { VerificationCategoryKind } from \"../generated/VerificationCategoryKind\";\r\n\r\n// ModelOverrides is a hand-authored convenience alias: the generated\r\n// UnifiedWorkflow / WorkflowStage type `model_overrides` as an open\r\n// `{ [k: string]: ModelOverrideConfig }`, but downstream code prefers a\r\n// named type with known phase keys. Keep as a local alias over the generated\r\n// per-phase config.\r\nimport type { ModelOverrideConfig as _ModelOverrideConfig } from \"../generated/ModelOverrideConfig\";\r\n\r\nexport type ModelOverrides = {\r\n  setup?: _ModelOverrideConfig;\r\n  agentic?: _ModelOverrideConfig;\r\n  completion?: _ModelOverrideConfig;\r\n  verification?: _ModelOverrideConfig;\r\n  investigation?: _ModelOverrideConfig;\r\n  summary?: _ModelOverrideConfig;\r\n  generation?: _ModelOverrideConfig;\r\n};\r\n\r\n// =============================================================================\r\n// Phases\r\n// =============================================================================\r\n\r\nexport type WorkflowPhase = \"setup\" | \"verification\" | \"agentic\" | \"completion\";\r\n\r\n// =============================================================================\r\n// Skill Types (re-exported from ./skill)\r\n// =============================================================================\r\n\r\nexport type {\r\n  SkillCategory,\r\n  SkillAuthor,\r\n  SkillParameterOption,\r\n  SkillParameter,\r\n  SingleStepTemplate,\r\n  MultiStepTemplate,\r\n  CompositionTemplate,\r\n  SkillRef,\r\n  SkillTemplate,\r\n  SkillDefinition,\r\n  SkillOrigin,\r\n  SkillExportManifest,\r\n  SkillExport,\r\n  SkillImportResult,\r\n} from \"./skill\";\r\n\r\nexport type {\r\n  PlannedActionType,\r\n  ElementTarget,\r\n  PlannedAction,\r\n  ActionPlan,\r\n  PlannedActionResult,\r\n  ActionPlanResult,\r\n  ActionPlanExecuteRequest,\r\n} from \"./action-plan\";\r\n\r\n// =============================================================================\r\n// Step Types — generated from qontinui-types::workflow_step\r\n//\r\n// The four canonical step variants (CommandStep, PromptStep, UiBridgeStep,\r\n// WorkflowStep) and their helper unions (HttpMethod, ApiContentType, …) are\r\n// re-exported at the top of this file from ../generated/*. The remaining\r\n// hand-authored types in this section are TS-only sugar: a `BaseStep` alias\r\n// for consumers that still want a name for the shared-fields subset, a\r\n// `StepTypeName` literal that includes non-canonical runner-side variants\r\n// (e.g. native_accessibility) for UI listings, and the phase-alias types.\r\n//\r\n// Phase narrowing is TS-only sugar — not a wire concern. The generator emits\r\n// a narrow `phase` field on each variant; these aliases just group the four\r\n// variants by the phase that can carry them.\r\n// =============================================================================\r\n\r\nimport type { CommandStep as _CommandStep } from \"../generated/CommandStep\";\r\nimport type { PromptStep as _PromptStep } from \"../generated/PromptStep\";\r\nimport type { UiBridgeStep as _UiBridgeStep } from \"../generated/UiBridgeStep\";\r\nimport type { WorkflowStep as _WorkflowStep } from \"../generated/WorkflowStep\";\r\n\r\n/**\r\n * Shared-fields subset carried by every canonical step variant.\r\n *\r\n * Alias for the generated `BaseStepFields` so downstream code can still\r\n * reference `BaseStep` by name.  Source of truth:\r\n * `qontinui-types::workflow_step::BaseStepFields`.\r\n */\r\nimport type { BaseStepFields as _BaseStepFields } from \"../generated/BaseStepFields\";\r\nexport type BaseStep = _BaseStepFields;\r\n\r\n// =============================================================================\r\n// Step Type Names\r\n// =============================================================================\r\n\r\n// Includes runner-side non-canonical variants (e.g. `native_accessibility`)\r\n// that appear in the UI listing but are not part of the `UnifiedStep` DTO.\r\nexport type StepTypeName = \"command\" | \"ui_bridge\" | \"prompt\" | \"workflow\" | \"native_accessibility\";\r\n\r\n// =============================================================================\r\n// Phase-alias types (TS-only sugar over the generated UnifiedStep)\r\n// =============================================================================\r\n\r\nexport type SetupStep = _CommandStep | _PromptStep | _UiBridgeStep | _WorkflowStep;\r\nexport type VerificationStep = _CommandStep | _PromptStep | _UiBridgeStep | _WorkflowStep;\r\nexport type AgenticStep = _PromptStep;\r\nexport type CompletionStep = _CommandStep | _PromptStep | _UiBridgeStep | _WorkflowStep;\r\n\r\n// =============================================================================\r\n// Verification Categories\r\n// =============================================================================\r\n\r\n// Alias for the generated `VerificationCategoryKind` union.  Source of truth:\r\n// `qontinui-types::workflow_step::VerificationCategoryKind`.  `VerificationCategoryKind`\r\n// itself is re-exported earlier in this file.\r\nimport type { VerificationCategoryKind as _VerificationCategoryKind } from \"../generated/VerificationCategoryKind\";\r\nexport type VerificationCategory = _VerificationCategoryKind;\r\n\r\n// =============================================================================\r\n// Dependency Graph\r\n// =============================================================================\r\n\r\nexport interface DependencyNode {\r\n  id: string;\r\n  label: string;\r\n  type: string;\r\n  phase: WorkflowPhase;\r\n  is_referenced: boolean;\r\n  cost_category?: string;\r\n}\r\n\r\nexport interface DependencyEdge {\r\n  source: string;\r\n  target: string;\r\n  label?: string;\r\n  edge_type: \"explicit_depends_on\" | \"implicit_reference\" | \"setup_provides\";\r\n}\r\n\r\nexport interface DependencyGraph {\r\n  nodes: DependencyNode[];\r\n  edges: DependencyEdge[];\r\n}\r\n\r\n// =============================================================================\r\n// Cost Annotations\r\n// =============================================================================\r\n\r\nexport type CostCategory =\r\n  | \"network\"\r\n  | \"ai_call\"\r\n  | \"setup\"\r\n  | \"ui_interaction\";\r\n\r\nexport interface StepCost {\r\n  step_id: string;\r\n  name: string;\r\n  estimated_ms: number;\r\n  category: CostCategory;\r\n  has_side_effects: boolean;\r\n}\r\n\r\nexport interface CostAnnotations {\r\n  steps: StepCost[];\r\n  total_estimated_ms: number;\r\n}\r\n\r\n// =============================================================================\r\n// Quality Report\r\n// =============================================================================\r\n\r\nexport type QualityFindingSeverity = \"critical\" | \"warning\" | \"info\";\r\n\r\nexport type QualityFindingCategory =\r\n  | \"verification_gap\"\r\n  | \"missing_criterion\"\r\n  | \"unnecessary_step\"\r\n  | \"weak_retry\"\r\n  | \"required_flag_violation\"\r\n  | \"retry_inconsistency\"\r\n  | \"data_contract_violation\"\r\n  | \"false_positive_risk\";\r\n\r\nexport interface QualityFinding {\r\n  finding_id: string;\r\n  step_id?: string;\r\n  severity: QualityFindingSeverity;\r\n  category: QualityFindingCategory;\r\n  description: string;\r\n  suggested_fix?: string;\r\n}\r\n\r\nexport interface CoverageMatrix {\r\n  criteria_to_steps: Record<string, string[]>;\r\n  steps_to_criteria: Record<string, string[]>;\r\n  uncovered_criteria: string[];\r\n  unlinked_steps: string[];\r\n}\r\n\r\nexport interface QualityReport {\r\n  findings: QualityFinding[];\r\n  score: number;\r\n  pass: boolean;\r\n  coverage_matrix?: CoverageMatrix;\r\n}\r\n\r\n// =============================================================================\r\n// Export/Import Types\r\n// =============================================================================\r\n\r\nimport type { UnifiedWorkflow as _UnifiedWorkflow } from \"../generated/UnifiedWorkflow\";\r\n\r\nexport interface WorkflowExportManifest {\r\n  version: string;\r\n  exported_at: string;\r\n  app_version: string;\r\n  content_type: \"unified_workflow\";\r\n}\r\n\r\nexport interface WorkflowExport {\r\n  manifest: WorkflowExportManifest;\r\n  workflow: _UnifiedWorkflow;\r\n}\r\n\r\nexport interface WorkflowImportResult {\r\n  workflow: _UnifiedWorkflow;\r\n  overwritten: boolean;\r\n  original_id: string | null;\r\n}\r\n\r\n// =============================================================================\r\n// Feature Detection\r\n// =============================================================================\r\n\r\nexport interface WorkflowFeatures {\r\n  hasSetup: boolean;\r\n  hasVerification: boolean;\r\n  hasAgentic: boolean;\r\n  hasCompletion: boolean;\r\n  hasUiBridge: boolean;\r\n  showIterationSettings: boolean;\r\n  hasAiPrompts: boolean;\r\n}\r\n\r\n// =============================================================================\r\n// Step Type Display Info\r\n// =============================================================================\r\n\r\nexport interface StepTypeInfo {\r\n  type: string;\r\n  label: string;\r\n  description: string;\r\n  icon: string;\r\n  color: string;\r\n  phase: WorkflowPhase;\r\n}\r\n\r\n// =============================================================================\r\n// Step Type Constants\r\n// =============================================================================\r\n\r\nexport const STEP_TYPES: Record<WorkflowPhase, StepTypeInfo[]> = {\r\n  setup: [\r\n    {\r\n      type: \"command\",\r\n      label: \"Command\",\r\n      description: \"Run shell commands, checks, or tests\",\r\n      icon: \"Terminal\",\r\n      color: \"gray\",\r\n      phase: \"setup\",\r\n    },\r\n    {\r\n      type: \"ui_bridge\",\r\n      label: \"UI Bridge\",\r\n      description: \"Interact with UI via UI Bridge SDK\",\r\n      icon: \"Monitor\",\r\n      color: \"emerald\",\r\n      phase: \"setup\",\r\n    },\r\n    {\r\n      type: \"prompt\",\r\n      label: \"AI Task\",\r\n      description: \"AI-driven task\",\r\n      icon: \"Bot\",\r\n      color: \"violet\",\r\n      phase: \"setup\",\r\n    },\r\n    {\r\n      type: \"workflow\",\r\n      label: \"Workflow\",\r\n      description: \"Run a saved workflow\",\r\n      icon: \"Workflow\",\r\n      color: \"blue\",\r\n      phase: \"setup\",\r\n    },\r\n  ],\r\n  verification: [\r\n    {\r\n      type: \"command\",\r\n      label: \"Command\",\r\n      description: \"Run commands, checks, or tests for verification\",\r\n      icon: \"Terminal\",\r\n      color: \"gray\",\r\n      phase: \"verification\",\r\n    },\r\n    {\r\n      type: \"ui_bridge\",\r\n      label: \"UI Bridge\",\r\n      description: \"Verify UI state via UI Bridge\",\r\n      icon: \"Monitor\",\r\n      color: \"emerald\",\r\n      phase: \"verification\",\r\n    },\r\n    {\r\n      type: \"prompt\",\r\n      label: \"AI Verification\",\r\n      description: \"AI-evaluated criteria\",\r\n      icon: \"Bot\",\r\n      color: \"violet\",\r\n      phase: \"verification\",\r\n    },\r\n    {\r\n      type: \"workflow\",\r\n      label: \"Workflow\",\r\n      description: \"Run a saved workflow for verification\",\r\n      icon: \"Workflow\",\r\n      color: \"blue\",\r\n      phase: \"verification\",\r\n    },\r\n    {\r\n      type: \"native_accessibility\",\r\n      label: \"Native Accessibility\",\r\n      description: \"Run a native accessibility audit using OS-level APIs\",\r\n      icon: \"Accessibility\",\r\n      color: \"teal\",\r\n      phase: \"verification\",\r\n    },\r\n  ],\r\n  agentic: [\r\n    {\r\n      type: \"prompt\",\r\n      label: \"Prompt\",\r\n      description: \"AI task instructions\",\r\n      icon: \"MessageSquare\",\r\n      color: \"amber\",\r\n      phase: \"agentic\",\r\n    },\r\n  ],\r\n  completion: [\r\n    {\r\n      type: \"command\",\r\n      label: \"Command\",\r\n      description: \"Run cleanup commands or final tests\",\r\n      icon: \"Terminal\",\r\n      color: \"gray\",\r\n      phase: \"completion\",\r\n    },\r\n    {\r\n      type: \"ui_bridge\",\r\n      label: \"UI Bridge\",\r\n      description: \"Final UI interactions\",\r\n      icon: \"Monitor\",\r\n      color: \"emerald\",\r\n      phase: \"completion\",\r\n    },\r\n    {\r\n      type: \"prompt\",\r\n      label: \"AI Completion\",\r\n      description: \"Final AI actions\",\r\n      icon: \"Bot\",\r\n      color: \"violet\",\r\n      phase: \"completion\",\r\n    },\r\n    {\r\n      type: \"workflow\",\r\n      label: \"Workflow\",\r\n      description: \"Run a saved workflow as a completion step\",\r\n      icon: \"Workflow\",\r\n      color: \"blue\",\r\n      phase: \"completion\",\r\n    },\r\n  ],\r\n};\r\n\r\n// =============================================================================\r\n// Phase Display Info\r\n// =============================================================================\r\n\r\nexport const PHASE_INFO: Record<\r\n  WorkflowPhase,\r\n  { label: string; description: string; color: string }\r\n> = {\r\n  setup: {\r\n    label: \"Setup\",\r\n    description: \"Runs once at the beginning\",\r\n    color: \"blue\",\r\n  },\r\n  verification: {\r\n    label: \"Verification\",\r\n    description: \"Checks success criteria, loops with agentic\",\r\n    color: \"green\",\r\n  },\r\n  agentic: {\r\n    label: \"Agentic\",\r\n    description: \"AI work, iterates until verification passes\",\r\n    color: \"amber\",\r\n  },\r\n  completion: {\r\n    label: \"Completion\",\r\n    description: \"Runs once after the loop exits\",\r\n    color: \"purple\",\r\n  },\r\n};\r\n\r\n// =============================================================================\r\n// Summary Step Constants\r\n// =============================================================================\r\n\r\nexport const DEFAULT_SUMMARY_PROMPT = `Write a one-paragraph summary of all the tasks completed in this workflow. Include what was accomplished, whether the stated goal was achieved, any issues encountered and how they were resolved, and remaining work if the goal was not fully achieved. Be concise but comprehensive.`;\r\n"],"mappings":"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","names":[]}