optimizely-opal.opal-tools-sdk 0.1.16.dev0__tar.gz → 0.1.18.dev0__tar.gz

{optimizely_opal_opal_tools_sdk-0.1.16.dev0 → optimizely_opal_opal_tools_sdk-0.1.18.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optimizely-opal.opal-tools-sdk
-Version: 0.1.16.dev0
+Version: 0.1.18.dev0
 Summary: SDK for creating Opal-compatible tools services
 Home-page: https://github.com/optimizely/opal-tools-sdk
 Author: Optimizely

{optimizely_opal_opal_tools_sdk-0.1.16.dev0 → optimizely_opal_opal_tools_sdk-0.1.18.dev0}/opal_tools_sdk/proteus.py

@@ -1,12 +1,12 @@
 # generated by datamodel-codegen:
 #   filename:  proteus-document-spec.json
-#   timestamp: 2026-03-07T00:35:26+00:00
+#   timestamp: 2026-03-12T17:59:00+00:00
 
 from __future__ import annotations
 
 from typing import Any, Literal
 
-from pydantic import BaseModel, ConfigDict, Field, RootModel
+from pydantic import BaseModel, ConfigDict, Field, RootModel, constr
 
 
 class OpalProteusDocumentSpecification(RootModel[Any]):
@@ -35,46 +35,33 @@ class ProteusEventHandler2(BaseModel):
     message: str = Field(..., description='Message to send to LLM via sendNewMessage()')
 
 
-class ProteusEventHandler3(BaseModel):
-    """
-    Client-side component action - for downloading a URL
-    """
-
-    model_config = ConfigDict(
-        extra='forbid',
-    )
-    action: Literal['download'] = Field(default='download', description='The action type')
-    url: str = Field(..., description='URL to download')
-
-
-class ProteusEventHandler(
-    RootModel[ProteusEventHandler1 | ProteusEventHandler2 | ProteusEventHandler3]
-):
-    root: ProteusEventHandler1 | ProteusEventHandler2 | ProteusEventHandler3 = Field(
-        ...,
-        description='Handler for user interactions - a server-side tool call, client-side message, or client-side component action',
-    )
-
-
 class Series(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    color: str | None = Field(default=None, description='Series color')
     dataKey: str = Field(..., description='Key in data records for this series')
-    labelKey: str | None = Field(
-        default=None,
-        description='Key in data records for pre-formatted labels displayed above bars',
-    )
     name: str | None = Field(default=None, description='Display name for legend')
 
 
+class Format(BaseModel):
+    """
+    Formatter with options
+    """
+
+    options: dict[str, Any] | None = None
+    type: str
+
+
 class Column(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
     accessorKey: str = Field(..., description='Key in data objects')
+    format: str | Format | None = Field(
+        default=None, description="Format to apply to cell values (e.g. 'Number', 'DateTime')"
+    )
     header: str = Field(..., description='Column header text')
+    size: float | None = Field(default=None, description='Column size')
 
 
 class Marks(BaseModel):
@@ -93,11 +80,30 @@ class Option(BaseModel):
     value: str = Field(..., description='Return a unique key for each item')
 
 
+class Formatter(BaseModel):
+    """
+    Formatter with custom Intl options. 'type' selects the formatter, 'options' are passed to the Intl constructor.
+    """
+
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    options: dict[str, Any] | None = Field(
+        default=None,
+        description='Options passed to the Intl formatter constructor (e.g., Intl.DateTimeFormatOptions or Intl.NumberFormatOptions)',
+    )
+    type: Literal['DateTime', 'Number'] = Field(..., description='Formatter type')
+
+
 class ProteusValue(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
     field_type: Literal['Value'] = Field(default='Value', alias='$type')
+    formatter: Literal['DateTime', 'Number'] | Formatter | None = Field(
+        default=None,
+        description='Optional formatter to apply to the resolved value. Can be a string shorthand or an object with type and options for Intl formatters.',
+    )
     path: str = Field(
         ...,
         description="Path to a value in the data. Absolute paths start with '/' and resolve from the root (e.g., '/title', '/options/0/label'). Inside a Map template, paths without a leading '/' are relative to the current item (e.g., 'title' resolves to each item's 'title' field).",
@@ -1681,9 +1687,9 @@ class SprinklePropZ(
     )
 
 
-class ProteusAtomicCondition1(BaseModel):
+class ProteusCondition1(BaseModel):
     """
-    Simple comparison condition - single operator only (used in OR arrays to avoid recursion)
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
     """
 
     model_config = ConfigDict(
@@ -1694,9 +1700,9 @@ class ProteusAtomicCondition1(BaseModel):
     )
 
 
-class ProteusAtomicCondition2(BaseModel):
+class ProteusCondition2(BaseModel):
     """
-    Simple comparison condition - single operator only (used in OR arrays to avoid recursion)
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
     """
 
     model_config = ConfigDict(
@@ -1707,9 +1713,9 @@ class ProteusAtomicCondition2(BaseModel):
     )
 
 
-class ProteusAtomicCondition3(BaseModel):
+class ProteusCondition3(BaseModel):
     """
-    Simple comparison condition - single operator only (used in OR arrays to avoid recursion)
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
     """
 
     model_config = ConfigDict(
@@ -1720,9 +1726,9 @@ class ProteusAtomicCondition3(BaseModel):
     )
 
 
-class ProteusAtomicCondition4(BaseModel):
+class ProteusCondition4(BaseModel):
     """
-    Simple comparison condition - single operator only (used in OR arrays to avoid recursion)
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
     """
 
     model_config = ConfigDict(
@@ -1733,9 +1739,9 @@ class ProteusAtomicCondition4(BaseModel):
     )
 
 
-class ProteusAtomicCondition5(BaseModel):
+class ProteusCondition5(BaseModel):
     """
-    Simple comparison condition - single operator only (used in OR arrays to avoid recursion)
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
     """
 
     model_config = ConfigDict(
@@ -1746,9 +1752,9 @@ class ProteusAtomicCondition5(BaseModel):
     )
 
 
-class ProteusAtomicCondition6(BaseModel):
+class ProteusCondition6(BaseModel):
     """
-    Simple comparison condition - single operator only (used in OR arrays to avoid recursion)
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
     """
 
     model_config = ConfigDict(
@@ -1759,9 +1765,9 @@ class ProteusAtomicCondition6(BaseModel):
     )
 
 
-class ProteusAtomicCondition7(BaseModel):
+class ProteusCondition7(BaseModel):
     """
-    Simple comparison condition - single operator only (used in OR arrays to avoid recursion)
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
     """
 
     model_config = ConfigDict(
@@ -1774,63 +1780,39 @@ class ProteusAtomicCondition7(BaseModel):
     )
 
 
-class ProteusAtomicCondition(
-    RootModel[
-        ProteusAtomicCondition1
-        | ProteusAtomicCondition2
-        | ProteusAtomicCondition3
-        | ProteusAtomicCondition4
-        | ProteusAtomicCondition5
-        | ProteusAtomicCondition6
-        | ProteusAtomicCondition7
-    ]
-):
-    root: (
-        ProteusAtomicCondition1
-        | ProteusAtomicCondition2
-        | ProteusAtomicCondition3
-        | ProteusAtomicCondition4
-        | ProteusAtomicCondition5
-        | ProteusAtomicCondition6
-        | ProteusAtomicCondition7
-    ) = Field(
-        ...,
-        description='Simple comparison condition - single operator only (used in OR arrays to avoid recursion)',
-    )
-
+class ProteusEventHandler3(BaseModel):
+    """
+    Client-side component action - for downloading a URL
+    """
 
-class Or(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    and_: list[ProteusAtomicCondition] = Field(
+    action: Literal['download'] = Field(default='download', description='The action type')
+    url: ProteusValue | str = Field(..., description='URL to download')
+
+
+class ProteusEventHandler(
+    RootModel[ProteusEventHandler1 | ProteusEventHandler2 | ProteusEventHandler3]
+):
+    root: ProteusEventHandler1 | ProteusEventHandler2 | ProteusEventHandler3 = Field(
         ...,
-        alias='and',
-        description='Logical AND - returns true if all conditions are true',
-        min_length=1,
+        description='Handler for user interactions - a server-side tool call, client-side message, or client-side component action',
     )
 
 
-class ProteusCondition1(BaseModel):
+class ProteusZip(BaseModel):
     """
-    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
+    Zips multiple parallel arrays into an array of objects. Each key in 'sources' becomes a property in the resulting row objects.
     """
 
     model_config = ConfigDict(
         extra='forbid',
     )
-    or_: list[Or | ProteusAtomicCondition] = Field(
-        ...,
-        alias='or',
-        description='Logical OR - returns true if any condition is true',
-        min_length=1,
-    )
-
-
-class ProteusCondition(RootModel[ProteusAtomicCondition | ProteusCondition1]):
-    root: ProteusAtomicCondition | ProteusCondition1 = Field(
+    field_type: Literal['Zip'] = Field(default='Zip', alias='$type')
+    sources: dict[constr(pattern=r'.*'), ProteusValue | list[Any]] = Field(
         ...,
-        description='Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.',
+        description='Map of output property names to array sources. Each source should resolve to an array of the same length.',
     )
 
 
@@ -1839,11 +1821,12 @@ class ProteusChart(BaseModel):
         extra='forbid',
     )
     field_type: Literal['Chart'] = Field(default='Chart', alias='$type')
-    data: list[dict[str, Any]] | ProteusValue | None = Field(
-        default=None, description='Chart data records, either inline or a ProteusValue reference'
+    data: list[dict[str, Any]] | ProteusValue | ProteusZip | None = Field(
+        default=None,
+        description='Chart data records, either inline, a ProteusValue reference, or a ProteusZip transformation',
     )
     series: list[Series] | None = Field(default=None, description='Data series configuration')
-    type: Literal['bar'] = Field(default='bar', description='Chart type')
+    type: Literal['bar', 'line'] | None = Field(default=None, description='Chart type')
     xAxisKey: str | None = Field(default=None, description='Key in data records for x-axis labels')
 
 
@@ -1853,7 +1836,71 @@ class ProteusDataTable(BaseModel):
     )
     field_type: Literal['DataTable'] = Field(default='DataTable', alias='$type')
     columns: list[Column] | None = Field(default=None, description='Column definitions')
-    data: list[dict[str, Any]] | ProteusValue | None = None
+    data: list[dict[str, Any]] | ProteusValue | ProteusZip | None = None
+
+
+class ProteusIconCalendar(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    field_type: Literal['IconCalendar'] = Field(default='IconCalendar', alias='$type')
+    alignItems: SprinklePropAlignItems | None = None
+    alignSelf: SprinklePropAlignSelf | None = None
+    animation: SprinklePropAnimation | None = None
+    backgroundImage: SprinklePropBackgroundImage | None = None
+    bg: SprinklePropBg | None = None
+    border: SprinklePropBorder | None = None
+    borderB: SprinklePropBorderB | None = None
+    borderColor: SprinklePropBorderColor | None = None
+    borderL: SprinklePropBorderL | None = None
+    borderR: SprinklePropBorderR | None = None
+    borderT: SprinklePropBorderT | None = None
+    color: SprinklePropColor | None = None
+    cursor: SprinklePropCursor | None = None
+    display: SprinklePropDisplay | None = None
+    flex: SprinklePropFlex | None = None
+    flexDirection: SprinklePropFlexDirection | None = None
+    flexWrap: SprinklePropFlexWrap | None = None
+    fontFamily: SprinklePropFontFamily | None = None
+    fontSize: SprinklePropFontSize | None = None
+    fontWeight: SprinklePropFontWeight | None = None
+    gap: SprinklePropGap | None = None
+    gridColumn: SprinklePropGridColumn | None = None
+    gridTemplateColumns: SprinklePropGridTemplateColumns | None = None
+    h: SprinklePropH | None = None
+    justifyContent: SprinklePropJustifyContent | None = None
+    justifyItems: SprinklePropJustifyItems | None = None
+    m: SprinklePropM | None = None
+    maxH: SprinklePropMaxH | None = None
+    maxW: SprinklePropMaxW | None = None
+    mb: SprinklePropMb | None = None
+    ml: SprinklePropMl | None = None
+    mr: SprinklePropMr | None = None
+    mt: SprinklePropMt | None = None
+    mx: SprinklePropMx | None = None
+    my: SprinklePropMy | None = None
+    objectFit: SprinklePropObjectFit | None = None
+    overflow: SprinklePropOverflow | None = None
+    overflowX: SprinklePropOverflowX | None = None
+    overflowY: SprinklePropOverflowY | None = None
+    p: SprinklePropP | None = None
+    pb: SprinklePropPb | None = None
+    pl: SprinklePropPl | None = None
+    placeItems: SprinklePropPlaceItems | None = None
+    pointerEvents: SprinklePropPointerEvents | None = None
+    pr: SprinklePropPr | None = None
+    pt: SprinklePropPt | None = None
+    px: SprinklePropPx | None = None
+    py: SprinklePropPy | None = None
+    rounded: SprinklePropRounded | None = None
+    shadow: SprinklePropShadow | None = None
+    size: SprinklePropSize | None = None
+    textAlign: SprinklePropTextAlign | None = None
+    textTransform: SprinklePropTextTransform | None = None
+    transition: SprinklePropTransition | None = None
+    w: SprinklePropW | None = None
+    whiteSpace: SprinklePropWhiteSpace | None = None
+    z: SprinklePropZ | None = None
 
 
 class ProteusImage(BaseModel):
@@ -2190,6 +2237,9 @@ class ProteusTextarea(BaseModel):
     pt: SprinklePropPt | None = None
     px: SprinklePropPx | None = None
     py: SprinklePropPy | None = None
+    required: bool | ProteusValue | None = Field(
+        default=None, description='Whether selecting this input is required.'
+    )
     resize: Literal['none'] | Literal['auto'] | Literal['vertical'] | ProteusValue | None = Field(
         default=None, description='Control whether resizing mode is manual, automatic, or disabled.'
     )
@@ -2279,6 +2329,38 @@ class ProteusTime(BaseModel):
     z: SprinklePropZ | None = None
 
 
+class ProteusCondition8(BaseModel):
+    """
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
+    """
+
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    and_: list[ProteusCondition] = Field(
+        ...,
+        alias='and',
+        description='Logical AND - returns true if all conditions are true',
+        min_length=1,
+    )
+
+
+class ProteusCondition9(BaseModel):
+    """
+    Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.
+    """
+
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    or_: list[ProteusCondition] = Field(
+        ...,
+        alias='or',
+        description='Logical OR - returns true if any condition is true',
+        min_length=1,
+    )
+
+
 class ProteusDocument(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
@@ -2389,6 +2471,93 @@ class ProteusAction(BaseModel):
     )
 
 
+class ProteusAvatar(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    field_type: Literal['Avatar'] = Field(default='Avatar', alias='$type')
+    alignItems: SprinklePropAlignItems | None = None
+    alignSelf: SprinklePropAlignSelf | None = None
+    animation: SprinklePropAnimation | None = None
+    backgroundImage: SprinklePropBackgroundImage | None = None
+    bg: SprinklePropBg | None = None
+    border: SprinklePropBorder | None = None
+    borderB: SprinklePropBorderB | None = None
+    borderColor: SprinklePropBorderColor | None = None
+    borderL: SprinklePropBorderL | None = None
+    borderR: SprinklePropBorderR | None = None
+    borderT: SprinklePropBorderT | None = None
+    children: ProteusNode | None = None
+    color: SprinklePropColor | None = None
+    colorScheme: Literal['purple'] | Literal['neutral'] | ProteusValue | None = Field(
+        default=None, description='Control the avatar fallback background and text colors.'
+    )
+    cursor: SprinklePropCursor | None = None
+    display: SprinklePropDisplay | None = None
+    fallback: Literal['opal'] | Literal['team'] | Literal['user'] | ProteusValue | None = Field(
+        default=None, description='The fallback icon to display when no name or image is given.'
+    )
+    flex: SprinklePropFlex | None = None
+    flexDirection: SprinklePropFlexDirection | None = None
+    flexWrap: SprinklePropFlexWrap | None = None
+    fontFamily: SprinklePropFontFamily | None = None
+    fontSize: SprinklePropFontSize | None = None
+    fontWeight: SprinklePropFontWeight | None = None
+    gap: SprinklePropGap | None = None
+    gridColumn: SprinklePropGridColumn | None = None
+    gridTemplateColumns: SprinklePropGridTemplateColumns | None = None
+    h: SprinklePropH | None = None
+    justifyContent: SprinklePropJustifyContent | None = None
+    justifyItems: SprinklePropJustifyItems | None = None
+    m: SprinklePropM | None = None
+    maxH: SprinklePropMaxH | None = None
+    maxW: SprinklePropMaxW | None = None
+    mb: SprinklePropMb | None = None
+    ml: SprinklePropMl | None = None
+    mr: SprinklePropMr | None = None
+    mt: SprinklePropMt | None = None
+    mx: SprinklePropMx | None = None
+    my: SprinklePropMy | None = None
+    name: str | ProteusValue | None = Field(
+        default=None, description='Use name to generate initials to show inside the avatar.'
+    )
+    objectFit: SprinklePropObjectFit | None = None
+    overflow: SprinklePropOverflow | None = None
+    overflowX: SprinklePropOverflowX | None = None
+    overflowY: SprinklePropOverflowY | None = None
+    p: SprinklePropP | None = None
+    pb: SprinklePropPb | None = None
+    pl: SprinklePropPl | None = None
+    placeItems: SprinklePropPlaceItems | None = None
+    pointerEvents: SprinklePropPointerEvents | None = None
+    pr: SprinklePropPr | None = None
+    pt: SprinklePropPt | None = None
+    px: SprinklePropPx | None = None
+    py: SprinklePropPy | None = None
+    rounded: SprinklePropRounded | None = None
+    shadow: SprinklePropShadow | None = None
+    size: (
+        Literal['xs']
+        | Literal['sm']
+        | Literal['md']
+        | Literal['lg']
+        | Literal['xl']
+        | Literal['3xl']
+        | Literal['2xs']
+        | ProteusValue
+        | None
+    ) = Field(default=None, description='Control the size of the avatar.')
+    src: str | ProteusValue | None = Field(
+        default=None, description='Render the image inside the avatar.'
+    )
+    textAlign: SprinklePropTextAlign | None = None
+    textTransform: SprinklePropTextTransform | None = None
+    transition: SprinklePropTransition | None = None
+    w: SprinklePropW | None = None
+    whiteSpace: SprinklePropWhiteSpace | None = None
+    z: SprinklePropZ | None = None
+
+
 class ProteusBadge(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
@@ -2534,6 +2703,241 @@ class ProteusCancelAction(BaseModel):
     )
 
 
+class ProteusCard(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    field_type: Literal['Card'] = Field(default='Card', alias='$type')
+    alignItems: SprinklePropAlignItems | None = None
+    alignSelf: SprinklePropAlignSelf | None = None
+    animation: SprinklePropAnimation | None = None
+    backgroundImage: SprinklePropBackgroundImage | None = None
+    bg: SprinklePropBg | None = None
+    border: SprinklePropBorder | None = None
+    borderB: SprinklePropBorderB | None = None
+    borderColor: SprinklePropBorderColor | None = None
+    borderL: SprinklePropBorderL | None = None
+    borderR: SprinklePropBorderR | None = None
+    borderT: SprinklePropBorderT | None = None
+    children: ProteusNode | None = None
+    color: SprinklePropColor | None = None
+    cursor: SprinklePropCursor | None = None
+    display: SprinklePropDisplay | None = None
+    flex: SprinklePropFlex | None = None
+    flexDirection: SprinklePropFlexDirection | None = None
+    flexWrap: SprinklePropFlexWrap | None = None
+    fontFamily: SprinklePropFontFamily | None = None
+    fontSize: SprinklePropFontSize | None = None
+    fontWeight: SprinklePropFontWeight | None = None
+    gap: SprinklePropGap | None = None
+    gridColumn: SprinklePropGridColumn | None = None
+    gridTemplateColumns: SprinklePropGridTemplateColumns | None = None
+    h: SprinklePropH | None = None
+    justifyContent: SprinklePropJustifyContent | None = None
+    justifyItems: SprinklePropJustifyItems | None = None
+    m: SprinklePropM | None = None
+    maxH: SprinklePropMaxH | None = None
+    maxW: SprinklePropMaxW | None = None
+    mb: SprinklePropMb | None = None
+    ml: SprinklePropMl | None = None
+    mr: SprinklePropMr | None = None
+    mt: SprinklePropMt | None = None
+    mx: SprinklePropMx | None = None
+    my: SprinklePropMy | None = None
+    objectFit: SprinklePropObjectFit | None = None
+    overflow: SprinklePropOverflow | None = None
+    overflowX: SprinklePropOverflowX | None = None
+    overflowY: SprinklePropOverflowY | None = None
+    p: SprinklePropP | None = None
+    pb: SprinklePropPb | None = None
+    pl: SprinklePropPl | None = None
+    placeItems: SprinklePropPlaceItems | None = None
+    pointerEvents: SprinklePropPointerEvents | None = None
+    pr: SprinklePropPr | None = None
+    pt: SprinklePropPt | None = None
+    px: SprinklePropPx | None = None
+    py: SprinklePropPy | None = None
+    rounded: SprinklePropRounded | None = None
+    shadow: SprinklePropShadow | None = None
+    size: SprinklePropSize | None = None
+    textAlign: SprinklePropTextAlign | None = None
+    textTransform: SprinklePropTextTransform | None = None
+    transition: SprinklePropTransition | None = None
+    w: SprinklePropW | None = None
+    whiteSpace: SprinklePropWhiteSpace | None = None
+    z: SprinklePropZ | None = None
+
+
+class ProteusCardHeader(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    field_type: Literal['CardHeader'] = Field(default='CardHeader', alias='$type')
+    addonAfter: ProteusNode | None = Field(
+        default=None, description='Display content inside the header after `children`.'
+    )
+    addonBefore: ProteusNode | None = Field(
+        default=None, description='Display content inside the header before `children`.'
+    )
+    alignItems: SprinklePropAlignItems | None = None
+    alignSelf: SprinklePropAlignSelf | None = None
+    animation: SprinklePropAnimation | None = None
+    backgroundImage: SprinklePropBackgroundImage | None = None
+    bg: SprinklePropBg | None = None
+    border: SprinklePropBorder | None = None
+    borderB: SprinklePropBorderB | None = None
+    borderColor: SprinklePropBorderColor | None = None
+    borderL: SprinklePropBorderL | None = None
+    borderR: SprinklePropBorderR | None = None
+    borderT: SprinklePropBorderT | None = None
+    children: ProteusNode | None = None
+    color: SprinklePropColor | None = None
+    cursor: SprinklePropCursor | None = None
+    description: ProteusNode | None = Field(
+        default=None, description='Add secondary text after the primary title.'
+    )
+    display: SprinklePropDisplay | None = None
+    flex: SprinklePropFlex | None = None
+    flexDirection: SprinklePropFlexDirection | None = None
+    flexWrap: SprinklePropFlexWrap | None = None
+    fontFamily: SprinklePropFontFamily | None = None
+    fontSize: SprinklePropFontSize | None = None
+    fontWeight: SprinklePropFontWeight | None = None
+    gap: SprinklePropGap | None = None
+    gridColumn: SprinklePropGridColumn | None = None
+    gridTemplateColumns: SprinklePropGridTemplateColumns | None = None
+    h: SprinklePropH | None = None
+    justifyContent: SprinklePropJustifyContent | None = None
+    justifyItems: SprinklePropJustifyItems | None = None
+    m: SprinklePropM | None = None
+    maxH: SprinklePropMaxH | None = None
+    maxW: SprinklePropMaxW | None = None
+    mb: SprinklePropMb | None = None
+    ml: SprinklePropMl | None = None
+    mr: SprinklePropMr | None = None
+    mt: SprinklePropMt | None = None
+    mx: SprinklePropMx | None = None
+    my: SprinklePropMy | None = None
+    objectFit: SprinklePropObjectFit | None = None
+    overflow: SprinklePropOverflow | None = None
+    overflowX: SprinklePropOverflowX | None = None
+    overflowY: SprinklePropOverflowY | None = None
+    p: SprinklePropP | None = None
+    pb: SprinklePropPb | None = None
+    pl: SprinklePropPl | None = None
+    placeItems: SprinklePropPlaceItems | None = None
+    pointerEvents: SprinklePropPointerEvents | None = None
+    pr: SprinklePropPr | None = None
+    pt: SprinklePropPt | None = None
+    px: SprinklePropPx | None = None
+    py: SprinklePropPy | None = None
+    rounded: SprinklePropRounded | None = None
+    shadow: SprinklePropShadow | None = None
+    size: SprinklePropSize | None = None
+    textAlign: SprinklePropTextAlign | None = None
+    textTransform: SprinklePropTextTransform | None = None
+    transition: SprinklePropTransition | None = None
+    w: SprinklePropW | None = None
+    whiteSpace: SprinklePropWhiteSpace | None = None
+    z: SprinklePropZ | None = None
+
+
+class ProteusCardLink(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    field_type: Literal['CardLink'] = Field(default='CardLink', alias='$type')
+    alignItems: SprinklePropAlignItems | None = None
+    alignSelf: SprinklePropAlignSelf | None = None
+    animation: SprinklePropAnimation | None = None
+    backgroundImage: SprinklePropBackgroundImage | None = None
+    bg: SprinklePropBg | None = None
+    border: SprinklePropBorder | None = None
+    borderB: SprinklePropBorderB | None = None
+    borderColor: SprinklePropBorderColor | None = None
+    borderL: SprinklePropBorderL | None = None
+    borderR: SprinklePropBorderR | None = None
+    borderT: SprinklePropBorderT | None = None
+    children: ProteusNode | None = None
+    color: SprinklePropColor | None = None
+    cursor: SprinklePropCursor | None = None
+    display: SprinklePropDisplay | None = None
+    flex: SprinklePropFlex | None = None
+    flexDirection: SprinklePropFlexDirection | None = None
+    flexWrap: SprinklePropFlexWrap | None = None
+    fontFamily: SprinklePropFontFamily | None = None
+    fontSize: SprinklePropFontSize | None = None
+    fontWeight: SprinklePropFontWeight | None = None
+    gap: SprinklePropGap | None = None
+    gridColumn: SprinklePropGridColumn | None = None
+    gridTemplateColumns: SprinklePropGridTemplateColumns | None = None
+    h: SprinklePropH | None = None
+    href: str | ProteusValue | None = Field(default=None, description='The link href.')
+    justifyContent: SprinklePropJustifyContent | None = None
+    justifyItems: SprinklePropJustifyItems | None = None
+    m: SprinklePropM | None = None
+    maxH: SprinklePropMaxH | None = None
+    maxW: SprinklePropMaxW | None = None
+    mb: SprinklePropMb | None = None
+    ml: SprinklePropMl | None = None
+    mr: SprinklePropMr | None = None
+    mt: SprinklePropMt | None = None
+    mx: SprinklePropMx | None = None
+    my: SprinklePropMy | None = None
+    objectFit: SprinklePropObjectFit | None = None
+    overflow: SprinklePropOverflow | None = None
+    overflowX: SprinklePropOverflowX | None = None
+    overflowY: SprinklePropOverflowY | None = None
+    p: SprinklePropP | None = None
+    pb: SprinklePropPb | None = None
+    pl: SprinklePropPl | None = None
+    placeItems: SprinklePropPlaceItems | None = None
+    pointerEvents: SprinklePropPointerEvents | None = None
+    pr: SprinklePropPr | None = None
+    pt: SprinklePropPt | None = None
+    px: SprinklePropPx | None = None
+    py: SprinklePropPy | None = None
+    rounded: SprinklePropRounded | None = None
+    shadow: SprinklePropShadow | None = None
+    size: SprinklePropSize | None = None
+    textAlign: SprinklePropTextAlign | None = None
+    textTransform: SprinklePropTextTransform | None = None
+    transition: SprinklePropTransition | None = None
+    w: SprinklePropW | None = None
+    whiteSpace: SprinklePropWhiteSpace | None = None
+    z: SprinklePropZ | None = None
+
+
+class ProteusChoice(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    field_type: Literal['Choice'] = Field(default='Choice', alias='$type')
+    addonBefore: ProteusNode | None = Field(
+        default=None, description='Content to display before the choice text (e.g., numbered badge)'
+    )
+    children: ProteusNode | None = Field(default=None, description='Title/label of the choice')
+    description: ProteusNode | None = Field(
+        default=None, description='Secondary description text shown below the title'
+    )
+    onClick: ProteusEventHandler | None = Field(
+        default=None, description='Action triggered when choice is selected'
+    )
+    required: bool | None = Field(
+        default=None, description='Whether selecting this choice is required to proceed'
+    )
+    value: str | None = Field(default=None, description='Value associated with this choice')
+
+
+class ProteusChoiceGroup(BaseModel):
+    model_config = ConfigDict(
+        extra='forbid',
+    )
+    field_type: Literal['ChoiceGroup'] = Field(default='ChoiceGroup', alias='$type')
+    children: ProteusNode | None = Field(default=None, description='Choice elements to render')
+    name: str | None = Field(default=None, description='Data field name for the selected value')
+
+
 class ProteusField(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
@@ -2832,6 +3236,9 @@ class ProteusInput(BaseModel):
     pt: SprinklePropPt | None = None
     px: SprinklePropPx | None = None
     py: SprinklePropPy | None = None
+    required: bool | ProteusValue | None = Field(
+        default=None, description='Whether selecting this input is required.'
+    )
     rounded: SprinklePropRounded | None = None
     shadow: SprinklePropShadow | None = None
     textAlign: SprinklePropTextAlign | None = None
@@ -2947,6 +3354,10 @@ class ProteusMap(BaseModel):
     path: str = Field(
         ..., description="JSON pointer path to the source array in the data (e.g., '/results')"
     )
+    separator: ProteusNode | None = Field(
+        default=None,
+        description='Optional separator to render between items. Can be a string or a ProteusNode for more complex separators.',
+    )
 
 
 class ProteusSelect(BaseModel):
@@ -2959,6 +3370,9 @@ class ProteusSelect(BaseModel):
         default=None, description='The name of the inner select element.'
     )
     options: list[Option] = Field(..., description='The select items/options we want to render.')
+    required: bool | ProteusValue | None = Field(
+        default=None, description='Whether the select value is required.'
+    )
 
 
 class ProteusSelectTrigger(BaseModel):
@@ -3110,16 +3524,52 @@ class ProteusText(BaseModel):
     z: SprinklePropZ | None = None
 
 
+class ProteusCondition(
+    RootModel[
+        ProteusCondition1
+        | ProteusCondition2
+        | ProteusCondition3
+        | ProteusCondition4
+        | ProteusCondition5
+        | ProteusCondition6
+        | ProteusCondition7
+        | ProteusCondition8
+        | ProteusCondition9
+    ]
+):
+    root: (
+        ProteusCondition1
+        | ProteusCondition2
+        | ProteusCondition3
+        | ProteusCondition4
+        | ProteusCondition5
+        | ProteusCondition6
+        | ProteusCondition7
+        | ProteusCondition8
+        | ProteusCondition9
+    ) = Field(
+        ...,
+        description='Condition for Show component. Can be a comparison operator, logical AND, or logical OR. Supports nesting.',
+    )
+
+
 class ProteusElement(
     RootModel[
         ProteusAction
+        | ProteusAvatar
         | ProteusBadge
         | ProteusCancelAction
+        | ProteusCard
+        | ProteusCardHeader
+        | ProteusCardLink
         | ProteusChart
+        | ProteusChoice
+        | ProteusChoiceGroup
         | ProteusDataTable
         | ProteusField
         | ProteusGroup
         | ProteusHeading
+        | ProteusIconCalendar
         | ProteusImage
         | ProteusInput
         | ProteusLink
@@ -3138,13 +3588,20 @@ class ProteusElement(
 ):
     root: (
         ProteusAction
+        | ProteusAvatar
         | ProteusBadge
         | ProteusCancelAction
+        | ProteusCard
+        | ProteusCardHeader
+        | ProteusCardLink
         | ProteusChart
+        | ProteusChoice
+        | ProteusChoiceGroup
         | ProteusDataTable
         | ProteusField
         | ProteusGroup
         | ProteusHeading
+        | ProteusIconCalendar
         | ProteusImage
         | ProteusInput
         | ProteusLink
@@ -3188,10 +3645,18 @@ class ProteusNode(
     )
 
 
+ProteusCondition8.model_rebuild()
+ProteusCondition9.model_rebuild()
 ProteusDocument.model_rebuild()
 ProteusAction.model_rebuild()
+ProteusAvatar.model_rebuild()
 ProteusBadge.model_rebuild()
 ProteusCancelAction.model_rebuild()
+ProteusCard.model_rebuild()
+ProteusCardHeader.model_rebuild()
+ProteusCardLink.model_rebuild()
+ProteusChoice.model_rebuild()
+ProteusChoiceGroup.model_rebuild()
 ProteusField.model_rebuild()
 ProteusGroup.model_rebuild()
 ProteusHeading.model_rebuild()
@@ -3217,14 +3682,21 @@ class UI:
     MIME_TYPE = "application/vnd.opal.proteus+json"
 
     Action = ProteusAction
+    Avatar = ProteusAvatar
     Badge = ProteusBadge
     CancelAction = ProteusCancelAction
+    Card = ProteusCard
+    CardHeader = ProteusCardHeader
+    CardLink = ProteusCardLink
     Chart = ProteusChart
+    Choice = ProteusChoice
+    ChoiceGroup = ProteusChoiceGroup
     DataTable = ProteusDataTable
     Document = ProteusDocument
     Field = ProteusField
     Group = ProteusGroup
     Heading = ProteusHeading
+    IconCalendar = ProteusIconCalendar
     Image = ProteusImage
     Input = ProteusInput
     Link = ProteusLink
@@ -3239,3 +3711,4 @@ class UI:
     Textarea = ProteusTextarea
     Time = ProteusTime
     Value = ProteusValue
+    Zip = ProteusZip

{optimizely_opal_opal_tools_sdk-0.1.16.dev0 → optimizely_opal_opal_tools_sdk-0.1.18.dev0}/opal_tools_sdk/service.py

@@ -227,6 +227,8 @@ class ToolsService:
             except ValidationError as e:
                 logger.warning(f"Invalid parameters predicted by LLM for tool {name}: {str(e)}")
                 raise HTTPException(status_code=400, detail=str(e))
+            except HTTPException:
+                raise
             except Exception as e:
                 import traceback
 

{optimizely_opal_opal_tools_sdk-0.1.16.dev0 → optimizely_opal_opal_tools_sdk-0.1.18.dev0}/optimizely_opal.opal_tools_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optimizely-opal.opal-tools-sdk
-Version: 0.1.16.dev0
+Version: 0.1.18.dev0
 Summary: SDK for creating Opal-compatible tools services
 Home-page: https://github.com/optimizely/opal-tools-sdk
 Author: Optimizely

{optimizely_opal_opal_tools_sdk-0.1.16.dev0 → optimizely_opal_opal_tools_sdk-0.1.18.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "optimizely-opal.opal-tools-sdk"
-version = "0.1.16-dev"
+version = "0.1.18-dev"
 description = "SDK for creating Opal-compatible tools services"
 authors = [{ name = "Optimizely", email = "opal-team@optimizely.com" }]
 readme = "README.md"

{optimizely_opal_opal_tools_sdk-0.1.16.dev0 → optimizely_opal_opal_tools_sdk-0.1.18.dev0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="optimizely-opal.opal-tools-sdk",
-    version="0.1.16-dev",
+    version="0.1.18-dev",
     packages=find_packages(),
     install_requires=[
         "fastapi>=0.100.0",