/**
 * Profile-scoped self-update support for the Web Settings page.
 *
 * Only registry-installed copies are mutable. Local `link:`, `file:`, git,
 * URL, and workspace installs stay developer-owned and are reported as
 * unsupported instead of being replaced behind the user's back.
 * @module dsh-vision-toolkit/plugin-update
 */
import type { Context } from '@deepseek-ai/cordis';
export declare const VISION_TOOLKIT_PACKAGE = "@anionex/dsh-vision-toolkit";
export type PluginUpdateUnavailableReason = 'profile-not-found' | 'not-direct-dependency' | 'unsupported-install-source' | 'profile-read-only' | 'pnpm-unavailable' | 'unsupported-platform' | 'restart-unmanaged' | 'restart-address-unavailable';
export interface PluginUpdateCapability {
    supported: boolean;
    checkSupported?: boolean;
    profile?: string;
    dependencySpec?: string;
    reason?: PluginUpdateUnavailableReason;
}
export interface PluginUpdateCheck extends PluginUpdateCapability {
    currentVersion: string;
    latestVersion?: string;
    updateAvailable: boolean;
    checkedAt: string;
}
interface PluginUpdateResultBase {
    fromVersion: string;
    toVersion: string;
    profile: string;
}
export type PluginUpdateResult = PluginUpdateResultBase & ({
    restarting: true;
    manualRestartRequired?: false;
    retryAfterMs: number;
} | {
    restarting: false;
    manualRestartRequired: true;
    retryAfterMs?: undefined;
});
export declare class PluginUpdateError extends Error {
    readonly code: string;
    constructor(code: string, message: string, options?: ErrorOptions);
}
export interface RestartRequest {
    pid: number;
    execPath: string;
    args: readonly string[];
    cwd: string;
    logPath: string;
    lockPath: string;
    lockToken: string;
    backupDir: string;
    handoffPath: string;
    profileDir: string;
    pnpmPath: string;
    packageName: string;
    fromVersion: string;
    toVersion: string;
    healthUrl: string;
    baselineRuntimeReady: boolean;
    rollbackTimeoutMs: number;
    processKillGraceMs: number;
    readinessTimeoutMs: number;
    oldProcessExitTimeoutMs: number;
}
export interface PluginUpdateServiceOptions {
    packageRoot?: string;
    profileDir?: string;
    dshHome?: string;
    argv?: readonly string[];
    now?: () => Date;
    prepareRestart?: (request: RestartRequest) => void | Promise<void>;
    terminateCurrent?: () => void;
    schedule?: (callback: () => void, delayMs: number) => void;
    allowDetachedRestart?: boolean;
    healthUrl?: string;
    runtimeReady?: () => boolean;
    platform?: NodeJS.Platform;
}
/** @internal Restart helper source exported for lifecycle integration tests. */
export declare const PLUGIN_RESTART_HELPER_SOURCE: string;
/** Compare two strict SemVer versions. */
export declare function compareVersions(left: string, right: string): number;
/** Profile-aware updater used by the same-origin Settings backend. */
export declare class VisionToolkitPluginUpdateService {
    private readonly ctx;
    private readonly currentVersion;
    private readonly packageRoot;
    private readonly profileDir;
    private readonly dshHome;
    private readonly argv;
    private readonly now;
    private readonly prepareRestart;
    private readonly terminateCurrent;
    private readonly schedule;
    private readonly allowDetachedRestart;
    private healthUrl;
    private readonly runtimeReady;
    private readonly platform;
    private updating;
    constructor(ctx: Pick<Context, 'subprocess'>, currentVersion: string, options?: PluginUpdateServiceOptions);
    /** Bind readiness checks to the active WebServer and reject ports that cannot be reproduced on restart. */
    configureWebServer(host: string, port: number): void;
    private inspectProfile;
    private locateProfile;
    private profile;
    private evaluate;
    private checkContext;
    /** Report whether the current installation can be safely replaced in place. */
    capability(): Promise<PluginUpdateCapability>;
    private runPnpm;
    private rollbackInstall;
    private acquireLock;
    /** Query the configured npm registry without mutating the profile. */
    check(): Promise<PluginUpdateCheck>;
    /** Install the currently published version, then restart when this process can do so safely. */
    installAndRestart(expectedVersion: string): Promise<PluginUpdateResult>;
}
export {};
//# sourceMappingURL=plugin-update.d.ts.map