imperal-sdk 4.2.4__tar.gz → 4.2.5__tar.gz

{imperal_sdk-4.2.4 → imperal_sdk-4.2.5}/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to `imperal-sdk` are documented here.
 
+## 4.2.5 — 2026-05-13
+
+**Fix: synthetic `__panel__*` tools excluded from validator tool_count + tests**
+
+v4.2.4 introduced an unconditional synthetic `secrets` panel via `Extension.__init__`,
+which auto-registers a `__panel__secrets` tool internally. The validator's `tool_count`
+logic was counting this synthetic tool as a user-authored tool, masking V3 ("at least
+one tool") error detection for extensions with zero user tools and inflating
+marketplace tool counts.
+
+### Fixed
+
+- **`validator.tool_count`** now excludes any tool whose name matches the
+  synthetic-prefix allowlist (`__panel__`, `__widget__`, `__tray__`, `__webhook__`).
+  These are platform-provided, not author-authored, and shouldn't count.
+- **`V3 "at least one tool"`** check now correctly fires for ext'ы with only
+  synthetic auto-registered tools.
+- `tests/test_panels.py::test_multiple_panels` updated to assert +1 for the
+  always-present synthetic `secrets` panel.
+
+### Notes
+
+- No behavior change for extensions with at least one real `@ext.tool` or
+  ChatExtension. Strict-tool-count-zero ext'ы now properly fail V3 again.
+- Marketplace tool counts shown to users no longer count synthetic panels.
+
 ## 4.2.4 — 2026-05-13
 
 **EXT-SECRETS-V1 — unconditional synthetic Secrets panel**

{imperal_sdk-4.2.4 → imperal_sdk-4.2.5}/PKG-INFO

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

{imperal_sdk-4.2.4 → imperal_sdk-4.2.5}/src/imperal_sdk/__init__.py

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

{imperal_sdk-4.2.4 → imperal_sdk-4.2.5}/src/imperal_sdk/validator.py

@@ -145,8 +145,17 @@ def validate_extension(ext) -> ValidationReport:
             fix="Set version to a valid semver string",
         ))
 
-    # Count registered @ext.tool entries
-    tools = getattr(ext, "_tools", {})
+    # Count registered @ext.tool entries. Exclude synthetic tools that the
+    # SDK auto-registers internally (e.g. __panel__secrets from the
+    # EXT-SECRETS-V1 unconditional synthetic Secrets panel, v4.2.4) — those
+    # are platform-provided, not user-authored, and shouldn't count toward
+    # V3 "at least one tool" or marketplace tool counts.
+    _all_tools = getattr(ext, "_tools", {})
+    _SYNTHETIC_PREFIXES = ("__panel__", "__widget__", "__tray__", "__webhook__")
+    tools = {
+        name: t for name, t in _all_tools.items()
+        if not any(name.startswith(p) for p in _SYNTHETIC_PREFIXES)
+    }
     report.tool_count = len(tools)
 
     # Collect all ChatExtension instances registered on this extension

{imperal_sdk-4.2.4 → imperal_sdk-4.2.5}/tests/test_panels.py

@@ -34,9 +34,12 @@ class TestPanelDecorator:
         async def left(ctx): pass
         @ext.panel("stats", slot="right", title="Right")
         async def right(ctx): pass
-        assert len(ext.panels) == 2
+        # +1 for the synthetic 'secrets' panel auto-injected by Extension.__init__
+        # (EXT-SECRETS-V1 v4.2.4) — see Extension._auto_register_secrets_panel.
+        assert len(ext.panels) == 3
         assert "sidebar" in ext.panels
         assert "stats" in ext.panels
+        assert "secrets" in ext.panels
 
     def test_default_slot(self):
         ext = Extension("test-app")