h2o-wave 1.0.2__py3-none-any.whl → 1.1.0__py3-none-any.whl

h2o_wave/cli.py

@@ -132,6 +132,10 @@ def run(app: str, no_reload: bool, no_autostart: bool):
     # uvicorn.main() does this before calling uvicorn.run().
     sys.path.insert(0, '.')
 
+    # Allow relative paths from bash autocomplete. E.g. wave run ./foo.py
+    if app.startswith(f'.{os.path.sep}'):
+        app = app[2:]
+
     # DevX: treat foo/bar/baz.py as foo.bar.baz
     app_path, ext = os.path.splitext(app)
     if ext.lower() == '.py':
@@ -150,6 +154,7 @@ def run(app: str, no_reload: bool, no_autostart: bool):
     waved_path = os.path.join(sys.exec_prefix, 'waved.exe' if IS_WINDOWS else 'waved')
     # OS agnostic wheels do not include waved - needed for HAC.
     is_waved_present = os.path.isfile(waved_path)
+    is_auto_started = server_not_running
 
     try:
         if autostart and is_waved_present and server_not_running:
@@ -171,7 +176,7 @@ def run(app: str, no_reload: bool, no_autostart: bool):
             print('Could not connect to Wave server. Please start the Wave server (waved or waved.exe) prior to running any app.')
             return
 
-        if not os.environ.get('H2O_WAVE_WAVED_DIR') and is_waved_present:
+        if not os.environ.get('H2O_WAVE_WAVED_DIR') and is_auto_started:
             os.environ['H2O_WAVE_WAVED_DIR'] = sys.exec_prefix
         reload_exclude = os.environ.get('H2O_WAVE_RELOAD_EXCLUDE', None)
         if reload_exclude:

h2o_wave/types.py

@@ -160,6 +160,8 @@ class Command:
             icon: Optional[str] = None,
             items: Optional[List['Command']] = None,
             value: Optional[str] = None,
+            path: Optional[str] = None,
+            download: Optional[bool] = None,
     ):
         _guard_scalar('Command.name', name, (str,), True, False, False)
         _guard_scalar('Command.label', label, (str,), False, True, False)
@@ -167,6 +169,8 @@ class Command:
         _guard_scalar('Command.icon', icon, (str,), False, True, False)
         _guard_vector('Command.items', items, (Command,), False, True, False)
         _guard_scalar('Command.value', value, (str,), False, True, False)
+        _guard_scalar('Command.path', path, (str,), False, True, False)
+        _guard_scalar('Command.download', download, (bool,), False, True, False)
         self.name = name
         """An identifying name for this component. If the name is prefixed with a '#', the command sets the location hash to the name when executed."""
         self.label = label
@@ -179,6 +183,10 @@ class Command:
         """Sub-commands, if any"""
         self.value = value
         """Data associated with this command, if any."""
+        self.path = path
+        """The path or URL to link to. The 'items' and 'value' props are ignored when specified."""
+        self.download = download
+        """True if the link should prompt the user to save the linked URL instead of navigating to it."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -188,6 +196,8 @@ class Command:
         _guard_scalar('Command.icon', self.icon, (str,), False, True, False)
         _guard_vector('Command.items', self.items, (Command,), False, True, False)
         _guard_scalar('Command.value', self.value, (str,), False, True, False)
+        _guard_scalar('Command.path', self.path, (str,), False, True, False)
+        _guard_scalar('Command.download', self.download, (bool,), False, True, False)
         return _dump(
             name=self.name,
             label=self.label,
@@ -195,6 +205,8 @@ class Command:
             icon=self.icon,
             items=None if self.items is None else [__e.dump() for __e in self.items],
             value=self.value,
+            path=self.path,
+            download=self.download,
         )
 
     @staticmethod
@@ -212,12 +224,18 @@ class Command:
         _guard_vector('Command.items', __d_items, (dict,), False, True, False)
         __d_value: Any = __d.get('value')
         _guard_scalar('Command.value', __d_value, (str,), False, True, False)
+        __d_path: Any = __d.get('path')
+        _guard_scalar('Command.path', __d_path, (str,), False, True, False)
+        __d_download: Any = __d.get('download')
+        _guard_scalar('Command.download', __d_download, (bool,), False, True, False)
         name: str = __d_name
         label: Optional[str] = __d_label
         caption: Optional[str] = __d_caption
         icon: Optional[str] = __d_icon
         items: Optional[List['Command']] = None if __d_items is None else [Command.load(__e) for __e in __d_items]
         value: Optional[str] = __d_value
+        path: Optional[str] = __d_path
+        download: Optional[bool] = __d_download
         return Command(
             name,
             label,
@@ -225,6 +243,8 @@ class Command:
             icon,
             items,
             value,
+            path,
+            download,
         )
 
 
@@ -969,6 +989,15 @@ class MessageBar:
         )
 
 
+_TextboxType = ['text', 'number', 'tel']
+
+
+class TextboxType:
+    TEXT = 'text'
+    NUMBER = 'number'
+    TEL = 'tel'
+
+
 class Textbox:
     """Create a text box.
 
@@ -998,6 +1027,7 @@ class Textbox:
             visible: Optional[bool] = None,
             tooltip: Optional[str] = None,
             spellcheck: Optional[bool] = None,
+            type: Optional[str] = None,
     ):
         _guard_scalar('Textbox.name', name, (str,), True, False, False)
         _guard_scalar('Textbox.label', label, (str,), False, True, False)
@@ -1019,6 +1049,7 @@ class Textbox:
         _guard_scalar('Textbox.visible', visible, (bool,), False, True, False)
         _guard_scalar('Textbox.tooltip', tooltip, (str,), False, True, False)
         _guard_scalar('Textbox.spellcheck', spellcheck, (bool,), False, True, False)
+        _guard_enum('Textbox.type', type, _TextboxType, True)
         self.name = name
         """An identifying name for this component."""
         self.label = label
@@ -1059,6 +1090,8 @@ class Textbox:
         """An optional tooltip message displayed when a user clicks the help icon to the right of the component."""
         self.spellcheck = spellcheck
         """True if the text may be checked for spelling errors. Defaults to True."""
+        self.type = type
+        """Keyboard to be shown on mobile devices. Defaults to 'text'. One of 'text', 'number', 'tel'. See enum h2o_wave.ui.TextboxType."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -1082,6 +1115,7 @@ class Textbox:
         _guard_scalar('Textbox.visible', self.visible, (bool,), False, True, False)
         _guard_scalar('Textbox.tooltip', self.tooltip, (str,), False, True, False)
         _guard_scalar('Textbox.spellcheck', self.spellcheck, (bool,), False, True, False)
+        _guard_enum('Textbox.type', self.type, _TextboxType, True)
         return _dump(
             name=self.name,
             label=self.label,
@@ -1103,6 +1137,7 @@ class Textbox:
             visible=self.visible,
             tooltip=self.tooltip,
             spellcheck=self.spellcheck,
+            type=self.type,
         )
 
     @staticmethod
@@ -1148,6 +1183,8 @@ class Textbox:
         _guard_scalar('Textbox.tooltip', __d_tooltip, (str,), False, True, False)
         __d_spellcheck: Any = __d.get('spellcheck')
         _guard_scalar('Textbox.spellcheck', __d_spellcheck, (bool,), False, True, False)
+        __d_type: Any = __d.get('type')
+        _guard_enum('Textbox.type', __d_type, _TextboxType, True)
         name: str = __d_name
         label: Optional[str] = __d_label
         placeholder: Optional[str] = __d_placeholder
@@ -1168,6 +1205,7 @@ class Textbox:
         visible: Optional[bool] = __d_visible
         tooltip: Optional[str] = __d_tooltip
         spellcheck: Optional[bool] = __d_spellcheck
+        type: Optional[str] = __d_type
         return Textbox(
             name,
             label,
@@ -1189,6 +1227,7 @@ class Textbox:
             visible,
             tooltip,
             spellcheck,
+            type,
         )
 
 
@@ -5823,12 +5862,14 @@ class Stat:
             caption: Optional[str] = None,
             icon: Optional[str] = None,
             icon_color: Optional[str] = None,
+            name: Optional[str] = None,
     ):
         _guard_scalar('Stat.label', label, (str,), False, False, False)
         _guard_scalar('Stat.value', value, (str,), False, True, False)
         _guard_scalar('Stat.caption', caption, (str,), False, True, False)
         _guard_scalar('Stat.icon', icon, (str,), False, True, False)
         _guard_scalar('Stat.icon_color', icon_color, (str,), False, True, False)
+        _guard_scalar('Stat.name', name, (str,), False, True, False)
         self.label = label
         """The label for the metric."""
         self.value = value
@@ -5839,6 +5880,8 @@ class Stat:
         """An optional icon, displayed next to the label."""
         self.icon_color = icon_color
         """The color of the icon."""
+        self.name = name
+        """An identifying name for this item."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -5847,12 +5890,14 @@ class Stat:
         _guard_scalar('Stat.caption', self.caption, (str,), False, True, False)
         _guard_scalar('Stat.icon', self.icon, (str,), False, True, False)
         _guard_scalar('Stat.icon_color', self.icon_color, (str,), False, True, False)
+        _guard_scalar('Stat.name', self.name, (str,), False, True, False)
         return _dump(
             label=self.label,
             value=self.value,
             caption=self.caption,
             icon=self.icon,
             icon_color=self.icon_color,
+            name=self.name,
         )
 
     @staticmethod
@@ -5868,17 +5913,21 @@ class Stat:
         _guard_scalar('Stat.icon', __d_icon, (str,), False, True, False)
         __d_icon_color: Any = __d.get('icon_color')
         _guard_scalar('Stat.icon_color', __d_icon_color, (str,), False, True, False)
+        __d_name: Any = __d.get('name')
+        _guard_scalar('Stat.name', __d_name, (str,), False, True, False)
         label: str = __d_label
         value: Optional[str] = __d_value
         caption: Optional[str] = __d_caption
         icon: Optional[str] = __d_icon
         icon_color: Optional[str] = __d_icon_color
+        name: Optional[str] = __d_name
         return Stat(
             label,
             value,
             caption,
             icon,
             icon_color,
+            name,
         )
 
 
@@ -5903,12 +5952,14 @@ class Stats:
             inset: Optional[bool] = None,
             width: Optional[str] = None,
             visible: Optional[bool] = None,
+            name: Optional[str] = None,
     ):
         _guard_vector('Stats.items', items, (Stat,), False, False, False)
         _guard_enum('Stats.justify', justify, _StatsJustify, True)
         _guard_scalar('Stats.inset', inset, (bool,), False, True, False)
         _guard_scalar('Stats.width', width, (str,), False, True, False)
         _guard_scalar('Stats.visible', visible, (bool,), False, True, False)
+        _guard_scalar('Stats.name', name, (str,), False, True, False)
         self.items = items
         """The individual stats to be displayed."""
         self.justify = justify
@@ -5919,6 +5970,8 @@ class Stats:
         """The width of the stats, e.g. '100px'."""
         self.visible = visible
         """True if the component should be visible. Defaults to True."""
+        self.name = name
+        """An identifying name for this component."""
 
     def dump(self) -> Dict:
         """Returns the contents of this object as a dict."""
@@ -5927,12 +5980,14 @@ class Stats:
         _guard_scalar('Stats.inset', self.inset, (bool,), False, True, False)
         _guard_scalar('Stats.width', self.width, (str,), False, True, False)
         _guard_scalar('Stats.visible', self.visible, (bool,), False, True, False)
+        _guard_scalar('Stats.name', self.name, (str,), False, True, False)
         return _dump(
             items=[__e.dump() for __e in self.items],
             justify=self.justify,
             inset=self.inset,
             width=self.width,
             visible=self.visible,
+            name=self.name,
         )
 
     @staticmethod
@@ -5948,17 +6003,21 @@ class Stats:
         _guard_scalar('Stats.width', __d_width, (str,), False, True, False)
         __d_visible: Any = __d.get('visible')
         _guard_scalar('Stats.visible', __d_visible, (bool,), False, True, False)
+        __d_name: Any = __d.get('name')
+        _guard_scalar('Stats.name', __d_name, (str,), False, True, False)
         items: List[Stat] = [Stat.load(__e) for __e in __d_items]
         justify: Optional[str] = __d_justify
         inset: Optional[bool] = __d_inset
         width: Optional[str] = __d_width
         visible: Optional[bool] = __d_visible
+        name: Optional[str] = __d_name
         return Stats(
             items,
             justify,
             inset,
             width,
             visible,
+            name,
         )
 
 
@@ -8206,6 +8265,65 @@ class ChatCard:
         )
 
 
+class ChatSuggestion:
+    """Create a chat prompt suggestion displayed as button below the last response in the chatbot component.
+    """
+    def __init__(
+            self,
+            name: str,
+            label: str,
+            caption: Optional[str] = None,
+            icon: Optional[str] = None,
+    ):
+        _guard_scalar('ChatSuggestion.name', name, (str,), True, False, False)
+        _guard_scalar('ChatSuggestion.label', label, (str,), False, False, False)
+        _guard_scalar('ChatSuggestion.caption', caption, (str,), False, True, False)
+        _guard_scalar('ChatSuggestion.icon', icon, (str,), False, True, False)
+        self.name = name
+        """An identifying name for this component."""
+        self.label = label
+        """The text displayed for this suggestion."""
+        self.caption = caption
+        """The caption displayed below the label."""
+        self.icon = icon
+        """The icon to be displayed for this suggestion."""
+
+    def dump(self) -> Dict:
+        """Returns the contents of this object as a dict."""
+        _guard_scalar('ChatSuggestion.name', self.name, (str,), True, False, False)
+        _guard_scalar('ChatSuggestion.label', self.label, (str,), False, False, False)
+        _guard_scalar('ChatSuggestion.caption', self.caption, (str,), False, True, False)
+        _guard_scalar('ChatSuggestion.icon', self.icon, (str,), False, True, False)
+        return _dump(
+            name=self.name,
+            label=self.label,
+            caption=self.caption,
+            icon=self.icon,
+        )
+
+    @staticmethod
+    def load(__d: Dict) -> 'ChatSuggestion':
+        """Creates an instance of this class using the contents of a dict."""
+        __d_name: Any = __d.get('name')
+        _guard_scalar('ChatSuggestion.name', __d_name, (str,), True, False, False)
+        __d_label: Any = __d.get('label')
+        _guard_scalar('ChatSuggestion.label', __d_label, (str,), False, False, False)
+        __d_caption: Any = __d.get('caption')
+        _guard_scalar('ChatSuggestion.caption', __d_caption, (str,), False, True, False)
+        __d_icon: Any = __d.get('icon')
+        _guard_scalar('ChatSuggestion.icon', __d_icon, (str,), False, True, False)
+        name: str = __d_name
+        label: str = __d_label
+        caption: Optional[str] = __d_caption
+        icon: Optional[str] = __d_icon
+        return ChatSuggestion(
+            name,
+            label,
+            caption,
+            icon,
+        )
+
+
 class ChatbotCard:
     """Create a chatbot card to allow getting prompts from users and providing them with LLM generated answers.
     """
@@ -8217,6 +8335,8 @@ class ChatbotCard:
             placeholder: Optional[str] = None,
             events: Optional[List[str]] = None,
             generating: Optional[bool] = None,
+            suggestions: Optional[List[ChatSuggestion]] = None,
+            disabled: Optional[bool] = None,
             commands: Optional[List[Command]] = None,
     ):
         _guard_scalar('ChatbotCard.box', box, (str,), False, False, False)
@@ -8224,6 +8344,8 @@ class ChatbotCard:
         _guard_scalar('ChatbotCard.placeholder', placeholder, (str,), False, True, False)
         _guard_vector('ChatbotCard.events', events, (str,), False, True, False)
         _guard_scalar('ChatbotCard.generating', generating, (bool,), False, True, False)
+        _guard_vector('ChatbotCard.suggestions', suggestions, (ChatSuggestion,), False, True, False)
+        _guard_scalar('ChatbotCard.disabled', disabled, (bool,), False, True, False)
         _guard_vector('ChatbotCard.commands', commands, (Command,), False, True, False)
         self.box = box
         """A string indicating how to place this component on the page."""
@@ -8234,9 +8356,13 @@ class ChatbotCard:
         self.placeholder = placeholder
         """Chat input box placeholder. Use for prompt examples."""
         self.events = events
-        """The events to capture on this chatbot. One of 'stop'."""
+        """The events to capture on this chatbot. One of 'stop' | 'scroll_up' | 'feedback' | 'suggestion'."""
         self.generating = generating
         """True to show a button to stop the text generation. Defaults to False."""
+        self.suggestions = suggestions
+        """Clickable prompt suggestions shown below the last response."""
+        self.disabled = disabled
+        """True if the user input should be disabled."""
         self.commands = commands
         """Contextual menu commands for this component."""
 
@@ -8247,6 +8373,8 @@ class ChatbotCard:
         _guard_scalar('ChatbotCard.placeholder', self.placeholder, (str,), False, True, False)
         _guard_vector('ChatbotCard.events', self.events, (str,), False, True, False)
         _guard_scalar('ChatbotCard.generating', self.generating, (bool,), False, True, False)
+        _guard_vector('ChatbotCard.suggestions', self.suggestions, (ChatSuggestion,), False, True, False)
+        _guard_scalar('ChatbotCard.disabled', self.disabled, (bool,), False, True, False)
         _guard_vector('ChatbotCard.commands', self.commands, (Command,), False, True, False)
         return _dump(
             view='chatbot',
@@ -8256,6 +8384,8 @@ class ChatbotCard:
             placeholder=self.placeholder,
             events=self.events,
             generating=self.generating,
+            suggestions=None if self.suggestions is None else [__e.dump() for __e in self.suggestions],
+            disabled=self.disabled,
             commands=None if self.commands is None else [__e.dump() for __e in self.commands],
         )
 
@@ -8273,6 +8403,10 @@ class ChatbotCard:
         _guard_vector('ChatbotCard.events', __d_events, (str,), False, True, False)
         __d_generating: Any = __d.get('generating')
         _guard_scalar('ChatbotCard.generating', __d_generating, (bool,), False, True, False)
+        __d_suggestions: Any = __d.get('suggestions')
+        _guard_vector('ChatbotCard.suggestions', __d_suggestions, (dict,), False, True, False)
+        __d_disabled: Any = __d.get('disabled')
+        _guard_scalar('ChatbotCard.disabled', __d_disabled, (bool,), False, True, False)
         __d_commands: Any = __d.get('commands')
         _guard_vector('ChatbotCard.commands', __d_commands, (dict,), False, True, False)
         box: str = __d_box
@@ -8281,6 +8415,8 @@ class ChatbotCard:
         placeholder: Optional[str] = __d_placeholder
         events: Optional[List[str]] = __d_events
         generating: Optional[bool] = __d_generating
+        suggestions: Optional[List[ChatSuggestion]] = None if __d_suggestions is None else [ChatSuggestion.load(__e) for __e in __d_suggestions]
+        disabled: Optional[bool] = __d_disabled
         commands: Optional[List[Command]] = None if __d_commands is None else [Command.load(__e) for __e in __d_commands]
         return ChatbotCard(
             box,
@@ -8289,6 +8425,8 @@ class ChatbotCard:
             placeholder,
             events,
             generating,
+            suggestions,
+            disabled,
             commands,
         )
 
@@ -9608,11 +9746,13 @@ class MarkdownCard:
             title: str,
             content: str,
             data: Optional[PackedRecord] = None,
+            compact: Optional[bool] = None,
             commands: Optional[List[Command]] = None,
     ):
         _guard_scalar('MarkdownCard.box', box, (str,), False, False, False)
         _guard_scalar('MarkdownCard.title', title, (str,), False, False, False)
         _guard_scalar('MarkdownCard.content', content, (str,), False, False, False)
+        _guard_scalar('MarkdownCard.compact', compact, (bool,), False, True, False)
         _guard_vector('MarkdownCard.commands', commands, (Command,), False, True, False)
         self.box = box
         """A string indicating how to place this component on the page."""
@@ -9622,6 +9762,8 @@ class MarkdownCard:
         """The markdown content. Supports Github Flavored Markdown (GFM): https://guides.github.com/features/mastering-markdown/"""
         self.data = data
         """Additional data for the card."""
+        self.compact = compact
+        """Make spacing tighter. Defaults to True."""
         self.commands = commands
         """Contextual menu commands for this component."""
 
@@ -9630,6 +9772,7 @@ class MarkdownCard:
         _guard_scalar('MarkdownCard.box', self.box, (str,), False, False, False)
         _guard_scalar('MarkdownCard.title', self.title, (str,), False, False, False)
         _guard_scalar('MarkdownCard.content', self.content, (str,), False, False, False)
+        _guard_scalar('MarkdownCard.compact', self.compact, (bool,), False, True, False)
         _guard_vector('MarkdownCard.commands', self.commands, (Command,), False, True, False)
         return _dump(
             view='markdown',
@@ -9637,6 +9780,7 @@ class MarkdownCard:
             title=self.title,
             content=self.content,
             data=self.data,
+            compact=self.compact,
             commands=None if self.commands is None else [__e.dump() for __e in self.commands],
         )
 
@@ -9650,18 +9794,22 @@ class MarkdownCard:
         __d_content: Any = __d.get('content')
         _guard_scalar('MarkdownCard.content', __d_content, (str,), False, False, False)
         __d_data: Any = __d.get('data')
+        __d_compact: Any = __d.get('compact')
+        _guard_scalar('MarkdownCard.compact', __d_compact, (bool,), False, True, False)
         __d_commands: Any = __d.get('commands')
         _guard_vector('MarkdownCard.commands', __d_commands, (dict,), False, True, False)
         box: str = __d_box
         title: str = __d_title
         content: str = __d_content
         data: Optional[PackedRecord] = __d_data
+        compact: Optional[bool] = __d_compact
         commands: Optional[List[Command]] = None if __d_commands is None else [Command.load(__e) for __e in __d_commands]
         return MarkdownCard(
             box,
             title,
             content,
             data,
+            compact,
             commands,
         )
 
@@ -12684,15 +12832,19 @@ class TallStatsCard:
             self,
             box: str,
             items: List[Stat],
+            name: Optional[str] = None,
             commands: Optional[List[Command]] = None,
     ):
         _guard_scalar('TallStatsCard.box', box, (str,), False, False, False)
         _guard_vector('TallStatsCard.items', items, (Stat,), False, False, False)
+        _guard_scalar('TallStatsCard.name', name, (str,), False, True, False)
         _guard_vector('TallStatsCard.commands', commands, (Command,), False, True, False)
         self.box = box
         """A string indicating how to place this component on the page."""
         self.items = items
         """The individual stats to be displayed."""
+        self.name = name
+        """An identifying name for this component."""
         self.commands = commands
         """Contextual menu commands for this component."""
 
@@ -12700,11 +12852,13 @@ class TallStatsCard:
         """Returns the contents of this object as a dict."""
         _guard_scalar('TallStatsCard.box', self.box, (str,), False, False, False)
         _guard_vector('TallStatsCard.items', self.items, (Stat,), False, False, False)
+        _guard_scalar('TallStatsCard.name', self.name, (str,), False, True, False)
         _guard_vector('TallStatsCard.commands', self.commands, (Command,), False, True, False)
         return _dump(
             view='tall_stats',
             box=self.box,
             items=[__e.dump() for __e in self.items],
+            name=self.name,
             commands=None if self.commands is None else [__e.dump() for __e in self.commands],
         )
 
@@ -12715,14 +12869,18 @@ class TallStatsCard:
         _guard_scalar('TallStatsCard.box', __d_box, (str,), False, False, False)
         __d_items: Any = __d.get('items')
         _guard_vector('TallStatsCard.items', __d_items, (dict,), False, False, False)
+        __d_name: Any = __d.get('name')
+        _guard_scalar('TallStatsCard.name', __d_name, (str,), False, True, False)
         __d_commands: Any = __d.get('commands')
         _guard_vector('TallStatsCard.commands', __d_commands, (dict,), False, True, False)
         box: str = __d_box
         items: List[Stat] = [Stat.load(__e) for __e in __d_items]
+        name: Optional[str] = __d_name
         commands: Optional[List[Command]] = None if __d_commands is None else [Command.load(__e) for __e in __d_commands]
         return TallStatsCard(
             box,
             items,
+            name,
             commands,
         )
 

h2o_wave/ui.py

@@ -58,6 +58,8 @@ def command(
         icon: Optional[str] = None,
         items: Optional[List[Command]] = None,
         value: Optional[str] = None,
+        path: Optional[str] = None,
+        download: Optional[bool] = None,
 ) -> Command:
     """Create a command.
 
@@ -70,6 +72,8 @@ def command(
         icon: The icon to be displayed for this command.
         items: Sub-commands, if any
         value: Data associated with this command, if any.
+        path: The path or URL to link to. The 'items' and 'value' props are ignored when specified.
+        download: True if the link should prompt the user to save the linked URL instead of navigating to it.
     Returns:
         A `h2o_wave.types.Command` instance.
     """
@@ -80,6 +84,8 @@ def command(
         icon,
         items,
         value,
+        path,
+        download,
     )
 
 
@@ -398,6 +404,7 @@ def textbox(
         visible: Optional[bool] = None,
         tooltip: Optional[str] = None,
         spellcheck: Optional[bool] = None,
+        type: Optional[str] = None,
 ) -> Component:
     """Create a text box.
 
@@ -426,6 +433,7 @@ def textbox(
         visible: True if the component should be visible. Defaults to True.
         tooltip: An optional tooltip message displayed when a user clicks the help icon to the right of the component.
         spellcheck: True if the text may be checked for spelling errors. Defaults to True.
+        type: Keyboard to be shown on mobile devices. Defaults to 'text'. One of 'text', 'number', 'tel'. See enum h2o_wave.ui.TextboxType.
     Returns:
         A `h2o_wave.types.Textbox` instance.
     """
@@ -450,6 +458,7 @@ def textbox(
         visible,
         tooltip,
         spellcheck,
+        type,
     ))
 
 
@@ -2156,6 +2165,7 @@ def stat(
         caption: Optional[str] = None,
         icon: Optional[str] = None,
         icon_color: Optional[str] = None,
+        name: Optional[str] = None,
 ) -> Stat:
     """Create a stat (a label-value pair) for displaying a metric.
 
@@ -2165,6 +2175,7 @@ def stat(
         caption: The caption displayed below the primary value.
         icon: An optional icon, displayed next to the label.
         icon_color: The color of the icon.
+        name: An identifying name for this item.
     Returns:
         A `h2o_wave.types.Stat` instance.
     """
@@ -2174,6 +2185,7 @@ def stat(
         caption,
         icon,
         icon_color,
+        name,
     )
 
 
@@ -2183,6 +2195,7 @@ def stats(
         inset: Optional[bool] = None,
         width: Optional[str] = None,
         visible: Optional[bool] = None,
+        name: Optional[str] = None,
 ) -> Component:
     """Create a set of stats laid out horizontally.
 
@@ -2192,6 +2205,7 @@ def stats(
         inset: Whether to display the stats with a contrasting background.
         width: The width of the stats, e.g. '100px'.
         visible: True if the component should be visible. Defaults to True.
+        name: An identifying name for this component.
     Returns:
         A `h2o_wave.types.Stats` instance.
     """
@@ -2201,6 +2215,7 @@ def stats(
         inset,
         width,
         visible,
+        name,
     ))
 
 
@@ -2869,6 +2884,30 @@ def chat_card(
     )
 
 
+def chat_suggestion(
+        name: str,
+        label: str,
+        caption: Optional[str] = None,
+        icon: Optional[str] = None,
+) -> ChatSuggestion:
+    """Create a chat prompt suggestion displayed as button below the last response in the chatbot component.
+
+    Args:
+        name: An identifying name for this component.
+        label: The text displayed for this suggestion.
+        caption: The caption displayed below the label.
+        icon: The icon to be displayed for this suggestion.
+    Returns:
+        A `h2o_wave.types.ChatSuggestion` instance.
+    """
+    return ChatSuggestion(
+        name,
+        label,
+        caption,
+        icon,
+    )
+
+
 def chatbot_card(
         box: str,
         name: str,
@@ -2876,6 +2915,8 @@ def chatbot_card(
         placeholder: Optional[str] = None,
         events: Optional[List[str]] = None,
         generating: Optional[bool] = None,
+        suggestions: Optional[List[ChatSuggestion]] = None,
+        disabled: Optional[bool] = None,
         commands: Optional[List[Command]] = None,
 ) -> ChatbotCard:
     """Create a chatbot card to allow getting prompts from users and providing them with LLM generated answers.
@@ -2885,8 +2926,10 @@ def chatbot_card(
         name: An identifying name for this component.
         data: Chat messages data. Requires cyclic buffer.
         placeholder: Chat input box placeholder. Use for prompt examples.
-        events: The events to capture on this chatbot. One of 'stop'.
+        events: The events to capture on this chatbot. One of 'stop' | 'scroll_up' | 'feedback' | 'suggestion'.
         generating: True to show a button to stop the text generation. Defaults to False.
+        suggestions: Clickable prompt suggestions shown below the last response.
+        disabled: True if the user input should be disabled.
         commands: Contextual menu commands for this component.
     Returns:
         A `h2o_wave.types.ChatbotCard` instance.
@@ -2898,6 +2941,8 @@ def chatbot_card(
         placeholder,
         events,
         generating,
+        suggestions,
+        disabled,
         commands,
     )
 
@@ -3388,6 +3433,7 @@ def markdown_card(
         title: str,
         content: str,
         data: Optional[PackedRecord] = None,
+        compact: Optional[bool] = None,
         commands: Optional[List[Command]] = None,
 ) -> MarkdownCard:
     """Create a card that renders Markdown content.
@@ -3402,6 +3448,7 @@ def markdown_card(
         title: The title for this card.
         content: The markdown content. Supports Github Flavored Markdown (GFM): https://guides.github.com/features/mastering-markdown/
         data: Additional data for the card.
+        compact: Make spacing tighter. Defaults to True.
         commands: Contextual menu commands for this component.
     Returns:
         A `h2o_wave.types.MarkdownCard` instance.
@@ -3411,6 +3458,7 @@ def markdown_card(
         title,
         content,
         data,
+        compact,
         commands,
     )
 
@@ -4501,6 +4549,7 @@ def tall_series_stat_card(
 def tall_stats_card(
         box: str,
         items: List[Stat],
+        name: Optional[str] = None,
         commands: Optional[List[Command]] = None,
 ) -> TallStatsCard:
     """Create a vertical label-value pairs collection. Icon in `ui.stat` is not yet supported in this card.
@@ -4508,6 +4557,7 @@ def tall_stats_card(
     Args:
         box: A string indicating how to place this component on the page.
         items: The individual stats to be displayed.
+        name: An identifying name for this component.
         commands: Contextual menu commands for this component.
     Returns:
         A `h2o_wave.types.TallStatsCard` instance.
@@ -4515,6 +4565,7 @@ def tall_stats_card(
     return TallStatsCard(
         box,
         items,
+        name,
         commands,
     )
 

h2o_wave/version.py

@@ -1 +1 @@
-__version__ = '1.0.2'
+__version__ = '1.1.0'

{h2o_wave-1.0.2.dist-info → h2o_wave-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: h2o-wave
-Version: 1.0.2
+Version: 1.1.0
 Summary: Python driver for H2O Wave Realtime Apps
 Project-URL: Homepage, https://wave.h2o.ai/
 Project-URL: Documentation, https://wave.h2o.ai/

{h2o_wave-1.0.2.dist-info → h2o_wave-1.1.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 h2o_wave/__init__.py,sha256=XIclw-HLtXgr0wNf5eQpkh6ZiqD9QAoiS-vZhp3IR5k,1674
 h2o_wave/__main__.py,sha256=MoNOW43ppIqCdY3iq0n25Q3SKLyk8Igg5fD_sSROK4c,638
-h2o_wave/cli.py,sha256=KPcHXIYdxoc5DMIHsyVSNgC1I9JgqJRtkpO0vEGwv_8,13424
+h2o_wave/cli.py,sha256=XZVNSF5vPq3EVhZs_Q0Jq1t8stTF4BdbTvZIQmEIsgE,13603
 h2o_wave/core.py,sha256=whFb-Z2wokNXe_39I8aL3i7JOx6eczRfWOkn5wb_YwM,39087
 h2o_wave/db.py,sha256=H3W_EyMfnwr4UjqPVoAsE19O2QzY1ptIYGMOqU0YUQo,7489
 h2o_wave/graphics.py,sha256=HLYrX-lwsMKbyLmy2ClG5L46DA2_hSCEPTsv0gPVoyg,25866
@@ -11,12 +11,12 @@ h2o_wave/routing.py,sha256=de8GVfUAb6bwFXtsWj6NXmjMVGELknlZb03F-R4ManY,10592
 h2o_wave/server.py,sha256=u80Jma83mMKqmTitVDFO703SrcC4Y29DQM2letSVNyA,17900
 h2o_wave/share.py,sha256=2zgywet8540O6xM-JD3po1glyP2PBJ3lIxaWBJbQvtQ,1164
 h2o_wave/test.py,sha256=hF_fS5e25bACnzENjpDrikv7nPOs0iENh4MuXX9BaVA,2738
-h2o_wave/types.py,sha256=PKvvwDeQj9dqRyIwUVRtQpmnPVF0TI3gkLn8M4i7Y4E,645052
-h2o_wave/ui.py,sha256=mJzYyqWsZ-_6dmwPdG8rdPRsIdtD3x_NS1jz1l1SJRg,168352
+h2o_wave/types.py,sha256=fRFrMuD2NBPk1IMTzv2iIj244sijX-h8yxFWTj54PNk,652613
+h2o_wave/ui.py,sha256=AklwDapMW7o4UZJR04Ttk4dUTLI7NLIZr5RWZbsoXW8,170275
 h2o_wave/ui_ext.py,sha256=zx_2Ec2-p_ztm8brfVaVF0fTQWVDrb_YxcGfVb-wA10,2325
-h2o_wave/version.py,sha256=ZTipNH6wyC6qsq1H_lZsvJyVruUa1nu3y4EysMdkpuU,22
-h2o_wave-1.0.2.dist-info/METADATA,sha256=xZ-m3YPkGcTVwVoOxWkPDmJUha7_LYZRJuwdNdoVJ8I,2907
-h2o_wave-1.0.2.dist-info/WHEEL,sha256=TJPnKdtrSue7xZ_AVGkp9YXcvDrobsjBds1du3Nx6dc,87
-h2o_wave-1.0.2.dist-info/entry_points.txt,sha256=kFeXNqSZlW1_H7YcRdSOhz5V00F4vhDQ0NuDuvRwLGw,43
-h2o_wave-1.0.2.dist-info/licenses/LICENSE,sha256=hpuFayniDwysSKD0tHGELH2KJDVyhUrKS29torRIpqY,53
-h2o_wave-1.0.2.dist-info/RECORD,,
+h2o_wave/version.py,sha256=b6-WiVk0Li5MaV2rBnHYl104TsouINojSWKqHDas0js,22
+h2o_wave-1.1.0.dist-info/METADATA,sha256=lIFqYw_ngy4IH4LoD034Qn-kYXO5yQs50hr1CVQXyc8,2907
+h2o_wave-1.1.0.dist-info/WHEEL,sha256=TJPnKdtrSue7xZ_AVGkp9YXcvDrobsjBds1du3Nx6dc,87
+h2o_wave-1.1.0.dist-info/entry_points.txt,sha256=kFeXNqSZlW1_H7YcRdSOhz5V00F4vhDQ0NuDuvRwLGw,43
+h2o_wave-1.1.0.dist-info/licenses/LICENSE,sha256=hpuFayniDwysSKD0tHGELH2KJDVyhUrKS29torRIpqY,53
+h2o_wave-1.1.0.dist-info/RECORD,,