imperal-sdk 4.2.9__tar.gz → 4.2.11__tar.gz

{imperal_sdk-4.2.9 → imperal_sdk-4.2.11}/CHANGELOG.md

@@ -2,6 +2,54 @@
 
 All notable changes to `imperal-sdk` are documented here.
 
+## 4.2.11 — 2026-05-13
+
+**Fix: `ui.Link(text=...)` no longer breaks panel render**
+
+`ui.Link` now accepts the visible text via either `label=` (canonical) or
+`text=` (alias matching the HTML/JSX `<a>text</a>` mental model). Before
+v4.2.11, passing `text=` raised `TypeError: Link() got an unexpected
+keyword argument 'text'` at panel-render time, which killed the right
+panel for any extension that used the natural-looking kwarg.
+
+```python
+# All three are now equivalent
+ui.Link("Read docs", href="https://docs.imperal.io")           # positional
+ui.Link(label="Read docs", href="https://docs.imperal.io")     # canonical kwarg
+ui.Link(text="Read docs",  href="https://docs.imperal.io")     # alias kwarg
+```
+
+Calling `ui.Link()` with neither `label` nor `text` raises a clear
+`TypeError("ui.Link requires a 'label' (or 'text' alias)")` instead of
+silently rendering an empty anchor. `label` wins if both are passed.
+
+No migration required — existing `label=` callers are unchanged.
+
+## 4.2.10 — 2026-05-13
+
+**Feat: `@chat.function` default `chain_callable=True` for ALL action_types (was write/destructive only)**
+
+V19 federal default: `chain_callable` now defaults to `True` for read
+action_types too, not just `write` / `destructive`. This closes the
+wrapper-LLM paraphrase risk for typed read handlers (`list_*`,
+`search_*`, `get_*`) — when the classifier picks a read with concrete
+args, the kernel `chain_executor._resolve_typed_dispatch` dispatches
+the typed call directly instead of routing through the ChatExtension
+BYOLLM tool-use loop.
+
+Authors who need the wrapper-LLM tool-use loop for their handler
+(conversational catch-all like `case_chat`) must explicitly set
+`chain_callable=False`. The change is backward-compatible — existing
+manifests with explicit `True` / `False` are unaffected; only the
+implicit default for reads flips.
+
+Migration: run `imperal build` to regenerate manifests; read functions
+without explicit `chain_callable` will now emit `chain_callable: true`.
+
+Federal invariant: closes the wrapper-LLM paraphrase risk class for
+read intents, completing the `I-CHAT-FUNCTION-VERBATIM-PARAMS`
+structural enforcement.
+
 ## 4.2.9 — 2026-05-13
 
 **Fix: regenerate `src/imperal_sdk/schemas/imperal.schema.json` after SecretDecl addition**

{imperal_sdk-4.2.9 → imperal_sdk-4.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imperal-sdk
-Version: 4.2.9
+Version: 4.2.11
 Summary: SDK for building Imperal Cloud extensions
 Author: Valentin Scerbacov, Imperal, Inc.
 License-Expression: AGPL-3.0-or-later

{imperal_sdk-4.2.9 → imperal_sdk-4.2.11}/src/imperal_sdk/__init__.py

@@ -39,7 +39,7 @@ from imperal_sdk.secrets import (
     SecretValueTooLarge, SecretDeclarationConflict,
 )
 
-__version__ = "4.2.9"
+__version__ = "4.2.11"
 
 __all__ = [
     # Core

{imperal_sdk-4.2.9 → imperal_sdk-4.2.11}/src/imperal_sdk/chat/extension.py

@@ -147,7 +147,16 @@ class ChatExtension:
                 ``archive_drafts_in_project``.
         """
         if chain_callable is None:
-            chain_callable = action_type in ("write", "destructive")
+            # V19 (federal v4.2.10, 2026-05-13): default True for ALL
+            # action_types — reads also typed-dispatch when the classifier
+            # picked them, closing the wrapper-LLM paraphrase risk on
+            # `list_*`, `search_*`, `get_*` style handlers. Authors who
+            # need the wrapper-LLM tool-use loop (catch-all conversational
+            # handlers like `case_chat`) must set `chain_callable=False`
+            # explicitly. Pre-v4.2.10 default kept `False` for reads;
+            # backward-compatible because action_type in ("write",
+            # "destructive") already returned True and continues to.
+            chain_callable = True
 
         def decorator(func: Callable) -> Callable:
             # Auto-detect Pydantic BaseModel params + return type

{imperal_sdk-4.2.9 → imperal_sdk-4.2.11}/src/imperal_sdk/ui/interactive.py

@@ -73,9 +73,23 @@ def Tooltip(content: str, children: UINode | None = None) -> UINode:
     return UINode(type="Tooltip", props=props)
 
 
-def Link(label: str, href: str = "", on_click: UIAction | None = None) -> UINode:
-    """Hyperlink — navigates via href or fires on_click action."""
-    props: dict[str, Any] = {"label": label}
+def Link(
+    label: str = "",
+    href: str = "",
+    on_click: UIAction | None = None,
+    *,
+    text: str = "",
+) -> UINode:
+    """Hyperlink — navigates via href or fires on_click action.
+
+    The visible text can be passed as either ``label`` (canonical) or
+    ``text`` (alias matching the HTML/JSX `<a>text</a>` mental model).
+    Exactly one must be provided; ``label`` wins if both are set.
+    """
+    resolved = label or text
+    if not resolved:
+        raise TypeError("ui.Link requires a 'label' (or 'text' alias)")
+    props: dict[str, Any] = {"label": resolved}
     if href: props["href"] = href
     if on_click: props["on_click"] = on_click
     return UINode(type="Link", props=props)