@downcity/plugins 1.0.153 → 1.0.156

package/src/chat/runtime/ChatChannelActions.ts

@@ -7,7 +7,11 @@
  * - 对外只暴露 action 级入口，供 ChatPluginActions 装配使用。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type {
+  AgentContext,
+  DowncityChatChannelConfig,
+  DowncityConfig,
+} from "@downcity/agent";
 import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
 import { getStoredChannelAccountSync } from "@/chat/accounts/Store.js";
 import type {
@@ -20,6 +24,7 @@ import type {
   ChatTestActionPayload,
 } from "@/chat/types/ChatPluginActionPayload.js";
 import type { ChatChannelTestResult } from "@/chat/types/ChannelStatus.js";
+import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
 import {
   describeChatChannelConfiguration,
   getChatChannelStatus,
@@ -49,6 +54,54 @@ function getChatRuntimeBindings(context: AgentContext): ChatRuntimeControlBindin
   return plugin as ChatRuntimeControlBindings;
 }
 
+/**
+ * 将 channel patch 合并进完整 plugins 配置并交给宿主持久化。
+ *
+ * 关键点（中文）
+ * - 始终写回完整 plugins 对象，避免覆盖其他 plugin 配置。
+ * - 宿主持久化成功后才更新当前 context 快照，保证运行态与存储态一致。
+ */
+async function persist_chat_channel_patches(params: {
+  context: AgentContext;
+  patches: Array<{
+    channel: ChatChannelName;
+    enabled?: boolean;
+    channel_account_id?: string | null;
+  }>;
+}): Promise<DowncityConfig["plugins"]> {
+  const current_plugins = params.context.config.plugins || {};
+  const current_chat = current_plugins.chat || {};
+  const next_channels = { ...(current_chat.channels || {}) };
+
+  for (const patch of params.patches) {
+    const current_channel = next_channels[patch.channel] || {};
+    const next_channel: DowncityChatChannelConfig = { ...current_channel };
+    if (typeof patch.enabled === "boolean") {
+      next_channel.enabled = patch.enabled;
+    }
+    if (Object.prototype.hasOwnProperty.call(patch, "channel_account_id")) {
+      const channel_account_id = String(patch.channel_account_id || "").trim();
+      if (channel_account_id) {
+        next_channel.channelAccountId = channel_account_id;
+      } else {
+        delete next_channel.channelAccountId;
+      }
+    }
+    next_channels[patch.channel] = next_channel;
+  }
+
+  const next_plugins: DowncityConfig["plugins"] = {
+    ...current_plugins,
+    chat: {
+      ...current_chat,
+      channels: next_channels,
+    },
+  };
+  await params.context.pluginConfig.persistProjectPlugins(next_plugins);
+  params.context.config.plugins = next_plugins;
+  return next_plugins;
+}
+
 /**
  * 执行 `chat.status` action。
  */
@@ -176,6 +229,10 @@ export async function executeChatOpenAction(params: {
 }) {
   const targets = resolveTargetChannels(params.payload.channel);
   const plugin = getChatRuntimeBindings(params.context);
+  await persist_chat_channel_patches({
+    context: params.context,
+    patches: targets.map((channel) => ({ channel, enabled: true })),
+  });
   for (const channel of targets) {
     plugin.applyChannelRuntimePatch({
       channel,
@@ -211,6 +268,10 @@ export async function executeChatCloseAction(params: {
 }) {
   const targets = resolveTargetChannels(params.payload.channel);
   const plugin = getChatRuntimeBindings(params.context);
+  await persist_chat_channel_patches({
+    context: params.context,
+    patches: targets.map((channel) => ({ channel, enabled: false })),
+  });
   for (const channel of targets) {
     await stopSingleChatChannel(params.state, channel);
     plugin.applyChannelRuntimePatch({
@@ -293,6 +354,16 @@ export async function executeChatConfigureAction(params: {
   }
 
   const plugin = getChatRuntimeBindings(params.context);
+  await persist_chat_channel_patches({
+    context: params.context,
+    patches: [{
+      channel,
+      ...(typeof patch.enabled === "boolean" ? { enabled: patch.enabled } : {}),
+      ...(Object.prototype.hasOwnProperty.call(patch, "channelAccountId")
+        ? { channel_account_id: String(patch.channelAccountId || "").trim() || null }
+        : {}),
+    }],
+  });
   plugin.applyChannelRuntimePatch({
     channel,
     ...(typeof patch.enabled === "boolean" ? { enabled: patch.enabled } : {}),

package/src/chat/runtime/ChatChannelConfig.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 渠道配置摘要、状态快照、patch 归一化都收敛在这里。
- * - chat.configure 的运行态写入由 ChatPlugin 实例承载，不再落盘到 downcity.json。
+ * - chat.configure 的配置持久化由宿主能力承载，运行态更新由 ChatPlugin 实例承载。
  * - 该模块不直接负责 action 流程控制，只提供可复用的底层能力。
  */
 
@@ -37,7 +37,7 @@ function toJsonObject(input: unknown): JsonObject {
  *
  * 关键点（中文）
  * - 不返回明文密钥，只返回布尔“是否已配置”。
- * - 字段命名尽量贴近 `downcity.json`，便于前端直接映射编辑。
+ * - 字段命名与 Agent 全局配置保持一致，便于前端直接映射编辑。
  */
 export function buildChatChannelConfigSummary(
   context: AgentContext,
@@ -194,7 +194,7 @@ export function normalizeChatChannelConfigPatch(params: {
   config: Record<string, JsonValue>;
 }): Record<string, string | number | boolean | null> {
   const configDefinition = getChatChannelConfiguration(params.channel);
-  const writableFields = configDefinition.getWritableShipFields();
+  const writableFields = configDefinition.get_writable_agent_config_fields();
   const patch: Record<string, string | number | boolean | null> = {};
 
   for (const field of writableFields) {

package/src/chat/runtime/ChatChannelCore.ts

@@ -101,7 +101,7 @@ export function resolveChannelAccountId(
  * 关键点（中文）
  * - 优先使用 ChatPlugin 实例上的显式解析逻辑。
  * - 若实例只提供 channelAccountId，再从默认全局账号池读取对应账号。
- * - 不再从 downcity.json 隐式推断运行时账号。
+ * - 不从项目文件隐式推断运行时账号。
  */
 export function resolveChannelAccount(
   context: AgentContext,

package/src/chat/runtime/ChatChannelLifecycle.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 渠道 bot 的创建、启动、停止逻辑统一收敛在这里。
  * - 渠道 bot 状态归属于 chat plugin runtime 实例持有的 `ChatChannelState`。
- * - 本模块不处理 downcity.json 写入，也不负责 action 输入输出包装。
+ * - 本模块不处理配置持久化，也不负责 action 输入输出包装。
  */
 
 import type { AgentContext } from "@downcity/agent";

package/src/chat/runtime/PluginPoints.ts

@@ -51,28 +51,4 @@ export const CHAT_PLUGIN_POINTS = {
    * - plugin 可在这里做统计、观测、调试落点。
    */
   afterEnqueue: "chat.afterEnqueue",
-  /**
-   * 观测入站主体信息。
-   *
-   * 说明（中文）
-   * - 仅做副作用记录，不返回值。
-   * - ChatPlugin 内置授权能力会使用该点记录主体快照。
-   */
-  observePrincipal: "chat.observePrincipal",
-  /**
-   * 判定当前入站消息是否允许执行。
-   *
-   * 说明（中文）
-   * - 由 chat plugin runtime 在 ingress 阶段显式调用。
-   * - ChatPlugin 内置授权能力会使用该点执行角色与权限判定。
-   */
-  authorizeIncoming: "chat.authorizeIncoming",
-  /**
-   * 解析当前用户角色。
-   *
-   * 说明（中文）
-   * - 主要用于在 history / queue metadata 中补齐授权上下文。
-   * - ChatPlugin 内置授权能力会使用该点补齐用户角色。
-   */
-  resolveUserRole: "chat.resolveUserRole",
 } as const;

package/src/chat/runtime/QueuedUserMessage.ts

@@ -43,8 +43,6 @@ export function buildQueuedUserMessageWithInfo(params: {
     `message_id: ${normalizeInfoValue(params.messageId || "unknown")}`,
     `user_id: ${normalizeInfoValue(params.userId || "unknown")}`,
     `username: ${normalizeInfoValue(params.username || "unknown")}`,
-    `role_id: ${normalizeInfoValue(params.roleId || "unknown")}`,
-    `permissions: ${normalizeInfoValue((params.permissions || []).join(",") || "none")}`,
     `received_at: ${normalizeInfoValue(receivedAtIso)}`,
     `received_at_local: ${normalizeInfoValue(formatDateTimeInTimezone(receivedAtDate, runtimeTimezone))}`,
     `runtime_timezone: ${normalizeInfoValue(runtimeTimezone)}`,

package/src/chat/types/ChannelConfiguration.ts

@@ -27,7 +27,7 @@ export type ChatChannelConfigurationFieldType =
  * 配置字段来源枚举。
  */
 export type ChatChannelConfigurationFieldSource =
-  | "ship_json"
+  | "agent_config"
   | "bot_account"
   | "env_fallback";
 
@@ -70,7 +70,7 @@ export interface ChatChannelConfigurationField {
    */
   type: ChatChannelConfigurationFieldType;
   /**
-   * 字段值来源（downcity.json / chat account / env fallback）。
+   * 字段值来源（Agent config / chat account / env fallback）。
    */
   source: ChatChannelConfigurationFieldSource;
   /**
@@ -145,9 +145,9 @@ export interface ChatChannelConfigurationDescriptor {
    */
   fields: {
     /**
-     * `downcity.json` 可声明字段。
+     * Agent 全局配置可声明字段。
      */
-    ship: ChatChannelConfigurationField[];
+    agent_config: ChatChannelConfigurationField[];
     /**
      * `channel_accounts` 字段。
      */

package/src/chat/types/ChatAccess.ts

@@ -0,0 +1,335 @@
+/**
+ * Chat Access 领域类型。
+ *
+ * 关键点（中文）
+ * - Chat Access 只负责外部聊天用户进入当前 Agent 前的准入判定。
+ * - 用户唯一身份由 channel、issuer、subject_id 共同确定。
+ * - `all` 仅用于管理命令输入，持久化时展开为 direct/group 两条明确记录。
+ */
+
+import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
+
+/** Chat Plugin 对外暴露的 Access Action。 */
+export const CHAT_ACCESS_ACTIONS = {
+  /** 读取 Principal、Grant 和 Request 快照。 */
+  snapshot: "access-snapshot",
+  /** 批准待处理 Request。 */
+  approve: "access-approve",
+  /** 拒绝待处理 Request。 */
+  deny: "access-deny",
+  /** 直接设置已知 Principal 的 Access。 */
+  set: "access-set",
+  /** 撤销已知 Principal 的 Access。 */
+  revoke: "access-revoke",
+} as const;
+
+/** Chat Access 支持的消息范围。 */
+export type ChatAccessScope = "direct" | "group";
+
+/** Chat Access 管理入口支持的范围。 */
+export type ChatAccessScopeInput = ChatAccessScope | "all";
+
+/** Chat Access Grant 效果。 */
+export type ChatAccessEffect = "allow" | "deny";
+
+/** Chat Access Request 状态。 */
+export type ChatAccessRequestStatus =
+  | "pending"
+  | "approved"
+  | "denied"
+  | "expired";
+
+/** Chat Access 判定原因。 */
+export type ChatAccessDecisionReason =
+  | "grant_allowed"
+  | "grant_denied"
+  | "request_pending"
+  | "identity_missing";
+
+/**
+ * Chat 平台提供的原始身份与消息来源。
+ */
+export interface ChatAccessIdentityInput {
+  /** 当前消息来源渠道。 */
+  channel: ChatDispatchChannel;
+  /** 当前 Bot/App 的稳定账号标识，不得包含密钥。 */
+  issuer: string;
+  /** 平台用户稳定 ID。 */
+  subject_id: string;
+  /** 用户展示名称。 */
+  display_name?: string;
+  /** 当前平台会话 ID。 */
+  chat_id: string;
+  /** 当前平台会话类型。 */
+  chat_type?: string;
+  /** 当前会话展示名称。 */
+  chat_title?: string;
+}
+
+/**
+ * Chat Access 内部规范化主体。
+ */
+export interface ChatAccessPrincipal {
+  /** 内部稳定主体 ID。 */
+  principal_id: string;
+  /** 当前主体来源渠道。 */
+  channel: ChatDispatchChannel;
+  /** 当前主体所在 Bot/App 账号边界。 */
+  issuer: string;
+  /** 平台用户稳定 ID。 */
+  subject_id: string;
+  /** 最近观测到的展示名称。 */
+  display_name?: string;
+  /** 首次观测时间。 */
+  first_seen_at: string;
+  /** 最近观测时间。 */
+  last_seen_at: string;
+  /** 最近发言会话 ID。 */
+  last_chat_id?: string;
+  /** 最近发言会话类型。 */
+  last_chat_type?: string;
+}
+
+/**
+ * Chat Access Grant。
+ */
+export interface ChatAccessGrant {
+  /** Grant 稳定 ID。 */
+  grant_id: string;
+  /** 关联主体 ID。 */
+  principal_id: string;
+  /** Grant 适用范围。 */
+  scope: ChatAccessScope;
+  /** Allow 或 Deny。 */
+  effect: ChatAccessEffect;
+  /** 执行该变更的可信操作者。 */
+  created_by: string;
+  /** 创建时间。 */
+  created_at: string;
+  /** 最近更新时间。 */
+  updated_at: string;
+}
+
+/**
+ * Chat Access Request。
+ */
+export interface ChatAccessRequest {
+  /** Request 稳定 ID。 */
+  request_id: string;
+  /** 关联主体 ID。 */
+  principal_id: string;
+  /** 请求准入范围。 */
+  scope: ChatAccessScope;
+  /** 触发请求的平台会话 ID。 */
+  chat_id: string;
+  /** 触发请求的平台会话类型。 */
+  chat_type: string;
+  /** 当前请求状态。 */
+  status: ChatAccessRequestStatus;
+  /** 解决该请求的可信操作者。 */
+  resolved_by?: string;
+  /** 创建时间。 */
+  created_at: string;
+  /** 最近一次重复请求时间。 */
+  last_requested_at: string;
+  /** 请求解决时间。 */
+  resolved_at?: string;
+}
+
+/**
+ * 带主体详情的请求展示项。
+ */
+export interface ChatAccessRequestView extends ChatAccessRequest {
+  /** 当前请求对应主体。 */
+  principal: ChatAccessPrincipal;
+}
+
+/**
+ * 带 Grant 的主体展示项。
+ */
+export interface ChatAccessPrincipalView {
+  /** 当前主体。 */
+  principal: ChatAccessPrincipal;
+  /** 当前主体所有 Grant。 */
+  grants: ChatAccessGrant[];
+}
+
+/**
+ * Chat Access 入站判定结果。
+ */
+export interface ChatAccessDecision {
+  /** 是否允许进入 Agent。 */
+  allowed: boolean;
+  /** 归一化主体 ID；身份缺失时为空字符串。 */
+  principal_id: string;
+  /** 当前消息对应范围。 */
+  scope: ChatAccessScope;
+  /** 稳定判定原因。 */
+  reason: ChatAccessDecisionReason;
+  /** 未批准时创建或复用的 Request ID。 */
+  request_id?: string;
+}
+
+/**
+ * 批准请求输入。
+ */
+export interface ApproveChatAccessRequestInput {
+  /** Request ID。 */
+  request_id: string;
+  /** 可选范围覆盖；默认使用请求自身范围。 */
+  scope?: ChatAccessScopeInput;
+  /** 执行批准的可信操作者。 */
+  operator: string;
+}
+
+/**
+ * 拒绝请求输入。
+ */
+export interface DenyChatAccessRequestInput {
+  /** Request ID。 */
+  request_id: string;
+  /** 可选范围覆盖；默认使用请求自身范围。 */
+  scope?: ChatAccessScopeInput;
+  /** 执行拒绝的可信操作者。 */
+  operator: string;
+}
+
+/**
+ * 撤销 Grant 输入。
+ */
+export interface RevokeChatAccessGrantInput {
+  /** Principal ID。 */
+  principal_id: string;
+  /** 要撤销的范围。 */
+  scope: ChatAccessScopeInput;
+  /** 执行撤销的可信操作者。 */
+  operator: string;
+}
+
+/** ChatAccessService 构造参数。 */
+export interface ChatAccessServiceOptions {
+  /** 当前 Agent 项目根目录。 */
+  project_root: string;
+}
+
+/** 直接设置 Principal Grant 的输入。 */
+export interface SetChatAccessPrincipalEffectInput {
+  /** Principal 稳定 ID。 */
+  principal_id: string;
+  /** 要设置的 Chat 消息范围。 */
+  scope: ChatAccessScopeInput;
+  /** 要写入的 Allow/Deny 效果。 */
+  effect: ChatAccessEffect;
+  /** 执行设置的可信操作者。 */
+  operator: string;
+}
+
+/** Store 新增或更新 Principal 的输入。 */
+export interface UpsertChatAccessPrincipalInput {
+  /** Principal 来源渠道。 */
+  channel: ChatDispatchChannel;
+  /** 当前 Bot/App 的稳定账号边界。 */
+  issuer: string;
+  /** 平台用户稳定 ID。 */
+  subject_id: string;
+  /** 最近观测到的展示名称。 */
+  display_name?: string;
+  /** 最近发言会话 ID。 */
+  chat_id?: string;
+  /** 最近发言会话类型。 */
+  chat_type?: string;
+  /** 迁移时提供的首次观测时间。 */
+  first_seen_at?: string;
+  /** 迁移时提供的最近观测时间。 */
+  last_seen_at?: string;
+}
+
+/** Store 新增或更新 Grant 的输入。 */
+export interface UpsertChatAccessGrantInput {
+  /** 关联 Principal 稳定 ID。 */
+  principal_id: string;
+  /** Grant 适用范围。 */
+  scope: ChatAccessScope;
+  /** Grant 的 Allow/Deny 效果。 */
+  effect: ChatAccessEffect;
+  /** 执行变更的可信操作者。 */
+  operator: string;
+}
+
+/** Store 创建或复用 Request 的输入。 */
+export interface CreateChatAccessRequestInput {
+  /** 关联 Principal 稳定 ID。 */
+  principal_id: string;
+  /** 请求准入范围。 */
+  scope: ChatAccessScope;
+  /** 触发请求的平台会话 ID。 */
+  chat_id: string;
+  /** 触发请求的平台会话类型。 */
+  chat_type?: string;
+}
+
+/** Store 创建或复用 Request 的结果。 */
+export interface CreateChatAccessRequestResult {
+  /** 创建或复用后的 Request。 */
+  request: ChatAccessRequest;
+  /** 本次是否创建了新 Request。 */
+  created: boolean;
+}
+
+/** Store 解决单个 Request 的输入。 */
+export interface ResolveChatAccessRequestStoreInput {
+  /** 要解决的 Request ID。 */
+  request_id: string;
+  /** Request 最终状态。 */
+  status: "approved" | "denied";
+  /** 执行操作的可信操作者。 */
+  operator: string;
+}
+
+/** Store 批量解决 Principal pending Request 的输入。 */
+export interface ResolvePendingChatAccessRequestsInput {
+  /** 关联 Principal 稳定 ID。 */
+  principal_id: string;
+  /** 要解决的明确范围集合。 */
+  scopes: ChatAccessScope[];
+  /** Request 最终状态。 */
+  status: "approved" | "denied";
+  /** 执行操作的可信操作者。 */
+  operator: string;
+}
+
+/** Store 写入审计事件的输入。 */
+export interface InsertChatAccessAuditEventInput {
+  /** 可选关联 Principal ID。 */
+  principal_id?: string;
+  /** 可选关联 Request ID。 */
+  request_id?: string;
+  /** 稳定审计动作名称。 */
+  action: string;
+  /** 可选 Chat 消息范围。 */
+  scope?: ChatAccessScope;
+  /** 可选判定或 Grant 效果。 */
+  decision?: string;
+  /** 可选可信操作者。 */
+  operator?: string;
+  /** 可选结构化审计详情。 */
+  detail?: Record<string, unknown>;
+}
+
+/**
+ * 请求列表过滤条件。
+ */
+export interface ListChatAccessRequestsInput {
+  /** 可选状态过滤。 */
+  status?: ChatAccessRequestStatus;
+}
+
+/**
+ * Chat Access 快照。
+ */
+export interface ChatAccessSnapshot {
+  /** 当前 Principal 列表。 */
+  principals: ChatAccessPrincipalView[];
+  /** 当前 Request 列表。 */
+  requests: ChatAccessRequestView[];
+}

package/src/chat/types/ChatPromptContext.ts

@@ -7,7 +7,6 @@
  * - 所有字段均保持可序列化，便于 system prompt 与入站消息文本复用。
  */
 
-import type { ChatAuthorizationPermission } from "@/auth/types/AuthPlugin.js";
 import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
 
 /**
@@ -103,22 +102,6 @@ export interface QueuedUserInfoInput {
    */
   username?: string;
 
-  /**
-   * 当前用户在授权系统中的角色 ID。
-   *
-   * 说明（中文）
-   * - 例如 `default`、`member`、`admin`。
-   */
-  roleId?: string;
-
-  /**
-   * 当前用户拥有的权限集合。
-   *
-   * 说明（中文）
-   * - 仅描述授权快照，不代表平台原生权限模型。
-   */
-  permissions?: ChatAuthorizationPermission[];
-
   /**
    * 当前消息接收时间。
    *

package/src/index.ts

@@ -32,18 +32,13 @@ export { WorkboardPlugin } from "./workboard/Plugin.js";
 export { TaskPlugin } from "./task/TaskPlugin.js";
 export { MemoryPlugin } from "./memory/MemoryPlugin.js";
 export {
-  listChatAuthorizationRoles,
-  readChatAuthorizationConfigSync,
-  setChatAuthorizationUserRole,
-} from "./auth/runtime/AuthorizationConfig.js";
-export { resolveAuthorizedUserRole } from "./auth/runtime/AuthorizationPolicy.js";
-export {
-  CHAT_AUTHORIZATION_ACTIONS,
-  CHAT_AUTHORIZATION_CHANNELS,
-  CHAT_AUTHORIZATION_POINTS,
-  createDefaultChatAuthorizationRoles,
-  isChatAuthorizationChannel,
-} from "./auth/types/AuthPlugin.js";
+  ChatAccessService,
+  is_chat_access_channel,
+  resolve_chat_access_scope,
+  resolve_chat_access_scopes,
+} from "./chat/access/ChatAccessService.js";
+export { get_chat_access_db_path } from "./chat/access/ChatAccessStore.js";
+export { CHAT_ACCESS_ACTIONS } from "./chat/types/ChatAccess.js";
 
 export type {
   ChatChannelAccountListItem,
@@ -121,22 +116,23 @@ export type {
   ImagePluginTextContent,
 } from "./image/types/ImagePlugin.js";
 export type {
-  ChatAuthorizationCatalog,
-  ChatAuthorizationChannel,
-  ChatAuthorizationConfig,
-  ChatAuthorizationDecision,
-  ChatAuthorizationEvaluateInput,
-  ChatAuthorizationEvaluateResult,
-  ChatAuthorizationObservePrincipalPayload,
-  ChatAuthorizationObservedChat,
-  ChatAuthorizationObservedUser,
-  ChatAuthorizationPermission,
-  ChatAuthorizationPermissionMeta,
-  ChatAuthorizationResolveUserRolePayload,
-  ChatAuthorizationRole,
-  ChatAuthorizationSetUserRolePayload,
-  ChatAuthorizationSnapshot,
-  ChatAuthorizationStateFile,
-  ChatAuthorizationWriteConfigPayload,
-  ChatChannelAuthorizationConfig,
-} from "./auth/types/AuthPlugin.js";
+  ApproveChatAccessRequestInput,
+  ChatAccessDecision,
+  ChatAccessDecisionReason,
+  ChatAccessEffect,
+  ChatAccessGrant,
+  ChatAccessIdentityInput,
+  ChatAccessPrincipal,
+  ChatAccessPrincipalView,
+  ChatAccessRequest,
+  ChatAccessRequestStatus,
+  ChatAccessRequestView,
+  ChatAccessScope,
+  ChatAccessScopeInput,
+  ChatAccessServiceOptions,
+  ChatAccessSnapshot,
+  DenyChatAccessRequestInput,
+  ListChatAccessRequestsInput,
+  RevokeChatAccessGrantInput,
+  SetChatAccessPrincipalEffectInput,
+} from "./chat/types/ChatAccess.js";

package/src/skill/Config.ts

@@ -2,7 +2,7 @@
  * SkillPlugin 构造参数归一化工具。
  *
  * 关键点（中文）
- * - SkillPlugin 不再读取 `downcity.json.plugins.skill` 私有配置。
+ * - SkillPlugin 只读取 constructor 配置，不读取项目配置文件。
  * - constructor options 是唯一行为配置入口，便于 SDK 用户直接理解。
  * - 这里只做默认值与去重，不做文件系统扫描。
  */

package/src/skill/runtime/Paths.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - roots 分三类：项目内（project）、用户目录（home），以及构造参数路径（custom）
- * - SkillPlugin constructor 是唯一配置入口，不再读取 downcity.json 的 skill 私有配置
+ * - SkillPlugin constructor 是唯一配置入口，不读取项目配置文件
  * - 兼容 `<any>/skills` 这种布局：如果 root basename 不是 `skills` 且其子目录 `skills/` 存在，则优先扫描 `<root>/skills`
  */