weapp-ide-cli 6.1.9 → 6.2.0

package/dist/index.d.ts

@@ -1,22 +1,77 @@
+import { AutomatorElement, AutomatorMiniProgram, AutomatorPage, DevtoolsConnectionInput, DevtoolsContext, DevtoolsElementSnapshot, DevtoolsPageSnapshot, DevtoolsRuntimeSessionOptions, DevtoolsToolResult, MachineE2ELeaseRecoveryScope, MiniProgramEventMap, closeSharedMiniProgram, getSharedMiniProgramSessionCount, readDevtoolsElementSnapshot as readElementSnapshot, releaseSharedMiniProgram, resolveDevtoolsProjectPath as resolveProjectPath, toDevtoolsSerializableValue as toSerializableValue } from "@weapp-vite/devtools-runtime";
 import { Buffer } from "node:buffer";
-import { AutomatorElement, AutomatorMiniProgram, AutomatorPage, DevtoolsConnectionInput, DevtoolsContext, DevtoolsElementSnapshot, DevtoolsPageSnapshot, DevtoolsRuntimeSessionOptions, DevtoolsToolResult, MiniProgramEventMap, closeSharedMiniProgram, getSharedMiniProgramSessionCount, readDevtoolsElementSnapshot as readElementSnapshot, releaseSharedMiniProgram, resolveDevtoolsProjectPath as resolveProjectPath, toDevtoolsSerializableValue as toSerializableValue } from "@weapp-vite/devtools-runtime";
+import { OperationLifecycle } from "@weapp-vite/miniprogram-automator/operation";
+import { MiniProgram } from "@weapp-vite/miniprogram-automator";
 import { McpServer } from "@modelcontextprotocol/server";
-//#region src/cli/automator.d.ts
-export interface AutomatorOptions {
-  projectPath: string;
+//#region src/devtoolsTarget/metadata.d.ts
+interface WechatDevtoolsMetadata {
+  version?: string;
+  channel?: 'stable' | 'rc' | 'nightly' | 'unknown';
+}
+//#endregion
+//#region src/devtoolsTarget/profile.d.ts
+interface WechatDevtoolsProfileOptions {
+  homeDir?: string;
+  localAppDataDir?: string;
+  platform?: NodeJS.Platform;
+}
+//#endregion
+//#region src/devtoolsTarget/host.d.ts
+interface WechatDevtoolsHostInspectionOptions {
+  platform?: NodeJS.Platform;
+  signal?: AbortSignal;
   timeout?: number;
+}
+/** 启动前验证共享宿主身份；无活跃宿主可以继续，其他安装不得被隐式接管。 */
+export declare function assertWechatDevtoolsHost(target: ResolvedWechatDevtoolsTarget, options?: WechatDevtoolsHostInspectionOptions): Promise<void>;
+/** HTTP 与 WebSocket 的显式端口均需由所选安装持有，端口号本身不是宿主身份。 */
+export declare function assertWechatDevtoolsPort(target: ResolvedWechatDevtoolsTarget, port: number, options?: WechatDevtoolsHostInspectionOptions): Promise<void>;
+//#endregion
+//#region src/devtoolsTarget/index.d.ts
+export interface ResolvedWechatDevtoolsTarget extends WechatDevtoolsMetadata {
+  cliPath: string;
+  installationId: string;
+  appPath: string;
+  profileDir: string;
+}
+export interface ResolveWechatDevtoolsTargetOptions extends WechatDevtoolsProfileOptions {
   cliPath?: string;
-  port?: number;
-  sessionId?: string;
+  target?: ResolvedWechatDevtoolsTarget;
+}
+/** 一次解析 CLI、应用身份及配置目录，供本次操作的所有阶段共同使用。 */
+export declare function resolveWechatDevtoolsTarget(options?: ResolveWechatDevtoolsTargetOptions): Promise<ResolvedWechatDevtoolsTarget>;
+//#endregion
+//#region src/cli/agentStart.d.ts
+export interface StartWechatIdeAgentOptions {
+  projectPath: string;
+  port: number;
+  cliPath?: string;
+  target?: ResolvedWechatDevtoolsTarget;
   trustProject?: boolean;
-  preferOpenedSession?: boolean;
-  preserveProjectRoot?: boolean;
-  persistAsDefaultSession?: boolean;
+  timeout?: number;
+  signal?: AbortSignal;
+  /** 官方回执验证后先登记窗口所有权，再检查取消状态。 */
+  onStarted?: (result: StartWechatIdeAgentResult) => void | Promise<void>;
 }
-/**
- * @description 为项目路径派生稳定的 DevTools automator 端口，避免多个 dev:open 项目抢占默认端口。
- */
-export declare function resolveProjectAutomatorPort(projectPath: string): number;
+export interface StartWechatIdeAgentResult {
+  autoPort: number;
+  openedProjectWindow: boolean;
+  version: string;
+}
+/** 使用所选安装的官方 agent start，并保留其窗口复用和端口冲突语义。 */
+export declare function startWechatIdeAgent(options: StartWechatIdeAgentOptions): Promise<StartWechatIdeAgentResult>;
+//#endregion
+//#region src/cli/automator/context.d.ts
+interface AutomatorInstallationOptions extends DevtoolsRuntimeSessionOptions {
+  target?: ResolvedWechatDevtoolsTarget;
+  signal?: AbortSignal;
+}
+/** 在连接与共享缓存入口固定安装选择；headless 不读取或修改 IDE 状态。 */
+export declare function resolveAutomatorSessionOptions<T extends AutomatorInstallationOptions>(options: T): Promise<T & AutomatorInstallationOptions & {
+  installationId: string;
+}>;
+//#endregion
+//#region src/cli/automator/errors.d.ts
 /**
  * @description 判断错误是否属于开发者工具服务端口不可用。
  */
@@ -53,17 +108,42 @@ export declare function isAutomatorLoginError(error: unknown): boolean;
  * @description 格式化开发者工具登录失效错误，便于终端展示。
  */
 export declare function formatAutomatorLoginError(error: unknown): string;
+//#endregion
+//#region src/cli/automator.d.ts
+export interface AutomatorOptions extends AutomatorInstallationOptions {
+  projectPath: string;
+  timeout?: number;
+  signal?: AbortSignal;
+  cliPath?: string;
+  port?: number;
+  sessionId?: string;
+  trustProject?: boolean;
+  preferOpenedSession?: boolean;
+  preserveProjectRoot?: boolean;
+  persistAsDefaultSession?: boolean;
+}
+/**
+ * @description 为项目路径派生稳定的 DevTools automator 端口，避免多个 dev:open 项目抢占默认端口。
+ */
+export declare function resolveProjectAutomatorPort(projectPath: string): number;
 /**
  * @description 基于当前配置解析 CLI 路径，并通过现代化 automator 入口启动会话。
  */
 export declare function launchAutomator(options: AutomatorOptions): Promise<any>;
 /**
- * @description 连接当前项目已打开的开发者工具自动化会话，不触发新的 IDE 拉起。
+ * @description 登记由外部 automator bridge 创建的会话，供 CLI 子进程安全复用。
+ */
+export declare function persistOpenedAutomatorSession(options: AutomatorOptions & {
+  wsEndpoint: string;
+}): Promise<void>;
+/**
+ * @description 只读连接当前项目已打开的自动化会话；失败不证明缓存过期，也不删除其他操作持有的会话记录。
  */
-export declare function connectOpenedAutomator(options: AutomatorOptions): Promise<unknown>;
+export declare function connectOpenedAutomator(options: AutomatorOptions): Promise<MiniProgram>;
 //#endregion
 //#region src/cli/automator-argv.d.ts
 export interface ParsedAutomatorArgs {
+  cliPath?: string;
   projectPath: string;
   timeout?: number;
   port?: number;
@@ -93,7 +173,10 @@ export declare function removeOption(argv: readonly string[], optionName: string
 type MiniProgramLike = AutomatorMiniProgram;
 type MiniProgramPage = AutomatorPage;
 type MiniProgramElement = AutomatorElement;
-interface AutomatorSessionOptions extends DevtoolsRuntimeSessionOptions {}
+interface AutomatorSessionOptions extends DevtoolsRuntimeSessionOptions {
+  signal?: AbortSignal;
+  target?: ResolvedWechatDevtoolsTarget;
+}
 /** 建立交互式会话，并报告最终连接错误。 */
 export declare function connectMiniProgram(options: AutomatorSessionOptions): Promise<MiniProgramLike>;
 /**
@@ -248,6 +331,8 @@ export declare function handleConfigCommand(argv: string[]): Promise<void>;
 //#endregion
 //#region src/cli/http.d.ts
 export interface WechatDevtoolsHttpCommandOptions {
+  cliPath?: string;
+  target?: ResolvedWechatDevtoolsTarget;
   port?: number;
   signal?: AbortSignal;
   timeoutMs?: number;
@@ -264,9 +349,10 @@ export interface PollWechatIdeEngineBuildResult extends WechatDevtoolsEngineBuil
   done: boolean;
   failed: boolean;
 }
+/** 请求期间持有机器租约，避免 E2E 与另一入口同时更改共享宿主。 */
 export declare function requestWechatDevtoolsHttp(pathname: string, query: Record<string, string>, options?: WechatDevtoolsHttpCommandOptions): Promise<string>;
 /**
- * @description 通过微信开发者工具 HTTP 服务端口重新打开项目；若项目已打开，开发者工具会刷新当前项目。
+ * @description 请求微信开发者工具打开项目并返回原始响应；目标 runtime 状态仍需通过会话或界面确认。
  */
 export declare function openWechatIdeProjectByHttp(projectPath: string, options?: WechatDevtoolsHttpCommandOptions): Promise<string>;
 /**
@@ -297,17 +383,19 @@ export interface RunWechatIdeEngineBuildByHttpOptions extends WechatDevtoolsHttp
 }
 export interface RunWechatIdeEngineBuildOptions extends RunWechatIdeEngineBuildByHttpOptions {
   fallbackToCli?: boolean;
+  /** 避免 CLI 诊断污染协议标准输出。 */
+  quiet?: boolean;
   logPath?: string;
 }
 export declare function isWechatIdeEngineBuildEndpointMissingError(error: unknown): boolean;
-/**
- * @description 通过开发者工具 HTTP 服务端口执行 engine build，并轮询直到构建结束。
- */
+/** 固定安装上下文后完整持有 HTTP 构建与轮询期间的租约。 */
 export declare function runWechatIdeEngineBuildByHttp(projectPath: string, options?: RunWechatIdeEngineBuildByHttpOptions): Promise<PollWechatIdeEngineBuildResult>;
-/**
- * @description 以更接近官方 CLI 的方式执行 engine build，并支持将构建日志写入文件。
- */
+/** HTTP、轮询与 CLI 回退沿用同一次解析的安装。 */
 export declare function runWechatIdeEngineBuild(projectPath: string, options?: RunWechatIdeEngineBuildOptions): Promise<void | PollWechatIdeEngineBuildResult>;
+/** 在验收交互前等待 IDE 消费产物，并沿用该会话选择的安装。 */
+export declare function prepareAcceptanceProject(projectPath: string, signal: AbortSignal, options?: WechatDevtoolsHttpCommandOptions & {
+  runtimeProvider?: 'headless' | 'devtools';
+}): Promise<void | PollWechatIdeEngineBuildResult>;
 //#endregion
 //#region src/cli/forwardConsole.d.ts
 export type ForwardConsoleLogLevel = 'debug' | 'log' | 'info' | 'warn' | 'error';
@@ -344,6 +432,7 @@ export interface SharedInputSession {
   suspend: () => void;
 }
 export interface ExclusiveKeypressOptions<T> {
+  signal?: AbortSignal;
   ignoreInitialMs?: number;
   timeoutMs?: number;
   onKeypress: (str: string, key: {
@@ -355,6 +444,20 @@ export declare function createSharedInputSession(options: SharedInputSessionOpti
 export declare function waitForExclusiveKeypress<T>(options: ExclusiveKeypressOptions<T>): Promise<T | 'timeout'>;
 export declare function runWithSuspendedSharedInput<T>(runner: () => Promise<T>): Promise<T>;
 //#endregion
+//#region src/cli/loginQuery.d.ts
+export type WechatIdeLoginQueryResult = {
+  status: 'success';
+  login: boolean;
+} | {
+  status: 'unknown';
+  reason: 'timeout' | 'command-failed' | 'invalid-response' | 'installation-mismatch' | 'runtime-busy';
+};
+/** 显式调用指定 CLI 查询登录语义，不重试、不提示登录；原生 CLI 可能启动 IDE。 */
+export declare function queryWechatIdeLogin(cliPath: string, options?: {
+  timeout?: number;
+  signal?: AbortSignal;
+}): Promise<WechatIdeLoginQueryResult>;
+//#endregion
 //#region src/cli/minidev.d.ts
 /**
  * @description 运行支付宝小程序 CLI（minidev）
@@ -378,6 +481,7 @@ export declare function resolveCliPath(): Promise<{
 //#endregion
 //#region src/cli/retry.d.ts
 export interface RetryKeypressOptions {
+  signal?: AbortSignal;
   timeoutMs?: number;
 }
 export interface RetryPromptOptions extends RetryKeypressOptions {
@@ -391,6 +495,7 @@ export interface RetryLogger {
   warn: (message: string) => void;
 }
 export interface WechatIdeLoginRetryOptions {
+  signal?: AbortSignal;
   allowRetry?: boolean;
   cancelLevel?: 'info' | 'warn';
   error: unknown;
@@ -469,31 +574,34 @@ export declare function runAutomatorCommand(command: string, argv: string[]): Pr
 //#endregion
 //#region src/cli/run-login.d.ts
 export interface RunWechatCliWithRetryOptions {
+  target?: ResolvedWechatDevtoolsTarget;
   silent?: boolean;
   timeout?: number;
+  signal?: AbortSignal;
 }
-/**
- * @description 运行微信开发者工具 CLI，并在登录失效时允许按键重试。
- */
+/** 原生 CLI 可能启动或改变共享宿主，完整命令与有限重试共用机器租约。 */
 export declare function runWechatCliWithRetry(cliPath: string, argv: string[], options?: RunWechatCliWithRetryOptions): Promise<void>;
 //#endregion
 //#region src/cli/run-login-executor.d.ts
 export interface RetryableCommandExecutorOptions<TResult, TPromptResult> {
+  timeout?: number;
+  signal?: AbortSignal;
+  maxAttempts?: number;
+  disposeLate?: (result: TResult) => void | Promise<void>;
   createCancelError: (result: TResult) => Error;
-  execute: () => Promise<TResult>;
+  execute: (operation: OperationLifecycle) => Promise<TResult>;
   isRetryableResult: (result: TResult) => boolean;
   onCancel?: (result: TResult) => void;
   onRetry?: () => void;
-  promptRetry: (result: TResult, retryCount: number) => Promise<TPromptResult>;
+  promptRetry: (result: TResult, retryCount: number, operation: OperationLifecycle) => Promise<TPromptResult>;
   shouldRetry: (result: TPromptResult) => boolean;
 }
-/**
- * @description 执行可重试命令循环，并将“是否可重试”与“如何提示重试”交给调用方定义。
- */
+/** 命令、登录提示和有限重试共用一个 deadline，取消信号由执行边界传入 I/O。 */
 export declare function runRetryableCommand<TResult, TPromptResult>(options: RetryableCommandExecutorOptions<TResult, TPromptResult>): Promise<TResult>;
 //#endregion
 //#region src/cli/run-mcp.d.ts
 export interface McpCommandOptions {
+  cliPath?: string;
   workspaceRoot?: string;
 }
 export declare function runMcpCommand(argv: string[]): Promise<void>;
@@ -582,6 +690,11 @@ export interface AutoReplayWechatIdeOptions {
 export interface OpenWechatIdeOtherProjectOptions {
   projectPath?: string;
 }
+export interface CloseWechatIdeProjectOptions {
+  projectPath?: string;
+  cliPath?: string;
+  target?: ResolvedWechatDevtoolsTarget;
+}
 export interface ClearWechatIdeCacheOptions {
   clean: 'all' | 'auth' | 'compile' | 'file' | 'network' | 'session' | 'storage';
 }
@@ -635,9 +748,7 @@ export interface BuildWechatIdeIpaOptions {
   versionDesc?: string;
   versionName?: string;
 }
-/**
- * @description 调用微信开发者工具 open 命令。
- */
+/** 打开与兼容回退在同一机器租约内沿用固定安装，禁止重新选择宿主。 */
 export declare function openWechatIde(options?: OpenWechatIdeOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 login 命令。
@@ -677,7 +788,7 @@ export declare function uploadWechatIde(options: UploadWechatIdeOptions): Promis
 /**
  * @description 调用微信开发者工具 close 命令。
  */
-export declare function closeWechatIdeProject(): Promise<void>;
+export declare function closeWechatIdeProject(options?: CloseWechatIdeProjectOptions): Promise<void>;
 /**
  * @description 调用微信开发者工具 quit 命令。
  */
@@ -738,14 +849,15 @@ export declare function buildWechatIdeIpa(options: BuildWechatIdeIpaOptions): Pr
 export declare function dispatchWechatCliCommand(argv: string[]): Promise<boolean>;
 //#endregion
 //#region src/cli/wechatDevtoolsRuntimePort.d.ts
+type PortTarget = Pick<ResolvedWechatDevtoolsTarget, 'installationId'>;
 /**
- * @description 标记当前进程最近一次检测到的微信开发者工具服务端口。
+ * @description 标记所选安装检测到的服务端口；无身份的旧调用仅保留在独立兼容槽中。
  */
-export declare function setRuntimeWechatDevtoolsServicePort(port: number | undefined): void;
+export declare function setRuntimeWechatDevtoolsServicePort(port: number | undefined, target?: PortTarget): void;
 /**
- * @description 读取当前进程最近一次检测到的微信开发者工具服务端口。
+ * @description 只读取所选安装的服务端口，不借用其他安装或无身份的旧记录。
  */
-export declare function getRuntimeWechatDevtoolsServicePort(): number | undefined;
+export declare function getRuntimeWechatDevtoolsServicePort(target?: PortTarget): number | undefined;
 //#endregion
 //#region src/cli/wechatDevtoolsSettings.d.ts
 export interface WechatDevtoolsSecuritySettings {
@@ -758,10 +870,8 @@ export interface DetectedWechatDevtoolsServicePortSettings {
   enabled?: boolean;
   port?: number;
 }
-export interface DetectWechatDevtoolsServicePortOptions {
-  homeDir?: string;
-  localAppDataDir?: string;
-  platform?: NodeJS.Platform;
+export interface DetectWechatDevtoolsServicePortOptions extends ResolveWechatDevtoolsTargetOptions {
+  target?: ResolvedWechatDevtoolsTarget;
 }
 export interface DetectWechatDevtoolsServicePortResult {
   touchedInstanceCount: number;
@@ -799,7 +909,7 @@ interface BaseConfig {
 /**
  * @description 配置来源
  */
-type ConfigSource = 'custom' | 'default' | 'missing';
+type ConfigSource = 'custom' | 'default' | 'environment' | 'missing';
 /**
  * @description 解析后的配置
  */
@@ -869,7 +979,7 @@ export declare function resolveDevtoolsAutomationDefaults(config: {
   autoTrustProject: boolean;
 };
 /**
- * @description 读取并解析 CLI 配置（自定义优先）
+ * @description 读取并解析 CLI 配置（进程选择优先，其次用户配置与平台默认）
  */
 export declare function getConfig(): Promise<ResolvedConfig>;
 /**
@@ -877,8 +987,162 @@ export declare function getConfig(): Promise<ResolvedConfig>;
  */
 export declare function getConfiguredLocale(): Promise<"zh" | "en" | undefined>;
 //#endregion
+//#region src/devtoolsProjectOwnership/types.d.ts
+interface ManagedWechatHostIdentity {
+  pid: number;
+  executable: string;
+  started: string;
+}
+type ManagedWechatProjectState = 'starting' | 'unconfirmed' | 'owned' | 'borrowed' | 'closing' | 'failed' | 'released';
+interface ManagedWechatInstallationExitEvidence {
+  protocol: 'wechat-devtools-installation-exit-v1';
+  recoveredAt: string;
+  recoveryScopeId: string;
+  journalScopeId: string;
+  journalRootPath: string;
+  installationId: string;
+  profileDir: string;
+  previous: {
+    state: 'starting' | 'unconfirmed' | 'failed';
+    error?: string;
+    updatedAt: string;
+    recordSha256: string;
+  };
+  stoppedOwnerPids: number[];
+  closedPorts: number[];
+  processInspection: {
+    platform: 'darwin';
+    installationRoot: string;
+    checkedAt: string;
+    inspectedProcessCount: number;
+    kernelPathProcessCount: number;
+    textImageProcessCount: number;
+    exitedProcessCount: number;
+    zombieProcessCount: number;
+    selectedProcessCount: 0;
+  };
+}
+interface ManagedWechatWindowLogCursor {
+  name: string;
+  identity: string;
+  offset: number;
+  anchor: string;
+  skipPartialLine: boolean;
+}
+interface ManagedWechatWindowCloseCall {
+  fileIdentity: string;
+  winId: string;
+  browserWindowId: number;
+  calledAt: string;
+  cancelled?: boolean;
+}
+interface ManagedWechatWindowCloseEvidence {
+  protocol: 'wechat-devtools-window-close-trace-v1';
+  profileDir: string;
+  productVersion: string;
+  capturedAt: string;
+  /** 活动日志按文件句柄捕获时，绑定实际持有日志的主进程身份。 */
+  mainHost?: ManagedWechatHostIdentity;
+  /** 关闭意图先于 CLI 落盘；未知执行结果不能再次按路径关闭窗口。 */
+  dispatchedAt?: string;
+  cursors: ManagedWechatWindowLogCursor[];
+  calls: ManagedWechatWindowCloseCall[];
+  window?: ManagedWechatWindowCloseCall & {
+    runtimeId: string;
+    requestedAt: string;
+    nativeClosedAt?: string;
+    webContentsDestroyedAt?: string;
+  };
+  failure?: string;
+  /** 旧整目录门禁恢复时保留原失败和游标，不重新捕获偏移或重复关窗。 */
+  logInventoryRecovery?: {
+    failure: string;
+    cursors: ManagedWechatWindowLogCursor[];
+  };
+}
+interface ManagedWechatProjectRecord {
+  schemaVersion: 1;
+  id: string;
+  generation: string;
+  journalPath: string;
+  ownerToken: string;
+  ownerPid: number;
+  target: ResolvedWechatDevtoolsTarget;
+  projectPath: string;
+  state: ManagedWechatProjectState;
+  openedProjectWindow?: boolean;
+  port?: number;
+  /** 自动化端口的监听进程身份，可能是 backend；不能当作主宿主或窗口身份。 */
+  host?: ManagedWechatHostIdentity;
+  createdAt: string;
+  updatedAt: string;
+  closeAcknowledgedAt?: string;
+  /** 端口退出不是窗口退出；保存所选 profile 的增量销毁证据供父任务恢复。 */
+  windowClose?: ManagedWechatWindowCloseEvidence;
+  releasedReason?: 'borrowed' | 'project-closed' | 'installation-exited';
+  /** 显式恢复只终结已退出安装的活资源；原启动失败与归属缺口仍保留。 */
+  installationExitRecovery?: ManagedWechatInstallationExitEvidence;
+  error?: string;
+}
+interface BeginManagedWechatProjectOptions {
+  target: ResolvedWechatDevtoolsTarget;
+  projectPath: string;
+  generation?: string;
+  port?: number;
+  journalPath?: string;
+  /** 当前任务根作用域最多持有一个窗口；双项目验收须显式指定两个。 */
+  maxOwnedWindows?: 1 | 2;
+}
+interface ManagedWechatProjectIntent {
+  id: string;
+  journalPath: string;
+  confirm: (result: {
+    openedProjectWindow: boolean;
+    port: number;
+  }) => Promise<void>;
+  fail: (error: unknown) => Promise<void>;
+  close: () => Promise<void>;
+}
+interface CleanupManagedWechatProjectsOptions {
+  journalPath?: string;
+  scope?: 'process' | 'journal';
+}
+//#endregion
+//#region src/devtoolsProjectOwnership/installationExit/index.d.ts
+export interface RecoverManagedWechatProjectsAfterInstallationExitOptions {
+  target: ResolvedWechatDevtoolsTarget;
+  recoveryScope: MachineE2ELeaseRecoveryScope;
+}
+export interface ManagedWechatInstallationExitRecoveryResult {
+  recoveredRecordIds: string[];
+}
+/** 在精确恢复租约中终结已退出安装的未知启动或失败关窗；保留原证据，不补造销毁事件。 */
+export declare function recoverManagedWechatProjectsAfterInstallationExit(options: RecoverManagedWechatProjectsAfterInstallationExitOptions): Promise<ManagedWechatInstallationExitRecoveryResult>;
+//#endregion
+//#region src/devtoolsProjectOwnership/journal/constants.d.ts
+/** 受管项目日志的环境变量名称；基础设施预检可在构建包之前读取。 */
+export declare const MANAGED_PROJECT_JOURNAL_ENV = "WEAPP_IDE_MANAGED_PROJECT_JOURNAL";
+/** 仅供显式受管任务声明双项目窗口验收；不允许无限扩大并行窗口。 */
+export declare const MANAGED_PROJECT_MAX_WINDOWS_ENV = "WEAPP_IDE_MANAGED_PROJECT_MAX_WINDOWS";
+//#endregion
+//#region src/devtoolsProjectOwnership/journal.d.ts
+/** 仅递归当前任务明确传递的 children；不扫描用户缓存，不跟随符号链接。 */
+export declare function readManagedWechatProjectRecords(journalPath?: string): Promise<ManagedWechatProjectRecord[]>;
+//#endregion
+//#region src/devtoolsProjectOwnership/index.d.ts
+/** 窗口销毁与连接断开分别验证；失败保留登记供后续继续观察。 */
+export declare function closeManagedWechatProject(options: {
+  journalPath?: string;
+  id: string;
+}): Promise<void>;
+/** 未启用受管日志时不改变公共共享会话；意图登记本身没有项目关闭权。 */
+export declare function beginManagedWechatProject(options: BeginManagedWechatProjectOptions): Promise<ManagedWechatProjectIntent | undefined>;
+/** 父进程可回收已退出工作进程的确认所有权；未知启动结果严格阻止后续任务。 */
+export declare function cleanupManagedWechatProjects(options?: CleanupManagedWechatProjectsOptions): Promise<void>;
+//#endregion
 //#region src/mcp/runtime.d.ts
 export interface StartWeappIdeMcpServerOptions {
+  cliPath?: string;
   workspaceRoot?: string;
 }
 export declare function startWeappIdeMcpServer(options?: StartWeappIdeMcpServerOptions): Promise<{
@@ -890,14 +1154,7 @@ interface ToolRegistrar {
   registerTool: McpServer['registerTool'];
 }
 export interface WeappIdeMcpRuntimeHooks {
-  withMiniProgram: <T>(options: {
-    preferOpenedSession?: boolean;
-    port?: number;
-    projectPath: string;
-    sharedSession?: boolean;
-    sessionId?: string;
-    timeout?: number;
-  }, runner: (miniProgram: MiniProgramLike) => Promise<T>) => Promise<T>;
+  withMiniProgram: <T>(options: AutomatorSessionOptions, runner: (miniProgram: MiniProgramLike) => Promise<T>) => Promise<T>;
 }
 export interface WeappIdeMcpServerOptions {
   runtimeHooks: WeappIdeMcpRuntimeHooks;
@@ -962,12 +1219,15 @@ interface ExecuteOptions {
   pipeStdout?: boolean;
   pipeStderr?: boolean;
   timeout?: number;
+  signal?: AbortSignal;
 }
 /**
  * @description 执行 CLI 命令并透传输出
  */
 export declare function execute(cliPath: string, argv: string[], options?: ExecuteOptions): Promise<import("execa").Result<{
   timeout: number | undefined;
+  cancelSignal: AbortSignal | undefined;
+  forceKillAfterDelay: number;
 }>>;
 //#endregion
 //#region src/utils/path.d.ts
@@ -976,4 +1236,4 @@ export declare function execute(cliPath: string, argv: string[], options?: Execu
  */
 export declare function resolvePath(filePath: string): string;
 //#endregion
-export { type AutomatorSessionOptions, type BaseConfig, type ConfigSource, type DevtoolsConnectionInput, type DevtoolsContext, type DevtoolsElementSnapshot, type DevtoolsPageSnapshot, type DevtoolsToolResult, type MiniProgramElement, type MiniProgramEventMap, type MiniProgramLike, type MiniProgramPage, type ResolvedConfig, closeSharedMiniProgram, getSharedMiniProgramSessionCount, readElementSnapshot, releaseSharedMiniProgram, resolveProjectPath, toSerializableValue };
+export { type AutomatorSessionOptions, type BaseConfig, type BeginManagedWechatProjectOptions, type CleanupManagedWechatProjectsOptions, type ConfigSource, type DevtoolsConnectionInput, type DevtoolsContext, type DevtoolsElementSnapshot, type DevtoolsPageSnapshot, type DevtoolsToolResult, type ManagedWechatHostIdentity, type ManagedWechatInstallationExitEvidence, type ManagedWechatProjectIntent, type ManagedWechatProjectRecord, type ManagedWechatProjectState, type ManagedWechatWindowCloseCall, type ManagedWechatWindowCloseEvidence, type ManagedWechatWindowLogCursor, type MiniProgramElement, type MiniProgramEventMap, type MiniProgramLike, type MiniProgramPage, type ResolvedConfig, type WechatDevtoolsHostInspectionOptions, closeSharedMiniProgram, getSharedMiniProgramSessionCount, readElementSnapshot, releaseSharedMiniProgram, resolveProjectPath, toSerializableValue };

package/dist/index.js

@@ -1,5 +1,8 @@
-import { $ as createAutoTrustProjectConfig, A as getAutomatorProtocolTimeoutMethod, B as bootstrapWechatDevtoolsSettings, C as runWithSuspendedSharedInput, F as isDevtoolsExtensionContextInvalidatedError, G as resolveDevtoolsAutomationDefaults, H as resolveCliPath, I as isDevtoolsHttpPortError, J as isOperatingSystemSupported, K as SupportedPlatformsMap, L as isRetryableAutomatorLaunchError, M as isAutomatorPortInUseError, N as isAutomatorProtocolTimeoutError, O as connectOpenedAutomator, P as isAutomatorWsConnectError, Q as createAutoBootstrapDevtoolsConfig, R as launchAutomator, S as createSharedInputSession, U as getConfig, V as detectWechatDevtoolsServicePort, W as getConfiguredLocale, Y as operatingSystemName, _ as isWechatIdeLoginRequiredError, a as connectMiniProgram, at as defaultCustomConfigDirPath, b as promptWechatIdeLoginRetry, c as withMiniProgram, d as RETRY_CONFIRM_KEYS, et as createCustomConfig, f as RETRY_PROMPT_INITIAL_IGNORE_MS, g as formatWechatIdeLoginRequiredError, h as formatRetryHotkeyPrompt, it as removeCustomConfigKey, j as isAutomatorLoginError, k as formatAutomatorLoginError, l as runRetryableCommand, m as extractExecutionErrorText, n as acquireSharedMiniProgram, nt as overwriteCustomConfig, o as getSharedMiniProgramSessionCount, ot as defaultCustomConfigFilePath, p as createWechatIdeLoginRequiredExitError, q as getDefaultCliPath, r as closeSharedMiniProgram, rt as readCustomConfig, s as releaseSharedMiniProgram, st as resolvePath, tt as createLocaleConfig, u as RETRY_CANCEL_KEYS, v as isWechatIdeLoginRequiredExitError, w as waitForExclusiveKeypress, x as waitForRetryKeypress, y as promptRetryKeypress, z as resolveProjectAutomatorPort } from "./automator-session-fbanL2eW.js";
-import { $ as getRuntimeWechatDevtoolsServicePort, A as isWechatIdeLoggedIn, C as clearWechatIdeCache, D as getWechatIdeTestAccounts, E as compileWechatIdeByAutomator, F as quitWechatIde, G as transformArgv, H as execute, I as refreshWechatIdeTicket, J as openWechatIdeProjectByHttp, K as promptForCliPath, L as resetWechatIdeFileUtils, M as openWechatIde, N as openWechatIdeOtherProject, O as getWechatIdeTicket, P as previewWechatIde, Q as startWechatIdeEngineBuildByHttp, R as setWechatIdeTicket, S as buildWechatIdeNpm, T as closeWechatIdeProject, U as createAlias, V as runWechatCliWithRetry, W as createPathCompat, X as requestWechatDevtoolsHttp, Y as pollWechatIdeEngineBuildResultByHttp, Z as resetWechatIdeFileUtilsByHttp, _ as autoPreviewWechatIde, a as navigateBack, b as buildWechatIdeApk, c as pageStack, d as remote, et as setRuntimeWechatDevtoolsServicePort, f as scrollTo, g as tap, h as takeScreenshot, i as input, it as removeOption, j as loginWechatIde, k as getWechatIdeToolInfo, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, nt as readBooleanOption, o as navigateTo, p as switchTab, q as WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, r as currentPage, rt as readOptionValue, s as pageData, t as audit, tt as parseAutomatorArgs, u as redirectTo, v as autoReplayWechatIde, w as clearWechatIdeCacheByAutomator, x as buildWechatIdeIpa, y as autoWechatIde, z as uploadWechatIde } from "./commands-__RJ552L.js";
-import { C as parseCompareArgs, S as printScreenshotHelp, _ as AUTOMATOR_COMMAND_NAMES, a as runMinidev, b as runAutomatorCommand, c as runWechatIdeEngineBuild, d as CONFIG_COMMAND_NAME, f as MCP_COMMAND_NAME, g as isWeappIdeTopLevelCommand, h as WECHAT_CLI_COMMAND_NAMES, i as validateWechatCliCommandArgs, l as runWechatIdeEngineBuildByHttp, m as WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, n as parse, o as startForwardConsole, p as MINIDEV_NAMESPACE_COMMAND_NAMES, r as dispatchWechatCliCommand, s as isWechatIdeEngineBuildEndpointMissingError, t as createCli, u as handleConfigCommand, v as getAutomatorCommandHelp, w as printCompareHelp, x as parseScreenshotArgs, y as isAutomatorCommand } from "./cli-2sY1sAVq.js";
-import { a as readElementSnapshot, i as registerWeappIdeMcpTools, n as startWeappIdeMcpServer, o as resolveProjectPath, r as createWeappIdeMcpServer, s as toSerializableValue, t as runMcpCommand } from "./run-mcp-LqaWlQJ_.js";
-export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MCP_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, RETRY_PROMPT_INITIAL_IGNORE_MS, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, acquireSharedMiniProgram, audit, autoPreviewWechatIde, autoReplayWechatIde, autoWechatIde, bootstrapWechatDevtoolsSettings, buildWechatIdeApk, buildWechatIdeIpa, buildWechatIdeNpm, captureScreenshotBuffer, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectMiniProgram, connectOpenedAutomator, createAlias, createAutoBootstrapDevtoolsConfig, createAutoTrustProjectConfig, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createSharedInputSession, createWeappIdeMcpServer, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getRuntimeWechatDevtoolsServicePort, getSharedMiniProgramSessionCount, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorPortInUseError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, loginWechatIde, navigateBack, navigateTo, openWechatIde, openWechatIdeOtherProject, openWechatIdeProjectByHttp, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, pollWechatIdeEngineBuildResultByHttp, previewWechatIde, printCompareHelp, printScreenshotHelp, promptForCliPath, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, reLaunch, readBooleanOption, readCustomConfig, readElementSnapshot, readOptionValue, redirectTo, refreshWechatIdeTicket, registerWeappIdeMcpTools, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, requestWechatDevtoolsHttp, resetWechatIdeFileUtils, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveDevtoolsAutomationDefaults, resolvePath, resolveProjectAutomatorPort, resolveProjectPath, runAutomatorCommand, runMcpCommand, runMinidev, runRetryableCommand, runWechatCliWithRetry, runWechatIdeEngineBuild, runWechatIdeEngineBuildByHttp, runWithSuspendedSharedInput, scrollTo, setRuntimeWechatDevtoolsServicePort, setWechatIdeTicket, startForwardConsole, startWeappIdeMcpServer, startWechatIdeEngineBuildByHttp, switchTab, systemInfo, takeScreenshot, tap, toSerializableValue, transformArgv, uploadWechatIde, validateWechatCliCommandArgs, waitForExclusiveKeypress, waitForRetryKeypress, withMiniProgram };
+import { C as getDefaultCliPath, S as SupportedPlatformsMap, T as operatingSystemName, _ as readCustomConfig, a as assertWechatDevtoolsPort, b as defaultCustomConfigFilePath, d as resolveDevtoolsAutomationDefaults, f as createAutoBootstrapDevtoolsConfig, g as overwriteCustomConfig, h as createLocaleConfig, i as assertWechatDevtoolsHost, l as getConfig, m as createCustomConfig, p as createAutoTrustProjectConfig, r as resolveWechatDevtoolsTarget, u as getConfiguredLocale, v as removeCustomConfigKey, w as isOperatingSystemSupported, x as resolvePath, y as defaultCustomConfigDirPath } from "./sessionStore-zdzy2UFM.js";
+import { d as MANAGED_PROJECT_MAX_WINDOWS_ENV, h as startWechatIdeAgent, i as recoverManagedWechatProjectsAfterInstallationExit, n as cleanupManagedWechatProjects, o as readManagedWechatProjectRecords, r as closeManagedWechatProject, t as beginManagedWechatProject, u as MANAGED_PROJECT_JOURNAL_ENV } from "./devtoolsProjectOwnership-yDD6h0dO.js";
+import { a as bootstrapWechatDevtoolsSettings, c as getAutomatorProtocolTimeoutMethod, d as isAutomatorProtocolTimeoutError, f as isAutomatorWsConnectError, g as resolveAutomatorSessionOptions, h as isRetryableAutomatorLaunchError, i as resolveProjectAutomatorPort, l as isAutomatorLoginError, m as isDevtoolsHttpPortError, n as launchAutomator, o as detectWechatDevtoolsServicePort, p as isDevtoolsExtensionContextInvalidatedError, r as persistOpenedAutomatorSession, s as formatAutomatorLoginError, t as connectOpenedAutomator, u as isAutomatorPortInUseError } from "./automator-CRpB6_pA.js";
+import { $ as MINIDEV_NAMESPACE_COMMAND_NAMES, A as queryWechatIdeLogin, B as WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, C as refreshWechatIdeTicket, D as validateWechatCliCommandArgs, E as uploadWechatIde, F as startForwardConsole, G as startWechatIdeEngineBuildByHttp, H as pollWechatIdeEngineBuildResultByHttp, I as isWechatIdeEngineBuildEndpointMissingError, J as handleConfigCommand, K as getRuntimeWechatDevtoolsServicePort, L as prepareAcceptanceProject, M as createAlias, N as createPathCompat, O as runWechatCliWithRetry, P as transformArgv, Q as MCP_COMMAND_NAME, R as runWechatIdeEngineBuild, S as quitWechatIde, T as setWechatIdeTicket, U as requestWechatDevtoolsHttp, V as openWechatIdeProjectByHttp, W as resetWechatIdeFileUtilsByHttp, X as promptForCliPath, Y as resolveCliPath, Z as CONFIG_COMMAND_NAME, _ as isWechatIdeLoggedIn, a as autoReplayWechatIde, at as isAutomatorCommand, b as openWechatIdeOtherProject, c as buildWechatIdeIpa, ct as printScreenshotHelp, d as clearWechatIdeCacheByAutomator, dt as parseAutomatorArgs, et as WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, f as closeWechatIdeProject, ft as readBooleanOption, g as getWechatIdeToolInfo, h as getWechatIdeTicket, i as autoPreviewWechatIde, it as getAutomatorCommandHelp, j as execute, k as runMinidev, l as buildWechatIdeNpm, lt as parseCompareArgs, m as getWechatIdeTestAccounts, mt as removeOption, n as parse, nt as isWeappIdeTopLevelCommand, o as autoWechatIde, ot as runAutomatorCommand, p as compileWechatIdeByAutomator, pt as readOptionValue, q as setRuntimeWechatDevtoolsServicePort, r as dispatchWechatCliCommand, rt as AUTOMATOR_COMMAND_NAMES, s as buildWechatIdeApk, st as parseScreenshotArgs, t as createCli, tt as WECHAT_CLI_COMMAND_NAMES, u as clearWechatIdeCache, ut as printCompareHelp, v as loginWechatIde, w as resetWechatIdeFileUtils, x as previewWechatIde, y as openWechatIde, z as runWechatIdeEngineBuildByHttp } from "./cli-ChMQqi5w.js";
+import { C as runWithSuspendedSharedInput, S as createSharedInputSession, _ as isWechatIdeLoginRequiredError, a as connectMiniProgram, b as promptWechatIdeLoginRetry, c as withMiniProgram, d as RETRY_CONFIRM_KEYS, f as RETRY_PROMPT_INITIAL_IGNORE_MS, g as formatWechatIdeLoginRequiredError, h as formatRetryHotkeyPrompt, l as runRetryableCommand, m as extractExecutionErrorText, n as acquireSharedMiniProgram, o as getSharedMiniProgramSessionCount, p as createWechatIdeLoginRequiredExitError, r as closeSharedMiniProgram, s as releaseSharedMiniProgram, u as RETRY_CANCEL_KEYS, v as isWechatIdeLoginRequiredExitError, w as waitForExclusiveKeypress, x as waitForRetryKeypress, y as promptRetryKeypress } from "./automator-session-gWEsSs_A.js";
+import { a as navigateBack, c as pageStack, d as remote, f as scrollTo, g as tap, h as takeScreenshot, i as input, l as reLaunch, m as systemInfo, n as captureScreenshotBuffer, o as navigateTo, p as switchTab, r as currentPage, s as pageData, t as audit, u as redirectTo } from "./commands-C1PF1B4P.js";
+import { a as readElementSnapshot, i as registerWeappIdeMcpTools, n as startWeappIdeMcpServer, o as resolveProjectPath, r as createWeappIdeMcpServer, s as toSerializableValue, t as runMcpCommand } from "./run-mcp-Dl_1TH1x.js";
+export { AUTOMATOR_COMMAND_NAMES, CONFIG_COMMAND_NAME, MANAGED_PROJECT_JOURNAL_ENV, MANAGED_PROJECT_MAX_WINDOWS_ENV, MCP_COMMAND_NAME, MINIDEV_NAMESPACE_COMMAND_NAMES, RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, RETRY_PROMPT_INITIAL_IGNORE_MS, SupportedPlatformsMap, WEAPP_IDE_TOP_LEVEL_COMMAND_NAMES, WECHAT_CLI_COMMAND_NAMES, WECHAT_DEVTOOLS_ENGINE_BUILD_STATUSES, acquireSharedMiniProgram, assertWechatDevtoolsHost, assertWechatDevtoolsPort, audit, autoPreviewWechatIde, autoReplayWechatIde, autoWechatIde, beginManagedWechatProject, bootstrapWechatDevtoolsSettings, buildWechatIdeApk, buildWechatIdeIpa, buildWechatIdeNpm, captureScreenshotBuffer, cleanupManagedWechatProjects, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeManagedWechatProject, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectMiniProgram, connectOpenedAutomator, createAlias, createAutoBootstrapDevtoolsConfig, createAutoTrustProjectConfig, createCli, createCustomConfig, createLocaleConfig, createPathCompat, createSharedInputSession, createWeappIdeMcpServer, createWechatIdeLoginRequiredExitError, currentPage, defaultCustomConfigDirPath, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, execute, extractExecutionErrorText, formatAutomatorLoginError, formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getAutomatorCommandHelp, getAutomatorProtocolTimeoutMethod, getConfig, getConfiguredLocale, getDefaultCliPath, getRuntimeWechatDevtoolsServicePort, getSharedMiniProgramSessionCount, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, handleConfigCommand, input, isAutomatorCommand, isAutomatorLoginError, isAutomatorPortInUseError, isAutomatorProtocolTimeoutError, isAutomatorWsConnectError, isDevtoolsExtensionContextInvalidatedError, isDevtoolsHttpPortError, isOperatingSystemSupported, isRetryableAutomatorLaunchError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, loginWechatIde, navigateBack, navigateTo, openWechatIde, openWechatIdeOtherProject, openWechatIdeProjectByHttp, operatingSystemName, overwriteCustomConfig, pageData, pageStack, parse, parseAutomatorArgs, parseCompareArgs, parseScreenshotArgs, persistOpenedAutomatorSession, pollWechatIdeEngineBuildResultByHttp, prepareAcceptanceProject, previewWechatIde, printCompareHelp, printScreenshotHelp, promptForCliPath, promptRetryKeypress, promptWechatIdeLoginRetry, queryWechatIdeLogin, quitWechatIde, reLaunch, readBooleanOption, readCustomConfig, readElementSnapshot, readManagedWechatProjectRecords, readOptionValue, recoverManagedWechatProjectsAfterInstallationExit, redirectTo, refreshWechatIdeTicket, registerWeappIdeMcpTools, releaseSharedMiniProgram, remote, removeCustomConfigKey, removeOption, requestWechatDevtoolsHttp, resetWechatIdeFileUtils, resetWechatIdeFileUtilsByHttp, resolveAutomatorSessionOptions, resolveCliPath, resolveDevtoolsAutomationDefaults, resolvePath, resolveProjectAutomatorPort, resolveProjectPath, resolveWechatDevtoolsTarget, runAutomatorCommand, runMcpCommand, runMinidev, runRetryableCommand, runWechatCliWithRetry, runWechatIdeEngineBuild, runWechatIdeEngineBuildByHttp, runWithSuspendedSharedInput, scrollTo, setRuntimeWechatDevtoolsServicePort, setWechatIdeTicket, startForwardConsole, startWeappIdeMcpServer, startWechatIdeAgent, startWechatIdeEngineBuildByHttp, switchTab, systemInfo, takeScreenshot, tap, toSerializableValue, transformArgv, uploadWechatIde, validateWechatCliCommandArgs, waitForExclusiveKeypress, waitForRetryKeypress, withMiniProgram };