[WIP] workflow builder

2026-02-23 20:45:10 -06:00
parent d629da32fa
commit 53a3fbb6b1
66 changed files with 7887 additions and 1608 deletions
--- a/crates/api/src/dto/action.rs
+++ b/crates/api/src/dto/action.rs
@@ -38,14 +38,14 @@ pub struct CreateActionRequest {
    #[schema(example = 1)]
    pub runtime: Option<i64>,

-    /// Parameter schema (JSON Schema) defining expected inputs
+    /// Parameter schema (StackStorm-style) defining expected inputs with inline required/secret
    #[serde(skip_serializing_if = "Option::is_none")]
-    #[schema(value_type = Object, nullable = true, example = json!({"type": "object", "properties": {"channel": {"type": "string"}, "message": {"type": "string"}}}))]
+    #[schema(value_type = Object, nullable = true, example = json!({"channel": {"type": "string", "description": "Slack channel", "required": true}, "message": {"type": "string", "description": "Message text", "required": true}}))]
    pub param_schema: Option<JsonValue>,

-    /// Output schema (JSON Schema) defining expected outputs
+    /// Output schema (flat format) defining expected outputs with inline required/secret
    #[serde(skip_serializing_if = "Option::is_none")]
-    #[schema(value_type = Object, nullable = true, example = json!({"type": "object", "properties": {"message_id": {"type": "string"}}}))]
+    #[schema(value_type = Object, nullable = true, example = json!({"message_id": {"type": "string", "description": "ID of the sent message", "required": true}}))]
    pub out_schema: Option<JsonValue>,
 }

@@ -71,7 +71,7 @@ pub struct UpdateActionRequest {
    #[schema(example = 1)]
    pub runtime: Option<i64>,

-    /// Parameter schema
+    /// Parameter schema (StackStorm-style with inline required/secret)
    #[schema(value_type = Object, nullable = true)]
    pub param_schema: Option<JsonValue>,

@@ -115,7 +115,7 @@ pub struct ActionResponse {
    #[schema(example = 1)]
    pub runtime: Option<i64>,

-    /// Parameter schema
+    /// Parameter schema (StackStorm-style with inline required/secret)
    #[schema(value_type = Object, nullable = true)]
    pub param_schema: Option<JsonValue>,

--- a/crates/api/src/dto/inquiry.rs
+++ b/crates/api/src/dto/inquiry.rs
@@ -137,8 +137,8 @@ pub struct CreateInquiryRequest {
    #[schema(example = "Approve deployment to production?")]
    pub prompt: String,

-    /// Optional JSON schema for the expected response format
-    #[schema(value_type = Object, example = json!({"type": "object", "properties": {"approved": {"type": "boolean"}}}))]
+    /// Optional schema for the expected response format (flat format with inline required/secret)
+    #[schema(value_type = Object, example = json!({"approved": {"type": "boolean", "description": "Whether the deployment is approved", "required": true}}))]
    pub response_schema: Option<JsonSchema>,

    /// Optional identity ID to assign this inquiry to
--- a/crates/api/src/dto/pack.rs
+++ b/crates/api/src/dto/pack.rs
@@ -28,9 +28,9 @@ pub struct CreatePackRequest {
    #[schema(example = "1.0.0")]
    pub version: String,

-    /// Configuration schema (JSON Schema)
+    /// Configuration schema (flat format with inline required/secret per parameter)
    #[serde(default = "default_empty_object")]
-    #[schema(value_type = Object, example = json!({"type": "object", "properties": {"api_token": {"type": "string"}}}))]
+    #[schema(value_type = Object, example = json!({"api_token": {"type": "string", "description": "API authentication key", "required": true, "secret": true}}))]
    pub conf_schema: JsonValue,

    /// Pack configuration values
@@ -95,11 +95,6 @@ pub struct InstallPackRequest {
    #[schema(example = "main")]
    pub ref_spec: Option<String>,

-    /// Force reinstall if pack already exists
-    #[serde(default)]
-    #[schema(example = false)]
-    pub force: bool,
-
    /// Skip running pack tests during installation
    #[serde(default)]
    #[schema(example = false)]
--- a/crates/api/src/dto/trigger.rs
+++ b/crates/api/src/dto/trigger.rs
@@ -28,14 +28,14 @@ pub struct CreateTriggerRequest {
    #[schema(example = "Triggers when a webhook is received")]
    pub description: Option<String>,

-    /// Parameter schema (JSON Schema) defining event payload structure
+    /// Parameter schema (StackStorm-style) defining trigger configuration with inline required/secret
    #[serde(skip_serializing_if = "Option::is_none")]
-    #[schema(value_type = Object, nullable = true, example = json!({"type": "object", "properties": {"url": {"type": "string"}}}))]
+    #[schema(value_type = Object, nullable = true, example = json!({"url": {"type": "string", "description": "Webhook URL", "required": true}}))]
    pub param_schema: Option<JsonValue>,

-    /// Output schema (JSON Schema) defining event data structure
+    /// Output schema (flat format) defining event data structure with inline required/secret
    #[serde(skip_serializing_if = "Option::is_none")]
-    #[schema(value_type = Object, nullable = true, example = json!({"type": "object", "properties": {"payload": {"type": "object"}}}))]
+    #[schema(value_type = Object, nullable = true, example = json!({"payload": {"type": "object", "description": "Event payload data", "required": true}}))]
    pub out_schema: Option<JsonValue>,

    /// Whether the trigger is enabled
@@ -56,7 +56,7 @@ pub struct UpdateTriggerRequest {
    #[schema(example = "Updated webhook trigger description")]
    pub description: Option<String>,

-    /// Parameter schema
+    /// Parameter schema (StackStorm-style with inline required/secret)
    #[schema(value_type = Object, nullable = true)]
    pub param_schema: Option<JsonValue>,

@@ -100,7 +100,7 @@ pub struct TriggerResponse {
    #[schema(example = true)]
    pub enabled: bool,

-    /// Parameter schema
+    /// Parameter schema (StackStorm-style with inline required/secret)
    #[schema(value_type = Object, nullable = true)]
    pub param_schema: Option<JsonValue>,

@@ -208,9 +208,9 @@ pub struct CreateSensorRequest {
    #[schema(example = "monitoring.cpu_threshold")]
    pub trigger_ref: String,

-    /// Parameter schema (JSON Schema) for sensor configuration
+    /// Parameter schema (flat format) for sensor configuration
    #[serde(skip_serializing_if = "Option::is_none")]
-    #[schema(value_type = Object, nullable = true, example = json!({"type": "object", "properties": {"threshold": {"type": "number"}}}))]
+    #[schema(value_type = Object, nullable = true, example = json!({"threshold": {"type": "number", "description": "Alert threshold", "required": true}}))]
    pub param_schema: Option<JsonValue>,

    /// Configuration values for this sensor instance (conforms to param_schema)
@@ -242,7 +242,7 @@ pub struct UpdateSensorRequest {
    #[schema(example = "/sensors/monitoring/cpu_monitor_v2.py")]
    pub entrypoint: Option<String>,

-    /// Parameter schema
+    /// Parameter schema (StackStorm-style with inline required/secret)
    #[schema(value_type = Object, nullable = true)]
    pub param_schema: Option<JsonValue>,

@@ -302,7 +302,7 @@ pub struct SensorResponse {
    #[schema(example = true)]
    pub enabled: bool,

-    /// Parameter schema
+    /// Parameter schema (StackStorm-style with inline required/secret)
    #[schema(value_type = Object, nullable = true)]
    pub param_schema: Option<JsonValue>,

--- a/crates/api/src/dto/workflow.rs
+++ b/crates/api/src/dto/workflow.rs
@@ -6,6 +6,54 @@ use serde_json::Value as JsonValue;
 use utoipa::{IntoParams, ToSchema};
 use validator::Validate;

+/// Request DTO for saving a workflow file to disk and syncing to DB
+#[derive(Debug, Clone, Deserialize, Validate, ToSchema)]
+pub struct SaveWorkflowFileRequest {
+    /// Workflow name (becomes filename: {name}.workflow.yaml)
+    #[validate(length(min = 1, max = 255))]
+    #[schema(example = "deploy_app")]
+    pub name: String,
+
+    /// Human-readable label
+    #[validate(length(min = 1, max = 255))]
+    #[schema(example = "Deploy Application")]
+    pub label: String,
+
+    /// Workflow description
+    #[schema(example = "Deploys an application to the target environment")]
+    pub description: Option<String>,
+
+    /// Workflow version (semantic versioning recommended)
+    #[validate(length(min = 1, max = 50))]
+    #[schema(example = "1.0.0")]
+    pub version: String,
+
+    /// Pack reference this workflow belongs to
+    #[validate(length(min = 1, max = 255))]
+    #[schema(example = "core")]
+    pub pack_ref: String,
+
+    /// The full workflow definition as JSON (will be serialized to YAML on disk)
+    #[schema(value_type = Object)]
+    pub definition: JsonValue,
+
+    /// Parameter schema (flat format with inline required/secret)
+    #[schema(value_type = Object, nullable = true)]
+    pub param_schema: Option<JsonValue>,
+
+    /// Output schema (flat format)
+    #[schema(value_type = Object, nullable = true)]
+    pub out_schema: Option<JsonValue>,
+
+    /// Tags for categorization
+    #[schema(example = json!(["deployment", "automation"]))]
+    pub tags: Option<Vec<String>>,
+
+    /// Whether the workflow is enabled
+    #[schema(example = true)]
+    pub enabled: Option<bool>,
+}
+
 /// Request DTO for creating a new workflow
 #[derive(Debug, Clone, Deserialize, Validate, ToSchema)]
 pub struct CreateWorkflowRequest {
@@ -33,12 +81,12 @@ pub struct CreateWorkflowRequest {
    #[schema(example = "1.0.0")]
    pub version: String,

-    /// Parameter schema (JSON Schema) defining expected inputs
-    #[schema(value_type = Object, example = json!({"type": "object", "properties": {"severity": {"type": "string"}, "channel": {"type": "string"}}}))]
+    /// Parameter schema (StackStorm-style) defining expected inputs with inline required/secret
+    #[schema(value_type = Object, example = json!({"severity": {"type": "string", "description": "Incident severity", "required": true}, "channel": {"type": "string", "description": "Notification channel"}}))]
    pub param_schema: Option<JsonValue>,

-    /// Output schema (JSON Schema) defining expected outputs
-    #[schema(value_type = Object, example = json!({"type": "object", "properties": {"incident_id": {"type": "string"}}}))]
+    /// Output schema (flat format) defining expected outputs with inline required/secret
+    #[schema(value_type = Object, example = json!({"incident_id": {"type": "string", "description": "Unique incident identifier", "required": true}}))]
    pub out_schema: Option<JsonValue>,

    /// Workflow definition (complete workflow YAML structure as JSON)
@@ -71,7 +119,7 @@ pub struct UpdateWorkflowRequest {
    #[schema(example = "1.1.0")]
    pub version: Option<String>,

-    /// Parameter schema
+    /// Parameter schema (StackStorm-style with inline required/secret)
    #[schema(value_type = Object, nullable = true)]
    pub param_schema: Option<JsonValue>,

@@ -123,7 +171,7 @@ pub struct WorkflowResponse {
    #[schema(example = "1.0.0")]
    pub version: String,

-    /// Parameter schema
+    /// Parameter schema (StackStorm-style with inline required/secret)
    #[schema(value_type = Object, nullable = true)]
    pub param_schema: Option<JsonValue>,