@downcity/plugins 1.0.57 → 1.0.60

package/bin/auth/Plugin.d.ts

@@ -1,17 +0,0 @@
-/**
- * ChatAuthorizationPlugin。
- *
- * 关键点（中文）
- * - chat-authorization 是内建且必需的 plugin，不走可选启停语义。
- * - 静态授权配置与动态观测态都收敛在项目 `.downcity/chat/authorization/`。
- * - 它只负责聊天主体授权，不负责 Town HTTP Bearer token 或路由访问鉴权。
- */
-import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
-/**
- * ChatAuthorizationPlugin：统一承载聊天用户授权能力。
- */
-export declare class ChatAuthorizationPlugin extends BasePlugin {
-    readonly name = "chat-authorization";
-    constructor();
-}
-//# sourceMappingURL=Plugin.d.ts.map

package/bin/auth/Plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/auth/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAyNhF;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,QAAQ,CAAC,IAAI,wBAAkC;;CAMhD"}

package/bin/auth/Plugin.js

@@ -1,199 +0,0 @@
-/**
- * ChatAuthorizationPlugin。
- *
- * 关键点（中文）
- * - chat-authorization 是内建且必需的 plugin，不走可选启停语义。
- * - 静态授权配置与动态观测态都收敛在项目 `.downcity/chat/authorization/`。
- * - 它只负责聊天主体授权，不负责 Town HTTP Bearer token 或路由访问鉴权。
- */
-import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
-import { CHAT_PLUGIN_POINTS } from "../chat/runtime/PluginPoints.js";
-import { CHAT_AUTHORIZATION_ACTIONS, CHAT_AUTHORIZATION_CATALOG, CHAT_AUTHORIZATION_PLUGIN_NAME, } from "../auth/types/AuthPlugin.js";
-import { readChatAuthorizationConfig, setChatAuthorizationUserRole, writeChatAuthorizationConfig, } from "../auth/runtime/AuthorizationConfig.js";
-import { evaluateIncomingChatAuthorization, resolveAuthorizedUserRole, } from "../auth/runtime/AuthorizationPolicy.js";
-import { readAuthorizationSnapshot, recordObservedAuthorizationPrincipal, } from "../auth/runtime/AuthorizationStore.js";
-function toChannel(value) {
-    const text = String(value || "").trim().toLowerCase();
-    if (text === "telegram" || text === "feishu" || text === "qq")
-        return text;
-    return null;
-}
-function toRecord(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return {};
-    return value;
-}
-function toEvaluateInput(payload) {
-    const channel = toChannel(payload.channel);
-    if (!channel) {
-        throw new Error("chat-authorization.authorize_incoming requires a valid channel");
-    }
-    return {
-        channel,
-        chatId: String(payload.chatId || "").trim(),
-        ...(typeof payload.chatType === "string" ? { chatType: payload.chatType.trim() } : {}),
-        ...(typeof payload.userId === "string" ? { userId: payload.userId.trim() } : {}),
-        ...(typeof payload.username === "string" ? { username: payload.username.trim() } : {}),
-        ...(typeof payload.chatTitle === "string" ? { chatTitle: payload.chatTitle.trim() } : {}),
-    };
-}
-function toSnapshotData(snapshot) {
-    return {
-        catalog: CHAT_AUTHORIZATION_CATALOG,
-        config: snapshot.config,
-        users: snapshot.users,
-        chats: snapshot.chats,
-    };
-}
-function createChatAuthorizationPluginDefinition() {
-    return {
-        name: CHAT_AUTHORIZATION_PLUGIN_NAME,
-        title: "Chat Access",
-        description: "Controls who can talk to the agent through chat platforms, records observed users and chats, and resolves each user's effective role for downstream service decisions.",
-        availability() {
-            return {
-                enabled: true,
-                available: true,
-                reasons: [],
-            };
-        },
-        hooks: {
-            guard: {
-                [CHAT_PLUGIN_POINTS.authorizeIncoming]: [
-                    async ({ context, value }) => {
-                        const input = value && typeof value === "object" && !Array.isArray(value)
-                            ? value
-                            : {};
-                        const evaluateInput = toEvaluateInput(input);
-                        const authorizationConfig = readChatAuthorizationConfig(context);
-                        const result = evaluateIncomingChatAuthorization({
-                            config: context.config,
-                            channel: evaluateInput.channel,
-                            input: evaluateInput,
-                            authorizationConfig,
-                        });
-                        if (result.decision !== "allow") {
-                            throw new Error(result.reason || "chat authorization blocked");
-                        }
-                    },
-                ],
-            },
-            effect: {
-                [CHAT_PLUGIN_POINTS.observePrincipal]: [
-                    async ({ context, value }) => {
-                        const input = toRecord(value);
-                        const channel = toChannel(input.channel);
-                        if (!channel) {
-                            throw new Error("chat.observePrincipal requires a valid channel");
-                        }
-                        await recordObservedAuthorizationPrincipal({
-                            context,
-                            channel,
-                            chatId: String(input.chatId || "").trim(),
-                            ...(typeof input.chatType === "string"
-                                ? { chatType: input.chatType.trim() }
-                                : {}),
-                            ...(typeof input.chatTitle === "string"
-                                ? { chatTitle: input.chatTitle.trim() }
-                                : {}),
-                            ...(typeof input.userId === "string"
-                                ? { userId: input.userId.trim() }
-                                : {}),
-                            ...(typeof input.username === "string"
-                                ? { username: input.username.trim() }
-                                : {}),
-                        });
-                    },
-                ],
-            },
-        },
-        resolves: {
-            [CHAT_PLUGIN_POINTS.resolveUserRole]: async ({ context, value }) => {
-                const input = value && typeof value === "object" && !Array.isArray(value)
-                    ? value
-                    : {};
-                const channel = toChannel(input.channel);
-                if (!channel) {
-                    throw new Error("chat.resolveUserRole requires a valid channel");
-                }
-                const role = resolveAuthorizedUserRole({
-                    channel,
-                    userId: String(input.userId || "").trim(),
-                    rootPath: context.rootPath,
-                });
-                return (role || null);
-            },
-        },
-        actions: {
-            [CHAT_AUTHORIZATION_ACTIONS.snapshot]: {
-                execute: async ({ context }) => {
-                    const snapshot = await readAuthorizationSnapshot({
-                        context,
-                    });
-                    return {
-                        success: true,
-                        data: toSnapshotData(snapshot),
-                    };
-                },
-            },
-            [CHAT_AUTHORIZATION_ACTIONS.readConfig]: {
-                execute: async ({ context }) => {
-                    return {
-                        success: true,
-                        data: readChatAuthorizationConfig(context),
-                    };
-                },
-            },
-            [CHAT_AUTHORIZATION_ACTIONS.writeConfig]: {
-                execute: async ({ context, payload }) => {
-                    const body = toRecord(payload);
-                    const nextConfig = body.config && typeof body.config === "object" && !Array.isArray(body.config)
-                        ? body.config
-                        : {};
-                    await writeChatAuthorizationConfig({
-                        context,
-                        nextConfig,
-                    });
-                    return {
-                        success: true,
-                        data: readChatAuthorizationConfig(context),
-                    };
-                },
-            },
-            [CHAT_AUTHORIZATION_ACTIONS.setUserRole]: {
-                execute: async ({ context, payload }) => {
-                    const body = toRecord(payload);
-                    const channel = toChannel(body.channel);
-                    if (!channel) {
-                        return {
-                            success: false,
-                            error: "set-user-role requires a valid channel",
-                            message: "set-user-role requires a valid channel",
-                        };
-                    }
-                    await setChatAuthorizationUserRole({
-                        context,
-                        channel,
-                        userId: String(body.userId || "").trim(),
-                        roleId: String(body.roleId || "").trim(),
-                    });
-                    return {
-                        success: true,
-                        data: readChatAuthorizationConfig(context),
-                    };
-                },
-            },
-        },
-    };
-}
-/**
- * ChatAuthorizationPlugin：统一承载聊天用户授权能力。
- */
-export class ChatAuthorizationPlugin extends BasePlugin {
-    name = CHAT_AUTHORIZATION_PLUGIN_NAME;
-    constructor() {
-        super();
-        Object.assign(this, createChatAuthorizationPluginDefinition());
-    }
-}
-//# sourceMappingURL=Plugin.js.map

package/bin/auth/Plugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/auth/Plugin.ts"],"names":[],"mappings":"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"}

package/bin/chat/ChatPluginTypes.d.ts

@@ -1,122 +0,0 @@
-/**
- * ChatPlugin SDK / runtime 配置类型。
- *
- * 关键点（中文）
- * - 这里定义 `new ChatPlugin({...})` 的显式注入接口。
- * - 构造参数只承载显式渠道配置与 queue 行为，不再承载自定义存储/解析器注入。
- * - 若未显式提供渠道凭据，ChatPlugin 会直接回退到默认全局账号池 `~/.downcity/downcity.db`。
- */
-import type { ChatQueueWorkerConfig } from "../chat/types/ChatQueueWorker.js";
-/**
- * Telegram 显式渠道配置。
- */
-export interface ChatPluginTelegramOptions {
-    /**
-     * 是否启用当前渠道。
-     *
-     * 说明（中文）
-     * - 省略时，若显式提供了 `botToken`，默认视为启用。
-     * - 传入 `false` 时会强制关闭，即使提供了凭据也不会启动。
-     */
-    enabled?: boolean;
-    /**
-     * Telegram Bot Token。
-     */
-    botToken: string;
-    /**
-     * 可选的显式账户 ID。
-     *
-     * 说明（中文）
-     * - 主要用于让上层产品把 runtime 渠道与自己的 account 池关联起来。
-     * - 省略时会使用 runtime 合成的临时 ID。
-     */
-    channelAccountId?: string;
-    /**
-     * 渠道展示名。
-     */
-    name?: string;
-}
-/**
- * Feishu 显式渠道配置。
- */
-export interface ChatPluginFeishuOptions {
-    /**
-     * 是否启用当前渠道。
-     */
-    enabled?: boolean;
-    /**
-     * Feishu / Lark App ID。
-     */
-    appId: string;
-    /**
-     * Feishu / Lark App Secret。
-     */
-    appSecret: string;
-    /**
-     * 可选的 Open API 域名。
-     */
-    domain?: string;
-    /**
-     * 可选的显式账户 ID。
-     */
-    channelAccountId?: string;
-    /**
-     * 渠道展示名。
-     */
-    name?: string;
-}
-/**
- * QQ 显式渠道配置。
- */
-export interface ChatPluginQqOptions {
-    /**
-     * 是否启用当前渠道。
-     */
-    enabled?: boolean;
-    /**
-     * QQ Bot App ID。
-     */
-    appId: string;
-    /**
-     * QQ Bot App Secret。
-     */
-    appSecret: string;
-    /**
-     * 是否使用 QQ 沙箱模式。
-     */
-    sandbox?: boolean;
-    /**
-     * 可选的显式账户 ID。
-     */
-    channelAccountId?: string;
-    /**
-     * 渠道展示名。
-     */
-    name?: string;
-}
-/**
- * ChatPlugin 显式构造参数。
- */
-export interface ChatPluginOptions {
-    /**
-     * Chat queue worker 运行配置。
-     *
-     * 说明（中文）
-     * - 显式传入时优先级高于 `downcity.json.plugins.chat.queue`。
-     * - 可用于不同 client 定制并发、突发合并等行为。
-     */
-    queue?: Partial<ChatQueueWorkerConfig>;
-    /**
-     * Telegram 渠道显式配置。
-     */
-    telegram?: ChatPluginTelegramOptions;
-    /**
-     * Feishu 渠道显式配置。
-     */
-    feishu?: ChatPluginFeishuOptions;
-    /**
-     * QQ 渠道显式配置。
-     */
-    qq?: ChatPluginQqOptions;
-}
-//# sourceMappingURL=ChatPluginTypes.d.ts.map

package/bin/chat/ChatPluginTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChatPluginTypes.d.ts","sourceRoot":"","sources":["../../src/chat/ChatPluginTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvC;;OAEG;IACH,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC;;OAEG;IACH,EAAE,CAAC,EAAE,mBAAmB,CAAC;CAC1B"}

package/bin/chat/ChatPluginTypes.js

@@ -1,10 +0,0 @@
-/**
- * ChatPlugin SDK / runtime 配置类型。
- *
- * 关键点（中文）
- * - 这里定义 `new ChatPlugin({...})` 的显式注入接口。
- * - 构造参数只承载显式渠道配置与 queue 行为，不再承载自定义存储/解析器注入。
- * - 若未显式提供渠道凭据，ChatPlugin 会直接回退到默认全局账号池 `~/.downcity/downcity.db`。
- */
-export {};
-//# sourceMappingURL=ChatPluginTypes.js.map

package/bin/chat/ChatPluginTypes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChatPluginTypes.js","sourceRoot":"","sources":["../../src/chat/ChatPluginTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/skill/types/ClaudeSkill.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClaudeSkill.d.ts","sourceRoot":"","sources":["../../../src/skill/types/ClaudeSkill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B"}

package/bin/skill/types/ClaudeSkill.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClaudeSkill.js","sourceRoot":"","sources":["../../../src/skill/types/ClaudeSkill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/src/auth/Plugin.ts

@@ -1,237 +0,0 @@
-/**
- * ChatAuthorizationPlugin。
- *
- * 关键点（中文）
- * - chat-authorization 是内建且必需的 plugin，不走可选启停语义。
- * - 静态授权配置与动态观测态都收敛在项目 `.downcity/chat/authorization/`。
- * - 它只负责聊天主体授权，不负责 Town HTTP Bearer token 或路由访问鉴权。
- */
-
-import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
-import type { Plugin } from "@downcity/agent/internal/plugin/types/Plugin.js";
-import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
-import { CHAT_PLUGIN_POINTS } from "@/chat/runtime/PluginPoints.js";
-import {
-  CHAT_AUTHORIZATION_ACTIONS,
-  CHAT_AUTHORIZATION_CATALOG,
-  CHAT_AUTHORIZATION_PLUGIN_NAME,
-  type ChatAuthorizationObservePrincipalPayload,
-  type ChatAuthorizationSetUserRolePayload,
-  type ChatAuthorizationWriteConfigPayload,
-  type ChatAuthorizationConfig,
-  type ChatAuthorizationEvaluateInput,
-  type ChatAuthorizationSnapshot,
-} from "@/auth/types/AuthPlugin.js";
-import {
-  readChatAuthorizationConfig,
-  setChatAuthorizationUserRole,
-  writeChatAuthorizationConfig,
-} from "@/auth/runtime/AuthorizationConfig.js";
-import {
-  evaluateIncomingChatAuthorization,
-  resolveAuthorizedUserRole,
-} from "@/auth/runtime/AuthorizationPolicy.js";
-import {
-  readAuthorizationSnapshot,
-  recordObservedAuthorizationPrincipal,
-} from "@/auth/runtime/AuthorizationStore.js";
-import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
-
-function toChannel(value: unknown): ChatDispatchChannel | null {
-  const text = String(value || "").trim().toLowerCase();
-  if (text === "telegram" || text === "feishu" || text === "qq") return text;
-  return null;
-}
-
-function toRecord(value: unknown): Record<string, unknown> {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
-  return value as Record<string, unknown>;
-}
-
-function toEvaluateInput(payload: Record<string, unknown>): ChatAuthorizationEvaluateInput {
-  const channel = toChannel(payload.channel);
-  if (!channel) {
-    throw new Error("chat-authorization.authorize_incoming requires a valid channel");
-  }
-  return {
-    channel,
-    chatId: String(payload.chatId || "").trim(),
-    ...(typeof payload.chatType === "string" ? { chatType: payload.chatType.trim() } : {}),
-    ...(typeof payload.userId === "string" ? { userId: payload.userId.trim() } : {}),
-    ...(typeof payload.username === "string" ? { username: payload.username.trim() } : {}),
-    ...(typeof payload.chatTitle === "string" ? { chatTitle: payload.chatTitle.trim() } : {}),
-  };
-}
-
-function toSnapshotData(snapshot: ChatAuthorizationSnapshot): JsonValue {
-  return {
-    catalog: CHAT_AUTHORIZATION_CATALOG as unknown as JsonValue,
-    config: snapshot.config as unknown as JsonValue,
-    users: snapshot.users as unknown as JsonValue,
-    chats: snapshot.chats as unknown as JsonValue,
-  };
-}
-
-function createChatAuthorizationPluginDefinition(): Plugin {
-  return {
-    name: CHAT_AUTHORIZATION_PLUGIN_NAME,
-    title: "Chat Access",
-    description:
-      "Controls who can talk to the agent through chat platforms, records observed users and chats, and resolves each user's effective role for downstream service decisions.",
-    availability() {
-      return {
-        enabled: true,
-        available: true,
-        reasons: [],
-      };
-    },
-    hooks: {
-      guard: {
-        [CHAT_PLUGIN_POINTS.authorizeIncoming]: [
-          async ({ context, value }) => {
-            const input =
-              value && typeof value === "object" && !Array.isArray(value)
-                ? (value as Record<string, unknown>)
-                : {};
-            const evaluateInput = toEvaluateInput(input);
-            const authorizationConfig = readChatAuthorizationConfig(context);
-            const result = evaluateIncomingChatAuthorization({
-              config: context.config,
-              channel: evaluateInput.channel,
-              input: evaluateInput,
-              authorizationConfig,
-            });
-            if (result.decision !== "allow") {
-              throw new Error(result.reason || "chat authorization blocked");
-            }
-          },
-        ],
-      },
-      effect: {
-        [CHAT_PLUGIN_POINTS.observePrincipal]: [
-          async ({ context, value }) => {
-            const input = toRecord(
-              value,
-            ) as unknown as ChatAuthorizationObservePrincipalPayload;
-            const channel = toChannel(input.channel);
-            if (!channel) {
-              throw new Error("chat.observePrincipal requires a valid channel");
-            }
-            await recordObservedAuthorizationPrincipal({
-              context,
-              channel,
-              chatId: String(input.chatId || "").trim(),
-              ...(typeof input.chatType === "string"
-                ? { chatType: input.chatType.trim() }
-                : {}),
-              ...(typeof input.chatTitle === "string"
-                ? { chatTitle: input.chatTitle.trim() }
-                : {}),
-              ...(typeof input.userId === "string"
-                ? { userId: input.userId.trim() }
-                : {}),
-              ...(typeof input.username === "string"
-                ? { username: input.username.trim() }
-                : {}),
-            });
-          },
-        ],
-      },
-    },
-    resolves: {
-      [CHAT_PLUGIN_POINTS.resolveUserRole]: async ({ context, value }) => {
-        const input =
-          value && typeof value === "object" && !Array.isArray(value)
-            ? (value as Record<string, unknown>)
-            : {};
-        const channel = toChannel(input.channel);
-        if (!channel) {
-          throw new Error("chat.resolveUserRole requires a valid channel");
-        }
-        const role = resolveAuthorizedUserRole({
-          channel,
-          userId: String(input.userId || "").trim(),
-          rootPath: context.rootPath,
-        });
-        return ((role || null) as unknown) as JsonValue;
-      },
-    },
-    actions: {
-      [CHAT_AUTHORIZATION_ACTIONS.snapshot]: {
-        execute: async ({ context }) => {
-          const snapshot = await readAuthorizationSnapshot({
-            context,
-          });
-          return {
-            success: true,
-            data: toSnapshotData(snapshot),
-          };
-        },
-      },
-      [CHAT_AUTHORIZATION_ACTIONS.readConfig]: {
-        execute: async ({ context }) => {
-          return {
-            success: true,
-            data: readChatAuthorizationConfig(context) as unknown as JsonValue,
-          };
-        },
-      },
-      [CHAT_AUTHORIZATION_ACTIONS.writeConfig]: {
-        execute: async ({ context, payload }) => {
-          const body = toRecord(
-            payload,
-          ) as unknown as ChatAuthorizationWriteConfigPayload;
-          const nextConfig =
-            body.config && typeof body.config === "object" && !Array.isArray(body.config)
-              ? (body.config as ChatAuthorizationConfig)
-              : {};
-          await writeChatAuthorizationConfig({
-            context,
-            nextConfig,
-          });
-          return {
-            success: true,
-            data: readChatAuthorizationConfig(context) as unknown as JsonValue,
-          };
-        },
-      },
-      [CHAT_AUTHORIZATION_ACTIONS.setUserRole]: {
-        execute: async ({ context, payload }) => {
-          const body = toRecord(
-            payload,
-          ) as unknown as ChatAuthorizationSetUserRolePayload;
-          const channel = toChannel(body.channel);
-          if (!channel) {
-            return {
-              success: false,
-              error: "set-user-role requires a valid channel",
-              message: "set-user-role requires a valid channel",
-            };
-          }
-          await setChatAuthorizationUserRole({
-            context,
-            channel,
-            userId: String(body.userId || "").trim(),
-            roleId: String(body.roleId || "").trim(),
-          });
-          return {
-            success: true,
-            data: readChatAuthorizationConfig(context) as unknown as JsonValue,
-          };
-        },
-      },
-    },
-  };
-}
-
-/**
- * ChatAuthorizationPlugin：统一承载聊天用户授权能力。
- */
-export class ChatAuthorizationPlugin extends BasePlugin {
-  readonly name = CHAT_AUTHORIZATION_PLUGIN_NAME;
-
-  constructor() {
-    super();
-    Object.assign(this, createChatAuthorizationPluginDefinition());
-  }
-}