aws-runtime-bridge 1.0.0

package/dist/utils/mcp-utils.js

@@ -0,0 +1,165 @@
+/**
+ * MCP 工具函数
+ *
+ * 提供 MCP 服务器配置的构建、转换和规范化功能
+ */
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { parseBoolean } from './validation.js';
+/**
+ * 构建 MCP 配置内容
+ *
+ * @param mcpServers - MCP 服务器列表
+ * @returns JSON 格式的配置内容
+ */
+export function buildMcpConfigContent(mcpServers) {
+    const servers = Array.isArray(mcpServers) ? mcpServers : [];
+    const serverMap = {};
+    for (const item of servers) {
+        if (!item) {
+            continue;
+        }
+        if (!parseBoolean(item.enabled, true)) {
+            continue;
+        }
+        const name = String(item.name || '').trim();
+        if (!name) {
+            continue;
+        }
+        const transport = String(item.transport || 'stdio').trim().toLowerCase();
+        const serverCfg = { transport };
+        if (item.command != null && String(item.command).trim()) {
+            serverCfg.command = String(item.command).trim();
+        }
+        if (item.url != null && String(item.url).trim()) {
+            serverCfg.url = String(item.url).trim();
+        }
+        if (item.args != null) {
+            serverCfg.args = Array.isArray(item.args) ? item.args : [];
+        }
+        if (item.env != null && typeof item.env === 'object') {
+            serverCfg.env = item.env;
+        }
+        serverMap[name] = serverCfg;
+    }
+    return JSON.stringify({
+        mcpServers: serverMap,
+    }, null, 2);
+}
+/**
+ * 规范化 MCP Payload
+ *
+ * @param payload - 原始 payload
+ * @returns 规范化后的 MCP Payload，无效返回 null
+ */
+export function normalizeMcpPayload(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return null;
+    }
+    const p = payload;
+    const name = String(p.name || '').trim();
+    if (!name) {
+        return null;
+    }
+    return {
+        id: String(p.id || randomUUID()),
+        name,
+        transport: String(p.transport || 'stdio').trim().toLowerCase(),
+        command: p.command == null ? '' : String(p.command),
+        url: p.url == null ? '' : String(p.url),
+        args: Array.isArray(p.args) ? p.args.map((item) => String(item)) : [],
+        env: p.env && typeof p.env === 'object' ? p.env : {},
+        enabled: parseBoolean(p.enabled, true),
+        installedAt: p.installedAt || new Date().toISOString(),
+    };
+}
+/**
+ * 规范化 SDK App 标志
+ *
+ * @param rawApps - 原始 apps 配置
+ * @returns 规范化后的 SdkApps
+ */
+export function normalizeSdkAppFlags(rawApps) {
+    if (!rawApps || typeof rawApps !== 'object') {
+        return undefined;
+    }
+    const apps = rawApps;
+    return {
+        claude: parseBoolean(apps.claude, false),
+        codex: parseBoolean(apps.codex, false),
+        gemini: parseBoolean(apps.gemini, false),
+        opencode: parseBoolean(apps.opencode, false),
+        openclaw: parseBoolean(apps.openclaw, false),
+    };
+}
+/**
+ * 规范化 SDK MCP 服务器规格
+ *
+ * @param rawMcp - 原始 MCP 配置
+ * @returns 规范化后的服务器配置
+ */
+export function normalizeSdkMcpServerSpec(rawMcp) {
+    const mcp = rawMcp && typeof rawMcp === 'object' ? rawMcp : {};
+    const baseServer = mcp.server && typeof mcp.server === 'object'
+        ? mcp.server
+        : {};
+    const type = String(baseServer.type || mcp.transport || 'stdio').trim().toLowerCase();
+    const server = {
+        ...baseServer,
+        type,
+    };
+    if (mcp.command != null && String(mcp.command).trim()) {
+        server.command = String(mcp.command).trim();
+    }
+    if (mcp.url != null && String(mcp.url).trim()) {
+        server.url = String(mcp.url).trim();
+    }
+    if (mcp.args != null) {
+        server.args = Array.isArray(mcp.args) ? mcp.args.map((item) => String(item)) : [];
+    }
+    if (mcp.env != null && typeof mcp.env === 'object') {
+        server.env = mcp.env;
+    }
+    if (mcp.headers != null && typeof mcp.headers === 'object') {
+        server.headers = mcp.headers;
+    }
+    return server;
+}
+/**
+ * 转换为 Legacy MCP State Item
+ *
+ * @param mcpServer - SDK MCP 服务器对象
+ * @returns Legacy MCP State Item
+ */
+export function toLegacyMcpStateItem(mcpServer) {
+    const server = mcpServer?.server && typeof mcpServer.server === 'object' ? mcpServer.server : {};
+    const apps = mcpServer?.apps && typeof mcpServer.apps === 'object' ? mcpServer.apps : {};
+    return {
+        id: String(mcpServer?.id || randomUUID()),
+        name: String(mcpServer?.name || '').trim(),
+        transport: String(server.type || 'stdio').trim().toLowerCase(),
+        command: server.command == null ? '' : String(server.command),
+        url: server.url == null ? '' : String(server.url),
+        args: Array.isArray(server.args) ? server.args.map((item) => String(item)) : [],
+        env: server.env && typeof server.env === 'object' ? server.env : {},
+        enabled: Boolean(apps.claude || apps.codex || apps.gemini || apps.opencode || apps.openclaw),
+        installedAt: new Date().toISOString(),
+    };
+}
+/**
+ * 转换为 Legacy Skill State Item
+ *
+ * @param skill - Skill 对象
+ * @returns Legacy Skill State Item
+ */
+export function toLegacySkillStateItem(skill) {
+    const directory = String(skill?.directory || skill?.sourceDir || skill?.filePath || '').trim();
+    return {
+        id: String(skill?.id || randomUUID()),
+        name: String(skill?.name || path.basename(directory || 'skill')).trim(),
+        fileName: directory ? path.basename(directory) : '',
+        filePath: directory,
+        bytes: 0,
+        installedAt: skill?.installedAt ? new Date(skill.installedAt).toISOString() : new Date().toISOString(),
+    };
+}

package/dist/utils/path-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 路径解析工具函数
+ *
+ * 提供路径解析和标准化的工具函数
+ */
+/**
+ * 解析结果接口
+ */
+export interface PropertiesPathResult {
+    normalizedWorkspace: string;
+    resolvedTarget: string;
+}
+export declare function resolveWorkspaceRoot(workspacePath: string | unknown): string;
+export declare function ensureInsideWorkspace(workspaceRoot: string, targetPath: string): string;
+export declare function resolveWorkspaceFilePath(workspacePath: string | unknown, relativeOrAbsolutePath: string | unknown, defaultRelativePath: string): PropertiesPathResult;
+/**
+ * 解析属性文件的目标路径
+ *
+ * @param workspacePath - 工作区路径
+ * @param relativeOrAbsolutePath - 相对或绝对路径
+ * @returns 解析后的路径结果
+ */
+export declare function resolvePropertiesTargetPath(workspacePath: string | unknown, relativeOrAbsolutePath: string | unknown): PropertiesPathResult;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/utils/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAM5E;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAUvF;AAED,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,GAAG,OAAO,EAC/B,sBAAsB,EAAE,MAAM,GAAG,OAAO,EACxC,mBAAmB,EAAE,MAAM,GAC1B,oBAAoB,CAatB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,GAAG,OAAO,EAC/B,sBAAsB,EAAE,MAAM,GAAG,OAAO,GACvC,oBAAoB,CAEtB"}

package/dist/utils/path-utils.js

@@ -0,0 +1,44 @@
+/**
+ * 路径解析工具函数
+ *
+ * 提供路径解析和标准化的工具函数
+ */
+import path from 'node:path';
+export function resolveWorkspaceRoot(workspacePath) {
+    if (!workspacePath || !String(workspacePath).trim()) {
+        throw new Error('workspacePath is required');
+    }
+    return path.resolve(String(workspacePath).trim());
+}
+export function ensureInsideWorkspace(workspaceRoot, targetPath) {
+    const resolvedTarget = path.resolve(targetPath);
+    const relativePath = path.relative(workspaceRoot, resolvedTarget);
+    const isOutside = relativePath.startsWith('..') || path.isAbsolute(relativePath);
+    if (isOutside) {
+        throw new Error(`Target path is outside workspace: ${resolvedTarget}`);
+    }
+    return resolvedTarget;
+}
+export function resolveWorkspaceFilePath(workspacePath, relativeOrAbsolutePath, defaultRelativePath) {
+    const normalizedWorkspace = resolveWorkspaceRoot(workspacePath);
+    const providedPathStr = relativeOrAbsolutePath
+        ? String(relativeOrAbsolutePath).trim() || defaultRelativePath
+        : defaultRelativePath;
+    const candidatePath = path.isAbsolute(providedPathStr)
+        ? providedPathStr
+        : path.resolve(normalizedWorkspace, providedPathStr);
+    return {
+        normalizedWorkspace,
+        resolvedTarget: ensureInsideWorkspace(normalizedWorkspace, candidatePath),
+    };
+}
+/**
+ * 解析属性文件的目标路径
+ *
+ * @param workspacePath - 工作区路径
+ * @param relativeOrAbsolutePath - 相对或绝对路径
+ * @returns 解析后的路径结果
+ */
+export function resolvePropertiesTargetPath(workspacePath, relativeOrAbsolutePath) {
+    return resolveWorkspaceFilePath(workspacePath, relativeOrAbsolutePath, 'vibe-coding/my.properties');
+}

package/dist/utils/validation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 验证工具函数
+ *
+ * 提供通用的验证和转换函数
+ */
+/**
+ * 解析布尔值
+ * 支持多种格式的布尔值转换
+ *
+ * @param value - 待解析的值
+ * @param defaultValue - 默认值
+ * @returns 解析后的布尔值
+ */
+export declare function parseBoolean(value: unknown, defaultValue?: boolean): boolean;
+/**
+ * 确保启用的工具列表有效
+ * 如果传入的数组无效或为空，返回默认工具列表
+ *
+ * @param rawTools - 原始工具列表
+ * @returns 有效的工具列表
+ */
+export declare function ensureEnabledTools(rawTools: unknown): string[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,UAAO,GAAG,OAAO,CAezE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAgB9D"}

package/dist/utils/validation.js

@@ -0,0 +1,53 @@
+/**
+ * 验证工具函数
+ *
+ * 提供通用的验证和转换函数
+ */
+/**
+ * 解析布尔值
+ * 支持多种格式的布尔值转换
+ *
+ * @param value - 待解析的值
+ * @param defaultValue - 默认值
+ * @returns 解析后的布尔值
+ */
+export function parseBoolean(value, defaultValue = true) {
+    if (value == null) {
+        return defaultValue;
+    }
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    const normalized = String(value).trim().toLowerCase();
+    if (['true', '1', 'yes', 'y', 'on'].includes(normalized)) {
+        return true;
+    }
+    if (['false', '0', 'no', 'n', 'off'].includes(normalized)) {
+        return false;
+    }
+    return defaultValue;
+}
+/**
+ * 确保启用的工具列表有效
+ * 如果传入的数组无效或为空，返回默认工具列表
+ *
+ * @param rawTools - 原始工具列表
+ * @returns 有效的工具列表
+ */
+export function ensureEnabledTools(rawTools) {
+    const defaults = ['claude', 'opencode', 'codex'];
+    if (!Array.isArray(rawTools) || rawTools.length === 0) {
+        return defaults;
+    }
+    const result = [];
+    for (const item of rawTools) {
+        const normalized = String(item || '').trim().toLowerCase();
+        if (!normalized) {
+            continue;
+        }
+        if (!result.includes(normalized)) {
+            result.push(normalized);
+        }
+    }
+    return result.length > 0 ? result : defaults;
+}

package/dist/utils/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/utils/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../src/utils/validation.test.ts"],"names":[],"mappings":""}

package/dist/utils/validation.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect } from 'vitest';
+import { parseBoolean, ensureEnabledTools } from './validation';
+describe('parseBoolean', () => {
+    describe('true values', () => {
+        it('should return true for "true"', () => {
+            expect(parseBoolean('true')).toBe(true);
+        });
+        it('should return true for "TRUE"', () => {
+            expect(parseBoolean('TRUE')).toBe(true);
+        });
+        it('should return true for "1"', () => {
+            expect(parseBoolean('1')).toBe(true);
+        });
+        it('should return true for "yes"', () => {
+            expect(parseBoolean('yes')).toBe(true);
+        });
+        it('should return true for boolean true', () => {
+            expect(parseBoolean(true)).toBe(true);
+        });
+    });
+    describe('empty/null/undefined values', () => {
+        it('should return default value (true) for empty string', () => {
+            expect(parseBoolean('')).toBe(true); // 默认值是 true
+        });
+        it('should return default value (true) for null', () => {
+            expect(parseBoolean(null)).toBe(true); // 默认值是 true
+        });
+        it('should return default value (true) for undefined', () => {
+            expect(parseBoolean(undefined)).toBe(true); // 默认值是 true
+        });
+        it('should return false when defaultValue is false for empty string', () => {
+            expect(parseBoolean('', false)).toBe(false);
+        });
+        it('should return false when defaultValue is false for null', () => {
+            expect(parseBoolean(null, false)).toBe(false);
+        });
+        it('should return false when defaultValue is false for undefined', () => {
+            expect(parseBoolean(undefined, false)).toBe(false);
+        });
+    });
+    describe('default value', () => {
+        it('should return default when value is null', () => {
+            expect(parseBoolean(null, true)).toBe(true);
+        });
+        it('should return default when value is undefined', () => {
+            expect(parseBoolean(undefined, true)).toBe(true);
+        });
+        it('should ignore default for valid values', () => {
+            expect(parseBoolean('false', true)).toBe(false);
+        });
+    });
+});
+describe('ensureEnabledTools', () => {
+    it('should return default tools for empty array', () => {
+        const result = ensureEnabledTools([]);
+        expect(result).toContain('claude');
+        expect(result).toContain('opencode');
+        expect(result).toContain('codex');
+    });
+    it('should return default tools for null', () => {
+        const result = ensureEnabledTools(null);
+        expect(result).toContain('claude');
+        expect(result).toContain('opencode');
+        expect(result).toContain('codex');
+    });
+    it('should return default tools for undefined', () => {
+        const result = ensureEnabledTools(undefined);
+        expect(result).toContain('claude');
+        expect(result).toContain('opencode');
+        expect(result).toContain('codex');
+    });
+    it('should return input array when not empty', () => {
+        const result = ensureEnabledTools(['claude', 'gemini']);
+        expect(result).toEqual(['claude', 'gemini']);
+    });
+    it('should handle single tool', () => {
+        const result = ensureEnabledTools(['opencode']);
+        expect(result).toEqual(['opencode']);
+    });
+    it('should deduplicate tools', () => {
+        const result = ensureEnabledTools(['claude', 'claude', 'opencode']);
+        expect(result).toEqual(['claude', 'opencode']);
+    });
+    it('should normalize tools to lowercase', () => {
+        const result = ensureEnabledTools(['CLAUDE', 'OpenCode']);
+        expect(result).toEqual(['claude', 'opencode']);
+    });
+});

package/dist/utils/yaml-utils.d.ts

@@ -0,0 +1,73 @@
+/**
+ * YAML 处理工具函数
+ *
+ * 提供 YAML 配置文件的读取、解析、生成和路径匹配功能
+ */
+/**
+ * YAML 加载结果
+ */
+export interface YmlLoadResult {
+    content: string | null;
+    resolvedPath: string;
+    foundInParent: boolean;
+    matchedAgentPath: string | null;
+}
+/**
+ * Agent 配置提取结果
+ */
+export interface AgentConfigResult {
+    content: string;
+    isTemplate: boolean;
+    projectFromSibling: string | null;
+}
+/**
+ * 检查 YAML 配置中是否有 agent 的 path 匹配目标路径
+ * path 字段格式支持：modules\x 或 modules/x
+ *
+ * @param yamlContent - YAML 内容
+ * @param targetRelativePath - 目标相对路径
+ * @returns 匹配的 agent path，无匹配则返回 null
+ */
+export declare function hasMatchingAgentPath(yamlContent: string, targetRelativePath: string): string | null;
+/**
+ * 从 YAML 配置中提取匹配的 agent 配置，或生成模板
+ *
+ * @param yamlContent - YAML 内容
+ * @param targetRelativePath - 目标相对路径
+ * @returns 提取结果
+ */
+export declare function extractAgentConfigOrTemplate(yamlContent: string, targetRelativePath: string): AgentConfigResult;
+/**
+ * 生成空模板
+ * 注意：path 字段留空，在写入时根据工作目录自动计算
+ *
+ * @param _targetRelativePath - 目标相对路径（未使用）
+ * @returns 空模板 YAML 内容
+ */
+export declare function generateEmptyTemplate(_targetRelativePath: string): string;
+/**
+ * 自动填充 YAML 配置中的 path 字段
+ * 如果 path 为空、未填写或只有空白字符，则使用工作目录相对于项目根目录的路径
+ *
+ * @param ymlContent - YAML 配置内容
+ * @param workspaceRelativePath - 工作目录相对于项目根目录的路径
+ * @returns 处理后的 YAML 内容
+ */
+export declare function autoFillPathInYml(ymlContent: string, workspaceRelativePath: string): string;
+/**
+ * 向上查找并加载 YAML 配置文件
+ *
+ * 查找逻辑：
+ * 1. 先检查工作目录下是否有配置文件，检查 path 是否匹配
+ * 2. 如果不匹配，向上查找父目录的配置文件，检查 path 是否匹配
+ * 3. 找到匹配的配置 → 使用该配置
+ * 4. 所有层级都没有匹配的配置 → 使用最后一个找到的配置（或在工作目录创建）
+ *
+ * 例如：工作目录 D:\a\b\c\d，相对路径 vibe-coding/my.yml
+ * 第1次查找：D:\a\b\c\d\vibe-coding\my.yml，匹配 path="."
+ * 第2次查找：D:\a\b\c\vibe-coding\my.yml，匹配 path="d"
+ * 第3次查找：D:\a\b\vibe-coding\my.yml，匹配 path="c/d"
+ * ...
+ */
+export declare function loadYmlWithUpwardSearch(workspacePath: string, relativePath: string): Promise<YmlLoadResult>;
+//# sourceMappingURL=yaml-utils.d.ts.map

package/dist/utils/yaml-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-utils.d.ts","sourceRoot":"","sources":["../../src/utils/yaml-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0CnG;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACzB,iBAAiB,CAkFnB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAkBzE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,MAAM,CAyC3F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,CAAC,CA8FxB"}