@jingyi0605/codingns4dsh 0.2.0-rc.2 → 0.2.0-rc3

package/data/build/dist/host/cli-adapters/codebuddy-driver.d.ts

@@ -0,0 +1,139 @@
+import { readFileSync } from 'node:fs';
+import { spawn, spawnSync } from 'node:child_process';
+import type { CodingNsAgentEvent, CodingNsCliModelCatalog, CodingNsCliTurnInput } from '../../shared/contracts/cli-adapter.js';
+import type { CodingNsCliDriver, CodingNsCliSessionProbeInput, CodingNsCliSessionProbeResult } from './driver.js';
+/** 同源 CodeBuddy / WorkBuddy 的产品身份参数。协议驱动只实现一份。 */
+export interface CodeBuddyRuntimeProfile {
+    readonly adapterId: 'codebuddy' | 'workbuddy' | string;
+    readonly displayName: string;
+    readonly configRootEnvVars: readonly string[];
+    /** 读取配置根时使用的变量；未提供时沿用 configRootEnvVars。 */
+    readonly configRootLookupEnvVars?: readonly string[];
+    readonly defaultConfigRoot: string;
+    readonly historyDirRule: 'lowercase-slug' | 'preserve-case' | 'none';
+    readonly platforms: readonly NodeJS.Platform[];
+    readonly commandEnvOverride: string;
+    readonly binaries: readonly string[];
+    readonly bundledInApp: boolean;
+    /** 认证存储使用的 HOME；为空时沿用宿主 HOME。 */
+    readonly isolatedHome?: string;
+    /** 启动 CLI 时覆盖的产品环境变量；undefined 表示清除继承值。 */
+    readonly environmentOverrides?: Readonly<Record<string, string | undefined>>;
+    /** 模型目录的显式覆盖变量。 */
+    readonly modelCatalogEnvVar?: string;
+}
+export interface CodeBuddyDriverOptions {
+    /** 覆盖 PATH 候选命令，主要用于自定义安装与测试。 */
+    readonly binaries?: readonly string[];
+    /** 覆盖候选命令；显式值无效时不会回退到其他候选。 */
+    readonly commandPath?: string;
+    /** 测试与宿主注入的环境快照，不会写回 process.env。 */
+    readonly environment?: Readonly<Record<string, string | undefined>>;
+    /** `env` 是 environment 的兼容别名，便于与其他驱动测试保持一致。 */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly configRoot?: string;
+    readonly sessionRoots?: readonly string[];
+    readonly fallbackCatalog?: CodingNsCliModelCatalog;
+    readonly spawnSync?: typeof spawnSync;
+    readonly spawn?: typeof spawn;
+    readonly platform?: NodeJS.Platform;
+    /** 覆盖产品模型目录文件，主要用于测试和自定义安装。 */
+    readonly modelCatalogPaths?: readonly string[];
+    readonly readFileSync?: typeof readFileSync;
+    readonly profile?: CodeBuddyRuntimeProfile;
+    /** WorkBuddy 是否通过桌面 sidecar 启动受控 HTTP ACP；测试可显式关闭。 */
+    readonly useSidecar?: boolean;
+    /** 覆盖 WorkBuddy sidecar 控制 socket，便于诊断和测试。 */
+    readonly sidecarSocketPath?: string;
+    /** 覆盖 WorkBuddy Electron 启动器路径。 */
+    readonly workbuddyElectronPath?: string;
+}
+/** CodeBuddy 独立 CLI 的产品身份。 */
+export declare const CODEBUDDY_PROFILE: CodeBuddyRuntimeProfile;
+/** 旧版 CN profile 的兼容导出；运行时不再把它注册为独立 Agent。 */
+export declare const CODEBUDDY_CN_PROFILE: CodeBuddyRuntimeProfile;
+/** WorkBuddy 桌面应用内置 CLI 的产品身份。 */
+export declare const WORKBUDDY_PROFILE: CodeBuddyRuntimeProfile;
+/** 无副作用模型探测的最低回退项；登记层可以传入更完整的真实目录覆盖它。 */
+export declare const CODEBUDDY_DEFAULT_CATALOG: CodingNsCliModelCatalog;
+export declare const CODEBUDDY_CN_DEFAULT_CATALOG: CodingNsCliModelCatalog;
+export declare const WORKBUDDY_DEFAULT_CATALOG: CodingNsCliModelCatalog;
+/**
+ * CodeBuddy 与 WorkBuddy 共用的 ACP stdio 驱动。
+ *
+ * 每轮启动一个短生命周期 ACP 进程，继续会话时通过 `session/load` 恢复。
+ * 这样取消不会把残留取消态带到下一轮，且不需要复制厂商 SDK 或桌面应用登录态。
+ */
+export declare class CodeBuddyCliDriver implements CodingNsCliDriver {
+    readonly descriptor: Omit<import('../../shared/contracts/cli-adapter.js').CodingNsCliAdapterDescriptor, 'installed' | 'enabled' | 'version' | 'command'>;
+    /** CodeBuddy/WorkBuddy 的 ACP 流可由 Registry 在工具完成后暂停并续读。 */
+    readonly supportsToolStepSplitting = true;
+    protected readonly profile: CodeBuddyRuntimeProfile;
+    private readonly runSpawnSync;
+    private readonly runSpawn;
+    private readonly environment;
+    private readonly configRoot;
+    private readonly sessionRoots;
+    private readonly fallbackCatalog;
+    private readonly platform;
+    private readonly binaries;
+    private readonly binariesOverride;
+    private readonly modelCatalogPaths;
+    private readonly readModelCatalogFile;
+    private readonly commandPath;
+    private readonly useSidecar;
+    private readonly sidecarSocketPath;
+    private readonly workbuddyElectronPath;
+    private cachedCommand;
+    private lastVersion;
+    private detectionDiagnostic;
+    private readonly processes;
+    private readonly sidecarProcesses;
+    constructor(options?: CodeBuddyDriverOptions);
+    /** 当前使用的产品身份配置根，供测试和诊断使用；不包含凭据。 */
+    get configDirectory(): string;
+    /** 最近一次探测失败的脱敏诊断。 */
+    get discoveryError(): string | undefined;
+    getDiscoveryDiagnostic(): string | undefined;
+    detect(): Promise<{
+        installed: boolean;
+        version: string | null;
+        command: string | null;
+    }>;
+    /** 从产品快照读取模型目录；ACP 没有标准只读目录接口，不能创建会话探测模型。 */
+    listModels(): Promise<CodingNsCliModelCatalog>;
+    /** 只读扫描产品自己的历史根；不会调用 ACP load/prompt。 */
+    probeSession(input: CodingNsCliSessionProbeInput): Promise<CodingNsCliSessionProbeResult>;
+    executeTurn(input: CodingNsCliTurnInput): AsyncIterable<CodingNsAgentEvent>;
+    /** WorkBuddy 桌面版必须由 sidecar 启动，普通 Node ACP 不会收到字段加密密钥。 */
+    private executeWorkBuddySidecarTurn;
+    /** ACP 未提供 usage 时，从 CodeBuddy 已落盘的最新 assistant 记录补齐用量。 */
+    private readHistoryUsage;
+    /** 中断当前 ACP 进程；服务端取消失败时仍关闭本轮进程。 */
+    interrupt(sessionId: string): Promise<void>;
+    dispose(): void;
+    private explicitCommand;
+    private candidateCommands;
+    private detectCommand;
+    private runtimeEnvironment;
+}
+/** WorkBuddy 只允许应用内置 codebuddy，不会误启动 PATH 上的 CodeBuddy。 */
+export declare class WorkBuddyCliDriver extends CodeBuddyCliDriver {
+    constructor(options?: Omit<CodeBuddyDriverOptions, 'profile'>);
+}
+/** 旧版 CN 类名兼容导出；CN/国际版现在统一使用 codebuddy 适配器。 */
+export declare class CodeBuddyCnCliDriver extends CodeBuddyCliDriver {
+    constructor(options?: Omit<CodeBuddyDriverOptions, 'profile'>);
+}
+export { CodeBuddyCliDriver as CodeBuddyDriver, CodeBuddyCnCliDriver as CodeBuddyCnDriver };
+/** 解析 CodeBuddy ACP usage_update；仅投影会话上下文，不推断账户套餐额度。 */
+export declare function codeBuddyUsageChunk(value: unknown): CodingNsAgentEvent | null;
+/**
+ * 读取 CodeBuddy JSONL 中最新 assistant 记录的 provider 用量。
+ *
+ * CodeBuddy 的 ACP 通道不会把这组字段放进 `session/prompt`，但同一轮完成后
+ * 会把 `rawUsage` 和 `message.usage` 原样写入会话文件。这里按完整输入、缓存读、
+ * 缓存写三桶折算，避免把 `prompt_tokens` 和缓存桶重复计入 DSH。
+ */
+export declare function readCodeBuddyHistoryUsage(path: string): CodingNsAgentEvent | null;
+//# sourceMappingURL=codebuddy-driver.d.ts.map

package/data/build/dist/host/cli-adapters/codebuddy-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebuddy-driver.d.ts","sourceRoot":"","sources":["../../../../../src/host/cli-adapters/codebuddy-driver.ts"],"names":[],"mappings":"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"}