aws-runtime-bridge 1.0.0

package/package/cc-switch-sdk/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class SdkError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(code: string, message: string, details?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/package/cc-switch-sdk/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEtB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAM7D"}

package/package/cc-switch-sdk/dist/errors.js

@@ -0,0 +1,8 @@
+export class SdkError extends Error {
+    constructor(code, message, details) {
+        super(message);
+        this.name = "SdkError";
+        this.code = code;
+        this.details = details;
+    }
+}

package/package/cc-switch-sdk/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @cc-switch/sdk - 纯配置管理 SDK
+ *
+ * 负责 MCP/Skill 的 CRUD 操作和状态管理。
+ * 注意：adapters 需要外部注入，SDK 不提供默认实现。
+ */
+import type { AppId, AppFlags, McpServer, McpServerSpec, InstalledSkill, SkillSyncMethod, SdkOptions, SdkPaths, SdkState, IMcpAdapter, ISkillAdapter, AdapterOverrides } from "./types.js";
+import { CcSwitchSdk } from "./sdk.js";
+import { AiConfigService, buildToolSpecificAiConfig, type AiConfigTemplate, type ClaudeCodeConfig, type CodexConfig, type OpenCodeConfig, type AiConfigPaths } from "./services/ai-config-service.js";
+export { CcSwitchSdk, AiConfigService, buildToolSpecificAiConfig, type AppId, type AppFlags, type McpServer, type McpServerSpec, type InstalledSkill, type SkillSyncMethod, type SdkOptions, type SdkPaths, type SdkState, type IMcpAdapter, type ISkillAdapter, type AdapterOverrides, type AiConfigTemplate, type ClaudeCodeConfig, type CodexConfig, type OpenCodeConfig, type AiConfigPaths, };
+//# sourceMappingURL=index.d.ts.map

package/package/cc-switch-sdk/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,EACd,eAAe,EACf,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,WAAW,EACX,eAAe,EACf,yBAAyB,EAEzB,KAAK,KAAK,EACV,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,QAAQ,EAEb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAErB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,CAAC"}

package/package/cc-switch-sdk/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @cc-switch/sdk - 纯配置管理 SDK
+ *
+ * 负责 MCP/Skill 的 CRUD 操作和状态管理。
+ * 注意：adapters 需要外部注入，SDK 不提供默认实现。
+ */
+import { CcSwitchSdk } from "./sdk.js";
+import { AiConfigService, buildToolSpecificAiConfig, } from "./services/ai-config-service.js";
+export { CcSwitchSdk, AiConfigService, buildToolSpecificAiConfig, };

package/package/cc-switch-sdk/dist/schemas.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import type { AppFlags, InstalledSkill, McpServer, McpServerSpec, SdkState } from "./types.js";
+export declare const appFlagsSchema: z.ZodType<AppFlags>;
+export declare const mcpServerSpecSchema: z.ZodType<McpServerSpec>;
+export declare const mcpServerSchema: z.ZodType<McpServer>;
+export declare const installedSkillSchema: z.ZodType<InstalledSkill>;
+export declare const sdkStateSchema: z.ZodType<SdkState>;
+//# sourceMappingURL=schemas.d.ts.map

package/package/cc-switch-sdk/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EACT,aAAa,EACb,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAO7C,CAAC;AAEH,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAQ3B,CAAC;AAE/B,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAMvB,CAAC;AAE3B,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAO5B,CAAC;AAEhC,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAGtB,CAAC"}

package/package/cc-switch-sdk/dist/schemas.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export const appFlagsSchema = z.object({
+    claude: z.boolean(),
+    claudecode: z.boolean(),
+    codex: z.boolean(),
+    gemini: z.boolean(),
+    opencode: z.boolean(),
+    openclaw: z.boolean(),
+});
+export const mcpServerSpecSchema = z.object({
+    type: z.enum(["stdio", "sse", "http"]).optional(),
+    command: z.string().optional(),
+    args: z.array(z.string()).optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    cwd: z.string().optional(),
+    url: z.string().optional(),
+    headers: z.record(z.string(), z.string()).optional(),
+});
+export const mcpServerSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    server: mcpServerSpecSchema,
+    description: z.string().optional(),
+    apps: appFlagsSchema,
+});
+export const installedSkillSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    directory: z.string(),
+    description: z.string().optional(),
+    apps: appFlagsSchema,
+    installedAt: z.number(),
+});
+export const sdkStateSchema = z.object({
+    mcpServers: z.record(z.string(), mcpServerSchema),
+    skills: z.record(z.string(), installedSkillSchema),
+});

package/package/cc-switch-sdk/dist/sdk.d.ts

@@ -0,0 +1,91 @@
+import type { AppId, InstalledSkill, McpServer, SdkOptions, SdkPaths } from "./types.js";
+import type { CreateMcpInput, UpdateMcpInput } from "./services/mcp-model.js";
+import type { CreateSkillInput, UpdateSkillInput } from "./services/skill-model.js";
+export declare class CcSwitchSdk {
+    private readonly paths;
+    private readonly skillSyncMethod;
+    private readonly mcpAdapters;
+    private readonly skillAdapters;
+    private state;
+    private operationQueue;
+    /**
+     * 创建 CcSwitchSdk 实例
+     *
+     * 注意：adapters 必须通过 options.adapters 注入，
+     * cc-switch-sdk 不再提供默认的 adapter 实现。
+     *
+     * @param options - SDK 配置选项
+     * @param options.adapters.mcp - MCP 适配器映射（必需）
+     * @param options.adapters.skill - Skill 适配器映射（必需）
+     */
+    constructor(options: SdkOptions);
+    private executeExclusive;
+    load(): Promise<void>;
+    save(): Promise<void>;
+    private getAiConfigPath;
+    private getAiBackupPath;
+    private backupAiConfigIfNeeded;
+    private backupBeforeMcpSyncByApps;
+    private backupBeforeMcpSync;
+    backupAiConfigs(appIds?: AppId[]): Promise<void>;
+    restoreAiConfig(appId: AppId): Promise<boolean>;
+    restoreAiConfigs(appIds?: AppId[]): Promise<Record<string, boolean>>;
+    getAllMcpServers(): McpServer[];
+    getMcpServerById(id: string): McpServer | undefined;
+    createMcpServer(input: CreateMcpInput): Promise<McpServer>;
+    updateMcpServer(id: string, patch: UpdateMcpInput): Promise<McpServer>;
+    deleteMcpServer(id: string): Promise<void>;
+    toggleMcpApp(serverId: string, appId: AppId, enabled: boolean): Promise<McpServer>;
+    importMcpFromApps(): Promise<number>;
+    /**
+     * 从单个应用导入 MCP 服务器
+     */
+    private importMcpFromApp;
+    /**
+     * 处理导入的 MCP 服务器（合并或创建）
+     * @returns 是否为新创建的 MCP
+     */
+    private processImportedMcp;
+    /**
+     * 根据名称查找 MCP 服务器
+     */
+    private findMcpServerByName;
+    /**
+     * 创建带有应用标记的 MCP 服务器
+     */
+    private createMcpWithAppFlag;
+    getAllSkills(): InstalledSkill[];
+    getSkillById(id: string): InstalledSkill | undefined;
+    installSkill(input: CreateSkillInput): Promise<InstalledSkill>;
+    updateSkill(id: string, patch: UpdateSkillInput): Promise<InstalledSkill>;
+    uninstallSkill(id: string): Promise<void>;
+    toggleSkillApp(skillId: string, appId: AppId, enabled: boolean): Promise<InstalledSkill>;
+    importSkillsFromApps(): Promise<number>;
+    /**
+     * 从单个应用导入 Skills
+     */
+    private importSkillsFromApp;
+    /**
+     * 处理导入的 Skill（合并或创建）
+     * @returns 是否为新创建的 Skill
+     */
+    private processImportedSkill;
+    /**
+     * 根据名称查找 Skill
+     */
+    private findSkillByName;
+    /**
+     * 合并已存在的 Skill
+     */
+    private mergeExistingSkill;
+    /**
+     * 创建新导入的 Skill
+     */
+    private createNewImportedSkill;
+    /**
+     * 创建带有应用标记的 Skill
+     */
+    private createSkillWithAppFlag;
+    getPaths(): SdkPaths;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/package/cc-switch-sdk/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,KAAK,EAEL,cAAc,EAEd,SAAS,EACT,UAAU,EACV,QAAQ,EAGT,MAAM,YAAY,CAAC;AAQpB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQ9E,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AA2BnC,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAC7D,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,cAAc,CAAoC;IAE1D;;;;;;;;;OASG;gBACS,OAAO,EAAE,UAAU;YAiBjB,gBAAgB;IAexB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,eAAe;YAKT,sBAAsB;YAgBtB,yBAAyB;YAWzB,mBAAmB;IAI3B,eAAe,CAAC,MAAM,GAAE,KAAK,EAAwC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrF,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAe/C,gBAAgB,CAAC,MAAM,GAAE,KAAK,EAAwC,GAAG,OAAO,CACpF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACxB;IAQD,gBAAgB,IAAI,SAAS,EAAE;IAI/B,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7C,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAW1D,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAetE,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB1C,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,SAAS,CAAC;IAiBf,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAc1C;;OAEG;YACW,gBAAgB;IAc9B;;;OAGG;YACW,kBAAkB;IAgBhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B,YAAY,IAAI,cAAc,EAAE;IAIhC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI9C,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAmB9D,WAAW,CACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,cAAc,CAAC;IAoBpB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCzC,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,cAAc,CAAC;IAsBpB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAc7C;;OAEG;YACW,mBAAmB;IAcjC;;;OAGG;YACW,oBAAoB;IAelC;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;YACW,kBAAkB;IAUhC;;OAEG;YACW,sBAAsB;IAWpC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuB9B,QAAQ,IAAI,QAAQ;CAGrB"}

package/package/cc-switch-sdk/dist/sdk.js

@@ -0,0 +1,427 @@
+import path from "node:path";
+import { resolvePaths } from "./constants.js";
+import { loadState, saveState } from "./state.js";
+import { buildMcpFromInput, mergeMcp, applyMcpAppFlag, } from "./services/mcp-model.js";
+import { syncMcpServerToApps } from "./services/mcp-service.js";
+import { buildSkillFromInput, mergeSkill, applySkillAppFlag, skillSourceDir, } from "./services/skill-model.js";
+import { syncSkillToApps } from "./services/skill-service.js";
+import { copyDir, copyFile, pathExists, removeIfExists, } from "./utils/fs.js";
+import { SdkError } from "./errors.js";
+/**
+ * 导入时合并 App 标记
+ * 注意：此函数移到 sdk.ts 中，因为它是导入逻辑的一部分
+ */
+function mergeAppFlagOnImport(server, appId) {
+    return {
+        ...server,
+        apps: {
+            ...server.apps,
+            [appId]: true,
+        },
+    };
+}
+export class CcSwitchSdk {
+    /**
+     * 创建 CcSwitchSdk 实例
+     *
+     * 注意：adapters 必须通过 options.adapters 注入，
+     * cc-switch-sdk 不再提供默认的 adapter 实现。
+     *
+     * @param options - SDK 配置选项
+     * @param options.adapters.mcp - MCP 适配器映射（必需）
+     * @param options.adapters.skill - Skill 适配器映射（必需）
+     */
+    constructor(options) {
+        this.state = { mcpServers: {}, skills: {} };
+        this.operationQueue = Promise.resolve();
+        if (!options.adapters?.mcp || !options.adapters?.skill) {
+            throw new SdkError("ADAPTERS_REQUIRED", "Adapters are required. Please provide mcp and skill adapters via options.adapters.", { hasMcp: !!options.adapters?.mcp, hasSkill: !!options.adapters?.skill });
+        }
+        const resolved = resolvePaths(options);
+        this.paths = resolved.paths;
+        this.skillSyncMethod = resolved.skillSyncMethod;
+        this.mcpAdapters = options.adapters.mcp;
+        this.skillAdapters = options.adapters.skill;
+    }
+    async executeExclusive(operation) {
+        const previous = this.operationQueue;
+        let release;
+        this.operationQueue = new Promise((resolve) => {
+            release = resolve;
+        });
+        await previous;
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+        }
+    }
+    async load() {
+        this.state = await loadState(this.paths.stateFile);
+    }
+    async save() {
+        await saveState(this.paths.stateFile, this.state);
+    }
+    getAiConfigPath(appId) {
+        if (appId === "opencode") {
+            return this.paths.opencodeConfigFile;
+        }
+        if (appId === "claudecode") {
+            return this.paths.claudecodeConfigFile;
+        }
+        if (appId === "codex") {
+            return this.paths.codexConfigFile;
+        }
+        return undefined;
+    }
+    getAiBackupPath(appId) {
+        const extension = appId === "codex" ? "toml" : "json";
+        return path.join(this.paths.backupDir, `${appId}.config.backup.${extension}`);
+    }
+    async backupAiConfigIfNeeded(appId) {
+        const configPath = this.getAiConfigPath(appId);
+        if (!configPath) {
+            return;
+        }
+        const backupPath = this.getAiBackupPath(appId);
+        if (await pathExists(backupPath)) {
+            return;
+        }
+        if (await pathExists(configPath)) {
+            await copyFile(configPath, backupPath);
+        }
+    }
+    async backupBeforeMcpSyncByApps(apps) {
+        const targets = ["opencode", "claudecode", "codex"];
+        for (const appId of targets) {
+            if (apps[appId]) {
+                await this.backupAiConfigIfNeeded(appId);
+            }
+        }
+    }
+    async backupBeforeMcpSync(server) {
+        await this.backupBeforeMcpSyncByApps(server.apps);
+    }
+    async backupAiConfigs(appIds = ["opencode", "claudecode", "codex"]) {
+        for (const appId of appIds) {
+            await this.backupAiConfigIfNeeded(appId);
+        }
+    }
+    async restoreAiConfig(appId) {
+        const configPath = this.getAiConfigPath(appId);
+        if (!configPath) {
+            return false;
+        }
+        const backupPath = this.getAiBackupPath(appId);
+        if (!(await pathExists(backupPath))) {
+            return false;
+        }
+        await copyFile(backupPath, configPath);
+        return true;
+    }
+    async restoreAiConfigs(appIds = ["opencode", "claudecode", "codex"]) {
+        const result = {};
+        for (const appId of appIds) {
+            result[appId] = await this.restoreAiConfig(appId);
+        }
+        return result;
+    }
+    getAllMcpServers() {
+        return Object.values(this.state.mcpServers);
+    }
+    getMcpServerById(id) {
+        return this.state.mcpServers[id];
+    }
+    async createMcpServer(input) {
+        return this.executeExclusive(async () => {
+            const server = buildMcpFromInput(input);
+            this.state.mcpServers[server.id] = server;
+            await this.backupBeforeMcpSync(server);
+            await syncMcpServerToApps(server, this.mcpAdapters);
+            await this.save();
+            return server;
+        });
+    }
+    async updateMcpServer(id, patch) {
+        return this.executeExclusive(async () => {
+            const current = this.state.mcpServers[id];
+            if (!current) {
+                throw new SdkError("MCP_NOT_FOUND", `MCP server not found: ${id}`, { id });
+            }
+            const updated = mergeMcp(current, patch);
+            this.state.mcpServers[id] = updated;
+            await this.backupBeforeMcpSync(updated);
+            await syncMcpServerToApps(updated, this.mcpAdapters);
+            await this.save();
+            return updated;
+        });
+    }
+    async deleteMcpServer(id) {
+        return this.executeExclusive(async () => {
+            const server = this.state.mcpServers[id];
+            if (!server) {
+                return;
+            }
+            const disabled = {
+                ...server,
+                apps: {
+                    claude: false,
+                    claudecode: false,
+                    codex: false,
+                    gemini: false,
+                    opencode: false,
+                    openclaw: false,
+                },
+            };
+            await syncMcpServerToApps(disabled, this.mcpAdapters);
+            delete this.state.mcpServers[id];
+            await this.save();
+        });
+    }
+    async toggleMcpApp(serverId, appId, enabled) {
+        return this.executeExclusive(async () => {
+            const current = this.state.mcpServers[serverId];
+            if (!current) {
+                throw new SdkError("MCP_NOT_FOUND", `MCP server not found: ${serverId}`, {
+                    serverId,
+                });
+            }
+            const updated = applyMcpAppFlag(current, appId, enabled);
+            this.state.mcpServers[serverId] = updated;
+            await this.backupBeforeMcpSyncByApps({ [appId]: enabled });
+            await syncMcpServerToApps(updated, this.mcpAdapters);
+            await this.save();
+            return updated;
+        });
+    }
+    async importMcpFromApps() {
+        return this.executeExclusive(async () => {
+            let count = 0;
+            const apps = ["claude", "claudecode", "opencode", "codex", "gemini", "openclaw"];
+            for (const appId of apps) {
+                count += await this.importMcpFromApp(appId);
+            }
+            await this.save();
+            return count;
+        });
+    }
+    /**
+     * 从单个应用导入 MCP 服务器
+     */
+    async importMcpFromApp(appId) {
+        let count = 0;
+        const imported = await this.mcpAdapters[appId].importServers();
+        for (const imp of imported) {
+            const isNew = await this.processImportedMcp(imp, appId);
+            if (isNew) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * 处理导入的 MCP 服务器（合并或创建）
+     * @returns 是否为新创建的 MCP
+     */
+    async processImportedMcp(imp, appId) {
+        const existing = this.findMcpServerByName(imp.name);
+        if (existing) {
+            const merged = mergeAppFlagOnImport(existing, appId);
+            this.state.mcpServers[existing.id] = merged;
+            await syncMcpServerToApps(merged, this.mcpAdapters);
+            return false;
+        }
+        const withFlag = this.createMcpWithAppFlag(imp, appId);
+        this.state.mcpServers[withFlag.id] = withFlag;
+        await syncMcpServerToApps(withFlag, this.mcpAdapters);
+        return true;
+    }
+    /**
+     * 根据名称查找 MCP 服务器
+     */
+    findMcpServerByName(name) {
+        return Object.values(this.state.mcpServers).find((s) => s.name === name);
+    }
+    /**
+     * 创建带有应用标记的 MCP 服务器
+     */
+    createMcpWithAppFlag(imp, appId) {
+        return {
+            ...imp,
+            apps: {
+                claude: false,
+                claudecode: false,
+                codex: false,
+                gemini: false,
+                opencode: false,
+                openclaw: false,
+                [appId]: true,
+            },
+        };
+    }
+    getAllSkills() {
+        return Object.values(this.state.skills);
+    }
+    getSkillById(id) {
+        return this.state.skills[id];
+    }
+    async installSkill(input) {
+        return this.executeExclusive(async () => {
+            const ssotDir = this.paths.ssotSkillsDir;
+            const skill = buildSkillFromInput(input);
+            const targetSource = skillSourceDir(ssotDir, skill);
+            await copyDir(input.sourceDir, targetSource);
+            this.state.skills[skill.id] = skill;
+            await syncSkillToApps(skill, targetSource, this.skillSyncMethod, this.skillAdapters);
+            await this.save();
+            return skill;
+        });
+    }
+    async updateSkill(id, patch) {
+        return this.executeExclusive(async () => {
+            const current = this.state.skills[id];
+            if (!current) {
+                throw new SdkError("SKILL_NOT_FOUND", `Skill not found: ${id}`, { id });
+            }
+            const updated = mergeSkill(current, patch);
+            this.state.skills[id] = updated;
+            const source = skillSourceDir(this.paths.ssotSkillsDir, updated);
+            await syncSkillToApps(updated, source, this.skillSyncMethod, this.skillAdapters);
+            await this.save();
+            return updated;
+        });
+    }
+    async uninstallSkill(id) {
+        return this.executeExclusive(async () => {
+            const skill = this.state.skills[id];
+            if (!skill) {
+                return;
+            }
+            const disabled = {
+                ...skill,
+                apps: {
+                    claude: false,
+                    claudecode: false,
+                    codex: false,
+                    gemini: false,
+                    opencode: false,
+                    openclaw: false,
+                },
+            };
+            const source = skillSourceDir(this.paths.ssotSkillsDir, skill);
+            await syncSkillToApps(disabled, source, this.skillSyncMethod, this.skillAdapters);
+            delete this.state.skills[id];
+            const sourceDir = skillSourceDir(this.paths.ssotSkillsDir, skill);
+            await removeIfExists(sourceDir);
+            await this.save();
+        });
+    }
+    async toggleSkillApp(skillId, appId, enabled) {
+        return this.executeExclusive(async () => {
+            const current = this.state.skills[skillId];
+            if (!current) {
+                throw new SdkError("SKILL_NOT_FOUND", `Skill not found: ${skillId}`, {
+                    skillId,
+                });
+            }
+            const updated = applySkillAppFlag(current, appId, enabled);
+            this.state.skills[skillId] = updated;
+            const source = skillSourceDir(this.paths.ssotSkillsDir, updated);
+            await syncSkillToApps(updated, source, this.skillSyncMethod, this.skillAdapters);
+            await this.save();
+            return updated;
+        });
+    }
+    async importSkillsFromApps() {
+        return this.executeExclusive(async () => {
+            let count = 0;
+            const apps = ["claude", "claudecode", "opencode", "codex", "gemini", "openclaw"];
+            for (const appId of apps) {
+                count += await this.importSkillsFromApp(appId);
+            }
+            await this.save();
+            return count;
+        });
+    }
+    /**
+     * 从单个应用导入 Skills
+     */
+    async importSkillsFromApp(appId) {
+        let count = 0;
+        const imported = await this.skillAdapters[appId].importSkills();
+        for (const imp of imported) {
+            const isNew = await this.processImportedSkill(imp, appId);
+            if (isNew) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * 处理导入的 Skill（合并或创建）
+     * @returns 是否为新创建的 Skill
+     */
+    async processImportedSkill(imp, appId) {
+        const existing = this.findSkillByName(imp.name);
+        if (existing) {
+            await this.mergeExistingSkill(existing, appId);
+            return false;
+        }
+        await this.createNewImportedSkill(imp, appId);
+        return true;
+    }
+    /**
+     * 根据名称查找 Skill
+     */
+    findSkillByName(name) {
+        return Object.values(this.state.skills).find((s) => s.name === name);
+    }
+    /**
+     * 合并已存在的 Skill
+     */
+    async mergeExistingSkill(existing, appId) {
+        const merged = {
+            ...existing,
+            apps: { ...existing.apps, [appId]: true },
+        };
+        this.state.skills[existing.id] = merged;
+        const source = skillSourceDir(this.paths.ssotSkillsDir, merged);
+        await syncSkillToApps(merged, source, this.skillSyncMethod, this.skillAdapters);
+    }
+    /**
+     * 创建新导入的 Skill
+     */
+    async createNewImportedSkill(imp, appId) {
+        const withFlag = this.createSkillWithAppFlag(imp, appId);
+        this.state.skills[withFlag.id] = withFlag;
+        const source = skillSourceDir(this.paths.ssotSkillsDir, withFlag);
+        await copyDir(imp.directory, source);
+        await syncSkillToApps(withFlag, source, this.skillSyncMethod, this.skillAdapters);
+    }
+    /**
+     * 创建带有应用标记的 Skill
+     */
+    createSkillWithAppFlag(imp, appId) {
+        const now = Date.now();
+        return {
+            id: imp.id,
+            name: imp.name,
+            directory: imp.directory,
+            description: imp.description,
+            apps: {
+                claude: false,
+                claudecode: false,
+                codex: false,
+                gemini: false,
+                opencode: false,
+                openclaw: false,
+                [appId]: true,
+            },
+            installedAt: now,
+        };
+    }
+    getPaths() {
+        return this.paths;
+    }
+}