@hagicode/hagiscript 0.1.0-dev.9.1.ba06982

package/dist/runtime/node-platform.js

@@ -0,0 +1,41 @@
+export class UnsupportedNodePlatformError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UnsupportedNodePlatformError";
+    }
+}
+export function mapNodePlatform(platform = process.platform, arch = process.arch) {
+    const os = mapOperatingSystem(platform);
+    const nodeArch = mapArchitecture(arch);
+    return {
+        os,
+        arch: nodeArch,
+        nodeFileKey: `${os}-${nodeArch}`,
+        archiveExtension: os === "win" ? "zip" : "tar.xz",
+        executableName: os === "win" ? "node.exe" : "node",
+        npmExecutableName: os === "win" ? "npm.cmd" : "npm"
+    };
+}
+function mapOperatingSystem(platform) {
+    switch (platform) {
+        case "win32":
+            return "win";
+        case "linux":
+            return "linux";
+        case "darwin":
+            return "darwin";
+        default:
+            throw new UnsupportedNodePlatformError(`Unsupported operating system for Node.js runtime archives: ${platform}`);
+    }
+}
+function mapArchitecture(arch) {
+    switch (arch) {
+        case "x64":
+            return "x64";
+        case "arm64":
+            return "arm64";
+        default:
+            throw new UnsupportedNodePlatformError(`Unsupported CPU architecture for Node.js runtime archives: ${arch}`);
+    }
+}
+//# sourceMappingURL=node-platform.js.map

package/dist/runtime/node-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-platform.js","sourceRoot":"","sources":["../../src/runtime/node-platform.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAC7B,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAC3B,IAAI,GAAG,OAAO,CAAC,IAAI;IAEnB,MAAM,EAAE,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,GAAG,EAAE,IAAI,QAAQ,EAAE;QAChC,gBAAgB,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;QACjD,cAAc,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM;QAClD,iBAAiB,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC;QACf,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB;YACE,MAAM,IAAI,4BAA4B,CACpC,8DAA8D,QAAQ,EAAE,CACzE,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB;YACE,MAAM,IAAI,4BAA4B,CACpC,8DAA8D,IAAI,EAAE,CACrE,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/runtime/node-release.d.ts

@@ -0,0 +1,28 @@
+import { type NodePlatformTarget } from "./node-platform.js";
+export declare const DEFAULT_NODE_MAJOR = 22;
+export declare const OFFICIAL_NODE_DIST_BASE_URL = "https://nodejs.org/dist";
+export interface NodeReleaseMetadata {
+    version: string;
+    lts?: string | boolean;
+    files: string[];
+    npm?: string;
+}
+export interface SelectedNodeArchive {
+    release: NodeReleaseMetadata;
+    version: string;
+    platform: NodePlatformTarget;
+    fileName: string;
+    url: string;
+}
+export declare class NodeVersionSelectorError extends Error {
+    constructor(message: string);
+}
+export declare class NodeRuntimeSourcePolicyError extends Error {
+    constructor(message: string);
+}
+export declare function normalizeVersionSelector(selector?: string): string;
+export declare function validateVersionSelector(selector?: string): void;
+export declare function fetchNodeReleaseMetadata(fetchImpl?: typeof fetch, baseUrl?: string): Promise<NodeReleaseMetadata[]>;
+export declare function resolveNodeRelease(releases: NodeReleaseMetadata[], selector?: string): NodeReleaseMetadata;
+export declare function selectNodeArchive(releases: NodeReleaseMetadata[], selector?: string, platform?: NodePlatformTarget, baseUrl?: string): SelectedNodeArchive;
+export declare function assertOfficialNodeDistBaseUrl(baseUrl: string): void;

package/dist/runtime/node-release.js

@@ -0,0 +1,146 @@
+import { mapNodePlatform } from "./node-platform.js";
+export const DEFAULT_NODE_MAJOR = 22;
+export const OFFICIAL_NODE_DIST_BASE_URL = "https://nodejs.org/dist";
+export class NodeVersionSelectorError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "NodeVersionSelectorError";
+    }
+}
+export class NodeRuntimeSourcePolicyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "NodeRuntimeSourcePolicyError";
+    }
+}
+export function normalizeVersionSelector(selector) {
+    const trimmed = selector?.trim();
+    return trimmed && trimmed.length > 0
+        ? trimmed.toLowerCase()
+        : String(DEFAULT_NODE_MAJOR);
+}
+export function validateVersionSelector(selector) {
+    const normalized = normalizeVersionSelector(selector);
+    if (["lts", "latest", "current"].includes(normalized)) {
+        return;
+    }
+    if (/^v?\d+(?:\.\d+\.\d+)?$/.test(normalized)) {
+        return;
+    }
+    throw new NodeVersionSelectorError(`Invalid Node.js version selector: ${selector ?? ""}. Use lts, latest, current, 22, 22.11.0, or v22.11.0.`);
+}
+export async function fetchNodeReleaseMetadata(fetchImpl = fetch, baseUrl = OFFICIAL_NODE_DIST_BASE_URL) {
+    assertOfficialNodeDistBaseUrl(baseUrl);
+    const response = await fetchImpl(`${baseUrl}/index.json`, {
+        headers: { accept: "application/json" }
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch Node.js release metadata: HTTP ${response.status}`);
+    }
+    const data = (await response.json());
+    if (!Array.isArray(data)) {
+        throw new Error("Node.js release metadata response was not an array.");
+    }
+    return data.map(parseReleaseMetadata);
+}
+export function resolveNodeRelease(releases, selector) {
+    validateVersionSelector(selector);
+    const normalized = normalizeVersionSelector(selector);
+    const sorted = [...releases].sort(compareReleaseDescending);
+    const selected = selectRelease(sorted, normalized);
+    if (!selected) {
+        throw new NodeVersionSelectorError(`No Node.js release matched version selector: ${selector ?? DEFAULT_NODE_MAJOR}`);
+    }
+    return selected;
+}
+export function selectNodeArchive(releases, selector, platform = mapNodePlatform(), baseUrl = OFFICIAL_NODE_DIST_BASE_URL) {
+    assertOfficialNodeDistBaseUrl(baseUrl);
+    const release = resolveNodeRelease(releases, selector);
+    if (!release.files.includes(platform.nodeFileKey)) {
+        throw new Error(`Node.js ${release.version} does not publish an archive for ${platform.nodeFileKey}.`);
+    }
+    const fileName = `node-${release.version}-${platform.nodeFileKey}.${platform.archiveExtension}`;
+    const url = `${baseUrl}/${release.version}/${fileName}`;
+    assertOfficialNodeArchiveUrl(url, baseUrl);
+    return {
+        release,
+        version: release.version,
+        platform,
+        fileName,
+        url
+    };
+}
+export function assertOfficialNodeDistBaseUrl(baseUrl) {
+    let parsed;
+    try {
+        parsed = new URL(baseUrl);
+    }
+    catch {
+        throw new NodeRuntimeSourcePolicyError(`Node.js runtime source is not a valid URL: ${baseUrl}`);
+    }
+    if (parsed.protocol !== "https:" || parsed.hostname !== "nodejs.org") {
+        throw new NodeRuntimeSourcePolicyError(`Node.js runtime source is not governed by the official distribution host: ${baseUrl}`);
+    }
+}
+function assertOfficialNodeArchiveUrl(url, baseUrl) {
+    assertOfficialNodeDistBaseUrl(baseUrl);
+    const parsedUrl = new URL(url);
+    const parsedBaseUrl = new URL(baseUrl);
+    if (parsedUrl.protocol !== "https:" ||
+        parsedUrl.hostname !== parsedBaseUrl.hostname ||
+        !parsedUrl.pathname.startsWith("/dist/v")) {
+        throw new NodeRuntimeSourcePolicyError(`Node.js archive URL violates source policy: ${url}`);
+    }
+}
+function parseReleaseMetadata(value) {
+    if (typeof value !== "object" || value === null) {
+        throw new Error("Node.js release metadata item was not an object.");
+    }
+    const record = value;
+    if (typeof record.version !== "string" || !Array.isArray(record.files)) {
+        throw new Error("Node.js release metadata item is missing version or files.");
+    }
+    return {
+        version: record.version,
+        lts: typeof record.lts === "string" || typeof record.lts === "boolean"
+            ? record.lts
+            : undefined,
+        files: record.files.filter((file) => typeof file === "string"),
+        npm: typeof record.npm === "string" ? record.npm : undefined
+    };
+}
+function selectRelease(releases, selector) {
+    if (selector === "lts") {
+        return releases.find((release) => Boolean(release.lts));
+    }
+    if (selector === "latest" || selector === "current") {
+        return releases[0];
+    }
+    if (/^v?\d+$/.test(selector)) {
+        const major = Number(selector.replace(/^v/, ""));
+        return releases.find((release) => getMajorVersion(release.version) === major);
+    }
+    const exact = selector.startsWith("v") ? selector : `v${selector}`;
+    return releases.find((release) => release.version === exact);
+}
+function compareReleaseDescending(left, right) {
+    const leftParts = parseVersionParts(left.version);
+    const rightParts = parseVersionParts(right.version);
+    for (let index = 0; index < 3; index += 1) {
+        if (leftParts[index] !== rightParts[index]) {
+            return rightParts[index] - leftParts[index];
+        }
+    }
+    return 0;
+}
+function getMajorVersion(version) {
+    return parseVersionParts(version)[0];
+}
+function parseVersionParts(version) {
+    const match = /^v?(\d+)\.(\d+)\.(\d+)$/.exec(version);
+    if (!match) {
+        return [0, 0, 0];
+    }
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+//# sourceMappingURL=node-release.js.map

package/dist/runtime/node-release.js.map

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

package/dist/runtime/node-verify.d.ts

@@ -0,0 +1,20 @@
+export interface RuntimeExecutablePaths {
+    nodePath: string;
+    npmPath: string;
+}
+export interface NodeRuntimeVerificationResult {
+    valid: boolean;
+    targetDirectory: string;
+    nodeVersion?: string;
+    npmVersion?: string;
+    nodePath?: string;
+    npmPath?: string;
+    failureReason?: string;
+}
+export interface VerifyNodeRuntimeOptions {
+    platform?: NodeJS.Platform;
+    timeoutMs?: number;
+    runCommand?: (command: string, args: string[], timeoutMs: number) => Promise<string>;
+}
+export declare function verifyNodeRuntime(targetDirectory: string, options?: VerifyNodeRuntimeOptions): Promise<NodeRuntimeVerificationResult>;
+export declare function getRuntimeExecutablePaths(targetDirectory: string, platform?: NodeJS.Platform): RuntimeExecutablePaths;

package/dist/runtime/node-verify.js

@@ -0,0 +1,66 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { constants } from "node:fs";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function verifyNodeRuntime(targetDirectory, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 15_000;
+    const runCommand = options.runCommand ?? runVersionCommand;
+    const paths = getRuntimeExecutablePaths(targetDirectory, options.platform);
+    try {
+        await access(paths.nodePath, constants.X_OK);
+        await access(paths.npmPath, constants.X_OK);
+        const [nodeVersion, npmVersion] = await Promise.all([
+            runCommand(paths.nodePath, ["--version"], timeoutMs),
+            runCommand(paths.npmPath, ["--version"], timeoutMs)
+        ]);
+        return {
+            valid: true,
+            targetDirectory,
+            nodeVersion: nodeVersion.trim(),
+            npmVersion: npmVersion.trim(),
+            nodePath: paths.nodePath,
+            npmPath: paths.npmPath
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            targetDirectory,
+            nodePath: paths.nodePath,
+            npmPath: paths.npmPath,
+            failureReason: error instanceof Error ? error.message : String(error)
+        };
+    }
+}
+export function getRuntimeExecutablePaths(targetDirectory, platform = process.platform) {
+    if (platform === "win32") {
+        return {
+            nodePath: join(targetDirectory, "node.exe"),
+            npmPath: join(targetDirectory, "npm.cmd")
+        };
+    }
+    return {
+        nodePath: join(targetDirectory, "bin", "node"),
+        npmPath: join(targetDirectory, "bin", "npm")
+    };
+}
+async function runVersionCommand(command, args, timeoutMs) {
+    try {
+        const { stdout } = await execFileAsync(command, args, {
+            timeout: timeoutMs,
+            windowsHide: true,
+            maxBuffer: 1024 * 1024
+        });
+        return stdout;
+    }
+    catch (error) {
+        const execError = error;
+        const stderr = typeof execError.stderr === "string" ? execError.stderr.trim() : "";
+        throw new Error(stderr.length > 0
+            ? stderr
+            : `Command failed: ${command} ${args.join(" ")}`);
+    }
+}
+//# sourceMappingURL=node-verify.js.map

package/dist/runtime/node-verify.js.map

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

package/dist/runtime/npm-global.d.ts

@@ -0,0 +1,20 @@
+export interface NpmCommandResult {
+    command: string;
+    args: string[];
+    stdout: string;
+    stderr: string;
+}
+export interface NpmCommandFailureContext extends NpmCommandResult {
+    exitCode?: string | number | null;
+}
+export declare class NpmCommandError extends Error {
+    readonly context: NpmCommandFailureContext;
+    constructor(message: string, context: NpmCommandFailureContext);
+}
+export interface NpmGlobalCommandOptions {
+    timeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+    runCommand?: (command: string, args: string[], timeoutMs: number) => Promise<NpmCommandResult>;
+}
+export declare function listGlobalPackages(npmPath: string, options?: NpmGlobalCommandOptions): Promise<NpmCommandResult>;
+export declare function installGlobalPackage(npmPath: string, selector: string, options?: NpmGlobalCommandOptions): Promise<NpmCommandResult>;

package/dist/runtime/npm-global.js

@@ -0,0 +1,53 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export class NpmCommandError extends Error {
+    context;
+    constructor(message, context) {
+        super(message);
+        this.name = "NpmCommandError";
+        this.context = context;
+    }
+}
+export async function listGlobalPackages(npmPath, options = {}) {
+    return runNpmCommand(npmPath, ["list", "-g", "--depth=0", "--json"], options);
+}
+export async function installGlobalPackage(npmPath, selector, options = {}) {
+    return runNpmCommand(npmPath, ["install", "-g", selector], options);
+}
+async function runNpmCommand(npmPath, args, options) {
+    const timeoutMs = options.timeoutMs ?? 120_000;
+    const runner = options.runCommand
+        ? options.runCommand
+        : (command, commandArgs, commandTimeoutMs) => execNpmCommand(command, commandArgs, commandTimeoutMs, options.env);
+    return runner(npmPath, args, timeoutMs);
+}
+async function execNpmCommand(command, args, timeoutMs, env) {
+    try {
+        const { stdout, stderr } = await execFileAsync(command, args, {
+            timeout: timeoutMs,
+            windowsHide: true,
+            env,
+            maxBuffer: 10 * 1024 * 1024
+        });
+        return {
+            command,
+            args,
+            stdout,
+            stderr
+        };
+    }
+    catch (error) {
+        const execError = error;
+        const stdout = typeof execError.stdout === "string" ? execError.stdout : "";
+        const stderr = typeof execError.stderr === "string" ? execError.stderr : "";
+        throw new NpmCommandError(`npm command failed: ${command} ${args.join(" ")}`, {
+            command,
+            args,
+            stdout,
+            stderr,
+            exitCode: execError.code
+        });
+    }
+}
+//# sourceMappingURL=npm-global.js.map

package/dist/runtime/npm-global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-global.js","sourceRoot":"","sources":["../../src/runtime/npm-global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0B,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAa1C,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,OAAO,CAA2B;IAE3C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAYD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,UAAmC,EAAE;IAErC,OAAO,aAAa,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,QAAgB,EAChB,UAAmC,EAAE;IAErC,OAAO,aAAa,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,OAAe,EACf,IAAc,EACd,OAAgC;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU;QAC/B,CAAC,CAAC,OAAO,CAAC,UAAU;QACpB,CAAC,CAAC,CAAC,OAAe,EAAE,WAAqB,EAAE,gBAAwB,EAAE,EAAE,CACnE,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1E,OAAO,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,OAAe,EACf,IAAc,EACd,SAAiB,EACjB,GAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE;YAC5D,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,IAAI;YACjB,GAAG;YACH,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QAEH,OAAO;YACL,OAAO;YACP,IAAI;YACJ,MAAM;YACN,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,KAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAE5E,MAAM,IAAI,eAAe,CACvB,uBAAuB,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAClD;YACE,OAAO;YACP,IAAI;YACJ,MAAM;YACN,MAAM;YACN,QAAQ,EAAE,SAAS,CAAC,IAAI;SACzB,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/runtime/npm-sync.d.ts

@@ -0,0 +1,114 @@
+import { NpmCommandError, type NpmGlobalCommandOptions } from "./npm-global.js";
+import { verifyNodeRuntime } from "./node-verify.js";
+import { type CustomAgentCliToolInput, type ToolSyncGroupId, type ToolSyncRequirement } from "./tool-sync-catalog.js";
+export interface NpmSyncManifestEntry {
+    version: string;
+    target?: string;
+    toolId?: string;
+    toolDisplayName?: string;
+    toolGroup?: ToolSyncGroupId;
+    toolRequirement?: ToolSyncRequirement;
+}
+export interface NpmSyncManifest {
+    packages: Record<string, NpmSyncManifestEntry>;
+    syncMode: "packages" | "tools";
+}
+export interface NpmSyncToolManifestSelection {
+    optionalAgentCliSyncEnabled?: boolean;
+    selectedOptionalAgentCliIds?: string[];
+    customAgentClis?: CustomAgentCliToolInput[];
+}
+export interface NpmSyncToolManifest {
+    tools: NpmSyncToolManifestSelection;
+}
+export type InstalledGlobalPackages = Record<string, string>;
+export type NpmSyncActionKind = "noop" | "install" | "upgrade" | "downgrade" | "sync";
+export interface NpmSyncPlannedAction {
+    packageName: string;
+    requiredRange: string;
+    targetSelector: string;
+    selectedInstallSelector: string;
+    installedVersion?: string;
+    action: NpmSyncActionKind;
+    toolId?: string;
+    toolDisplayName?: string;
+    toolGroup?: ToolSyncGroupId;
+    toolRequirement?: ToolSyncRequirement;
+}
+export interface NpmSyncActionResult extends NpmSyncPlannedAction {
+    changed: boolean;
+    command?: string;
+    args?: string[];
+    stdout?: string;
+    stderr?: string;
+}
+export interface NpmSyncRuntimeMetadata {
+    targetDirectory: string;
+    nodePath: string;
+    npmPath: string;
+    nodeVersion: string;
+    npmVersion: string;
+}
+export interface NpmSyncSummary {
+    runtime: NpmSyncRuntimeMetadata;
+    manifestPath: string;
+    packageCount: number;
+    syncMode: NpmSyncManifest["syncMode"];
+    noopCount: number;
+    changedCount: number;
+    actions: NpmSyncActionResult[];
+}
+export interface NpmSyncOptions {
+    runtimePath: string;
+    manifestPath: string;
+    npmOptions?: NpmGlobalCommandOptions;
+    verifyRuntime?: typeof verifyNodeRuntime;
+    onLog?: (event: NpmSyncLogEvent) => void;
+}
+export type NpmSyncLogEvent = {
+    type: "manifest-loaded";
+    manifestPath: string;
+    packageCount: number;
+    syncMode: NpmSyncManifest["syncMode"];
+} | {
+    type: "runtime-valid";
+    runtime: NpmSyncRuntimeMetadata;
+} | {
+    type: "inventory";
+    packages: InstalledGlobalPackages;
+} | {
+    type: "planned-action";
+    action: NpmSyncPlannedAction;
+} | {
+    type: "skip";
+    action: NpmSyncPlannedAction;
+} | {
+    type: "install-start";
+    action: NpmSyncPlannedAction;
+} | {
+    type: "install-complete";
+    action: NpmSyncActionResult;
+} | {
+    type: "summary";
+    summary: NpmSyncSummary;
+};
+export declare class NpmSyncError extends Error {
+    constructor(message: string);
+}
+export declare class NpmManifestValidationError extends NpmSyncError {
+    readonly errors: string[];
+    constructor(errors: string[]);
+}
+export declare class NpmSyncCommandError extends NpmSyncError {
+    readonly packageName?: string;
+    readonly command: string;
+    readonly args: string[];
+    readonly stdout: string;
+    readonly stderr: string;
+    constructor(message: string, error: NpmCommandError, packageName?: string);
+}
+export declare function loadNpmSyncManifest(manifestPath: string): Promise<NpmSyncManifest>;
+export declare function validateNpmSyncManifest(value: unknown): NpmSyncManifest;
+export declare function normalizeGlobalInventory(stdout: string): InstalledGlobalPackages;
+export declare function createNpmSyncPlan(manifest: NpmSyncManifest, installed: InstalledGlobalPackages): NpmSyncPlannedAction[];
+export declare function syncNpmGlobals(options: NpmSyncOptions): Promise<NpmSyncSummary>;