@tencent-ai/agent-sdk 0.3.252 → 0.3.253

package/cli/dist-server/types/node/plugins/marketplaces/git-fallback-coordinator.d.ts

@@ -1,42 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { MarketplaceSource } from '../plugin-protocol';
-import { GitAvailabilityDetector } from './git-availability-detector';
-import { GitToZipUrlConverter } from './git-to-zip-url-converter';
-/**
- * Facade that decides whether a Git/Github marketplace source should be
- * silently rewritten to a Zip source because the local `git` executable is
- * not available.
- *
- * The rewrite is intentionally applied as early as possible in
- * {@link PluginManagerImpl.addMarketplace} — before the marketplace info is
- * persisted to disk — so that the on-disk state reflects the actual install
- * method. This keeps subsequent `updateMarketplace`, autoUpdate and startup
- * load paths on the Zip code path without requiring any per-path patches.
- *
- * See `apps/workbuddy-desktop/docs/refactor/marketplace/09-git-to-zip-fallback-design.md`
- * for the full design.
- */
-export declare class GitFallbackCoordinator {
-    protected readonly logger: Logger;
-    protected readonly detector: GitAvailabilityDetector;
-    protected readonly converter: GitToZipUrlConverter;
-    /**
-     * When the input is a Git/Github source and the local git is unavailable,
-     * return a new Zip source targeting the platform's archive URL. Otherwise
-     * return the input unchanged.
-     *
-     * Warnings are emitted (but no error is thrown) when git is unavailable
-     * but no conversion is possible; the original source is returned so the
-     * subsequent Git install can surface its native error message to the user.
-     *
-     * @param src Source produced by {@link PluginManagerImpl.parseSource}.
-     * @param displayName Optional marketplace name used only for logging.
-     */
-    maybeFallback(src: MarketplaceSource, displayName?: string): Promise<MarketplaceSource>;
-    /**
-     * Extract a usable reference string from a Git/Github source. Prefers
-     * the most explicit form (`url`) and falls back through `path` and
-     * `repo` shorthand.
-     */
-    private extractUrl;
-}

package/cli/dist-server/types/node/plugins/marketplaces/git-to-zip-url-converter.d.ts

@@ -1,50 +0,0 @@
-/**
- * A single platform's rule for translating a Git repository URL to a ZIP
- * download URL. Rules are matched by hostname and applied in registration
- * order (newest first, see {@link GitToZipUrlConverter.registerRule}).
- */
-export interface GitPlatformRule {
-    /** Human-readable rule identifier, used in logs and tests. */
-    readonly name: string;
-    /** Return true when this rule applies to the given lower-cased hostname. */
-    match(hostname: string): boolean;
-    /**
-     * Build the ZIP download URL.
-     *
-     * @param host Host with optional port, as returned by `URL#host`.
-     * @param pathname Repository pathname with leading `/` and no trailing `/`.
-     */
-    convert(host: string, pathname: string): string;
-}
-/**
- * Converts Git-style references (http(s) URLs, SSH URLs, or `owner/repo`
- * shorthand) into archive download URLs understood by {@link ZipMarketplace}.
- *
- * Rule set is intentionally aligned with the reference table in
- * `packages/agent-craft/src/common/plugin/plugin-manager.ts` so the two
- * implementations stay behaviour-compatible.
- *
- * The converter does not know whether git is available; that decision is
- * made by {@link GitFallbackCoordinator}.
- */
-export declare class GitToZipUrlConverter {
-    private readonly rules;
-    /**
-     * Register an additional rule. Newer rules take precedence over built-ins
-     * so callers can override default behaviour for a specific host.
-     */
-    registerRule(rule: GitPlatformRule): void;
-    /**
-     * Convert a Git reference to a ZIP archive URL.
-     *
-     * Accepts:
-     * - `https://host/owner/repo` / `https://host/owner/repo.git`
-     * - `git@host:owner/repo(.git)?`
-     * - `owner/repo` shorthand (assumed to be GitHub)
-     *
-     * Returns `undefined` when the host is not recognised or the input is
-     * not parseable as any of the accepted forms.
-     */
-    convert(input: string): string | undefined;
-    private normaliseToHttpUrl;
-}

package/cli/dist-server/types/node/plugins/marketplaces/github-marketplace.d.ts

@@ -1,41 +0,0 @@
-import { ProgressCallback } from '../plugin-protocol';
-import { DirectoryMarketplace } from './directory-marketplace';
-/**
- * GitHub类型的市场实现类
- */
-export declare class GithubMarketplace extends DirectoryMarketplace {
-    /**
-     * 安装或更新GitHub仓库到本地
-     */
-    install(onProgress?: ProgressCallback): Promise<void>;
-    /**
-     * clone 完成后根据 marketplace.json 里的 name rename 目录。
-     *
-     * 不复用 HttpMarketplace 的 tempLocation 预建方式：Git marketplace 的 manifest
-     * 是随 clone 一并下来的，install 开始时读不到 —— 因此只能在 update() 之后回头调整。
-     *
-     * rename 失败不抛异常：clone 已成功，稳住旧目录名仍可继续工作，由上层的
-     * known_marketplaces.json 记录 installLocation 做后续定位。
-     * 不安全的 manifest.name（路径穿越）忽略，同样保留 slug 目录 (#71947)。
-     */
-    private renameToManifestName;
-    /**
-     * 读取 installLocation 下的 marketplace.json 获取 name 字段
-     * 遍历所有支持的 metadata 目录（.codebuddy-plugin / .claude-plugin）
-     */
-    private readManifestName;
-    private readMarketplaceManifest;
-    update(onProgress?: ProgressCallback): Promise<boolean>;
-    private readRepoState;
-    /**
-     * 克隆Git仓库
-     * clone 失败时清理残留目录，避免后续 update 误判为已有仓库
-     */
-    private cloneRepo;
-    private swapDirectoryFromStaging;
-    /**
-     * 获取Git URL
-     * 从source中提取Git仓库地址
-     */
-    private getGitUrl;
-}

package/cli/dist-server/types/node/plugins/marketplaces/http-marketplace.d.ts

@@ -1,47 +0,0 @@
-import { ProgressCallback } from '../plugin-protocol';
-import { DirectoryMarketplace } from './directory-marketplace';
-/**
- * HTTP类型的市场实现类
- */
-export declare class HttpMarketplace extends DirectoryMarketplace {
-    /** 上次成功命中的远端元数据目录，用于后续插件探测时优先尝试 */
-    private detectedMetaDir?;
-    /**
-     * 安装或更新HTTP市场到本地
-     * HTTP市场需要下载marketplace.json和所有插件的plugin.json到本地缓存
-     */
-    install(onProgress?: ProgressCallback): Promise<void>;
-    /**
-     * 更新HTTP市场
-     * 重新下载marketplace.json和插件信息
-     */
-    update(onProgress?: ProgressCallback): Promise<boolean>;
-    /**
-     * 获取marketplace.json内容
-     */
-    private fetchManifest;
-    /**
-     * 下载marketplace.json到本地
-     */
-    private downloadManifest;
-    private downloadPluginManifest;
-    private fetchJson;
-    /** Compare complete metadata snapshots so a successful no-op refresh stays idempotent. */
-    private haveSameSnapshot;
-    private readSnapshotFiles;
-    /**
-     * 根据URL生成临时名称（用于初始下载）
-     */
-    private generateNameFromUrl;
-    /**
-     * 获取HTTP URL
-     * 从source中提取HTTP地址，source.url实际指向marketplace.json
-     */
-    private getHttpUrl;
-    /**
-     * 构建完整URL
-     */
-    private buildUrl;
-    private swapDirectoryFromStaging;
-    private safeRemove;
-}

package/cli/dist-server/types/node/plugins/marketplaces/index.d.ts

@@ -1,13 +0,0 @@
-export * from './base-marketplace';
-export * from './directory-marketplace';
-export * from './github-marketplace';
-export * from './http-marketplace';
-export * from './zip-marketplace';
-export * from './marketplace-factory';
-export * from './marketplace-storage';
-export * from './marketplace-config-manager';
-export * from './marketplace-update-checker';
-export * from './builtin-marketplace-provider';
-export * from './git-availability-detector';
-export * from './git-to-zip-url-converter';
-export * from './git-fallback-coordinator';

package/cli/dist-server/types/node/plugins/marketplaces/marketplace-config-manager.d.ts

@@ -1,39 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { SettingsManager } from '../../settings';
-import { CliSettingSourcesProvider } from '../../settings/cli-setting-sources-provider';
-import { MarketplaceConfigManager, MarketplaceSource, MarketplaceStorage, MarketplaceToInstall } from '../plugin-protocol';
-/**
- * 市场配置管理器
- * 负责从 settings 中读取 extraKnownMarketplaces 配置,
- * 并识别需要安装的市场
- */
-export declare class MarketplaceConfigManagerImpl implements MarketplaceConfigManager {
-    protected readonly logger: Logger;
-    protected readonly settingsManager: SettingsManager;
-    protected readonly cliSettingSourcesProvider: CliSettingSourcesProvider;
-    protected readonly marketplaceStorage: MarketplaceStorage;
-    protected init(): void;
-    /**
-     * 获取所有配置的市场(按 user → project → local → CLI 顺序合并，后者覆盖前者)
-     *
-     * 各 scope 受 `--setting-sources` 约束(isScopeAllowed：文件系统 scope 需在
-     * sources 里，CLI 来自 `--settings` 显式注入、恒允许)，避免 SDK/隔离环境
-     * 仍被本机 settings 注入市场。
-     */
-    getConfiguredMarketplaces(options?: {
-        includeSession?: boolean;
-    }): Promise<Map<string, MarketplaceSource>>;
-    private getConfiguredMarketplaceDeclarations;
-    /**
-     * 获取需要安装的市场列表
-     */
-    getMarketplacesToInstall(): Promise<MarketplaceToInstall[]>;
-    /**
-     * 合并市场配置到 Map 中
-     */
-    private mergeMarketplaceConfig;
-    /**
-     * 验证市场源配置的有效性
-     */
-    private validateMarketplaceSource;
-}

package/cli/dist-server/types/node/plugins/marketplaces/marketplace-factory.d.ts

@@ -1,11 +0,0 @@
-import { Marketplace, MarketplaceInfo } from '../plugin-protocol';
-/**
- * Marketplace工厂类
- * 根据source类型创建不同的Marketplace实例
- */
-export declare class MarketplaceFactory {
-    /**
-     * 从JSON对象创建对应类型的Marketplace实例
-     */
-    static createFromJSON(marketplaceInfo: MarketplaceInfo): Marketplace;
-}

package/cli/dist-server/types/node/plugins/marketplaces/marketplace-storage.d.ts

@@ -1,141 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { FileLockService } from '../../lock';
-import { MarketplaceInfo, MarketplaceStorage, PluginErrorCollector } from '../plugin-protocol';
-/**
- * 市场存储实现
- * 负责管理市场配置的持久化
- *
- * 并发与原子性保证：
- * 1. 进程内：`writeLock` Promise 链串行化 read-modify-write，避免同一进程内的 lost-update。
- * 2. 跨进程：`FileLockService` 互斥锁，防止多 CLI/Gateway/Desktop 实例同时写同一份 JSON 导致字节级交错。
- * 3. 原子写：`tempFile + rename`，即便锁意外失效，读者也只会看到旧版本或新版本，绝不会看到半成品。
- * 4. 自愈：读到无法解析的 JSON 时只在同一写锁内复查、备份为 `.broken-<ts>`，
- *    再由真实 mutation 重建；只读路径绝不创建/覆盖 registry。
- */
-export declare class MarketplaceStorageImpl implements MarketplaceStorage {
-    protected readonly logger: Logger;
-    protected readonly errorCollector: PluginErrorCollector;
-    protected readonly fileLockService: FileLockService;
-    /** 市场配置文件路径 */
-    private readonly configFilePath;
-    /** 当前配置目录检查的 single-flight；完成后释放以支持外部删除后的自愈。 */
-    private configFileInitPromise?;
-    /** 序列化写操作，防止并发 read-modify-write 丢失更新（进程内） */
-    private writeLock;
-    constructor();
-    protected init(): void;
-    /**
-     * 进程内写锁：确保同一进程内的写操作串行执行。
-     */
-    private withWriteLock;
-    /**
-     * 跨进程文件锁：确保多进程间的写操作互斥。
-     * 获取失败时必须终止写入。仅进程内锁无法阻止另一个 CLI 基于旧快照
-     * 覆盖 known_marketplaces.json，原子 rename 只能防半文件，不能防 lost-update。
-     */
-    private withFileLock;
-    /**
-     * 同时获取进程内锁与跨进程锁。
-     */
-    private withLocks;
-    private sanitizeLockName;
-    /** Ensure only the parent directory. Readers must never create registry data. */
-    private ensureConfigFileAsync;
-    /**
-     * 实际执行配置文件初始化
-     */
-    private doEnsureConfigFile;
-    /**
-     * Read the registry without mutating it. A caller that already holds the
-     * storage write lock may opt into corruption repair; only that path backs
-     * up the broken snapshot and returns an empty object for the subsequent
-     * atomic write. Unlocked readers surface a typed error so they cannot race
-     * a healthy writer with a repair rename.
-     */
-    private readAndRepair;
-    private getPublishingMarketplaceNames;
-    private sameStringSet;
-    /**
-     * Journal/registry seqlock for unlocked readers. The marketplace-name lock
-     * remains the authoritative boundary for mutable-source copying, but this
-     * prevents list/browse callers from constructing a Marketplace from the
-     * obvious stable-swap window.
-     */
-    private readConsistentMarketplaceSnapshot;
-    /**
-     * Older WorkBuddy builds registered a generated marketplace root inside
-     * `plugins/cache`. Keep detecting those records for compatibility, but
-     * never move cache contents into `plugins/marketplaces`.
-     *
-     * Claude keeps these trees independent:
-     * - marketplaces/<marketplace> is the mutable source checkout
-     * - cache/<marketplace>/<plugin>/<version> is an immutable install snapshot
-     */
-    private hasRepairableLegacyMarketplaceCacheReferences;
-    private getCanonicalMarketplaceLocation;
-    /**
-     * Repair only the storage reference when a real canonical marketplace
-     * source already exists. Cache-only legacy records are intentionally left
-     * untouched: moving them would turn installed snapshots into a marketplace
-     * source and destroy the cache/source boundary.
-     */
-    private repairLegacyMarketplaceCacheReferences;
-    private isMarketplaceRoot;
-    /**
-     * 原子写：写入临时文件后 rename 到目标路径。
-     * 同一文件系统内 rename 是原子操作，读者要么看到旧文件要么看到新文件，
-     * 绝不会看到"被截断后正在写入"的半成品。
-     */
-    private atomicWriteJson;
-    /**
-     * 生成与 pid/时间戳/随机串绑定的临时文件名，避免多进程冲突。
-     * 抽成实例方法以便测试替换。
-     */
-    protected generateTempPath(): string;
-    /**
-     * 底层写入临时文件。抽成实例方法以便测试替换而不污染 `fs-extra` 模块属性。
-     */
-    protected writeTempFile(tempPath: string, content: string): Promise<void>;
-    /**
-     * 底层原子 rename，带 Windows EPERM/EBUSY/EACCES 重试。抽成实例方法以便测试替换。
-     *
-     * 背景：Windows 上 `rename` 覆盖已存在的目标文件需要对目标持有 DELETE 权限。
-     * 当杀软 / 索引器 / 并发的无锁读取者（getMarketplaces → readAndRepair 读取
-     * known_marketplaces.json 时不加锁）持有目标文件的句柄且未带 FILE_SHARE_DELETE 时，
-     * 替换式 rename 会抛 `EPERM: operation not permitted, rename ...`，进而冒泡成
-     * 删除市场 HTTP 500。这类占用几乎都是瞬时的（占用方几十毫秒内即释放），
-     * 因此做短退避重试即可扛住，而不改变 temp+rename 的原子写语义。
-     *
-     * 注意：刻意不做 copyFile 兜底——copyFile 非原子，会让读取者看到半成品。
-     * 保持纯 rename
-     * 重试，既消除该风险，又覆盖现实中绝大多数瞬时 EPERM。重试耗尽仍失败时
-     * 抛出原始 rename 错误，保留诊断信息。
-     */
-    protected renameTempFile(tempPath: string, targetPath: string): Promise<void>;
-    /**
-     * 底层 fs.rename。抽成实例方法以便测试注入失败（fs-extra 的导出方法不可 stub）。
-     */
-    protected rawRename(tempPath: string, targetPath: string): Promise<void>;
-    /**
-     * 底层清理临时文件（best-effort）。抽成实例方法以便测试替换与断言。
-     */
-    protected removeTempFile(tempPath: string): Promise<void>;
-    /**
-     * 获取所有市场配置
-     */
-    getMarketplaces(options?: {
-        includePublishing?: boolean;
-    }): Promise<MarketplaceInfo[]>;
-    /**
-     * 保存市场配置
-     */
-    saveMarketplace(marketplace: MarketplaceInfo): Promise<void>;
-    /**
-     * 删除市场配置
-     */
-    removeMarketplace(name: string): Promise<void>;
-    /**
-     * 检查市场是否已安装
-     */
-    isMarketplaceInstalled(name: string): Promise<boolean>;
-}

package/cli/dist-server/types/node/plugins/marketplaces/marketplace-update-checker.d.ts

@@ -1,38 +0,0 @@
-import { ProductManager } from '@genie/product';
-import { Logger } from '@genie/telemetry';
-import { MarketplaceNeedsUpdateResult, MarketplaceUpdateChecker } from '../plugin-protocol';
-/**
- * Default implementation of {@link MarketplaceUpdateChecker}.
- *
- * Check order (first decisive signal wins):
- *   1. mtime throttle — if the version file was touched recently, skip remote calls
- *   2. versionUrl (Product metadata) — fetch a small remote version token
- *   3. urlVersion (由调用方从 zipUrl 解析得到) — 本地版本号字符串比对，
- *      不发起任何 HTTP；所有调度方共用 `parseVersionFromUrl`，避免两层更新
- *      判据不一致。
- *   4. ETag / Last-Modified (HEAD on the zip URL) — 兜底路径，覆盖用户自定义市场
- *      及 url 不带 UUID 段的内置市场。
- *
- * This service is a Singleton so its throttle map lives across marketplace transient instances.
- */
-export declare class MarketplaceUpdateCheckerImpl implements MarketplaceUpdateChecker {
-    protected readonly logger: Logger;
-    protected readonly productManager: ProductManager;
-    protected init(): void;
-    needsUpdate(args: {
-        marketplaceName: string;
-        installLocation: string;
-        zipUrl: string;
-        versionUrl?: string;
-        urlVersion?: string;
-    }): Promise<MarketplaceNeedsUpdateResult>;
-    commitVersion(marketplaceName: string, installLocation: string, version: string): Promise<void>;
-    invalidateCache(marketplaceName: string, installLocation: string): Promise<void>;
-    protected fetchRemoteVersion(versionUrl: string): Promise<string>;
-    private isRecentlyChecked;
-    private touchVersionFile;
-    private readCachedVersion;
-    private hasZipMetadata;
-    private classifyHttpCheck;
-    private getCheckIntervalMs;
-}

package/cli/dist-server/types/node/plugins/marketplaces/workspace-project-root.d.ts

@@ -1,14 +0,0 @@
-export interface WorkspaceProjectIdentity {
-    kind: 'directory' | 'git';
-    path: string;
-}
-/**
- * Resolve Claude-compatible project identity for Plugin installation records.
- * Git worktrees use their canonical common/main repository root, while a
- * directory outside Git keeps its canonical requested path. Missing trailing
- * path components are preserved lexically after resolving the nearest existing
- * ancestor so historical registry records remain comparable.
- */
-export declare function resolveWorkspaceProjectIdentity(workspacePath: string, options?: {
-    preserveNonGitPath?: boolean;
-}): Promise<WorkspaceProjectIdentity>;

package/cli/dist-server/types/node/plugins/marketplaces/zip-marketplace.d.ts

@@ -1,134 +0,0 @@
-import { MarketplaceUpdatePreparation, ProgressCallback } from '../plugin-protocol';
-import { DirectoryMarketplace } from './directory-marketplace';
-/**
- * Marketplace source served as a ZIP / TGZ / TAR.GZ archive.
- *
- * Install flow:
- *   1. Download (or copy for local paths) the archive into an OS temp directory
- *   2. Extract into the same OS temp directory
- *   3. Read `marketplace.json` to determine the final marketplace name
- *   4. Atomically move the temp directory to `~/.codebuddy/plugins/marketplaces/<name>`
- *   5. Persist HTTP caching metadata (`.zip-metadata.json`) for future freshness checks
- *
- * Update flow mirrors install but preserves the existing installation until the
- * new extraction succeeds, so a failed update never corrupts a working copy.
- */
-export declare class ZipMarketplace extends DirectoryMarketplace {
-    /** ZIP archives are complete snapshots; copying the live tree is wasted IO. */
-    get updateStagingMode(): 'empty';
-    install(onProgress?: ProgressCallback): Promise<void>;
-    checkForUpdate(onProgress?: ProgressCallback): Promise<MarketplaceUpdatePreparation>;
-    update(onProgress?: ProgressCallback, preparation?: MarketplaceUpdatePreparation): Promise<boolean>;
-    /**
-     * 当前 marketplace 是否为内置市场。
-     * 仅在需要走 url-version 分支时判别，避免动到非内置市场的原有路径。
-     */
-    private getBuiltInVersionMetadata;
-    /**
-     * 首装成功后记录 Product versionUrl 或 ZIP URL 中的版本。只写入检查器
-     * 已确认的 token；失败时保留完整安装并让下次后台刷新重试。
-     */
-    private seedVersionCache;
-    /**
-     * Try `downloadFile(url)`; on HTTP 404, attempt the alternate branch name
-     * (main ↔ master) exactly once. Throws the original error if no fallback
-     * applies or the fallback also fails.
-     */
-    private downloadWithBranchFallback;
-    /**
-     * Look for `marketplace.json` at the extraction root or inside the known
-     * metadata directories (e.g. `.codebuddy-plugin/`, `.claude-plugin/`).
-     */
-    private readManifestFromDir;
-    /** Same lookup as `readManifestFromDir`, but keeps the path so callers can rewrite it. */
-    private readManifestEntryFromDir;
-    /**
-     * Every manifest copy that exists in the tree, in lookup order.
-     *
-     * Archives sometimes ship the manifest twice — at the extraction root and
-     * inside a metadata directory — so that clients with different conventions
-     * both find one. Readers disagree about which copy wins: this class checks
-     * the root first, while `loadManifest` and `isMarketplaceMaterialized` only
-     * ever look inside the metadata directories. Anything that rewrites a
-     * manifest must therefore rewrite all of them.
-     */
-    private listManifestPaths;
-    /**
-     * Accept a freshly extracted archive as this marketplace's next snapshot.
-     *
-     * A published archive that declares a local plugin it does not ship is the
-     * publisher's mistake, not a half-written local extraction: every retry
-     * downloads the same incomplete bytes, so rejecting it strands the whole
-     * marketplace — the remaining plugins become uninstallable and the
-     * registry can never move to the declared source. Drop the unshipped
-     * entries instead and keep the rest usable.
-     *
-     * Every manifest copy in the staged tree is pruned before it is published,
-     * so the snapshot we install is internally consistent. Otherwise
-     * `checkForUpdate`, which validates the installed snapshot strictly, would
-     * rediscover the gap on every pass and re-download the same archive
-     * forever, and a stale copy would keep `isMarketplaceMaterialized`
-     * answering "not installed" for a marketplace that is in fact installed.
-     *
-     * Two conditions still reject the archive: entries that resolve outside
-     * the archive or are not directories (integrity violations, #71947), and
-     * archives missing more than the caps above allow.
-     */
-    private adoptDownloadedSnapshot;
-    /** Drop entries pointing at `missingPaths` from one manifest copy on disk. */
-    private pruneManifestFile;
-    /** Whether a manifest entry points at one of the directories the archive omitted. */
-    private declaresMissingPath;
-    private assertValidManifest;
-    /** Narrowing wrapper for callers that also need the manifest's path. */
-    private assertValidManifestEntry;
-    /**
-     * Strict check for an already installed snapshot.
-     *
-     * Freshness metadata describes the whole extracted source snapshot, not
-     * only marketplace.json. A process killed after publishing that manifest
-     * but before every local plugin directory exists must not make the next
-     * update return "current" forever. A local gap is always recoverable by
-     * re-downloading, so nothing here is tolerated — unlike a freshly
-     * downloaded archive, where `adoptDownloadedSnapshot` decides.
-     */
-    private assertCompleteSnapshot;
-    /**
-     * Walk the manifest's local plugin entries against the tree on disk.
-     *
-     * Absent directories are reported to the caller, which decides whether
-     * they are tolerable. Entries that escape the archive root or are not
-     * directories always throw: they are integrity violations rather than
-     * missing content, and no caller may accept them.
-     */
-    private inspectLocalPlugins;
-    /** Extract the archive URL from the marketplace source config. */
-    private getZipUrl;
-    /**
-     * Derive a stable, filesystem-safe base name from a URL or local path.
-     * Used as the temp directory prefix until the real name is read from the manifest.
-     */
-    private generateNameFromUrl;
-    private slugify;
-    private createTempRoot;
-    private swapDirectoryFromTemp;
-    private renameDirectory;
-    /** Remove a path if it exists, silently ignoring any failure. */
-    private safeRemove;
-    /**
-     * Sweep orphan transient artefacts from `marketplacesRoot`.
-     *
-     * An artefact is considered orphan when:
-     *   1. Its name matches `<...>.<13-digit-ts>-<6-char-suffix>(.zip|.tmp)?` —
-     *      i.e. the unique-suffix naming this class uses for downloads/extract dirs.
-     *   2. The embedded timestamp is older than ORPHAN_ARTIFACT_MIN_AGE_MS, so we
-     *      never touch temp files belonging to a concurrent install/update.
-     *
-     * Real marketplace install dirs (e.g. `cb_teams_marketplace`) never carry
-     * the timestamp+random suffix, so they cannot match the pattern.
-     *
-     * Best-effort: any failure here must not affect the caller's install/update
-     * result, which has already succeeded by the time we run.
-     */
-    private cleanupOrphanArtifacts;
-}

package/cli/dist-server/types/node/plugins/mcpb-handler.d.ts

@@ -1,29 +0,0 @@
-import { McpConfig } from '../mcp';
-import { McpBundleEntry, McpBundleLoadResult } from './plugin-protocol';
-/**
- * 判断源字符串是否为 MCPB 文件引用
- */
-export declare function isMcpbSource(source: string): boolean;
-/**
- * 加载 MCP Bundle 文件
- *
- * 流程：
- * 1. 检查缓存
- * 2. 下载或读取本地文件
- * 3. 校验 checksum
- * 4. 解压 ZIP
- * 5. 解析 manifest.json
- * 6. 生成 MCP 服务器配置
- * 7. 保存缓存元数据
- */
-export declare function loadMcpBundle(bundle: McpBundleEntry, pluginPath: string, pluginId: string, onProgress?: (status: string) => void): Promise<McpBundleLoadResult>;
-/**
- * 批量加载 MCP Bundles
- */
-export declare function loadMcpBundles(bundles: McpBundleEntry[], pluginPath: string, pluginId: string, onProgress?: (status: string) => void): Promise<{
-    configs: Record<string, McpConfig>;
-    errors: Array<{
-        bundle: McpBundleEntry;
-        error: Error;
-    }>;
-}>;