dsh-llm-codebuddy-power 1.0.0

package/lib/types/adapter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * `CodeBuddyAdapter`:针对 CodeBuddy 的 OpenAI 兼容聊天路由使用 fetch + SSE,
+ * 身份与模型目录则从 OAuth 会话解析。
+ *
+ * 这一区分很重要:聊天面兼容 OpenAI,而目录面并不兼容,因此模型信息取自 CodeBuddy
+ * 自己的 `/v3/config` 响应——每个模型的工具调用、推理、图像与尺寸事实都出自那里。
+ * 本类中不存在任何 API key;每个请求都由会话刷新的、浏览器签发的 bearer token 授权。
+ *
+ * @module dsh-llm-codebuddy-power/adapter
+ */
+import { LlmAdapter } from '@deepseek-ai/dsh-llm';
+import type { GenerateOptions, LlmModelInfo, LlmProviderInfo, LlmResolvedModelInfo, StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { AttachmentStore } from '@deepseek-ai/dsh-attachment';
+import { DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_TOKENS } from './constants.ts';
+import type { CodeBuddySession } from './session.ts';
+import type { WireError } from './types.ts';
+import type { ModelOverrides } from './model-enrich.ts';
+/** 由注册插件解析、适配器直接采信的连接事实。 */
+export interface CodeBuddyConnectionOptions {
+    /** 聊天 endpoint 的基地址;其后会追加 `/chat/completions`。 */
+    baseURL: string;
+    /** 目录未给出模型容量时使用的上下文容量。 */
+    defaultContextWindow: number;
+    /** 目录未给出模型上限时使用的单请求输出上限。 */
+    defaultMaxTokens: number;
+    /** 单次流读取尚未返回时,provider 允许的最大空闲时间。 */
+    streamIdleTimeoutMs: number;
+}
+/** 构造参数:会话,以及每次操作调用的连接 thunk。 */
+export interface CodeBuddyAdapterOptions {
+    session: CodeBuddySession;
+    options: () => CodeBuddyConnectionOptions;
+    /** 解析持久化附件服务;缺失时拒绝图像输入。 */
+    resolveAttachments: () => AttachmentStore | undefined;
+    /** 已设置时,解析用户为单个模型设置的上限(上下文窗口 / 最大输出)。 */
+    resolveOverrides?: (modelId: string) => Promise<ModelOverrides | undefined>;
+}
+/**
+ * 把 HTTP 状态码映射为稳定的 harness 错误码。
+ * @param status - 非 2xx 的状态码。
+ * @param error - 可读取时,已解析的 provider 错误体。
+ * @returns 归一化后的错误码。
+ */
+export declare function httpErrorCode(status: number, error?: WireError['error']): string;
+/**
+ * CodeBuddy 适配器。单个实例服务于唯一的 `codebuddy` 路由,
+ * 以及该路由目录报告的全部模型。
+ */
+export declare class CodeBuddyAdapter extends LlmAdapter {
+    private readonly config;
+    constructor(config: CodeBuddyAdapterOptions);
+    providerInfo(provider: string): LlmProviderInfo;
+    listModels(provider: string): Promise<readonly LlmModelInfo[]>;
+    resolveModel(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
+    stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
+}
+export { DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_TOKENS };
+//# sourceMappingURL=adapter.d.ts.map

package/lib/types/atomic-file.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 插件自有 JSON 文件的写入底座:原子替换 + 按路径串行化。
+ *
+ * 三个存储(账号、会话选择、每轮积分)都是读-改-写的文件。原子替换让
+ * 残缺内容永远不会留在磁盘上被当成一份读不出的记录;按路径排队让并发写入
+ * 串行执行 —— 后一次读得到前一次的结果,而不是各自基于同一份旧内容覆盖对方。
+ * 集中在这里,使三个存储不会各自实现一遍,也不会各自漏掉队列。
+ *
+ * @module dsh-llm-codebuddy-power/atomic-file
+ */
+/**
+ * 排队一次针对某文件的写:前一次写完成后才开始执行。
+ *
+ * 队尾保存的是已消化失败的 promise —— 它的拒绝无人 await,留着会变成未处理的
+ * rejection;调用方从返回的 promise 收到同一个失败。
+ * @param path - 被写的文件。
+ * @param write - 实际写入;在同一路径的写之间串行执行。
+ * @returns 本次写入的结果;失败时以该失败拒绝。
+ */
+export declare function queueWrite(path: string, write: () => Promise<void>): Promise<void>;
+/**
+ * 以原子替换写入一个文件,并在支持的文件系统上收紧为仅属主可读。
+ *
+ * 先写同目录下的临时文件再改名:改名在同一文件系统内是原子的,因此读到的
+ * 要么是旧内容要么是新内容,不会是写了一半的内容。
+ *
+ * 内容是调用方给的字符串而不是由本函数序列化:`JSON.stringify` 的默认输出是一个
+ * 字节的重复都没有的紧凑格式,可读性全靠调用方自己插入的换行 —— 需要控制"哪里换行"
+ * 的存储因此各自决定格式(见 `session-store.ts` 的逐轮一行)。
+ * @param path - 目标文件。
+ * @param content - 要写入的完整内容。
+ */
+export declare function writeFileAtomic(path: string, content: string): Promise<void>;
+/**
+ * 以原子替换写入一个 JSON 文件,缩进两格。
+ *
+ * 缩进是给需要肉眼排查的凭据文件用的(`storage.ts` 的 refresh token 与过期时间),
+ * 不是通用默认值:批量记录类文件改用 {@link writeFileAtomic} 自己排版。
+ * @param path - 目标文件。
+ * @param value - 要序列化的值。
+ */
+export declare function writeJsonAtomic(path: string, value: unknown): Promise<void>;
+//# sourceMappingURL=atomic-file.d.ts.map

package/lib/types/auth-service.d.ts

@@ -0,0 +1,195 @@
+/**
+ * 通过私有 RPC 通道暴露给 Web 客户端的宿主侧 OAuth 服务。
+ *
+ * 浏览器登录是长时操作(要等待用户完成登录),因此拆成两个 RPC endpoint:
+ * `startLogin` 生成握手并返回用户必须打开的 URL,`pollLogin` 检查该握手是否已完成;
+ * 一次完成的登录会**追加**一个账号,而不是取代已有的。`accounts`、`activate`、
+ * `setDefault`、`logout` 是设置页与会话账号按钮其余时间驱动的读写组合。
+ *
+ * @module dsh-llm-codebuddy-power/auth-service
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { CodeBuddySession } from './session.ts';
+import type { CodeBuddyAccountInfo } from './session.ts';
+import type { EnrichedModelRow } from './model-enrich.ts';
+/** 客户端调用认证服务所用的 RPC 通道。 */
+export declare const CODEBUDDY_AUTH_CHANNEL = "/codebuddy";
+/** `accounts` 返回给客户端的结构。 */
+export interface CodeBuddyAccountsResult {
+    /** 已存账号,顺序与磁盘一致。 */
+    accounts: CodeBuddyAccountInfo[];
+    /** 用户显式指定的默认账号;未指定或缺省时缺省。 */
+    defaultUid?: string;
+}
+/** `startLogin` 返回给客户端的结构。 */
+export interface CodeBuddyLoginStart {
+    /** 用户必须打开以完成登录的 URL。 */
+    authUrl: string;
+    /** 握手 id;客户端会把它回传给 `pollLogin`。 */
+    state: string;
+}
+/** `pollLogin` 返回给客户端的结构。 */
+export interface CodeBuddyLoginPoll {
+    /** 握手是否已完成,且账号已持久化。 */
+    done: boolean;
+    /** 登录刚刚完成时的显示名称。 */
+    nickname?: string;
+}
+/** `sessionAccount` 返回给客户端的结构。 */
+export interface CodeBuddySessionAccount {
+    /** 该会话此刻生效的账号 uid;一个账号也没有时缺省。 */
+    uid?: string;
+}
+/**
+ * 发给客户端的一个计量窗口,是 {@link UsageWindow} 的纯数据投影,
+ * 其中的可选字段可以安全省略。
+ */
+export interface CodeBuddyUsageWindow {
+    name: string;
+    used?: number;
+    limit?: number;
+    resetsAt?: string;
+}
+/** 发给客户端的一个聚合额度池。 */
+export interface CodeBuddyUsagePool {
+    used: number;
+    limit: number;
+}
+/** 赠送额度的汇总,以及其提示中最近到期的明细。 */
+export interface CodeBuddyUsageGift extends CodeBuddyUsagePool {
+    /** 生效中的赠送窗口,按最早到期在前排序,最多 5 个。 */
+    soonest: CodeBuddyUsageWindow[];
+}
+/** `usage` 返回给客户端的结构。 */
+export interface CodeBuddyUsageResult {
+    /** 该会话是否有可用账号;为 false 表示没有用量可显示。 */
+    loggedIn: boolean;
+    /**
+     * 首个计量窗口的重置时刻,与主池的数值显示在同一行提示里;平面未报告窗口
+     * 或该窗口未披露重置时刻时为 `undefined`。
+     */
+    primaryResetsAt?: string;
+    /** 可刷新的主额度池。 */
+    main?: CodeBuddyUsagePool;
+    /** 一次性的赠送额度池及其最近到期明细。 */
+    gift?: CodeBuddyUsageGift;
+}
+/** `creditOf` 返回给客户端的一条轮次记录。 */
+export interface CodeBuddyTurnCreditResult {
+    credit: number;
+    /** 本轮扣分用过的账号,按首次使用排序;一轮里切换过账号时会有多个。 */
+    accounts: CodeBuddyTurnCreditAccount[];
+}
+/** `creditOf` 返回给客户端的一个账号。 */
+export interface CodeBuddyTurnCreditAccount {
+    nickname: string;
+    /** uid 的显示前段;提示框只用于区分同名账号,不必给全量。 */
+    uidPrefix: string;
+}
+/**
+ * CodeBuddy 认证 RPC 服务。
+ *
+ * 握手由 `startLogin` 发起,由 `pollLogin` 轮询至完成,其账号由适配器的
+ * `CodeBuddySession` 在下一个请求中取用 → 因此通过 UI 完成的登录无需重启
+ * 即可到达运行中的 harness。`logout` 移除指定账号并使会话缓存失效。
+ */
+export declare class CodeBuddyAuthService {
+    private readonly session?;
+    /** 按 state id 索引的进行中握手。 */
+    private readonly pending;
+    constructor(ctx: Context, session?: CodeBuddySession | undefined);
+    /** 把一次 RPC endpoint 调用路由到对应的处理器。 */
+    private dispatch;
+    /**
+     * 读取已存账号及其默认账号,不要求必须存在。
+     * @returns 账号集合;未存任何内容时为空列表。
+     */
+    accounts(): Promise<CodeBuddyAccountsResult>;
+    /**
+     * 发起一次浏览器登录握手。
+     * @returns 用户必须打开的 URL。
+     */
+    startLogin(): Promise<CodeBuddyLoginStart>;
+    /**
+     * 检查已发起的握手是否完成。
+     * @param state - 来自 `startLogin` 的握手 id。
+     * @returns 登录是否完成、账号是否已持久化。
+     */
+    pollLogin(state: string): Promise<CodeBuddyLoginPoll>;
+    /**
+     * 某会话此刻生效的账号。
+     * @param sessionId - dsh 会话身份;为空时按未选定处理。
+     * @returns 该会话的账号 uid;没有账号时缺省。
+     */
+    sessionAccount(sessionId: string): Promise<CodeBuddySessionAccount>;
+    /**
+     * 把某会话的账号切换为指定账号。
+     * @param sessionId - dsh 会话身份。
+     * @param uid - 目标账号 uid。
+     * @returns 该账号已存时为 true。
+     */
+    activate(sessionId: string, uid: string): Promise<boolean>;
+    /**
+     * 放弃一次进行中的登录握手。
+     *
+     * 中止底层的令牌轮询并丢弃该握手:用户点了取消之后,客户端不再轮询,而宿主也不该
+     * 继续占着一个十分钟的轮询循环。未知或已完成的 state 视作已经结束,返回 true ——
+     * 取消是幂等的收尾动作,没有"已经取消过"这种失败。
+     * @param state - 来自 `startLogin` 的握手 id。
+     * @returns 该握手是否已被放弃(未知 state 同样是 true)。
+     */
+    cancelLogin(state: string): boolean;
+    /**
+     * 指定或取消默认账号。
+     * @param uid - 默认账号 uid;`undefined` 表示取消默认账号。
+     * @returns 指定时该账号已存、或取消成功时为 true。
+     */
+    setDefault(uid: string | undefined): Promise<boolean>;
+    /**
+     * 移除若干账号。
+     * @param uids - 要移除的账号 uid。
+     */
+    logout(uids: readonly string[]): Promise<void>;
+    /**
+     * 按给定顺序重排账号。
+     *
+     * 顺序即展示顺序,也是没有默认账号、也没有手动切换记录时的兜底账号,因此这里真的
+     * 改变"用谁"。重排会让输入区控件组读到的账号集合顺序变化,故同样使会话缓存失效。
+     * @param uids - 目标顺序上的账号 uid。
+     */
+    reorder(uids: readonly string[]): Promise<void>;
+    /**
+     * 为界面读取某会话账号的 CodeBuddy 用量快照。
+     *
+     * 委托给会话完成:会话会在读取计量前解析刷新后的身份,且计量服务不可用时不会抛错。
+     * 没有账号时按 `loggedIn: false` 上报,让客户端隐藏该呈现,
+     * 而不是渲染出坏掉的进度条。
+     * @param sessionId - dsh 会话身份。
+     * @returns 用量投影;没有账号时返回未登录结构。
+     */
+    usage(sessionId: string): Promise<CodeBuddyUsageResult>;
+    /**
+     * 把一次握手推进到持久化的账号。
+     *
+     * 复用 `buildAccount`,使落盘结构与 CLI 登录完全一致。
+     * 任何失败都返回 `undefined`,让客户端的轮询得到 `done: false`,
+     * 从而可以从 `startLogin` 重试。
+     */
+    private runLogin;
+    /**
+     * 供客户端面板使用的增强版 CodeBuddy 目录:应用了促销/等级展示信息与覆盖配置的模型。
+     * @param sessionId - 用哪个会话的账号读目录;为空时用默认账号。
+     * @returns 增强结果;会话不可用或该账号没有目录时为空行。
+     */
+    enrichedModels(sessionId: string): Promise<{
+        models: EnrichedModelRow[];
+    }>;
+    /**
+     * 插入或更新(或清除)单个模型的用户覆盖配置,并持久化整张表。
+     * @param modelId - 模型 id。
+     * @param payload - `{ contextWindow?, maxOutputTokens? }`;显式缺省或非正数的字段
+     *   会清除对应的上限。
+     */
+    setOverride(modelId: string, payload: unknown): Promise<void>;
+}
+//# sourceMappingURL=auth-service.d.ts.map

package/lib/types/cli/login.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * `codebuddy-power`:通过浏览器登录 CodeBuddy,把账号追加到插件读取的账号列表,
+ * 并管理那份列表。
+ *
+ * 刻意作为独立入口而非 harness 内的提示:该流程需要浏览器和
+ * 人工,而运行中的 agent 不应为等待它而阻塞模型调用。已在运行
+ * 的 harness 会在下一次请求时取用该账号,无需重启。
+ *
+ * 用法:
+ *   codebuddy-power                     登录并追加账号
+ *   codebuddy-power --status            列出全部账号与默认账号
+ *   codebuddy-power --default <账号>    把某个账号设为默认
+ *   codebuddy-power --logout <账号>     退出一个账号
+ *   codebuddy-power --logout --all      退出全部账号
+ *   codebuddy-power --no-open           只打印 URL,不打开浏览器
+ *
+ * `<账号>` 可以是 `--status` 列出的序号、账号 uid 或昵称。
+ *
+ * @module dsh-llm-codebuddy-power/cli/login
+ */
+export {};
+//# sourceMappingURL=login.d.ts.map

package/lib/types/client/AccountSwitcher.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 对话框输入区里的 CodeBuddy 账号控件:一个额度圆环加一个账号切换按钮。
+ *
+ * 它注册在 `conversation.input.right`,与 CodeBuddy 模型按钮同处一个插槽元素、
+ * 排在其左侧。两者都按**当前会话**取数:圆环显示该会话此刻生效账号的用量
+ * (主额度与赠送额度合并成一个圆环,百分比按两者之和算),按钮显示该账号昵称的
+ * 缩写,点开在账号之间切换 —— 每个会话各选各的,不影响别的会话。
+ *
+ * **不挂 store**:本插槽是会话作用域,而设置页是 root 作用域,一个 store handle
+ * 只能绑一个作用域(挂两处会在加载时抛 "one handle, one scope")。账号集合因此在
+ * 这里由注入面按轮询间隔自取。
+ *
+ * 偏好不是自取的:它经注入面的 `hooks` 隔舱与设置页共享同一个活来源(用户设置
+ * 文档里的命名空间),因此「显示额度余量」开关翻动的那一帧圆环就跟着出现或消失,
+ * 不经过轮询。
+ *
+ * @module dsh-llm-codebuddy-power/client/AccountSwitcher
+ */
+import type { ReactElement } from 'react';
+import type { HostObservable, InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { CodeBuddyPrefs } from '../prefs.ts';
+import type { CodeBuddyKey } from './locales.ts';
+import type { CodeBuddyAccountView, CodeBuddyUsageResult } from './wire.ts';
+/** 本控件按会话取数的注入面。 */
+export interface AccountSwitcherInjected {
+    hooks: {
+        /** 三个界面偏好的当前值,与设置页同源。 */
+        prefs: HostObservable<CodeBuddyPrefs>;
+    };
+    /** 读取账号集合与默认账号。 */
+    fetchAccounts: () => Promise<{
+        accounts: CodeBuddyAccountView[];
+        defaultUid: string | null;
+    } | null>;
+    /** 读取该会话此刻生效的账号 uid;没有账号时为 null。 */
+    fetchSessionAccount: () => Promise<string | null>;
+    /** 把该会话切换到指定账号;该账号已存时解析为 true。 */
+    activate: (uid: string) => Promise<boolean>;
+    /** 读取该会话生效账号的用量;没有账号或计量不可用时为 null。 */
+    fetchUsage: () => Promise<CodeBuddyUsageResult | null>;
+}
+/** 插槽 runtime 份额 + locale + 注入 face。 */
+export type AccountSwitcherProps = PropsRuntime<'conversation.input.right'> & {
+    t: (key: CodeBuddyKey, params?: Record<string, unknown>) => string;
+} & InjectFace<AccountSwitcherInjected>;
+/**
+ * 会话账号控件:额度圆环(可选)+ 账号切换按钮。
+ * @param props - 带注入 face 的插槽 props。
+ * @returns 控件元素;一个账号都没有时为 null。
+ */
+export declare function AccountSwitcher(props: AccountSwitcherProps): ReactElement | null;
+export type { AccountSwitcherProps as CodeBuddyAccountSwitcherProps };
+//# sourceMappingURL=AccountSwitcher.d.ts.map

package/lib/types/client/CodeBuddySection.d.ts

@@ -0,0 +1,62 @@
+/**
+ * CodeBuddy 设置分区:多账号登录页。
+ *
+ * 展示全部已登录账号(每个账号一个徽章),在此发起浏览器登录以**追加**账号、
+ * 退出单个或选中的多个账号、指定或取消默认账号;下方是两种登录状态下都渲染的
+ * 界面偏好行。退出是破坏性操作(会删除磁盘上的凭据),因此单个与批量都先弹确认框。
+ * 弹窗可见性由 shell 拥有,故此处不需要关闭控件。
+ */
+import type { ReactElement } from 'react';
+import type { HostObservable, InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import { createCodeBuddyStore } from './store.ts';
+import type { CodeBuddyPrefs } from '../prefs.ts';
+/**
+ * 设置分区与对话内账号控件共享的、经 RPC 支撑的业务面。每个回调都经 store action
+ * 写入;组件自身不接触 wire。
+ *
+ * 界面偏好走 `hooks` 隔舱:它与对话输入区的控件组是同一份活来源(用户设置文档里
+ * 的命名空间),写入经 `setPref`。
+ */
+export interface CodeBuddySectionInjected {
+    hooks: {
+        /** 三个界面偏好的当前值,与对话输入区的控件组同源。 */
+        prefs: HostObservable<CodeBuddyPrefs>;
+    };
+    /** 重新读取账号集合与默认账号,并离开加载阶段。 */
+    refreshAccounts: () => Promise<void>;
+    /** 发起浏览器登录握手(在新标签页打开鉴权 URL);完成后账号被追加到列表。 */
+    startLogin: () => Promise<void>;
+    /**
+     * 发起一次登录握手并把鉴权 URL 复制到剪贴板(不打开浏览器),用于在别的浏览器或
+     * 机器上完成登录。失败时会发布一条页面级错误。
+     * @returns 链接是否已复制到剪贴板。
+     */
+    copyLoginLink: () => Promise<boolean>;
+    /**
+     * 放弃一次进行中的登录握手,并把界面从“登录中”收回到可再次发起的状态。
+     * @returns 是否确已放弃;未知或已完成的握手同样返回 true(取消是幂等的)。
+     */
+    cancelLogin: (state: string) => Promise<boolean>;
+    /** 按 state id 轮询一次握手;账号持久化后解析为 true。 */
+    pollLogin: (state: string) => Promise<boolean>;
+    /** 退出若干账号。 */
+    logoutAccounts: (uids: string[]) => Promise<void>;
+    /**
+     * 按给定顺序重排账号。顺序即展示顺序,并决定没有默认账号时用谁。
+     * @param uids - 目标顺序上的全部账号 uid。
+     */
+    reorderAccounts: (uids: string[]) => Promise<void>;
+    /** 指定默认账号;`null` 表示取消默认账号。 */
+    setDefault: (uid: string | null) => Promise<void>;
+    /** 写入一个界面偏好字段;该写入持久化到用户设置文档。 */
+    setPref: (field: keyof CodeBuddyPrefs, value: boolean | number) => void;
+}
+/** 完整组件 props:runtime 份额 + store 份额 + locale seat + inject face。 */
+export type CodeBuddySectionProps = PropsRuntime<'settings.section'> & PropsStore<ReturnType<typeof createCodeBuddyStore>> & PropsLocale<'settings.codebuddy'> & InjectFace<CodeBuddySectionInjected>;
+/**
+ * CodeBuddy 设置分区。
+ * @param props - 组合后的 slot props。
+ * @returns 分区的元素树。
+ */
+export declare function CodeBuddySection(props: CodeBuddySectionProps): ReactElement;
+//# sourceMappingURL=CodeBuddySection.d.ts.map

package/lib/types/client/ComposerControls.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 对话框输入区里的 CodeBuddy 控件组:额度圆环、账号切换按钮与模型面板的 logo 按钮。
+ *
+ * 三者注册为 `conversation.input.right` 的**同一个条目**,因此处在同一个容器元素里。
+ * 分成两个条目时它们只是插槽 owner 容器下的两个兄弟元素,各自带自己的根元素,中间
+ * 还隔着该容器的间距 —— 读起来像两组互不相干的控件,而它们其实是同桌的三个按钮。
+ *
+ * @module dsh-llm-codebuddy-power/client/ComposerControls
+ */
+import type { ReactElement } from 'react';
+import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { AccountSwitcherInjected } from './AccountSwitcher.tsx';
+import type { ModelPanelInjected } from './ModelPanel.tsx';
+import type { CodeBuddyKey } from './locales.ts';
+/** 插槽 runtime 份额 + locale + 两个子控件的注入面。 */
+export type ComposerControlsProps = PropsRuntime<'conversation.input.right'> & {
+    t: (key: CodeBuddyKey, params?: Record<string, unknown>) => string;
+} & InjectFace<AccountSwitcherInjected & ModelPanelInjected>;
+/**
+ * 把额度圆环、账号切换按钮与模型面板拼进同一个容器。
+ *
+ * 两个子控件各自接受 runtime 份额与自己的注入成员,因此整份 props 原样透传即可:
+ * 它们看到的正是自己声明的那部分。
+ * @param props - 组合后的 slot props。
+ * @returns 控件组元素。
+ */
+export declare function ComposerControls(props: ComposerControlsProps): ReactElement;
+export type { ComposerControlsProps as CodeBuddyComposerControlsProps };
+//# sourceMappingURL=ComposerControls.d.ts.map

package/lib/types/client/DrawToolCard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * codebuddy-draw 工具的浏览器卡片:按已结算工具结果 content 里的标准
+ * ImageBlock,经系统附件通道(loadImage → uiConversation.imageUrl →
+ * session.readAttachment)读取图片并在对话中内联展示,图下方标注提示词
+ * 与实际扣分。重启后图片仍可读(附件持久化于磁盘,读经 host 鉴权通道)。
+ *
+ * @module dsh-llm-codebuddy-power/client/DrawToolCard
+ */
+import { type ReactElement } from 'react';
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
+/** 组件 props:标准 toolview 份额 + locale seat + 注册时 inject face 注入的 loadImage。 */
+type DrawToolCardProps = ToolCallViewProps & PropsLocale<'settings.codebuddy'> & {
+    loadImage: ((attachment: ImageAttachmentRef) => Promise<string>) | undefined;
+};
+/**
+ * codebuddy-draw 的 keyed toolview 组件。运行中的调用显示占位;已结算
+ * 结果按 content 里的标准 ImageBlock 经 loadImage 渲染图片,meta 缺失时
+ * (如无卡片客户端回放)返回空。
+ */
+export declare function DrawToolCard(props: DrawToolCardProps): ReactElement | null;
+export {};
+//# sourceMappingURL=DrawToolCard.d.ts.map

package/lib/types/client/ModelPanel.d.ts

@@ -0,0 +1,77 @@
+/**
+ * CodeBuddy 模型能力面板：官方模型选择器（conversation.input.right）旁边的
+ * 一个按钮，点击后打开仅包含 CodeBuddy 模型的列表，其中的模型带有促销/档位
+ * 信息。悬停某一行会显示提示框，内含模型信息，以及就地覆盖上下文窗口和最大
+ * 输出 token 数的输入项；两者都通过宿主覆盖存储按模型持久化，并传给
+ * resolveModel，由 dsh 依据它们管理上下文与输出上限。
+ *
+ * 与上游项目不同，本面板不会遮蔽官方的 conversation.input.model 座位——
+ * 选择仍然流经共享的 ModelDirectory，因此官方座位、/model 弹窗和本面板保持
+ * 同步。
+ *
+ * @module dsh-llm-codebuddy-power/client/ModelPanel
+ */
+import type { ReactElement } from 'react';
+import type { HostObservable, InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { CodeBuddyKey } from './locales.ts';
+import type { CodeBuddyModelRow, CodeBuddyModelOverrides } from './wire.ts';
+/** 本面板读取的共享模型目录快照的最小投影。 */
+export interface CodeBuddyDirectoryState {
+    current: {
+        provider: string;
+        model: string;
+        reasoningEffort?: string;
+    } | null;
+    groups: readonly {
+        id: string;
+        name: string;
+        models: readonly {
+            id: string;
+            name: string;
+            /**
+             * 该模型公布的思考等级。来自共享目录而非本插件的富化 RPC:harness 组装目录
+             * 时会对每个模型额外调一次 `resolveModelInfo` 取推理元数据,那份数据只存在
+             * 于目录快照里,富化行没有它。
+             */
+            reasoning?: {
+                efforts: readonly {
+                    id: string;
+                    name: string;
+                }[];
+                defaultEffort?: string;
+            };
+        }[];
+    }[];
+    status: 'idle' | 'loading' | 'selecting' | 'ready' | 'error';
+}
+/** 注入侧：共享模型目录 + 本插件的富化 RPC。 */
+export interface ModelPanelInjected {
+    hooks: {
+        /** 会话共享的模型目录快照（与官方座位是同一个存储）。 */
+        directory: HostObservable<CodeBuddyDirectoryState>;
+    };
+    /** 确保共享目录已加载。 */
+    load: () => void;
+    /** 提交一次 provider/model 选择（写回共享目录）。 */
+    select: (selection: {
+        provider: string;
+        model: string;
+        reasoningEffort?: string;
+    }) => Promise<boolean>;
+    /** 获取富化后的 CodeBuddy 模型行。 */
+    fetchModels: () => Promise<CodeBuddyModelRow[]>;
+    /** 持久化某个模型的覆盖值。 */
+    saveOverrides: (modelId: string, overrides: CodeBuddyModelOverrides) => Promise<void>;
+}
+/** 插槽 owner props + locale + 注入 face。 */
+export type ModelPanelProps = PropsRuntime<'conversation.input.right'> & {
+    t: (key: CodeBuddyKey, params?: Record<string, unknown>) => string;
+} & InjectFace<ModelPanelInjected>;
+/**
+ * CodeBuddy 模型面板的触发按钮 + 弹出层。
+ * @param props - 带注入 face 的插槽 props。
+ * @returns 触发按钮、打开时的面板，以及行的提示框。
+ */
+export declare function ModelPanel(props: ModelPanelProps): ReactElement | null;
+export type { ModelPanelProps as CodeBuddyModelPanelProps };
+//# sourceMappingURL=ModelPanel.d.ts.map

package/lib/types/client/TurnCreditPill.d.ts

@@ -0,0 +1,33 @@
+/**
+ * codebuddy 每轮积分的按钮 pill,插在官方用量/耗时 pill 同一行的
+ * `conversation.chat.assistant-actions` seat(copy/branch 之间)。
+ *
+ * owner 只给 durable `messageId`,轮号由 `useChat` 快照里匹配的 assistant
+ * 节点反查(`AssistantMessageNode.turn`);再经注入的 RPC 查该轮积分,有记录
+ * 则渲染,无记录(非 CodeBuddy 轮)渲染为空。与官方 `TurnUsagePanel` 同构:
+ * 图标 + 文字标签,点击无详情面板(仅展示一条合计)。
+ *
+ * 悬停提示附上本轮用过的账号:账号在扣分那一刻随记录写入(见 host 的
+ * `recordCredit`),不是悬停时现查 —— 一轮里用户可以切换账号,现查会把整轮
+ * 说成最后那个账号。
+ *
+ * @module dsh-llm-codebuddy-power/client/TurnCreditPill
+ */
+import type { ReactElement } from 'react';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { AssistantActionOwnerProps } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { CodeBuddyTurnCreditRecord } from './wire.ts';
+/** 注册侧提供的 credit 查询 face。 */
+export interface TurnCreditInjected {
+    /** 查询某会话某一轮的积分记录(无则 undefined)。 */
+    creditOf: (sessionId: string, turn: number) => Promise<CodeBuddyTurnCreditRecord | undefined>;
+}
+/** 组件 props:assistant-actions owner 的 messageId + 标准 session 份额 + locale + inject face。 */
+export type TurnCreditPillProps = Pick<AssistantActionOwnerProps, 'messageId'> & PropsRuntime<'conversation.chat.assistant-actions'> & PropsLocale<'settings.codebuddy'> & TurnCreditInjected;
+/**
+ * 每轮积分 pill。messageId 反查轮号后查该轮记录;无记录渲染为空(未用
+ * CodeBuddy 模型即一轮 0 分也渲染,有记录即证明用了 CodeBuddy)。只显示
+ * 积分,模型由 dsh 用量自带;悬停给出本轮用过的账号。
+ */
+export declare function TurnCreditPill(props: TurnCreditPillProps): ReactElement | null;
+//# sourceMappingURL=TurnCreditPill.d.ts.map

package/lib/types/client/UsageIndicator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 渲染在侧边栏底部 Settings 触发项上方的用量指示器。
+ *
+ * 宽列在赠送剩余额度的纯文本行上方显示主池的进度条(可续期额度 —— 自定义配额
+ * 上限与危险阈值仅作用于该进度条);赠送行的 tooltip 列出五个最早过期的有效赠送
+ * 窗口及其剩余/总量数值。未登录的账号、计量服务故障或空池都不渲染任何内容 ——
+ * 该提示纯属附加。窄栏列为主池保留单个圆环,其下是赠送剩余的裸数值。
+ */
+import type { ReactElement } from 'react';
+import type { PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import { createCodeBuddyStore } from './store.ts';
+import type { CodeBuddySectionInjected } from './CodeBuddySection.tsx';
+/** 完整组件 props:footer-action 运行时份额 + store + locale + 注入 face。 */
+export type CodeBuddyUsageIndicatorProps = PropsRuntime<'sidebar.footer.action'> & PropsStore<ReturnType<typeof createCodeBuddyStore>> & PropsLocale<'settings.codebuddy'> & CodeBuddySectionInjected;
+/**
+ * 两条用量进度条(宽列)或主池圆环(窄栏),仅在存在可用池时渲染。
+ * @param props - 组合后的 slot props。
+ * @returns 指示器元素;无内容显示时为 null。
+ */
+export declare function UsageIndicator(props: CodeBuddyUsageIndicatorProps): ReactElement | null;
+//# sourceMappingURL=UsageIndicator.d.ts.map

package/lib/types/client/icons.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 以行内图标组件形式给出的 CodeBuddy 品牌 logo。
+ *
+ * dsh 客户端栈把图标按代码渲染(ui-primitives 的图标是行内 SVG)而非图片资源,
+ * 故插件 logo 在此内联。源图形是 40×40 的品牌标识(紫色圆角方块 + 白色字形);
+ * 组件经标准 IconProps 的 size 缩放它。
+ *
+ * @module dsh-llm-codebuddy-power/client/icons
+ */
+import type { ReactElement } from 'react';
+/** 行内图标的通用尺寸。 */
+export interface IconProps {
+    /** 边长,单位 px;默认 16。 */
+    size?: number;
+    /** 可选地拼接到 svg 上的 class(无默认值)。 */
+    className?: string;
+}
+/**
+ * CodeBuddy 徽标图形。
+ * @param props - 尺寸与 class。
+ * @returns 行内 SVG。
+ */
+export declare function CodeBuddyLogo({ size, className }: IconProps): ReactElement;
+//# sourceMappingURL=icons.d.ts.map