@hcu-lab.me/mcp-device 1.0.5 → 1.0.6

package/dist/device/self-update.d.ts

@@ -1,20 +1,115 @@
 import { spawn as spawnCallback } from 'child_process';
+import { type DeviceStatePaths } from './device-state.js';
 export declare const MCP_DEVICE_PACKAGE = "@hcu-lab.me/mcp-device";
+export type DeviceUpdateManagerKind = 'windows-task' | 'windows-run' | 'windows-manual' | 'systemd' | 'pm2';
+export type DeviceUpdatePhase = 'prepared' | 'helper_started' | 'handoff_ready' | 'quiescing' | 'installing' | 'installed_waiting_reconnect' | 'rollback' | 'failed';
+export interface DeviceUpdateState {
+    schema: number;
+    requestId: string;
+    fromVersion: string;
+    targetVersion: string;
+    state: DeviceUpdatePhase;
+    startedAt: number;
+    updatedAt?: number;
+    completedAt: number | null;
+    errorCode: string | null;
+    message: string | null;
+    deviceId: string;
+    managerKind: DeviceUpdateManagerKind;
+    parentPid: number;
+    childPid: number | null;
+    packageRoot: string;
+    globalPrefix: string;
+    nodePath: string;
+    npmCliPath: string;
+    targetTarball: string;
+    cacheDir: string;
+    rollbackSnapshot: string;
+    rollbackPath: string;
+    helperPath: string;
+    handoffPath: string;
+    runtimeOwnerControlPath: string;
+    windowsRunnerPath?: string;
+    windowsTaskName?: string;
+    windowsUpdateTaskName?: string;
+    powershellPath?: string;
+    schtasksPath?: string;
+    systemctlPath?: string;
+    systemdRunPath?: string;
+    systemdUnit?: string;
+    systemdUpdateUnit?: string;
+    pm2Path?: string;
+    pm2Name?: string;
+}
+export interface PreparedDeviceUpdate {
+    state: DeviceUpdateState;
+    statePath: string;
+    helperRunnerPath?: string;
+}
+type ExecFileFn = (file: string, args: string[]) => Promise<{
+    stdout?: string;
+    stderr?: string;
+}>;
+export interface DeviceUpdateManagerOverride {
+    managerKind: DeviceUpdateManagerKind;
+    windowsRunnerPath?: string;
+    windowsTaskName?: string;
+    powershellPath?: string;
+    schtasksPath?: string;
+    systemctlPath?: string;
+    systemdRunPath?: string;
+    systemdUnit?: string;
+    pm2Path?: string;
+    pm2Name?: string;
+}
 export declare function normalizeUpdateVersion(value: string): string;
-export declare function installDevicePackageUpdate(targetVersion: string, options?: {
+export declare function readDeviceUpdateState(paths?: DeviceStatePaths): Promise<DeviceUpdateState | null>;
+export declare function assertDeviceStartupAllowedDuringUpdate(currentVersion?: string, paths?: DeviceStatePaths): Promise<void>;
+export declare function resolveNpmCliPath(options?: {
     platform?: NodeJS.Platform | string;
-    execFile?: (file: string, args: string[]) => Promise<{
-        stdout?: string;
-        stderr?: string;
-    }>;
-    npmPath?: string;
+    execFile?: ExecFileFn;
+    nodePath?: string;
+    npmExecPath?: string;
 }): Promise<string>;
-export declare function buildWindowsRestartHelper(deviceId: string, currentPid?: number): string;
-export declare function scheduleDeviceRuntimeRestart(options: {
+export declare function findCurrentPackageRoot(entrypoint?: string): Promise<string>;
+export declare function prepareDevicePackageUpdate(options: {
+    targetVersion: string;
+    requestId: string;
     deviceId: string;
-    platform?: NodeJS.Platform | string;
+    childPid?: number | null;
+    fromVersion?: string;
     argv?: string[];
-    delayMs?: number;
+    platform?: NodeJS.Platform | string;
+    execFile?: ExecFileFn;
+    paths?: DeviceStatePaths;
+    entrypoint?: string;
+    nodePath?: string;
+    packageRoot?: string;
+    npmCliPath?: string;
+    globalPrefix?: string;
+    globalRoot?: string;
+    managerOverride?: DeviceUpdateManagerOverride;
+    helperSourcePath?: string;
+}): Promise<PreparedDeviceUpdate>;
+export declare function launchDeviceUpdateHelper(prepared: PreparedDeviceUpdate, options?: {
+    execFile?: ExecFileFn;
     spawn?: typeof spawnCallback;
-    exit?: (code?: number) => never | void;
-}): void;
+    platform?: NodeJS.Platform | string;
+    paths?: DeviceStatePaths;
+}): Promise<void>;
+export declare function signalDeviceUpdateHandoff(handoff?: {
+    childPid?: number | null;
+}, paths?: DeviceStatePaths): Promise<void>;
+export declare function markPreparedUpdateFailed(code: string, message: string, paths?: DeviceStatePaths): Promise<void>;
+export type UpdateReconciliation = {
+    action: 'none';
+} | {
+    action: 'success';
+    state: DeviceUpdateState;
+} | {
+    action: 'report-failed';
+    state: DeviceUpdateState;
+};
+export declare function reconcileDeviceUpdateAfterStart(currentVersion?: string, paths?: DeviceStatePaths): Promise<UpdateReconciliation>;
+export declare function retireDeviceUpdateState(state: DeviceUpdateState, paths?: DeviceStatePaths): Promise<void>;
+export {};