Automation file format

Workflow files live under .konvio/automations/ and use YAML (preferred) or JSON.

Top-level fields

Field	Required	Description
`name`	yes	Display name
`description`	no	Short summary
`enabled`	no	Defaults to `true`
`on` / `trigger`	yes	Event type(s), shortcuts, or object with filters
`steps`	yes	Ordered list of steps

Triggers

Shortcuts expand to Konvio event ids:

Shortcut	Event
`manual`	`automation.manual`
`workflow_run`	`github.workflow_run.completed`
`pipeline` / `pipeline_completed`	`gitlab.pipeline.completed`
`push`	`github.push`
`pull_request`	GitHub PR opened + synchronize
`issues`	`github.issue.created`
`work_item`	Projects work item created / status changed

You can also set the full event id (for example github.workflow_run.completed).

Filters and manual inputs

on:
  workflow_run:
    conclusion: [failure]
    branches: [main]
    workflows: [CI]

on:
  manual:
    inputs:
      environment:
        type: choice
        options: [staging, production]
        default: staging
        description: Target environment

Steps

Supported type values:

check — expression gate; optional then / else
agent — run an application agent with a prompt
commands — shell commands in a sandbox
notify — in-app notification

Each step may include an id for {{steps.<id>.*}} variables.

Minimal example

name: Smoke check
enabled: true
on:
  manual:
    inputs: {}
steps:
  - id: notify
    type: notify
    title: Smoke check
    body: Managed automation source is ready.