@tencent-ai/agent-harness 0.2.0-beta.7 → 0.2.0-beta.8

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/dependency-resolver.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 插件依赖解析器
+ * DFS 闭包算法，支持循环检测、跨市场限制、自动降级
+ *
+ * 参考: Claude Code dependencyResolver.ts (305行)
+ */
+export interface PluginDependencyNode {
+    /** 插件 ID (name@marketplace) */
+    id: string;
+    /** 插件名称 */
+    name: string;
+    /** 市场名称 */
+    marketplace: string;
+    /** 依赖列表（插件 ID 格式） */
+    dependencies: string[];
+}
+export interface DependencyResolutionResult {
+    /** 解析成功的依赖闭包（按拓扑排序） */
+    resolved: string[];
+    /** 缺失的依赖 */
+    missing: string[];
+    /** 循环依赖链 */
+    cycles: string[][];
+    /** 被降级（自动禁用）的插件 */
+    demoted: string[];
+}
+/**
+ * 使用 DFS 解析插件的传递依赖闭包
+ *
+ * @param rootId 根插件 ID
+ * @param lookup 所有可用插件的映射
+ * @returns 传递依赖的 ID 集合（不包含 rootId 本身）
+ */
+export declare function resolveDependencyClosure(rootId: string, lookup: Map<string, PluginDependencyNode>): DependencyResolutionResult;
+/**
+ * 验证并降级：检查所有插件的依赖是否满足
+ * 如果某个插件的依赖缺失或有循环，自动将其标记为降级（禁用）
+ *
+ * @param plugins 所有启用的插件列表
+ * @param allowCrossMarketplaceDeps 是否允许跨市场依赖（默认 false）
+ * @returns 降级结果
+ */
+export declare function verifyAndDemote(plugins: PluginDependencyNode[], allowCrossMarketplaceDeps?: boolean): DependencyResolutionResult;

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/directory-plugin-cache-projection.d.ts

@@ -0,0 +1,2 @@
+export declare function isCurrentDirectoryPluginCacheProjection(targetDir: string, sourceDir: string): Promise<boolean>;
+export declare function replaceWithDirectoryPluginCacheProjection(sourceDir: string, targetDir: string, cacheRoot: string): Promise<boolean>;

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/guards/index.d.ts

@@ -0,0 +1,2 @@
+import './weixinpay-integrity-guard.js';
+export { WeixinpayIntegrityGuard } from './weixinpay-integrity-guard.js';

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/guards/weixinpay-integrity-guard.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Weixinpay plugin directory integrity guard.
+ *
+ * On Windows, verifies the weixinpay plugin directory against its
+ * manifest.qmsig using QmProtectorLib.dll. Bun executables use Bun's native
+ * FFI; the Node/npm distribution keeps Koffi as its Node-API adapter.
+ * On other platforms or when the runtime FFI is unavailable, passthrough.
+ */
+import { PluginInfo, PluginLoadGuard } from '../plugin-protocol.js';
+/**
+ * Windows x64 layout of QM_SIGNER_VERIFY_OPTIONS / RESULT.
+ *
+ * The Bun branch is intentionally local to Agent CLI: Agent Harness embeds
+ * the same CodeBuddy bundle but neither knows about this plugin nor ships a
+ * generic native FFI sidecar.
+ */
+export declare function createBunFfiWeixinpayBinding(ffi: BunFfiModule, dllPath: string): WeixinpayBinding;
+export declare class WeixinpayIntegrityGuard implements PluginLoadGuard {
+    private readonly logger;
+    private bindingCache;
+    canLoad(plugin: PluginInfo): Promise<boolean>;
+    private getBinding;
+    private pathExists;
+}
+interface WeixinpayBinding {
+    verify(rootDir: string, manifestPath: string): {
+        hr: number;
+        filesOk: number;
+        filesBad: number;
+        filesMissing: number;
+        extraEntries: number;
+    };
+}
+export interface BunFfiModule {
+    readonly FFIType: {
+        readonly i32: number;
+        readonly ptr: number;
+    };
+    dlopen(path: string, symbols: Record<string, {
+        readonly args: readonly number[];
+        readonly returns: number;
+    }>): {
+        readonly close?: () => void;
+        readonly symbols: Record<string, (optionsPointer: number, resultPointer: number) => number>;
+    };
+    ptr(value: Uint8Array): number;
+}
+export {};

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 插件系统
+ *
+ * 提供完整的插件管理功能,包括:
+ * 1. 市场管理: 支持本地/Git/HTTP多种市场源
+ * 2. 插件管理: 安装/卸载/启用/禁用插件
+ * 3. 扩展加载: 自动加载agents/commands/skills/mcps等扩展
+ *
+ * @example
+ * // 添加市场
+ * const marketplace = await marketplaceManager.add('./local-marketplace', 'my-marketplace');
+ *
+ * // 安装插件
+ * await pluginManager.install('my-plugin', 'my-marketplace', { autoEnable: true });
+ *
+ * // 列出已安装插件
+ * const plugins = await pluginManager.getInstalled();
+ */
+export * from './plugin-protocol.js';
+export * from './concurrency.js';
+export * from './marketplace-name-validator.js';
+export * from './marketplace-path-safety.js';
+export * from './dependency-resolver.js';
+export * from './plugin-environment.js';
+export * from './plugin-policy-service.js';
+export * from './plugin-runtime-refresh-service.js';
+export * from './plugin-options-storage.js';
+export * from './plugin-validator.js';
+export * from './mcpb-handler.js';
+export * from './zip-utils.js';
+export * from './marketplaces/index.js';
+export * from './plugin-manager.js';
+export * from './loaders/index.js';
+export * from './plugin-controller.js';
+export * from './installers/index.js';
+export * from './plugin-error-collector.js';
+export * from './plugin-install-stats-service.js';
+export * from './guards/index.js';
+export * from './directory-plugin-cache-projection.js';
+export * from './plugin-mcp-snapshot.js';
+export * from './session-plugin-snapshot.js';
+export * from './plugin-read-summary.js';

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/installers/git-plugin-installer.d.ts

@@ -0,0 +1,42 @@
+import { MarketplacePluginEntry, PluginErrorCollector, PluginInstaller, PluginSource, ProgressCallback } from '../plugin-protocol.js';
+/**
+ * Git远程仓库插件安装器
+ * 处理source.source === 'url'的插件
+ */
+export declare class GitPluginInstaller implements PluginInstaller {
+    protected readonly errorCollector: PluginErrorCollector;
+    /**
+     * 判断是否支持该插件源
+     * 支持: PluginSource对象且source === 'url' 或 'github'
+     */
+    support(pluginSource: string | PluginSource | undefined): boolean;
+    /**
+     * 安装Git远程插件
+     * 克隆Git仓库到指定目录
+     */
+    install(pluginEntry: MarketplacePluginEntry, targetDir: string, onProgress?: ProgressCallback): Promise<string>;
+    /**
+     * 更新已安装的Git插件
+     * 执行git pull更新内容
+     */
+    update(pluginEntry: MarketplacePluginEntry, installedPath: string, onProgress?: ProgressCallback): Promise<string>;
+    /**
+     * 检查Git插件是否已安装
+     */
+    isInstalled(pluginEntry: MarketplacePluginEntry, marketplaceInstalledPath: string): Promise<string | undefined>;
+    /**
+     * 获取插件的当前版本信息(commit hash)
+     */
+    getInstalledVersion(installedPath: string): Promise<string | undefined>;
+    /**
+     * 获取插件的远程URL
+     */
+    getRemoteUrl(installedPath: string): Promise<string | undefined>;
+    /**
+     * 从PluginSource解析实际的Git URL
+     * @param source 插件源配置
+     * @returns Git URL
+     */
+    private resolveGitUrl;
+    private validateGitSha;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/installers/git-subdir-plugin-installer.d.ts

@@ -0,0 +1,19 @@
+import { Logger } from '@celljs/core';
+import { MarketplacePluginEntry, PluginInstaller, PluginSource } from '../plugin-protocol.js';
+/**
+ * Git 子目录插件安装器
+ * 使用 git sparse checkout 从 monorepo 的子目录安装插件
+ * 避免全量克隆整个仓库
+ *
+ * 参考: Claude Code schemas.ts:1131-1157
+ */
+export declare class GitSubdirPluginInstaller implements PluginInstaller {
+    protected readonly logger: Logger;
+    protected init(): void;
+    support(pluginSource: string | PluginSource): boolean;
+    install(pluginEntry: MarketplacePluginEntry, targetDir: string, onProgress?: (message: string) => void): Promise<string>;
+    update(pluginEntry: MarketplacePluginEntry, installedPath: string, onProgress?: (message: string) => void): Promise<string>;
+    isInstalled(pluginInfo: MarketplacePluginEntry, marketplaceInstalledPath: string): Promise<string | undefined>;
+    private validateGitSha;
+    private getValidatedSubdir;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/installers/index.d.ts

@@ -0,0 +1,4 @@
+export { LocalPluginInstaller } from './local-plugin-installer.js';
+export { GitPluginInstaller } from './git-plugin-installer.js';
+export { NpmPluginInstaller } from './npm-plugin-installer.js';
+export { GitSubdirPluginInstaller } from './git-subdir-plugin-installer.js';

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/installers/local-plugin-installer.d.ts

@@ -0,0 +1,40 @@
+import { MarketplacePluginEntry, PluginErrorCollector, PluginInstaller, PluginSource, ProgressCallback } from '../plugin-protocol.js';
+/**
+ * 本地相对路径插件安装器
+ * 处理source.source === 'local'的插件
+ */
+export declare class LocalPluginInstaller implements PluginInstaller {
+    protected readonly errorCollector: PluginErrorCollector;
+    /**
+     * 判断是否支持该插件源
+     * 支持:
+     * 1. 字符串类型source(视为本地相对路径)
+     * 2. PluginSource对象且source === 'local'
+     */
+    support(pluginSource: string | PluginSource): boolean;
+    /**
+     * 安装本地插件
+     * 本地插件无需实际安装,只需解析路径
+     */
+    install(pluginEntry: MarketplacePluginEntry, targetDir: string, onProgress?: ProgressCallback): Promise<string>;
+    /**
+     * 更新本地插件
+     * 本地插件无需更新,直接返回路径
+     */
+    update(pluginEntry: MarketplacePluginEntry, installedPath: string, onProgress?: ProgressCallback): Promise<string>;
+    /**
+     * 检查本地插件是否已安装(已解析)
+     */
+    isInstalled(pluginEntry: MarketplacePluginEntry, marketplaceInstalledPath: string): Promise<string | undefined>;
+    /**
+     * 解析插件的实际路径
+     * 支持两种路径模式:
+     * 1. 直接指向插件根目录: targetDir/path（含 "." / "./" = 市场根本身）
+     * 2. 指向插件的父目录: targetDir/path/pluginName
+     */
+    private resolvePluginPath;
+    /**
+     * 标准化插件源为PluginSource对象
+     */
+    private normalizeSource;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/installers/npm-plugin-installer.d.ts

@@ -0,0 +1,23 @@
+import { Logger } from '@celljs/core';
+import { MarketplacePluginEntry, PluginInstaller, PluginSource } from '../plugin-protocol.js';
+/**
+ * npm 插件安装器
+ * 通过 npm install 安装插件包到指定目录
+ *
+ * 参考: Claude Code schemas.ts:974-1050
+ */
+export declare class NpmPluginInstaller implements PluginInstaller {
+    protected readonly logger: Logger;
+    protected init(): void;
+    support(pluginSource: string | PluginSource): boolean;
+    install(pluginEntry: MarketplacePluginEntry, targetDir: string, onProgress?: (message: string) => void): Promise<string>;
+    update(pluginEntry: MarketplacePluginEntry, installedPath: string, onProgress?: (message: string) => void): Promise<string>;
+    isInstalled(pluginInfo: MarketplacePluginEntry, marketplaceInstalledPath: string): Promise<string | undefined>;
+    /** Fail-closed: package name must be a valid npm id (scoped ok); never a path. */
+    private resolvePackageName;
+    /**
+     * Resolve `node_modules/<package>` under the install dir. Scoped names become
+     * two segments (`@scope`, `name`); containment rejects any escape (#71947).
+     */
+    private resolvePackageDir;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/loaders/agent-loader.d.ts

@@ -0,0 +1,43 @@
+import { Logger } from '@celljs/core';
+import { Agent } from '../../../../../product/lib/common/index.js';
+import { PluginEnvironmentContext } from '../plugin-environment.js';
+import { PluginErrorCollector, PluginExtensionType } from '../plugin-protocol.js';
+/**
+ * Agent 扩展加载器
+ * 从扩展目录的 agents 子目录中加载 agent 配置
+ * 支持配置路径和默认扫描的合并
+ */
+export declare class AgentExtensionLoader {
+    readonly type = PluginExtensionType.Agent;
+    protected readonly logger: Logger;
+    protected readonly errorCollector: PluginErrorCollector;
+    protected init(): void;
+    /**
+     * 加载 agents
+     * 如果提供了 agentPaths 配置，则加载指定路径；否则默认扫描 agents 目录
+     * 两种方式的结果会被合并，并通过路径去重避免重复加载
+     * @param extensionDir 扩展目录路径
+     * @param extensionName 扩展名称（用于标记）
+     * @param agentPaths 可选的 agent 路径配置数组，相对于 extensionDir
+     * @returns Agent 数组
+     */
+    load(extensionDir: string, extensionName: string, agentPaths?: string[], pluginEnvironment?: PluginEnvironmentContext): Promise<Agent[]>;
+    /**
+     * 从指定的 agent 路径加载
+     * @param extensionDir 扩展目录路径
+     * @param extensionName 扩展名称
+     * @param agentPaths agent 路径配置数组
+     * @param loadedPaths 已加载的路径集合，用于去重
+     * @returns Agent 数组
+     */
+    private loadFromPaths;
+    private pathExists;
+    /**
+     * 递归枚举插件 agents 目录下的 .md 文件（走 data-fs seam，注入卷可见）。
+     * 深度上限防御异常插件树；软链条目用 stat 归类，与 DirectoryScanUtils 一致。
+     */
+    private scanMdFiles;
+    private scanAgentsDirectory;
+    private parseAgentFile;
+    private generateSourceLabel;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/loaders/command-loader.d.ts

@@ -0,0 +1,39 @@
+import { Logger } from '@celljs/core';
+import { Command, type ProductConfiguration } from '../../../../../product/lib/common/index.js';
+import { PluginEnvironmentContext } from '../plugin-environment.js';
+import { PluginErrorCollector, PluginExtensionType } from '../plugin-protocol.js';
+/**
+ * Command 扩展加载器
+ * 从扩展目录的 commands 子目录中加载 slash command 配置
+ * 支持配置路径和默认扫描的合并
+ */
+export declare class CommandExtensionLoader {
+    readonly type = PluginExtensionType.Command;
+    protected readonly logger: Logger;
+    protected readonly errorCollector: PluginErrorCollector;
+    protected init(): void;
+    /** Embedding hosts can supply the Product belonging to their own assembly. */
+    protected getProductConfiguration(): Pick<ProductConfiguration, 'models'> | undefined;
+    /**
+     * 加载 commands
+     * 如果提供了 commandPaths 配置，则加载指定路径；否则默认扫描 commands 目录
+     * 两种方式的结果会被合并，并通过路径去重避免重复加载
+     * @param extensionDir 扩展目录路径
+     * @param source 来源
+     * @param commandPaths 可选的 command 路径配置数组，相对于 extensionDir
+     * @returns Command 数组
+     */
+    load(extensionDir: string, source: string, commandPaths?: string[], pluginEnvironment?: PluginEnvironmentContext): Promise<Command[]>;
+    /**
+     * 从指定的 command 路径加载
+     * @param extensionDir 扩展目录路径
+     * @param source 来源
+     * @param commandPaths command 路径配置数组
+     * @param loadedPaths 已加载的路径集合，用于去重
+     * @returns Command 数组
+     */
+    private loadFromPaths;
+    private pathExists;
+    private scanCommandsDirectory;
+    private parseCommandFile;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/loaders/hook-loader.d.ts

@@ -0,0 +1,55 @@
+import { Logger } from '@celljs/core';
+import { HookConfig } from '../../../../../../node/hooks/hook-protocol.js';
+import { PluginEnvironmentContext } from '../plugin-environment.js';
+import { PluginOptionsStorage } from '../plugin-options-storage.js';
+import { PluginExtensionType, PluginHooksConfig } from '../plugin-protocol.js';
+/**
+ * Hook 扩展加载器
+ * 从扩展目录中加载 hooks 配置
+ * 支持配置路径和默认扫描的合并
+ */
+export declare class HookExtensionLoader {
+    readonly type = PluginExtensionType.Hook;
+    protected readonly logger: Logger;
+    protected readonly pluginOptionsStorage?: PluginOptionsStorage;
+    protected init(): void;
+    /**
+     * 加载 hooks 配置
+     * 如果提供了 hooksConfig 配置，则加载指定配置；否则默认扫描 hooks.json 文件
+     * 两种方式的结果会被合并
+     * @param extensionDir 扩展目录路径
+     * @param source 来源
+     * @param hooksConfig 可选的 hooks 配置，可以是文件路径或直接的配置对象
+     * @returns Hook 配置对象，键为事件名，值为 HookConfig 数组
+     */
+    load(extensionDir: string, source: string, hooksConfig?: PluginHooksConfig, pluginEnvironment?: PluginEnvironmentContext): Promise<Record<string, HookConfig[]>>;
+    /**
+     * 从配置加载 hooks
+     * @param extensionDir 扩展目录路径
+     * @param source 来源
+     * @param hooksConfig hooks 配置，可以是文件路径或直接的配置对象
+     * @returns Hook 配置对象
+     */
+    private loadFromConfig;
+    private mergeHooks;
+    private pathExists;
+    /**
+     * 从文件加载 hooks
+     * @param filePath 文件路径
+     * @param source 来源
+     * @returns Hook 配置对象
+     */
+    private loadFromFile;
+    /**
+     * 验证 hooks 配置格式是否正确
+     * @param config 配置对象
+     * @returns 是否为有效的 hooks 配置
+     */
+    private isValidHooksConfig;
+    /**
+     * 验证单个 HookConfig 是否有效
+     * @param config HookConfig 对象
+     * @returns 是否为有效的 HookConfig
+     */
+    private isValidHookConfig;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/loaders/index.d.ts

@@ -0,0 +1,8 @@
+export * from './agent-loader.js';
+export * from './command-loader.js';
+export * from './skill-loader.js';
+export * from './hook-loader.js';
+export * from './mcp-loader.js';
+export * from './lsp-loader.js';
+export * from './output-style-loader.js';
+export * from './plugin-loader-manager.js';

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/loaders/lsp-loader.d.ts

@@ -0,0 +1,47 @@
+import { Logger } from '@celljs/core';
+import { PluginEnvironmentContext } from '../plugin-environment.js';
+import { PluginOptionsStorage } from '../plugin-options-storage.js';
+import { LspServerConfig, PluginExtensionType } from '../plugin-protocol.js';
+/**
+ * LSP 服务器加载器
+ * 从扩展目录中加载 LSP 服务器配置
+ * 支持配置路径和默认扫描的合并
+ */
+export declare class LSPExtensionLoader {
+    readonly type = PluginExtensionType.LSP;
+    protected readonly logger: Logger;
+    protected readonly pluginOptionsStorage?: PluginOptionsStorage;
+    protected init(): void;
+    /**
+     * 加载 LSP 服务器配置
+     * 如果提供了 lspConfig 配置,则加载指定配置;否则默认扫描 .lsp.json
+     * 如果 plugin.json 中配置了 lspServers,优先使用该配置,忽略 .lsp.json
+     * @param extensionDir 扩展目录路径
+     * @param extensionName 扩展名称(用于标记)
+     * @param lspConfig 可选的 LSP 配置,可以是文件路径或直接的配置对象
+     * @returns LSP 服务器配置对象
+     */
+    load(extensionDir: string, extensionName: string, lspConfig?: string | Record<string, LspServerConfig>, pluginEnvironment?: PluginEnvironmentContext): Promise<Record<string, LspServerConfig>>;
+    /**
+     * 从配置加载 LSP 服务器
+     * @param extensionDir 扩展目录路径
+     * @param extensionName 扩展名称
+     * @param lspConfig LSP 配置,可以是文件路径或直接的配置对象
+     * @returns LSP 服务器配置对象
+     */
+    private loadFromConfig;
+    /**
+     * 从 .lsp.json 配置文件加载 LSP 服务器
+     */
+    private loadFromConfigFile;
+    private pathExists;
+    /**
+     * 解析 LSP 服务器配置文件
+     */
+    private parseServerConfigFile;
+    private enrichWithPluginEnvironment;
+    /**
+     * 验证 LSP 配置
+     */
+    private validateConfigs;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/loaders/mcp-loader.d.ts

@@ -0,0 +1,75 @@
+import { Logger } from '@celljs/core';
+import { McpConfig } from '../../../../../../node/mcp/index.js';
+import { PluginEnvironmentContext } from '../plugin-environment.js';
+import { PluginOptionsStorage } from '../plugin-options-storage.js';
+import { McpBundleEntry, PluginErrorCollector, PluginExtensionType } from '../plugin-protocol.js';
+/**
+ * MCP 服务器加载器
+ * 从扩展目录中加载 MCP 服务器配置
+ * 支持配置路径和默认扫描的合并
+ */
+export declare class MCPExtensionLoader {
+    readonly type = PluginExtensionType.MCP;
+    protected readonly logger: Logger;
+    protected readonly errorCollector: PluginErrorCollector;
+    protected readonly pluginOptionsStorage?: PluginOptionsStorage;
+    protected init(): void;
+    /**
+     * 加载 MCP 服务器配置
+     * 如果提供了 mcpConfig 配置，则加载指定配置；否则默认扫描 mcp.json 和 mcp 目录
+     * 两种方式的结果会被合并
+     * @param extensionDir 扩展目录路径
+     * @param extensionName 扩展名称（用于标记）
+     * @param mcpConfig 可选的 MCP 配置，可以是文件路径或直接的配置对象
+     * @param mcpBundles 可选的 MCP Bundle 列表
+     * @returns MCP 服务器配置对象
+     */
+    load(extensionDir: string, extensionName: string, mcpConfig?: string | Record<string, McpConfig>, mcpBundles?: McpBundleEntry[], pluginEnvironment?: PluginEnvironmentContext): Promise<Record<string, McpConfig>>;
+    /**
+     * 从配置加载 MCP 服务器
+     * @param extensionDir 扩展目录路径
+     * @param extensionName 扩展名称
+     * @param mcpConfig MCP 配置，可以是文件路径或直接的配置对象
+     * @returns MCP 服务器配置对象
+     */
+    private loadFromConfig;
+    /**
+     * 从 mcp.json 配置文件加载 MCP 服务器
+     */
+    private loadFromConfigFile;
+    /**
+     * 从 mcp 目录扫描加载 MCP 服务器配置
+     */
+    private loadFromDirectory;
+    private pathExists;
+    /**
+     * Parse MCP server config file.
+     *
+     * Supports JSONC format with:
+     * - Single-line comments (//)
+     * - Multi-line comments (/* *\/)
+     * - Trailing commas
+     *
+     * @param filePath - Path to the config file
+     * @returns MCP server configurations
+     */
+    private parseServerConfigFile;
+    private enrichWithPluginEnvironment;
+    /**
+     * 当 MCP 配置未显式声明 `type` 时，按现有字段推断出完整类型。
+     * 推断规则与 mcp-config-manager.normalizePartialData 保持一致：
+     *   - `command`  → stdio
+     *   - `ideName`  → ws-ide
+     *   - `url`      → http
+     * 若已有合法 `type`（stdio/sse/http/remote/ws-ide/sse-ide），原样返回。
+     * 若既无 `type` 也无法推断，返回 `null` 表示应跳过。
+     */
+    private inferTypeIfMissing;
+    /**
+     * 推断是否为扁平的 MCP server 配置格式
+     * 当没有 mcpServers 字段时，检查每个顶层 entry 的 value 是否包含 command 或 url 字段
+     * @param config 解析后的配置对象
+     * @returns 如果是扁平格式则返回配置对象，否则返回空对象
+     */
+    private inferFlatFormat;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/plugins/loaders/output-style-loader.d.ts

@@ -0,0 +1,49 @@
+import { Logger } from '@celljs/core';
+import { PluginErrorCollector, PluginExtensionType, PluginOutputStyleEntry } from '../plugin-protocol.js';
+/**
+ * Output Style 扩展加载器
+ * 从扩展目录的 output-styles 子目录中加载 output style 配置
+ * 支持配置路径和默认扫描的合并
+ */
+export declare class OutputStyleExtensionLoader {
+    readonly type = PluginExtensionType.OutputStyle;
+    protected readonly logger: Logger;
+    protected readonly errorCollector: PluginErrorCollector;
+    protected init(): void;
+    /**
+     * 加载 output styles
+     * 如果提供了 outputStylePaths 配置，则加载指定路径；否则默认扫描 output-styles 目录
+     * 两种方式的结果会被合并，去重并命名空间化
+     * @param extensionDir 扩展目录路径
+     * @param extensionName 扩展名称（用于命名空间化）
+     * @param outputStylePaths 可选的 output style 路径配置数组，相对于 extensionDir
+     * @returns PluginOutputStyleEntry 数组
+     */
+    load(extensionDir: string, extensionName: string, outputStylePaths?: string[]): Promise<PluginOutputStyleEntry[]>;
+    /**
+     * 从指定的 output style 路径加载
+     * @param extensionDir 扩展目录路径
+     * @param extensionName 扩展名称（用于命名空间化）
+     * @param outputStylePaths output style 路径配置数组
+     * @param loadedPaths 已加载的路径集合，用于去重
+     * @returns PluginOutputStyleEntry 数组
+     */
+    private loadFromPaths;
+    private pathExists;
+    /**
+     * 扫描 output-styles 目录并加载所有 Markdown 文件
+     * @param baseDir 基础目录路径
+     * @param extensionName 扩展名称（用于命名空间化）
+     * @param loadedPaths 已加载的路径集合
+     * @returns PluginOutputStyleEntry 数组
+     */
+    private scanOutputStylesDirectory;
+    /**
+     * 解析单个 output style 文件
+     * @param filePath 文件路径
+     * @param extensionName 扩展名称（用于命名空间化）
+     * @param styleName 可选的样式名称（来自目录或文件名）
+     * @returns PluginOutputStyleEntry | undefined
+     */
+    private parseOutputStyleFile;
+}