a2ui-core 0.2.0__tar.gz → 0.3.0__tar.gz

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/.gitignore

@@ -15,6 +15,9 @@ site/
 .venv/
 coverage/
 
+# Older a2ui-agent-sdk builds copied specification JSON into these directories.
+# Nothing writes there anymore, but older checkouts can still have the files;
+# these rules keep them out of commits and locally built wheels.
 ## old agent SDK path
 a2a_agents/python/a2ui_agent/src/a2ui/assets/**/*.json
 agent_sdks/python/src/a2ui/assets/**/*.json

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/CHANGELOG.md

@@ -1,5 +1,75 @@
 ## Unreleased
 
+- `inline_local_refs` is exported from `a2ui.core`. It writes a schema's local
+  `#/` references inline, keeping references to common types, as
+  `Catalog.from_json` does
+  ([#2966](https://github.com/a2ui-project/a2ui/pull/2966)).
+- (v1_0) The basic catalog's `and`, `or` and `not` read a ValidationResult
+  operand by its `valid` member instead of treating every non-empty dict as
+  truthy, so the v1.0 specification's nested
+  `and(required, or(required, required))` check is false when a field is
+  empty. The v0.9 catalog keeps plain truthiness, since its validators return
+  booleans.
+- **BREAKING**: `DataContext` validates a function call's arguments as
+  written, before resolving the bindings and nested calls in them, and passes
+  the resolved values to the function body without validating them again.
+  The catalog's argument schema describes the written shape (a
+  `DynamicBoolean` admits a `{"@call": ...}`), so validating the resolved
+  values rejected, for example, the ValidationResult a v1.0 validator returns
+  to `and`, `or` or `not`. This matches web_core. Accordingly,
+  `FunctionImplementation.execute` no longer validates its arguments; callers
+  that invoke it directly validate the written arguments first, with
+  `PayloadValidator.validate_function` or the function's schema model.
+- **BREAKING**: `ComponentModel.component_tree` names the component under
+  `component`, as an `updateComponents` message does, instead of `type`. A
+  property named `type` no longer replaces the component type in the tree,
+  and is kept. `ComponentModel.validate` validates that same dict, so a
+  property named `component` or `id` no longer replaces the model's own
+  during validation ([#2930](https://github.com/a2ui-project/a2ui/pull/2930)).
+- The path syntax and function call depth checks in
+  `validate_recursion_and_paths` also read v1.0's `@path` and `@call`. A v1.0
+  payload with a malformed `@path`, or with `@call` expressions nested deeper
+  than the limit, used to pass validation
+  ([#3013](https://github.com/a2ui-project/a2ui/pull/3013)).
+- JSON Schema patterns are validated with `regex` (`SchemaValidator` in
+  `a2ui.core.validation`), supporting Unicode property escapes such as
+  `\p{XID_Start}` and `\p{XID_Continue}` natively and anchoring `$` to the end
+  of the string per ECMA-262. `clean_schema_node` leaves `const`, `enum`,
+  `default`, and `examples` values untouched.
+- `PayloadValidator` reports invalid `Extensions` keys even with
+  `allow_unknown_elements`.
+- Catalog schemas reference `DynamicStringList` for string list values, as the
+  basic catalog does, instead of `DynamicValue`.
+- Patch and pre-release protocol versions use the common types of their release
+  line (`1.0.0-rc.1` uses v1.0). Unparsable versions raise `A2uiCatalogError`
+  when a catalog schema is built.
+- `GenericBinder` binds `$ref`s to catalog-defined dynamic defs (for example
+  `DynamicDate`).
+- Add `CatalogApi`, the name for a schema-only `Catalog[ComponentApi, FunctionApi]`, exported from `a2ui.core`. `Catalog.from_json` returns it.
+- Execute `functionCall` and `call` component actions locally in `GenericBinder` and prevent `SurfaceModel.dispatch_action` from emitting them as agent-facing `on_action` events.
+- `ExpressionParser` accepts number literals with a leading decimal point
+  (`.5`, `-.5`, `+.5`, `.5e2`), including as function-call arguments. `.foo`
+  and `./x` are still paths.
+- `ExpressionParser` raises `A2uiExpressionError` for a number literal outside
+  the double range, such as `1e999` or a 400-digit integer. It used to return
+  `inf` for float literals and an exact `int` for integer literals. Integer
+  literals longer than 4,300 digits no longer raise a bare `ValueError`.
+- **BREAKING**: Optional JSON Schema `default` annotations in generated v0.9
+  and v1.0 Pydantic models are kept in field descriptions instead of becoming
+  field values. `const` values remain fixed.
+- **BREAKING**: `BasicCatalog` from `a2ui.core.basic_catalog` is a factory that
+  returns the basic catalog of a protocol version, for example
+  `BasicCatalog("0.9")`. The package no longer re-exports the v0.9 basic
+  catalog's symbols; import them from `a2ui.core.basic_catalog.v0_9`.
+- The v0.8 basic catalog's `catalog_id` is the v0.8 standard catalog ID,
+  `https://a2ui.org/specification/v0_8/standard_catalog_definition.json`.
+- **BREAKING**: `PayloadValidator`, `SurfaceModel`, `SurfaceGroupModel`,
+  `DataContext`, and `RpcHandler` are no longer generic. They take `CatalogApi`
+  catalogs, so remove type arguments such as
+  `SurfaceModel[MyComponent, MyFunction]`.
+
+## 0.2.0 (2026-09-28)
+
 - **BREAKING**: Module paths and validation interfaces moved or changed in v0.2.0. Deprecation shims are provided for renamed public module paths; importing them emits a `DeprecationWarning` naming the new path. These shims will be removed in `v0.3.0`.
 
   **Shimmed Modules (Deprecated; removal in v0.3.0):**
@@ -144,6 +214,10 @@
   suite cannot be parsed, when a case has no `name` or `action`, or when an
   action has no handler. Suites the core library cannot run are named in
   `UNRUNNABLE_SUITES` with a reason.
+- Move `@index` (`IndexApi`, `IndexArgs`, `IndexImplementation`) from
+  `a2ui.core.basic_catalog.v1_0` (`v1_0/operator_apis.py` removed) to
+  `a2ui.core.catalog`, where `system_functions_for` supplies it to v1.0 and
+  later catalogs.
 
 ## 0.1.1
 

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: a2ui-core
-Version: 0.2.0
+Version: 0.3.0
 Summary: A2UI Python SDK - Core Library
 Requires-Python: >=3.10
 Requires-Dist: babel>=2.14.0
 Requires-Dist: jsonschema>=4.26.0
 Requires-Dist: pydantic>=2.10.0
 Requires-Dist: referencing>=0.37.0
+Requires-Dist: regex>=2024.11.6
 Description-Content-Type: text/markdown
 
 # A2UI Core Library (`a2ui_core`)

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/pyproject.toml

@@ -19,10 +19,11 @@ description = "A2UI Python SDK - Core Library"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
+    "babel>=2.14.0",
     "jsonschema>=4.26.0",
     "pydantic>=2.10.0",
     "referencing>=0.37.0",
-    "babel>=2.14.0",
+    "regex>=2024.11.6",
 ]
 
 [dependency-groups]

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/src/a2ui/core/__init__.py

@@ -14,6 +14,12 @@
 
 from a2ui.core.catalog import (
     Catalog as Catalog,
+    CatalogApi as CatalogApi,
+    get_agent_to_renderer_schema_json as get_agent_to_renderer_schema_json,
+    get_agent_to_renderer_schema_map as get_agent_to_renderer_schema_map,
+    get_common_types_schema_json as get_common_types_schema_json,
+    get_common_types_schema_map as get_common_types_schema_map,
+    inline_local_refs as inline_local_refs,
     is_valid_uax31_identifier as is_valid_uax31_identifier,
 )
 from a2ui.core.exceptions import (
@@ -36,8 +42,13 @@ from a2ui.core.processing import (
     MessageProcessor as MessageProcessor,
     MessageProcessorOptions as MessageProcessorOptions,
 )
+from a2ui.core.resolution import DataContext as DataContext
 from a2ui.core.rpc import CallOptions as CallOptions, RpcHandler as RpcHandler
-from a2ui.core.state import DataModel as DataModel, SurfaceModel as SurfaceModel
+from a2ui.core.state import (
+    ComponentModel as ComponentModel,
+    DataModel as DataModel,
+    SurfaceModel as SurfaceModel,
+)
 from a2ui.core.validation import (
     PayloadValidator as PayloadValidator,
     RELAXED_VALIDATION as RELAXED_VALIDATION,
@@ -61,6 +72,9 @@ __all__ = [
     "CallOptions",
     "CapabilitiesOptions",
     "Catalog",
+    "CatalogApi",
+    "ComponentModel",
+    "DataContext",
     "DataModel",
     "ExecutionContext",
     "MessageProcessor",
@@ -73,5 +87,10 @@ __all__ = [
     "SurfaceModel",
     "ValidationConfig",
     "__version__",
+    "get_agent_to_renderer_schema_json",
+    "get_agent_to_renderer_schema_map",
+    "get_common_types_schema_json",
+    "get_common_types_schema_map",
+    "inline_local_refs",
     "is_valid_uax31_identifier",
 ]

a2ui_core-0.3.0/src/a2ui/core/basic_catalog/__init__.py

@@ -0,0 +1,67 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""A2UI Basic Catalog Module."""
+
+from __future__ import annotations
+
+from a2ui.core.catalog import CatalogApi
+from a2ui.core.common import to_protocol_version
+from a2ui.core.exceptions import A2uiError
+from a2ui.core.schema import ProtocolVersion
+
+from . import v0_8, v0_9, v1_0
+
+
+def BasicCatalog(
+    protocol_version: ProtocolVersion | str,
+    locale: str | None = None,
+) -> CatalogApi:
+    """Returns the basic catalog instance for the specified protocol version.
+
+    Args:
+        protocol_version: The protocol version (e.g. ProtocolVersion.V0_9,
+            ProtocolVersion.V1_0, 'v0.9', '0.9', '1.0').
+        locale: Optional locale string for function implementations.
+
+    Returns:
+        The versioned BasicCatalog instance.
+
+    Raises:
+        A2uiError: If the protocol version is not supported.
+    """
+    try:
+        p_ver = to_protocol_version(protocol_version)
+    except (ValueError, A2uiError) as e:
+        raise A2uiError(
+            f"Unsupported protocol version for BasicCatalog: '{protocol_version}'."
+        ) from e
+
+    if p_ver == ProtocolVersion.V0_8:
+        return v0_8.BasicCatalog(locale=locale)
+    if p_ver in (ProtocolVersion.V0_9, ProtocolVersion.V0_9_1):
+        return v0_9.BasicCatalog(locale=locale)
+    if p_ver == ProtocolVersion.V1_0:
+        return v1_0.BasicCatalog(locale=locale)
+    raise A2uiError(
+        f"Unsupported protocol version for BasicCatalog: '{protocol_version}'."
+    )
+
+
+__all__ = [
+    "BasicCatalog",
+    "v0_8",
+    "v0_9",
+    "v1_0",
+]

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/src/a2ui/core/basic_catalog/v0_8/__init__.py

@@ -76,6 +76,8 @@ from ...catalog import Catalog, ModelComponentApi, FunctionImplementation
 
 
 def _basic_catalog_id(protocol_version: str) -> str:
+    if protocol_version == "v0.8":
+        return f"{PROTOCOL_BASE_URL}/v0_8/standard_catalog_definition.json"
     return (
         f"{PROTOCOL_BASE_URL}/{protocol_version.replace('.', '_')}/catalogs/basic/catalog.json"
     )

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/src/a2ui/core/basic_catalog/v0_8/components.py

@@ -30,6 +30,7 @@ from ...schema.common_types import (
     FunctionCall,
     ListReference,
     SingleReference,
+    SpecBaseModel,
     StrictBaseModel,
     TemplateChildList,
 )
@@ -40,24 +41,24 @@ class TextItem(StrictBaseModel):
     """The value of the text field. This can be a literal string or a reference to a value in the data model ('path', e.g. '/user/name')."""
 
     model_config = ConfigDict(populate_by_name=True)
-    literal_string: str | None = Field(None, alias="literalString")
-    path: str | None = Field(None)
+    literal_string: str | None = Field(default=None, alias="literalString")
+    path: str | None = Field(default=None)
 
 
 class UrlItem(StrictBaseModel):
     """The URL of the audio to be played. This can be a literal string ('literal') or a reference to a value in the data model ('path', e.g. '/song/url')."""
 
     model_config = ConfigDict(populate_by_name=True)
-    literal_string: str | None = Field(None, alias="literalString")
-    path: str | None = Field(None)
+    literal_string: str | None = Field(default=None, alias="literalString")
+    path: str | None = Field(default=None)
 
 
 class AltTextItem(StrictBaseModel):
     """The alt text for the image. This can be a literal string ('literal') or a reference to a value in the data model ('path', e.g. '/thumbnail/altText')."""
 
     model_config = ConfigDict(populate_by_name=True)
-    literal_string: str | None = Field(None, alias="literalString")
-    path: str | None = Field(None)
+    literal_string: str | None = Field(default=None, alias="literalString")
+    path: str | None = Field(default=None)
 
 
 class NameItem(StrictBaseModel):
@@ -116,25 +117,25 @@ class NameItem(StrictBaseModel):
             "warning",
         ]
         | None
-    ) = Field(None, alias="literalString")
-    path: str | None = Field(None)
+    ) = Field(default=None, alias="literalString")
+    path: str | None = Field(default=None)
 
 
 class DescriptionItem(StrictBaseModel):
     """A description of the audio, such as a title or summary. This can be a literal string or a reference to a value in the data model ('path', e.g. '/song/title')."""
 
     model_config = ConfigDict(populate_by_name=True)
-    literal_string: str | None = Field(None, alias="literalString")
-    path: str | None = Field(None)
+    literal_string: str | None = Field(default=None, alias="literalString")
+    path: str | None = Field(default=None)
 
 
 class ChildrenItem(StrictBaseModel):
     """Defines the children. Use 'explicitList' for a fixed set of children, or 'template' to generate children from a data list."""
 
     model_config = ConfigDict(populate_by_name=True)
-    explicit_list: list[str] | None = Field(None, alias="explicitList")
+    explicit_list: list[str] | None = Field(default=None, alias="explicitList")
     template: TemplateItem | None = Field(
-        None,
+        default=None,
         description=(
             "A template for generating a dynamic list of children from a data model"
             " list. `componentId` is the component to use as a template, and"
@@ -161,31 +162,31 @@ class ActionItem(StrictBaseModel):
 
     model_config = ConfigDict(populate_by_name=True)
     name: str = Field(...)
-    context: list[ContextItem] | None = Field(None)
+    context: list[ContextItem] | None = Field(default=None)
 
 
 class LabelItem(StrictBaseModel):
     """The label for the slider. This can be a literal string or a reference to a value in the data model ('path')."""
 
     model_config = ConfigDict(populate_by_name=True)
-    literal_string: str | None = Field(None, alias="literalString")
-    path: str | None = Field(None)
+    literal_string: str | None = Field(default=None, alias="literalString")
+    path: str | None = Field(default=None)
 
 
 class ValueItem(StrictBaseModel):
     """The current value of the slider. This can be a literal number ('literalNumber') or a reference to a value in the data model ('path', e.g. '/restaurant/cost')."""
 
     model_config = ConfigDict(populate_by_name=True)
-    literal_number: float | None = Field(None, alias="literalNumber")
-    path: str | None = Field(None)
+    literal_number: float | None = Field(default=None, alias="literalNumber")
+    path: str | None = Field(default=None)
 
 
 class SelectionItem(StrictBaseModel):
     """The currently selected values for the component. This can be a literal array of strings or a path to an array in the data model('path', e.g. '/hotel/options')."""
 
     model_config = ConfigDict(populate_by_name=True)
-    literal_array: list[str] | None = Field(None, alias="literalArray")
-    path: str | None = Field(None)
+    literal_array: list[str] | None = Field(default=None, alias="literalArray")
+    path: str | None = Field(default=None)
 
 
 class OptionItem(StrictBaseModel):
@@ -214,8 +215,8 @@ class TitleItem(StrictBaseModel):
     """The tab title. Defines the value as either a literal value or a path to data model value (e.g. '/options/title')."""
 
     model_config = ConfigDict(populate_by_name=True)
-    literal_string: str | None = Field(None, alias="literalString")
-    path: str | None = Field(None)
+    literal_string: str | None = Field(default=None, alias="literalString")
+    path: str | None = Field(default=None)
 
 
 class ContextItem(StrictBaseModel):
@@ -243,7 +244,7 @@ class TextComponent(ComponentCommon):
         ),
     )
     usage_hint: Literal["h1", "h2", "h3", "h4", "h5", "caption", "body"] | None = Field(
-        None,
+        default=None,
         alias="usageHint",
         description=(
             "A hint for the base text style. One of: - `h1`: Largest heading. - `h2`:"
@@ -265,7 +266,7 @@ class ImageComponent(ComponentCommon):
         ),
     )
     alt_text: AltTextItem | None = Field(
-        None,
+        default=None,
         alias="altText",
         description=(
             "The alt text for the image. This can be a literal string ('literal') or a"
@@ -274,7 +275,7 @@ class ImageComponent(ComponentCommon):
         ),
     )
     fit: Literal["contain", "cover", "fill", "none", "scale-down"] | None = Field(
-        None,
+        default=None,
         description=(
             "Specifies how the image should be resized to fit its container. This"
             " corresponds to the CSS 'object-fit' property."
@@ -286,7 +287,7 @@ class ImageComponent(ComponentCommon):
         ]
         | None
     ) = Field(
-        None,
+        default=None,
         alias="usageHint",
         description=(
             "A hint for the image size and style. One of: - `icon`: Small square icon."
@@ -330,7 +331,7 @@ class AudioPlayerComponent(ComponentCommon):
         ),
     )
     description: DescriptionItem | None = Field(
-        None,
+        default=None,
         description=(
             "A description of the audio, such as a title or summary. This can be a"
             " literal string or a reference to a value in the data model ('path', e.g."
@@ -352,14 +353,14 @@ class RowComponent(ComponentCommon):
         Literal["center", "end", "spaceAround", "spaceBetween", "spaceEvenly", "start"]
         | None
     ) = Field(
-        None,
+        default=None,
         description=(
             "Defines the arrangement of children along the main axis (horizontally)."
             " This corresponds to the CSS 'justify-content' property."
         ),
     )
     alignment: Literal["start", "center", "end", "stretch"] | None = Field(
-        None,
+        default=None,
         description=(
             "Defines the alignment of children along the cross axis (vertically). This"
             " corresponds to the CSS 'align-items' property."
@@ -380,14 +381,14 @@ class ColumnComponent(ComponentCommon):
         Literal["start", "center", "end", "spaceBetween", "spaceAround", "spaceEvenly"]
         | None
     ) = Field(
-        None,
+        default=None,
         description=(
             "Defines the arrangement of children along the main axis (vertically). This"
             " corresponds to the CSS 'justify-content' property."
         ),
     )
     alignment: Literal["center", "end", "start", "stretch"] | None = Field(
-        None,
+        default=None,
         description=(
             "Defines the alignment of children along the cross axis (horizontally)."
             " This corresponds to the CSS 'align-items' property."
@@ -405,10 +406,11 @@ class ListComponent(ComponentCommon):
         ),
     )
     direction: Literal["vertical", "horizontal"] | None = Field(
-        None, description="The direction in which the list items are laid out."
+        default=None, description="The direction in which the list items are laid out."
     )
     alignment: Literal["start", "center", "end", "stretch"] | None = Field(
-        None, description="Defines the alignment of children along the cross axis."
+        default=None,
+        description="Defines the alignment of children along the cross axis.",
     )
 
 
@@ -434,7 +436,7 @@ class TabsComponent(ComponentCommon):
 class DividerComponent(ComponentCommon):
     component: Literal["Divider"] = "Divider"
     axis: Literal["horizontal", "vertical"] | None = Field(
-        None, description="The orientation of the divider."
+        default=None, description="The orientation of the divider."
     )
 
 
@@ -465,7 +467,7 @@ class ButtonComponent(ComponentCommon):
         ),
     )
     primary: bool | None = Field(
-        None,
+        default=None,
         description="Indicates if this button should be styled as the primary action.",
     )
     action: ActionItem = Field(
@@ -506,7 +508,7 @@ class TextFieldComponent(ComponentCommon):
         ),
     )
     text: TextItem | None = Field(
-        None,
+        default=None,
         description=(
             "The value of the text field. This can be a literal string or a reference"
             " to a value in the data model ('path', e.g. '/user/name')."
@@ -515,10 +517,12 @@ class TextFieldComponent(ComponentCommon):
     text_field_type: (
         Literal["date", "longText", "number", "shortText", "obscured"] | None
     ) = Field(
-        None, alias="textFieldType", description="The type of input field to display."
+        default=None,
+        alias="textFieldType",
+        description="The type of input field to display.",
     )
     validation_regexp: str | None = Field(
-        None,
+        default=None,
         alias="validationRegexp",
         description=(
             "A regular expression used for client-side validation of the input."
@@ -537,12 +541,12 @@ class DateTimeInputComponent(ComponentCommon):
         ),
     )
     enable_date: bool | None = Field(
-        None,
+        default=None,
         alias="enableDate",
         description="If true, allows the user to select a date.",
     )
     enable_time: bool | None = Field(
-        None,
+        default=None,
         alias="enableTime",
         description="If true, allows the user to select a time.",
     )
@@ -562,22 +566,23 @@ class MultipleChoiceComponent(ComponentCommon):
         ..., description="An array of available options for the user to choose from."
     )
     max_allowed_selections: int | None = Field(
-        None,
+        default=None,
         alias="maxAllowedSelections",
         description="The maximum number of options that the user is allowed to select.",
     )
     variant: Literal["checkbox", "chips"] | None = Field(
-        None, description="The display style of the component."
+        default=None, description="The display style of the component."
     )
     filterable: bool | None = Field(
-        None, description="If true, displays a search input to filter the options."
+        default=None,
+        description="If true, displays a search input to filter the options.",
     )
 
 
 class SliderComponent(ComponentCommon):
     component: Literal["Slider"] = "Slider"
     label: LabelItem | None = Field(
-        None,
+        default=None,
         description=(
             "The label for the slider. This can be a literal string or a reference to a"
             " value in the data model ('path')."
@@ -592,10 +597,10 @@ class SliderComponent(ComponentCommon):
         ),
     )
     min_value: float | None = Field(
-        None, alias="minValue", description="The minimum value of the slider."
+        default=None, alias="minValue", description="The minimum value of the slider."
     )
     max_value: float | None = Field(
-        None, alias="maxValue", description="The maximum value of the slider."
+        default=None, alias="maxValue", description="The maximum value of the slider."
     )
 
 

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/src/a2ui/core/basic_catalog/v0_8/styles.py

@@ -21,9 +21,9 @@ from ...schema.common_types import StrictBaseModel
 
 class Styles(BaseModel):
     model_config = ConfigDict(populate_by_name=True)
-    font: str | None = Field(None, description="The primary font for the UI.")
+    font: str | None = Field(default=None, description="The primary font for the UI.")
     primary_color: str | None = Field(
-        None,
+        default=None,
         alias="primaryColor",
         description="The primary UI color as a hexadecimal code (e.g., '#00BFFF').",
         pattern=r"^#[0-9a-fA-F]{6}$",

{a2ui_core-0.2.0 → a2ui_core-0.3.0}/src/a2ui/core/basic_catalog/v0_9/__init__.py

@@ -84,6 +84,8 @@ from ...catalog import Catalog, ModelComponentApi, FunctionImplementation
 
 
 def _basic_catalog_id(protocol_version: str) -> str:
+    if protocol_version == "v0.8":
+        return f"{PROTOCOL_BASE_URL}/v0_8/standard_catalog_definition.json"
     return (
         f"{PROTOCOL_BASE_URL}/{protocol_version.replace('.', '_')}/catalogs/basic/catalog.json"
     )