Diff

IntroductionLinked dataHuman and agentComponents

Information / clio.diff.v1

Show what changed between two versions of text or code.

Live exampleHow it worksSkill

When to use it

Show what changed between two versions of text or code.

What the agent supplies

A unified diff for one path, inline or from a referenced file.

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.diff.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.diff.v1"
        },
        "dataUri": {
          "description": "A workspace file path or artifact:// reference; CLIO registers a path as an artifact before validation. Its file content is the diff text.",
          "not": {
            "pattern": "\\s"
          },
          "pattern": "^artifact://artifact_[A-Za-z0-9_-]+$",
          "type": "string"
        },
        "diff": {
          "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
          "description": "Inline unified diff text; use dataUri instead for a referenced file."
        },
        "path": {
          "type": "string"
        },
        "status": {
          "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
        }
      },
      "required": [
        "component",
        "path"
      ],
      "type": "object"
    },
    {
      "description": "Exactly one of diff or dataUri is required.",
      "oneOf": [
        {
          "not": {
            "required": [
              "dataUri"
            ]
          },
          "required": [
            "diff"
          ]
        },
        {
          "not": {
            "required": [
              "diff"
            ]
          },
          "required": [
            "dataUri"
          ]
        }
      ]
    }
  ],
  "description": "A unified diff for one path, inline or from a referenced file.",
  "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, https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString