Choice Picker

IntroductionLinked dataHuman and agentComponents

Controls / ChoicePicker

Choose one option from a defined set.

Live exampleHow it worksSkill

When to use it

Choose one option from a defined set.

What the agent supplies

A single- or multiple-selection picker; bind value to the path an action reads.

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-basic", file="catalog.json#/components/ChoicePicker")

{
  "type": "object",
  "allOf": [
    {
      "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/ComponentCommon"
    },
    {
      "type": "object",
      "properties": {
        "weight": {
          "type": "number",
          "description": "The relative weight of this component within a Row or Column. This is similar to the CSS 'flex-grow' property. Note: this may ONLY be set when the component is a direct descendant of a Row or Column."
        }
      }
    },
    {
      "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/Checkable"
    },
    {
      "type": "object",
      "description": "A component that allows selecting one or more options from a list.",
      "properties": {
        "component": {
          "const": "ChoicePicker"
        },
        "label": {
          "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString",
          "description": "The label for the group of options."
        },
        "variant": {
          "type": "string",
          "description": "A hint for how the choice picker should be displayed and behave.",
          "enum": [
            "multipleSelection",
            "mutuallyExclusive"
          ],
          "default": "mutuallyExclusive"
        },
        "options": {
          "type": "array",
          "description": "The list of available options to choose from.",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "description": "The text to display for this option.",
                "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicString"
              },
              "value": {
                "type": "string",
                "description": "The stable value associated with this option."
              }
            },
            "required": [
              "label",
              "value"
            ],
            "additionalProperties": false
          }
        },
        "value": {
          "$ref": "https://a2ui.org/specification/v0_9/common_types.json#/$defs/DynamicStringList",
          "description": "The list of currently selected values. This should be bound to a string array in the data model."
        },
        "displayStyle": {
          "type": "string",
          "description": "The display style of the component.",
          "enum": [
            "checkbox",
            "chips"
          ],
          "default": "checkbox"
        },
        "filterable": {
          "type": "boolean",
          "description": "If true, displays a search input to filter the options.",
          "default": false
        }
      },
      "required": [
        "component",
        "options",
        "value"
      ]
    }
  ],
  "unevaluatedProperties": false
}

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