@hopping-dev/hub 0.1.0

package/dist/cli/config-writer.js

@@ -0,0 +1,318 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeMcpJson = writeMcpJson;
+exports.writeMcpToml = writeMcpToml;
+exports.writeMcpConfig = writeMcpConfig;
+exports.writeClaudeCodeHooks = writeClaudeCodeHooks;
+exports.isCursorAdapterReady = isCursorAdapterReady;
+exports.writeCursorHooks = writeCursorHooks;
+exports.writeHooksConfig = writeHooksConfig;
+/**
+ * ConfigWriter — 設定檔讀取/合併/寫入（JSON + TOML）
+ *
+ * REQ-HUB-042: Setup CLI — Multi-Agent Config File Merge
+ * REQ-HUB-043: Setup CLI — Cross-Platform Hook Commands
+ */
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const TOML = __importStar(require("smol-toml"));
+const path_resolver_1 = require("./path-resolver");
+// ============================================
+// Helpers
+// ============================================
+/**
+ * 確保目錄存在
+ */
+async function ensureDir(filePath) {
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * 讀取 JSON 檔案，不存在返回空物件
+ */
+async function readJsonFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            console.error(`  ⚠ Warning: Failed to parse ${filePath}, will create new config`);
+        }
+        return {};
+    }
+}
+/**
+ * 讀取 TOML 檔案，不存在返回空物件
+ */
+async function readTomlFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return TOML.parse(content);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            console.error(`  ⚠ Warning: Failed to parse ${filePath}, will create new config`);
+        }
+        return {};
+    }
+}
+/**
+ * 建立 .bak 備份（僅當檔案已存在時）
+ */
+async function createBackup(filePath) {
+    if ((0, node_fs_1.existsSync)(filePath)) {
+        await fs.copyFile(filePath, `${filePath}.bak`);
+        return true;
+    }
+    return false;
+}
+/**
+ * 寫入 JSON 檔案（含備份 + 目錄建立）
+ */
+async function writeJsonFile(filePath, data, dryRun) {
+    const existed = (0, node_fs_1.existsSync)(filePath);
+    let backedUp = false;
+    if (!dryRun) {
+        await ensureDir(filePath);
+        backedUp = await createBackup(filePath);
+        await fs.writeFile(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+    }
+    return {
+        path: filePath,
+        action: existed ? 'updated' : 'created',
+        backedUp,
+    };
+}
+/**
+ * 寫入 TOML 檔案（含備份 + 目錄建立）
+ */
+async function writeTomlFile(filePath, data, dryRun) {
+    const existed = (0, node_fs_1.existsSync)(filePath);
+    let backedUp = false;
+    if (!dryRun) {
+        await ensureDir(filePath);
+        backedUp = await createBackup(filePath);
+        await fs.writeFile(filePath, TOML.stringify(data) + '\n', 'utf-8');
+    }
+    return {
+        path: filePath,
+        action: existed ? 'updated' : 'created',
+        backedUp,
+    };
+}
+// ============================================
+// MCP Config Writers (REQ-HUB-042)
+// ============================================
+/**
+ * 建立 MCP Server 設定物件
+ */
+function buildMcpEntry(agent, options) {
+    const entry = {
+        command: options.hubCommand,
+        args: [...options.hubArgs],
+        env: { HOPPING_DEV_MODE: options.devMode },
+    };
+    // Claude Code 需要 type: 'stdio'
+    if (agent.name === 'claude-code') {
+        entry.type = 'stdio';
+    }
+    return entry;
+}
+/**
+ * 寫入 Claude Code / Cursor MCP config（JSON 格式）
+ * - Claude Code: .mcp.json（project） / ~/.claude.json（user）
+ * - Cursor: .cursor/mcp.json（project） / ~/.cursor/mcp.json（user）
+ */
+async function writeMcpJson(agent, options) {
+    const configPath = options.scope === 'project' ? agent.mcpConfigPath : agent.globalMcpConfigPath;
+    const existing = await readJsonFile(configPath);
+    const mcpServers = (existing.mcpServers ?? {});
+    mcpServers['hopping-hub'] = buildMcpEntry(agent, options);
+    existing.mcpServers = mcpServers;
+    return writeJsonFile(configPath, existing, options.dryRun);
+}
+/**
+ * 寫入 Codex MCP config（TOML 格式）
+ * - .codex/config.toml（project / user）
+ */
+async function writeMcpToml(agent, options) {
+    const configPath = options.scope === 'project' ? agent.mcpConfigPath : agent.globalMcpConfigPath;
+    const existing = await readTomlFile(configPath);
+    const mcpServers = (existing.mcp_servers ?? {});
+    mcpServers['hopping-hub'] = {
+        command: options.hubCommand,
+        args: [...options.hubArgs],
+        enabled: true,
+        env: { HOPPING_DEV_MODE: options.devMode },
+    };
+    existing.mcp_servers = mcpServers;
+    return writeTomlFile(configPath, existing, options.dryRun);
+}
+/**
+ * 寫入 MCP config（根據 agent 自動分派 JSON 或 TOML）
+ */
+async function writeMcpConfig(agent, options) {
+    if (agent.configFormat === 'toml') {
+        return writeMcpToml(agent, options);
+    }
+    return writeMcpJson(agent, options);
+}
+// ============================================
+// Hooks Config Writers (REQ-HUB-042)
+// ============================================
+/** Hook command pattern（用於偵測既有 hopping hooks） */
+const HOPPING_HOOK_PATTERN = /hopping|pre-tool-use|post-tool-use|cursor-adapter/i;
+/**
+ * 寫入 Claude Code Hooks config（.claude/settings.json，巢狀格式，PascalCase）
+ */
+async function writeClaudeCodeHooks(hooksConfigPath, options) {
+    const existing = await readJsonFile(hooksConfigPath);
+    const hooks = (existing.hooks ?? {});
+    const preCommand = (0, path_resolver_1.buildPreHookCommand)(options.preHookPath, options.devMode);
+    const postCommand = (0, path_resolver_1.buildPostHookCommand)(options.postHookPath);
+    // PreToolUse
+    const preHooks = (hooks.PreToolUse ?? []);
+    const existingPreIdx = preHooks.findIndex((h) => h.hooks?.some((sub) => HOPPING_HOOK_PATTERN.test(sub.command)));
+    const preEntry = {
+        matcher: '',
+        hooks: [{ type: 'command', command: preCommand }],
+    };
+    if (existingPreIdx >= 0) {
+        preHooks[existingPreIdx] = preEntry;
+    }
+    else {
+        preHooks.push(preEntry);
+    }
+    hooks.PreToolUse = preHooks;
+    // PostToolUse
+    const postHooks = (hooks.PostToolUse ?? []);
+    const existingPostIdx = postHooks.findIndex((h) => h.hooks?.some((sub) => HOPPING_HOOK_PATTERN.test(sub.command)));
+    const postEntry = {
+        matcher: '',
+        hooks: [{ type: 'command', command: postCommand }],
+    };
+    if (existingPostIdx >= 0) {
+        postHooks[existingPostIdx] = postEntry;
+    }
+    else {
+        postHooks.push(postEntry);
+    }
+    hooks.PostToolUse = postHooks;
+    existing.hooks = hooks;
+    return writeJsonFile(hooksConfigPath, existing, options.dryRun);
+}
+/**
+ * 檢查 cursor-adapter.js 是否已實作（非空檔案）
+ */
+function isCursorAdapterReady(adapterPath) {
+    if (!(0, node_fs_1.existsSync)(adapterPath))
+        return false;
+    try {
+        const stat = (0, node_fs_1.statSync)(adapterPath);
+        // 空檔案或只有換行的檔案視為未實作
+        if (stat.size <= 1)
+            return false;
+        const content = (0, node_fs_1.readFileSync)(adapterPath, 'utf-8').trim();
+        return content.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 寫入 Cursor Hooks config（.cursor/hooks.json，扁平格式，camelCase，version: 1）
+ * 只有在 cursor-adapter.js 存在且已實作時才寫入
+ */
+async function writeCursorHooks(hooksConfigPath, cursorAdapterPath, options) {
+    if (!isCursorAdapterReady(cursorAdapterPath)) {
+        return null; // 回傳 null 表示跳過
+    }
+    const existing = await readJsonFile(hooksConfigPath);
+    existing.version = 1;
+    const hooks = (existing.hooks ?? {});
+    const preCommand = `node "${cursorAdapterPath}" pre`;
+    const postCommand = `node "${cursorAdapterPath}" post`;
+    // preToolUse
+    const preHooks = (hooks.preToolUse ?? []);
+    const existingPreIdx = preHooks.findIndex((h) => HOPPING_HOOK_PATTERN.test(h.command));
+    const preEntry = { command: preCommand };
+    if (existingPreIdx >= 0) {
+        preHooks[existingPreIdx] = preEntry;
+    }
+    else {
+        preHooks.push(preEntry);
+    }
+    hooks.preToolUse = preHooks;
+    // postToolUse
+    const postHooks = (hooks.postToolUse ?? []);
+    const existingPostIdx = postHooks.findIndex((h) => HOPPING_HOOK_PATTERN.test(h.command));
+    const postEntry = { command: postCommand };
+    if (existingPostIdx >= 0) {
+        postHooks[existingPostIdx] = postEntry;
+    }
+    else {
+        postHooks.push(postEntry);
+    }
+    hooks.postToolUse = postHooks;
+    existing.hooks = hooks;
+    return writeJsonFile(hooksConfigPath, existing, options.dryRun);
+}
+/**
+ * 寫入 Hooks config（根據 agent 自動分派）
+ * 回傳 WriteResult（成功）、null（跳過，如 Cursor adapter 未實作）、或 'unsupported'（如 Codex）
+ */
+async function writeHooksConfig(agent, options) {
+    if (!agent.supportsHooks) {
+        return 'unsupported';
+    }
+    if (options.skipHooks) {
+        return null;
+    }
+    const hooksConfigPath = agent.hooksConfigPath;
+    if (!hooksConfigPath) {
+        return 'unsupported';
+    }
+    if (agent.name === 'claude-code') {
+        return writeClaudeCodeHooks(hooksConfigPath, options);
+    }
+    if (agent.name === 'cursor') {
+        return writeCursorHooks(hooksConfigPath, options.cursorAdapterPath, options);
+    }
+    return 'unsupported';
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/cli/config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-writer.js","sourceRoot":"","sources":["../../src/cli/config-writer.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

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

package/dist/cli/index.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * CLI 入口 — Commander.js 子命令分派
+ *
+ * REQ-HUB-040: CLI Entry Point (bin)
+ *
+ * - No subcommand (or `serve`) → Start MCP Server (stdio transport)
+ * - `setup` → Execute setup CLI
+ * - `--help` or `-h` → Display usage information
+ */
+const commander_1 = require("commander");
+const setup_1 = require("./setup");
+const program = new commander_1.Command();
+program.name('hopping-hub').description('HopPing Hub — AI Agent Remote Control').version('0.1.0');
+// Default command: start MCP Server
+program
+    .command('serve', { isDefault: true })
+    .description('Start MCP Server (stdio transport)')
+    .action(async () => {
+    // 動態 import 原有 MCP Server 入口
+    await Promise.resolve().then(() => __importStar(require('../index')));
+});
+// Setup command
+program
+    .command('setup')
+    .description('Interactive setup wizard — configure MCP, Hooks, and Skill for detected agents')
+    .option('-y, --yes', 'Skip confirmation prompt', false)
+    .option('--dry-run', 'Show planned changes without writing files', false)
+    .option('--scope <scope>', 'Config scope: project or user', 'project')
+    .option('--skip-hooks', 'Skip hooks configuration', false)
+    .option('--skip-skill', 'Skip skill auto-install', false)
+    .addOption(new commander_1.Option('--dev-mode <mode>', 'HOPPING_DEV_MODE value')
+    .choices(['isolated', 'allowlist', 'full'])
+    .default('full'))
+    .action(async (opts) => {
+    const flags = {
+        yes: opts.yes,
+        dryRun: opts.dryRun,
+        scope: opts.scope === 'user' ? 'user' : 'project',
+        skipHooks: opts.skipHooks,
+        skipSkill: opts.skipSkill,
+        devMode: opts.devMode,
+    };
+    await (0, setup_1.executeSetup)(flags);
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA;;;;;;;;GAQG;AACH,yCAA4C;AAC5C,mCAAwD;AAExD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,uCAAuC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAElG,oCAAoC;AACpC,OAAO;KACJ,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACrC,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,6BAA6B;IAC7B,wDAAa,UAAU,GAAC,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEL,gBAAgB;AAChB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,gFAAgF,CAAC;KAC7F,MAAM,CAAC,WAAW,EAAE,0BAA0B,EAAE,KAAK,CAAC;KACtD,MAAM,CAAC,WAAW,EAAE,4CAA4C,EAAE,KAAK,CAAC;KACxE,MAAM,CAAC,iBAAiB,EAAE,+BAA+B,EAAE,SAAS,CAAC;KACrE,MAAM,CAAC,cAAc,EAAE,0BAA0B,EAAE,KAAK,CAAC;KACzD,MAAM,CAAC,cAAc,EAAE,yBAAyB,EAAE,KAAK,CAAC;KACxD,SAAS,CACR,IAAI,kBAAM,CAAC,mBAAmB,EAAE,wBAAwB,CAAC;KACtD,OAAO,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;KAC1C,OAAO,CAAC,MAAM,CAAC,CACnB;KACA,MAAM,CACL,KAAK,EAAE,IAON,EAAE,EAAE;IACH,MAAM,KAAK,GAAe;QACxB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACjD,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;IAEF,MAAM,IAAA,oBAAY,EAAC,KAAK,CAAC,CAAC;AAC5B,CAAC,CACF,CAAC;AAEJ,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cli/path-resolver.d.ts

@@ -0,0 +1,48 @@
+export type InstallMode = 'npm' | 'local';
+export type AgentName = 'claude-code' | 'cursor' | 'codex';
+export interface DetectedAgent {
+    name: AgentName;
+    displayName: string;
+    configFormat: 'json' | 'toml';
+    /** MCP config 寫入路徑（project scope） */
+    mcpConfigPath: string;
+    /** MCP config 寫入路徑（user scope） */
+    globalMcpConfigPath: string;
+    supportsHooks: boolean;
+    /** Hooks config 寫入路徑（project scope，若支援 hooks） */
+    hooksConfigPath?: string;
+}
+export interface ResolvedPaths {
+    installMode: InstallMode;
+    hubCommand: string;
+    hubArgs: string[];
+    preHookPath: string;
+    postHookPath: string;
+    cursorAdapterPath: string;
+    detectedAgents: DetectedAgent[];
+}
+/**
+ * 偵測安裝模式：
+ * - npm mode: __dirname 包含 node_modules → 使用 npx
+ * - local mode: 直接使用 node 執行
+ */
+export declare function detectInstallMode(dirname: string): InstallMode;
+/**
+ * 偵測已安裝的 Agent（啟發式：檢查 home directory 下是否有對應設定目錄）
+ */
+export declare function detectAgents(homeDir?: string, cwd?: string): DetectedAgent[];
+/**
+ * 產生跨平台 Hook command
+ * - Unix: HOPPING_DEV_MODE=<mode> node <hookPath>
+ * - Windows: cmd /c "set HOPPING_DEV_MODE=<mode> && node <hookPath>"
+ */
+export declare function buildPreHookCommand(hookPath: string, devMode: string, platform?: NodeJS.Platform): string;
+/**
+ * PostToolUse hook 不需要 HOPPING_DEV_MODE（純觀測）
+ */
+export declare function buildPostHookCommand(hookPath: string): string;
+/**
+ * 完整路徑解析：偵測安裝模式、Agent、解析所有路徑
+ */
+export declare function resolve(dirname?: string, homeDir?: string, cwd?: string): ResolvedPaths;
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/cli/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../src/cli/path-resolver.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,CAAC;AAE1C,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAyDD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAE9D;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,GAAE,MAAqB,EAC9B,GAAG,GAAE,MAAsB,GAC1B,aAAa,EAAE,CAqBjB;AAyED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AAMD;;GAEG;AACH,wBAAgB,OAAO,CACrB,OAAO,GAAE,MAAkB,EAC3B,OAAO,GAAE,MAAqB,EAC9B,GAAG,GAAE,MAAsB,GAC1B,aAAa,CAcf"}