@nia-teams/claude-code-plugin 0.2.0 → 0.3.0
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.
- package/AGENTS.md +11 -71
- package/README.md +129 -114
- package/README_CN.md +130 -112
- package/dist/cli.js +3 -7
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +3 -6
- package/dist/index.js +2 -4
- package/dist/index.js.map +1 -1
- package/dist/runner.js +5 -12
- package/dist/runner.js.map +1 -1
- package/docs/SPECIFICATION.md +22 -535
- package/package.json +2 -11
- package/skills/nia-teams-claude-code/SKILL.md +18 -40
- package/.claude-plugin/marketplace.json +0 -20
- package/.claude-plugin/plugin.json +0 -22
- package/.mcp.json +0 -5
- package/CLAUDE.md +0 -71
- package/dist/bridge-client.d.ts +0 -1
- package/dist/bridge-client.js +0 -2
- package/dist/bridge-client.js.map +0 -1
- package/dist/channel-server.d.ts +0 -48
- package/dist/channel-server.js +0 -269
- package/dist/channel-server.js.map +0 -1
- package/dist/crypto.d.ts +0 -1
- package/dist/crypto.js +0 -2
- package/dist/crypto.js.map +0 -1
- package/dist/http.d.ts +0 -1
- package/dist/http.js +0 -2
- package/dist/http.js.map +0 -1
- package/dist/prompt.d.ts +0 -2
- package/dist/prompt.js +0 -4
- package/dist/prompt.js.map +0 -1
- package/dist/publications.d.ts +0 -1
- package/dist/publications.js +0 -2
- package/dist/publications.js.map +0 -1
- package/dist/stdio.d.ts +0 -2
- package/dist/stdio.js +0 -45
- package/dist/stdio.js.map +0 -1
- package/docs/DAEMON.md +0 -15
- package/examples/embedded.mjs +0 -8
package/README_CN.md
CHANGED
|
@@ -2,207 +2,225 @@
|
|
|
2
2
|
|
|
3
3
|
[English](./README.md) | 简体中文
|
|
4
4
|
|
|
5
|
-
把本地或远程 **Claude Code
|
|
5
|
+
把本地或远程 **Claude Code** 接入 [Nia Teams](https://nia-teams.com),作为群聊 Agent 与团队成员**双向通讯**。
|
|
6
6
|
|
|
7
7
|
```sh
|
|
8
8
|
npm install -g @nia-teams/claude-code-plugin
|
|
9
|
-
nia-claude pair --name
|
|
9
|
+
nia-claude pair --name 'My Claude Code'
|
|
10
10
|
nia-claude start --cwd "." --daemon
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
```sh
|
|
16
|
-
claude plugin marketplace add nia-teams/agent-bridge
|
|
17
|
-
claude plugin install nia-teams@nia-teams --scope user
|
|
18
|
-
npx @nia-teams/claude-code-plugin pair --label 'claude@macbook'
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
AI 编程助手请加载 [`./skills/nia-teams-claude-code/SKILL.md`](./skills/nia-teams-claude-code/SKILL.md);npm 安装后路径为 `node_modules/@nia-teams/claude-code-plugin/skills/nia-teams-claude-code/SKILL.md`。Claude Code 插件中的 Skill 名称为 `/nia-teams:nia-teams-claude-code`。
|
|
22
|
-
|
|
23
|
-
[English](./README.md) · [协议规范](./docs/SPECIFICATION.md) · [维护说明](./AGENTS.md)
|
|
13
|
+
AI 编程助手请加载 [skills/nia-teams-claude-code/SKILL.md](./skills/nia-teams-claude-code/SKILL.md);安装后路径为 `node_modules/@nia-teams/claude-code-plugin/skills/nia-teams-claude-code/SKILL.md`。
|
|
24
14
|
|
|
25
15
|
邀请码接入见[邀请码接入](../../docs/INVITE-CONNECT_CN.md)。
|
|
26
16
|
|
|
27
|
-
##
|
|
17
|
+
## 一、产品背景与协作模型
|
|
28
18
|
|
|
29
|
-
|
|
19
|
+
本包通过 Claude Agent SDK 执行任务,复用 Claude Code CLI 的本机登录。群聊各自保存会话,团队成员通过 TaskBar 确认工具请求。
|
|
30
20
|
|
|
31
|
-
|
|
21
|
+
- **一步创建并绑定,无需预先建 Agent 或配置 API Key**:在主机终端运行配对命令,在任意设备的浏览器打开生成的链接并登录 Nia Teams,即可新建外部 Agent 并绑定主机公钥。
|
|
22
|
+
- **群聊实时状态与多轮会话隔离**:群聊底部显示该外部 Agent 的在线状态(`未连接`、`空闲待命`、`Thinking…`、`等待确认`)。每个群聊使用独立的 Claude Code 会话,后续任务沿用该群聊上下文;各群聊共享主机上的代码目录。
|
|
23
|
+
- **TaskBar 权限确认与提问交互**:当 Claude Code 请求执行命令、修改文件等操作的权限时,群聊底部 TaskBar 会弹出权限确认卡。该 Agent 的成员可点击 **允许执行**;普通提问在群消息中等待回复。
|
|
32
24
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
|
36
|
-
|
|
|
37
|
-
|
|
|
25
|
+

|
|
26
|
+
|
|
27
|
+
| 模块 | 本地宿主 | 本包 | Nia Teams |
|
|
28
|
+
| --- | --- | --- | --- |
|
|
29
|
+
| Agent 运行时 | 模型、工具、工作目录与 Claude Code 登录 | 群聊到运行时会话映射、查询与取消 | 外部 Agent 身份与归属 |
|
|
30
|
+
| 连接与认证 | 本机 Node.js 进程与 Claude Code CLI | Ed25519 凭证、WebSocket 长连接与重连 | 浏览器配对、challenge/lease 与消息投递 |
|
|
31
|
+
| 群聊对话 | 推理轮次与本地任务 | 提示格式、会话恢复与回复发布 | 群聊时间线、成员与活动状态 |
|
|
32
|
+
| 人工确认与安全边界 | Claude Code 工具权限与执行范围 | 将工具权限请求显示为 TaskBar 确认卡、RS256 验签与请求匹配 | TaskBar 卡片、Agent 成员权限与签名 |
|
|
38
33
|
|
|
39
|
-
|
|
34
|
+
## 二、五步快速接入(从零到在群里对话)
|
|
40
35
|
|
|
41
|
-
|
|
36
|
+
前提条件:运行桥接的主机已安装 Node.js 20+,并已在同一系统用户下完成 Claude Code CLI 的登录;还需要一个 [Nia Teams](https://nia-teams.com) 账号,不需要提前创建 Agent。
|
|
42
37
|
|
|
43
|
-
### 第 1
|
|
38
|
+
### 第 1 步:安装桥接包与准备宿主环境
|
|
44
39
|
|
|
45
|
-
|
|
40
|
+
在同一系统用户下安装并登录 Claude Code CLI,然后安装桥接包:
|
|
46
41
|
|
|
47
42
|
```sh
|
|
48
43
|
npm install -g @nia-teams/claude-code-plugin
|
|
49
44
|
```
|
|
50
45
|
|
|
51
|
-
|
|
46
|
+
桥接通过 PATH 和常见安装目录查找 `claude`。使用 `--claude-bin` 或 `CLAUDE_BIN` 指定可执行文件;SDK 使用 `pathToClaudeCodeExecutable`。本机 Claude Code 登录与 Nia Teams 配对分别管理。
|
|
47
|
+
|
|
48
|
+
### 第 2 步:发起主机配对并在浏览器创建 Agent
|
|
52
49
|
|
|
53
50
|
```sh
|
|
54
|
-
claude
|
|
55
|
-
claude plugin install nia-teams@nia-teams --scope user
|
|
51
|
+
nia-claude status
|
|
56
52
|
```
|
|
57
53
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
不使用插件系统时,等价的用户级注册命令是 `claude mcp add --scope user nia-teams -- npx -y @nia-teams/claude-code-plugin mcp`(兼容宿主如 CodeBuddy CLI 可将 `claude` 替换为 `codebuddy`);本地源码调试先运行 `npm ci && npm run build`,再使用 `claude mcp add --scope user nia-teams -- node /absolute/path/to/agent-bridge/packages/claude-code/bin/nia-claude.mjs mcp`。插件与纯 MCP 注册二选一,不要让两条连接竞争同一个 Agent。`npx skills add nia-teams/agent-bridge` 仅安装 Skill,不注册 MCP Server 或启用 Channel。
|
|
61
|
-
|
|
62
|
-
### 第 2 步:配对主机并创建外部 Agent
|
|
63
|
-
|
|
64
|
-
先运行 `nia-claude status`;输出的 Agent 与 Server 符合目标时复用凭证。首次接入或主动更换绑定时,使用 `nia-claude pair --name 'My Claude'`;下方 `--label` 写法与之等价。
|
|
54
|
+
若这台主机曾经配对,先核对 `status` 输出中的 `Agent:`、`Server:` 和配置目录;仍是要使用的 Agent 时,无需再次配对。首次接入时,在主机终端执行:
|
|
65
55
|
|
|
66
56
|
```sh
|
|
67
|
-
|
|
57
|
+
nia-claude pair --name 'My Claude Code'
|
|
68
58
|
```
|
|
69
59
|
|
|
70
|
-
|
|
60
|
+
终端在本机生成 Ed25519 密钥对,并打印有效期为 10 分钟的配对链接:
|
|
71
61
|
|
|
72
62
|
```text
|
|
73
63
|
Pairing code: A7F39C2B
|
|
74
64
|
https://nia-teams.com/bridge/agent-pair/A7F39C2B
|
|
75
65
|
```
|
|
76
66
|
|
|
77
|
-
|
|
67
|
+
在**任意设备的浏览器**打开该链接,不需要与运行 Claude Code 的主机在同一台设备上。未登录时,先登录 Nia Teams,再回到 **连接外部 Agent** 页面:
|
|
78
68
|
|
|
79
|
-
1. 填写 **Agent
|
|
80
|
-
2. 点击
|
|
69
|
+
1. 填写 **Agent 名称**(默认预填主机标签;若页面顶部显示切换栏,保持选中 **新建外部 Agent**)。若你加入了组织,在 **归属** 下拉框中选择目标组织或 **个人助理**。
|
|
70
|
+
2. 点击 **创建并连接**。Nia Teams 创建该外部 Agent,你成为它的 `owner`;主机终端完成签名验证,把凭证保存到 `~/.config/nia-teams-claude-code/credentials.json`,输出 `Paired: <Agent 名称> (@external-...)`。保持配对进程运行到退出码 `0`。
|
|
81
71
|
|
|
82
|
-
迁移已有 Agent
|
|
72
|
+
迁移已有 Agent 时,由该 Agent 的 `owner` 或 `admin` 切换到 **重绑已有外部 Agent**,选中目标后点击 **确认重新绑定**。
|
|
83
73
|
|
|
84
|
-

|
|
85
75
|
|
|
86
|
-
|
|
76
|
+
凭证保存在主机上,POSIX 目录权限为 `0700`、文件权限为 `0600`。配对与项目目录无关,后续启动使用同一配置目录。
|
|
87
77
|
|
|
88
78
|
```sh
|
|
89
|
-
|
|
79
|
+
nia-claude status
|
|
90
80
|
```
|
|
91
81
|
|
|
92
|
-
`status`
|
|
82
|
+
`status` 展示已保存的配对身份与地址;连接状态在下一步通过常驻进程和群聊状态栏验证。
|
|
93
83
|
|
|
94
|
-
### 第 3
|
|
84
|
+
### 第 3 步:启动守护进程
|
|
95
85
|
|
|
96
|
-
|
|
86
|
+
手动操作时可在交互终端以前台方式运行,日志保留在终端:
|
|
97
87
|
|
|
98
|
-
|
|
88
|
+
```sh
|
|
89
|
+
nia-claude start --cwd /path/to/workspace
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
后台运行或由本地 AI 启动时,使用脱离终端的进程:
|
|
99
93
|
|
|
100
94
|
```sh
|
|
101
95
|
# 跨平台后台启动(Windows PowerShell/CMD/Git Bash、macOS、Linux):
|
|
102
|
-
nia-claude start --cwd "
|
|
96
|
+
nia-claude start --cwd "/path/to/workspace" --daemon
|
|
103
97
|
|
|
104
98
|
# 仅 POSIX 的替代方式(不适用于 Windows):
|
|
105
|
-
nohup nia-claude start --cwd
|
|
99
|
+
nohup nia-claude start --cwd /path/to/workspace > /tmp/nia-claude.log 2>&1 &
|
|
106
100
|
sleep 2
|
|
107
101
|
cat /tmp/nia-claude.log
|
|
108
102
|
pgrep -af '[n]ia-claude.*start'
|
|
109
103
|
```
|
|
110
104
|
|
|
111
|
-
-
|
|
112
|
-
- SDK 设置 `strictMcpConfig: true`,启动时添加 `--strict-mcp-config`,仅使用本次传入的群聊 MCP 工具。用户、项目与本地设置仍参与权限规则和钩子处理。
|
|
113
|
-
- `send_message` 与 `chat_history` 在当前群聊作用域内执行;所有回复均需显式调用 `send_message`,轮次结束文本保持私有。
|
|
114
|
-
- `canUseTool` 收到工具权限请求时,在 TaskBar 弹出权限确认卡;`AskUserQuestion` 向发起人提问并等待群聊回复。已有允许规则不触发重复审批,`--full-auto` 选择 Claude Code 的 `bypassPermissions` 并跳过桥接确认。
|
|
115
|
-
- 同一凭证只运行一个 `start` 或 `mcp` 连接。macOS 上任务执行期间通过 `caffeinate` 防止系统休眠;SIGINT/SIGTERM 中止 SDK 查询并清理卡片与连接。
|
|
105
|
+
启动后建立到 `wss://nia-teams.com/ws/agent-bridge` 的认证连接。网络中断后使用指数退避重连;同一配对目录只由一个桥接进程持有。macOS 上任务执行期间通过 `caffeinate` 防止系统休眠,任务结束后释放。
|
|
116
106
|
|
|
117
|
-
|
|
107
|
+
各群聊的模型上下文彼此独立,但共享 `--cwd` 指定的代码目录、仓库和本地工具。凭证与会话记录分别保存在 `credentials.json` 和 `threads.json` 中。
|
|
118
108
|
|
|
119
|
-
|
|
109
|
+
#### SDK 会话、工具请求与提问
|
|
120
110
|
|
|
121
|
-
|
|
122
|
-
claude --dangerously-load-development-channels plugin:nia-teams@nia-teams
|
|
123
|
-
```
|
|
111
|
+
每个群聊在私有 `threads.json` 中保存 Claude Code 的 `session_id`,后续查询通过 `resume` 恢复。`SessionHost` 为同一群聊串行执行轮次,运行中到达的消息排队;群聊会话切换时中止旧查询并清理旧输入。每个群聊默认最多排队 64 条消息,输入队列与待发回复队列分别管理。
|
|
124
112
|
|
|
125
|
-
|
|
113
|
+
SDK 的 system、assistant 与 result 事件仅用于保存会话和同步活动状态。终端输出留在本机,群聊回复通过 `send_message` 发布。
|
|
126
114
|
|
|
127
|
-
|
|
115
|
+
`canUseTool` 收到的工具请求显示为 TaskBar 权限确认卡。`AskUserQuestion` 则发到群聊等待任务发起人回答;单题回复文字,多题回复按问题文本为键的 JSON,例如 `{"目标分支":"main","运行测试":"是"}`。回答超时或轮次取消时,Claude Agent SDK 收到拒绝结果。
|
|
128
116
|
|
|
129
|
-
|
|
117
|
+
用户、项目、本地设置中的 Claude Code 允许规则与钩子继续生效。`strictMcpConfig: true` 仅加载桥接提供的群聊工具服务。已经允许的工具可能不触发 SDK 权限回调;`--full-auto` 选择 bypassPermissions 并跳过桥接确认。Claude Code 登录凭证保留在主机上,Nia 配对不替代 Claude Code 登录。
|
|
130
118
|
|
|
131
|
-
|
|
119
|
+
### 第 4 步:把外部 Agent 拉进群聊并验证在线状态
|
|
132
120
|
|
|
133
|
-
|
|
134
|
-
codebuddy plugin marketplace add nia-teams/agent-bridge
|
|
135
|
-
codebuddy plugin install nia-teams@nia-teams --scope user
|
|
136
|
-
codebuddy --dangerously-load-development-channels plugin:nia-teams@nia-teams
|
|
137
|
-
```
|
|
121
|
+
点击配对成功页的 **前往群聊**,或打开 [Nia Teams](https://nia-teams.com) 进入左侧 **消息** 页:
|
|
138
122
|
|
|
139
|
-
|
|
123
|
+
- **发起新对话**:在消息列表顶部的 Agent 快捷栏点击刚创建的外部 Agent 头像发起对话(Agent 较多时可点快捷栏右侧下箭头展开),或点击快捷栏最右侧的 **`+`**(新建聊天)创建多人群聊。
|
|
124
|
+
- **拉进已有群聊**:打开已有群聊,点击右上角成员头像旁的 **`+`**(添加聊天成员),在 **邀请已有成员** 弹窗中勾选该外部 Agent 并点击 **完成**。同一组织成员可将组织归属的 Agent 拉入群;「个人助理」仅创建者可拉入群,加入后群内其他成员也可 `@` 它。
|
|
140
125
|
|
|
141
|
-
|
|
126
|
+
进入群聊后,查看底部输入框上方的状态栏:当该外部 Agent 的状态从红色的 **`未连接`** 变为 **`空闲待命`**,说明 Claude Code 桥接进程已经连通就绪。
|
|
142
127
|
|
|
143
|
-
### 第
|
|
128
|
+
### 第 5 步:在群聊中 `@` 它协作与日常管理
|
|
144
129
|
|
|
145
|
-
|
|
130
|
+
在输入框输入 `@` 选中该外部 Agent 并发送任务。执行时状态栏显示 `Thinking…` 或正在运行的工具,回复发回群聊。后续日常管理按权限分为三类:
|
|
146
131
|
|
|
147
|
-
|
|
132
|
+
- **临时离线(主机侧操作)**:以前台方式运行时,在主机终端按 `Ctrl+C` 停止 `nia-claude start`;后台运行时,对启动时记录的 PID 发送 SIGTERM。群内状态会变为 `未连接`,重新运行 `nia-claude start --cwd /path/to/workspace` 即可恢复连接。
|
|
133
|
+
- **更换主机或解绑主机(需该 Agent 的 `owner` 或 `admin`)**:迁移到新主机时,在新主机执行 `nia-claude pair`,在浏览器配对页切换到 **重绑已有外部 Agent**,选中目标后点击 **确认重新绑定**。若仅需解绑,在它的对话页或共同所在的群聊右上角打开应用菜单(网格图标 **Apps**)→ **Agent 设置**,点击 **解绑主机**。重绑或解绑会递增 `keyGeneration` 使旧主机凭证失效,并以关闭码 `4401` 断开旧连接。
|
|
134
|
+
- **停用归档(仅唯一 `owner` 可操作)**:当该外部 Agent 没有其他联系人且你是唯一 `owner` 时,在 **Agent 设置** 底部点击 **停用「<Agent 名称>」**,再点 **确认停用**,即可归档移除并断开在线连接。
|
|
148
135
|
|
|
149
|
-
|
|
136
|
+
### 常见问题排查(连不上怎么办)
|
|
150
137
|
|
|
151
|
-
-
|
|
152
|
-
- `
|
|
153
|
-
-
|
|
138
|
+
- **网页提示「配对请求已过期」**:配对链接有效期为 10 分钟,回到主机终端重新执行 `nia-claude pair`,再打开新链接。
|
|
139
|
+
- **`nia-claude status` 报错或绑定不是目标 Agent**:核对当前系统用户、配置目录和服务地址。若尚未完成配对,或旧主机凭证因重绑、解绑而失效,重新执行 `nia-claude pair` 并启动桥接进程。`status` 只显示保存的身份,不代表主机已在线。
|
|
140
|
+
- **群里一直显示红色 `未连接`**:确认 `nia-claude start` 进程仍在运行,检查 `/tmp/nia-claude.log` 中的启动或连接错误,并用 `nia-claude status` 核对群内 Agent 与保存的身份是否一致。若日志出现 `4409`,说明另一个连接接管了同一身份,应检查是否重复启动了进程。
|
|
141
|
+
- **Claude Code 未登录或启动失败**:先在同一系统用户下运行 Claude Code CLI,完成登录,确认 Node.js 版本和可执行文件路径。模型产品的登录与 Nia Teams 配对是两件事,不能互相替代。
|
|
142
|
+
- **任务已执行但没有回复**:检查守护进程日志中的运行或消息发布错误,确认任务未被取消,也未因群聊会话切换而中断。
|
|
154
143
|
|
|
155
|
-
|
|
144
|
+
## 三、CLI 参数、环境变量与包导出
|
|
156
145
|
|
|
157
|
-
|
|
146
|
+
```text
|
|
147
|
+
nia-claude connect --invite-code <code> [--user-name <name>] [--agent-name <name>]
|
|
148
|
+
[--no-browser] [--no-start] [--cwd <dir>] [--daemon] [--log-file <path>]
|
|
149
|
+
nia-claude pair [--server-url <origin>] [--config-dir <dir>] [--name <label>]
|
|
150
|
+
nia-claude status [--config-dir <dir>]
|
|
151
|
+
nia-claude start [--cwd <dir>] [--config-dir <dir>] [--model <model>]
|
|
152
|
+
[--full-auto] [--claude-bin <path>] [--daemon] [--log-file <path>]
|
|
153
|
+
nia-claude --help
|
|
154
|
+
```
|
|
158
155
|
|
|
159
|
-
|
|
156
|
+
- `connect`:使用邀请码接入;首次注册需提供 `--user-name` 与 `--agent-name`。接入后启动守护进程,已在运行时使用 `--no-start`。
|
|
157
|
+
- `--daemon`:脱离终端运行并打印 PID 与日志位置;`--log-file` 指定日志,默认 `<config-dir>/daemon.log`。可在 Windows PowerShell、CMD、Git Bash、macOS 和 Linux 使用。
|
|
158
|
+
- `--server-url`:配对服务 origin,优先级为参数、`NIA_TEAMS_URL`、`https://nia-teams.com`;后续命令读取保存的地址。
|
|
159
|
+
- `--config-dir`:参数优先于 `NIA_CLAUDE_CONFIG_DIR`,默认 `~/.config/nia-teams-claude-code`;pair、status、start 应指向同一目录。
|
|
160
|
+
- `--name`:配对主机标签,显示在浏览器和握手中;未传入时按宿主前缀与主机名生成。浏览器可另行填写 Agent 显示名。
|
|
161
|
+
- `--cwd`:项目工作目录,默认当前目录,启动时转为绝对路径;它不改变配对凭证位置。
|
|
162
|
+
- `--model`:传给 Claude Agent SDK 的模型名称;可用模型取决于 Claude Code 账号和配置。
|
|
163
|
+
- `--help` / `-h`:显示命令概览;无命令时也显示帮助。
|
|
164
|
+
- `--claude-bin / CLAUDE_BIN`:指定 Claude Code 可执行文件或 `.js` / `.mjs` / `.cjs` 入口。
|
|
165
|
+
- `--full-auto`:关闭桥接工具确认。
|
|
160
166
|
|
|
161
|
-
|
|
167
|
+
### 包导出与嵌入入口
|
|
162
168
|
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
-
|
|
166
|
-
|
|
167
|
-
|
|
169
|
+
| 入口 | 用途 |
|
|
170
|
+
| --- | --- |
|
|
171
|
+
| `nia-claude` | 主机配对、身份检查与守护进程 |
|
|
172
|
+
| `createClaudeRunner` | 创建供 SessionHost 使用的 SDK 运行器 |
|
|
173
|
+
| `resolveClaudeBinary` | 定位 Claude Code CLI |
|
|
174
|
+
| `SessionHost` | 群聊队列、会话恢复、取消与工具确认 |
|
|
175
|
+
| `dist/**/*.d.ts` | 导出函数、配置与运行时接口的类型声明 |
|
|
168
176
|
|
|
169
|
-
|
|
177
|
+
根模块通过具名导出提供接口,公开子路径为 `.` 与 `./package.json`。方法签名查询类型声明,运行时协议与 Claude Code 数据结构见 [docs/SPECIFICATION.md](./docs/SPECIFICATION.md)。
|
|
170
178
|
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
```
|
|
179
|
+
嵌入时把 `createClaudeRunner(options)` 交给 core 的 `runSessionDaemon`,或由接入方构造 `SessionHost` 管理生命周期。SDK 查询与群聊工具共用当前轮次的作用域,不由模型选择目标群聊。
|
|
180
|
+
|
|
181
|
+
## 四、权限确认、群聊工具与安全边界
|
|
182
|
+
|
|
183
|
+

|
|
177
184
|
|
|
178
|
-
|
|
179
|
-
- 凭证目录优先级:`--config-dir`、`NIA_CLAUDE_CONFIG_DIR`、`~/.config/nia-teams-claude-code`。
|
|
180
|
-
- `start` 的 `--cwd` 默认为当前目录;`--model` 指定 Claude Code 模型;`--claude-bin`、`CLAUDE_BIN`、本机常见安装目录依次选择 CLI;`--full-auto` 开启免确认执行。
|
|
181
|
-
- 默认主机标签 `claude-code@<hostname>`;配对超时 600000 ms,每 2 秒轮询。
|
|
182
|
-
- 有界内存 FIFO 队列在短暂断线后重试回复,保留原 Nia session 与发布 UUID;进程崩溃后不持久保存。
|
|
183
|
-
- 后台 `start` 为各群聊持久化独立 SDK 会话;交互式 `mcp` Channel 中,多个 GroupChat 共享一个宿主/模型上下文。权限请求无群聊 ID,优先路由到最近触发且处于 executing 的群聊,否则路由到最近触发的已跟踪群聊。尚无群聊消息时,终端请求保持本地处理。需要隔离时使用独立宿主身份与会话。
|
|
184
|
-
- Channel 模式的 executing/waiting 每 30 秒续租。权限卡在本地 5 分钟超时。宿主协议不发送远程提示已结束通知,因此终端先批准后远端卡片可能保留至超时;宿主忽略已关闭请求的后续 verdict。
|
|
185
|
-
- 后台模式取消会中止 SDK 查询、清理该群聊输入队列和待确认卡。Channel 模式的群聊取消会拒绝待确认权限、撤销卡片、取消排队回复并设为空闲;通知要求 Claude 停止对应任务,但 Channel 协议无法强制中断正在运行的本地工具。
|
|
186
|
-
- Channel 模式中,stdin end/close、SIGINT/SIGTERM/SIGHUP 与 stdin watchdog 均触发尽力清理和有时限退出。MCP stdout 仅含 JSON-RPC,诊断写 stderr。`4409` 表示新主机接管,旧连接停止重连。
|
|
185
|
+
### 1. TaskBar 签名确认流程
|
|
187
186
|
|
|
188
|
-
|
|
187
|
+
1. Claude Code 请求工具权限时,桥接在 TaskBar 弹出权限确认卡,并保存当前轮次与请求参数。
|
|
188
|
+
2. Nia Teams 校验点击者是外部 Agent 的有效 `owner`、`admin` 或 `member`,签发 `_meta["nia/confirmationToken"]`,随 `card.action` 送回主机。
|
|
189
|
+
3. core 通过 `@nia-teams/mcp-sdk/auth`,从 `${issuer}/oauth2/jwks` 获取公钥,验证 RS256 签名、issuer、`aud: nia-teams-workload`、有效期、service 身份与 `human_confirmed: true`。
|
|
190
|
+
4. 验证 `context_server: agent-bridge`、`context_tool: claude_code.permission`、canonical JSON 参数的 SHA-256 摘要及 `confirmation_card_id === cardId`。验证对象来自本机保存的请求,不从聊天正文重建。
|
|
191
|
+
5. 通过后只批准该次请求;缺失/无效 Token、忽略卡片、超时或取消均拒绝。待确认卡默认 5 分钟到期。
|
|
189
192
|
|
|
190
|
-
|
|
193
|
+
### 2. 群聊工具、消息与原生提及
|
|
191
194
|
|
|
192
|
-
|
|
195
|
+
Nia Teams 提供可用的协作工具,包括群聊管理、提醒和分享链接,运行时通过本机工具接口加载。
|
|
196
|
+
|
|
197
|
+
- `send_message({ content })` 向当前群聊发布 Markdown 或 Rich HTML,常用于进度与提问;所有回复均需显式发送,轮次结束文本保持私有。
|
|
198
|
+
- `chat_history({ limit?, offset? })` 分页读取历史;`limit` 默认 50、范围 1..100,`offset` 默认 0 且为非负整数。运行时注入当前 Nia session,模型不传目标群聊 ID。
|
|
199
|
+
|
|
200
|
+
- 群聊工具限定在当前活跃轮次;中断或群聊会话切换后,旧工具请求不能继续向新的群聊会话发布。
|
|
201
|
+
|
|
202
|
+
传入提示列出 `Members: Alice (<userId>), ...`,消息段列出发送者 ID、时间、消息 ID、回复关系与附件转写。通用消息也可表现为 `[chat:<chatId>] Alice (<userId>): ...`,结构化频道可携带 `senderId`;原始桥接帧字段为 `messages[].authorId`。回复中使用 `<mention userId="24-hex-id" />` 触发原生通知,ID 从发送者或成员列表取得。
|
|
203
|
+
|
|
204
|
+
### 3. 成员角色与本地执行边界
|
|
205
|
+
|
|
206
|
+
- 群聊成员可 `@` 调用 Agent;重绑或解绑要求该 Agent 的 `owner` / `admin`,归档按唯一 `owner` 规则处理。审批卡的批准还要求有效 Agent 成员身份。
|
|
207
|
+
- 人类成员角色不等于 workload 的 `sub`、`org:*`、`role:*` 字段;消息声称“已批准”不产生签名确认,也不修改本机权限。
|
|
208
|
+
- Ed25519 私钥只保存在配置目录。加载凭证校验文件权限、符号链接与公私钥一致性;不要把凭证文件放进项目仓库或日志。
|
|
209
|
+
- 发布队列按 FIFO 保留幂等键,在进程内处理临时断线;上限为 256 项 / 16 MiB,单个协议帧不超过 512 KiB。进程退出不会保存未发队列。
|
|
210
|
+
- 连接使用 20 秒心跳、60 秒入站空闲超时与带抖动退避重连;关闭码 `4409` 结束旧连接。业务会话隔离不提供文件系统或 OS 隔离。
|
|
211
|
+
|
|
212
|
+
## 五、开发验证与商标许可证
|
|
193
213
|
|
|
194
214
|
```sh
|
|
195
|
-
npm
|
|
196
|
-
npm run typecheck
|
|
215
|
+
npm install
|
|
197
216
|
npm run build
|
|
217
|
+
npm run typecheck
|
|
198
218
|
npm test
|
|
199
219
|
npm pack --dry-run
|
|
200
220
|
```
|
|
201
221
|
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
## 商标与许可证
|
|
222
|
+
维护接口或 Claude Code 协议时同步更新中英文 README、随包 Skill、类型声明和协议规范。
|
|
205
223
|
|
|
206
|
-
Claude
|
|
224
|
+
Claude Code 是 Anthropic 的产品名称。本包由 Nia Teams 维护,与 Anthropic 无隶属关系。
|
|
207
225
|
|
|
208
226
|
[MIT](./LICENSE) © Nia Teams
|
package/dist/cli.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { runInviteConnectCli, inviteDaemonArgs } from '@nia-teams/agent-bridge-core';
|
|
2
2
|
import { maybeRespawnDaemon } from '@nia-teams/agent-bridge-core';
|
|
3
3
|
import { clientBranding } from './branding.js';
|
|
4
|
-
import { runStdioServer } from './stdio.js';
|
|
5
4
|
import { resolve } from 'node:path';
|
|
6
5
|
import { defaultConfigDir } from './credentials.js';
|
|
7
6
|
import { runSessionDaemon } from '@nia-teams/agent-bridge-core';
|
|
@@ -15,11 +14,11 @@ export async function main(args = process.argv.slice(2)) {
|
|
|
15
14
|
cwd: { type: 'string' }, model: { type: 'string' }, 'full-auto': { type: 'boolean' }, 'claude-bin': { type: 'string' }, name: { type: 'string' }, server: { type: 'string' }, 'server-url': { type: 'string' }, 'config-dir': { type: 'string' }, label: { type: 'string' }, 'timeout-ms': { type: 'string' }, help: { type: 'boolean', short: 'h' },
|
|
16
15
|
} });
|
|
17
16
|
if (values.help || positionals.length === 0) {
|
|
18
|
-
console.log('nia-claude connect --invite-code <code> [--user-name <name>] [--agent-name <name>] [--no-browser] [--no-start] [--cwd <dir>] [--daemon] [--log-file <path>]\nnia-claude pair [--server-url <url>] [--config-dir <dir>] [--
|
|
17
|
+
console.log('nia-claude connect --invite-code <code> [--user-name <name>] [--agent-name <name>] [--no-browser] [--no-start] [--cwd <dir>] [--daemon] [--log-file <path>]\nnia-claude pair [--server-url <url>] [--config-dir <dir>] [--name <label>] [--timeout-ms <ms>]\nnia-claude start [--daemon] [--log-file <path>] [--config-dir <dir>] [--cwd <dir>] [--model <model>] [--full-auto] [--claude-bin <path>]\nnia-claude status [--config-dir <dir>]');
|
|
19
18
|
return;
|
|
20
19
|
}
|
|
21
20
|
if (positionals.length !== 1)
|
|
22
|
-
throw new Error('Expected one command: pair, status,
|
|
21
|
+
throw new Error('Expected one command: connect, pair, status, or start');
|
|
23
22
|
if (positionals[0] === 'connect') {
|
|
24
23
|
if (!values['invite-code'])
|
|
25
24
|
throw new Error('connect requires --invite-code');
|
|
@@ -48,9 +47,6 @@ export async function main(args = process.argv.slice(2)) {
|
|
|
48
47
|
...clientBranding, configDir: resolve(values['config-dir'] ?? defaultConfigDir()), runtime: 'Claude Code', approvalTool: 'claude_code.permission', fullAuto: values['full-auto'],
|
|
49
48
|
});
|
|
50
49
|
}
|
|
51
|
-
else if (positionals[0] === 'mcp') {
|
|
52
|
-
await runStdioServer(values['config-dir']);
|
|
53
|
-
}
|
|
54
50
|
else if (positionals[0] === 'status') {
|
|
55
51
|
const credentials = await loadCredentials(values['config-dir']);
|
|
56
52
|
console.log(`Agent: ${credentials.agentName} (@${credentials.agentSlug})\nServer: ${credentials.serverUrl}\nTeam: ${credentials.teamId}\nKey generation: ${credentials.keyGeneration}\nConfig: ${values['config-dir'] ?? defaultConfigDir()}`);
|
|
@@ -58,6 +54,6 @@ export async function main(args = process.argv.slice(2)) {
|
|
|
58
54
|
console.log('Challenge/lease authentication: OK');
|
|
59
55
|
}
|
|
60
56
|
else
|
|
61
|
-
throw new Error('Unknown command; use nia-claude pair, status, or
|
|
57
|
+
throw new Error('Unknown command; use nia-claude connect, pair, status, or start');
|
|
62
58
|
}
|
|
63
59
|
//# sourceMappingURL=cli.js.map
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE;YACjF,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACxK,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3D,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;SACrV,EAAE,CAAC,CAAC;IACL,IAAI,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,+aAA+a,CAAC,CAAC;QAC7b,OAAO;IACT,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACvG,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC5D,MAAM,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,mBAAmB,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,cAAc;YACtI,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC;YACjG,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAClI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;YAAE,MAAM,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,gBAAgB,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,gBAAgB,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;QAClO,OAAO;IACT,CAAC;IACD,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC9B,MAAM,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK;YAC7I,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;SACzF,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QACtC,IAAI,MAAM,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,gBAAgB,EAAE,EAAE,YAAY,CAAC,CAAC;YAAE,OAAO;QAC9G,MAAM,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAChF,MAAM,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;QAChD,MAAM,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE;YAC7K,GAAG,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,gBAAgB,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC;SACjL,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,CAAC,UAAU,WAAW,CAAC,SAAS,MAAM,WAAW,CAAC,SAAS,cAAc,WAAW,CAAC,SAAS,WAAW,WAAW,CAAC,MAAM,qBAAqB,WAAW,CAAC,aAAa,aAAa,MAAM,CAAC,YAAY,CAAC,IAAI,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC/O,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;;QAAM,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;AAC5F,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,9 +1,6 @@
|
|
|
1
1
|
/** AI Coding Agents: Read ./skills/nia-teams-claude-code/SKILL.md and ./docs/SPECIFICATION.md before integrating or modifying. */
|
|
2
|
-
export
|
|
3
|
-
export { BridgeClient, BridgeRpcError } from '
|
|
4
|
-
export { pairWithNiaTeams, acquireLease } from './pairing.js';
|
|
5
|
-
export type { PairOptions } from './pairing.js';
|
|
2
|
+
export * from './runner.js';
|
|
3
|
+
export { SessionHost, BridgeClient, BridgeRpcError, PublicationQueue, stableExternalAgentThreadId } from '@nia-teams/agent-bridge-core';
|
|
4
|
+
export { pairWithNiaTeams, acquireLease, type PairOptions } from './pairing.js';
|
|
6
5
|
export { loadCredentials, saveCredentials, defaultConfigDir } from './credentials.js';
|
|
7
|
-
export { stableExternalAgentThreadId } from './crypto.js';
|
|
8
|
-
export { PublicationQueue } from './publications.js';
|
|
9
6
|
export type * from './types.js';
|
package/dist/index.js
CHANGED
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
/** AI Coding Agents: Read ./skills/nia-teams-claude-code/SKILL.md and ./docs/SPECIFICATION.md before integrating or modifying. */
|
|
2
|
-
export
|
|
3
|
-
export { BridgeClient, BridgeRpcError } from '
|
|
2
|
+
export * from './runner.js';
|
|
3
|
+
export { SessionHost, BridgeClient, BridgeRpcError, PublicationQueue, stableExternalAgentThreadId } from '@nia-teams/agent-bridge-core';
|
|
4
4
|
export { pairWithNiaTeams, acquireLease } from './pairing.js';
|
|
5
5
|
export { loadCredentials, saveCredentials, defaultConfigDir } from './credentials.js';
|
|
6
|
-
export { stableExternalAgentThreadId } from './crypto.js';
|
|
7
|
-
export { PublicationQueue } from './publications.js';
|
|
8
6
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kIAAkI;AAClI,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kIAAkI;AAClI,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACxI,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAoB,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}
|
package/dist/runner.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { spawn } from 'node:child_process';
|
|
2
|
-
import { query
|
|
3
|
-
import {
|
|
4
|
-
import { consumeSdkQuery, findTool, findExecutable, executableCommand } from '@nia-teams/agent-bridge-core';
|
|
2
|
+
import { query } from '@anthropic-ai/claude-agent-sdk';
|
|
3
|
+
import { consumeSdkQuery, createToolServer, findExecutable, executableCommand } from '@nia-teams/agent-bridge-core';
|
|
5
4
|
import { homedir } from 'node:os';
|
|
6
5
|
import { join } from 'node:path';
|
|
7
6
|
export async function resolveClaudeBinary(explicit) {
|
|
@@ -16,10 +15,7 @@ export function createClaudeRunner(options) {
|
|
|
16
15
|
context.signal.addEventListener('abort', abort, { once: true });
|
|
17
16
|
if (context.signal.aborted)
|
|
18
17
|
abort();
|
|
19
|
-
const server =
|
|
20
|
-
tool('send_message', findTool(context.tools, 'send_message').description, { content: z.string().trim().min(1) }, async ({ content }) => { await context.send(content); return { content: [{ type: 'text', text: '消息已发布到聊天' }] }; }),
|
|
21
|
-
tool('chat_history', findTool(context.tools, 'chat_history').description, { limit: z.number().int().min(1).max(100).optional(), offset: z.number().int().min(0).optional() }, async ({ limit, offset }) => ({ content: [{ type: 'text', text: JSON.stringify(await context.history(limit, offset)) }] })),
|
|
22
|
-
] });
|
|
18
|
+
const server = { type: 'sdk', name: 'nia', instance: createToolServer(context, true) };
|
|
23
19
|
try {
|
|
24
20
|
return await consumeSdkQuery(query({ prompt: context.prompt, options: {
|
|
25
21
|
// The SDK recognizes .js/.mjs itself; its hook handles custom batch
|
|
@@ -29,15 +25,12 @@ export function createClaudeRunner(options) {
|
|
|
29
25
|
return spawn(command.file, command.args, { ...command.options, cwd: options.cwd, env: options.env, signal: options.signal, stdio: ['pipe', 'pipe', 'pipe'] });
|
|
30
26
|
} } : {}),
|
|
31
27
|
pathToClaudeCodeExecutable: binary, cwd: options.cwd, model: options.model, resume: context.resume,
|
|
32
|
-
// User/project settings may launch the legacy channel plugin. Its child
|
|
33
|
-
// must not acquire a second bridge connection and supersede this daemon.
|
|
34
|
-
env: { ...process.env, NIA_CLAUDE_DAEMON: '1' },
|
|
35
28
|
abortController: controller, permissionMode: options.fullAuto ? 'bypassPermissions' : 'default', allowDangerouslySkipPermissions: Boolean(options.fullAuto),
|
|
36
29
|
settingSources: ['user', 'project', 'local'], systemPrompt: { type: 'preset', preset: 'claude_code', append: context.systemPrompt },
|
|
37
30
|
mcpServers: { nia: server }, strictMcpConfig: true,
|
|
38
31
|
canUseTool: async (name, input, detail) => {
|
|
39
|
-
//
|
|
40
|
-
if (name
|
|
32
|
+
// Collaboration tools own their server-side authorization and confirmations.
|
|
33
|
+
if (name.startsWith('mcp__nia__'))
|
|
41
34
|
return { behavior: 'allow', updatedInput: input };
|
|
42
35
|
const result = await context.permission(name, input, detail.signal);
|
|
43
36
|
return result.behavior === 'allow' ? { behavior: 'allow', updatedInput: result.updatedInput ?? input } : { behavior: 'deny', message: result.message ?? 'Denied' };
|
package/dist/runner.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}
|