Workflow

IntroductionLinked dataHuman and agentComponents

Decisions and work / clio.workflow.v1

Trace a multi-step process as connected nodes and edges.

Live exampleHow it worksSkill

When to use it

Trace a multi-step process as connected nodes and edges.

What the agent supplies

A step/edge graph showing a multi-step plan's progress.

The agent chooses the content and binds it to the component. CLIO then renders the view and its available controls.

What the agent receives

The exact output of load_skill, including resolved local definitions.

load_skill("a2ui-catalog-clio-workspace", file="catalog.json#/components/clio.workflow.v1")

{
  "allOf": [
    {
      "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
    },
    {
      "properties": {
        "weight": {
          "description": "Relative flex weight of this component inside a Row or Column. Only meaningful as a direct child of one.",
          "type": "number"
        }
      },
      "type": "object"
    },
    {
      "properties": {
        "action": {
          "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Action"
        },
        "component": {
          "const": "clio.workflow.v1"
        },
        "dataUri": {
          "description": "A workspace file path or artifact:// reference; CLIO registers a path as an artifact before validation. A JSON file shaped {\"nodes\": [...], \"edges\": [...]}.",
          "not": {
            "pattern": "\\s"
          },
          "pattern": "^artifact://artifact_[A-Za-z0-9_-]+$",
          "type": "string"
        },
        "edges": {
          "description": "Inline edges (at most 256), alongside nodes.",
          "items": {
            "additionalProperties": false,
            "properties": {
              "label": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "target": {
                "type": "string"
              }
            },
            "required": [
              "source",
              "target"
            ],
            "type": "object"
          },
          "maxItems": 256,
          "type": "array"
        },
        "nodes": {
          "description": "Inline nodes (at most 128) \u2014 rides the surface's own wire message; give edges too, or use dataUri instead of both for a larger graph, unbounded.",
          "items": {
            "additionalProperties": false,
            "properties": {
              "detail": {
                "type": "string"
              },
              "id": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "state": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "label"
            ],
            "type": "object"
          },
          "maxItems": 128,
          "minItems": 1,
          "type": "array"
        },
        "selected": {
          "type": "string"
        }
      },
      "required": [
        "component"
      ],
      "type": "object"
    },
    {
      "description": "Exactly one of nodes+edges or dataUri is required.",
      "oneOf": [
        {
          "not": {
            "required": [
              "dataUri"
            ]
          },
          "required": [
            "nodes",
            "edges"
          ]
        },
        {
          "not": {
            "anyOf": [
              {
                "required": [
                  "nodes"
                ]
              },
              {
                "required": [
                  "edges"
                ]
              }
            ]
          },
          "required": [
            "dataUri"
          ]
        }
      ]
    }
  ],
  "description": "A step/edge graph showing a multi-step plan's progress.",
  "type": "object",
  "unevaluatedProperties": false
}

Standard refs (not loadable here): https://a2ui.org/specification/v0_9/common_types.json#/$defs/Action, https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon