clawconnect-agent 0.2.13 → 0.2.15

package/dist/platform/service-manager-windows.d.ts

@@ -1,36 +1,46 @@
 import { execFileSync } from "child_process";
 import type { ServiceStatus } from "./service-manager-common.js";
-export declare const TASK_NAME = "ClawConnectAgent";
-export declare const WINDOWS_SERVICE_RUNNER_NAME = "clawconnect-service.ps1";
-export declare const WINDOWS_RUN_KEY = "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run";
-export declare const WINDOWS_READ_ONLY_QUERY_TIMEOUT_MS = 5000;
-export interface WindowsServiceStatusProbeOptions {
+import type { WindowsQueryTimeoutReporter } from "./windows-process-control.js";
+export { windowsServiceName } from "./windows-service-paths.js";
+export { buildWindowsProcessQueryScript, WINDOWS_READ_ONLY_QUERY_TIMEOUT_MS, } from "./windows-process-control.js";
+export declare const WINDOWS_SERVICE_STATE_POLL_INTERVAL_MS = 500;
+export declare const WINDOWS_SERVICE_STATE_TIMEOUT_MS = 30000;
+/** 失败后第 1、2 次 5 秒重启，之后 60 秒；24 小时无失败则清零计数。 */
+export declare const WINDOWS_SERVICE_FAILURE_ACTIONS = "restart/5000/restart/5000/restart/60000";
+export declare const WINDOWS_SERVICE_FAILURE_RESET_SECONDS = 86400;
+export type WindowsServiceState = "running" | "stopped" | "pending" | "missing" | "unknown";
+export interface WindowsServiceDeps {
     execFileSyncImpl?: typeof execFileSync;
-    onQueryTimeout?: (probe: string) => void;
-    scriptPath?: string;
+    onQueryTimeout?: WindowsQueryTimeoutReporter;
+    sleepSync?: (ms: number) => void;
+    /** 测试用：覆盖 csc.exe 路径解析。 */
+    cscPath?: string;
+    /** 测试用：替换"结束 Agent 进程"的动作，避免单测去执行 Windows 命令。 */
+    killProcess?: (profile: string | undefined) => boolean;
+    /** 测试用：替换"编译服务宿主 exe"的动作，避免单测写入真实主目录。 */
+    compileHost?: (profile: string | undefined) => void;
+    /** 测试用：替换"写服务宿主配置"的动作，避免单测写入真实主目录。 */
+    writeConfig?: (profile: string | undefined) => void;
+    /** 测试用：覆盖服务账户，避免依赖运行测试的机器的 USERNAME / USERDOMAIN。 */
+    account?: string;
 }
-export declare function windowsTaskName(profile?: string): string;
-export declare function buildWindowsPowerShellBootstrap(command: string): string;
 export declare function normalizeWindowsServiceLogEncoding(path: string): void;
-export declare function buildWindowsServiceProcessCommand(args: string[], logPath: string, errorLogPath: string): string;
-export declare function windowsServiceRunnerPath(profile?: string): string;
-export declare function buildWindowsServiceTaskCommand(runnerPath: string): string;
-export declare function buildWindowsStartupRegistryArgs(taskName: string, taskCommand: string): string[];
-export declare function migrateLegacyWindowsStartup(profile?: string, options?: Pick<WindowsServiceStatusProbeOptions, "execFileSyncImpl" | "onQueryTimeout"> & {
-    defaultProfileConfigured?: boolean;
-    stopLegacyProcess?: () => void;
-}): boolean;
-export declare function buildWindowsScheduledTaskStateScript(): string;
-export declare function buildWindowsDetachedRunnerStartScript(): string;
-export declare function writeWindowsServiceRunner(profile: string | undefined, args: string[], logPath: string, errorLogPath: string): string;
+export declare function buildWindowsServiceStateScript(): string;
+/** 服务账户：域/计算机名\用户名。服务必须以当前用户运行，才能读写其目录下的配置、日志与本机网关。 */
+export declare function windowsServiceAccount(env?: NodeJS.ProcessEnv): string;
 /**
- * Kill any running node processes that are executing this specific script.
- * Uses execFileSync to bypass cmd.exe, avoiding CMD quote-mangling.
- * Returns true if any processes were killed.
+ * 创建服务并设置当前用户凭据。密码只经 Read-Host -AsSecureString 在 PowerShell 进程内流转，
+ * 不进入命令行参数，也不经过 Node。创建前先校验密码，避免注册一个永远以 1069 启动失败的服务。
  */
-export declare function buildWindowsProcessQueryScript(profile?: string): string;
-export declare function installWindowsService(profile?: string): boolean;
-export declare function uninstallWindowsService(profile?: string): boolean;
-export declare function restartWindowsService(profile?: string): boolean;
-export declare function stopWindowsService(profile?: string): boolean;
-export declare function getWindowsServiceStatus(profile?: string, options?: WindowsServiceStatusProbeOptions): ServiceStatus;
+export declare function buildWindowsServiceCreateScript(): string;
+/** SCM 启动宿主时传入的参数：服务名 + 宿主配置路径。 */
+export declare function buildWindowsServiceBinaryPath(hostExePath: string, serviceName: string, configPath: string): string;
+export declare function resolveWindowsCscPath(fileExists?: (path: string) => boolean, windowsDir?: string): string | undefined;
+export declare function buildWindowsServiceHostCompileArgs(sourcePath: string, outputPath: string): string[];
+export declare function isWindowsElevated(execFileSyncImpl?: typeof execFileSync): boolean;
+export declare function queryWindowsServiceState(serviceName: string, deps?: WindowsServiceDeps): WindowsServiceState;
+export declare function installWindowsService(profile?: string, deps?: WindowsServiceDeps): boolean;
+export declare function restartWindowsService(profile?: string, deps?: WindowsServiceDeps): boolean;
+export declare function stopWindowsService(profile?: string, deps?: WindowsServiceDeps): boolean;
+export declare function uninstallWindowsService(profile?: string, deps?: WindowsServiceDeps): boolean;
+export declare function getWindowsServiceStatus(profile?: string, deps?: WindowsServiceDeps): ServiceStatus;