@celljs/ta-agents 4.16.0 → 4.18.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/README.en.md +14 -2
- package/README.md +14 -2
- package/extension/index.mjs +571 -113
- package/host/index.mjs +668 -0
- package/package.json +21 -5
- package/web/index.js +386 -0
package/README.en.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Cell - Ta Agents
|
|
2
2
|
|
|
3
|
-
A pi package that comes with Ta (on by default; turn it off in Settings → Extensions of the web client): other coding agents as models to pick. A conversation on CodeBuddy Code, Claude Code or Codex runs every turn on that agent's own harness: its system prompt, tools, context management, subagents and login, so you get the agent as it works with its own models.
|
|
3
|
+
A pi package that comes with Ta (on by default; turn it off in Settings → Extensions of the web client): other coding agents as models to pick. A conversation on CodeBuddy Code, Claude Code or Codex runs every turn on that agent's own harness: its system prompt, tools, context management, subagents and login, so you get the agent as it works with its own models. At its core it is one pi extension (`src/extension.ts` → `extension/index.mjs`), with no change to Ta's core; pi can install it too. In Ta it also brings a section of the settings (`src/web.tsx` → `web/index.js`) and its server side (`src/host.ts` → `host/index.mjs`), which install these agents in one click:
|
|
4
4
|
|
|
5
5
|
```bash
|
|
6
6
|
pi install npm:@celljs/ta-agents
|
|
@@ -16,6 +16,18 @@ The agents are reached over the [Agent Client Protocol](https://agentclientproto
|
|
|
16
16
|
|
|
17
17
|
CodeBuddy Code works as in its own terminal: in PTC (code mode, its tools called through REPL; it declares `mainAgentSupport` / `toolModeSupport` and sets `CODEBUDDY_CODE_MODE_ENABLED=1`, without which ACP clients get the standard mode only), and a new session has full access (`options.mode`, which the settings change). npx fetches an adapter the first time it is used; the versions are pinned in the package. Each agent keeps its own login. When it offers ways to sign in over ACP (CodeBuddy Code), a message sent while it is signed out asks first which way to sign in with; the agent opens its page in the browser of this computer, a notice of Ta Web has an Open button for it (for a phone or another device), and the turn goes on once signed in. Otherwise, or without a UI (`pi -p`), the conversation says which command to run in a terminal (`cbc`, `claude`, `codex login`).
|
|
18
18
|
|
|
19
|
+
## Install them in the settings
|
|
20
|
+
|
|
21
|
+
On a computer without these agents (a Linux box just set up, say), Install in Settings → Coding agents of Ta installs one with npm into Ta's own directory `~/.ta/agent/coding-agents` (an npm prefix of its own: nothing in the global npm, no root), and it is a model in the + menu at once, without a restart. What each installs:
|
|
22
|
+
|
|
23
|
+
| Agent | Packages | How it starts |
|
|
24
|
+
| --- | --- | --- |
|
|
25
|
+
| CodeBuddy Code | `@tencent-ai/codebuddy-code` | `cbc --acp` |
|
|
26
|
+
| Claude Code | `@anthropic-ai/claude-code` and the adapter | the adapter, `CLAUDE_CODE_EXECUTABLE` set to the `claude` installed |
|
|
27
|
+
| Codex | `@openai/codex` and the adapter | the adapter, `CODEX_PATH` set to the `codex` installed |
|
|
28
|
+
|
|
29
|
+
The npm is the computer's (with Node.js 22 or newer); without one, Ta first downloads Node.js 22 from nodejs.org (checked against its SHA-256 sums) into `coding-agents/node`, for these agents alone (macOS and Linux, x64 and arm64). On Windows without Node.js, the settings link to its download. The user's own programs (on `PATH`) come before those Ta installed. An agent installed has a Sign in button: a terminal of this computer in a dialog, running its sign-in (`cbc`, `claude`, `codex login`), which works from a phone too.
|
|
30
|
+
|
|
19
31
|
## Use
|
|
20
32
|
|
|
21
33
|
Pick one in the model list of the + on the left of the input box, an agent's models are listed by their names, with the agent beside them (`Claude-Opus-5.5 codebuddy-code`, for example). Each agent is a provider (`codebuddy-code`, `claude-code`, `codex`) whose models are the ones the agent lists; `default` (the entry named only after the agent) uses the default model set up in the agent. The models are known once the agent ran, and kept in `~/.cache/ta-agents/models.json`. The thinking level becomes the agent's own (xhigh is CodeBuddy Code's `xhigh` or `max`, for example).
|
|
@@ -65,4 +77,4 @@ Fields: `name`, `command`, `args`, `env`, `login` (the sign-in command to tell t
|
|
|
65
77
|
|
|
66
78
|
- Conversations in `ssh://` directories (the agent runs on this computer and cannot see remote files).
|
|
67
79
|
- The agent's own slash commands (`available_commands_update`) are not in the + menu yet; typing `/command` in the box sends it to the agent as it is.
|
|
68
|
-
- The client file system and terminal of ACP are not offered: the agent reads and writes files and runs commands with its own tools.
|
|
80
|
+
- The client file system and terminal of ACP are not offered: the agent reads and writes files and runs commands with its own tools.
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Cell - Ta Agents
|
|
2
2
|
|
|
3
|
-
Ta 自带的 pi 包(默认开启,可在 Web 客户端的 设置 → 扩展 关闭):把别的 coding agent 当作模型来选。选了 CodeBuddy Code、Claude Code 或 Codex 的对话,每一轮都由那个 Agent 在它自己的 harness 上完成——它自己的系统提示、工具、上下文管理、子 Agent
|
|
3
|
+
Ta 自带的 pi 包(默认开启,可在 Web 客户端的 设置 → 扩展 关闭):把别的 coding agent 当作模型来选。选了 CodeBuddy Code、Claude Code 或 Codex 的对话,每一轮都由那个 Agent 在它自己的 harness 上完成——它自己的系统提示、工具、上下文管理、子 Agent 和登录,所以拿到的就是它在自家模型上的完整体验。核心是一个 pi 扩展(`src/extension.ts` → `extension/index.mjs`),不改 Ta 的核心,pi 也能装;在 Ta 里还带一个设置分区(`src/web.tsx` → `web/index.js`)和它的服务端(`src/host.ts` → `host/index.mjs`),用来一键安装这些 Agent:
|
|
4
4
|
|
|
5
5
|
```bash
|
|
6
6
|
pi install npm:@celljs/ta-agents
|
|
@@ -16,6 +16,18 @@ pi install npm:@celljs/ta-agents
|
|
|
16
16
|
|
|
17
17
|
CodeBuddy Code 和在它自己的终端里一样:用 PTC(代码模式,工具都经 REPL 调用;启动时声明 `mainAgentSupport` / `toolModeSupport` 并设 `CODEBUDDY_CODE_MODE_ENABLED=1`,不声明的 ACP 客户端只能用标准模式),新会话的权限模式是 Full Access(`options.mode`,可在设置里改)。适配器第一次用到时由 npx 下载,版本固定在包里。登录由各 Agent 自己管。Agent 在 ACP 里提供登录方式时(CodeBuddy Code),没登录就发消息会先问用哪种方式登录,Agent 在这台电脑的浏览器里打开登录页,Ta Web 的通知里也有“打开”按钮(给手机等别的设备用),登录好这一轮接着做;不提供、或没有界面(`pi -p`)时,对话里提示要在终端执行的命令(`cbc`、`claude`、`codex login`)。
|
|
18
18
|
|
|
19
|
+
## 在设置里安装
|
|
20
|
+
|
|
21
|
+
电脑上还没有这些 Agent 时(比如一台新装的 Linux 小机),在 Ta 的 设置 → 编程 Agent 里点“安装”:Ta 用 npm 把它装进自己的目录 `~/.ta/agent/coding-agents`(单独的 npm 前缀,不碰全局 npm,也不用 root),装好后它立刻出现在 + 菜单的模型里,不用重启。每个 Agent 装的包:
|
|
22
|
+
|
|
23
|
+
| Agent | 安装的包 | 怎么启动 |
|
|
24
|
+
| --- | --- | --- |
|
|
25
|
+
| CodeBuddy Code | `@tencent-ai/codebuddy-code` | `cbc --acp` |
|
|
26
|
+
| Claude Code | `@anthropic-ai/claude-code` 和适配器 | 适配器,`CLAUDE_CODE_EXECUTABLE` 指向装好的 `claude` |
|
|
27
|
+
| Codex | `@openai/codex` 和适配器 | 适配器,`CODEX_PATH` 指向装好的 `codex` |
|
|
28
|
+
|
|
29
|
+
npm 用电脑自己的(要求 Node.js 22 或更新);没有时 Ta 先从 nodejs.org 下载一份 Node.js 22(核对官方 SHA-256)放进 `coding-agents/node`,只给这些 Agent 用(macOS、Linux 的 x64 和 arm64)。Windows 上没有 Node.js 时,设置页给出 Node.js 的下载入口。用户自己装的程序(在 `PATH` 上)优先于 Ta 装的。装好的 Agent 有“登录”按钮:在对话框里打开这台电脑的终端,运行它的登录命令(`cbc`、`claude`、`codex login`),在手机上也能登录。
|
|
30
|
+
|
|
19
31
|
## 用法
|
|
20
32
|
|
|
21
33
|
在输入框左侧 + 号的模型列表里选,Agent 的模型在列表里写模型名,旁边标着 Agent(比如 `Claude-Opus-5.5 codebuddy-code`)。每个 Agent 是一个 provider(`codebuddy-code`、`claude-code`、`codex`),模型就是这个 Agent 自己列出的模型;`default`(列表里只写 Agent 名字的那一项)表示用 Agent 自己设置的默认模型。Agent 第一次运行后才知道它有哪些模型,之后缓存在 `~/.cache/ta-agents/models.json`。思考强度会换成 Agent 自己的档位(例如 xhigh 对应 CodeBuddy Code 的 `xhigh` 或 `max`)。
|
|
@@ -65,4 +77,4 @@ CodeBuddy Code 和在它自己的终端里一样:用 PTC(代码模式,工
|
|
|
65
77
|
|
|
66
78
|
- `ssh://` 远程目录里的对话(Agent 跑在本机,看不到远端文件)。
|
|
67
79
|
- Agent 自带的斜杠命令列表(`available_commands_update`)还没进 + 菜单;在输入框里直接输入 `/命令` 会原样发给 Agent。
|
|
68
|
-
- 不提供 ACP 的客户端文件系统和终端能力,Agent 用自己的工具读写文件、跑命令。
|
|
80
|
+
- 不提供 ACP 的客户端文件系统和终端能力,Agent 用自己的工具读写文件、跑命令。
|