feat(M1): Universal-MiniApp-Registry — Plugin-Layer, permission fail-closed, Lifecycle, /api/v1/miniapps
Check Cross-Plugin Imports / check (push) Has been cancelled
Check Cross-Plugin Imports / check (push) Has been cancelled
- app/plugins/miniapp_registry.py: Registry aus kommunikation in Plugin-Layer gehoben (Plattform-Konzept, hosts chat/dashboard/window)
- MiniAppDef: permission (fail-closed) + settings_schema + col/row_span + hosts + component + order + builtin
- MiniAppContribution + FrontendDashboardWidget (Manifest-Schema) um M1-Felder erweitert — dashboard_widgets ist Alias von miniapps (ein Contribution-Typ, #359-Philosophie)
- BasePlugin.on_activate: automatische Manifest-Registrierung; on_deactivate: unregister_plugin (nur eigene Apps)
- GET /api/v1/miniapps (server-seitig permission-gefiltert, ?host=) + GET /api/v1/miniapps/{app_id} (403/404 fail-closed)
- kommunikation/miniapp_registry.py = Kompatibilitaets-Bruecke (Bestands-Importer unveraendert)
- Doku: api-documentation.md + plugin-development-guide.md (MiniApp-Beitragsmuster)
TDD: Rot 16 failed -> Gruen 16/16; Regressionen: contracts 23/23, lifecycle+route_order 4/4; ruff clean (M1-Dateien, Vorbestand per Stash bewiesen); create_app OK
This commit is contained in:
@@ -1,92 +1,25 @@
|
||||
"""Mini-App registry for plugin-provided interactive chat components."""
|
||||
"""Compatibility bridge — the MiniApp registry moved to the plugin layer.
|
||||
|
||||
The registry is a platform concept now (Phase M1): MiniApps are universal
|
||||
building blocks for Chat, Dashboard and Windows. This module re-exports the
|
||||
universal registry so every existing importer (kommunikation contracts,
|
||||
automation routes, tests) keeps working unchanged.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import logging
|
||||
from typing import Any
|
||||
from app.plugins.miniapp_registry import ( # noqa: F401
|
||||
DEFAULT_HOSTS,
|
||||
MiniAppDef,
|
||||
MiniAppRegistry,
|
||||
get_miniapp_registry,
|
||||
reset_miniapp_registry,
|
||||
)
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
|
||||
class MiniAppDef(BaseModel):
|
||||
"""Definition of a mini-app that plugins can register."""
|
||||
|
||||
app_id: str = Field(..., description="Unique app identifier")
|
||||
name: str = Field(..., description="Display name")
|
||||
icon: str = Field(default="app", description="Icon name")
|
||||
description: str = Field(default="", description="App description")
|
||||
plugin_name: str = Field(..., description="Plugin that registered this app")
|
||||
render_schema: dict[str, Any] = Field(
|
||||
default_factory=dict, description="JSON schema for frontend rendering"
|
||||
)
|
||||
|
||||
|
||||
class MiniAppRegistry:
|
||||
"""Registry for mini-apps that plugins provide for chat embedding."""
|
||||
|
||||
def __init__(self) -> None:
|
||||
self._apps: dict[str, MiniAppDef] = {}
|
||||
|
||||
def register(
|
||||
self,
|
||||
app_id: str,
|
||||
name: str,
|
||||
icon: str,
|
||||
description: str,
|
||||
plugin_name: str,
|
||||
render_schema: dict[str, Any] | None = None,
|
||||
) -> None:
|
||||
"""Register a mini-app."""
|
||||
app = MiniAppDef(
|
||||
app_id=app_id,
|
||||
name=name,
|
||||
icon=icon,
|
||||
description=description,
|
||||
plugin_name=plugin_name,
|
||||
render_schema=render_schema or {},
|
||||
)
|
||||
self._apps[app_id] = app
|
||||
logger.info(f"Mini-app registered: {app_id} by {plugin_name}")
|
||||
|
||||
def unregister(self, app_id: str) -> None:
|
||||
"""Unregister a mini-app."""
|
||||
app = self._apps.pop(app_id, None)
|
||||
if app:
|
||||
logger.info(f"Mini-app unregistered: {app_id}")
|
||||
|
||||
def unregister_plugin(self, plugin_name: str) -> None:
|
||||
"""Unregister all mini-apps from a specific plugin."""
|
||||
to_remove = [app_id for app_id, app in self._apps.items() if app.plugin_name == plugin_name]
|
||||
for app_id in to_remove:
|
||||
self._apps.pop(app_id, None)
|
||||
if to_remove:
|
||||
logger.info(f"Unregistered {len(to_remove)} mini-apps from plugin {plugin_name}")
|
||||
|
||||
def list_apps(self) -> list[dict[str, Any]]:
|
||||
"""List all available mini-apps for frontend."""
|
||||
return [app.model_dump() for app in self._apps.values()]
|
||||
|
||||
def get_app(self, app_id: str) -> MiniAppDef | None:
|
||||
"""Get a specific mini-app definition."""
|
||||
return self._apps.get(app_id)
|
||||
|
||||
|
||||
# ─── Singleton helpers ───
|
||||
|
||||
_registry: MiniAppRegistry | None = None
|
||||
|
||||
|
||||
def get_miniapp_registry() -> MiniAppRegistry:
|
||||
"""Return the shared singleton MiniAppRegistry instance."""
|
||||
global _registry
|
||||
if _registry is None:
|
||||
_registry = MiniAppRegistry()
|
||||
return _registry
|
||||
|
||||
|
||||
def reset_miniapp_registry() -> None:
|
||||
"""Reset the singleton instance (useful for tests)."""
|
||||
global _registry
|
||||
_registry = None
|
||||
__all__ = [
|
||||
"MiniAppDef",
|
||||
"MiniAppRegistry",
|
||||
"get_miniapp_registry",
|
||||
"reset_miniapp_registry",
|
||||
"DEFAULT_HOSTS",
|
||||
]
|
||||
|
||||
Reference in New Issue
Block a user