hagiscript-sdk 0.2.9-dev.1780142424.1.dedbfb7

package/dist/src/runtime/runtime-paths.d.ts

@@ -0,0 +1,45 @@
+import type { LoadedRuntimeManifest } from "./runtime-manifest.js";
+export declare const defaultRuntimeRoot = "~/.hagicode/runtime";
+export interface ResolvedRuntimePaths {
+    root: string;
+    runtimeHome: string;
+    runtimeDataRoot: string;
+    serverProgramRoot: string;
+    serverDataRoot: string;
+    bin: string;
+    config: string;
+    logs: string;
+    data: string;
+    stateFile: string;
+    componentsRoot: string;
+    componentDataRoot: string;
+    defaultPm2Home: string;
+    npmPrefix: string;
+    nodeRuntime: string;
+    dotnetRuntime: string;
+    vendoredRoot: string;
+}
+export interface ResolveRuntimePathsOptions {
+    runtimeRoot?: string;
+    runtimeHome?: string;
+    runtimeDataRoot?: string;
+    serverProgramRoot?: string;
+    serverDataRoot?: string;
+}
+export declare function resolveRuntimePaths(manifest: LoadedRuntimeManifest, options?: ResolveRuntimePathsOptions): ResolvedRuntimePaths;
+export declare function normalizeManagedRoot(value: string): string;
+export declare function resolveManagedPath(pathValue: string, runtimeRoot: string): string;
+export declare function resolveReleasedServicePath(pathValue: string, componentRoot: string): string;
+export declare function getComponentManagedRoot(paths: ResolvedRuntimePaths, componentName: string): string;
+export declare function getRuntimeComponentsRoot(paths: ResolvedRuntimePaths): string;
+export declare function sanitizeRuntimeComponentVersionSegment(version: string): string;
+export declare function getVersionedRuntimeComponentRoot(paths: ResolvedRuntimePaths, componentDirectoryName: string, version: string): string;
+export declare function getServerProgramRoot(paths: ResolvedRuntimePaths): string;
+export declare function getServerVersionsRoot(paths: ResolvedRuntimePaths): string;
+export declare function getServerVersionRoot(paths: ResolvedRuntimePaths, version: string): string;
+export declare function getServerSharedDataRoot(paths: ResolvedRuntimePaths): string;
+export declare function getComponentConfigDirectory(paths: ResolvedRuntimePaths, componentName: string, runtimeDataDir?: string): string;
+export declare function getComponentLogsDirectory(paths: ResolvedRuntimePaths, componentName: string, runtimeDataDir?: string): string;
+export declare function getComponentRuntimeDataHome(paths: ResolvedRuntimePaths, componentName: string, runtimeDataDir?: string): string;
+export declare function getComponentPm2Home(paths: ResolvedRuntimePaths, componentName: string, runtimeDataDir?: string, pm2Home?: string, defaultHomeName?: string): string;
+export declare function isPathInsideRuntimeRoot(runtimeRoot: string, targetPath: string): boolean;

package/dist/src/runtime/runtime-paths.js

@@ -0,0 +1,138 @@
+import { homedir } from "node:os";
+import { join, posix, relative, resolve, win32 } from "node:path";
+export const defaultRuntimeRoot = "~/.hagicode/runtime";
+export function resolveRuntimePaths(manifest, options = {}) {
+    const root = normalizeManagedRoot(options.runtimeRoot ?? manifest.paths.runtimeRoot ?? defaultRuntimeRoot);
+    const runtimeHome = options.runtimeHome
+        ? resolveManagedPath(options.runtimeHome, root)
+        : resolveManagedPath(manifest.paths.runtimeHome, root);
+    const runtimeDataRoot = options.runtimeDataRoot
+        ? resolveManagedPath(options.runtimeDataRoot, root)
+        : resolveManagedPath(manifest.paths.runtimeDataRoot, root);
+    const serverProgramRoot = options.serverProgramRoot
+        ? resolveManagedPath(options.serverProgramRoot, root)
+        : manifest.paths.serverProgramRoot
+            ? resolveManagedPath(manifest.paths.serverProgramRoot, root)
+            : join(runtimeHome, "server");
+    const serverDataRoot = options.serverDataRoot
+        ? resolveManagedPath(options.serverDataRoot, root)
+        : manifest.paths.serverDataRoot
+            ? resolveManagedPath(manifest.paths.serverDataRoot, root)
+            : join(runtimeDataRoot, "server");
+    return {
+        root,
+        runtimeHome,
+        runtimeDataRoot,
+        serverProgramRoot,
+        serverDataRoot,
+        bin: resolveManagedPath(manifest.paths.bin, runtimeHome),
+        config: resolveManagedPath(manifest.paths.config, runtimeDataRoot),
+        logs: resolveManagedPath(manifest.paths.logs, runtimeDataRoot),
+        data: resolveManagedPath(manifest.paths.data, runtimeDataRoot),
+        stateFile: resolveManagedPath(manifest.paths.stateFile, runtimeDataRoot),
+        componentsRoot: resolveManagedPath(manifest.paths.componentsRoot, runtimeHome),
+        componentDataRoot: resolveManagedPath(manifest.paths.componentDataRoot, runtimeDataRoot),
+        defaultPm2Home: manifest.paths.defaultPm2Home,
+        npmPrefix: resolveManagedPath(manifest.paths.npmPrefix, runtimeDataRoot),
+        nodeRuntime: resolveManagedPath(manifest.paths.nodeRuntime, runtimeHome),
+        dotnetRuntime: resolveManagedPath(manifest.paths.dotnetRuntime, runtimeHome),
+        vendoredRoot: resolveManagedPath(manifest.paths.vendoredRoot, runtimeHome)
+    };
+}
+export function normalizeManagedRoot(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error("Managed runtime root must be a non-empty path.");
+    }
+    return resolve(expandHomeDirectory(trimmed));
+}
+export function resolveManagedPath(pathValue, runtimeRoot) {
+    const expanded = expandHomeDirectory(pathValue.trim());
+    const absolutePath = resolvePortableAbsolutePath(expanded);
+    return absolutePath ?? resolve(runtimeRoot, expanded);
+}
+export function resolveReleasedServicePath(pathValue, componentRoot) {
+    return resolveManagedPath(pathValue, componentRoot);
+}
+export function getComponentManagedRoot(paths, componentName) {
+    switch (componentName) {
+        case "node":
+            return paths.nodeRuntime;
+        case "dotnet":
+            return paths.dotnetRuntime;
+        case "omniroute":
+        case "code-server":
+            return join(paths.vendoredRoot, componentName);
+        case "server":
+            return paths.serverProgramRoot;
+        default:
+            return join(paths.componentsRoot, componentName);
+    }
+}
+export function getRuntimeComponentsRoot(paths) {
+    return join(paths.runtimeDataRoot, "runtimeComponents");
+}
+export function sanitizeRuntimeComponentVersionSegment(version) {
+    const normalized = version.trim().replaceAll(/[^A-Za-z0-9._-]+/g, "-");
+    const sanitized = normalized.replaceAll(/^[.-]+|[.-]+$/g, "");
+    if (!sanitized) {
+        throw new Error(`Managed runtime component version is invalid: ${JSON.stringify(version)}`);
+    }
+    return sanitized;
+}
+export function getVersionedRuntimeComponentRoot(paths, componentDirectoryName, version) {
+    return join(getRuntimeComponentsRoot(paths), componentDirectoryName, sanitizeRuntimeComponentVersionSegment(version));
+}
+export function getServerProgramRoot(paths) {
+    return paths.serverProgramRoot;
+}
+export function getServerVersionsRoot(paths) {
+    return join(getServerProgramRoot(paths), "versions");
+}
+export function getServerVersionRoot(paths, version) {
+    return join(getServerVersionsRoot(paths), version);
+}
+export function getServerSharedDataRoot(paths) {
+    return paths.serverDataRoot;
+}
+export function getComponentConfigDirectory(paths, componentName, runtimeDataDir) {
+    return join(getComponentRuntimeDataHome(paths, componentName, runtimeDataDir), "config");
+}
+export function getComponentLogsDirectory(paths, componentName, runtimeDataDir) {
+    return join(getComponentRuntimeDataHome(paths, componentName, runtimeDataDir), "logs");
+}
+export function getComponentRuntimeDataHome(paths, componentName, runtimeDataDir) {
+    if (componentName === "server") {
+        return paths.serverDataRoot;
+    }
+    return resolveManagedPath(runtimeDataDir ?? componentName, paths.componentDataRoot);
+}
+export function getComponentPm2Home(paths, componentName, runtimeDataDir, pm2Home, defaultHomeName) {
+    if (pm2Home) {
+        return resolveManagedPath(pm2Home, getComponentRuntimeDataHome(paths, componentName, runtimeDataDir));
+    }
+    return resolveManagedPath(`~/.hagiscript/pm2/${defaultHomeName ?? componentName}`, paths.root);
+}
+export function isPathInsideRuntimeRoot(runtimeRoot, targetPath) {
+    const relativePath = relative(resolve(runtimeRoot), resolve(targetPath));
+    return relativePath === "" || (!relativePath.startsWith("..") && !relativePath.startsWith("../"));
+}
+function expandHomeDirectory(value) {
+    if (value === "~") {
+        return homedir();
+    }
+    if (value.startsWith("~/")) {
+        return join(homedir(), value.slice(2));
+    }
+    return value;
+}
+function resolvePortableAbsolutePath(value) {
+    if (posix.isAbsolute(value)) {
+        return posix.normalize(value);
+    }
+    if (win32.isAbsolute(value)) {
+        return win32.normalize(value);
+    }
+    return undefined;
+}
+//# sourceMappingURL=runtime-paths.js.map

package/dist/src/runtime/runtime-paths.js.map

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

package/dist/src/runtime/runtime-state.d.ts

@@ -0,0 +1,45 @@
+import type { LoadedRuntimeManifest } from "./runtime-manifest.js";
+import type { ResolvedRuntimePaths } from "./runtime-paths.js";
+export type RuntimeComponentStatus = "not-installed" | "installed" | "removed" | "failed";
+export interface RuntimeComponentState {
+    name: string;
+    type: string;
+    status: RuntimeComponentStatus;
+    version: string | null;
+    managedProgramPaths: string[];
+    managedDataPaths: string[];
+    managedPaths: string[];
+    lastAction: "install" | "remove" | "update" | null;
+    lastUpdatedAt: string | null;
+    logFile: string | null;
+    details?: Record<string, unknown>;
+}
+export interface RuntimeOperationState {
+    phase: "install" | "remove" | "update";
+    status: "success" | "failed";
+    selectedComponents: string[];
+    completedComponents: string[];
+    startedAt: string;
+    finishedAt: string;
+    logFile: string | null;
+    message?: string;
+}
+export interface RuntimeState {
+    schemaVersion: 1;
+    runtime: {
+        name: string;
+        version: string;
+        manifestPath: string;
+    };
+    managedRoot: string;
+    managedPaths: ResolvedRuntimePaths;
+    components: Record<string, RuntimeComponentState>;
+    lastOperation: RuntimeOperationState | null;
+}
+export declare class RuntimeStateError extends Error {
+    constructor(message: string);
+}
+export declare function createInitialRuntimeState(manifest: LoadedRuntimeManifest, paths: ResolvedRuntimePaths): RuntimeState;
+export declare function readRuntimeState(statePath: string): Promise<RuntimeState | null>;
+export declare function writeRuntimeState(statePath: string, state: RuntimeState): Promise<void>;
+export declare function mergeRuntimeState(manifest: LoadedRuntimeManifest, paths: ResolvedRuntimePaths, state: RuntimeState | null): RuntimeState;

package/dist/src/runtime/runtime-state.js

@@ -0,0 +1,82 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+export class RuntimeStateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RuntimeStateError";
+    }
+}
+export function createInitialRuntimeState(manifest, paths) {
+    return {
+        schemaVersion: 1,
+        runtime: {
+            name: manifest.runtime.name,
+            version: manifest.runtime.version,
+            manifestPath: manifest.manifestPath
+        },
+        managedRoot: paths.root,
+        managedPaths: paths,
+        components: {},
+        lastOperation: null
+    };
+}
+export async function readRuntimeState(statePath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(statePath, "utf8"));
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return null;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RuntimeStateError(`Failed to read runtime state ${statePath}: ${message}`);
+    }
+    return validateRuntimeState(parsed, statePath);
+}
+export async function writeRuntimeState(statePath, state) {
+    await mkdir(dirname(statePath), { recursive: true });
+    await writeFile(statePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+}
+export function mergeRuntimeState(manifest, paths, state) {
+    const nextState = state ?? createInitialRuntimeState(manifest, paths);
+    return {
+        ...nextState,
+        runtime: {
+            name: manifest.runtime.name,
+            version: manifest.runtime.version,
+            manifestPath: manifest.manifestPath
+        },
+        managedRoot: paths.root,
+        managedPaths: paths,
+        components: { ...nextState.components }
+    };
+}
+function validateRuntimeState(value, statePath) {
+    if (!isRecord(value)) {
+        throw new RuntimeStateError(`Runtime state ${statePath} must be a JSON object.`);
+    }
+    if (value.schemaVersion !== 1) {
+        throw new RuntimeStateError(`Runtime state ${statePath} has unsupported schemaVersion ${String(value.schemaVersion)}.`);
+    }
+    if (!isRecord(value.runtime) || typeof value.runtime.name !== "string" || typeof value.runtime.version !== "string") {
+        throw new RuntimeStateError(`Runtime state ${statePath} is missing runtime metadata.`);
+    }
+    if (!isRecord(value.managedPaths)) {
+        throw new RuntimeStateError(`Runtime state ${statePath} is missing managedPaths.`);
+    }
+    if (!isRecord(value.components)) {
+        throw new RuntimeStateError(`Runtime state ${statePath} is missing components.`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isMissingFileError(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        typeof error.code === "string" &&
+        error.code === "ENOENT");
+}
+//# sourceMappingURL=runtime-state.js.map

package/dist/src/runtime/runtime-state.js.map

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

package/dist/src/runtime/server-config.d.ts

@@ -0,0 +1,21 @@
+export interface ManagedServerConfigOptions {
+    manifestPath?: string;
+    runtimeRoot?: string;
+}
+export interface ManagedServerConfigUpdate {
+    host?: string;
+    port?: number;
+}
+export interface ManagedServerConfigResult {
+    host: string;
+    port: number;
+    aspNetCoreUrls: string;
+    configPath: string;
+    source: "manifest-default" | "config-file";
+}
+export declare class ManagedServerConfigError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function getManagedServerConfig(options?: ManagedServerConfigOptions): Promise<ManagedServerConfigResult>;
+export declare function setManagedServerConfig(update: ManagedServerConfigUpdate, options?: ManagedServerConfigOptions): Promise<ManagedServerConfigResult>;
+export declare function buildAspNetCoreUrls(host: string, port: number): string;

package/dist/src/runtime/server-config.js

@@ -0,0 +1,169 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { getServerSharedDataRoot, resolveRuntimePaths } from "./runtime-paths.js";
+import { loadRuntimeManifest } from "./runtime-manifest.js";
+const SERVER_CONFIG_FILE_NAME = "server-config.json";
+const DEFAULT_SERVER_HOST = "127.0.0.1";
+const DEFAULT_SERVER_PORT = 39150;
+export class ManagedServerConfigError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ManagedServerConfigError";
+    }
+}
+export async function getManagedServerConfig(options = {}) {
+    const context = await resolveServerConfigContext(options);
+    const persisted = await readPersistedConfig(context.configPath);
+    if (!persisted) {
+        return {
+            ...context.defaults,
+            configPath: context.configPath,
+            source: "manifest-default"
+        };
+    }
+    const host = normalizeHost(persisted.host);
+    const port = normalizePort(persisted.port);
+    const explicitUrl = normalizeAspNetCoreUrls(persisted.aspNetCoreUrls);
+    return {
+        host: host ?? context.defaults.host,
+        port: port ?? context.defaults.port,
+        aspNetCoreUrls: explicitUrl ??
+            buildAspNetCoreUrls(host ?? context.defaults.host, port ?? context.defaults.port),
+        configPath: context.configPath,
+        source: "config-file"
+    };
+}
+export async function setManagedServerConfig(update, options = {}) {
+    const normalizedHost = update.host === undefined ? undefined : validateHost(update.host);
+    const normalizedPort = update.port === undefined ? undefined : validatePort(update.port);
+    if (normalizedHost === undefined && normalizedPort === undefined) {
+        throw new ManagedServerConfigError("Provide at least one update value: --host and/or --port.");
+    }
+    const current = await getManagedServerConfig(options);
+    const nextHost = normalizedHost ?? current.host;
+    const nextPort = normalizedPort ?? current.port;
+    const next = {
+        host: nextHost,
+        port: nextPort,
+        aspNetCoreUrls: buildAspNetCoreUrls(nextHost, nextPort),
+        configPath: current.configPath,
+        source: "config-file"
+    };
+    await mkdir(dirname(next.configPath), { recursive: true });
+    await writeFile(next.configPath, JSON.stringify({
+        host: next.host,
+        port: next.port,
+        aspNetCoreUrls: next.aspNetCoreUrls,
+        updatedAt: new Date().toISOString()
+    }, null, 2) + "\n", "utf8");
+    return next;
+}
+export function buildAspNetCoreUrls(host, port) {
+    const normalizedHost = validateHost(host);
+    const normalizedPort = validatePort(port);
+    return `http://${normalizedHost}:${normalizedPort}`;
+}
+async function resolveServerConfigContext(options) {
+    const manifest = await loadRuntimeManifest({ manifestPath: options.manifestPath });
+    const serverComponent = manifest.componentMap.get("server");
+    if (!serverComponent) {
+        throw new ManagedServerConfigError("Runtime manifest does not define a server component.");
+    }
+    const paths = resolveRuntimePaths(manifest, { runtimeRoot: options.runtimeRoot });
+    const configDir = join(getServerSharedDataRoot(paths), "config");
+    const configPath = join(configDir, SERVER_CONFIG_FILE_NAME);
+    const manifestUrls = serverComponent.pm2?.env?.ASPNETCORE_URLS;
+    const parsedManifestUrls = parseAspNetCoreUrl(manifestUrls);
+    const host = parsedManifestUrls?.host ?? DEFAULT_SERVER_HOST;
+    const port = parsedManifestUrls?.port ?? DEFAULT_SERVER_PORT;
+    return {
+        configPath,
+        defaults: {
+            host,
+            port,
+            aspNetCoreUrls: buildAspNetCoreUrls(host, port)
+        }
+    };
+}
+async function readPersistedConfig(configPath) {
+    try {
+        const content = await readFile(configPath, "utf8");
+        const parsed = JSON.parse(content);
+        if (!parsed || typeof parsed !== "object") {
+            throw new ManagedServerConfigError(`Managed server config must be a JSON object: ${configPath}`);
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return undefined;
+        }
+        if (error instanceof ManagedServerConfigError) {
+            throw error;
+        }
+        throw new ManagedServerConfigError(`Failed to read managed server config: ${configPath}`, error instanceof Error ? { cause: error } : undefined);
+    }
+}
+function parseAspNetCoreUrl(value) {
+    const normalized = normalizeAspNetCoreUrls(value);
+    if (!normalized) {
+        return undefined;
+    }
+    const firstEntry = normalized
+        .split(";")
+        .map((entry) => entry.trim())
+        .find(Boolean);
+    if (!firstEntry) {
+        return undefined;
+    }
+    const matched = /^https?:\/\/([^:/\s]+|\[[^\]]+\]):(\d+)$/u.exec(firstEntry);
+    if (!matched) {
+        return undefined;
+    }
+    const host = normalizeHost(matched[1]);
+    const port = normalizePort(Number(matched[2]));
+    if (!host || !port) {
+        return undefined;
+    }
+    return { host, port };
+}
+function normalizeAspNetCoreUrls(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized ? normalized : undefined;
+}
+function normalizeHost(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized ? normalized : undefined;
+}
+function validateHost(value) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new ManagedServerConfigError("Server host must be a non-empty string.");
+    }
+    if (/\s/u.test(normalized)) {
+        throw new ManagedServerConfigError("Server host cannot contain whitespace.");
+    }
+    return normalized;
+}
+function normalizePort(value) {
+    if (typeof value === "number" && Number.isInteger(value)) {
+        return value;
+    }
+    if (typeof value === "string" && /^\d+$/u.test(value.trim())) {
+        return Number.parseInt(value.trim(), 10);
+    }
+    return undefined;
+}
+function validatePort(value) {
+    if (!Number.isInteger(value) || value < 1 || value > 65535) {
+        throw new ManagedServerConfigError("Server port must be an integer between 1 and 65535.");
+    }
+    return value;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/src/runtime/server-config.js.map

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

package/dist/src/runtime/server-manager.d.ts

@@ -0,0 +1,107 @@
+import { rm } from "node:fs/promises";
+import { type CommandRunner } from "./command-launch.js";
+import { type ManagedPm2CommandResult, type ManagedPm2EnvironmentResult } from "./pm2-manager.js";
+import { installRuntime, queryRuntimeState, type RuntimeStateReport, type RuntimeLifecycleResult } from "./runtime-manager.js";
+import { type ManagedServerVersionSummary } from "./server-version-state.js";
+export type ManagedServerSourceKind = "github-release" | "http-index" | "direct-url" | "local-archive" | "local-folder";
+export interface ManagedServerInstallOptions {
+    manifestPath?: string;
+    runtimeRoot?: string;
+    archivePath?: string;
+    packageDirectory?: string;
+    url?: string;
+    indexUrl?: string;
+    indexChannel?: string;
+    indexVersion?: string;
+    githubRepository?: string;
+    githubTag?: string;
+    assetName?: string;
+    force?: boolean;
+    ensurePm2?: boolean;
+    pm2Version?: string;
+    registryMirror?: string;
+    downloadCache?: boolean;
+    downloadCacheDir?: string;
+    githubToken?: string;
+    logger?: (message: string) => void;
+    fetchImpl?: typeof fetch;
+    runner?: CommandRunner;
+    extractArchive?: (archivePath: string, extractRoot: string, runner: CommandRunner) => Promise<void>;
+    installRuntimeFn?: typeof installRuntime;
+    queryRuntimeStateFn?: typeof queryRuntimeState;
+}
+export interface ManagedServerInstallResult {
+    source: {
+        kind: ManagedServerSourceKind;
+        locator: string;
+        version: string | null;
+        assetName: string;
+    };
+    installedVersion: string;
+    activeVersion: string;
+    stagedPath: string;
+    stagedDllPath: string;
+    statePath: string;
+    sharedDataRoot: string;
+    runtimeLifecycle: RuntimeLifecycleResult;
+    runtimeState: RuntimeStateReport;
+    pm2: {
+        ensured: boolean;
+        versionRange: string | null;
+    };
+}
+export interface ManagedServerLifecycleOptions {
+    manifestPath?: string;
+    runtimeRoot?: string;
+    instanceName?: string;
+}
+export interface ManagedServerEnvironmentResult {
+    host: string;
+    port: number;
+    aspNetCoreUrls: string;
+    configPath: string;
+    sharedDataRoot: string;
+    environment: Record<string, string>;
+}
+export interface ManagedServerVersionOptions {
+    manifestPath?: string;
+    runtimeRoot?: string;
+}
+export interface ManagedServerUseVersionOptions extends ManagedServerVersionOptions {
+    version: string;
+}
+export interface ManagedServerRemoveVersionOptions extends ManagedServerVersionOptions {
+    version: string;
+    removeDirectoryFn?: typeof rm;
+    retryDelayMs?: number;
+}
+export interface ManagedServerListResult {
+    activeVersion: string | null;
+    versions: ManagedServerVersionSummary[];
+    statePath: string;
+    sharedDataRoot: string;
+}
+export interface ManagedServerUseVersionResult {
+    previousActiveVersion: string | null;
+    activeVersion: string;
+    statePath: string;
+}
+export interface ManagedServerRemoveVersionResult {
+    activeVersion: string | null;
+    removedVersion: string;
+    removedPath: string;
+    statePath: string;
+}
+export declare class ManagedServerError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function installManagedServer(options?: ManagedServerInstallOptions): Promise<ManagedServerInstallResult>;
+export declare function startManagedServer(options?: ManagedServerLifecycleOptions): Promise<ManagedPm2CommandResult>;
+export declare function listManagedServerVersions(options?: ManagedServerVersionOptions): Promise<ManagedServerListResult>;
+export declare function useManagedServerVersion(options: ManagedServerUseVersionOptions): Promise<ManagedServerUseVersionResult>;
+export declare function removeManagedServerInstalledVersion(options: ManagedServerRemoveVersionOptions): Promise<ManagedServerRemoveVersionResult>;
+export declare function restartManagedServer(options?: ManagedServerLifecycleOptions): Promise<ManagedPm2CommandResult>;
+export declare function stopManagedServer(options?: ManagedServerLifecycleOptions): Promise<ManagedPm2CommandResult>;
+export declare function getManagedServerStatus(options?: ManagedServerLifecycleOptions): Promise<ManagedPm2CommandResult>;
+export declare function resolveManagedServerStartupEnvironment(options?: ManagedServerLifecycleOptions): Promise<ManagedPm2EnvironmentResult>;
+export declare function resolveManagedServerEnvironment(options: ManagedServerLifecycleOptions): Promise<ManagedServerEnvironmentResult>;