@nia-teams/workbuddy-plugin 0.0.0-stage → 0.1.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/LICENSE +21 -0
- package/README.md +220 -2
- package/README_CN.md +222 -0
- package/bin/nia-workbuddy.mjs +3 -0
- package/dist/branding.d.ts +5 -0
- package/dist/branding.js +6 -0
- package/dist/branding.js.map +1 -0
- package/dist/cli.d.ts +1 -0
- package/dist/cli.js +35 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -0
- package/dist/runner.d.ts +9 -0
- package/dist/runner.js +241 -0
- package/dist/runner.js.map +1 -0
- package/docs/SPECIFICATION.md +36 -0
- package/docs/assets/agent-pairing.png +0 -0
- package/docs/assets/group-chat-overview.png +0 -0
- package/docs/assets/taskbar-approval.png +0 -0
- package/docs/upstream/codebuddy-help.txt +106 -0
- package/docs/upstream/sdk-types.txt +1602 -0
- package/package.json +50 -4
- package/skills/nia-teams-workbuddy/SKILL.md +43 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Nia Teams
|
|
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/README.md
CHANGED
|
@@ -1,3 +1,221 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @nia-teams/workbuddy-plugin
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
English | [简体中文](./README_CN.md)
|
|
4
|
+
|
|
5
|
+
Connect **WorkBuddy (CodeBuddy)** into [Nia Teams](https://nia-teams.com) as an Agent in Nia Teams with **two-way communication**.
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npm install -g @nia-teams/workbuddy-plugin
|
|
9
|
+
nia-workbuddy pair --name 'My WorkBuddy / CodeBuddy'
|
|
10
|
+
nia-workbuddy start --cwd "." --daemon
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
AI coding agents: load [skills/nia-teams-workbuddy/SKILL.md](./skills/nia-teams-workbuddy/SKILL.md); installed path: `node_modules/@nia-teams/workbuddy-plugin/skills/nia-teams-workbuddy/SKILL.md`.
|
|
14
|
+
|
|
15
|
+
## 1. Product Overview & Collaboration Model
|
|
16
|
+
|
|
17
|
+
The package runs tasks through the CodeBuddy Agent SDK using local desktop or CLI authentication. Each GroupChat retains its session, and teammates approve tool requests in TaskBar.
|
|
18
|
+
|
|
19
|
+
- **Create and bind in one flow, without precreating an Agent or distributing static keys**: Start pairing on the WorkBuddy / CodeBuddy host, sign in to Nia Teams from a browser on any device, create the external Agent, and bind the host public key. The private key stays on the host.
|
|
20
|
+
- **Live presence and per-GroupChat conversation history**: The composer activity strip shows disconnected, idle, executing, or waiting state. Each chat retains its own CodeBuddy session for later turns; the host workspace is shared.
|
|
21
|
+
- **TaskBar approvals and mid-turn tools**: Permission requests display tool names and arguments for Agent-member approval; model tools publish progress and read GroupChat history.
|
|
22
|
+
|
|
23
|
+

|
|
24
|
+
|
|
25
|
+
| Concern | Local host | This package | Nia Teams |
|
|
26
|
+
| --- | --- | --- | --- |
|
|
27
|
+
| Agent runtime | Models, tools, workspace, CodeBuddy sign-in | Chat-to-runtime sessions, queries, cancellation | External Agent identity and scope |
|
|
28
|
+
| Connection and auth | Local Node process and WorkBuddy desktop app or CodeBuddy CLI | Ed25519 credentials, WebSocket, reconnection | Browser pairing, challenge/lease, delivery |
|
|
29
|
+
| Conversation | Inference turns and local tasks | Prompt formatting, session resume, publication | Timeline, members, activity |
|
|
30
|
+
| Approval and safety | CodeBuddy tool permissions and execution scope | Display tool permission requests as TaskBar cards, verify RS256, match pending actions | TaskBar, Agent membership, signed approvals |
|
|
31
|
+
|
|
32
|
+
## 2. Five-Step Quick Start
|
|
33
|
+
|
|
34
|
+
Prerequisites: Node.js 20+, a signed-in WorkBuddy desktop app or CodeBuddy CLI, and a Nia Teams account. No external Agent needs to be created in advance.
|
|
35
|
+
|
|
36
|
+
### Step 1: Install the bridge and prepare the host
|
|
37
|
+
|
|
38
|
+
Sign in to the WorkBuddy desktop app, then install:
|
|
39
|
+
|
|
40
|
+
```sh
|
|
41
|
+
npm install -g @nia-teams/workbuddy-plugin
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Discovery covers PATH, `/Applications/WorkBuddy.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy`, the user Applications directory, and common CLI locations. If a desktop distribution includes `dist/codebuddy-lite-wb.mjs`, the bridge selects that readable ESM entry for the SDK instead of opening the desktop wrapper. Standalone CodeBuddy installations retain their own entry.
|
|
45
|
+
|
|
46
|
+
Desktop credential decryption runs the app’s Electron with `ELECTRON_RUN_AS_NODE=1` and an empty inherited `NODE_OPTIONS`. This Node mode does not start desktop UI or steal macOS window focus. Decrypted values stay in memory; concurrent requests share decryption, and credential-file mtime changes trigger refresh. Existing plaintext sign-in or an explicit `CODEBUDDY_AUTH_TOKEN` skips Electron decryption.
|
|
47
|
+
|
|
48
|
+
For standalone CodeBuddy CLI, complete that CLI’s own login, then select it through PATH, `CODEBUDDY_BIN`, or `--codebuddy-bin`. The SDK executable option is `pathToCodebuddyCode`; the bridge retains `user`, `project`, and `local` settings and CodeBuddy authentication from the local environment.
|
|
49
|
+
|
|
50
|
+
### Step 2: Pair the host and create an Agent in the browser
|
|
51
|
+
|
|
52
|
+
```sh
|
|
53
|
+
nia-workbuddy status
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Check the saved `Agent:`, `Server:`, and config directory first. Reuse an existing intended binding; pair for first setup or an intentional Agent change:
|
|
57
|
+
|
|
58
|
+
```sh
|
|
59
|
+
nia-workbuddy pair --name 'My WorkBuddy / CodeBuddy'
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
The terminal generates an Ed25519 keypair locally and prints a pairing link valid for 10 minutes:
|
|
63
|
+
|
|
64
|
+
```text
|
|
65
|
+
Pairing code: A7F39C2B
|
|
66
|
+
Open this URL to create or bind your external Agent:
|
|
67
|
+
https://nia-teams.com/bridge/agent-pair/A7F39C2B
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Open the link in a browser on any device and sign in to Nia Teams:
|
|
71
|
+
|
|
72
|
+
1. Keep **Create external Agent** selected, enter the Agent name, and choose Personal Assistant or an organization you belong to. The creator becomes the Agent’s `owner`.
|
|
73
|
+
2. Click **Create & Connect**. To migrate an existing Agent, select **Rebind existing external Agent** as its `owner` or `admin`, select the target, and confirm the new binding; the old host disconnects.
|
|
74
|
+
|
|
75
|
+

|
|
76
|
+
|
|
77
|
+
Wait for `Paired: <Agent name> (@external-...)` and exit code `0` in the terminal. After proving private-key possession, the host saves `credentials.json` under `~/.config/nia-teams-workbuddy/`, using POSIX `0700` directory and `0600` file modes. Pairing is independent of the project directory; later startup reads the same config directory.
|
|
78
|
+
|
|
79
|
+
```sh
|
|
80
|
+
nia-workbuddy status
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
`status` shows the saved identity and server; verify the running connection through the daemon and GroupChat presence in the next steps.
|
|
84
|
+
|
|
85
|
+
### Step 3: Start the daemon
|
|
86
|
+
|
|
87
|
+
For manual operation, run in an interactive foreground terminal with logs visible:
|
|
88
|
+
|
|
89
|
+
```sh
|
|
90
|
+
nia-workbuddy start --cwd /path/to/workspace
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
For detached operation or local AI setup, launch in the background:
|
|
94
|
+
|
|
95
|
+
```sh
|
|
96
|
+
# Portable background launch (Windows PowerShell/CMD/Git Bash, macOS, Linux):
|
|
97
|
+
nia-workbuddy start --cwd "/path/to/workspace" --daemon
|
|
98
|
+
|
|
99
|
+
# POSIX-only alternative (not Windows):
|
|
100
|
+
nohup nia-workbuddy start --cwd /path/to/workspace > /tmp/nia-workbuddy.log 2>&1 &
|
|
101
|
+
sleep 2
|
|
102
|
+
cat /tmp/nia-workbuddy.log
|
|
103
|
+
pgrep -af '[n]ia-workbuddy.*start'
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
Startup opens an authenticated connection to `wss://nia-teams.com/ws/agent-bridge`. Network interruptions reconnect with exponential backoff. Run one bridge per paired config directory. On macOS, `caffeinate` prevents system sleep while a task runs and is released when the task finishes.
|
|
107
|
+
|
|
108
|
+
GroupChats have separate model contexts but share the files, repository, and local tools under `--cwd`. Credentials and session records are stored separately in `credentials.json` and `threads.json`.
|
|
109
|
+
|
|
110
|
+
#### SDK sessions, tool requests, and questions
|
|
111
|
+
|
|
112
|
+
Private `threads.json` stores each GroupChat’s CodeBuddy `session_id`; later queries pass it as `resume`. `SessionHost` serializes turns within a chat and queues incoming messages. Nia session rotation aborts the old query and clears old inputs. Each chat admits up to 64 queued messages by default; input admission and outgoing publication queues are separate.
|
|
113
|
+
|
|
114
|
+
The bridge uses `query({ prompt, options })` and cancels through `AbortController` and the CodeBuddy query interrupt path. It consumes system, assistant, and result events; a successful result supplies the main final reply, rather than treating Subagent intermediate text as a root reply. Final replies and explicit GroupChat sends share publication state.
|
|
115
|
+
|
|
116
|
+
Tool requests delivered to `canUseTool` become TaskBar cards. `AskUserQuestion` instead posts to GroupChat and waits for the task’s invoking human. Reply with text for one question; for multiple questions, use JSON keyed by question text, such as `{"Target branch":"main","Run tests":"yes"}`. Timeout or cancellation returns a deny result to the CodeBuddy Agent SDK.
|
|
117
|
+
|
|
118
|
+
CodeBuddy allow rules and hooks from user, project, and local settings remain effective. Already-allowed tools may not reach the SDK permission callback; `--full-auto` selects bypassPermissions and skips bridge confirmation. CodeBuddy authentication belongs to the model host; Nia pairing does not replace CodeBuddy login.
|
|
119
|
+
|
|
120
|
+
### Step 4: Invite the external Agent and verify presence
|
|
121
|
+
|
|
122
|
+
Click **Go to GroupChat** on the pairing confirmation page, or open Nia Teams **Messages** in the left navigation:
|
|
123
|
+
|
|
124
|
+
- **Start a new conversation**: Click the external Agent avatar in the quick strip above the chat list; expand the strip when it overflows. The `+` at its right creates a multi-person GroupChat.
|
|
125
|
+
- **Invite into an existing chat**: Open the GroupChat, click `+` beside member avatars in the upper-right header, select the Agent in **Invite existing members**, and click **Done**.
|
|
126
|
+
- **Invitation roles**: Organization members can invite organization-affiliated Agents. The creator initially invites a Personal Assistant; other members of that GroupChat may then invoke it.
|
|
127
|
+
|
|
128
|
+
Watch the activity strip above the composer: red **Disconnected** changes to **Idle / Ready** when the host connects. Match the chat Agent to the identity shown by `status`, then send a short task to verify a reply.
|
|
129
|
+
|
|
130
|
+
### Step 5: Mention the Agent and manage its lifecycle
|
|
131
|
+
|
|
132
|
+
Type `@` in the composer and select the external Agent. Its activity becomes executing while the task runs, and the final reply returns to GroupChat. Incoming prompts include title, URL, members, sender, messages, and attachment transcripts. Notify a person with their ID: `<mention userId="24-hex-id" />`, rather than plain `@Name`.
|
|
133
|
+
|
|
134
|
+
- **Temporary offline**: Press `Ctrl+C` in the foreground terminal or send SIGTERM to the recorded background PID. Presence becomes **Disconnected**. Restart loads existing credentials and session mappings.
|
|
135
|
+
- **Move or unpair a host**: An Agent `owner` / `admin` pairs the new host and selects **Rebind existing external Agent**. To unpair only, use **Apps → Agent Settings → Unpair host** in a shared chat’s upper-right header. Rebind/unpair increments `keyGeneration` to invalidate old host credentials and disconnects the old host with `4401`. A competing connection taking over the same identity closes the old connection with `4409`, stopping reconnects.
|
|
136
|
+
- **Deactivate and archive**: When no other contacts remain and you are the sole `owner`, use **Agent Settings → Deactivate “Agent name” → Confirm**. Archiving revokes the Agent’s online connections.
|
|
137
|
+
|
|
138
|
+
### Troubleshooting
|
|
139
|
+
|
|
140
|
+
- **Pairing request expired**: Links last 10 minutes. Run `nia-workbuddy pair` again on the host and open the new URL.
|
|
141
|
+
- **status fails**: Check OS user, config directory, file permissions, and completed pairing. A locally operated re-pair may be needed after rebind/unpair; diagnose network and origin failures before replacing credentials.
|
|
142
|
+
- **Chat stays red Disconnected**: Inspect the daemon, `/tmp/nia-workbuddy.log`, saved Server, and chat Agent identity. Check for another process using the credentials. Close code `4409` means another connection took over.
|
|
143
|
+
- **CodeBuddy login or startup fails**: Run the WorkBuddy desktop app or CodeBuddy CLI under the same OS user, sign in, and verify Node version and binary selection. CodeBuddy sign-in and Nia pairing are separate.
|
|
144
|
+
- **Execution without a reply**: Inspect CodeBuddy results and publication errors. Check cancellation, session rotation, and final text. A successful explicit GroupChat send suppresses duplicate final text for that turn.
|
|
145
|
+
|
|
146
|
+
## 3. CLI, Environment & Package Exports
|
|
147
|
+
|
|
148
|
+
```text
|
|
149
|
+
nia-workbuddy pair [--server-url <origin>] [--config-dir <dir>] [--name <label>]
|
|
150
|
+
nia-workbuddy status [--config-dir <dir>]
|
|
151
|
+
nia-workbuddy start [--cwd <dir>] [--config-dir <dir>] [--model <model>]
|
|
152
|
+
[--full-auto] [--codebuddy-bin <path>]
|
|
153
|
+
nia-workbuddy --help
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
- `--server-url`: Pairing origin; precedence is flag, `NIA_TEAMS_URL`, then `https://nia-teams.com`. Later commands use the saved origin.
|
|
157
|
+
- `--config-dir`: Explicit path overrides `NIA_WORKBUDDY_CONFIG_DIR` and defaults to `~/.config/nia-teams-workbuddy`. Use the same directory for pair, status, and start.
|
|
158
|
+
- `--name`: Pairing host label shown in browser and handshake; omission generates a host-prefixed machine label. The Agent display name can be changed in the browser.
|
|
159
|
+
- `--cwd`: Project working directory; defaults to the current directory and resolves to an absolute path. It does not move credentials.
|
|
160
|
+
- `--model`: Model name passed to the selected CodeBuddy runtime; available models depend on the CodeBuddy account and settings.
|
|
161
|
+
- `--help` / `-h`: Show command overview; no command also displays help.
|
|
162
|
+
- `--codebuddy-bin / CODEBUDDY_BIN`: Select a CodeBuddy executable or readable `.mjs` / `.js` entry.
|
|
163
|
+
- `--full-auto`: Disable bridge tool confirmations.
|
|
164
|
+
|
|
165
|
+
### Exports and embedding
|
|
166
|
+
|
|
167
|
+
| Entrypoint | Purpose |
|
|
168
|
+
| --- | --- |
|
|
169
|
+
| `nia-workbuddy` | Pairing, identity inspection, and daemon |
|
|
170
|
+
| `createWorkBuddyRunner` | Create an SDK runner for SessionHost |
|
|
171
|
+
| `resolveCodeBuddyBinary` | Locate the standalone CLI or desktop entry |
|
|
172
|
+
| `SessionHost` | GroupChat queues, session resume, cancellation, and approvals |
|
|
173
|
+
| `dist/**/*.d.ts` | Exported functions, options, and runtime interfaces |
|
|
174
|
+
|
|
175
|
+
The root module provides named exports; public export-map paths are `.` and `./package.json`. Read declarations for exact signatures and [docs/SPECIFICATION.md](./docs/SPECIFICATION.md) for runtime and CodeBuddy contracts.
|
|
176
|
+
|
|
177
|
+
For embedding, pass `createWorkBuddyRunner(options)` to core `runSessionDaemon`, or own a `SessionHost` lifecycle. SDK queries and GroupChat tools share the active turn scope; models do not choose a destination chat.
|
|
178
|
+
|
|
179
|
+
## 4. Approvals, GroupChat Tools & Security Boundaries
|
|
180
|
+
|
|
181
|
+

|
|
182
|
+
|
|
183
|
+
### 1. Signed TaskBar approval flow
|
|
184
|
+
|
|
185
|
+
1. A CodeBuddy tool permission request opens a TaskBar confirmation card bound to the current turn and request arguments.
|
|
186
|
+
2. Nia Teams checks that the clicker is an active Agent `owner`, `admin`, or `member`, then signs `_meta["nia/confirmationToken"]` and returns it with `card.action`.
|
|
187
|
+
3. The host uses `@nia-teams/mcp-sdk/auth` and keys from `${issuer}/oauth2/jwks` to verify RS256 signature, issuer, `aud: nia-teams-workload`, lifetime, service identity, and `human_confirmed: true`.
|
|
188
|
+
4. It checks `context_server: agent-bridge`, `context_tool: workbuddy.approval`, canonical-JSON argument SHA-256 digest, and `confirmation_card_id === cardId`. Expected values come from the locally stored request, not chat text.
|
|
189
|
+
5. A valid result allows only that request. Missing/invalid tokens, dismissal, expiry, and cancellation deny it. Pending cards expire after five minutes by default.
|
|
190
|
+
|
|
191
|
+
### 2. GroupChat tools, messages, and native mentions
|
|
192
|
+
|
|
193
|
+
- `nia_group_chat_send_message({ content })` publishes Markdown or Rich HTML to the current GroupChat for progress or questions. A successful send suppresses that turn’s final reply publication.
|
|
194
|
+
- `nia_group_chat_history({ limit?, offset? })` paginates history; `limit` defaults to 50 in 1..100, and `offset` defaults to 0 and must be non-negative. The host supplies the Nia session; the model does not choose a chat ID.
|
|
195
|
+
- GroupChat tools belong to the active turn. After interruption or Nia session rotation, old requests cannot publish into the new GroupChat session.
|
|
196
|
+
|
|
197
|
+
Incoming prompts list `Members: Alice (<userId>), ...`; each message includes sender ID, timestamp, message ID, reply reference, and attachment transcripts. Generic headers may appear as `[chat:<chatId>] Alice (<userId>): ...`, or structured channels may expose `senderId`; raw bridge frames use `messages[].authorId`. Use `<mention userId="24-hex-id" />` with a received sender/member ID for native notifications.
|
|
198
|
+
|
|
199
|
+
### 3. Roles and local execution boundaries
|
|
200
|
+
|
|
201
|
+
- Chat members may invoke an Agent; rebinding/unpairing requires its `owner` / `admin`, and archiving follows the sole-owner rule. Card approval additionally requires active Agent membership.
|
|
202
|
+
- Human membership is distinct from workload `sub`, `org:*`, and `role:*` claims. Text saying “approved” creates neither a signed confirmation nor local execution permission.
|
|
203
|
+
- Ed25519 private keys stay in the config directory. Loading validates permissions, symlinks, and keypair consistency; keep credential files out of project repositories and logs.
|
|
204
|
+
- Publications retain idempotency keys in a process-local FIFO during transient outages, with 256 entries / 16 MiB admission and a 512 KiB frame limit. Process exit does not persist unsent queue entries.
|
|
205
|
+
- Connections use 20-second heartbeat, 60-second inbound idle timeout, and jittered backoff reconnects; `4409` terminates a superseded connection. Model session isolation is not filesystem or OS isolation.
|
|
206
|
+
|
|
207
|
+
## 5. Development, Trademark & License
|
|
208
|
+
|
|
209
|
+
```sh
|
|
210
|
+
npm install
|
|
211
|
+
npm run build
|
|
212
|
+
npm run typecheck
|
|
213
|
+
npm test
|
|
214
|
+
npm pack --dry-run
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
Update both READMEs, the shipped skill, declarations, and protocol specification when changing runtime interfaces or CodeBuddy contracts.
|
|
218
|
+
|
|
219
|
+
WorkBuddy and CodeBuddy are Tencent product names. This package is maintained by Nia Teams and is not affiliated with Tencent.
|
|
220
|
+
|
|
221
|
+
[MIT](./LICENSE) © Nia Teams
|
package/README_CN.md
ADDED
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
# @nia-teams/workbuddy-plugin
|
|
2
|
+
|
|
3
|
+
[English](./README.md) | 简体中文
|
|
4
|
+
|
|
5
|
+
把本地 **WorkBuddy(CodeBuddy)** 接入到 [Nia Teams](https://nia-teams.com) 里,作为一个 Nia Teams 里的 Agent 与群聊成员**双向通讯**。
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npm install -g @nia-teams/workbuddy-plugin
|
|
9
|
+
nia-workbuddy pair --name 'My WorkBuddy / CodeBuddy'
|
|
10
|
+
nia-workbuddy start --cwd "." --daemon
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
AI 编程助手请加载 [skills/nia-teams-workbuddy/SKILL.md](./skills/nia-teams-workbuddy/SKILL.md);安装后路径为 `node_modules/@nia-teams/workbuddy-plugin/skills/nia-teams-workbuddy/SKILL.md`。
|
|
14
|
+
|
|
15
|
+
## 一、产品背景与协作模型
|
|
16
|
+
|
|
17
|
+
本包通过 CodeBuddy Agent SDK 执行任务,复用桌面应用或 CLI 的本机登录。群聊各自保存会话,团队成员通过 TaskBar 确认工具请求。
|
|
18
|
+
|
|
19
|
+
- **一步创建并绑定,无需预先建 Agent 或配置 API Key**:在主机终端运行配对命令,在任意设备的浏览器打开生成的链接并登录 Nia Teams,即可新建外部 Agent 并绑定主机公钥。
|
|
20
|
+
- **群聊实时状态与多轮会话隔离**:群聊底部显示该外部 Agent 的在线状态(`未连接`、`空闲待命`、`Thinking…`、`等待确认`)。每个群聊使用独立的 CodeBuddy 会话,后续任务沿用该群聊上下文;各群聊共享主机上的代码目录。
|
|
21
|
+
- **TaskBar 权限确认与提问交互**:当 WorkBuddy / CodeBuddy 请求执行命令、修改文件等操作的权限时,群聊底部 TaskBar 会弹出权限确认卡。该 Agent 的成员可点击 **允许执行**;普通提问在群消息中等待回复。
|
|
22
|
+
|
|
23
|
+

|
|
24
|
+
|
|
25
|
+
| 模块 | 本地宿主 | 本包 | Nia Teams |
|
|
26
|
+
| --- | --- | --- | --- |
|
|
27
|
+
| Agent 运行时 | 模型、工具、工作目录与 CodeBuddy 登录 | 群聊到运行时会话映射、查询与取消 | 外部 Agent 身份与归属 |
|
|
28
|
+
| 连接与认证 | 本机 Node.js 进程与 WorkBuddy 桌面端或 CodeBuddy CLI | Ed25519 凭证、WebSocket 长连接与重连 | 浏览器配对、challenge/lease 与消息投递 |
|
|
29
|
+
| 群聊对话 | 推理轮次与本地任务 | 提示格式、会话恢复与回复发布 | 群聊时间线、成员与活动状态 |
|
|
30
|
+
| 人工确认与安全边界 | CodeBuddy 工具权限与执行范围 | 将工具权限请求显示为 TaskBar 确认卡、RS256 验签与请求匹配 | TaskBar 卡片、Agent 成员权限与签名 |
|
|
31
|
+
|
|
32
|
+
## 二、五步快速接入(从零到在群里对话)
|
|
33
|
+
|
|
34
|
+
前提条件:运行桥接的主机已安装 Node.js 20+,并已在同一系统用户下完成 WorkBuddy 桌面端或 CodeBuddy CLI 的登录;还需要一个 [Nia Teams](https://nia-teams.com) 账号,不需要提前创建 Agent。
|
|
35
|
+
|
|
36
|
+
### 第 1 步:安装桥接包与准备宿主环境
|
|
37
|
+
|
|
38
|
+
先在主机的 WorkBuddy 桌面端完成登录,再安装桥接包;使用独立 CodeBuddy CLI 的方式见下文:
|
|
39
|
+
|
|
40
|
+
```sh
|
|
41
|
+
npm install -g @nia-teams/workbuddy-plugin
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
桌面发现依次涵盖 PATH、`/Applications/WorkBuddy.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy`、用户 Applications 目录及常见 CLI 安装路径。桌面发行版带有 `dist/codebuddy-lite-wb.mjs` 时,桥接选择该可读 ESM 入口交给 SDK,不依赖桌面包装器启动窗口。独立 CodeBuddy CLI 保持其原有入口。
|
|
45
|
+
|
|
46
|
+
桌面凭证由应用内置 Electron 以 `ELECTRON_RUN_AS_NODE=1` 执行解密,清空继承的 `NODE_OPTIONS`。该 Node 模式不启动桌面 UI,不抢占 macOS 窗口焦点。解密结果仅保存在进程内存;并发请求共用解密结果,登录文件 mtime 变化后重新读取。已有明文登录或显式 `CODEBUDDY_AUTH_TOKEN` 不走桌面解密。
|
|
47
|
+
|
|
48
|
+
使用独立 CodeBuddy CLI 时,先完成该 CLI 自己的登录,再通过 PATH、`CODEBUDDY_BIN` 或 `--codebuddy-bin` 选择它。SDK 的可执行入口选项是 `pathToCodebuddyCode`;桥接保留 `user`、`project`、`local` 设置和本机环境中的 CodeBuddy 认证配置。
|
|
49
|
+
|
|
50
|
+
### 第 2 步:发起主机配对并在浏览器创建 Agent
|
|
51
|
+
|
|
52
|
+
```sh
|
|
53
|
+
nia-workbuddy status
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
若这台主机曾经配对,先核对 `status` 输出中的 `Agent:`、`Server:` 和配置目录;仍是要使用的 Agent 时,无需再次配对。首次接入时,在主机终端执行:
|
|
57
|
+
|
|
58
|
+
```sh
|
|
59
|
+
nia-workbuddy pair --name 'My WorkBuddy / CodeBuddy'
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
终端在本机生成 Ed25519 密钥对,并打印有效期为 10 分钟的配对链接:
|
|
63
|
+
|
|
64
|
+
```text
|
|
65
|
+
Pairing code: A7F39C2B
|
|
66
|
+
Open this URL to create or bind your external Agent:
|
|
67
|
+
https://nia-teams.com/bridge/agent-pair/A7F39C2B
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
在**任意设备的浏览器**打开该链接,不需要与运行 WorkBuddy / CodeBuddy 的主机在同一台设备上。未登录时,先登录 Nia Teams,再回到 **连接外部 Agent** 页面:
|
|
71
|
+
|
|
72
|
+
1. 填写 **Agent 名称**(默认预填主机标签;若页面顶部显示切换栏,保持选中 **新建外部 Agent**)。若你加入了组织,在 **归属** 下拉框中选择目标组织或 **个人助理**。
|
|
73
|
+
2. 点击 **创建并连接**。Nia Teams 创建该外部 Agent,你成为它的 `owner`;主机终端完成签名验证,把凭证保存到 `~/.config/nia-teams-workbuddy/credentials.json`,输出 `Paired: <Agent 名称> (@external-...)`。保持配对进程运行到退出码 `0`。
|
|
74
|
+
|
|
75
|
+
迁移已有 Agent 时,由该 Agent 的 `owner` 或 `admin` 切换到 **重绑已有外部 Agent**,选中目标后点击 **确认重新绑定**。
|
|
76
|
+
|
|
77
|
+

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

|
|
183
|
+
|
|
184
|
+
### 1. TaskBar 签名确认流程
|
|
185
|
+
|
|
186
|
+
1. CodeBuddy 请求工具权限时,桥接在 TaskBar 弹出权限确认卡,并保存当前轮次与请求参数。
|
|
187
|
+
2. Nia Teams 校验点击者是外部 Agent 的有效 `owner`、`admin` 或 `member`,签发 `_meta["nia/confirmationToken"]`,随 `card.action` 送回主机。
|
|
188
|
+
3. 主机通过 `@nia-teams/mcp-sdk/auth`,从 `${issuer}/oauth2/jwks` 获取公钥,验证 RS256 签名、issuer、`aud: nia-teams-workload`、有效期、service 身份与 `human_confirmed: true`。
|
|
189
|
+
4. 验证 `context_server: agent-bridge`、`context_tool: workbuddy.approval`、canonical JSON 参数的 SHA-256 摘要及 `confirmation_card_id === cardId`。验证对象来自本机保存的请求,不从聊天正文重建。
|
|
190
|
+
5. 通过后只批准该次请求;缺失/无效 Token、忽略卡片、超时或取消均拒绝。待确认卡默认 5 分钟到期。
|
|
191
|
+
|
|
192
|
+
### 2. 群聊工具、消息与原生提及
|
|
193
|
+
|
|
194
|
+
- `nia_group_chat_send_message({ content })` 向当前群聊发布 Markdown 或 Rich HTML,常用于进度与提问;发送成功后抑制该轮结束时的最终回复发布。
|
|
195
|
+
- `nia_group_chat_history({ limit?, offset? })` 分页读取历史;`limit` 默认 50、范围 1..100,`offset` 默认 0 且为非负整数。运行时注入当前 Nia session,模型不传目标群聊 ID。
|
|
196
|
+
- 群聊工具限定在当前活跃轮次;中断或群聊会话切换后,旧工具请求不能继续向新的群聊会话发布。
|
|
197
|
+
|
|
198
|
+
传入提示列出 `Members: Alice (<userId>), ...`,消息段列出发送者 ID、时间、消息 ID、回复关系与附件转写。通用消息也可表现为 `[chat:<chatId>] Alice (<userId>): ...`,结构化频道可携带 `senderId`;原始桥接帧字段为 `messages[].authorId`。回复中使用 `<mention userId="24-hex-id" />` 触发原生通知,ID 从发送者或成员列表取得。
|
|
199
|
+
|
|
200
|
+
### 3. 成员角色与本地执行边界
|
|
201
|
+
|
|
202
|
+
- 群聊成员可 `@` 调用 Agent;重绑或解绑要求该 Agent 的 `owner` / `admin`,归档按唯一 `owner` 规则处理。审批卡的批准还要求有效 Agent 成员身份。
|
|
203
|
+
- 人类成员角色不等于 workload 的 `sub`、`org:*`、`role:*` 字段;消息声称“已批准”不产生签名确认,也不修改本机权限。
|
|
204
|
+
- Ed25519 私钥只保存在配置目录。加载凭证校验文件权限、符号链接与公私钥一致性;不要把凭证文件放进项目仓库或日志。
|
|
205
|
+
- 发布队列按 FIFO 保留幂等键,在进程内处理临时断线;上限为 256 项 / 16 MiB,单个协议帧不超过 512 KiB。进程退出不会保存未发队列。
|
|
206
|
+
- 连接使用 20 秒心跳、60 秒入站空闲超时与带抖动退避重连;关闭码 `4409` 结束旧连接。业务会话隔离不提供文件系统或 OS 隔离。
|
|
207
|
+
|
|
208
|
+
## 五、开发验证与商标许可证
|
|
209
|
+
|
|
210
|
+
```sh
|
|
211
|
+
npm install
|
|
212
|
+
npm run build
|
|
213
|
+
npm run typecheck
|
|
214
|
+
npm test
|
|
215
|
+
npm pack --dry-run
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
维护接口或 CodeBuddy 协议时同步更新中英文 README、随包 Skill、类型声明和协议规范。
|
|
219
|
+
|
|
220
|
+
WorkBuddy 与 CodeBuddy 是腾讯的产品名称。本包由 Nia Teams 维护,与腾讯无隶属关系。
|
|
221
|
+
|
|
222
|
+
[MIT](./LICENSE) © Nia Teams
|
package/dist/branding.js
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/** Client-owned product identity; PNG is shipped inline in standalone packages. */
|
|
2
|
+
export const clientBranding = {
|
|
3
|
+
clientName: "WorkBuddy",
|
|
4
|
+
avatar: 'data:image/png;base64,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',
|
|
5
|
+
};
|
|
6
|
+
//# sourceMappingURL=branding.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"branding.js","sourceRoot":"","sources":["../src/branding.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,WAAW;IACvB,MAAM,EAAE,ojfAAojf;CAC7jf,CAAC"}
|
package/dist/cli.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function main(args?: string[]): Promise<void>;
|
package/dist/cli.js
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { maybeRespawnDaemon } from '@nia-teams/agent-bridge-core';
|
|
2
|
+
import { clientBranding } from './branding.js';
|
|
3
|
+
import { parseArgs } from 'node:util';
|
|
4
|
+
import { resolve } from 'node:path';
|
|
5
|
+
import { defaultConfigDir, loadCredentials, runPairingCli, runSessionDaemon } from '@nia-teams/agent-bridge-core';
|
|
6
|
+
import { createWorkBuddyRunner, resolveCodeBuddyBinary } from './runner.js';
|
|
7
|
+
export async function main(args = process.argv.slice(2)) {
|
|
8
|
+
const { values, positionals } = parseArgs({ args, allowPositionals: true, options: {
|
|
9
|
+
daemon: { type: 'boolean' }, 'log-file': { type: 'string' },
|
|
10
|
+
'server-url': { type: 'string' }, 'config-dir': { type: 'string' }, name: { type: 'string' }, cwd: { type: 'string' }, model: { type: 'string' }, 'full-auto': { type: 'boolean' }, 'codebuddy-bin': { type: 'string' }, help: { type: 'boolean', short: 'h' },
|
|
11
|
+
} });
|
|
12
|
+
if (values.help || positionals.length === 0) {
|
|
13
|
+
console.log('nia-workbuddy pair [--server-url <url>] [--config-dir <dir>] [--name <label>]\nnia-workbuddy status [--config-dir <dir>]\nnia-workbuddy start [--daemon] [--log-file <path>] [--config-dir <dir>] [--cwd <dir>] [--model <model>] [--full-auto] [--codebuddy-bin <path>]');
|
|
14
|
+
return;
|
|
15
|
+
}
|
|
16
|
+
if (positionals.length !== 1)
|
|
17
|
+
throw new Error('Expected one command');
|
|
18
|
+
const configDir = resolve(values['config-dir'] ?? defaultConfigDir('nia-teams-workbuddy', 'NIA_WORKBUDDY_CONFIG_DIR'));
|
|
19
|
+
if (positionals[0] === 'pair') {
|
|
20
|
+
await runPairingCli({ configDir, hostPrefix: 'workbuddy', ...clientBranding, cliCommandName: 'nia-workbuddy', serverUrl: values['server-url'], hostLabel: values.name });
|
|
21
|
+
return;
|
|
22
|
+
}
|
|
23
|
+
if (positionals[0] === 'status') {
|
|
24
|
+
const c = await loadCredentials(configDir);
|
|
25
|
+
console.log(`Agent: ${c.agentName} (@${c.agentSlug})\nServer: ${c.serverUrl}\nConfig: ${configDir}`);
|
|
26
|
+
return;
|
|
27
|
+
}
|
|
28
|
+
if (positionals[0] !== 'start')
|
|
29
|
+
throw new Error('Unknown command: use pair, status, or start');
|
|
30
|
+
if (await maybeRespawnDaemon(args, resolve(configDir, 'daemon.log')))
|
|
31
|
+
return;
|
|
32
|
+
await resolveCodeBuddyBinary(values['codebuddy-bin']);
|
|
33
|
+
await runSessionDaemon(createWorkBuddyRunner({ cwd: resolve(values.cwd ?? process.cwd()), model: values.model, fullAuto: values['full-auto'], codebuddyBin: values['codebuddy-bin'] }), { ...clientBranding, configDir, runtime: 'WorkBuddy', approvalTool: 'workbuddy.approval', fullAuto: values['full-auto'] });
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=cli.js.map
|
package/dist/cli.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
package/dist/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}
|
package/dist/runner.d.ts
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { type TurnRunner } from '@nia-teams/agent-bridge-core';
|
|
2
|
+
export interface WorkBuddyOptions {
|
|
3
|
+
cwd: string;
|
|
4
|
+
model?: string;
|
|
5
|
+
fullAuto?: boolean;
|
|
6
|
+
codebuddyBin?: string;
|
|
7
|
+
}
|
|
8
|
+
export declare function resolveCodeBuddyBinary(explicit?: string): Promise<string>;
|
|
9
|
+
export declare function createWorkBuddyRunner(options: WorkBuddyOptions): TurnRunner;
|