@zhin.js/adapter-onebot11 4.0.2 → 5.0.0

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # @zhin.js/adapter-onebot11
 
+## 5.0.0
+
+### Patch Changes
+
+- 7db69c1: 命令前缀改为适配器配置项：`MessageDispatcher` 不再硬编码 `/`，默认按消息所属适配器实例 config 的 `commandPrefix` 解析（默认 `''` 无前缀，任意文本按命令匹配），`endpoints[i].commandPrefix` 逐项覆盖；`ImRuntime({ commandPrefix })` 仍可设全局静态前缀。全部 20 个平台适配器 schema 新增 `commandPrefix` 属性。
+
+  BREAKING（行为变化）：未配置时命令不再需要 `/` 前缀——原 `/zt` 写法不再命中，直接发 `zt` 即可；需要斜杠风格的适配器请在配置里显式设 `commandPrefix: '/'`。
+
+- 713445c: 适配器配置格式定稿（不兼容旧格式）：`plugins.<adapter>` 顶层仅共享字段 + `commandPrefix`，`endpoints[i]` 携带 endpoint 级字段（`name` + 凭据，各 schema 已类型化），`endpoints` 为必填（icqq 另需顶层 `master`）；icqq 新增 `trusted` 列表（顶层/逐项均可）。scaffold-wizard 全部字段式与自定义 configure() 产出改为新格式，examples（full-bot / qq-games-bot）与 20 个适配器 README 同步迁移。
+- Updated dependencies [7db69c1]
+- Updated dependencies [e5c84ed]
+- Updated dependencies [3ea84a0]
+- Updated dependencies [1ddcd70]
+- Updated dependencies [ac9da66]
+  - @zhin.js/core@1.4.0
+  - @zhin.js/adapter@1.1.0
+  - @zhin.js/plugin-runtime@1.1.0
+  - @zhin.js/agent@1.0.5
+  - @zhin.js/host-http@1.0.2
+  - zhin.js@5.0.0
+
+## 4.0.3
+
+### Patch Changes
+
+- cc5c94d: 约定式插件运行时迁移（breaking）：插件与适配器由 `usePlugin()` / `extends Adapter` 迁移为 `definePlugin` / `defineAdapter` + `plugin.ts` + 约定目录（`adapters/`、`commands/`、`components/`、`tools/` 等）。
+
+  - 新增约定式运行时包：`@zhin.js/plugin-runtime`、`@zhin.js/adapter`、`@zhin.js/runtime`、`@zhin.js/host-http`（首版 1.0.0 走 init-publish，不在本 changeset 内 bump）。
+  - 全部 20 个平台适配器改为约定式 `defineAdapter`，旧 `usePlugin` / `extends Adapter` / `segment-mapper` 生产入口已删除；onebot11 反向 WSS、onebot12 webhook/wss、milky sse/webhook/wss、satori webhook、kook webhook、qq webhook/middleware 等 slice 1 推迟的连接模式已补齐。
+  - 游戏 / 工具 / 服务插件同步迁移到约定目录结构。
+  - CLI 增加 plugin-runtime host installer（http/database/outbound/schedule/console 等）。
+
+  后续加固（同批）：
+
+  - CLI：`zhin runtime start --daemon`（pidfile/崩溃拉起/风暴保护），orphan watchdog 防僵尸进程；legacy `zhin dev` / `zhin start` 已移除（含 `zhin restart`），`zhin stop` 兼容新 daemon。
+  - 安全：builtin 工具统一走 `security/policy-facade.ts` 的 `runToolPolicies`（声明式策略表，deny 优先）；审计日志 close flush + 背压队列；`splitCompoundCommand` 引号感知、`extractCommandName` 去引号堵绕过。
+  - 日志：Logger 双堆栈修复、本地时区、`getLogger` 挂树（`setLevel` 递归生效）、第三方库（log4js/discord）桥接、启动人读总结。
+  - 结构：`plugins/games/shared` 迁为 `packages/game-kit`（`@zhin.js/game-kit`）；死目录 `plugins/adapters/common` 删除。
+  - 脚手架：`create-zhin-app` / `zhin new` / scaffold-wizard 生成物改为 Plugin Runtime 形态（minimal-bot 同构，新配置格式）。
+  - Console：endpoint.list 真实名称与 phase、schema:get-all 按 instanceKey 映射、db:\* 接 DatabaseHost。
+
+  注：按仓库发布惯例（见 1bb345dd2），本次 breaking 迁移统一使用 patch，避免 zhin.js 5.0 级联。
+
+- 447f3e2: 迁移缺口修复（legacy 功能对齐）：
+
+  - html 段出站规范化：经 `@zhin.js/html-renderer` 渲染为 image 段（sandbox 豁免、无渲染器时降级文本），修复真实平台 `[object Object]`。
+  - 群聊 @ 触发 AI：适配器入站标注 `metadata.mentioned`（icqq/qq/slack/onebot11/onebot12/napcat/milky/discord/telegram/kook/dingtalk/satori），`matchAiTrigger` 补齐 ignorePrefixes/respondToAt/respondToPrivate/keywords（默认值与 legacy 对齐）。
+  - im_transcripts 全量流水恢复写入（chat_history 工具可用）；群聊旁听上下文回迁。
+  - `ai.trigger.timeout/thinkingMessage/errorTemplate` 生效；masters/trusted 角色解析对齐 legacy。
+  - `Message.sender` 统一为用户 ID（onebot11/12、napcat、milky 原误传显示名）；quote_id 经 metadata 接入 AI 引用上下文。
+
+- Updated dependencies [16ec4e8]
+- Updated dependencies [cc5c94d]
+- Updated dependencies [447f3e2]
+  - @zhin.js/core@1.3.5
+  - @zhin.js/agent@1.0.4
+  - @zhin.js/host-http@1.0.1
+  - zhin.js@4.1.3
+  - @zhin.js/logger@1.0.75
+  - @zhin.js/plugin-runtime@1.0.1
+  - @zhin.js/adapter@1.0.1
+
 ## 4.0.2
 
 ### Patch Changes

package/README.md

@@ -1,423 +1,84 @@
 # @zhin.js/adapter-onebot11
 
-Zhin.js OneBot v11 协议适配器，通过 WebSocket 连接各种支持 OneBot 协议的 QQ 机器人实现（如 go-cqhttp、Shamrock、LagrangeGo 等）。
+Zhin.js [OneBot 11](https://github.com/botuniverse/onebot-11) 适配器（Plugin Runtime）。生产路径为正向 WebSocket 客户端（`connection: ws`）；亦支持反向 WS（`connection: wss`，经 `httpHostToken`）。
 
 ## 功能特性
 
-- 🔌 完整 OneBot v11 协议兼容
-- 📦 **单一适配器**：`context: onebot11`，通过 `connection` 选择连接方式
-- 🌐 **正向 WebSocket**（`connection: ws`）：应用连 OneBot 实现的 WS
-- 🔄 **反向 WebSocket**（`connection: wss`）：应用开 WS 服务端，实现连上来
-- 🔐 Access Token 认证支持
-- 🔄 自动重连机制
-- 💓 心跳检测
-- 📨 群聊和私聊消息处理
-- 🛠️ 完整的 API 调用支持
-- 📝 消息段（Message Segment）完整支持
+- [OneBot 11 标准](https://github.com/botuniverse/onebot-11) 兼容（事件 + 动作）
+- 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
+- **正向 WebSocket**（`connection: ws`）：应用连 OneBot 实现的 WS 服务器
+- `access_token` 鉴权（Bearer + query）
+- 入站经 `messageGatewayToken`；出站 `send({ target, payload })`
 
 ## 安装
 
 ```bash
-pnpm add @zhin.js/adapter-onebot11 ws
+pnpm add @zhin.js/adapter-onebot11
 ```
 
-反向 WS 需同时启用 `@zhin.js/host-router`。
+## Plugin Runtime
 
-## 前置条件
+- `@zhin.js/adapter` — 约定式 `adapters/onebot11.ts`（`defineAdapter`）
+- `@zhin.js/core` — `messageGatewayToken` 入站/出站
+- `@zhin.js/plugin-runtime` — `plugin.ts`（`definePlugin`）
+- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 
-| 要求 | 说明 |
-|------|------|
-| **OneBot 实现** | 已运行 go-cqhttp、Lagrange、Shamrock 等，并开启 WS 服务 |
-| **正向 WS（`connection: ws`）** | 配置 OneBot 实现的 WS 地址；应用主动连接 |
-| **反向 WS（`connection: wss`）** | 需 `@zhin.js/host-router`；OneBot 实现连到本 Endpoint 的 `path` |
-| **access_token** | 可选；须与 OneBot 实现侧配置一致 |
-
-必填字段见 `OneBot11EndpointConfig`：`context`、`name`、`connection`；`ws` 需 `url`，`wss` 需 `path`。
+入站：`gateway.receive({ adapter, target: "private:uid"|"group:gid", content, sender, metadata })`  
+出站：`send({ target, payload })` → WS `send_private_msg` / `send_group_msg`（payload 已由 gateway/core 渲染；无 segment-mapper）
 
 ## 最小配置
 
-正向 WebSocket（本地开发推荐）：
-
 ```yaml
+# zhin.config.yml（Plugin Runtime）
 plugins:
-  - "@zhin.js/adapter-onebot11"
-
-endpoints:
-  - context: onebot11
+  onebot11:
     connection: ws
-    name: my-bot
-    url: "ws://127.0.0.1:6700"
-    access_token: "${ONEBOT11_ACCESS_TOKEN}"
-```
-
-## 配置
-
-所有 Endpoint 使用 **同一 context：`onebot11`**，通过 **`connection`** 区分连接方式。
-
-### 正向 WebSocket（connection: ws）
-
-```yaml
-plugins:
-  - "@zhin.js/adapter-onebot11"
-
-endpoints:
-  - context: onebot11
-    connection: ws
-    name: my-bot
-    url: "ws://localhost:8080"
-    access_token: "${ONEBOT_TOKEN}"
     reconnect_interval: 5000
     heartbeat_interval: 30000
+    endpoints:
+      - name: ob11-bot
+        url: "ws://127.0.0.1:6700"
+        access_token: "${ONEBOT11_ACCESS_TOKEN}"
 ```
 
-### 反向 WebSocket（connection: wss）
-
-```yaml
-plugins:
-  - "@zhin.js/host-router"
-  - "@zhin.js/adapter-onebot11"
-
-endpoints:
-  - context: onebot11
-    connection: wss
-    name: my-bot
-    path: "/onebot/ws"
-    access_token: "${ONEBOT_TOKEN}"
-    heartbeat_interval: 30000
-```
-
-兼容旧配置：若使用 `type: 'ws'` / `type: 'ws_reverse'` 而未写 `connection`，适配器会自动映射为 `ws` / `wss`。
-
-## 支持的 OneBot 实现
-
-### 推荐实现
-
-| 实现 | 协议支持 | 稳定性 | 推荐度 |
-|------|---------|--------|--------|
-| [go-cqhttp](https://github.com/Mrs4s/go-cqhttp) | ✅ 完整 | ⭐⭐⭐⭐⭐ | 高 |
-| [LagrangeGo](https://github.com/LagrangeDev/Lagrange.Core) | ✅ 完整 | ⭐⭐⭐⭐ | 高 |
-| [Shamrock](https://github.com/whitechi73/OpenShamrock) | ✅ 完整 | ⭐⭐⭐⭐ | 中 |
-| [NapCat](https://github.com/NapNeko/NapCatQQ) | ✅ 完整 | ⭐⭐⭐⭐ | 中 |
-
-### 配置示例
-
-#### go-cqhttp
-
-```yaml
-# config.yml
-servers:
-  - ws:
-      host: 0.0.0.0
-      port: 8080
-      access-token: "your_token_here"
-```
-
-#### Shamrock
-
-在 Shamrock 设置中：
-1. 启用 WebSocket 服务
-2. 设置端口（默认 5800）
-3. 配置 Access Token（可选）
+根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-onebot11`（`instanceKey: onebot11`）。
 
-## 使用示例
+## 连接方式
 
-### 基础消息处理
-
-```typescript
-import { addCommand, MessageCommand } from 'zhin.js'
-
-addCommand(new MessageCommand('hello <name:text>')
-  .action(async (message, result) => {
-    return `你好，${result.params.name}！`
-  })
-)
-```
-
-### 群聊消息
-
-```typescript
-import { onGroupMessage } from 'zhin.js'
-
-onGroupMessage(async (message) => {
-  console.log(`群 ${message.$channel.id} 收到消息`)
-  await message.$reply('收到了！')
-})
-```
-
-### 私聊消息
-
-```typescript
-import { onPrivateMessage } from 'zhin.js'
-
-onPrivateMessage(async (message) => {
-  await message.$reply('你好！')
-})
-```
-
-### 发送图片
-
-```typescript
-addCommand(new MessageCommand('pic <url:text>')
-  .action(async (message, result) => {
-    return [
-      { type: 'image', data: { file: result.params.url } }
-    ]
-  })
-)
-```
-
-### 使用 CQ 码
-
-```typescript
-addCommand(new MessageCommand('cq')
-  .action(async (message) => {
-    return [
-      { type: 'face', data: { id: '123' } },
-      { type: 'text', data: { text: '表情' } }
-    ]
-  })
-)
-```
-
-## 消息类型支持
-
-### 接收消息类型
-
-- ✅ 文本消息（text）
-- ✅ 图片消息（image）
-- ✅ 语音消息（record）
-- ✅ 视频消息（video）
-- ✅ @ 提及（at）
-- ✅ 表情（face）
-- ✅ 引用回复（reply）
-- ✅ 戳一戳（poke）
-- ✅ 分享（share）
-- ✅ 位置（location）
-- ✅ 音乐分享（music）
-- ✅ JSON 卡片（json）
-- ✅ XML 卡片（xml）
-
-### 发送消息类型
-
-- ✅ 文本消息
-- ✅ 图片消息（支持 URL、Base64、本地文件）
-- ✅ 语音消息
-- ✅ 视频消息
-- ✅ @ 提及
-- ✅ 表情
-- ✅ 引用回复
-- ✅ 戳一戳
-- ✅ 分享卡片
-- ✅ 音乐分享
-- ✅ JSON/XML 卡片
-
-## API 方法
-
-### 消息相关
-
-```typescript
-const endpoint = app.adapters.get('onebot11')?.endpoints.get('my-bot')
-
-// 发送群消息
-await endpoint.callApi('send_group_msg', {
-  group_id: 123456,
-  message: '消息内容'
-})
-
-// 发送私聊消息
-await endpoint.callApi('send_private_msg', {
-  user_id: 123456,
-  message: '消息内容'
-})
-
-// 撤回消息
-await endpoint.callApi('delete_msg', {
-  message_id: 123456
-})
-```
+| connection | 状态 |
+|------------|----------------|
+| `ws` | 已实现（推荐） |
+| `wss` | 已实现：反向 WS（`httpHostToken`） |
 
-### 信息获取
+## 鉴权
 
-```typescript
-// 获取登录信息
-const loginInfo = await endpoint.callApi('get_login_info')
+- **Bearer**：`Authorization: Bearer <access_token>`
+- 正向 WS 在 Upgrade 时附带请求头，并在 URL query 写入 `access_token`
 
-// 获取用户信息
-const userInfo = await endpoint.callApi('get_stranger_info', {
-  user_id: 123456
-})
+## 动作与事件
 
-// 获取群信息
-const groupInfo = await endpoint.callApi('get_group_info', {
-  group_id: 123456
-})
-
-// 获取群成员列表
-const memberList = await endpoint.callApi('get_group_member_list', {
-  group_id: 123456
-})
-```
-
-### 群管理
-
-```typescript
-// 踢出群成员
-await endpoint.callApi('set_group_kick', {
-  group_id: 123456,
-  user_id: 654321
-})
-
-// 禁言群成员
-await endpoint.callApi('set_group_ban', {
-  group_id: 123456,
-  user_id: 654321,
-  duration: 600 // 秒
-})
-
-// 设置群名片
-await endpoint.callApi('set_group_card', {
-  group_id: 123456,
-  user_id: 654321,
-  card: '新名片'
-})
-```
-
-## 连接模式对比
-
-### 正向 WebSocket（客户端模式）
-
-**优点：**
-- ✅ 配置简单
-- ✅ 主动连接，无需开放端口
-- ✅ 适合本地开发
-
-**缺点：**
-- ❌ 需要 OneBot 实现提供 WebSocket 服务
-
-### 反向 WebSocket（服务器模式）
-
-**优点：**
-- ✅ OneBot 实现主动连接
-- ✅ 支持多个客户端连接
-- ✅ 适合生产环境
-
-**缺点：**
-- ❌ 需要开放端口或使用内网穿透
-- ❌ 配置相对复杂
-
-## 消息 ID 格式
-
-OneBot11 适配器的消息 ID 格式：`{message_id}`
-
-撤回消息时直接使用数字 ID。
-
-## 注意事项
-
-### Access Token
-
-建议配置 Access Token 增强安全性：
-```typescript
-{
-  access_token: process.env.ONEBOT_TOKEN
-}
-```
-
-OneBot 实现需要配置相同的 Token。
-
-### 重连机制
-
-适配器会自动重连，可配置重连间隔：
-```typescript
-{
-  reconnect_interval: 5000  // 5秒后重连
-}
-```
-
-### 心跳检测
-
-心跳机制确保连接活跃：
-```typescript
-{
-  heartbeat_interval: 30000  // 30秒发送一次心跳
-}
-```
-
-### API 超时
-
-API 调用默认 30 秒超时，可在代码中调整。
-
-## 故障排查
-
-### 连接不上 OneBot 服务
-
-1. OneBot 服务是否已启动
-2. WebSocket 地址（`url`）或反向路径（`path`）是否正确
-3. `access_token` 是否与实现侧一致
-4. 防火墙是否阻止连接
-
-### 消息发送失败
-
-1. QQ 未登录或登录失效
-2. 账号风控限制
-3. 群/好友不存在
-4. 消息段格式错误
-
-### 反向 WS 无法连接
-
-1. `@zhin.js/host-router` 已启用且 HTTP 服务正常
-2. `path` 与 OneBot 实现配置的反向 WS 地址一致
-3. 端口已从公网或内网可达
-
-### CQ 码与消息段
-
-适配器自动处理 CQ 码转换；发送时使用消息段格式即可：
-
-```typescript
-[
-  { type: 'text', data: { text: '文本' } },
-  { type: 'image', data: { file: 'url' } }
-]
-```
-
-## 文档链接
-
-- [OneBot v11 适配器文档](https://zhin.js.org/adapters/onebot11)
-- [适配器概览](https://zhin.js.org/essentials/adapters)
-- [OneBot 11 标准](https://github.com/botuniverse/onebot-11)
-
-## 相关链接
-
-- [OneBot 标准](https://github.com/botuniverse/onebot-11)
-- [go-cqhttp](https://github.com/Mrs4s/go-cqhttp)
-- [LagrangeGo](https://github.com/LagrangeDev/Lagrange.Core)
-- [Shamrock](https://github.com/whitechi73/OpenShamrock)
-
-## 依赖项
-
-- `ws` - WebSocket 客户端/服务器库
-- `zhin.js` - Zhin 核心框架
+- 事件：`post_type`（message/notice/request/meta_event）、`message_type`、`message` 等
+- 动作：`send_private_msg`、`send_group_msg`、`delete_msg`、`set_group_special_title` 等
 
 ## AI 工具
 
 | 类别 | 路径 |
 |------|------|
 | Permit 词汇 | `agent/PERMITS.md` |
-| 平台工具（1 个） | `agent/tools/set_title.ts` → `onebot11_set_title` |
+| 平台工具 | `agent/tools/set_title.ts` → `onebot11_set_title` |
 | 技能说明 | `agent/skills/onebot11.md` |
-| 群管标准工具 | `createSceneManagementTools()` |
 
+## 迁移说明（Plugin Runtime）
 
-## 开发
+- **notice / request 侧事件已移除**：旧 Adapter 对 `post_type: notice|request` 构建 `notice.receive` / `request.receive` 事件；新 Plugin Runtime（`messageGatewayToken`）暂无侧事件总线，入站仅处理 `post_type: message`，notice / request 事件静默丢弃。
+- **群管工具暂未迁移**：旧 Adapter 经 `createSceneManagementTools` 注册踢人 / 禁言 / 群名片等成套 agent 工具；迁移后仅保留 `onebot11_set_title`，其余群管能力可通过 `callApi`（如 `set_group_kick`、`set_group_ban`）作为逃生舱调用。
+- **平台权限门禁**：`plugin.ts` setup 已注册 `registerDefaultScenePlatformPermitChecker('onebot11')`，`scene_admin` / `scene_owner` 依据入站 metadata 中的 sender `role`（owner / admin）判定。
 
-```bash
-pnpm build  # 构建
-pnpm clean  # 清理构建文件
-```
+## 文档链接
+
+- [OneBot 11 标准](https://github.com/botuniverse/onebot-11)
+- [适配器概览](https://zhin.js.org/essentials/adapters)
 
 ## 许可证
 
 MIT License
-
-## 贡献
-
-欢迎提交 Issue 和 Pull Request！

package/adapters/onebot11.ts

@@ -0,0 +1,39 @@
+/**
+ * Convention entry: discover `adapters/onebot11.ts` → defineAdapter.
+ */
+import { defineAdapter } from '@zhin.js/adapter';
+import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { httpHostToken } from '@zhin.js/host-http';
+import { OneBot11WsEndpoint } from '../src/ws-endpoint.js';
+import { OneBot11WssEndpoint } from '../src/wss-endpoint.js';
+import {
+  resolveOneBot11Config,
+  type OneBot11AdapterConfig,
+} from '../src/protocol.js';
+
+export { OneBot11WsEndpoint } from '../src/ws-endpoint.js';
+export type { OneBot11WsEndpointOptions } from '../src/ws-endpoint.js';
+export { OneBot11WssEndpoint } from '../src/wss-endpoint.js';
+export type { OneBot11WssEndpointOptions } from '../src/wss-endpoint.js';
+export type { OneBot11WsSocket, OneBot11WsCreateOptions } from '../src/ws-types.js';
+
+export default defineAdapter<OneBot11AdapterConfig>({
+  capabilities: ['inbound', 'outbound'],
+  create(context) {
+    const config = resolveOneBot11Config(context.config);
+    const gateway = context.use(messageGatewayToken);
+    if (config.connection === 'wss') {
+      return new OneBot11WssEndpoint({
+        id: context.id,
+        gateway,
+        http: context.use(httpHostToken),
+        config,
+      });
+    }
+    return new OneBot11WsEndpoint({
+      id: context.id,
+      gateway,
+      config,
+    });
+  },
+});

package/agent/tools/set_title.ts

@@ -1,7 +1,7 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getOnebot11AgentDeps } from '../../src/onebot11-agent-deps.js';
-export default defineTool<{ endpoint_id: string; group_id: number; user_id: number; title: string }>({
+export default defineAgentTool<{ endpoint_id: string; group_id: number; user_id: number; title: string }>({
   description: '设置 QQ 群成员的专属头衔。只有群主才能设置。',
   inputSchema: z.object({
     endpoint_id: z.string().describe('Endpoint 名称'),

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+export { buildSendAction, buildWsConnectOptions, extractQuoteId, formatInboundContent, formatInboundMetadata, formatInboundTarget, formatOutboundSegments, getChannelId, isMessageEvent, isOneBot11BotMentioned, parseSendTarget, resolveOneBot11Config, senderDisplayName, senderNickname, senderUserId, type OneBot11ActionRequest, type OneBot11ActionResponse, type OneBot11AdapterConfig, type OneBot11ConfigBase, type OneBot11EndpointConfig, type OneBot11Event, type OneBot11Segment, type OneBot11Sender, type OneBot11WireSegment, type OneBot11WsConfig, type OneBot11WssConfig, type ParsedSendTarget, type ResolvedOneBot11Config, } from './protocol.js';
+export { OneBot11WsEndpoint, type OneBot11WsEndpointOptions, } from './ws-endpoint.js';
+export { OneBot11WssEndpoint, type OneBot11WssEndpointOptions, } from './wss-endpoint.js';
+export type { OneBot11WsSocket, OneBot11WsCreateOptions } from './ws-types.js';
+export { callOneBot11WsAction, decodeWsPayload, handleOneBot11WsMessage, rejectAllPending, startOneBot11Heartbeat, } from './ws-transport.js';
+export { verifyOneBotAccessToken } from './wss-auth.js';
+export { getOnebot11AgentDeps, registerOnebot11AgentEndpoint, setOnebot11AgentDeps, type Onebot11AgentDeps, type Onebot11AgentEndpoint, } from './onebot11-agent-deps.js';

package/lib/index.js

@@ -0,0 +1,6 @@
+export { buildSendAction, buildWsConnectOptions, extractQuoteId, formatInboundContent, formatInboundMetadata, formatInboundTarget, formatOutboundSegments, getChannelId, isMessageEvent, isOneBot11BotMentioned, parseSendTarget, resolveOneBot11Config, senderDisplayName, senderNickname, senderUserId, } from './protocol.js';
+export { OneBot11WsEndpoint, } from './ws-endpoint.js';
+export { OneBot11WssEndpoint, } from './wss-endpoint.js';
+export { callOneBot11WsAction, decodeWsPayload, handleOneBot11WsMessage, rejectAllPending, startOneBot11Heartbeat, } from './ws-transport.js';
+export { verifyOneBotAccessToken } from './wss-auth.js';
+export { getOnebot11AgentDeps, registerOnebot11AgentEndpoint, setOnebot11AgentDeps, } from './onebot11-agent-deps.js';

package/lib/onebot11-agent-deps.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Agent tool deps for onebot11 (set_title etc.).
+ * Endpoints register themselves on start; tools look up by config name / endpoint id.
+ */
+export interface Onebot11AgentEndpoint {
+    setTitle(groupId: number, userId: number, title: string, duration?: number): Promise<boolean>;
+    callApi(action: string, params?: Record<string, unknown>): Promise<unknown>;
+}
+export interface Onebot11AgentDeps {
+    getEndpoint: (endpointId: string) => Onebot11AgentEndpoint;
+}
+export declare function registerOnebot11AgentEndpoint(endpointId: string, endpoint: Onebot11AgentEndpoint): () => void;
+/** Optional override used by tests / transitional callers. */
+export declare function setOnebot11AgentDeps(deps: Onebot11AgentDeps): void;
+export declare function getOnebot11AgentDeps(): Onebot11AgentDeps;

package/lib/onebot11-agent-deps.js

@@ -0,0 +1,30 @@
+/**
+ * Agent tool deps for onebot11 (set_title etc.).
+ * Endpoints register themselves on start; tools look up by config name / endpoint id.
+ */
+const endpoints = new Map();
+let override = null;
+export function registerOnebot11AgentEndpoint(endpointId, endpoint) {
+    endpoints.set(endpointId, endpoint);
+    return () => {
+        if (endpoints.get(endpointId) === endpoint) {
+            endpoints.delete(endpointId);
+        }
+    };
+}
+/** Optional override used by tests / transitional callers. */
+export function setOnebot11AgentDeps(deps) {
+    override = deps;
+}
+export function getOnebot11AgentDeps() {
+    if (override)
+        return override;
+    return {
+        getEndpoint(endpointId) {
+            const registered = endpoints.get(endpointId);
+            if (!registered)
+                throw new Error(`Endpoint ${endpointId} 不存在`);
+            return registered;
+        },
+    };
+}