refactor(channels): make built-in channels self-contained (#4908)

* refactor(channels): own setup and instance contracts * refactor(channels): isolate management contracts * refactor(channels): normalize activation contracts * fix(channels): enforce management contracts * refactor(channels): finish setup ownership migration * fix(channels): harden management contracts * fix(channels): enforce lazy loading and runtime ownership * fix(feishu): make multi-instance startup idempotent * fix(webui): render channel setup contracts cleanly * fix(feishu): stop websocket clients cleanly * fix(channels): enforce persistence and activation gates * fix(channels): preserve global feature action scope * fix(channels): apply defaults for single plugins * fix(channels): enforce management contract boundaries * refactor(feishu): remove identity helper indirection * fix(channels): preserve management setup contracts * refactor(channels): generalize instance settings UI * refactor(channels): package channel plugins with web UI metadata * refactor(channels): make built-ins self-contained packages * test(channels): colocate tests with channel packages * fix(dingtalk): use official brand icon * feat(channels): colocate webui translations * docs(channels): clarify plugin ownership * test(exec): remove output wait race * refactor(channels): unify plugin descriptors * fix(channels): enforce descriptor-owned contracts * refactor(channels): finish package-owned plugin setup * refactor(channels): use repository-owned packages only * fix(channels): self-describe dependencies and runtime state * fix(channels): warn about legacy entry points
2026-07-19 23:30:49 +08:00
parent 7aaac37bca
commit 462a0dfb0f
388 changed files with 17093 additions and 5110 deletions
@@ -0,0 +1,34 @@
+"""Feishu/Lark setup validation owned by the channel package."""
+
+from typing import Any
+
+from nanobot.channels.contracts import ChannelValidationContext
+from nanobot.channels.validation import check, payload, required_checks, string_value
+
+
+def validate(values: dict[str, Any], _context: ChannelValidationContext) -> dict[str, Any]:
+    checks, missing = required_checks("feishu", values)
+    display_name = string_value(values.get("displayName") or values.get("name"))
+    avatar_url = string_value(values.get("avatarUrl"))
+    app_id = string_value(values.get("appId"))
+    if app_id.startswith(("cli_", "oapi_")):
+        checks.append(check("app_id", "App ID", "pass", "A Feishu/Lark App ID is saved."))
+    elif app_id:
+        checks.append(
+            check(
+                "app_id",
+                "App ID",
+                "warn",
+                "App ID is saved, but it does not look like a standard Feishu App ID.",
+            )
+        )
+    status = "connected" if not missing else "needs_setup"
+    identity = {
+        "name": display_name or "Feishu assistant",
+        "avatar_url": avatar_url or None,
+        "account": app_id,
+    }
+    return payload("feishu", status, checks, identity=identity, missing_fields=missing)
+
+
+__all__ = ["validate"]