@oxy-hq/cli 0.1.0

package/json-schemas/app.json

@@ -0,0 +1,1884 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "AppConfig",
+  "type": "object",
+  "required": [
+    "display",
+    "tasks"
+  ],
+  "properties": {
+    "controls": {
+      "description": "Interactive controls (dropdowns, toggles, date pickers) whose values are injected into task Jinja templates as `{{ controls.<name> }}`.",
+      "default": [],
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ControlConfig"
+      }
+    },
+    "description": {
+      "description": "Optional description of the app.",
+      "default": "",
+      "type": "string"
+    },
+    "display": {
+      "description": "display blocks to render the app",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Display"
+      }
+    },
+    "published": {
+      "description": "When false (default), the app is treated as a draft and hidden from the left sidebar. Authors can still open, edit, and run it from the IDE. Flip to true to make the app visible to consumers.",
+      "default": false,
+      "type": "boolean"
+    },
+    "tasks": {
+      "description": "tasks to prepare the data for the app",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Task"
+      }
+    },
+    "title": {
+      "description": "Human-friendly title shown in dashboard listings. When unset, callers fall back to a humanized form of the filename-derived name.",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "AppTaskMode": {
+      "description": "Where a task is executed when used inside an app with interactive controls. `client` (default) — the frontend re-runs the SQL directly in DuckDB WASM on every control change; no server round-trip required. `server` — the server executes the task on every control change (required for tasks that query external databases like Snowflake or BigQuery).",
+      "type": "string",
+      "enum": [
+        "client",
+        "server"
+      ]
+    },
+    "Condition": {
+      "type": "object",
+      "required": [
+        "if",
+        "tasks"
+      ],
+      "properties": {
+        "if": {
+          "type": "string"
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Task"
+          }
+        }
+      }
+    },
+    "ControlConfig": {
+      "type": "object",
+      "required": [
+        "name",
+        "type"
+      ],
+      "properties": {
+        "default": {
+          "description": "Default value injected into Jinja context on initial load.",
+          "default": null
+        },
+        "label": {
+          "default": null,
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "options": {
+          "description": "Static list of options (used when source is not set).",
+          "default": null,
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": true
+        },
+        "source": {
+          "description": "Task name whose first column populates dropdown options dynamically.",
+          "default": null,
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "type": {
+          "$ref": "#/definitions/ControlType"
+        }
+      }
+    },
+    "ControlType": {
+      "type": "string",
+      "enum": [
+        "select",
+        "toggle",
+        "date"
+      ]
+    },
+    "Display": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "content",
+            "type"
+          ],
+          "properties": {
+            "content": {
+              "type": "string"
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "markdown"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "data",
+            "type",
+            "x",
+            "y"
+          ],
+          "properties": {
+            "data": {
+              "description": "reference data output from a table using table name",
+              "type": "string"
+            },
+            "series": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "title": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "line_chart"
+              ]
+            },
+            "x": {
+              "type": "string"
+            },
+            "x_axis_label": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "y": {
+              "type": "string"
+            },
+            "y_axis_label": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "y_format": {
+              "description": "Optional formatting applied to the y-axis labels and tooltip values. Use `currency` for monetary measures. Unset renders raw numbers.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/DisplayFormat"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "data",
+            "name",
+            "type",
+            "value"
+          ],
+          "properties": {
+            "data": {
+              "description": "reference data output from a table using table name",
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "title": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "pie_chart"
+              ]
+            },
+            "value": {
+              "type": "string"
+            },
+            "value_format": {
+              "description": "Optional formatting applied to the slice value in the tooltip. Use `currency` for monetary measures. Unset renders raw numbers.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/DisplayFormat"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "data",
+            "type",
+            "x",
+            "y"
+          ],
+          "properties": {
+            "data": {
+              "description": "reference data output from a table using table name",
+              "type": "string"
+            },
+            "series": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "title": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "bar_chart"
+              ]
+            },
+            "x": {
+              "type": "string"
+            },
+            "y": {
+              "type": "string"
+            },
+            "y_format": {
+              "description": "Optional formatting applied to the y-axis labels and tooltip values. Use `currency` for monetary measures. Unset renders raw numbers.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/DisplayFormat"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "data",
+            "type"
+          ],
+          "properties": {
+            "data": {
+              "type": "string"
+            },
+            "formats": {
+              "description": "Optional per-column formatting. Keys are the output column names as they appear in the task result (e.g. `oxymart__total_weekly_sales` for semantic_query tasks, which join view + field with `__`). Columns omitted from the map fall back to the default numeric formatter.",
+              "type": [
+                "object",
+                "null"
+              ],
+              "additionalProperties": {
+                "$ref": "#/definitions/DisplayFormat"
+              }
+            },
+            "title": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "table"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "children",
+            "type"
+          ],
+          "properties": {
+            "children": {
+              "description": "Child display blocks rendered side-by-side in a grid row.",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Display"
+              }
+            },
+            "columns": {
+              "description": "Number of equal-width columns; defaults to the number of children.",
+              "default": null,
+              "type": [
+                "integer",
+                "null"
+              ],
+              "format": "uint8",
+              "minimum": 0.0
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "row"
+              ]
+            }
+          }
+        },
+        {
+          "description": "A group of controls defined inline in the display list. The backend extracts these items into the controls array before sending to clients.",
+          "type": "object",
+          "required": [
+            "items",
+            "type"
+          ],
+          "properties": {
+            "items": {
+              "description": "Interactive controls defined inline in the display list.",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/ControlConfig"
+              }
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "controls"
+              ]
+            }
+          }
+        },
+        {
+          "description": "A single control defined inline in the display list. Because the Display enum uses \"type\" as its discriminant, the control kind is expressed as \"control_type\" instead of \"type\" to avoid a duplicate-key conflict:\n\ndisplay: - type: control name: region control_type: select label: Region options: [All, North, South]",
+          "type": "object",
+          "required": [
+            "control_type",
+            "name",
+            "type"
+          ],
+          "properties": {
+            "control_type": {
+              "$ref": "#/definitions/ControlType"
+            },
+            "default": {
+              "default": null
+            },
+            "label": {
+              "default": null,
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": "string"
+            },
+            "options": {
+              "default": null,
+              "type": [
+                "array",
+                "null"
+              ],
+              "items": true
+            },
+            "source": {
+              "default": null,
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "control"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "DisplayFormat": {
+      "description": "How a numeric value is formatted for display.\n\nUsed on chart axes / tooltips and on individual table columns. When unset, the renderer falls back to its default numeric formatting (trailing zeros stripped for integers, two decimals for floats).",
+      "oneOf": [
+        {
+          "description": "Monetary values — e.g. `$301,397,792.46`. Uses USD by default.",
+          "type": "string",
+          "enum": [
+            "currency"
+          ]
+        },
+        {
+          "description": "Percentage values — e.g. `12.5%`. Input is already a percentage (0–100), not a ratio.",
+          "type": "string",
+          "enum": [
+            "percent"
+          ]
+        },
+        {
+          "description": "Plain number with thousands separators — e.g. `1,234,567`.",
+          "type": "string",
+          "enum": [
+            "number"
+          ]
+        }
+      ]
+    },
+    "ExportFormat": {
+      "type": "string",
+      "enum": [
+        "sql",
+        "csv",
+        "json",
+        "txt",
+        "docx"
+      ]
+    },
+    "LookerSortField": {
+      "description": "A sort field for a Looker query with explicit field name and direction.",
+      "type": "object",
+      "required": [
+        "field"
+      ],
+      "properties": {
+        "direction": {
+          "default": "asc",
+          "type": "string"
+        },
+        "field": {
+          "type": "string"
+        }
+      }
+    },
+    "LoopValues": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": true
+        }
+      ]
+    },
+    "OrderType": {
+      "type": "string",
+      "enum": [
+        "asc",
+        "desc"
+      ]
+    },
+    "PersistToSecret": {
+      "description": "Persist a field of an `http_request` JSON response back into a project secret.\n\nThis is the rotating-OAuth-token path: the QuickBooks token-refresh response returns a new `refresh_token`, which we write back to the secret store so the next run starts from the latest value (mirrors the Airway Intuit source).",
+      "type": "object",
+      "required": [
+        "from",
+        "name"
+      ],
+      "properties": {
+        "from": {
+          "description": "JSON pointer into the parsed response body, e.g. `/refresh_token`.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Project secret name to upsert with the extracted value.",
+          "type": "string"
+        }
+      }
+    },
+    "SemanticFilter": {
+      "anyOf": [
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "op",
+            "value"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "eq"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "op",
+            "value"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "neq"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "op",
+            "value"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "gt"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "op",
+            "value"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "gte"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "op",
+            "value"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "lt"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "op",
+            "value"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "lte"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "op",
+            "values"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "in"
+              ]
+            },
+            "values": {
+              "description": "Array of values to filter by. Each value can be a string, number, boolean, or null.",
+              "type": [
+                "array"
+              ],
+              "items": {
+                "type": [
+                  "string",
+                  "number",
+                  "boolean",
+                  "null"
+                ]
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "op",
+            "values"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "not_in"
+              ]
+            },
+            "values": {
+              "description": "Array of values to filter by. Each value can be a string, number, boolean, or null.",
+              "type": [
+                "array"
+              ],
+              "items": {
+                "type": [
+                  "string",
+                  "number",
+                  "boolean",
+                  "null"
+                ]
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "from",
+            "op",
+            "to"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "from": {
+              "description": "Start of the date range. Can be a string (ISO date or relative like 'today', '7 days ago'), number (timestamp).",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "in_date_range"
+              ]
+            },
+            "to": {
+              "description": "End of the date range. Can be a string (ISO date or relative like 'today', '7 days ago'), number (timestamp).",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "field",
+            "from",
+            "op",
+            "to"
+          ],
+          "properties": {
+            "field": {
+              "description": "The measure/dimension to apply the filter on. Must by full name: <view_name>.<field_name>",
+              "type": "string"
+            },
+            "from": {
+              "description": "Start of the date range. Can be a string (ISO date or relative like 'today', '7 days ago'), number (timestamp).",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "not_in_date_range"
+              ]
+            },
+            "to": {
+              "description": "End of the date range. Can be a string (ISO date or relative like 'today', '7 days ago'), number (timestamp).",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "SemanticFilterType": {
+      "description": "Enum representing different filter types with their appropriate value types",
+      "oneOf": [
+        {
+          "description": "Scalar comparison filter (eq, neq, gt, gte, lt, lte)",
+          "type": "object",
+          "required": [
+            "op",
+            "value"
+          ],
+          "properties": {
+            "op": {
+              "type": "string",
+              "enum": [
+                "eq"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Scalar comparison filter (eq, neq, gt, gte, lt, lte)",
+          "type": "object",
+          "required": [
+            "op",
+            "value"
+          ],
+          "properties": {
+            "op": {
+              "type": "string",
+              "enum": [
+                "neq"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Scalar comparison filter (eq, neq, gt, gte, lt, lte)",
+          "type": "object",
+          "required": [
+            "op",
+            "value"
+          ],
+          "properties": {
+            "op": {
+              "type": "string",
+              "enum": [
+                "gt"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Scalar comparison filter (eq, neq, gt, gte, lt, lte)",
+          "type": "object",
+          "required": [
+            "op",
+            "value"
+          ],
+          "properties": {
+            "op": {
+              "type": "string",
+              "enum": [
+                "gte"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Scalar comparison filter (eq, neq, gt, gte, lt, lte)",
+          "type": "object",
+          "required": [
+            "op",
+            "value"
+          ],
+          "properties": {
+            "op": {
+              "type": "string",
+              "enum": [
+                "lt"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Scalar comparison filter (eq, neq, gt, gte, lt, lte)",
+          "type": "object",
+          "required": [
+            "op",
+            "value"
+          ],
+          "properties": {
+            "op": {
+              "type": "string",
+              "enum": [
+                "lte"
+              ]
+            },
+            "value": {
+              "description": "The value to compare. Can be a string, number, boolean, or null.",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Array-based filter (in, not_in)",
+          "type": "object",
+          "required": [
+            "op",
+            "values"
+          ],
+          "properties": {
+            "op": {
+              "type": "string",
+              "enum": [
+                "in"
+              ]
+            },
+            "values": {
+              "description": "Array of values to filter by. Each value can be a string, number, boolean, or null.",
+              "type": [
+                "array"
+              ],
+              "items": {
+                "type": [
+                  "string",
+                  "number",
+                  "boolean",
+                  "null"
+                ]
+              }
+            }
+          }
+        },
+        {
+          "description": "Array-based filter (in, not_in)",
+          "type": "object",
+          "required": [
+            "op",
+            "values"
+          ],
+          "properties": {
+            "op": {
+              "type": "string",
+              "enum": [
+                "not_in"
+              ]
+            },
+            "values": {
+              "description": "Array of values to filter by. Each value can be a string, number, boolean, or null.",
+              "type": [
+                "array"
+              ],
+              "items": {
+                "type": [
+                  "string",
+                  "number",
+                  "boolean",
+                  "null"
+                ]
+              }
+            }
+          }
+        },
+        {
+          "description": "Date range filter (in_date_range, not_in_date_range)",
+          "type": "object",
+          "required": [
+            "from",
+            "op",
+            "to"
+          ],
+          "properties": {
+            "from": {
+              "description": "Start of the date range. Can be a string (ISO date or relative like 'today', '7 days ago'), number (timestamp).",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "in_date_range"
+              ]
+            },
+            "to": {
+              "description": "End of the date range. Can be a string (ISO date or relative like 'today', '7 days ago'), number (timestamp).",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Date range filter (in_date_range, not_in_date_range)",
+          "type": "object",
+          "required": [
+            "from",
+            "op",
+            "to"
+          ],
+          "properties": {
+            "from": {
+              "description": "Start of the date range. Can be a string (ISO date or relative like 'today', '7 days ago'), number (timestamp).",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            },
+            "op": {
+              "type": "string",
+              "enum": [
+                "not_in_date_range"
+              ]
+            },
+            "to": {
+              "description": "End of the date range. Can be a string (ISO date or relative like 'today', '7 days ago'), number (timestamp).",
+              "type": [
+                "string",
+                "number",
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "SemanticQueryOrder": {
+      "type": "object",
+      "required": [
+        "direction",
+        "field"
+      ],
+      "properties": {
+        "direction": {
+          "type": "string"
+        },
+        "field": {
+          "type": "string"
+        }
+      }
+    },
+    "Task": {
+      "type": "object",
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "agent_ref",
+            "prompt",
+            "type"
+          ],
+          "properties": {
+            "agent_ref": {
+              "type": "string"
+            },
+            "consistency_prompt": {
+              "description": "Custom consistency evaluation prompt for this specific task Overrides automation-level consistency_prompt if specified",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "consistency_run": {
+              "default": 1,
+              "type": "integer",
+              "format": "uint",
+              "minimum": 0.0
+            },
+            "export": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TaskExport"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "prompt": {
+              "type": "string"
+            },
+            "retry": {
+              "default": 1,
+              "type": "integer",
+              "format": "uint",
+              "minimum": 0.0
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "agent"
+              ]
+            },
+            "variables": {
+              "type": [
+                "object",
+                "null"
+              ],
+              "additionalProperties": true
+            }
+          }
+        },
+        {
+          "type": "object",
+          "anyOf": [
+            {
+              "type": "object",
+              "required": [
+                "sql_file"
+              ],
+              "properties": {
+                "sql_file": {
+                  "type": "string"
+                }
+              }
+            },
+            {
+              "type": "object",
+              "required": [
+                "sql_query"
+              ],
+              "properties": {
+                "sql_query": {
+                  "type": "string"
+                }
+              }
+            }
+          ],
+          "required": [
+            "database",
+            "type"
+          ],
+          "properties": {
+            "database": {
+              "type": "string"
+            },
+            "dry_run_limit": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "format": "uint64",
+              "minimum": 0.0
+            },
+            "export": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TaskExport"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "execute_sql"
+              ]
+            },
+            "variables": {
+              "default": null,
+              "type": [
+                "object",
+                "null"
+              ],
+              "additionalProperties": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "dimensions": {
+              "description": "List of dimensions to include in the query. Format: <view_name>.<dimension_name>",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "export": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TaskExport"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "filters": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/SemanticFilter"
+              }
+            },
+            "limit": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "format": "uint64",
+              "minimum": 0.0
+            },
+            "measures": {
+              "description": "List of measures to include in the query. Format: <view_name>.<measure_name>",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "offset": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "format": "uint64",
+              "minimum": 0.0
+            },
+            "orders": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/SemanticQueryOrder"
+              }
+            },
+            "time_dimensions": {
+              "description": "List of time dimensions with granularity and date range. Can only use with dimensions of type time or datetime. Format: <view_name>.<dimension_name>",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/TimeDimension"
+              }
+            },
+            "topic": {
+              "default": null,
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "semantic_query"
+              ]
+            },
+            "variables": {
+              "description": "Variables to resolve in semantic model expressions. Use {{variables.variable_name}} syntax in semantic definitions.",
+              "type": [
+                "object",
+                "null"
+              ],
+              "additionalProperties": true
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "fields",
+            "integration",
+            "topic",
+            "type"
+          ],
+          "properties": {
+            "export": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TaskExport"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "fields": {
+              "description": "Fields to select. Field name must be full name format {view}.{field_name}. No aggregation or any other syntax.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "integration": {
+              "type": "string"
+            },
+            "limit": {
+              "description": "Maximum number of rows to return.",
+              "type": [
+                "integer",
+                "null"
+              ],
+              "format": "uint64",
+              "minimum": 0.0
+            },
+            "sorts": {
+              "description": "Fields to sort by with direction (asc/desc).",
+              "type": [
+                "object",
+                "null"
+              ],
+              "additionalProperties": {
+                "$ref": "#/definitions/OrderType"
+              }
+            },
+            "topic": {
+              "type": "string"
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "omni_query"
+              ]
+            }
+          }
+        },
+        {
+          "description": "Task configuration for executing a Looker query within an automation.",
+          "type": "object",
+          "required": [
+            "explore",
+            "fields",
+            "integration",
+            "model",
+            "type"
+          ],
+          "properties": {
+            "explore": {
+              "description": "The explore name within the model",
+              "type": "string"
+            },
+            "export": {
+              "description": "Optional export configuration for query results",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TaskExport"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "fields": {
+              "description": "Fields to select. Field name must be full name format {view}.{field_name}.",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "filter_expression": {
+              "description": "Looker filter expression for complex conditions.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "filters": {
+              "description": "Filter conditions as field name to Looker filter expression mappings.",
+              "type": [
+                "object",
+                "null"
+              ],
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "integration": {
+              "description": "Name of the Looker integration to use",
+              "type": "string"
+            },
+            "limit": {
+              "description": "Maximum number of rows to return.",
+              "type": [
+                "integer",
+                "null"
+              ],
+              "format": "int64"
+            },
+            "model": {
+              "description": "The LookML model name",
+              "type": "string"
+            },
+            "sorts": {
+              "description": "Fields to sort by using Looker syntax: 'view.field asc' or 'view.field desc'.",
+              "type": [
+                "array",
+                "null"
+              ],
+              "items": {
+                "$ref": "#/definitions/LookerSortField"
+              }
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "looker_query"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "tasks",
+            "type",
+            "values"
+          ],
+          "properties": {
+            "concurrency": {
+              "default": 1,
+              "type": "integer",
+              "format": "uint",
+              "minimum": 0.0
+            },
+            "tasks": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Task"
+              }
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "loop_sequential"
+              ]
+            },
+            "values": {
+              "$ref": "#/definitions/LoopValues"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "template",
+            "type"
+          ],
+          "properties": {
+            "export": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TaskExport"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "template": {
+              "type": "string"
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "formatter"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "src",
+            "type"
+          ],
+          "properties": {
+            "export": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/TaskExport"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "src": {
+              "type": "string"
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "workflow"
+              ]
+            },
+            "variables": {
+              "type": [
+                "object",
+                "null"
+              ],
+              "additionalProperties": true
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "conditions",
+            "type"
+          ],
+          "properties": {
+            "conditions": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Condition"
+              }
+            },
+            "else": {
+              "default": null,
+              "type": [
+                "array",
+                "null"
+              ],
+              "items": {
+                "$ref": "#/definitions/Task"
+              }
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "conditional"
+              ]
+            }
+          }
+        },
+        {
+          "description": "`type: http_request` — make an outbound HTTP request from a workflow.\n\nThe reusable primitive behind the QuickBooks JE-posting automation (and the stop-gap for Oxy Functions' `ctx.fetch`). Templated fields render against the prior-step render context; `{{ secrets.NAME }}` resolves declared `secrets`. Egress is constrained (private/loopback/link-local hosts are always denied; `allow_hosts`, when set, is an additional allowlist).",
+          "type": "object",
+          "required": [
+            "type",
+            "url"
+          ],
+          "properties": {
+            "allow_hosts": {
+              "description": "Allowed target hostnames (in addition to the always-on private-IP deny). Empty means \"any public host\"; set it to lock a task to specific APIs.",
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "body": {
+              "description": "Raw request body (Jinja-templated). Mutually exclusive with `form`.",
+              "default": null,
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "expected_status": {
+              "description": "Accepted HTTP status codes. Empty → any 2xx is accepted; anything else fails the task.",
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "integer",
+                "format": "uint16",
+                "minimum": 0.0
+              }
+            },
+            "form": {
+              "description": "Form fields serialized as `application/x-www-form-urlencoded` (values templated).",
+              "default": null,
+              "type": [
+                "object",
+                "null"
+              ],
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "headers": {
+              "description": "Request headers; values are Jinja-templated and may reference `{{ secrets.X }}`.",
+              "default": {},
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "method": {
+              "description": "HTTP method (GET/POST/PUT/PATCH/DELETE). Defaults to POST.",
+              "default": "POST",
+              "type": "string"
+            },
+            "persist_to_secret": {
+              "description": "Optionally write a field of the JSON response back into a project secret.",
+              "default": null,
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/PersistToSecret"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "secrets": {
+              "description": "Project secret names to resolve into the `{{ secrets.NAME }}` template scope.",
+              "default": [],
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "timeout_secs": {
+              "description": "Request timeout in seconds (1–120). Defaults to 30.",
+              "default": 30,
+              "type": "integer",
+              "format": "uint64",
+              "minimum": 0.0
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "http_request"
+              ]
+            },
+            "url": {
+              "description": "Request URL (Jinja-templated).",
+              "type": "string"
+            }
+          }
+        },
+        {
+          "description": "Run an airway ELT pipeline as an automation step.\n\nUnlike the other I/O task types this is **not** executed by `step_executor` — it is delegated as a `TaskSpec::Airway`, reusing the existing airway run path (secret resolution, Airhouse credential minting, backfill windowing, run-scoped state). See `StepKind::Airway`.\n\nA step completes only once the pipeline's end-of-load fold has committed, so a following `execute_sql` step reads a queryable table rather than a half-folded one.",
+          "type": "object",
+          "required": [
+            "pipeline",
+            "type"
+          ],
+          "properties": {
+            "pipeline": {
+              "description": "Workspace-relative path to the `.airway.yml` pipeline spec.",
+              "type": "string"
+            },
+            "resources": {
+              "description": "Explicit subset of the spec's resources (tables) to run. Omitted or empty runs the whole pipeline.",
+              "default": null,
+              "type": [
+                "array",
+                "null"
+              ],
+              "items": {
+                "type": "string"
+              }
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "airway"
+              ]
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "Unknown"
+              ]
+            }
+          }
+        }
+      ],
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "cache": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TaskCache"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "mode": {
+          "description": "Execution mode when this task is used inside a data app. Defaults to `client`.",
+          "default": "client",
+          "allOf": [
+            {
+              "$ref": "#/definitions/AppTaskMode"
+            }
+          ]
+        },
+        "name": {
+          "description": "Unique name for the task within the workflow. Format: alphanumeric and underscores only, starting with a letter.",
+          "type": "string"
+        }
+      }
+    },
+    "TaskCache": {
+      "type": "object",
+      "required": [
+        "path"
+      ],
+      "properties": {
+        "enabled": {
+          "default": false,
+          "type": "boolean"
+        },
+        "path": {
+          "type": "string"
+        }
+      }
+    },
+    "TaskExport": {
+      "type": "object",
+      "required": [
+        "format",
+        "path"
+      ],
+      "properties": {
+        "format": {
+          "$ref": "#/definitions/ExportFormat"
+        },
+        "path": {
+          "type": "string"
+        }
+      }
+    },
+    "TimeDimension": {
+      "description": "Time dimension for temporal queries with granularity and date range",
+      "type": "object",
+      "required": [
+        "dimension"
+      ],
+      "properties": {
+        "dimension": {
+          "description": "Dimension name in format: <view_name>.<dimension_name>",
+          "type": "string"
+        },
+        "granularity": {
+          "description": "Time granularity for grouping (year, month, day, etc.)",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/TimeGranularity"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "TimeGranularity": {
+      "description": "Time granularity options for time dimension queries",
+      "type": "string",
+      "enum": [
+        "year",
+        "quarter",
+        "month",
+        "week",
+        "day",
+        "hour",
+        "minute",
+        "second"
+      ]
+    }
+  }
+}