agent-loft 0.2.98 → 0.2.100
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/README.md +5 -4
- package/package.json +2 -1
- package/src/agents/claude/session.ts +58 -6
- package/src/agents/codex/app-server.ts +2 -1
- package/src/agents/codex/protocol.ts +2 -1
- package/src/agents/codex/session.ts +65 -1
- package/src/agents/health.ts +73 -2
- package/src/agents/workbuddy/account.ts +98 -0
- package/src/agents/workbuddy/driver.ts +157 -0
- package/src/agents/workbuddy/errors.ts +34 -0
- package/src/agents/workbuddy/history.ts +237 -0
- package/src/agents/workbuddy/sdk.ts +156 -0
- package/src/agents/workbuddy/session.ts +484 -0
- package/src/channels/feishu/bot.ts +1 -1
- package/src/channels/feishu/cards.ts +9 -4
- package/src/channels/web/api.ts +40 -0
- package/src/channels/web/experts-api.ts +3 -1
- package/src/channels/weixin/bot.ts +2 -1
- package/src/channels/weixin/format.ts +5 -5
- package/src/core/builtin-agents.ts +48 -7
- package/src/core/command-catalog.ts +4 -2
- package/src/core/commands.ts +13 -1
- package/src/core/config.ts +20 -3
- package/src/core/experts.ts +5 -3
- package/src/core/hub.ts +62 -12
- package/src/core/interactions.ts +1 -1
- package/src/core/memory-curator.ts +2 -2
- package/src/core/memory.ts +2 -2
- package/src/core/permission.ts +20 -2
- package/src/core/store.ts +5 -0
- package/src/core/types.ts +14 -0
- package/src/core/users.ts +1 -1
- package/src/main.ts +6 -2
- package/web/css/composer.css +15 -0
- package/web/lib/dom.js +2 -0
- package/web/lib/permission.js +23 -4
- package/web/settings/agents.js +107 -13
- package/web/settings/commands.js +1 -1
- package/web/settings/experts.js +1 -1
- package/web/settings/memory.js +2 -1
- package/web/state.js +4 -0
- package/web/views/composer.js +5 -4
- package/web/views/conv-actions.js +24 -4
- package/web/views/interaction.js +9 -5
- package/web/views/sidebar.js +2 -1
- package/web/views/tasks.js +2 -2
- package/web/views/topbar.js +16 -11
package/README.md
CHANGED
|
@@ -36,7 +36,8 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
|
|
|
36
36
|
|
|
37
37
|
## 能做什么
|
|
38
38
|
|
|
39
|
-
- **多个 agent**:Claude Code、Codex
|
|
39
|
+
- **多个 agent**:Claude Code、Codex、WorkBuddy。几个 agent 共用工作目录,能看到对方改过的文件,但聊天记录各自独立。
|
|
40
|
+
- **WorkBuddy(腾讯)**:默认不启用。调用这台服务器上 **WorkBuddy 桌面版自带的 CLI**(官方 Agent SDK `@tencent-ai/agent-sdk` 驱动,账号站点 www.workbuddy.cn),也可以改用 CodeBuddy 国内版 / 国际版 / 腾讯 iOA 的账号(用 SDK 自带的 CLI,不用装桌面版)。到 设置 → Agent → WorkBuddy 勾上「启用」、选账号站点后保存,再在「运行环境」里点「登录 WorkBuddy」:在你自己的浏览器里打开登录页,**1 分钟内**登录完(CLI 只等这么久,超时重新点),整台服务器登一次就行,所有人共用。桌面版里登录过也要在这里再登一次(同一个账号):桌面版的登录由它自己保管,不交给单独跑的 CLI;这边的令牌存在 `data/workbuddy-auth.json`(0600),不碰桌面版的数据。也可以给服务设 `CODEBUDDY_API_KEY`。支持流式回复、授权卡(逐次询问 / 自动改文件 / 完全允许)、提问卡、计划模式、中途换模型、图片附件、`/sessions` 恢复以前的会话、记忆和定时任务工具、个人技能和 MCP;管理员的会话读机器上的 `~/.codebuddy` 配置,成员只读项目里的。暂不支持自定义专家、分叉 / 回退、思考程度和额度显示;令牌过期后要回设置页重新登录。
|
|
40
41
|
- **多个飞书机器人**:设置 → 飞书 →「可用专家」直接勾选内置或共享专家,并选择「默认专家」。只勾一个共享专家即可专用,不用再勾选底层 Agent;每个人绑定自己的账号后,直接私聊就是这个专家,使用各自的记忆和工具。机器人能在 Web 上扫码创建(Lark 国际版用「手动添加」),改完配置立即生效,不用重启。
|
|
41
42
|
- 群聊里要 @ 机器人;不同话题是各自独立的会话;支持文字、富文本、图片、文件、语音和视频。
|
|
42
43
|
- 思考和工具调用显示在实时刷新的过程卡片里,最终回复是普通消息。
|
|
@@ -76,10 +77,10 @@ Logo 就是这个意思:一大两小几颗星(多个 agent)站在同一张
|
|
|
76
77
|
- **网页多服务器切换**:在 设置 → 服务器 添加其他 agent-loft,再点「授权」到对方页面确认,侧栏左上角通过名称和紧随其后的箭头切换,不显示服务器图标,嵌入桌面端时隐藏此入口;各台分别登录,切走后保持连接,列表显示待处理数和运行状态,刷新后保留选择。几台需使用同一主域名下的 HTTPS 地址(例如 `mac.example.com`、`nas.example.com`)。在外层页面开启系统通知后,各台的提醒都能推到同一个主屏幕 App,点通知自动切到对应服务器和对话。见[使用指南](docs/产品介绍.md#在网页和手机上切换多台服务器)。
|
|
77
78
|
- **系统通知**:Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑(设置 → 系统 → 系统通知 → 「在此设备开启通知」,可以发测试通知)。飞书会话由飞书提醒,正在前台看着的会话不推。需要 HTTPS 访问,iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
|
|
78
79
|
- **跨渠道同步**:飞书里的会话在 Web 上也能打开接着聊。同一个授权请求同时出现在飞书卡片和网页上,哪边先点算哪边,另一边自动变成「已处理」。
|
|
79
|
-
- **授权**:允许一次 / 本会话全部允许 / 总是允许(按钮上写明放行范围)/ 拒绝。权限级别(输入框左下角或 `/permission`):逐次询问 / 自动改文件 /
|
|
80
|
+
- **授权**:允许一次 / 本会话全部允许 / 总是允许(按钮上写明放行范围)/ 拒绝。权限级别(输入框左下角或 `/permission`):逐次询问 / 自动改文件 / 自动判断(仅 Claude Code,由 Claude 逐个判断安不安全)/ 完全允许,定时任务也可以单独设,自动判断和完全允许只给管理员;默认级别在 设置 → Agent 里按引擎设。同一个弹窗里还有**计划模式**开关(或 `/planmode on`):agent 先只读、出方案,你点「开始执行」后再按权限级别动手。`/autoedit on` 让 Claude Code 在这条会话里改工作目录内的文件不再询问(Bash 仍询问)。超时一律按拒绝处理。
|
|
80
81
|
- **设置都在网页上**,按用途分组:**我的**(账号、飞书和微信绑定、自己的登录设备、记忆、专家、技能、MCP、用量);**Agent**(运行环境置顶,各 agent 卡片分别配置默认模型、思考程度、可选模型、个人默认技能和 MCP,Codex 沙箱、额度查询;工作目录、会话闲置过期、授权卡超时和 Claude 的「总是允许」名单;「/」命令);**连接**(飞书机器人、配对批准、指令面板同步;远程控制;服务器);**管理**(用户标题旁添加用户,用户的「管理 → 登录设备」查看和下线各自设备;系统页管理服务端版本和升级、重启、局域网访问和端口,网络访问下方是系统通知;成员也可在系统页设置自己的通知)。账号页通过「修改名称」「修改密码」按需展开表单;飞书和微信绑定操作位于卡片右上角。设置、新建 / 编辑专家、重命名等编辑弹窗不会因点击外部或按 Esc 关闭;通过关闭、取消或保存 / 完成按钮退出。改了没保存就切页或关掉设置会先提醒。
|
|
81
82
|
- **多用户**(信任型):管理员在 设置 → 用户 里给别人建账号。每个人只看得到自己的对话、授权和通知;个人设置各自管理,服务器设置由管理员修改,见下面「安全」。
|
|
82
|
-
- **专家**:设置 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex` 换专家会开新会话)。**内置专家**:Claude Code、Codex,保留原装提示词和所有工具,默认技能与 MCP 在「设置 → Agent」中按账号、按引擎分别选择。**自定义专家**由创建者管理,可以勾选「共享给所有账号」。共享后,其他人能在网页、绑定账号后的飞书私聊和定时任务中选择它;只有创建者能修改设定。每个人在该专家的「我的工具」里选择自己的技能和 MCP,使用各自的变量、凭据、记忆和聊天记录;创建者沿用原有工具选择;其他人没配置过时,沿用创建者选的里面自己能用的(自己装了的技能、创建者共享出来的 MCP),创建者私有的 MCP 和机器 MCP 不会带给别人。取消共享后,其他人的历史对话保留,后续消息不能继续调用该专家,相关定时任务在下次运行时暂停。可以配:
|
|
83
|
+
- **专家**:设置 → 专家。专家是一份配置,新建对话、定时任务时选一个,对话从头到尾都是它(中途不能换;飞书里 `/expert 名字`、`/claude`、`/codex`、`/workbuddy` 换专家会开新会话)。**内置专家**:Claude Code、Codex,保留原装提示词和所有工具,默认技能与 MCP 在「设置 → Agent」中按账号、按引擎分别选择。**自定义专家**由创建者管理,可以勾选「共享给所有账号」。共享后,其他人能在网页、绑定账号后的飞书私聊和定时任务中选择它;只有创建者能修改设定。每个人在该专家的「我的工具」里选择自己的技能和 MCP,使用各自的变量、凭据、记忆和聊天记录;创建者沿用原有工具选择;其他人没配置过时,沿用创建者选的里面自己能用的(自己装了的技能、创建者共享出来的 MCP),创建者私有的 MCP 和机器 MCP 不会带给别人。取消共享后,其他人的历史对话保留,后续消息不能继续调用该专家,相关定时任务在下次运行时暂停。可以配:
|
|
83
84
|
- 头像(点头像区域的加号上传;未上传时,会话中用引擎的图标)、引擎(Claude / Codex,建好后不能换)、默认模型和思考程度(从模型列表里选);
|
|
84
85
|
- 提示词:人设、规则、输出格式。agent-loft 在后面自动补上这个专家能做什么、今天的日期、记忆。Claude 专家默认只用这段提示词(一句话约 2 千 token),也可以选「追加在 Claude Code 原装提示词后面」(干活更稳,每轮多约 1.6 万);Codex 的基础指令改不了,专家的提示词附在第一条消息后面,约束力弱一些;
|
|
85
86
|
- 权限,勾选:联网搜索、读网页,以及文件权限(一级包含一级):都不勾就是**只能联网**(不碰本机文件、不弹授权,文本附件内容直接放进消息)/**能读文件**/**能改文件**/**能跑命令**(跑命令就等于能改任何文件,需要授权时弹卡)。Claude 按权限给工具;Codex 按权限开 shell、apply_patch,沙箱只读或 workspace-write;
|
|
@@ -178,7 +179,7 @@ agent-loft service install
|
|
|
178
179
|
|
|
179
180
|
`aloft` 是 `agent-loft` 的简写。
|
|
180
181
|
|
|
181
|
-
聊天里的命令(飞书和 Web 通用;Web 打开页面时会预加载当前专家和目录的命令,输入框打 `/` 会弹出命令补全,飞书里打 `/` 会弹出机器人的指令面板(agent-loft 自动注册,约 5~8 分钟生效;只发一个 `/` 也会回一张可点击的命令卡片),顺序和显示项在 设置 → 命令 里调整):`/new` `/fork` `/sessions [all]` `/resume <id>` `/model [名称]` `/effort <程度>` `/stop` `/cd <目录>` `/pwd` `/status` `/permission [ask|edit|full|default]`、`/autoedit [on|off]` `/approve <id> allow-once|allow-always|allow-session|deny` `/help`;只在飞书里有的:`/expert [名称]`(或者直接发 `/claude`、`/codex`,换专家会开新会话)`/web` `/detach` `/bind <绑定码>`
|
|
182
|
+
聊天里的命令(飞书和 Web 通用;Web 打开页面时会预加载当前专家和目录的命令,输入框打 `/` 会弹出命令补全,飞书里打 `/` 会弹出机器人的指令面板(agent-loft 自动注册,约 5~8 分钟生效;只发一个 `/` 也会回一张可点击的命令卡片),顺序和显示项在 设置 → 命令 里调整):`/new` `/fork` `/sessions [all]` `/resume <id>` `/model [名称]` `/effort <程度>` `/stop` `/cd <目录>` `/pwd` `/status` `/permission [ask|edit|auto|full|default]`、`/planmode [on|off]`、`/autoedit [on|off]` `/approve <id> allow-once|allow-always|allow-session|deny` `/help`;只在飞书里有的:`/expert [名称]`(或者直接发 `/claude`、`/codex`,换专家会开新会话)`/web` `/detach` `/bind <绑定码>`
|
|
182
183
|
|
|
183
184
|
自定义命令:设置 → 命令 → 「添加命令」,填命令名、说明和一段提示词,之后发 `/命令名 参数` 就会把这段提示词发给 agent(提示词里的 `$ARGUMENTS` 换成参数,没写就把参数接在后面)。按 agent 分开存,可以编辑、删除,也会同步到飞书指令面板。
|
|
184
185
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-loft",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.100",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "多个 agent 的工作台:把本机 Claude Code / Codex 放到一处统一管理,用飞书和 Web 页面随时驱动——会话、审批、模型切换都共用",
|
|
6
6
|
"keywords": [
|
|
@@ -49,6 +49,7 @@
|
|
|
49
49
|
"@highlightjs/cdn-assets": "^11.12.0",
|
|
50
50
|
"@larksuiteoapi/node-sdk": "^1.73.0",
|
|
51
51
|
"@novnc/novnc": "^1.7.0",
|
|
52
|
+
"@tencent-ai/agent-sdk": "^0.3.301",
|
|
52
53
|
"@xterm/addon-fit": "^0.11.0",
|
|
53
54
|
"@xterm/xterm": "^6.0.0",
|
|
54
55
|
"dompurify": "^3.2.0",
|
|
@@ -11,6 +11,7 @@ import {
|
|
|
11
11
|
type McpServerConfigForProcessTransport,
|
|
12
12
|
type ModelUsage,
|
|
13
13
|
type Options,
|
|
14
|
+
type PermissionMode,
|
|
14
15
|
type PermissionResult,
|
|
15
16
|
type Query,
|
|
16
17
|
type SDKMessage,
|
|
@@ -49,6 +50,16 @@ import {
|
|
|
49
50
|
} from "./permissions.js";
|
|
50
51
|
import { feedTodos, readTodos, TodoTracker } from "./todos.js";
|
|
51
52
|
|
|
53
|
+
/**
|
|
54
|
+
* 级别 + 计划模式 → Claude 的 permissionMode。计划模式优先(只读、出方案)。
|
|
55
|
+
* acceptEdits 只放行工作目录(含附件目录)内的改文件;auto 由分类器逐个判断,拿不准的才走 canUseTool;
|
|
56
|
+
* 「完全允许」用 default,在 canUseTool 里全放行(bypassPermissions 会让 canUseTool 变成死代码)
|
|
57
|
+
*/
|
|
58
|
+
function modeOf(level: PermissionLevel | undefined, plan: boolean | undefined): PermissionMode {
|
|
59
|
+
if (plan) return "plan";
|
|
60
|
+
return level === "edit" ? "acceptEdits" : level === "auto" ? "auto" : "default";
|
|
61
|
+
}
|
|
62
|
+
|
|
52
63
|
export function toModelInfo(models: Awaited<ReturnType<Query["supportedModels"]>>): ModelInfo[] {
|
|
53
64
|
return models.map((m) => ({
|
|
54
65
|
id: m.value,
|
|
@@ -58,7 +69,7 @@ export function toModelInfo(models: Awaited<ReturnType<Query["supportedModels"]>
|
|
|
58
69
|
}));
|
|
59
70
|
}
|
|
60
71
|
|
|
61
|
-
class AsyncQueue<T> {
|
|
72
|
+
export class AsyncQueue<T> {
|
|
62
73
|
private items: T[] = [];
|
|
63
74
|
private waiting: ((result: IteratorResult<T>) => void)[] = [];
|
|
64
75
|
private closed = false;
|
|
@@ -363,9 +374,8 @@ export class ClaudeSession implements AgentSession {
|
|
|
363
374
|
...(this.access === "web" ? {} : { CLAUDE_CODE_ENABLE_TODO_TOOLS: "1" }),
|
|
364
375
|
...(this.access === "exec" ? (this.opts.skills?.env ?? {}) : {}),
|
|
365
376
|
},
|
|
366
|
-
//
|
|
367
|
-
|
|
368
|
-
permissionMode: this.opts.permission === "edit" ? "acceptEdits" : "default",
|
|
377
|
+
// 不用 bypassPermissions:它会让 canUseTool 变成死代码(「完全允许」也在 canUseTool 里放行)。见 modeOf
|
|
378
|
+
permissionMode: modeOf(this.opts.permission, this.opts.plan),
|
|
369
379
|
// 逐字输出给 Web 用;飞书渠道直接忽略这些片段
|
|
370
380
|
includePartialMessages: true,
|
|
371
381
|
...(this.opts.model ? { model: this.opts.model } : {}),
|
|
@@ -415,6 +425,12 @@ export class ClaudeSession implements AgentSession {
|
|
|
415
425
|
return;
|
|
416
426
|
}
|
|
417
427
|
|
|
428
|
+
// 模式变了(Claude 自己调 EnterPlanMode 进了计划模式、批准方案后退出):对话上的开关跟着走
|
|
429
|
+
if (message.type === "system" && message.subtype === "status") {
|
|
430
|
+
if (message.permissionMode) this.syncPlan(message.permissionMode === "plan");
|
|
431
|
+
return;
|
|
432
|
+
}
|
|
433
|
+
|
|
418
434
|
// 逐字片段。子 agent 的输出(parent_tool_use_id 非空)不算回复正文
|
|
419
435
|
if (message.type === "stream_event") {
|
|
420
436
|
if (message.parent_tool_use_id) return;
|
|
@@ -546,12 +562,15 @@ export class ClaudeSession implements AgentSession {
|
|
|
546
562
|
const answered = await this.askQuestion(input);
|
|
547
563
|
if (answered) return answered;
|
|
548
564
|
}
|
|
565
|
+
// 批准方案也不是授权:完全允许、本会话全部允许都不能替用户批
|
|
566
|
+
if (toolName === "ExitPlanMode") return this.approvePlan(input);
|
|
549
567
|
|
|
550
568
|
// 提问、批准计划这类不是「安全确认」,而是要用户真的做决定,全部允许也照样问。
|
|
551
569
|
// 标了「调用前询问」的 MCP 是用户特意要每次把关的:全部允许、总是允许都不算数(和 Codex 一致)
|
|
552
570
|
const asksFirst = this.mcpAsksFirst(toolName);
|
|
553
571
|
const sessionable = isRememberable(toolName) && !asksFirst;
|
|
554
|
-
|
|
572
|
+
// 计划模式下不沿用全部放行:只读是计划模式的前提,Bash 写文件不能因为放开过就直接跑
|
|
573
|
+
if (sessionable && this.allowAll && !this.opts.plan) return { behavior: "allow", updatedInput: input };
|
|
555
574
|
|
|
556
575
|
const signature = signatureOf(toolName, input);
|
|
557
576
|
const rememberable = !asksFirst && isRememberableSignature(toolName, signature);
|
|
@@ -602,6 +621,34 @@ export class ClaudeSession implements AgentSession {
|
|
|
602
621
|
return this.opts.expert?.access ?? "exec";
|
|
603
622
|
}
|
|
604
623
|
|
|
624
|
+
/**
|
|
625
|
+
* ExitPlanMode:方案出好了,问用户按不按它做。批准就切回这条对话的权限级别接着干;
|
|
626
|
+
* 不批就留在计划模式,等用户说要怎么改。
|
|
627
|
+
*/
|
|
628
|
+
private async approvePlan(input: Record<string, unknown>): Promise<PermissionResult> {
|
|
629
|
+
const plan = typeof input.plan === "string" && input.plan.trim() ? input.plan : "(Claude 没有附上方案正文)";
|
|
630
|
+
const outcome = await this.host({ kind: "approval", title: "方案出好了,按这个开始做?", detail: plan, allowLabel: "开始执行", denyLabel: "继续改方案" });
|
|
631
|
+
if (outcome.settlement === "allow-once" || outcome.settlement === "allow-always") {
|
|
632
|
+
this.syncPlan(false);
|
|
633
|
+
const mode = modeOf(this.opts.permission, false);
|
|
634
|
+
return { behavior: "allow", updatedInput: input, updatedPermissions: [{ type: "setMode", mode, destination: "session" }] };
|
|
635
|
+
}
|
|
636
|
+
const message =
|
|
637
|
+
outcome.settlement === "timeout"
|
|
638
|
+
? "用户长时间没有回应这个方案(已超时)。留在计划模式,不要动手,等用户回来。"
|
|
639
|
+
: outcome.settlement === "cancelled"
|
|
640
|
+
? "方案确认已被取消(用户中断了这一轮或切换了会话)。留在计划模式,不要动手。"
|
|
641
|
+
: "用户还不想按这个方案做。留在计划模式,不要动手;简短问一句要改哪里,等用户说明。";
|
|
642
|
+
return { behavior: "deny", message };
|
|
643
|
+
}
|
|
644
|
+
|
|
645
|
+
/** 记下是不是在计划模式,变了就告诉核心 */
|
|
646
|
+
private syncPlan(on: boolean): void {
|
|
647
|
+
if (!!this.opts.plan === on) return;
|
|
648
|
+
this.opts.plan = on;
|
|
649
|
+
this.events.onPlanMode?.(on);
|
|
650
|
+
}
|
|
651
|
+
|
|
605
652
|
/**
|
|
606
653
|
* AskUserQuestion:选了什么要顺着 updatedInput.answers 回填(问题原文 → 答案),
|
|
607
654
|
* 少了这一步工具会以「The user did not answer the questions.」收场。
|
|
@@ -684,7 +731,12 @@ export class ClaudeSession implements AgentSession {
|
|
|
684
731
|
this.opts.permission = level;
|
|
685
732
|
this.allowAll = level === "full";
|
|
686
733
|
// 还没起 CLI 就不用管:下次拉起时按 opts 来
|
|
687
|
-
if (this.q) await this.q.setPermissionMode(level
|
|
734
|
+
if (this.q) await this.q.setPermissionMode(modeOf(level, this.opts.plan));
|
|
735
|
+
}
|
|
736
|
+
|
|
737
|
+
async setPlan(on: boolean): Promise<void> {
|
|
738
|
+
this.opts.plan = on;
|
|
739
|
+
if (this.q) await this.q.setPermissionMode(modeOf(this.opts.permission, on));
|
|
688
740
|
}
|
|
689
741
|
|
|
690
742
|
async setModel(model?: string, effort?: string): Promise<void> {
|
|
@@ -125,7 +125,8 @@ export class AppServer {
|
|
|
125
125
|
|
|
126
126
|
const result = (await this.request("initialize", {
|
|
127
127
|
clientInfo: CLIENT_INFO,
|
|
128
|
-
|
|
128
|
+
// 计划模式(turn/start 的 collaborationMode)是实验接口,不声明就收不到
|
|
129
|
+
capabilities: { experimentalApi: true },
|
|
129
130
|
})) as InitializeResult;
|
|
130
131
|
|
|
131
132
|
// 握手的第二拍。少了它,服务端会一直当我们还没准备好。
|
|
@@ -83,7 +83,8 @@ export type Thread = {
|
|
|
83
83
|
updatedAt?: number;
|
|
84
84
|
};
|
|
85
85
|
|
|
86
|
-
|
|
86
|
+
/** collaborationMode 是实验字段(initialize 时开了 experimentalApi 才有):这条 thread 上次停在哪个模式 */
|
|
87
|
+
export type ThreadResponse = { thread: Thread; collaborationMode?: { mode?: string } | null };
|
|
87
88
|
export type ThreadListResponse = { data: Thread[]; nextCursor?: string | null };
|
|
88
89
|
|
|
89
90
|
/** 只列出我们会发的:文字,以及落在本机的图片。 */
|
|
@@ -156,7 +156,8 @@ export function codexMcp(mcp: ExpertRuntime["mcp"], ask: readonly string[] = [])
|
|
|
156
156
|
}
|
|
157
157
|
|
|
158
158
|
const SANDBOX_RANK = ["read-only", "workspace-write", "danger-full-access"];
|
|
159
|
-
|
|
159
|
+
// Codex 没有自动判断,按自动改文件算(hub 交过来之前已经降过级,这里兜底)
|
|
160
|
+
const PERMISSION_SANDBOX: Record<PermissionLevel, string> = { ask: "read-only", edit: "workspace-write", auto: "workspace-write", full: "danger-full-access" };
|
|
160
161
|
|
|
161
162
|
/** 用户自己配的 MCP 服务(config.toml 里的 mcp_servers)。名字因人而异,只能读出来再逐个关 */
|
|
162
163
|
let userMcpCache: { names: string[]; at: number } | null = null;
|
|
@@ -318,6 +319,14 @@ export class CodexSession implements AgentSession {
|
|
|
318
319
|
/** 全部放行:对话选了「完全允许」,或者用户点过「本会话全部允许」(点出来的只在内存里,会话对象一换就重新逐条询问)。 */
|
|
319
320
|
private allowAll = false;
|
|
320
321
|
private replyText = "";
|
|
322
|
+
/** 这一轮是按计划模式跑的;planText 是它出的方案,轮次结束后拿来问用户开不开始做 */
|
|
323
|
+
private turnPlan = false;
|
|
324
|
+
private planText = "";
|
|
325
|
+
/**
|
|
326
|
+
* 这条 thread 当前停在计划模式:collaborationMode 会留在 thread 上,关掉计划模式后要显式切回 default 一次。
|
|
327
|
+
* 恢复 thread 时按响应里的 collaborationMode 定
|
|
328
|
+
*/
|
|
329
|
+
private planOnThread = false;
|
|
321
330
|
/** 本轮所有模型请求的用量,和会话汇总使用相同的输入 / 缓存 / 输出口径。 */
|
|
322
331
|
private turnTokens: number | undefined;
|
|
323
332
|
/** 上次看到的 thread 累计 token 数:变了才说明有新的模型请求(同一次请求可能报好几遍) */
|
|
@@ -549,6 +558,7 @@ export class CodexSession implements AgentSession {
|
|
|
549
558
|
throw new DisposedError();
|
|
550
559
|
}
|
|
551
560
|
this.adopt(res.thread);
|
|
561
|
+
this.planOnThread = res.collaborationMode?.mode === "plan";
|
|
552
562
|
// 到这里分叉才算完成;之前任何一步失败,下次重试都还会走 thread/fork,绝不会续写原会话
|
|
553
563
|
if (fork) this.forked = true;
|
|
554
564
|
return res.thread.id;
|
|
@@ -608,6 +618,8 @@ export class CodexSession implements AgentSession {
|
|
|
608
618
|
private startTurn(input: UserInput): void {
|
|
609
619
|
this.currentInput = input;
|
|
610
620
|
this.replyText = "";
|
|
621
|
+
this.planText = "";
|
|
622
|
+
this.turnPlan = false;
|
|
611
623
|
this.turnTokens = undefined;
|
|
612
624
|
this.turnSeen = false;
|
|
613
625
|
this.phase = "starting";
|
|
@@ -633,6 +645,7 @@ export class CodexSession implements AgentSession {
|
|
|
633
645
|
if (this.disposed) throw new DisposedError();
|
|
634
646
|
if (token !== this.turnSeq) throw new DisposedError(); // 等 thread 期间被停止了
|
|
635
647
|
startedOn = threadId;
|
|
648
|
+
const collaborationMode = this.collaborationMode();
|
|
636
649
|
return appServer.call<{ turn?: { id?: string } }>("turn/start", {
|
|
637
650
|
threadId,
|
|
638
651
|
input: [
|
|
@@ -646,6 +659,7 @@ export class CodexSession implements AgentSession {
|
|
|
646
659
|
sandboxPolicy: sandboxPolicyFor(this.sandboxMode, this.opts.cwd),
|
|
647
660
|
...(this.opts.model ? { model: this.opts.model } : {}),
|
|
648
661
|
...(this.opts.effort ? { effort: this.opts.effort } : {}),
|
|
662
|
+
...(collaborationMode ? { collaborationMode } : {}),
|
|
649
663
|
});
|
|
650
664
|
})
|
|
651
665
|
.then((res) => {
|
|
@@ -683,6 +697,47 @@ export class CodexSession implements AgentSession {
|
|
|
683
697
|
}
|
|
684
698
|
}
|
|
685
699
|
|
|
700
|
+
/**
|
|
701
|
+
* 这一轮要带的 collaborationMode:开着计划模式就是 plan;刚关掉的话切回 default 一次(模式会留在 thread 上)。
|
|
702
|
+
* settings.model 是必填的,按这条会话当前的模型给(thread 打开后一定知道);developer_instructions 给 null 用 Codex 内置的说明
|
|
703
|
+
*/
|
|
704
|
+
private collaborationMode(): Record<string, unknown> | undefined {
|
|
705
|
+
const plan = !!this.opts.plan;
|
|
706
|
+
if (!plan && !this.planOnThread) return undefined;
|
|
707
|
+
const model = this.opts.model ?? this.runtime.model;
|
|
708
|
+
if (!model) return undefined;
|
|
709
|
+
this.turnPlan = plan;
|
|
710
|
+
this.planOnThread = plan;
|
|
711
|
+
return { mode: plan ? "plan" : "default", settings: { model, reasoning_effort: this.opts.effort ?? this.runtime.effort ?? null, developer_instructions: null } };
|
|
712
|
+
}
|
|
713
|
+
|
|
714
|
+
/** 下一轮生效 */
|
|
715
|
+
async setPlan(on: boolean): Promise<void> {
|
|
716
|
+
this.opts.plan = on;
|
|
717
|
+
}
|
|
718
|
+
|
|
719
|
+
/**
|
|
720
|
+
* 计划模式那一轮只出方案就结束了:弹一张不阻塞的卡问开不开始做(和 Codex 自己界面上的「按这个方案实施?」一样)。
|
|
721
|
+
* 批准就关掉计划模式,替用户发一句「开始执行」;用户另外发了消息(比如说要改哪里)卡就撤掉,照旧留在计划模式
|
|
722
|
+
*/
|
|
723
|
+
private askPlanApproval(): void {
|
|
724
|
+
void this.host({
|
|
725
|
+
kind: "approval",
|
|
726
|
+
title: "方案出好了,按这个开始做?",
|
|
727
|
+
detail: "方案见上面的回复。开始执行后关闭计划模式,按这条对话的权限动手;想改的话直接发消息说。",
|
|
728
|
+
allowLabel: "开始执行",
|
|
729
|
+
denyLabel: "继续改方案",
|
|
730
|
+
detached: true,
|
|
731
|
+
})
|
|
732
|
+
.then((outcome) => {
|
|
733
|
+
if (this.disposed || (outcome.settlement !== "allow-once" && outcome.settlement !== "allow-always")) return;
|
|
734
|
+
this.opts.plan = false;
|
|
735
|
+
this.events.onPlanMode?.(false);
|
|
736
|
+
this.events.onFollowUp?.("按这个方案开始执行。");
|
|
737
|
+
})
|
|
738
|
+
.catch((err) => console.warn("[codex] 方案确认卡没能弹出:", err));
|
|
739
|
+
}
|
|
740
|
+
|
|
686
741
|
/** 记下来,下一轮 turn/start 带上即可。 */
|
|
687
742
|
async setModel(model?: string, effort?: string): Promise<void> {
|
|
688
743
|
if (model !== undefined) this.opts.model = model;
|
|
@@ -974,6 +1029,8 @@ export class CodexSession implements AgentSession {
|
|
|
974
1029
|
...(this.turnTokens !== undefined ? { tokens: this.turnTokens } : {}),
|
|
975
1030
|
...(turn.id ? { anchor: turn.id } : {}),
|
|
976
1031
|
});
|
|
1032
|
+
// 用户已经排了下一条(多半就是要改方案)就不问了;计划模式期间又被关掉的也不问
|
|
1033
|
+
if (this.turnPlan && this.planText && this.opts.plan && this.queue.length === 0) this.askPlanApproval();
|
|
977
1034
|
}
|
|
978
1035
|
this.drainQueue();
|
|
979
1036
|
return;
|
|
@@ -1071,6 +1128,13 @@ export class CodexSession implements AgentSession {
|
|
|
1071
1128
|
case "plan": {
|
|
1072
1129
|
if (phase !== "completed") return;
|
|
1073
1130
|
const plan = item as Extract<ThreadItem, { type: "plan" }>;
|
|
1131
|
+
// 计划模式出的方案就是这一轮的回复(实测这一轮往往没有别的正文)
|
|
1132
|
+
if (this.turnPlan && plan.text.trim()) {
|
|
1133
|
+
this.planText = plan.text;
|
|
1134
|
+
this.replyText += (this.replyText ? "\n\n" : "") + plan.text;
|
|
1135
|
+
this.events.onText(plan.text);
|
|
1136
|
+
return;
|
|
1137
|
+
}
|
|
1074
1138
|
this.events.onStep("note", `📋 ${summarize(plan.text, 90)}`);
|
|
1075
1139
|
return;
|
|
1076
1140
|
}
|
package/src/agents/health.ts
CHANGED
|
@@ -8,11 +8,15 @@ import path from "node:path";
|
|
|
8
8
|
import { agentEnvironment } from "../core/agent-env.js";
|
|
9
9
|
import { config } from "../core/config.js";
|
|
10
10
|
import { withProbe } from "./claude/probe.js";
|
|
11
|
+
import { onLoginDone, readAccount } from "./workbuddy/account.js";
|
|
12
|
+
import { desktopCli, ENVIRONMENT_LABEL, environment } from "./workbuddy/sdk.js";
|
|
11
13
|
|
|
12
14
|
const require = createRequire(import.meta.url);
|
|
13
15
|
|
|
14
16
|
export type AgentFix = {
|
|
15
17
|
action: "install" | "login";
|
|
18
|
+
/** 能在网页上直接完成(WorkBuddy 的浏览器登录):设置页给按钮,不用去终端 */
|
|
19
|
+
web?: boolean;
|
|
16
20
|
title: string;
|
|
17
21
|
/** 每一条是一种做法,任选其一(比如 Homebrew 和 npm 两种装法) */
|
|
18
22
|
commands: string[];
|
|
@@ -20,7 +24,7 @@ export type AgentFix = {
|
|
|
20
24
|
};
|
|
21
25
|
|
|
22
26
|
export type AgentHealth = {
|
|
23
|
-
id: "claude" | "codex";
|
|
27
|
+
id: "claude" | "codex" | "workbuddy";
|
|
24
28
|
label: string;
|
|
25
29
|
enabled: boolean;
|
|
26
30
|
installed: boolean;
|
|
@@ -132,7 +136,69 @@ async function codexHealth(): Promise<AgentHealth> {
|
|
|
132
136
|
};
|
|
133
137
|
}
|
|
134
138
|
|
|
139
|
+
/** WorkBuddy:SDK 自带 CLI,装了 agent-loft 就有;登录在网页上点 */
|
|
140
|
+
async function workbuddyHealth(): Promise<AgentHealth> {
|
|
141
|
+
const base = { id: "workbuddy" as const, label: "WorkBuddy", enabled: config().agents.workbuddy.enabled };
|
|
142
|
+
const site = ENVIRONMENT_LABEL[environment()];
|
|
143
|
+
const loginFix: AgentFix = {
|
|
144
|
+
action: "login",
|
|
145
|
+
web: true,
|
|
146
|
+
title: "登录 WorkBuddy",
|
|
147
|
+
commands: [],
|
|
148
|
+
note: `点下面的按钮会打开 ${site} 的登录页,在浏览器里登录完回到这里点「重新检查」。也可以给 agent-loft 服务设 CODEBUDDY_API_KEY 环境变量用 API Key。`,
|
|
149
|
+
};
|
|
150
|
+
let version: string | undefined;
|
|
151
|
+
try {
|
|
152
|
+
// package.json 不在包的 exports 里,从入口(lib/index.js)往上找
|
|
153
|
+
const v = (require(path.join(path.dirname(require.resolve("@tencent-ai/agent-sdk")), "..", "package.json")) as { version?: string }).version;
|
|
154
|
+
version = v ? `SDK ${v}` : undefined;
|
|
155
|
+
} catch {
|
|
156
|
+
return {
|
|
157
|
+
...base,
|
|
158
|
+
installed: false,
|
|
159
|
+
loggedIn: null,
|
|
160
|
+
problem: "找不到 @tencent-ai/agent-sdk",
|
|
161
|
+
fix: { action: "install", title: "安装 WorkBuddy SDK", commands: ["npm install"], note: "在 agent-loft 的目录里运行,装好后重启服务。" },
|
|
162
|
+
};
|
|
163
|
+
}
|
|
164
|
+
if (environment() === "workbuddy") {
|
|
165
|
+
const cli = desktopCli();
|
|
166
|
+
if (!cli) {
|
|
167
|
+
return {
|
|
168
|
+
...base,
|
|
169
|
+
installed: false,
|
|
170
|
+
loggedIn: null,
|
|
171
|
+
problem: config().agents.workbuddy.cliPath ? `找不到 ${config().agents.workbuddy.cliPath}` : "没找到 WorkBuddy 桌面版",
|
|
172
|
+
fix: {
|
|
173
|
+
action: "install",
|
|
174
|
+
title: "安装 WorkBuddy 桌面版",
|
|
175
|
+
commands: [],
|
|
176
|
+
note: "agent-loft 调用的是 WorkBuddy 桌面版自带的 CLI(账号站点 www.workbuddy.cn)。在这台服务器上装好桌面版(workbuddy.cn 下载);装在别处的话,在下面填「CLI 路径」(桌面版目录里的 resources/app.asar.unpacked/cli/bin/codebuddy)。不想装桌面版可以把账号站点换成 CodeBuddy。",
|
|
177
|
+
},
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
version = "WorkBuddy 桌面版 CLI";
|
|
181
|
+
}
|
|
182
|
+
try {
|
|
183
|
+
const acct = await Promise.race([readAccount(), timeout<never>(25_000, "读取 WorkBuddy 账号")]);
|
|
184
|
+
return {
|
|
185
|
+
...base,
|
|
186
|
+
installed: true,
|
|
187
|
+
...(version ? { version } : {}),
|
|
188
|
+
loggedIn: acct.loggedIn,
|
|
189
|
+
account: acct.account ? `${acct.account} · ${site}` : acct.loggedIn ? site : undefined,
|
|
190
|
+
...(acct.loggedIn ? {} : { fix: loginFix }),
|
|
191
|
+
};
|
|
192
|
+
} catch (err) {
|
|
193
|
+
return { ...base, installed: true, ...(version ? { version } : {}), loggedIn: null, problem: err instanceof Error ? err.message : String(err), fix: loginFix };
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
|
|
135
197
|
let cache: { at: number; value: AgentHealth[] } | null = null;
|
|
198
|
+
// 网页上登录完:下次体检别用缓存
|
|
199
|
+
onLoginDone(() => {
|
|
200
|
+
cache = null;
|
|
201
|
+
});
|
|
136
202
|
|
|
137
203
|
/**
|
|
138
204
|
* 不等体检、立刻给出的「这个 agent 能不能用」:用最近一次体检的结果(多旧都算),
|
|
@@ -157,7 +223,12 @@ let inflight: Promise<AgentHealth[]> | null = null;
|
|
|
157
223
|
/** 两个 agent 一起查,结果缓存一分钟;refresh 跳过缓存(点了「重新检查」) */
|
|
158
224
|
export function agentHealth(refresh = false): Promise<AgentHealth[]> {
|
|
159
225
|
if (!refresh && cache && Date.now() - cache.at < 60_000) return Promise.resolve(cache.value);
|
|
160
|
-
|
|
226
|
+
// WorkBuddy 没启用就不去起它的 CLI(包很大,拉起要几秒)
|
|
227
|
+
const workbuddy = () =>
|
|
228
|
+
config().agents.workbuddy.enabled
|
|
229
|
+
? workbuddyHealth()
|
|
230
|
+
: Promise.resolve<AgentHealth>({ id: "workbuddy", label: "WorkBuddy", enabled: false, installed: true, loggedIn: null });
|
|
231
|
+
inflight ??= Promise.all([claudeHealth(), codexHealth(), workbuddy()])
|
|
161
232
|
.then((value) => {
|
|
162
233
|
cache = { at: Date.now(), value };
|
|
163
234
|
return value;
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
// WorkBuddy 的账号:查登没登录、网页登录。
|
|
2
|
+
//
|
|
3
|
+
// 登录用 SDK 的 unstable_v2_authenticate:CLI 给一个登录链接,用户在自己的浏览器里打开、登录完,
|
|
4
|
+
// 拿到的令牌由这边保存(见 sdk.ts 的 saveAuth),之后起 CLI 时交给它。不用到服务器的终端里操作。
|
|
5
|
+
// 同一时间只跑一个登录流程;再点一次「登录」就复用还没过期的那个链接。
|
|
6
|
+
import { baseOptions, environment, loadSdk, savedAuth, saveAuth, withProbe, workbuddyEnv } from "./sdk.js";
|
|
7
|
+
|
|
8
|
+
export type WorkBuddyAccount = { loggedIn: boolean; account?: string };
|
|
9
|
+
|
|
10
|
+
/** 读账号:没登录时 accountInfo 是个空对象 */
|
|
11
|
+
export async function readAccount(): Promise<WorkBuddyAccount> {
|
|
12
|
+
const info = (await withProbe((q) => q.accountInfo())) as Record<string, unknown>;
|
|
13
|
+
const pick = (k: string) => (typeof info[k] === "string" && info[k] ? (info[k] as string) : undefined);
|
|
14
|
+
const who = pick("email") ?? pick("userName") ?? pick("userNickname") ?? pick("organization");
|
|
15
|
+
const apiKey = pick("apiKeySource");
|
|
16
|
+
const token = pick("tokenSource");
|
|
17
|
+
// 用令牌登录时 CLI 的 accountInfo 是空的(实测),以这边存的为准
|
|
18
|
+
const saved = savedAuth();
|
|
19
|
+
const envKey = process.env.CODEBUDDY_API_KEY || process.env.CODEBUDDY_AUTH_TOKEN;
|
|
20
|
+
const loggedIn = !!(who || apiKey || (token && token !== "none") || saved || envKey);
|
|
21
|
+
const account = who
|
|
22
|
+
? `${who}${pick("subscriptionType") ? `(${pick("subscriptionType")})` : ""}`
|
|
23
|
+
: apiKey
|
|
24
|
+
? `API Key(${apiKey})`
|
|
25
|
+
: saved
|
|
26
|
+
? saved.user
|
|
27
|
+
: envKey
|
|
28
|
+
? "环境变量里的 API Key"
|
|
29
|
+
: undefined;
|
|
30
|
+
return { loggedIn, ...(account ? { account } : {}) };
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export type LoginState =
|
|
34
|
+
| { status: "idle" }
|
|
35
|
+
| { status: "waiting"; url: string; startedAt: number }
|
|
36
|
+
| { status: "done"; user: string; at: number }
|
|
37
|
+
| { status: "failed"; error: string; at: number };
|
|
38
|
+
|
|
39
|
+
const LOGIN_TIMEOUT = 5 * 60_000;
|
|
40
|
+
/** CLI 自己只等 1 分钟:这之后再点登录要换新链接,不能复用 */
|
|
41
|
+
const LINK_TTL = 55_000;
|
|
42
|
+
let state: LoginState = { status: "idle" };
|
|
43
|
+
let onDone: (() => void) | null = null;
|
|
44
|
+
|
|
45
|
+
export function loginState(): LoginState {
|
|
46
|
+
return state;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** 登录成功后要做的(清体检缓存之类),由调用方注册 */
|
|
50
|
+
export function onLoginDone(fn: () => void): void {
|
|
51
|
+
onDone = fn;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** 开始登录,拿到链接就返回(不等用户登完)。已经在等的就直接给那个链接 */
|
|
55
|
+
export async function startLogin(): Promise<string> {
|
|
56
|
+
if (state.status === "waiting" && Date.now() - state.startedAt < LINK_TTL) return state.url;
|
|
57
|
+
const { unstable_v2_authenticate } = await loadSdk();
|
|
58
|
+
return new Promise<string>((resolve, reject) => {
|
|
59
|
+
let gotUrl = false;
|
|
60
|
+
const site = environment();
|
|
61
|
+
const { environment: authEnv, pathToCodebuddyCode } = baseOptions();
|
|
62
|
+
unstable_v2_authenticate({
|
|
63
|
+
...(authEnv ? { environment: authEnv } : {}),
|
|
64
|
+
...(pathToCodebuddyCode ? { pathToCodebuddyCode } : {}),
|
|
65
|
+
env: workbuddyEnv() as Record<string, string>,
|
|
66
|
+
timeout: LOGIN_TIMEOUT,
|
|
67
|
+
onAuthUrl: (s) => {
|
|
68
|
+
gotUrl = true;
|
|
69
|
+
state = { status: "waiting", url: s.authUrl, startedAt: Date.now() };
|
|
70
|
+
resolve(s.authUrl);
|
|
71
|
+
},
|
|
72
|
+
})
|
|
73
|
+
.then((r) => {
|
|
74
|
+
const u = r.userinfo;
|
|
75
|
+
const user = u.userNickname || u.userName || u.userId;
|
|
76
|
+
if (u.token) saveAuth(site, { token: u.token, user, at: Date.now() });
|
|
77
|
+
state = { status: "done", user, at: Date.now() };
|
|
78
|
+
console.log(`[workbuddy] 已登录:${state.user}`);
|
|
79
|
+
onDone?.();
|
|
80
|
+
})
|
|
81
|
+
.catch((err) => {
|
|
82
|
+
const raw = err instanceof Error ? err.message : String(err);
|
|
83
|
+
// CLI 发出登录链接后只等 1 分钟(它自己定的,SDK 的 timeout 管不到),超时报的是 canceled / Authentication failed
|
|
84
|
+
const msg = /cancel|authentication failed/i.test(raw) ? "1 分钟内没有完成登录,链接已失效" : raw;
|
|
85
|
+
state = { status: "failed", error: msg, at: Date.now() };
|
|
86
|
+
if (!gotUrl) reject(err instanceof Error ? err : new Error(msg));
|
|
87
|
+
});
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
export async function logout(): Promise<void> {
|
|
92
|
+
const { unstable_v2_logout } = await loadSdk();
|
|
93
|
+
const { environment: authEnv, pathToCodebuddyCode } = baseOptions();
|
|
94
|
+
saveAuth(environment(), null);
|
|
95
|
+
await unstable_v2_logout({ ...(authEnv ? { environment: authEnv } : {}), ...(pathToCodebuddyCode ? { pathToCodebuddyCode } : {}), env: workbuddyEnv() as Record<string, string> }).catch(() => {});
|
|
96
|
+
state = { status: "idle" };
|
|
97
|
+
onDone?.();
|
|
98
|
+
}
|