@hopping-dev/hub 0.1.0

package/dist/cli/path-resolver.js

@@ -0,0 +1,212 @@
+"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.detectInstallMode = detectInstallMode;
+exports.detectAgents = detectAgents;
+exports.buildPreHookCommand = buildPreHookCommand;
+exports.buildPostHookCommand = buildPostHookCommand;
+exports.resolve = resolve;
+/**
+ * PathResolver — 安裝模式偵測 + Agent 偵測 + 路徑解析
+ *
+ * REQ-HUB-041: Setup CLI — Install Mode & Agent Detection
+ */
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const AGENT_DEFINITIONS = [
+    {
+        name: 'claude-code',
+        displayName: 'Claude Code',
+        detectDir: '.claude',
+        configFormat: 'json',
+        mcpConfigRelative: '.mcp.json',
+        globalMcpConfigRelative: '.claude.json',
+        supportsHooks: true,
+        hooksConfigRelative: '.claude/settings.json',
+    },
+    {
+        name: 'cursor',
+        displayName: 'Cursor',
+        detectDir: '.cursor',
+        configFormat: 'json',
+        mcpConfigRelative: '.cursor/mcp.json',
+        globalMcpConfigRelative: '.cursor/mcp.json',
+        supportsHooks: true,
+        hooksConfigRelative: '.cursor/hooks.json',
+    },
+    {
+        name: 'codex',
+        displayName: 'Codex',
+        detectDir: '.codex',
+        configFormat: 'toml',
+        mcpConfigRelative: '.codex/config.toml',
+        globalMcpConfigRelative: '.codex/config.toml',
+        supportsHooks: false,
+    },
+];
+// ============================================
+// Install Mode Detection (REQ-HUB-041)
+// ============================================
+/**
+ * 偵測安裝模式：
+ * - npm mode: __dirname 包含 node_modules → 使用 npx
+ * - local mode: 直接使用 node 執行
+ */
+function detectInstallMode(dirname) {
+    return dirname.includes('node_modules') ? 'npm' : 'local';
+}
+// ============================================
+// Agent Detection (REQ-HUB-041)
+// ============================================
+/**
+ * 偵測已安裝的 Agent（啟發式：檢查 home directory 下是否有對應設定目錄）
+ */
+function detectAgents(homeDir = os.homedir(), cwd = process.cwd()) {
+    const agents = [];
+    for (const def of AGENT_DEFINITIONS) {
+        const detectPath = path.join(homeDir, def.detectDir);
+        if (fs.existsSync(detectPath)) {
+            agents.push({
+                name: def.name,
+                displayName: def.displayName,
+                configFormat: def.configFormat,
+                mcpConfigPath: path.join(cwd, def.mcpConfigRelative),
+                globalMcpConfigPath: path.join(homeDir, def.globalMcpConfigRelative),
+                supportsHooks: def.supportsHooks,
+                hooksConfigPath: def.hooksConfigRelative
+                    ? path.join(cwd, def.hooksConfigRelative)
+                    : undefined,
+            });
+        }
+    }
+    return agents;
+}
+// ============================================
+// Hub Command Resolution
+// ============================================
+/**
+ * 解析 Hub MCP Server 啟動指令（用於寫入 MCP config）
+ */
+function resolveHubCommand(installMode, dirname) {
+    if (installMode === 'npm') {
+        return { command: 'npx', args: ['@hopping-dev/hub'] };
+    }
+    // local mode: 使用絕對路徑指向 dist/index.js
+    const hubRoot = findHubRoot(dirname);
+    return { command: 'node', args: [path.join(hubRoot, 'dist', 'index.js')] };
+}
+/**
+ * 從 CLI 模組的 dirname 往上找到 hub package 根目錄
+ */
+function findHubRoot(dirname) {
+    // dirname 可能是 packages/hub/dist/cli/ 或 packages/hub/src/cli/
+    let current = dirname;
+    for (let i = 0; i < 5; i++) {
+        const pkgJson = path.join(current, 'package.json');
+        if (fs.existsSync(pkgJson)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgJson, 'utf-8'));
+                if (pkg.name === '@hopping-dev/hub') {
+                    return current;
+                }
+            }
+            catch {
+                // ignore parse errors
+            }
+        }
+        current = path.dirname(current);
+    }
+    // fallback: assume 2 levels up from cli/
+    return path.resolve(dirname, '..', '..');
+}
+// ============================================
+// Hook Path Resolution (REQ-HUB-043)
+// ============================================
+/**
+ * 解析 Hook 腳本的絕對路徑
+ */
+function resolveHookPaths(dirname) {
+    const hubRoot = findHubRoot(dirname);
+    // hooks 套件在 monorepo 中與 hub 同層
+    const hooksDir = path.resolve(hubRoot, '..', 'hooks', 'hooks');
+    const adapterDir = path.resolve(hubRoot, '..', 'hooks');
+    return {
+        preHookPath: path.join(hooksDir, 'pre-tool-use.js'),
+        postHookPath: path.join(hooksDir, 'post-tool-use.js'),
+        cursorAdapterPath: path.join(adapterDir, 'cursor-adapter.js'),
+    };
+}
+// ============================================
+// Cross-Platform Hook Commands (REQ-HUB-043)
+// ============================================
+/**
+ * 產生跨平台 Hook command
+ * - Unix: HOPPING_DEV_MODE=<mode> node <hookPath>
+ * - Windows: cmd /c "set HOPPING_DEV_MODE=<mode> && node <hookPath>"
+ */
+function buildPreHookCommand(hookPath, devMode, platform = process.platform) {
+    if (platform === 'win32') {
+        return `cmd /c "set HOPPING_DEV_MODE=${devMode} && node ""${hookPath}"""`;
+    }
+    return `HOPPING_DEV_MODE=${devMode} node "${hookPath}"`;
+}
+/**
+ * PostToolUse hook 不需要 HOPPING_DEV_MODE（純觀測）
+ */
+function buildPostHookCommand(hookPath) {
+    return `node "${hookPath}"`;
+}
+// ============================================
+// Main Resolver
+// ============================================
+/**
+ * 完整路徑解析：偵測安裝模式、Agent、解析所有路徑
+ */
+function resolve(dirname = __dirname, homeDir = os.homedir(), cwd = process.cwd()) {
+    const installMode = detectInstallMode(dirname);
+    const { command, args } = resolveHubCommand(installMode, dirname);
+    const hookPaths = resolveHookPaths(dirname);
+    return {
+        installMode,
+        hubCommand: command,
+        hubArgs: args,
+        preHookPath: hookPaths.preHookPath,
+        postHookPath: hookPaths.postHookPath,
+        cursorAdapterPath: hookPaths.cursorAdapterPath,
+        detectedAgents: detectAgents(homeDir, cwd),
+    };
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/cli/path-resolver.js.map

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

package/dist/cli/setup.d.ts

@@ -0,0 +1,10 @@
+export interface SetupFlags {
+    yes: boolean;
+    dryRun: boolean;
+    scope: 'project' | 'user';
+    skipHooks: boolean;
+    skipSkill: boolean;
+    devMode: string;
+}
+export declare function executeSetup(flags: SetupFlags, dirname?: string): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAwKD,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGhG"}

package/dist/cli/setup.js

@@ -0,0 +1,268 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeSetup = executeSetup;
+/**
+ * Setup CLI — 互動式多 Agent 安裝主流程
+ *
+ * REQ-HUB-044: Setup CLI — Interactive Flow & Skill Auto-Install
+ */
+const readline = __importStar(require("node:readline"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const chalk_1 = __importDefault(require("chalk"));
+const path_resolver_1 = require("./path-resolver");
+const config_writer_1 = require("./config-writer");
+// ============================================
+// Interactive Helpers
+// ============================================
+async function confirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stderr,
+    });
+    return new Promise((done) => {
+        rl.question(`${message} (Y/n) `, (answer) => {
+            rl.close();
+            const trimmed = answer.trim().toLowerCase();
+            done(trimmed === '' || trimmed === 'y' || trimmed === 'yes');
+        });
+    });
+}
+// ============================================
+// Skill Install Helpers
+// ============================================
+function getSkillInstallDir(agentName) {
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
+    switch (agentName) {
+        case 'claude-code':
+            return path.join(home, '.claude', 'skills', 'hopping-skill');
+        case 'cursor':
+            return path.join(home, '.cursor', 'skills', 'hopping-skill');
+        default:
+            return path.join(home, '.claude', 'skills', 'hopping-skill');
+    }
+}
+function getBundledSkillPath(dirname) {
+    // When running from dist/cli/setup.js → assets is at ../../assets
+    const fromDist = path.resolve(dirname, '..', '..', 'assets', 'hopping-skill', 'SKILL.md');
+    if (fs.existsSync(fromDist))
+        return fromDist;
+    // When running from src/cli/setup.ts (dev mode) → assets is at ../../assets
+    const fromSrc = path.resolve(dirname, '..', '..', 'assets', 'hopping-skill', 'SKILL.md');
+    if (fs.existsSync(fromSrc))
+        return fromSrc;
+    // Fallback: monorepo path
+    const monoRepo = path.resolve(dirname, '..', '..', '..', 'skill', 'skills', 'hopping-skill', 'SKILL.md');
+    if (fs.existsSync(monoRepo))
+        return monoRepo;
+    return fromDist; // Will fail with clear error
+}
+function installSkill(agentName, dirname, dryRun) {
+    const targetDir = getSkillInstallDir(agentName);
+    const targetFile = path.join(targetDir, 'SKILL.md');
+    const sourcePath = getBundledSkillPath(dirname);
+    if (dryRun) {
+        return { dir: targetDir, action: 'would write' };
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    fs.copyFileSync(sourcePath, targetFile);
+    return { dir: targetDir, action: fs.existsSync(targetFile) ? 'updated' : 'created' };
+}
+// ============================================
+// Display Plan (REQ-HUB-044)
+// ============================================
+function displayPlan(resolved, flags) {
+    const log = (msg) => {
+        console.error(msg);
+    };
+    log('');
+    log(chalk_1.default.bold.yellow('  HopPing Setup — AI Agent Remote Control'));
+    log('');
+    log(`  Install mode: ${chalk_1.default.cyan(resolved.installMode === 'npm' ? 'npm (npx)' : 'local (monorepo)')}`);
+    if (resolved.detectedAgents.length === 0) {
+        log(chalk_1.default.yellow('  No agents detected. Install Claude Code, Cursor, or Codex first.'));
+        return;
+    }
+    log(`  Detected agents: ${chalk_1.default.cyan(resolved.detectedAgents.map((a) => a.displayName).join(', '))}`);
+    log('');
+    log(chalk_1.default.bold('  Planned changes:'));
+    log('');
+    // 1. MCP Server
+    log(chalk_1.default.bold('  1. MCP Server'));
+    for (const agent of resolved.detectedAgents) {
+        const configPath = flags.scope === 'project' ? agent.mcpConfigPath : agent.globalMcpConfigPath;
+        log(`     ${chalk_1.default.green('+')} ${agent.displayName} ${chalk_1.default.dim(`-> ${configPath}`)}`);
+        log(`       Command: ${resolved.hubCommand} ${resolved.hubArgs.join(' ')}`);
+        log(`       Env: HOPPING_DEV_MODE=${flags.devMode}`);
+    }
+    log('');
+    // 2. Hooks
+    if (!flags.skipHooks) {
+        log(chalk_1.default.bold('  2. Hooks'));
+        for (const agent of resolved.detectedAgents) {
+            if (!agent.supportsHooks) {
+                log(`     ${chalk_1.default.dim('-')} ${agent.displayName} ${chalk_1.default.dim('(not supported)')}`);
+                continue;
+            }
+            if (agent.name === 'cursor' && !(0, config_writer_1.isCursorAdapterReady)(resolved.cursorAdapterPath)) {
+                log(`     ${chalk_1.default.dim('-')} ${agent.displayName} ${chalk_1.default.dim('(skipped: cursor-adapter.js not implemented, see S4-HOOK-CURSOR-001)')}`);
+                continue;
+            }
+            log(`     ${chalk_1.default.green('+')} ${agent.displayName} ${chalk_1.default.dim(`-> ${agent.hooksConfigPath}`)}`);
+            if (agent.name === 'claude-code') {
+                log(`       PreToolUse:  ${(0, path_resolver_1.buildPreHookCommand)(resolved.preHookPath, flags.devMode)}`);
+                log(`       PostToolUse: ${(0, path_resolver_1.buildPostHookCommand)(resolved.postHookPath)}`);
+            }
+            else if (agent.name === 'cursor') {
+                log(`       preToolUse:  node ${resolved.cursorAdapterPath} pre`);
+                log(`       postToolUse: node ${resolved.cursorAdapterPath} post`);
+            }
+        }
+        log('');
+    }
+    // 3. Skill
+    if (!flags.skipSkill) {
+        log(chalk_1.default.bold('  3. Skill (bundled SKILL.md)'));
+        for (const agent of resolved.detectedAgents) {
+            const skillDir = getSkillInstallDir(agent.name);
+            log(`     ${chalk_1.default.green('+')} ${agent.displayName} ${chalk_1.default.dim(`-> ${skillDir}`)}`);
+        }
+        log('');
+    }
+    if (flags.dryRun) {
+        log(chalk_1.default.yellow('  [dry-run] No files will be written.'));
+        log('');
+    }
+}
+// ============================================
+// Execute Setup (REQ-HUB-044)
+// ============================================
+async function executeSetup(flags, dirname = __dirname) {
+    const log = (msg) => {
+        console.error(msg);
+    };
+    // 1. Resolve paths
+    const resolved = (0, path_resolver_1.resolve)(dirname);
+    // 2. Display plan
+    displayPlan(resolved, flags);
+    if (resolved.detectedAgents.length === 0) {
+        log(chalk_1.default.yellow('  No agents detected. Nothing to do.'));
+        process.exitCode = 1;
+        return;
+    }
+    // 3. Confirm
+    if (!flags.yes && !flags.dryRun) {
+        const ok = await confirm(chalk_1.default.bold('  Proceed?'));
+        if (!ok) {
+            log(chalk_1.default.yellow('  Aborted.'));
+            return;
+        }
+        log('');
+    }
+    // Build write options
+    const writeOptions = {
+        hubCommand: resolved.hubCommand,
+        hubArgs: resolved.hubArgs,
+        devMode: flags.devMode,
+        preHookPath: resolved.preHookPath,
+        postHookPath: resolved.postHookPath,
+        cursorAdapterPath: resolved.cursorAdapterPath,
+        scope: flags.scope,
+        skipHooks: flags.skipHooks,
+        dryRun: flags.dryRun,
+    };
+    // 4. Write MCP config per agent
+    for (const agent of resolved.detectedAgents) {
+        const result = await (0, config_writer_1.writeMcpConfig)(agent, writeOptions);
+        const icon = flags.dryRun ? chalk_1.default.dim('[dry-run]') : chalk_1.default.green('  OK');
+        log(`${icon} ${agent.displayName} MCP config ${result.action} (${result.path})`);
+        if (result.backedUp) {
+            log(chalk_1.default.dim(`     backup: ${result.path}.bak`));
+        }
+    }
+    // 5. Write Hooks config per agent
+    if (!flags.skipHooks) {
+        for (const agent of resolved.detectedAgents) {
+            const result = await (0, config_writer_1.writeHooksConfig)(agent, writeOptions);
+            if (result === 'unsupported') {
+                log(chalk_1.default.dim(`  -- ${agent.displayName} hooks: not supported`));
+            }
+            else if (result === null) {
+                if (agent.name === 'cursor') {
+                    log(chalk_1.default.yellow(`  >> ${agent.displayName} hooks: skipped (cursor-adapter.js not implemented, re-run setup after S4-HOOK-CURSOR-001)`));
+                }
+                else {
+                    log(chalk_1.default.dim(`  -- ${agent.displayName} hooks: skipped`));
+                }
+            }
+            else {
+                const icon = flags.dryRun ? chalk_1.default.dim('[dry-run]') : chalk_1.default.green('  OK');
+                log(`${icon} ${agent.displayName} hooks ${result.action} (${result.path})`);
+                if (result.backedUp) {
+                    log(chalk_1.default.dim(`     backup: ${result.path}.bak`));
+                }
+            }
+        }
+    }
+    // 6. Install bundled Skill (SKILL.md) per agent
+    if (!flags.skipSkill) {
+        log('');
+        for (const agent of resolved.detectedAgents) {
+            try {
+                const result = installSkill(agent.name, dirname, flags.dryRun);
+                const icon = flags.dryRun ? chalk_1.default.dim('[dry-run]') : chalk_1.default.green('  OK');
+                log(`${icon} ${agent.displayName} Skill ${result.action} (${result.dir})`);
+            }
+            catch (err) {
+                log(chalk_1.default.yellow(`  !! ${agent.displayName} Skill install failed: ${err}`));
+            }
+        }
+    }
+    // 7. Completion summary
+    log('');
+    log(chalk_1.default.bold.green('  HopPing setup complete!'));
+    log('');
+    log(chalk_1.default.bold('  Next steps:'));
+    log('  1. Start Backend: pnpm --filter backend dev');
+    log('  2. Hub will be auto-started by your Agent (via MCP config)');
+    log('  3. On first launch, scan the QR Code with HopPing mobile app');
+    log('  4. Enjoy your coffee');
+    log('');
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/cloud/connector.d.ts

@@ -0,0 +1,74 @@
+import type { PermissionPromptPayload, AgentStatusPayload, AgentMode, ProgressUpdatePayload, DetailResponsePayload, StatsResponsePayload } from '@hopping/shared';
+import type { SessionMemory } from '../approval/session-memory';
+import type { ApprovalManager } from '../approval/manager';
+import type { HubDatabase } from '../store';
+import type { Logger } from '../utils/logger';
+export interface CloudConnectorOptions {
+    cloudUrl: string;
+    agentToken: string;
+    logger: Logger;
+    approvalManager: ApprovalManager;
+    store?: HubDatabase;
+    connectTimeoutMs?: number;
+    /** YOLO 模式偵測 getter（S4-HUB-YOLO-001）：連線/重連後發送 agent_status 時帶入 agentMode */
+    getAgentMode?: () => AgentMode;
+    /** S4-HUB-DONTASK-001：Session 免審記憶 */
+    sessionMemory?: SessionMemory;
+}
+/**
+ * CloudConnector — Hub 端的 socket.io-client 封裝
+ *
+ * 負責：
+ * 1. 使用 agent token 連接 Cloud Gateway
+ * 2. Hub → Cloud 事件發送（permission_prompt, agent_status, progress_update, detail_response, stats_response）
+ * 3. Cloud → Hub 事件接收（permission_response, detail_request, stats_request, command）
+ * 4. 優雅降級：連線失敗不阻擋 MCP Server 運行
+ */
+export declare class CloudConnector {
+    private socket;
+    private _connected;
+    private logger;
+    private approvalManager;
+    private store?;
+    private connectTimeoutMs;
+    /** YOLO 模式偵測 getter（可選） */
+    private getAgentMode?;
+    /** ENH-YOLO-002：記住 YOLO 進入時間，避免重連時重置 Mobile 計時器 */
+    private _yoloEnteredAt?;
+    /** S4-HUB-DONTASK-001：Session 免審記憶 */
+    private sessionMemory?;
+    /** Cloud 認證後回傳的 agentId（Cloud DB 中的 UUID） */
+    private _agentId?;
+    /** Cloud 認證後回傳的 agentName */
+    private _agentName?;
+    constructor(options: CloudConnectorOptions);
+    /**
+     * 連接 Cloud Gateway 並等待認證結果
+     *
+     * - 成功：_connected = true（由持久 authenticated listener 設定）
+     * - 失敗/超時：_connected = false，不 throw（Hub 降級為純本地模式）
+     *
+     * 注意：自動重連由 socket.io 在背景持續嘗試，connect() 僅處理初始握手超時。
+     */
+    connect(): Promise<void>;
+    /**
+     * 斷開連線並清理資源
+     */
+    disconnect(): Promise<void>;
+    get isConnected(): boolean;
+    get cloudAgentId(): string | undefined;
+    get cloudAgentName(): string | undefined;
+    sendPermissionPrompt(payload: PermissionPromptPayload): void;
+    sendAgentStatus(payload: AgentStatusPayload): void;
+    sendProgressUpdate(payload: ProgressUpdatePayload): void;
+    sendDetailResponse(payload: DetailResponsePayload): void;
+    sendStatsResponse(payload: StatsResponsePayload): void;
+    private bindEventListeners;
+    private handlePermissionResponse;
+    private sendDetailError;
+    private handleDetailRequest;
+    private calculateDateRange;
+    private handleStatsRequest;
+    private handleCommand;
+}
+//# sourceMappingURL=connector.d.ts.map

package/dist/cloud/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/cloud/connector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,uBAAuB,EACvB,kBAAkB,EAClB,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EAErB,oBAAoB,EAQrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAO9C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,eAAe,CAAC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,SAAS,CAAC;IAC/B,sCAAsC;IACtC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AA+BD;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,gBAAgB,CAAS;IACjC,2BAA2B;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAkB;IACvC,mDAAmD;IACnD,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,sCAAsC;IACtC,OAAO,CAAC,aAAa,CAAC,CAAgB;IAEtC,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,CAAS;IAE1B,6BAA6B;IAC7B,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,OAAO,EAAE,qBAAqB;IAuB1C;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED,IAAI,cAAc,IAAI,MAAM,GAAG,SAAS,CAEvC;IAID,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAY5D,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAYlD,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAWxD,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAWxD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAatD,OAAO,CAAC,kBAAkB;IA2G1B,OAAO,CAAC,wBAAwB;IAgDhC,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,mBAAmB;IA0D3B,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,kBAAkB;IAuE1B,OAAO,CAAC,aAAa;CAoEtB"}