weixin-devtools-mcp 0.0.1 → 0.1.0

package/build/connection/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/connection/adapters.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAqLpB,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAoBlC"}

package/build/connection/adapters.js

@@ -0,0 +1,134 @@
+import automator from 'miniprogram-automator';
+import { connectDevtoolsEnhanced, detectIDEPort, } from '../tools.js';
+import { EnvironmentConnectionError, ProtocolConnectionError, SessionConflictConnectionError, } from './errors.js';
+function extractMessage(error) {
+    return error.message.toLowerCase();
+}
+function buildEnhancedOptions(request, mode) {
+    return {
+        projectPath: request.projectPath ?? '',
+        mode,
+        cliPath: request.cliPath,
+        autoPort: request.autoPort,
+        timeout: request.timeoutMs,
+        fallbackMode: request.fallback.length > 0,
+        healthCheck: false,
+        verbose: request.verbose,
+        autoAudits: request.autoAudits,
+    };
+}
+function ensurePagePath(pagePath) {
+    if (!pagePath) {
+        throw new ProtocolConnectionError('连接成功但当前页面路径为空', [
+            '请确认开发者工具中项目已成功打开',
+        ]);
+    }
+    return pagePath;
+}
+async function connectByEnhancedMode(request, strategy) {
+    try {
+        const result = await connectDevtoolsEnhanced(buildEnhancedOptions(request, strategy));
+        const endpoint = result.processInfo?.port
+            ? `ws://127.0.0.1:${result.processInfo.port}`
+            : null;
+        const pagePath = ensurePagePath(result.pagePath);
+        return {
+            strategyUsed: strategy,
+            endpoint,
+            miniProgram: result.miniProgram,
+            currentPage: result.currentPage,
+            pagePath,
+        };
+    }
+    catch (error) {
+        const baseError = error instanceof Error ? error : new Error(String(error));
+        const message = extractMessage(baseError);
+        if (message.includes('session') || message.includes('already') || message.includes('conflict')) {
+            throw new SessionConflictConnectionError(baseError.message, undefined, baseError);
+        }
+        throw new EnvironmentConnectionError(baseError.message, 'connect', ['检查 projectPath、cliPath 与微信开发者工具启动状态'], { strategy }, baseError);
+    }
+}
+async function connectByWsEndpoint(request, wsEndpoint, strategyUsed) {
+    try {
+        const miniProgram = await automator.connect({ wsEndpoint, timeout: request.timeoutMs });
+        const currentPage = await miniProgram.currentPage();
+        if (!currentPage) {
+            throw new ProtocolConnectionError('wsEndpoint 已连接但 currentPage 不可用', [
+                '确认目标 DevTools 实例已打开小程序项目',
+            ]);
+        }
+        const pagePath = ensurePagePath(await currentPage.path);
+        return {
+            strategyUsed,
+            endpoint: wsEndpoint,
+            miniProgram,
+            currentPage,
+            pagePath,
+        };
+    }
+    catch (error) {
+        const baseError = error instanceof Error ? error : new Error(String(error));
+        throw new ProtocolConnectionError(baseError.message, ['确认 wsEndpoint 可访问，且端点属于微信开发者工具自动化端口'], { wsEndpoint, strategy: strategyUsed }, baseError);
+    }
+}
+function parseWebSocketDebuggerUrl(payload) {
+    const endpoint = payload.webSocketDebuggerUrl ?? payload.websocketDebuggerUrl;
+    if (!endpoint) {
+        throw new EnvironmentConnectionError('browserUrl 未返回 webSocketDebuggerUrl', 'connect', ['确认目标地址支持 /json/version 并开启远程调试']);
+    }
+    return endpoint;
+}
+async function resolveWsEndpointByBrowserUrl(browserUrl, timeoutMs) {
+    const normalizedBase = browserUrl.endsWith('/') ? browserUrl.slice(0, -1) : browserUrl;
+    const versionUrl = `${normalizedBase}/json/version`;
+    let response;
+    try {
+        response = await fetch(versionUrl, {
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+    }
+    catch (error) {
+        const baseError = error instanceof Error ? error : new Error(String(error));
+        throw new EnvironmentConnectionError(`请求 browserUrl 失败: ${baseError.message}`, 'connect', ['确认 browserUrl 可访问，例如 http://127.0.0.1:9222'], { browserUrl }, baseError);
+    }
+    if (!response.ok) {
+        throw new EnvironmentConnectionError(`browserUrl 返回非成功状态: ${response.status}`, 'connect', ['确认远程调试服务已开启并允许访问 /json/version'], { browserUrl, status: response.status });
+    }
+    const payload = await response.json();
+    return parseWebSocketDebuggerUrl(payload);
+}
+async function connectByBrowserUrl(request, browserUrl) {
+    const endpoint = await resolveWsEndpointByBrowserUrl(browserUrl, request.timeoutMs);
+    return connectByWsEndpoint(request, endpoint, 'browserUrl');
+}
+async function connectByDiscover(request) {
+    const port = await detectIDEPort(request.verbose);
+    if (port === null) {
+        throw new EnvironmentConnectionError('自动发现失败：未检测到可用的微信开发者工具自动化端口', 'startup', [
+            '先在微信开发者工具中开启自动化能力',
+            '改用 strategy=launch 并传入 projectPath',
+        ]);
+    }
+    const endpoint = `ws://127.0.0.1:${port}`;
+    return connectByWsEndpoint(request, endpoint, 'discover');
+}
+export async function executeConnectionStrategy(strategy, request) {
+    if (strategy === 'auto' || strategy === 'launch' || strategy === 'connect') {
+        return connectByEnhancedMode(request, strategy);
+    }
+    if (strategy === 'wsEndpoint') {
+        if (!request.wsEndpoint) {
+            throw new EnvironmentConnectionError('wsEndpoint 策略缺少 wsEndpoint 参数', 'resolve');
+        }
+        return connectByWsEndpoint(request, request.wsEndpoint, strategy);
+    }
+    if (strategy === 'browserUrl') {
+        if (!request.browserUrl) {
+            throw new EnvironmentConnectionError('browserUrl 策略缺少 browserUrl 参数', 'resolve');
+        }
+        return connectByBrowserUrl(request, request.browserUrl);
+    }
+    return connectByDiscover(request);
+}
+//# sourceMappingURL=adapters.js.map

package/build/connection/adapters.js.map

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

package/build/connection/errors.d.ts

@@ -0,0 +1,34 @@
+import type { ConnectionErrorSummary, ConnectionPhase, MetadataValue } from './types.js';
+export type ConnectionErrorCode = 'INVALID_ARGUMENT' | 'ENVIRONMENT' | 'SESSION_CONFLICT' | 'PROTOCOL' | 'HEALTH_CHECK_FAILED' | 'CONNECTION_FAILED' | 'DISCONNECTED';
+export interface ConnectionErrorOptions {
+    code: ConnectionErrorCode;
+    phase: ConnectionPhase;
+    suggestions?: string[];
+    metadata?: Record<string, MetadataValue>;
+    cause?: Error;
+}
+export declare class ConnectionError extends Error {
+    readonly code: ConnectionErrorCode;
+    readonly phase: ConnectionPhase;
+    readonly suggestions: string[];
+    readonly metadata?: Record<string, MetadataValue>;
+    constructor(message: string, options: ConnectionErrorOptions);
+    toSummary(): ConnectionErrorSummary;
+}
+export declare class ValidationConnectionError extends ConnectionError {
+    constructor(message: string, suggestions?: string[], metadata?: Record<string, MetadataValue>);
+}
+export declare class EnvironmentConnectionError extends ConnectionError {
+    constructor(message: string, phase: Extract<ConnectionPhase, 'startup' | 'connect' | 'resolve'>, suggestions?: string[], metadata?: Record<string, MetadataValue>, cause?: Error);
+}
+export declare class ProtocolConnectionError extends ConnectionError {
+    constructor(message: string, suggestions?: string[], metadata?: Record<string, MetadataValue>, cause?: Error);
+}
+export declare class SessionConflictConnectionError extends ConnectionError {
+    constructor(message: string, metadata?: Record<string, MetadataValue>, cause?: Error);
+}
+export declare class HealthCheckConnectionError extends ConnectionError {
+    constructor(message: string, metadata?: Record<string, MetadataValue>, cause?: Error);
+}
+export declare function normalizeConnectionError(error: Error | ConnectionError): ConnectionError;
+//# sourceMappingURL=errors.d.ts.map

package/build/connection/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/connection/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,aAAa,GACb,kBAAkB,GAClB,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB;IAS5D,SAAS,IAAI,sBAAsB;CAUpC;AAED,qBAAa,yBAA0B,SAAQ,eAAe;gBAE1D,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;CAU3C;AAED,qBAAa,0BAA2B,SAAQ,eAAe;gBAE3D,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,EAClE,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACxC,KAAK,CAAC,EAAE,KAAK;CAWhB;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAExD,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACxC,KAAK,CAAC,EAAE,KAAK;CAWhB;AAED,qBAAa,8BAA+B,SAAQ,eAAe;gBACrD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK;CAarF;AAED,qBAAa,0BAA2B,SAAQ,eAAe;gBACjD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK;CAarF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,GAAG,eAAe,CAWxF"}

package/build/connection/errors.js

@@ -0,0 +1,101 @@
+export class ConnectionError extends Error {
+    code;
+    phase;
+    suggestions;
+    metadata;
+    constructor(message, options) {
+        super(message, options.cause ? { cause: options.cause } : undefined);
+        this.name = 'ConnectionError';
+        this.code = options.code;
+        this.phase = options.phase;
+        this.suggestions = options.suggestions ?? [];
+        this.metadata = options.metadata;
+    }
+    toSummary() {
+        return {
+            code: this.code,
+            phase: this.phase,
+            message: this.message,
+            suggestions: this.suggestions,
+            metadata: this.metadata,
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+export class ValidationConnectionError extends ConnectionError {
+    constructor(message, suggestions, metadata) {
+        super(message, {
+            code: 'INVALID_ARGUMENT',
+            phase: 'resolve',
+            suggestions,
+            metadata,
+        });
+        this.name = 'ValidationConnectionError';
+    }
+}
+export class EnvironmentConnectionError extends ConnectionError {
+    constructor(message, phase, suggestions, metadata, cause) {
+        super(message, {
+            code: 'ENVIRONMENT',
+            phase,
+            suggestions,
+            metadata,
+            cause,
+        });
+        this.name = 'EnvironmentConnectionError';
+    }
+}
+export class ProtocolConnectionError extends ConnectionError {
+    constructor(message, suggestions, metadata, cause) {
+        super(message, {
+            code: 'PROTOCOL',
+            phase: 'connect',
+            suggestions,
+            metadata,
+            cause,
+        });
+        this.name = 'ProtocolConnectionError';
+    }
+}
+export class SessionConflictConnectionError extends ConnectionError {
+    constructor(message, metadata, cause) {
+        super(message, {
+            code: 'SESSION_CONFLICT',
+            phase: 'startup',
+            suggestions: [
+                '关闭当前微信开发者工具窗口后重试',
+                '切换到 wsEndpoint 或 discover 策略复用现有会话',
+            ],
+            metadata,
+            cause,
+        });
+        this.name = 'SessionConflictConnectionError';
+    }
+}
+export class HealthCheckConnectionError extends ConnectionError {
+    constructor(message, metadata, cause) {
+        super(message, {
+            code: 'HEALTH_CHECK_FAILED',
+            phase: 'health_check',
+            suggestions: [
+                '检查开发者工具是否仍在运行',
+                '使用 reconnect_devtools 重新建立连接',
+            ],
+            metadata,
+            cause,
+        });
+        this.name = 'HealthCheckConnectionError';
+    }
+}
+export function normalizeConnectionError(error) {
+    if (error instanceof ConnectionError) {
+        return error;
+    }
+    return new ConnectionError(error.message, {
+        code: 'CONNECTION_FAILED',
+        phase: 'connect',
+        suggestions: ['请检查连接参数并重试'],
+        cause: error,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/build/connection/errors.js.map

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

package/build/connection/health-probe.d.ts

@@ -0,0 +1,4 @@
+import type { MiniProgram } from 'miniprogram-automator';
+import type { ConnectionHealth } from './types.js';
+export declare function probeConnectionHealth(miniProgram: MiniProgram): Promise<ConnectionHealth>;
+//# sourceMappingURL=health-probe.d.ts.map

package/build/connection/health-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-probe.d.ts","sourceRoot":"","sources":["../../src/connection/health-probe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAwCpB,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+B/F"}

package/build/connection/health-probe.js

@@ -0,0 +1,60 @@
+async function runCheck(name, execute) {
+    const start = Date.now();
+    try {
+        const result = await execute();
+        return {
+            name,
+            status: result.passed ? 'pass' : 'fail',
+            message: result.message,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name,
+            status: 'fail',
+            message,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+function resolveLevel(checks) {
+    const failures = checks.filter(check => check.status === 'fail').length;
+    if (failures === 0) {
+        return 'healthy';
+    }
+    const transportCheck = checks.find(check => check.name === 'transport');
+    if (!transportCheck || transportCheck.status === 'fail') {
+        return 'unhealthy';
+    }
+    return 'degraded';
+}
+export async function probeConnectionHealth(miniProgram) {
+    const checks = [];
+    checks.push(await runCheck('transport', async () => {
+        await miniProgram.evaluate(() => true);
+        return { passed: true, message: 'evaluate 调用成功' };
+    }));
+    let pagePath = '';
+    checks.push(await runCheck('session', async () => {
+        const page = await miniProgram.currentPage();
+        if (!page) {
+            return { passed: false, message: 'currentPage 为空' };
+        }
+        pagePath = await page.path;
+        return { passed: true, message: 'currentPage 可访问' };
+    }));
+    checks.push(await runCheck('page', async () => {
+        if (!pagePath) {
+            return { passed: false, message: '页面路径为空' };
+        }
+        return { passed: true, message: `当前页面: ${pagePath}` };
+    }));
+    return {
+        level: resolveLevel(checks),
+        checks,
+        checkedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=health-probe.js.map

package/build/connection/health-probe.js.map

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

package/build/connection/index.d.ts

@@ -0,0 +1,6 @@
+export { ConnectionManager } from './manager.js';
+export { probeConnectionHealth } from './health-probe.js';
+export { resolveConnectionPlan } from './resolver.js';
+export * from './errors.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/connection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/build/connection/index.js

@@ -0,0 +1,6 @@
+export { ConnectionManager } from './manager.js';
+export { probeConnectionHealth } from './health-probe.js';
+export { resolveConnectionPlan } from './resolver.js';
+export * from './errors.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/build/connection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/build/connection/manager.d.ts

@@ -0,0 +1,19 @@
+import type { MiniProgram, Page } from 'miniprogram-automator';
+import { type ConnectionConnectResult, type ConnectionErrorSummary, type ConnectionRequest, type ConnectionStatusSnapshot, type ResolvedConnectionRequest } from './types.js';
+interface StoredSession {
+    miniProgram: MiniProgram;
+    currentPage: Page;
+}
+export declare class ConnectionManager {
+    #private;
+    getSession(): StoredSession | null;
+    getStatusSnapshot(): ConnectionStatusSnapshot;
+    getLastRequest(): ResolvedConnectionRequest | null;
+    connect(request: ConnectionRequest): Promise<ConnectionConnectResult>;
+    reconnect(request?: ConnectionRequest): Promise<ConnectionConnectResult>;
+    disconnect(): Promise<ConnectionStatusSnapshot>;
+    refreshHealth(): Promise<ConnectionStatusSnapshot>;
+    markDisconnectedWithError(error: ConnectionErrorSummary): ConnectionStatusSnapshot;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/build/connection/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/connection/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAY/D,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAEpB,UAAU,aAAa;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,IAAI,CAAC;CACnB;AAmBD,qBAAa,iBAAiB;;IAK5B,UAAU,IAAI,aAAa,GAAG,IAAI;IAIlC,iBAAiB,IAAI,wBAAwB;IAI7C,cAAc,IAAI,yBAAyB,GAAG,IAAI;IAI5C,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgGrE,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAcxE,UAAU,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAwB/C,aAAa,IAAI,OAAO,CAAC,wBAAwB,CAAC;IA0CxD,yBAAyB,CAAC,KAAK,EAAE,sBAAsB,GAAG,wBAAwB;CAQnF"}

package/build/connection/manager.js

@@ -0,0 +1,198 @@
+import { executeConnectionStrategy } from './adapters.js';
+import { HealthCheckConnectionError, ValidationConnectionError, normalizeConnectionError, } from './errors.js';
+import { probeConnectionHealth } from './health-probe.js';
+import { resolveConnectionPlan } from './resolver.js';
+import { createDisconnectedStatus, } from './types.js';
+function createConnectionId() {
+    return `conn_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function cloneStatus(status) {
+    return {
+        ...status,
+        health: status.health
+            ? {
+                ...status.health,
+                checks: status.health.checks.map(check => ({ ...check })),
+            }
+            : null,
+        lastError: status.lastError ? { ...status.lastError } : null,
+    };
+}
+export class ConnectionManager {
+    #session = null;
+    #status = createDisconnectedStatus();
+    #lastRequest = null;
+    getSession() {
+        return this.#session;
+    }
+    getStatusSnapshot() {
+        return cloneStatus(this.#status);
+    }
+    getLastRequest() {
+        return this.#lastRequest ? { ...this.#lastRequest, fallback: [...this.#lastRequest.fallback] } : null;
+    }
+    async connect(request) {
+        const plan = resolveConnectionPlan(request);
+        this.#status = {
+            ...this.#status,
+            state: 'connecting',
+            connected: false,
+            strategyUsed: null,
+            endpoint: null,
+            lastError: null,
+        };
+        const startedAt = Date.now();
+        const warnings = [];
+        let latestError = null;
+        for (const strategy of plan.attempts) {
+            const attemptStartedAt = Date.now();
+            try {
+                const adapterResult = await executeConnectionStrategy(strategy, plan.request);
+                const connectMs = Date.now() - attemptStartedAt;
+                const healthStart = Date.now();
+                const health = plan.request.healthCheck
+                    ? await probeConnectionHealth(adapterResult.miniProgram)
+                    : {
+                        level: 'healthy',
+                        checks: [],
+                        checkedAt: new Date().toISOString(),
+                    };
+                if (health.level === 'unhealthy') {
+                    throw new HealthCheckConnectionError('连接后健康检查失败', {
+                        strategy,
+                        endpoint: adapterResult.endpoint,
+                    });
+                }
+                const connectionId = createConnectionId();
+                const totalMs = Date.now() - startedAt;
+                const healthMs = Date.now() - healthStart;
+                const pagePath = adapterResult.pagePath;
+                const status = health.level === 'healthy' ? 'connected' : 'degraded';
+                this.#session = {
+                    miniProgram: adapterResult.miniProgram,
+                    currentPage: adapterResult.currentPage,
+                };
+                this.#lastRequest = {
+                    ...plan.request,
+                    strategy,
+                    fallback: plan.request.fallback.filter(item => item !== strategy),
+                };
+                this.#status = {
+                    connectionId,
+                    state: status,
+                    strategyUsed: adapterResult.strategyUsed,
+                    endpoint: adapterResult.endpoint,
+                    connected: true,
+                    hasCurrentPage: pagePath.length > 0,
+                    pagePath,
+                    health,
+                    lastError: null,
+                    lastConnectedAt: new Date().toISOString(),
+                    lastHealthCheckAt: health.checkedAt,
+                };
+                return {
+                    ...adapterResult,
+                    connectionId,
+                    health,
+                    status,
+                    timing: {
+                        totalMs,
+                        connectMs,
+                        healthMs,
+                    },
+                    warnings,
+                };
+            }
+            catch (error) {
+                latestError = normalizeConnectionError(error instanceof Error ? error : new Error(String(error)));
+                warnings.push(`[${strategy}] ${latestError.message}`);
+            }
+        }
+        if (!latestError) {
+            latestError = new ValidationConnectionError('未执行任何连接尝试');
+        }
+        this.#session = null;
+        this.#status = {
+            ...createDisconnectedStatus(),
+            lastError: latestError.toSummary(),
+        };
+        throw latestError;
+    }
+    async reconnect(request) {
+        const baseRequest = request ?? this.#lastRequest;
+        if (!baseRequest) {
+            throw new ValidationConnectionError('没有可用于重连的历史连接参数', ['调用 reconnect_devtools 时显式传入连接参数']);
+        }
+        await this.disconnect();
+        await new Promise(resolve => setTimeout(resolve, 300));
+        return this.connect(baseRequest);
+    }
+    async disconnect() {
+        if (this.#session?.miniProgram) {
+            const miniProgram = this.#session.miniProgram;
+            try {
+                miniProgram.removeAllListeners('console');
+                miniProgram.removeAllListeners('exception');
+            }
+            catch {
+                // 忽略监听器清理异常
+            }
+            try {
+                await miniProgram.disconnect();
+            }
+            catch {
+                // 忽略断连异常，始终清理本地状态
+            }
+            await new Promise(resolve => setTimeout(resolve, 200));
+        }
+        this.#session = null;
+        this.#status = createDisconnectedStatus();
+        return this.getStatusSnapshot();
+    }
+    async refreshHealth() {
+        if (!this.#session) {
+            this.#status = createDisconnectedStatus();
+            return this.getStatusSnapshot();
+        }
+        const health = await probeConnectionHealth(this.#session.miniProgram);
+        const levelToState = {
+            healthy: 'connected',
+            degraded: 'degraded',
+            unhealthy: 'disconnected',
+        };
+        if (health.level === 'unhealthy') {
+            this.#session = null;
+            this.#status = {
+                ...createDisconnectedStatus(),
+                lastError: {
+                    code: 'HEALTH_CHECK_FAILED',
+                    phase: 'health_check',
+                    message: '连接健康检查失败，已自动标记为断开',
+                    suggestions: ['调用 connect_devtools 或 reconnect_devtools 重新建立连接'],
+                    timestamp: new Date().toISOString(),
+                },
+            };
+            return this.getStatusSnapshot();
+        }
+        const pagePath = this.#session.currentPage ? await this.#session.currentPage.path : null;
+        this.#status = {
+            ...this.#status,
+            state: levelToState[health.level],
+            connected: true,
+            hasCurrentPage: !!pagePath,
+            pagePath,
+            health,
+            lastHealthCheckAt: health.checkedAt,
+        };
+        return this.getStatusSnapshot();
+    }
+    markDisconnectedWithError(error) {
+        this.#session = null;
+        this.#status = {
+            ...createDisconnectedStatus(),
+            lastError: error,
+        };
+        return this.getStatusSnapshot();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/build/connection/manager.js.map

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

package/build/connection/resolver.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectionRequest, ResolvedConnectionPlan } from './types.js';
+export declare function resolveConnectionPlan(rawRequest: ConnectionRequest): ResolvedConnectionPlan;
+//# sourceMappingURL=resolver.d.ts.map

package/build/connection/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/connection/resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAEjB,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AA0GpB,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,GAAG,sBAAsB,CA4B3F"}