@zhin.js/adapter-slack 1.1.25 → 1.1.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/CHANGELOG.md +186 -0
  2. package/LICENSE +21 -0
  3. package/PERMITS.md +10 -17
  4. package/README.md +8 -4
  5. package/agents/slack/conversation.js +15 -0
  6. package/agents/slack/conversation.ts +17 -0
  7. package/agents/slack/messages.js +4 -0
  8. package/agents/slack/messages.ts +4 -0
  9. package/agents/slack/skills/slack-channels/tools/archive_channel/index.js +6 -7
  10. package/agents/slack/skills/slack-channels/tools/archive_channel/index.ts +7 -10
  11. package/agents/slack/skills/slack-channels/tools/invite_to_channel/index.js +5 -5
  12. package/agents/slack/skills/slack-channels/tools/invite_to_channel/index.ts +5 -6
  13. package/agents/slack/skills/slack-channels/tools/set_purpose/index.js +5 -5
  14. package/agents/slack/skills/slack-channels/tools/set_purpose/index.ts +5 -6
  15. package/agents/slack/skills/slack-channels/tools/set_topic/index.js +5 -5
  16. package/agents/slack/skills/slack-channels/tools/set_topic/index.ts +5 -6
  17. package/agents/slack/skills/slack-channels/tools/unarchive/index.js +2 -3
  18. package/agents/slack/skills/slack-channels/tools/unarchive/index.ts +2 -3
  19. package/agents/slack/skills/slack-messages/tools/add_reaction/index.js +5 -4
  20. package/agents/slack/skills/slack-messages/tools/add_reaction/index.ts +5 -5
  21. package/agents/slack/skills/slack-messages/tools/edit_message/index.js +6 -5
  22. package/agents/slack/skills/slack-messages/tools/edit_message/index.ts +6 -6
  23. package/agents/slack/skills/slack-messages/tools/pin_message/index.js +5 -5
  24. package/agents/slack/skills/slack-messages/tools/pin_message/index.ts +5 -6
  25. package/agents/slack/skills/slack-messages/tools/remove_reaction/index.js +5 -4
  26. package/agents/slack/skills/slack-messages/tools/remove_reaction/index.ts +5 -5
  27. package/agents/slack/skills/slack-messages/tools/unpin_message/index.js +5 -5
  28. package/agents/slack/skills/slack-messages/tools/unpin_message/index.ts +5 -6
  29. package/lib/console-spec.js +119 -11
  30. package/lib/index.d.ts +2 -2
  31. package/lib/index.js +2 -2
  32. package/lib/platform-permit.d.ts +4 -12
  33. package/lib/platform-permit.js +7 -41
  34. package/lib/protocol.d.ts +1 -5
  35. package/lib/protocol.js +1 -19
  36. package/lib/slack-message-ref.d.ts +0 -1
  37. package/lib/slack-message-ref.js +0 -3
  38. package/lib/webhook.d.ts +1 -2
  39. package/lib/webhook.js +12 -29
  40. package/package.json +24 -26
  41. package/plugin.js +0 -6
  42. package/schema.json +0 -56
  43. package/src/console-spec.ts +119 -11
  44. package/src/index.ts +1 -7
  45. package/src/platform-permit.ts +5 -54
  46. package/src/protocol.ts +2 -23
  47. package/src/slack-message-ref.ts +0 -4
  48. package/src/webhook.ts +12 -32
package/CHANGELOG.md CHANGED
@@ -1,5 +1,191 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.1.27
4
+
5
+ ### Patch Changes
6
+
7
+ - c606d51: 各适配器按平台能力上报入站发送者的 `sender.platform`(ADR 0056 §1),并在能力画像 `scene.platformStanding` 中声明:OneBot11、NapCat、Milky、ICQQ 群消息上报群主 / 管理员 / 成员;QQ 官方频道上报频道主 / 超级管理员与身份组;Discord 服务器频道上报所有者 / 管理员 / 成员、身份组与 snake*case 权限位;Telegram 群消息按 `getChatMember` 上报 creator / administrator / member / 已离开,以及管理员的 `can*\*` 权限;KOOK 服务器频道上报服务器主 / 管理员角色、角色列表与权限位;飞书、钉钉群消息上报群主 / 管理员 / 成员;Sandbox 把模拟角色作为平台身份上报,不再授予框架主人角色。Satori、Slack、OneBot12、企业微信、LINE 的事件不带可靠的成员身份,不上报。README 补充「成员身份」说明。
8
+
9
+ 机器人自身身份(`management.inspectSelfStanding` + 能力画像 `scene.selfStanding`,供 `bot:*` permit):ICQQ、OneBot11、NapCat、Milky 群(`get_group_member_info` self);QQ 官方群(`getBotState`)与频道(机器人频道成员身份组);Discord(`guild.members.me` 身份组与频道权限);Telegram(`getChatMember` bot);KOOK(`/v3/user/view` self 的服务器角色与权限位);飞书(`chat.get` 群主与 `bot_manager_id_list`)。钉钉没有对应接口,不声明。群管理类 Agent 工具补上 `bot:admin` / `bot:owner` / `bot-permission:*`,需要发言者是群管的平台操作改用 `platform:admin` 等。
10
+
11
+ - 53932e5: 修复平台身份 permit 与操作目标不一致的问题(ADR 0056 §5):`platform:*` / `platform-permission:*` / `bot:*` / `bot-permission:*` 按**当前会话**判定,但群管理工具此前接受模型传入的任意群 / 服务器 / 频道 ID,机器人同在 A、B 两群当管理员时,A 群管理员可让 Agent 在 B 群踢人。
12
+
13
+ - 目标改为取自当前会话、去掉目标 ID 入参(模型传入的 ID 被忽略):ICQQ(踢人、禁言、设管理员、头衔、公告、匿名;设精华校验消息属于本群)、Telegram(邀请链接、置顶 / 取消置顶、群描述、默认权限)、Discord(加 / 移除身份组、身份组列表、建子线程)、KOOK(黑名单、授予 / 撤销 / 创建 / 删除角色)、飞书(加成员、设 / 撤管理员、改群信息、解散群)、NapCat(群公告、删公告、头衔、群头像;精华消息校验属于本群)、OneBot11(头衔)、QQ 官方频道(身份组增删建与列表、子频道列表、成员详情;子频道详情只限本频道)。核心场景治理工具工厂(`createSceneManagementTools`)同样只作用于调用消息所在会话,没有会话时拒绝;Agent 侧同名工厂改用与核心一致的 `platform:<地位>` + `bot:<地位>`(此前误作 zhin 角色)。
14
+ - 钉钉群管理接口使用旧版 `chatid`(无法由当前会话推出),`dingtalk_add_chat_members` / `dingtalk_update_chat` 改为要求 zhin `owner`(`update_chat` 此前没有任何门禁);`dingtalk_create_chat` 改为要求 zhin `trusted`(`admin` / `owner` 亦满足),不再依赖钉钉从不上报的 `platform-permission:chat_owner`。
15
+ - Slack 不上报发言者平台身份,频道工具改用 zhin 角色并只作用于当前频道:话题、用途、邀请、置顶 / 取消置顶要求 `admin`,归档 / 恢复归档要求 `owner`;`PERMITS.md` 同步修正。
16
+ - Discord:加 / 移除身份组要求目标身份组低于发起者的最高身份组(服务器主豁免;托管身份组拒绝),低位 `manage_roles` 管理员不能借机器人给自己加更高身份组。平台权限统一为服务器级:机器人自身改读 `GuildMember.permissions`(不再用频道级 `permissionsFor`);Interactions 模式的位域含频道覆盖,只上报不能被频道覆盖的权限(管理员上报全部),并用最近一次交互的 `app_permissions` 上报机器人自身身份(同一口径,10 分钟内有效)。
17
+ - Telegram:`set_permissions` 改要求 `platform-permission:restrict_members`,`set_description` 改 `change_info`,`create_invite` 改 `invite_users`;发送者 `getChatMember` 并发合并为一次、失败负缓存 10 秒,收到 `chat_member` / `my_chat_member` 更新时以新状态覆盖缓存(默认 `allowedUpdates` 增加这两项);restricted 成员的个人 `can_*` 不再作为平台权限上报(与普通成员一致,只有管理员上报权限)。
18
+ - KOOK:服务器主与持有「管理员」位的成员(含机器人自身)展开为全部权限;并入「全体成员」(role_id 0)的基础权限。
19
+ - 飞书:`chat.get` 失败或未返回 `owner_id` 时发送者 / 机器人地位为未知(不再报确定的 `member` 并缓存 60 秒),失败负缓存 10 秒。
20
+ - QQ 官方:发送者平台身份只在频道子频道上报(群、单聊、频道私信不上报)。
21
+ - `AdapterIndex.selfStanding`:共享查询使用独立的 10 秒期限,调用方的 `signal` 只中止自己的等待,不再取消他人共享的查询或把结果缓存为未知;查询期间被 `invalidateSelfStanding` 失效时不写回旧结果。
22
+ - OneBot11 / NapCat / Milky:机器人自身身份不再永久记住首次 `get_login_info` 的账号(重连或换号后刷新;只为合并突发请求复用 5 秒,查询失败即丢弃)。
23
+ - 删除遗留导出(生成永不匹配的 permit 或已不再注册):`discordGroupPermitResolver` / `checkDiscordPlatformPermit` / `normalizeDiscordSenderForPermit`、`telegramGroupPermitResolver` / `checkTelegramPlatformPermit` / `normalizeTelegramChatMember`、`kookGroupPermitResolver` / `checkKookPlatformPermit` / `normalizeKookSenderForPermit` / `KookSenderInfo`、`larkGroupPermitResolver` / `checkLarkPlatformPermit` / `normalizeLarkSenderForPermit`、`slackGroupPermitResolver` / `checkSlackPlatformPermit` / `normalizeSlackSenderForPermit`、`dingtalkGroupPermitResolver` / `checkDingtalkPlatformPermit` / `normalizeDingtalkSenderForPermit`、`wecomGroupPermitResolver` / `checkWecomPlatformPermit` / `normalizeWecomSenderForPermit`、`qqGuildPermitResolver` / `checkQqPlatformPermit` / `normalizeQqGuildSenderForPermit`。permit 一律交给内置评估器(`@zhin.js/permission`),`platformPermit()` 仍保留;各适配器 `PERMITS.md` 按实际上报的字段重写。
24
+
25
+ - 89b63fa: 适配器工具的操作目标与角色层级收尾(ADR 0056 §5):
26
+
27
+ - KOOK:`kook_grant_role` / `kook_revoke_role` 要求目标角色严格低于发起者的最高角色(KOOK 角色 `position` 值越小优先级越高;服务器主豁免;「全体成员」与不存在的角色拒绝),低位 `manage_roles` 成员不能借机器人给自己授予更高角色;`kook_blacklist` 拉黑时要求目标成员低于发起者、不能拉黑服务器主;`kook_list_roles` 改为只读当前服务器(去掉 `guild_id`)。
28
+ - 不带层级限定 owner 的工具不再接受任意群 / 频道 / 会话 ID,目标改为取自当前会话(模型传入的 ID 被忽略):
29
+ - ICQQ:`group_invite`、`group_member_info`、`group_sign`、`poke`、`group_files`、`list_muted`;
30
+ - Discord:`discord_react`、`discord_send_embed`(当前频道 / 线程 / 私信)、`discord_forum_post`(在当前帖子所属的论坛发帖);
31
+ - NapCat:精华列表、群公告列表、群文件(根目录、下载链接、上传)、群消息历史、AI 语音与角色、群详情、禁言列表、群签到;`get_friend_msg_history` 只读当前私聊;`send_poke` 在当前会话;`send_forward_msg` 发往当前会话,引用已有消息的节点只能引用当前会话的消息;
32
+ - Slack:`slack_add_reaction`、`slack_remove_reaction`、`slack_edit_message`;
33
+ - Telegram:`telegram_list_admins`、`telegram_member_count`、`telegram_react`、`telegram_send_poll`、`telegram_send_sticker`;
34
+ - LINE:`line_get_group_members`。
35
+ - 本身就跨会话的工具改为要求全局层 `owner`(`owner@global`):NapCat `forward_single_msg`(转发任意消息到任意好友 / 群)、`upload_group_file`(`file` 可为宿主本地路径)、钉钉 `dingtalk_send_work_notice`、企业微信 `wecom_send_text`(发给任意用户)。
36
+ - 各适配器 `PERMITS.md` 同步(Slack `slack_unarchive`、钉钉跨群工具更正为 `owner@global`)。
37
+
38
+ - 57c6cdc: fix: 全仓审计修复
39
+
40
+ - kernel: 模板求值沙箱不再泄漏宿主对象——宿主函数的返回值与抛出的错误会重新包裹代理(`segments.map(x=>x).constructor.constructor(...)` 之前可拿到宿主 `Function`),并禁止通过代理写入/删除宿主属性。
41
+ - agent: exec 白名单正则按整体锚定(`git|npm` 不再匹配 `gitevil`);SSRF 主机名黑名单识别尾点形式(`localhost.`);Docker 沙箱 `always` 模式的 fail-closed 分支可被触达;声明缺失的 `chalk` 依赖。
42
+ - ai: 摘要按最新优先加载(超过 500 条时不再使用过期锚点);修复 `test` 脚本指向不存在的配置。
43
+ - cli: `ZHIN_LOG_LEVEL` 生效(修复运算符优先级);移除旧守护进程遗留的无引用进程辅助函数。
44
+ - logger: `formatCompact` 不再把 `config: 'yaml'`、`direction: 'in'` 这类非路径值改写成 `./yaml`。
45
+ - host-http: 未配置数据库时 `db:tables` 与有数据库时一致返回 `{ tables }`。
46
+ - a2a: 405 响应把 `Allow` 放进响应头。
47
+ - pagemanager: 内联进 `<script>` 的页面元数据转义 `<`。
48
+ - client: 事件历史请求失败时携带 HTTP 状态,token 失效可触发重新登录。
49
+ - scaffold-wizard / create-zhin-app: 修正适配器文档 URL 与模板里的 `@zhin.js/tool` 导入。
50
+ - adapter-wechat-mp: 签名比较改为常量时间。
51
+ - adapter-kook: 声明运行时依赖 `ws`。
52
+ - plugin-lottery: 遗漏值按最近一次出现计算;推送目标 schema 字段与实现一致(`endpointKey`)。
53
+ - plugin-code-runner: 语言校验改用自有属性判断。
54
+ - plugin-link-poster: 抓取前校验主机名白名单(修复 SSRF),超时覆盖响应体读取。
55
+ - 其余包:从 `files` 中移除不存在的目录。
56
+ - feature-kit / middleware: 修正 README 中层级错误的文档链接。
57
+
58
+ - e1fda87: fix: 按审计待审清单处理(安全、功能、清理)
59
+
60
+ **行为变更(升级前请阅读)**
61
+
62
+ - kernel / core / zhin.js:出站文本中的 `${…}` 不再用 `vm` 求值,只替换 `TemplateContext` 上能解析到值的属性路径(如 `${sender.name}`);表达式、函数调用、未知名字原样保留。整套 vm 沙箱(`evaluate` / `execute` / `compiler` / `getValueWithRuntime`)已移除。
63
+ - kernel / core / zhin.js:移除零引用的遗留导出——`Scheduler`、错误管理器与 `ZhinError` 子类、`compose`、`segment.from/toString`、AI 触发/准入函数、`@zhin.js/core/queue-im-field-contract`、`zhin.js/contexts`。
64
+ - agent:readonly 执行预设不再放行重定向、后台 `&`、进程替换、`find -delete/-exec`、`sed -i`、`sort -o`、`tee`、`xargs`、awk;curl/wget 校验每个 URL 与裸主机并识别更多上传参数;自定义 `execAllowlist` 中的只读命令带写入风险时改走审批。沙箱超时/取消会杀掉进程组或具名容器,默认镜像改为 `node:22-bookworm-slim` + `bash`。移除无生产调用的 `AuditLogger`、`AnomalyDetector`、旧 vision 回合等导出。
65
+ - ai:移除 `storage`、`FileStateCache`、`CostTracker`、`model-name-utils`、`./agent-step-checkpoint` 子路径、`ContextManager` 及旧压缩管线;延迟工具快照改为有界 LRU。
66
+ - cli:`zhin send` / `watch` / `schedule` 改为与运行中的 Host 通信(新增 `POST /message/send` 与 `/assistant/jobs` 写接口),`schedule` 不再支持离线改文件;移除 `zhin uninstall service`(用 `zhin service uninstall`)、`build --analyze`、`install -S`;`zhin stop` 杀不掉进程时保留 pid 文件并以非零退出;`runtime migrate` 新增 `verify`;未设置 `TZ` 时调度默认时区改为系统时区;不带 `ZHIN_SUPERVISOR_PID` 的进程被 init 接管后不再自行退出。
67
+ - schedule:后台 reconcile 出错不再产生未处理 rejection(新增 `onStoreError`);启动途中 `stop()` 不再遗留定时器。
68
+ - schema:元组校验与 `safeParse`、JSON Schema 一致(空数组不通过,缺省的可选元组为 `undefined`)。
69
+ - client / contract:删除无后端路由的 agent-stream API、未使用的 `definePage` 与旧 PageManager 类型;`@zhin.js/contract` 不再依赖 `@zhin.js/ai`;客户端收到 401 会清除已保存的凭据;安装/更新/卸载 RPC 默认超时 120 秒。
70
+ - a2a:流式响应中途出错写入 SSE error 并结束;未配置 token 的非生产环境只接受本机请求;任务存储有上限与过期;Mailbox 凭据回退与生产环境缺密钥检查修复。
71
+ - speech:`provider: openai` 不再套用 Ollama 的默认 host/model;识别语言改为可配置,不再写死 `zh`。
72
+ - adapter-lark:支持 `encryptKey` 加密事件解密。adapter-github:Device Flow 可取消、带超时并回复失败原因。adapter-wecom / dingtalk:请求加超时并校验 HTTP 状态。adapter-weixin-ilink:输入关闭期间暂停轮询。adapter-milky:SSE 支持 CRLF、缓冲上限与空闲重连。adapter-onebot-events:好友删除通知改为 `notice.friend.decrease`。
73
+ - plugin-group-suite:`teachAllowRegex` 默认关闭,正则安全检查更严格。plugin-qrcode:改为本地生成,回复 data URL 图片。plugin-rss / short-url / link-poster:拒绝解析到内网的地址;rss 修复条目每周重复推送;short-url 的 Console 创建改为真实调用 is.gd。plugin-lottery:按 `historyLimit` 同步。
74
+
75
+ **其余**
76
+
77
+ - host-http:插件市场详情加缓存与包名校验,SSE 回放容忍背压。host-http-contract:新增 `readTextBody()`,九个适配器改用它。
78
+ - pagemanager:页面外壳 importmap 升级到 React 19.2.8 / react-router 7.12.0。console-contract:`definePage` 接受 `description` / `group` / `parent` / `fullWidth`。
79
+ - command:进度提示本地化,匹配不再重复拷贝消息段。runtime:源码监听降级后退避重试原生监听。
80
+ - html-renderer:删除未接线的 `aiTextAsImage`。create-zhin-app / scaffold-wizard:移除不起作用的"全局安装 CLI"与运行时选择提示。
81
+ - 依赖声明清理、发布清单不再携带解析不到的 `src` 目录、移除未使用的 Skill 挂载、README 与示例配置按当前实现更正。
82
+
83
+ - a9c7a13: 聊天角色安全审查修复(ADR 0056 修订):
84
+
85
+ - 角色的作用范围:Runtime 在 `sender.chatRole` 之外写入 `sender.chatRoleLevels`(每个角色最高来自哪一层)。宿主全局能力——Agent 危险工具 / exec / 文件策略、主人审批的接收人、重启实例、写全局 / 平台记忆、定时任务的高信任运行、聊天改项目配置、`icqq login` 跨适配器恢复——只认**全局层** `owner`;增删适配器账号需要适配器层或以上的 `owner`。会话 / 账号 / 适配器层的 owner 在 Agent 信任档位上按 `admin` 计(`principal.roles`),链上角色保留在 `principal.chatRole` / `chatRoleLevels`。`@zhin.js/im-contract` / `@zhin.js/core` 新增 `chatRoleHeldAt`、`hostChatRole`、`ChatRoleLevels`。
86
+ - permit 新增层级限定写法 `<角色>@<层级>`(`owner@global`、`owner@adapter`、`admin@endpoint`……,也可写在 `role(…)` 中);不带层级的 `owner` 含义不变。
87
+ - 聊天 `角色 授予 / 撤销`:被替换或撤销的已有角色同样计入「被触及的角色」,低角色的授予不能覆盖同级或更高的角色,触及 owner 需更高层 owner;`角色 列表` 需要 admin,上级条目不显示身份。
88
+ - Console `chat-roles.grant|revoke`:涉及 owner(授予、替换、撤销)需要全局 `iam.manage`;`chat-roles.list` 对调用者作用域之外的条目脱敏(`redacted: true`,`ConsoleChatRoleEntry.adapter` / `userId` 变为可选)。
89
+ - 非关系型数据库时授予 / 撤销被拒绝(RPC 503 `chat-roles-unpersisted`,聊天回复「未保存」);迁移来的授予只在内存生效、记录保持 pending 并标记,不再「撤销后复活」。
90
+ - 迁移保持旧语义:适配器 `master` 迁为「没有自己 master 的账号」的账号层 owner(不再建适配器层 owner);`ai.trigger.masters / trusted` 不再登记到声明 `runtime.sandbox` 的模拟适配器与无法判断的适配器(写日志)。
91
+ - 线程 / 子话题沿用父会话键:Discord 线程上报为父频道 + `threadId`(出站仍发到线程);会话无法生成会话键时退回账号层链解析,全局 owner 不再丢失角色。
92
+ - 执行时复检重新读取发言者当前角色与机器人身份(`PermissionHost.setSenderRoleResolver` / `currentSenderRoles`);定时任务记录创建者所在会话,到期按创建者当前角色运行,普通用户的任务以普通成员信任运行。
93
+ - `AdapterIndex.selfStanding` 的 `cachedOnly` 读到过期缓存视为未知;入站时丢弃适配器上报的 `chatRole`,事件流发布增强后的 sender。`@zhin.js/testing` 的 `PluginTestKit` 声明的角色按全局层处理。
94
+ - 跨群 / 账号级 Agent 工具改用层级限定:钉钉 `add_chat_members` / `update_chat`、Slack `unarchive` 要求 `owner@global`;NapCat `delete_friend` 要求 `owner@endpoint`。
95
+
96
+ - 120e225: 聊天角色(ADR 0056,2026-11-12 修订):zhin 角色 owner / admin / trusted 分四级、只来自授予;发言者的平台身份与机器人自身的平台身份是独立维度,命令、Agent 工具 / 技能、中间件与按钮按三条维度共用一个评估器过滤。升级说明见 docs/migrations/chat-roles.md。
97
+
98
+ - zhin.js:实例首次启动把适配器 `master` / `trusted`、`endpoints[i].master|trusted` 与 `ai.trigger.masters|trusted` 迁入项目数据库 `chat_roles`(先记入 `.zhin/chat-roles-migration.json`,再从配置移除并记日志);之后配置再出现这些字段时启动报错并指向升级指南。平台身份不再映射为 zhin 角色:删除 `roles.mappings`(适配器块与 `endpoints[i].roles` 出现即启动报错)、`chat_role_mappings` 表与 Console `chat-roles.mappings` / `chat-roles.set-mappings`;`features.selfService.platformAdmins|roles|allowUsers` 删除;群内「功能」「角色」命令只认 zhin 角色,平台群主不再自动具备;聊天改配置、聊天重启、Agent 主人审批按 zhin `owner` 判断。
99
+ - @zhin.js/core(minor,破坏性):角色模型与解析移入 core(`ChatRoleService`、`createChatRoleSenderEnricher`),入站消息带 `sender.chatRole` 与归一的 `sender.platform`;删除 `SenderRole`、`senderRolesFromMessage`、`roleSatisfies` 等,`master` 改名 `owner`;删除映射规则 API(`createMappingChatRoleSource`、`DEFAULT_CHAT_ROLE_MAPPINGS` 等)与 `ChatRoleSource`;`createSenderEnricher` / `createConfigurationChatAuthorizer` 改为基于聊天角色。IM Runtime 为 PermissionHost 提供机器人自身身份(经 Adapter 索引缓存),机器人的角色变化事件使缓存失效;命令拒绝回复说明缺少的平台 / 机器人条件;`<Button permit>` 按点击者鉴权;场景治理工具工厂同时要求 `platform:*` 与 `bot:*`;`ai.trigger.masters|trusted` 删除。
100
+ - @zhin.js/permission(minor,破坏性):permit 语法 `owner` / `admin` / `trusted` / `role(...)`(zhin 角色)、`platform:owner|admin`、`platform-role:<id>`、`platform-permission:<name>`(发言者平台身份),新增 `bot:owner|admin`、`bot-role:<id>`、`bot-permission:<name>`(机器人自身平台身份,`PermissionSubject.bot`);`PermissionHost` 新增 `setBotStandingResolver`、`withBotStanding`、`firstDenied`,`checkAll` 可带 `source` 解析机器人身份;新增 `describeDeniedPermit`、`permitsNeedBotStanding`。删除 `role(master)`、`scene_admin`、`scene_owner`、`platform(adapter,perm)` 及 `registerPlatform`、`createSceneRolePlatformChecker`、`platformPermission`、`definePlatformPermission`,定义时报错并给出替代写法。
101
+ - @zhin.js/command(minor,破坏性):命令会话的发送者改为 `chatRole` / `platform`,不再从 metadata 读角色;`CONVERSATION_MANAGER_PERMIT` 改为 `admin`(平台群主不再自动满足);分发结果 `denied` 带 `denial`(第一条不满足的规则与原因);指令菜单只列出当前发送者在本会话可用的命令。
102
+ - @zhin.js/agent(minor,破坏性):危险工具、文件 / exec 策略、主人审批、Agent 回合主体只读 zhin 角色(`principal.roles` 只含展开的聊天角色,平台地位在 `principal.platform`);`SenderRole` → `PrincipalRole`,`SELF_CHANGE_MASTER_ROLE` → `SELF_CHANGE_OWNER_ROLE`;回合开始时读取机器人自身身份(`contextState.bot.platform`),按三条维度过滤 tool / skill / Agent 包后才披露,执行工具时再校验一次;群规「群主和管理员豁免」改为平台群主 / 管理员与 zhin `owner`。
103
+ - @zhin.js/feature-kit:`OperationSession.sender` 改为 `chatRole` / `platform`。
104
+ - @zhin.js/im-contract:新增 `PlatformStanding`、`SelfStandingRequest`、`standingFromMemberRole`。
105
+ - @zhin.js/adapter:入站 sender 可带 `platform`;账号管理命令需要聊天角色 `owner`;`EndpointManagement` 新增可选 `inspectSelfStanding`,能力画像新增 `scene.selfStanding`(声明即须实现),`AdapterIndex.selfStanding` / `invalidateSelfStanding` 按会话缓存机器人自身身份。
106
+ - @zhin.js/middleware:入站中间件可声明 `permit`,不满足时跳过该中间件(机器人身份只读缓存)。
107
+ - @zhin.js/tool:定义工具时拒绝已移除的 permit 写法。
108
+ - @zhin.js/ai:注释更新。
109
+ - @zhin.js/console-protocol:`chat-roles.list|grant|revoke`(`iam.manage`);`ConsoleChatRoleSource` 只有 `grant`。
110
+ - @zhin.js/runtime:Host 配置 Schema 删除 `features.selfService.platformAdmins|roles|allowUsers`。
111
+ - @zhin.js/testing:伪造消息与 `PluginTestKit` 用 `sender.chatRole` 声明测试身份。
112
+ - @zhin.js/scaffold-wizard:ICQQ 向导不再写 `master`,完成后提示在 Console 账号「角色」页签或聊天 `角色 授予` 设置 owner。
113
+ - 适配器:配置 Schema 删除 `master` / `trusted`(以及预览版的 `roles`);群管理类工具同时声明发言者条件与机器人条件(如 `platform:admin` + `bot:admin`、`bot-permission:manage_roles`),NapCat / OneBot11 工具不再使用已移除的 `platform(adapter,…)` 写法。
114
+ - 插件:内容审核以 `inbound.bypass`(permit 列表,默认 `owner` 或 `platform:admin`)取代 `masters` / `inbound.bypassMasters`;群管、音乐、日历、地震、B 站、轮盘赌的权限改用 zhin 角色,订阅类命令只认 zhin `admin` / `owner`。
115
+
116
+ - c2bbdcf: Console 访问控制(ADR 0049):用户、角色、会话、API 令牌与审计日志存入项目数据库,每个 Console RPC、`/api` 路由与 Host 鉴权的 WebSocket 都按 `@zhin.js/console-protocol` 的权限表放行,未登记的一律拒绝。
117
+
118
+ **破坏性变更**
119
+
120
+ - `http.tokens` 与演示模式(`scope: demo` / `user`)删除;配置里仍有 `http.tokens` 时 Host 拒绝启动。Host 配置 Schema 同步删除该字段。
121
+ - `http.token` 变为初始化令牌:只在创建第一个所有者之前有效,之后在所有接口上被拒绝。
122
+ - 未在 `CONSOLE_WS_PERMISSIONS` 登记、又使用 Host 鉴权的插件 WebSocket 不再接受 Console 账号;插件自己的 WebSocket 应改用 `ws(path, { auth: 'protocol' })` 并自行校验凭据(新增 `verifyProtocolAccessToken`、`isLoopbackAddress`)。
123
+ - OneBot 11 / 12、NapCat、Milky 的反向 WebSocket 改为只认适配器自己的 `access_token`;未配置 `access_token` 时只接受本机回环连接。
124
+ - `zhin doctor --live` 等改从 `ZHIN_CONSOLE_TOKEN` 读取 API 令牌(仍兼容 `ZHIN_HTTP_TOKEN`)。
125
+
126
+ **迁移步骤**(详见文档「升级到 Console 访问控制」)
127
+
128
+ 1. 升级后用 `http.token` 打开 Console 初始化向导创建第一个所有者,或运行 `zhin console init`(脚本:`zhin console init --yes --owner <名> --password-stdin`)。
129
+ 2. 删除配置里的 `http.tokens`,在 Console「访问控制」里为原来的令牌持有人创建用户并绑定角色(`viewer` / `operator` / `admin`);演示环境改用 `viewer` 账号。
130
+ 3. 自动化在 Console 签发 API 令牌,放进 `ZHIN_CONSOLE_TOKEN`。
131
+ 4. 从其他机器或容器连接的反向 WebSocket endpoint 补上 `access_token`。
132
+ 5. 忘记密码或所有者被锁时,停下 Host,用 `zhin console user passwd|enable|create` 离线恢复。
133
+
134
+ MCP / A2A 的 Bearer 访问同样接受用户 API 令牌(分别需要 `mcp.access`、`a2a.access`)。适配器与插件文档同步改为账号与角色的说法。
135
+
136
+ - 5cd9d3d: HTTP 路由契约改为 Web 标准 `Request` / `Response`(ADR 0054 §2,B1.0)
137
+
138
+ - host-http-contract:路由处理函数签名改为 `(request, context) => Response`,`context` 提供 `url`、`params`、`principal`、`remoteAddress`;新增 `readBodyBytes` / `readTextBody` / `readJsonBody`(带大小上限,超限先读完再报 413)、`jsonResponse` / `emptyResponse`、带背压的 `createResponseStream`(SSE、大文件下载)与 `WsConnection`。契约不再引用 `node:http` / `ws`。
139
+ - host-http:Node 服务器移到 `@zhin.js/host-http/node`(`createHttpHost`),负责 Node 请求与 `Request` / `Response` 的互转;认证结果经 `context.principal` 传给路由,删除旧的按请求取主体的辅助函数;未预期的异常只返回通用错误信息,细节写日志。
140
+ - runtime、mcp、a2a、gateway、zhin.js、calendar 插件与各适配器的 Webhook / 反向 WebSocket 路由迁移到新契约,行为不变。
141
+
142
+ - 68659cd: `zod` 改为运行时依赖(原为可选对等依赖):插件运行时在启动时就会加载这些包的约定目录(Agent 工具、命令等),其中静态导入了 `zod`;生成的项目里没有安装可选对等依赖,启动会报 `Cannot find package 'zod'`。范围为 `^4.6.7`(已修复的版本)。
143
+ - Updated dependencies [53932e5]
144
+ - Updated dependencies [57c6cdc]
145
+ - Updated dependencies [e1fda87]
146
+ - Updated dependencies [4e8ba38]
147
+ - Updated dependencies [a9c7a13]
148
+ - Updated dependencies [120e225]
149
+ - Updated dependencies [c2bbdcf]
150
+ - Updated dependencies [c2bbdcf]
151
+ - Updated dependencies [63595fc]
152
+ - Updated dependencies [fd055d2]
153
+ - Updated dependencies [4e8ba38]
154
+ - Updated dependencies [cc7a5f9]
155
+ - Updated dependencies [4e8ba38]
156
+ - Updated dependencies [f8bf684]
157
+ - Updated dependencies [e0bc008]
158
+ - Updated dependencies [5cd9d3d]
159
+ - Updated dependencies [5cd9d3d]
160
+ - Updated dependencies [c2bbdcf]
161
+ - Updated dependencies [f8bf684]
162
+ - Updated dependencies [663473b]
163
+ - Updated dependencies [c606d51]
164
+ - Updated dependencies [5cd9d3d]
165
+ - Updated dependencies [d655ef0]
166
+ - Updated dependencies [1e54b1e]
167
+ - @zhin.js/adapter@1.1.33
168
+ - @zhin.js/core@1.2.0
169
+ - @zhin.js/logger@1.1.3
170
+ - @zhin.js/host-http@1.2.0
171
+ - @zhin.js/feature-kit@1.1.16
172
+ - @zhin.js/agent-feature@1.1.17
173
+ - @zhin.js/console-contract@1.1.6
174
+ - @zhin.js/host-http-contract@1.2.0
175
+ - @zhin.js/skill@1.1.17
176
+ - @zhin.js/tool@1.1.19
177
+ - @zhin.js/im-contract@1.1.14
178
+ - @zhin.js/page@1.1.18
179
+
180
+ ## 1.1.26
181
+
182
+ ### Patch Changes
183
+
184
+ - 0d76a7c: Overhaul Console interactive workbenches, platform-specific adapter account onboarding/login flows, DeclarativePageView visual/interactive capabilities, and official utility plugin Console pages.
185
+ - Updated dependencies [0d76a7c]
186
+ - @zhin.js/adapter@1.1.32
187
+ - @zhin.js/core@1.1.60
188
+
3
189
  ## 1.1.25
4
190
 
5
191
  ### Patch Changes
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 凉菜
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/PERMITS.md CHANGED
@@ -1,24 +1,17 @@
1
1
  # Slack Platform Permits
2
2
 
3
- ## 入站字段
3
+ ## 入站字段(ADR 0056 §1)
4
4
 
5
- 频道消息异步 enrich(`users.info` + `conversations.info`,TTL 60s):
5
+ Slack 适配器不上报 `sender.platform`,也不声明 `scene.platformStanding` / `scene.selfStanding`:Workspace 管理员身份需逐用户调用 `users.info`,「频道管理者」没有标准 Web API 可查。因此 `platform:*` 与 `bot:*` permit 在 Slack 会话中都不满足。
6
6
 
7
- | 字段 | 来源 |
8
- |------|------|
9
- | `$sender.role` | `owner` · `admin` · `channel_admin` · `member` |
10
- | `$sender.permissions` | `workspace_owner` · `workspace_admin` · `channel_manager` |
7
+ ## 工具门禁
11
8
 
12
- `channel_manager`:频道 `creator === user` 或 workspace 管理员。
9
+ 频道管理工具改用 zhin 角色,并且只作用于当前频道(不接受频道 ID 入参):
13
10
 
14
- ## Permit 词汇表
11
+ | 工具 | Permit |
12
+ |------|--------|
13
+ | `slack_set_topic` · `slack_set_purpose` · `slack_invite_to_channel` · `slack_pin_message` · `slack_unpin_message` | `admin` |
14
+ | `slack_archive_channel` | `owner` |
15
+ | `slack_unarchive`(归档频道内无法对话,需指定频道 ID,可跨频道) | `owner@global` |
15
16
 
16
- | `platform(slack,…)` | 含义 |
17
- |---------------------|------|
18
- | `workspace_owner` | Workspace 主 |
19
- | `workspace_admin` | Workspace 管理员 |
20
- | `channel_manager` | 频道管理者 |
21
-
22
- ## 工厂映射
23
-
24
- `scene_admin` → `channel_manager` · `scene_owner` → `workspace_owner`
17
+ 消息工具 `slack_add_reaction` / `slack_remove_reaction` / `slack_edit_message` 只作用于当前频道或私信(不接受频道 ID 入参)。
package/README.md CHANGED
@@ -8,7 +8,7 @@ Zhin.js Slack 适配器(Plugin Runtime),优先 Socket Mode,也可经 Run
8
8
  - **HTTP Events API**:`httpHostToken` POST(签名验证),**非** legacy host-router/Koa
9
9
  - 入站经 `endpoint[endpointSpec].events`;出站 `send({ conversation, payload })` → `chat.postMessage` / Block Kit
10
10
  - 约定式 `defineAdapter` / `definePlugin`(无需 `usePlugin`)
11
- - Block Kit 按钮、斜杠命令、消息编辑、表情反应等(见 `tools/`)
11
+ - Block Kit 按钮、斜杠命令、消息编辑、表情反应等(见 `agents/slack/skills/slack-*/tools/`)
12
12
 
13
13
  ## 渐进式回复
14
14
 
@@ -134,8 +134,8 @@ HTTP 模式下 Runtime Host(`http`)须已 listen;Slack App 的 Event Subsc
134
134
  | 类别 | 路径 |
135
135
  |------|------|
136
136
  | Permit 词汇 | `PERMITS.md` |
137
- | 平台工具 | `tools/`(邀请、话题、反应、置顶、编辑等) |
138
- | 技能说明 | `agents/slack/skills/slack-channels/SKILL.md`、`agents/slack/skills/slack-messages/SKILL.md` |
137
+ | 平台工具(11 个) | `agents/slack/skills/slack-{channels,messages,users}/tools/`(邀请、话题、反应、置顶、编辑等) |
138
+ | 技能说明 | `agents/slack/skills/slack-channels/SKILL.md`、`agents/slack/skills/slack-messages/SKILL.md`、`agents/slack/skills/slack-users/SKILL.md` |
139
139
 
140
140
  ## 限制
141
141
 
@@ -152,7 +152,7 @@ HTTP 模式下 Runtime Host(`http`)须已 listen;Slack App 的 Event Subsc
152
152
  - 在账号库保存、修改、启动、停止、替换或删除该 Adapter 的账号;新增仅保存,不创建 SDK Client,需手动启动;
153
153
  - 如果适配器要求登录,页面会显示 LoginAssist 的扫码 / 滑块 / 设备确认待办;
154
154
 
155
- 读取需要 `slack:read`,写操作需要 `slack:write`;管理员 full token 不受限。页面里的「添加 endpoint」等价于原来的 `slack endpoint add`。
155
+ 读取需要 `slack:read`(`read` 级别,内置角色 `viewer` 及以上都有);增删改账号等写操作需要 `slack:write`(`operate` 级别,`operator` 及以上都有,绑定到本适配器的角色也算),首次迁移还需管理员身份;全局所有者不受限,见[插件权限的级别](https://zhin.js.org/console/#插件权限的级别)。页面里的「添加 endpoint」等价于原来的 `slack endpoint add`。
156
156
 
157
157
  首次修改启动配置里的既有账号前,管理员必须核对清单并确认一次迁移。原 canonical 身份与历史保留,完整账号配置加密进入 Host 数据库;此后账号管理只写数据库,不修改启动文件或 `.env`,不重启进程。没有持久化账号端口的环境可使用静态配置连接,动态写操作明确不可用。
158
158
 
@@ -206,3 +206,7 @@ SLACK_WEB_API_PROXY_PORT=18560 pnpm --filter platform-acceptance-bot dev:slack
206
206
  ```
207
207
 
208
208
  启动代理 forwarding 后先发新的 `/acceptance probe:slack-api-baseline`,确认真实回执;control `POST /cut` 只切 API TCP,WSS保持连接,再发独立新样本并确认报告 unknown且无后台重发。`POST /recover` 后先确认旧样本没有补发,再发新样本验证恢复。每个未知样本都保留并检查平台可见消息;禁止因为 unknown 重发同一业务。TCP cut 发生在请求前不能证明“平台已接收但回执丢失”,这一情况已有本地 TLS fixture 在服务收到 POST 后切断覆盖,实机未单独证明。
209
+
210
+ ## 成员身份
211
+
212
+ Slack 消息事件不带成员身份(工作区角色需额外 `users.info` 查询),不上报 `sender.platform`,能力画像也不声明 `scene.platformStanding`。详见 [ADR 0056 §1](https://github.com/zhinjs/zhin/blob/main/docs/adr/0056-chat-roles.md)。
@@ -0,0 +1,15 @@
1
+ // Generated by build-plugin-runtime-entries.mjs. Do not edit.
2
+ import { messages as t } from './messages.js';
3
+ /**
4
+ * The trusted turn owns the channel; model input cannot select another one. zhin roles are judged
5
+ * along the current conversation's scope chain, so channel administration tools act on the current
6
+ * channel only (ADR 0056 §5).
7
+ */
8
+ export function currentChannel(context, options = {}) {
9
+ const { origin } = context;
10
+ const conversation = origin?.kind === 'im' && origin.platform === 'slack' ? origin.conversation : undefined;
11
+ if (!conversation || (conversation.kind === 'private' && !options.allowDirect))
12
+ throw new Error(t(context.locale, 'channelRequired'));
13
+ context.signal?.throwIfAborted();
14
+ return conversation.id;
15
+ }
@@ -0,0 +1,17 @@
1
+ import type { ToolExecutionContext } from '@zhin.js/tool';
2
+ import { messages as t } from './messages.js';
3
+
4
+ export type SlackToolContext = ToolExecutionContext<unknown, 'slack'>;
5
+
6
+ /**
7
+ * The trusted turn owns the channel; model input cannot select another one. zhin roles are judged
8
+ * along the current conversation's scope chain, so channel administration tools act on the current
9
+ * channel only (ADR 0056 §5).
10
+ */
11
+ export function currentChannel(context: SlackToolContext, options: { readonly allowDirect?: boolean } = {}): string {
12
+ const { origin } = context;
13
+ const conversation = origin?.kind === 'im' && origin.platform === 'slack' ? origin.conversation : undefined;
14
+ if (!conversation || (conversation.kind === 'private' && !options.allowDirect)) throw new Error(t(context.locale, 'channelRequired'));
15
+ context.signal?.throwIfAborted();
16
+ return conversation.id;
17
+ }
@@ -1,6 +1,10 @@
1
1
  // Generated by build-plugin-runtime-entries.mjs. Do not edit.
2
2
  import { createMessages } from 'zhin.js/i18n';
3
3
  export const messages = createMessages({
4
+ "channelRequired": {
5
+ "zh-CN": "此操作仅支持当前 Slack 频道",
6
+ "en": "This operation requires the current Slack channel"
7
+ },
4
8
  "operationFailed": {
5
9
  "zh-CN": "操作失败",
6
10
  "en": "Operation failed"
@@ -1,6 +1,10 @@
1
1
  import { createMessages } from 'zhin.js/i18n';
2
2
 
3
3
  export const messages = createMessages({
4
+ "channelRequired": {
5
+ "zh-CN": "此操作仅支持当前 Slack 频道",
6
+ "en": "This operation requires the current Slack channel"
7
+ },
4
8
  "operationFailed": {
5
9
  "zh-CN": "操作失败",
6
10
  "en": "Operation failed"
@@ -1,18 +1,17 @@
1
1
  // Generated by build-plugin-runtime-entries.mjs. Do not edit.
2
2
  import { messages as t } from "../../../../messages.js";
3
+ import { currentChannel } from "../../../../conversation.js";
3
4
  import { defineAgentTool } from '@zhin.js/tool';
4
5
  import { z } from 'zod';
5
- import { platformPermission } from '@zhin.js/permission';
6
6
  export default defineAgentTool({
7
- description: '归档 Slack 频道',
8
- inputSchema: z.object({
9
- channel: z.string().describe('频道 ID'),
10
- }),
7
+ description: '归档当前 Slack 频道(仅 zhin owner)',
8
+ inputSchema: z.object({}),
11
9
  adapter: 'slack',
12
10
  scopes: ["group"],
13
11
  tags: ['slack'],
14
- permissions: [platformPermission('slack', 'workspace_admin')],
15
- async execute({ channel }, context) {
12
+ permissions: ['owner'],
13
+ async execute(_args, context) {
14
+ const channel = currentChannel(context);
16
15
  const client = context.$client;
17
16
  await client.conversations.archive({ channel });
18
17
  const success = true;
@@ -1,20 +1,17 @@
1
1
  import { messages as t } from "../../../../messages.js";
2
+ import { currentChannel } from "../../../../conversation.js";
2
3
  import { defineAgentTool } from '@zhin.js/tool';
3
4
  import { z } from 'zod';
4
- import { platformPermission } from '@zhin.js/permission';
5
5
 
6
- export default defineAgentTool<{
7
- channel: string;
8
- }>({
9
- description: '归档 Slack 频道',
10
- inputSchema: z.object({
11
- channel: z.string().describe('频道 ID'),
12
- }),
6
+ export default defineAgentTool<Record<string, never>>({
7
+ description: '归档当前 Slack 频道(仅 zhin owner)',
8
+ inputSchema: z.object({}),
13
9
  adapter: 'slack',
14
10
  scopes: ["group"],
15
11
  tags: ['slack'],
16
- permissions: [platformPermission('slack', 'workspace_admin')],
17
- async execute({ channel }, context) {
12
+ permissions: ['owner'],
13
+ async execute(_args, context) {
14
+ const channel = currentChannel(context);
18
15
  const client = context.$client;
19
16
  await client.conversations.archive({ channel });
20
17
  const success = true;
@@ -1,19 +1,19 @@
1
1
  // Generated by build-plugin-runtime-entries.mjs. Do not edit.
2
2
  import { messages as t } from "../../../../messages.js";
3
+ import { currentChannel } from "../../../../conversation.js";
3
4
  import { defineAgentTool } from '@zhin.js/tool';
4
5
  import { z } from 'zod';
5
- import { platformPermission } from '@zhin.js/permission';
6
6
  export default defineAgentTool({
7
- description: '邀请用户加入 Slack 频道',
7
+ description: '邀请用户加入当前 Slack 频道',
8
8
  inputSchema: z.object({
9
- channel: z.string().describe('频道 ID'),
10
9
  users: z.string().describe('用户 ID 列表(逗号分隔)'),
11
10
  }),
12
11
  adapter: 'slack',
13
12
  scopes: ["group"],
14
13
  tags: ['slack'],
15
- permissions: [platformPermission('slack', 'channel_manager')],
16
- async execute({ channel, users }, context) {
14
+ permissions: ['admin'],
15
+ async execute({ users }, context) {
16
+ const channel = currentChannel(context);
17
17
  const client = context.$client;
18
18
  await client.conversations.invite({ channel, users });
19
19
  const success = true;
@@ -1,22 +1,21 @@
1
1
  import { messages as t } from "../../../../messages.js";
2
+ import { currentChannel } from "../../../../conversation.js";
2
3
  import { defineAgentTool } from '@zhin.js/tool';
3
4
  import { z } from 'zod';
4
- import { platformPermission } from '@zhin.js/permission';
5
5
 
6
6
  export default defineAgentTool<{
7
- channel: string;
8
7
  users: string;
9
8
  }>({
10
- description: '邀请用户加入 Slack 频道',
9
+ description: '邀请用户加入当前 Slack 频道',
11
10
  inputSchema: z.object({
12
- channel: z.string().describe('频道 ID'),
13
11
  users: z.string().describe('用户 ID 列表(逗号分隔)'),
14
12
  }),
15
13
  adapter: 'slack',
16
14
  scopes: ["group"],
17
15
  tags: ['slack'],
18
- permissions: [platformPermission('slack', 'channel_manager')],
19
- async execute({ channel, users }, context) {
16
+ permissions: ['admin'],
17
+ async execute({ users }, context) {
18
+ const channel = currentChannel(context);
20
19
  const client = context.$client;
21
20
  await client.conversations.invite({ channel, users });
22
21
  const success = true;
@@ -1,19 +1,19 @@
1
1
  // Generated by build-plugin-runtime-entries.mjs. Do not edit.
2
2
  import { messages as t } from "../../../../messages.js";
3
+ import { currentChannel } from "../../../../conversation.js";
3
4
  import { defineAgentTool } from '@zhin.js/tool';
4
5
  import { z } from 'zod';
5
- import { platformPermission } from '@zhin.js/permission';
6
6
  export default defineAgentTool({
7
- description: '设置 Slack 频道的用途/目的',
7
+ description: '设置当前 Slack 频道的用途/目的',
8
8
  inputSchema: z.object({
9
- channel_id: z.string().describe('频道 ID'),
10
9
  purpose: z.string().describe('频道用途描述'),
11
10
  }),
12
11
  adapter: 'slack',
13
12
  scopes: ["group"],
14
13
  tags: ['slack'],
15
- permissions: [platformPermission('slack', 'channel_manager')],
16
- async execute({ channel_id, purpose }, context) {
14
+ permissions: ['admin'],
15
+ async execute({ purpose }, context) {
16
+ const channel_id = currentChannel(context);
17
17
  const client = context.$client;
18
18
  await client.conversations.setPurpose({ channel: channel_id, purpose });
19
19
  const success = true;
@@ -1,22 +1,21 @@
1
1
  import { messages as t } from "../../../../messages.js";
2
+ import { currentChannel } from "../../../../conversation.js";
2
3
  import { defineAgentTool } from '@zhin.js/tool';
3
4
  import { z } from 'zod';
4
- import { platformPermission } from '@zhin.js/permission';
5
5
 
6
6
  export default defineAgentTool<{
7
- channel_id: string;
8
7
  purpose: string;
9
8
  }>({
10
- description: '设置 Slack 频道的用途/目的',
9
+ description: '设置当前 Slack 频道的用途/目的',
11
10
  inputSchema: z.object({
12
- channel_id: z.string().describe('频道 ID'),
13
11
  purpose: z.string().describe('频道用途描述'),
14
12
  }),
15
13
  adapter: 'slack',
16
14
  scopes: ["group"],
17
15
  tags: ['slack'],
18
- permissions: [platformPermission('slack', 'channel_manager')],
19
- async execute({ channel_id, purpose }, context) {
16
+ permissions: ['admin'],
17
+ async execute({ purpose }, context) {
18
+ const channel_id = currentChannel(context);
20
19
  const client = context.$client;
21
20
  await client.conversations.setPurpose({ channel: channel_id, purpose });
22
21
  const success = true;
@@ -1,19 +1,19 @@
1
1
  // Generated by build-plugin-runtime-entries.mjs. Do not edit.
2
2
  import { messages as t } from "../../../../messages.js";
3
+ import { currentChannel } from "../../../../conversation.js";
3
4
  import { defineAgentTool } from '@zhin.js/tool';
4
5
  import { z } from 'zod';
5
- import { platformPermission } from '@zhin.js/permission';
6
6
  export default defineAgentTool({
7
- description: '设置 Slack 频道话题',
7
+ description: '设置当前 Slack 频道话题',
8
8
  inputSchema: z.object({
9
- channel: z.string().describe('频道 ID'),
10
9
  topic: z.string().describe('新话题'),
11
10
  }),
12
11
  adapter: 'slack',
13
12
  scopes: ["group"],
14
13
  tags: ['slack'],
15
- permissions: [platformPermission('slack', 'channel_manager')],
16
- async execute({ channel, topic }, context) {
14
+ permissions: ['admin'],
15
+ async execute({ topic }, context) {
16
+ const channel = currentChannel(context);
17
17
  const client = context.$client;
18
18
  await client.conversations.setTopic({ channel, topic });
19
19
  const success = true;
@@ -1,22 +1,21 @@
1
1
  import { messages as t } from "../../../../messages.js";
2
+ import { currentChannel } from "../../../../conversation.js";
2
3
  import { defineAgentTool } from '@zhin.js/tool';
3
4
  import { z } from 'zod';
4
- import { platformPermission } from '@zhin.js/permission';
5
5
 
6
6
  export default defineAgentTool<{
7
- channel: string;
8
7
  topic: string;
9
8
  }>({
10
- description: '设置 Slack 频道话题',
9
+ description: '设置当前 Slack 频道话题',
11
10
  inputSchema: z.object({
12
- channel: z.string().describe('频道 ID'),
13
11
  topic: z.string().describe('新话题'),
14
12
  }),
15
13
  adapter: 'slack',
16
14
  scopes: ["group"],
17
15
  tags: ['slack'],
18
- permissions: [platformPermission('slack', 'channel_manager')],
19
- async execute({ channel, topic }, context) {
16
+ permissions: ['admin'],
17
+ async execute({ topic }, context) {
18
+ const channel = currentChannel(context);
20
19
  const client = context.$client;
21
20
  await client.conversations.setTopic({ channel, topic });
22
21
  const success = true;
@@ -2,16 +2,15 @@
2
2
  import { messages as t } from "../../../../messages.js";
3
3
  import { defineAgentTool } from '@zhin.js/tool';
4
4
  import { z } from 'zod';
5
- import { platformPermission } from '@zhin.js/permission';
6
5
  export default defineAgentTool({
7
- description: '恢复已归档的 Slack 频道',
6
+ description: '恢复已归档的 Slack 频道(归档频道无法在其中对话,需指定频道 ID;仅全局层 zhin owner)',
8
7
  inputSchema: z.object({
9
8
  channel_id: z.string().describe('频道 ID'),
10
9
  }),
11
10
  adapter: 'slack',
12
11
  scopes: ["group"],
13
12
  tags: ['slack'],
14
- permissions: [platformPermission('slack', 'workspace_admin')],
13
+ permissions: ['owner@global'],
15
14
  async execute({ channel_id }, context) {
16
15
  const client = context.$client;
17
16
  await client.conversations.unarchive({ channel: channel_id });