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,42 @@
+"""Dependency-free Feishu/Lark management contract."""
+
+from nanobot.channels._manifest import DIRECT_GROUP_POLICIES, field, required_fields
+from nanobot.channels.contracts import ChannelSetupSpec
+from nanobot.channels.feishu.instances import FEISHU_MANAGEMENT
+from nanobot.channels.feishu.validation import validate
+from nanobot.channels.plugin import ChannelPlugin
+
+SETUP_SPEC = ChannelSetupSpec(
+    fields={
+        "appId": field(snapshot=False),
+        "appSecret": field("secret", snapshot=False),
+        "domain": field(
+            "enum",
+            choices={"feishu", "lark"},
+            default="feishu",
+            snapshot=False,
+        ),
+        "groupPolicy": field(
+            "enum",
+            choices=DIRECT_GROUP_POLICIES,
+            default="mention",
+            snapshot=False,
+        ),
+        "allowFrom": field("list", snapshot=False),
+        "topicIsolation": field("bool", default=True, snapshot=False),
+    },
+    required=required_fields("appId", "appSecret"),
+    official_url="https://open.feishu.cn/app",
+    validator=validate,
+)
+
+PLUGIN = ChannelPlugin(
+    name="feishu",
+    display_name="Feishu",
+    runtime=f"{__package__}.runtime:FeishuChannel",
+    connector=f"{__package__}.connect:FeishuConnectStore",
+    setup=SETUP_SPEC,
+    management=FEISHU_MANAGEMENT,
+    dependencies=("lark-oapi>=1.5.0,<2.0.0",),
+    webui="webui/index.tsx",
+)