dsh-llm-codebuddy-power 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 pgnqukezrdxmhjso
+Copyright (c) 2026 Shatyuka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# dsh-llm-codebuddy-power
+
+![AI-Crap](https://img.shields.io/badge/%F0%9F%92%A9-AI_crap_code-5C4033?style=flat-square) [![npm](https://img.shields.io/npm/v/dsh-llm-codebuddy-power)](https://www.npmjs.com/package/dsh-llm-codebuddy-power) 
+
+[中文](./README.zh.md)
+
+dsh's CodeBuddy plugin — a complete set of CodeBuddy model capabilities.
+
+Design document: [design/en/current.md](design/en/current.md).
+
+## Install
+
+```bash
+dsh plugin --profile web add dsh-llm-codebuddy-power
+```
+
+**Installing through GitHub is not supported.**
+
+## Features
+
+- Registers the `codebuddy` LLM provider route with models from CodeBuddy's model catalog
+- Image input: image-capable models receive pasted or attached images
+- Image generation tool `codebuddy-draw` callable from chat, billed against CodeBuddy credits; click a generated image to open a full-size preview (under PTC mode the tool is folded into the `run_code` SDK, so the model may not call it on its own; remind it that `codebuddy-draw` exists)
+- Browser OAuth sign-in from the Web Settings → CodeBuddy page, no API key needed; several accounts can stay signed in, with each conversation choosing one
+- Settings-page account badges: a badge shows only the account and can be dragged to reorder the list (the order is also the CLI's numbering and the fallback account when no default is set); the top action row carries "Choose default", and the default badge's own "Default" marker removes it
+- Account control in the composer: a used-allowance ring (main and gifted allowances merged) plus an account button showing the current conversation's account
+- CodeBuddy model panel beside the model selector: promotion and subscription badges, credit multiplier, per-model details on hover or tap, and context-window / max-output overrides
+- Per-turn credit pill at the right end of the message tail action row (after other contributions), showing the credits spent that turn; hover it to see which accounts that turn was billed to
+- Settings page preferences stored in the harness user settings document: show the allowance ring, the low-allowance alert percentage, and whether minimal-mode (agent preset `minimal`) sessions see the draw tool
+- CLI account-management tool `codebuddy-power`
+
+## Usage examples
+
+Web: open **Settings → CodeBuddy** and click **Sign in** to add an account; the copy button beside it puts the sign-in link on the clipboard instead of opening it, for completing sign-in in another browser or on another machine. Drag a badge to reorder the list, pick the default account with **Choose default** (the default badge's **Default** marker removes it), and sign an account out with **Multi-select**; the account button in the composer switches the current conversation's account.
+
+CLI:
+
+```bash
+dsh plugin --profile web codebuddy-power # sign in through the browser and append an account
+```
+
+### CLI arguments
+
+| Argument | Description | Type | Required |
+|---|---|---|---|
+| `--status` | List every account by index with the default one marked, and show the model list | boolean | no |
+| `--default <account>` | Make the given account the default (`<account>` is a uid, index, or nickname) | string | no |
+| `--logout <account>` | Sign out the given account (`<account>` is a uid, index, or nickname) | string | no |
+| `--logout --all` | Sign out every account | boolean | no |
+| `--no-open` | Only print the sign-in link, do not open a browser | boolean | no |
+| `--help` / `-h` | Print usage | boolean | no |
+
+## dsh version used for development
+
+- dsh version used for development: `0.1.5-rc.2`. `@deepseek-ai/dsh-*` dependencies use `workspace:^`.
+
+## Secondary development
+
+- The plugin must stay at a `packages/<group>/` path inside the dsh checkout: its `tsconfig*.json` files extend the dsh repository's `tsconfig.base*.json`, so moving it outside the checkout breaks the build.
+- Local build: `pnpm --filter dsh-llm-codebuddy-power build` (`tsc -b` + `tsdown`, artifacts under `lib/`).
+
+-----
+
+## Runtime invariant
+
+No runtime invariant companion is published. Every registration this plugin makes — the `codebuddy` LLM adapter route (`ctx.llm.registerAdapter`), the `codebuddy-draw` tool, the `/codebuddy` RPC prefix route (`webServer.register`), and the `agent/created` / `agent-preset/selected` / `session/event` listeners — is effect-owned and leaves with the plugin fiber, and each owning registry (`dsh-llm`, `dsh-tools`, `dsh-host-webserver`, `dsh-agent`, `dsh-session`) asserts that relationship in its own companion. The plugin owns no cross-event durable relation and no second data source to compare: the per-turn credit record is a write-only projection into the plugin's own file, and the model panel and account control live in the browser process, beyond the host invariant service.

package/README.zh.md

@@ -0,0 +1,66 @@
+# dsh-llm-codebuddy-power
+
+![AI-Crap](https://img.shields.io/badge/%F0%9F%92%A9-AI_crap_code-5C4033?style=flat-square) [![npm](https://img.shields.io/npm/v/dsh-llm-codebuddy-power)](https://www.npmjs.com/package/dsh-llm-codebuddy-power) 
+
+[English](./README.md)
+
+dsh 的 CodeBuddy 插件——提供完整的 CodeBuddy 模型能力。
+
+设计文档：[design/zh/current.md](design/zh/current.md)。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-llm-codebuddy-power
+```
+
+**不支持通过 GitHub 安装。**
+
+## 功能
+
+- 注册 `codebuddy` LLM 供应商路由，模型来自 CodeBuddy 模型目录
+- 图片输入：支持图片的模型可接收粘贴/挂载的图片
+- 聊天可调用的文生图工具 `codebuddy-draw`，按 CodeBuddy 积分计费；点击生成图片可查看大图（PTC 模式下工具被折叠进 `run_code` SDK，模型可能不会主动调用，需提醒它存在 `codebuddy-draw`）
+- 浏览器 OAuth 登录（Web 设置 → CodeBuddy 页面），无需 API key；可同时登录多个账号，每个会话各选一个
+- 设置页账号徽章：徽章只显示账号，可拖拽排序（该顺序同时是命令行的序号，以及没有默认账号时的兜底账号）；默认账号由首行的「选择默认」选定，点徽章上的「默认」标记即可取消
+- 对话框输入区的账号控件：额度圆环（主额度与赠送额度合并）+ 账号切换按钮，显示当前会话账号的昵称
+- 模型选择器旁的 CodeBuddy 模型面板：促销与订阅徽章、积分倍率、悬停或点按详情，以及上下文窗口/最大输出覆写
+- 消息尾部操作行最右端的每轮积分 pill（排在其他贡献之后），显示该轮消耗积分；悬停可见该轮花的是哪些账号
+- 设置页偏好存于 harness 用户设置文档：是否显示额度圆环、余量告警百分比、极简模式（agent preset `minimal`）会话是否出现画图工具
+- 命令行账号管理工具 `codebuddy-power`
+
+## 使用示例
+
+Web：打开 **设置 → CodeBuddy**，点击 **登录** 可追加一个账号；旁边的复制按钮把登录链接放进剪贴板而不打开它，用于在别的浏览器或别的机器上完成登录。拖拽徽章可调整顺序，用 **选择默认** 指定默认账号（点徽章上的 **默认** 标记可取消），退出账号用 **多选**；对话框输入区的账号按钮可为当前会话单独切换。
+
+CLI：
+
+```bash
+dsh plugin --profile web codebuddy-power # 浏览器登录并追加一个账号
+```
+
+### CLI 参数
+
+| 参数名 | 说明 | 类型 | 必填 |
+|---|---|---|---|
+| `--status` | 按序号列出全部账号与默认账号，并显示模型列表 | 布尔 | 否 |
+| `--default <账号>` | 把指定账号设为默认账号（`<账号>` 为 uid、序号或昵称） | 字符串 | 否 |
+| `--logout <账号>` | 退出指定账号（`<账号>` 为 uid、序号或昵称） | 字符串 | 否 |
+| `--logout --all` | 退出全部账号 | 布尔 | 否 |
+| `--no-open` | 仅打印登录链接，不打开浏览器 | 布尔 | 否 |
+| `--help` / `-h` | 显示用法 | 布尔 | 否 |
+
+## 构建时使用的 dsh 版本
+
+- 构建时使用的 dsh 版本：`0.1.5-rc.2`；`@deepseek-ai/dsh-*` 依赖使用 `workspace:^`。
+
+## 二次开发说明
+
+- 插件必须位于 dsh 检出内的 `packages/<组>/` 路径下：插件的 `tsconfig*.json` 依赖 dsh 仓库的 `tsconfig.base*.json`，移出检出目录会无法构建。
+- 本地构建：`pnpm --filter dsh-llm-codebuddy-power build`（`tsc -b` + `tsdown`，产物在 `lib/`）。
+
+-----
+
+## 运行时 invariant
+
+不发布 `./invariant` companion。本插件的每一项注册——`codebuddy` LLM 适配器路由（`ctx.llm.registerAdapter`）、`codebuddy-draw` 工具、`/codebuddy` RPC 前缀路由（`webServer.register`），以及 `agent/created`、`agent-preset/selected`、`session/event` 监听——都由 effect 持有并随插件 fiber 释放，其归属关系分别由各自的宿主注册表（`dsh-llm`、`dsh-tools`、`dsh-host-webserver`、`dsh-agent`、`dsh-session`）在自己的 companion 中断言。本插件自身不持有跨事件的持久关系，也没有可供交叉比对的第二数据源：每轮积分记录是写入插件自有文件的单向投影，模型面板与账号控件位于浏览器进程内，宿主 invariant 服务无法观察。

package/cordis.patch.yml

@@ -0,0 +1,32 @@
+# The dsh-llm-codebuddy-power bundle patch.
+#
+# Applied as ONE insert after the in-box bundle layers (dsh-base, and for the
+# web profile dsh-web-app), so this row lands on top of them without touching
+# any row they own. Registering a provider needs no change to the `llm` row —
+# this plugin injects the `llm` service and calls
+# `ctx.llm.registerAdapter()` when it activates.
+#
+# Activation is service-availability driven, not row-order driven: the entry
+# below declares `inject: ['llm']` in code, so Cordis mounts it once the `llm`
+# service from dsh-base is up, regardless of where this row sits.
+#
+# Config is omitted deliberately — every field of the plugin's Config is
+# optional and the shipped defaults reach the public CodeBuddy service. There
+# is no credential field by design; sign in through the Web Settings → CodeBuddy
+# page or `dsh plugin --profile web codebuddy-power`.
+#
+# The `showUsage`, `dangerPct` and `drawToolInMinimal` fields are the base layer
+# of the plugin's user-settings namespace: the Web Settings → CodeBuddy page
+# writes the user layer over them.
+#
+# To pin a different endpoint, sizing, or preference default, override this row
+# by id from your profile's own cordis.patch.yml, for example:
+#
+#   - id: llm-codebuddy-power
+#     config:
+#       streamIdleTimeoutMs: 120000
+#       dangerPct: 80
+
+- insert:
+    - id: llm-codebuddy-power
+      name: 'dsh-llm-codebuddy-power'