@ai-agent-forge/agent-forge 0.85.0

package/dist/core/package-install-host.js

@@ -0,0 +1,202 @@
+import { createHash } from "node:crypto";
+import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve, sep } from "node:path";
+import { satisfies } from "semver";
+import { CONFIG_DIR_NAME } from "../config.js";
+import { markPathIgnoredByCloudSync } from "../utils/paths.js";
+import { stripBom } from "../utils/text.js";
+export function getPackageTempFolder(agentDir) {
+    const tempFolder = join(agentDir, "tmp", "packages");
+    mkdirSync(tempFolder, { recursive: true, mode: 0o700 });
+    chmodSync(tempFolder, 0o700);
+    return tempFolder;
+}
+export function getNpmCommand(ctx) {
+    const configuredCommand = ctx.settingsManager.getNpmCommand();
+    if (!configuredCommand || configuredCommand.length === 0) {
+        return { command: "npm", args: [] };
+    }
+    const [command, ...args] = configuredCommand;
+    if (!command) {
+        throw new Error("Invalid npmCommand: first array entry must be a non-empty command");
+    }
+    return { command, args };
+}
+export function getPackageManagerName(ctx) {
+    const npmCommand = getNpmCommand(ctx);
+    const commandParts = [npmCommand.command, ...npmCommand.args];
+    const separatorIndex = commandParts.lastIndexOf("--");
+    const packageManagerCommand = separatorIndex >= 0 ? commandParts[separatorIndex + 1] : npmCommand.command;
+    return packageManagerCommand ? basename(packageManagerCommand).replace(/\.(cmd|exe)$/i, "") : "";
+}
+export function getGitDependencyInstallArgs(ctx) {
+    const configuredCommand = ctx.settingsManager.getNpmCommand();
+    if (configuredCommand && configuredCommand.length > 0) {
+        return ["install"];
+    }
+    return ["install", "--omit=dev"];
+}
+export function getNpmInstallArgs(ctx, specs, installRoot) {
+    const packageManagerName = getPackageManagerName(ctx);
+    // Extension packages run inside Agent Forge and resolve its APIs through loader aliases/virtual modules.
+    // Disable peer dependency resolution for managed installs (npm's --legacy-peer-deps, and
+    // equivalent bun/pnpm settings) so package managers do not install or solve host-provided
+    // @agent-forge/* peers. Stale auto-installed host peers can otherwise block updates.
+    if (packageManagerName === "bun") {
+        return ["install", ...specs, "--cwd", installRoot, "--omit=peer"];
+    }
+    if (packageManagerName === "pnpm") {
+        return [
+            "install",
+            ...specs,
+            "--prefix",
+            installRoot,
+            "--config.auto-install-peers=false",
+            "--config.strict-peer-dependencies=false",
+            "--config.strict-dep-builds=false",
+        ];
+    }
+    return ["install", ...specs, "--prefix", installRoot, "--legacy-peer-deps"];
+}
+export function getNpmInstallRoot(ctx, scope, temporary) {
+    if (temporary) {
+        return getTemporaryDir(ctx, "npm");
+    }
+    if (scope === "project") {
+        return join(ctx.cwd, CONFIG_DIR_NAME, "npm");
+    }
+    return join(ctx.agentDir, "npm");
+}
+export function getGitInstallRoot(ctx, scope) {
+    if (scope === "temporary") {
+        return undefined;
+    }
+    if (scope === "project") {
+        return join(ctx.cwd, CONFIG_DIR_NAME, "git");
+    }
+    return join(ctx.agentDir, "git");
+}
+export function getManagedNpmInstallPath(ctx, source, scope) {
+    if (scope === "temporary") {
+        return join(getTemporaryDir(ctx, "npm"), "node_modules", source.name);
+    }
+    if (scope === "project") {
+        return join(ctx.cwd, CONFIG_DIR_NAME, "npm", "node_modules", source.name);
+    }
+    return join(ctx.agentDir, "npm", "node_modules", source.name);
+}
+export function getGitInstallPath(ctx, source, scope) {
+    if (scope === "temporary") {
+        return getTemporaryDir(ctx, `git-${source.host}`, source.path);
+    }
+    const installRoot = getGitInstallRoot(ctx, scope);
+    if (!installRoot) {
+        throw new Error("Missing git install root");
+    }
+    return resolveManagedPath(installRoot, source.host, source.path);
+}
+export function getTemporaryDir(ctx, prefix, suffix) {
+    const root = resolveManagedPath(getPackageTempFolder(ctx.agentDir), prefix);
+    const hash = createHash("sha256")
+        .update(`${prefix}-${suffix ?? ""}`)
+        .digest("hex")
+        .slice(0, 8);
+    return resolveManagedPath(root, hash, suffix ?? "");
+}
+function resolveManagedPath(root, ...parts) {
+    const resolvedRoot = resolve(root);
+    const resolvedPath = resolve(resolvedRoot, ...parts);
+    if (resolvedPath !== resolvedRoot && !resolvedPath.startsWith(`${resolvedRoot}${sep}`)) {
+        throw new Error(`Refusing to use path outside package install root: ${resolvedPath}`);
+    }
+    return resolvedPath;
+}
+export function ensureNpmProject(installRoot) {
+    if (!existsSync(installRoot)) {
+        mkdirSync(installRoot, { recursive: true });
+    }
+    markPathIgnoredByCloudSync(installRoot);
+    ensureGitIgnore(installRoot);
+    const packageJsonPath = join(installRoot, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        const pkgJson = { name: "agent-forge-extensions", private: true };
+        writeFileSync(packageJsonPath, JSON.stringify(pkgJson, null, 2), "utf-8");
+    }
+}
+export function ensureGitIgnore(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const ignorePath = join(dir, ".gitignore");
+    if (!existsSync(ignorePath)) {
+        writeFileSync(ignorePath, "*\n!.gitignore\n", "utf-8");
+    }
+}
+export function getInstalledNpmVersion(installedPath) {
+    const packageJsonPath = join(installedPath, "package.json");
+    if (!existsSync(packageJsonPath))
+        return undefined;
+    try {
+        const content = readFileSync(packageJsonPath, "utf-8");
+        const pkg = JSON.parse(stripBom(content));
+        return pkg.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function installedNpmMatchesConfiguredVersion(source, installedPath) {
+    const installedVersion = getInstalledNpmVersion(installedPath);
+    if (!installedVersion) {
+        return false;
+    }
+    return source.range ? satisfies(installedVersion, source.range) : true;
+}
+export function hasMissingGitDependencies(targetDir) {
+    const packageJsonPath = join(targetDir, "package.json");
+    if (!existsSync(packageJsonPath))
+        return false;
+    try {
+        const manifest = JSON.parse(stripBom(readFileSync(packageJsonPath, "utf-8")));
+        if (!manifest.dependencies || typeof manifest.dependencies !== "object" || Array.isArray(manifest.dependencies)) {
+            return false;
+        }
+        const nodeModulesDir = resolve(targetDir, "node_modules");
+        return Object.keys(manifest.dependencies).some((name) => {
+            const dependencyPath = resolve(nodeModulesDir, name);
+            if (!dependencyPath.startsWith(`${nodeModulesDir}${sep}`))
+                return false;
+            return !existsSync(dependencyPath);
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export function getGitUpdateMarkerPath(targetDir) {
+    return join(dirname(targetDir), `.${basename(targetDir)}.agent-forge-update-incomplete`);
+}
+export function pruneEmptyGitParents(targetDir, installRoot) {
+    if (!installRoot)
+        return;
+    const resolvedRoot = resolve(installRoot);
+    let current = dirname(targetDir);
+    while (current.startsWith(resolvedRoot) && current !== resolvedRoot) {
+        if (!existsSync(current)) {
+            current = dirname(current);
+            continue;
+        }
+        const entries = readdirSync(current);
+        if (entries.length > 0) {
+            break;
+        }
+        try {
+            rmSync(current, { recursive: true, force: true });
+        }
+        catch {
+            break;
+        }
+        current = dirname(current);
+    }
+}
+//# sourceMappingURL=package-install-host.js.map

package/dist/core/package-install-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-install-host.js","sourceRoot":"","sources":["../../src/core/package-install-host.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { basename, dirname, join, resolve, sep } from \"node:path\";\nimport { satisfies } from \"semver\";\nimport { CONFIG_DIR_NAME } from \"../config.ts\";\nimport type { GitSource } from \"../utils/git.ts\";\nimport { markPathIgnoredByCloudSync } from \"../utils/paths.ts\";\nimport { stripBom } from \"../utils/text.ts\";\nimport type { NpmSource, PackageManagerContext, SourceScope } from \"./package-source.ts\";\n\nexport function getPackageTempFolder(agentDir: string): string {\n\tconst tempFolder = join(agentDir, \"tmp\", \"packages\");\n\tmkdirSync(tempFolder, { recursive: true, mode: 0o700 });\n\tchmodSync(tempFolder, 0o700);\n\treturn tempFolder;\n}\n\nexport function getNpmCommand(ctx: PackageManagerContext): { command: string; args: string[] } {\n\tconst configuredCommand = ctx.settingsManager.getNpmCommand();\n\tif (!configuredCommand || configuredCommand.length === 0) {\n\t\treturn { command: \"npm\", args: [] };\n\t}\n\tconst [command, ...args] = configuredCommand;\n\tif (!command) {\n\t\tthrow new Error(\"Invalid npmCommand: first array entry must be a non-empty command\");\n\t}\n\treturn { command, args };\n}\n\nexport function getPackageManagerName(ctx: PackageManagerContext): string {\n\tconst npmCommand = getNpmCommand(ctx);\n\tconst commandParts = [npmCommand.command, ...npmCommand.args];\n\tconst separatorIndex = commandParts.lastIndexOf(\"--\");\n\tconst packageManagerCommand = separatorIndex >= 0 ? commandParts[separatorIndex + 1] : npmCommand.command;\n\treturn packageManagerCommand ? basename(packageManagerCommand).replace(/\\.(cmd|exe)$/i, \"\") : \"\";\n}\n\nexport function getGitDependencyInstallArgs(ctx: PackageManagerContext): string[] {\n\tconst configuredCommand = ctx.settingsManager.getNpmCommand();\n\tif (configuredCommand && configuredCommand.length > 0) {\n\t\treturn [\"install\"];\n\t}\n\treturn [\"install\", \"--omit=dev\"];\n}\n\nexport function getNpmInstallArgs(ctx: PackageManagerContext, specs: string[], installRoot: string): string[] {\n\tconst packageManagerName = getPackageManagerName(ctx);\n\t// Extension packages run inside Agent Forge and resolve its APIs through loader aliases/virtual modules.\n\t// Disable peer dependency resolution for managed installs (npm's --legacy-peer-deps, and\n\t// equivalent bun/pnpm settings) so package managers do not install or solve host-provided\n\t// @agent-forge/* peers. Stale auto-installed host peers can otherwise block updates.\n\tif (packageManagerName === \"bun\") {\n\t\treturn [\"install\", ...specs, \"--cwd\", installRoot, \"--omit=peer\"];\n\t}\n\tif (packageManagerName === \"pnpm\") {\n\t\treturn [\n\t\t\t\"install\",\n\t\t\t...specs,\n\t\t\t\"--prefix\",\n\t\t\tinstallRoot,\n\t\t\t\"--config.auto-install-peers=false\",\n\t\t\t\"--config.strict-peer-dependencies=false\",\n\t\t\t\"--config.strict-dep-builds=false\",\n\t\t];\n\t}\n\treturn [\"install\", ...specs, \"--prefix\", installRoot, \"--legacy-peer-deps\"];\n}\n\nexport function getNpmInstallRoot(ctx: PackageManagerContext, scope: SourceScope, temporary: boolean): string {\n\tif (temporary) {\n\t\treturn getTemporaryDir(ctx, \"npm\");\n\t}\n\tif (scope === \"project\") {\n\t\treturn join(ctx.cwd, CONFIG_DIR_NAME, \"npm\");\n\t}\n\treturn join(ctx.agentDir, \"npm\");\n}\n\nexport function getGitInstallRoot(ctx: PackageManagerContext, scope: SourceScope): string | undefined {\n\tif (scope === \"temporary\") {\n\t\treturn undefined;\n\t}\n\tif (scope === \"project\") {\n\t\treturn join(ctx.cwd, CONFIG_DIR_NAME, \"git\");\n\t}\n\treturn join(ctx.agentDir, \"git\");\n}\n\nexport function getManagedNpmInstallPath(ctx: PackageManagerContext, source: NpmSource, scope: SourceScope): string {\n\tif (scope === \"temporary\") {\n\t\treturn join(getTemporaryDir(ctx, \"npm\"), \"node_modules\", source.name);\n\t}\n\tif (scope === \"project\") {\n\t\treturn join(ctx.cwd, CONFIG_DIR_NAME, \"npm\", \"node_modules\", source.name);\n\t}\n\treturn join(ctx.agentDir, \"npm\", \"node_modules\", source.name);\n}\n\nexport function getGitInstallPath(ctx: PackageManagerContext, source: GitSource, scope: SourceScope): string {\n\tif (scope === \"temporary\") {\n\t\treturn getTemporaryDir(ctx, `git-${source.host}`, source.path);\n\t}\n\tconst installRoot = getGitInstallRoot(ctx, scope);\n\tif (!installRoot) {\n\t\tthrow new Error(\"Missing git install root\");\n\t}\n\treturn resolveManagedPath(installRoot, source.host, source.path);\n}\n\nexport function getTemporaryDir(ctx: PackageManagerContext, prefix: string, suffix?: string): string {\n\tconst root = resolveManagedPath(getPackageTempFolder(ctx.agentDir), prefix);\n\tconst hash = createHash(\"sha256\")\n\t\t.update(`${prefix}-${suffix ?? \"\"}`)\n\t\t.digest(\"hex\")\n\t\t.slice(0, 8);\n\treturn resolveManagedPath(root, hash, suffix ?? \"\");\n}\n\nfunction resolveManagedPath(root: string, ...parts: string[]): string {\n\tconst resolvedRoot = resolve(root);\n\tconst resolvedPath = resolve(resolvedRoot, ...parts);\n\tif (resolvedPath !== resolvedRoot && !resolvedPath.startsWith(`${resolvedRoot}${sep}`)) {\n\t\tthrow new Error(`Refusing to use path outside package install root: ${resolvedPath}`);\n\t}\n\treturn resolvedPath;\n}\n\nexport function ensureNpmProject(installRoot: string): void {\n\tif (!existsSync(installRoot)) {\n\t\tmkdirSync(installRoot, { recursive: true });\n\t}\n\tmarkPathIgnoredByCloudSync(installRoot);\n\tensureGitIgnore(installRoot);\n\tconst packageJsonPath = join(installRoot, \"package.json\");\n\tif (!existsSync(packageJsonPath)) {\n\t\tconst pkgJson = { name: \"agent-forge-extensions\", private: true };\n\t\twriteFileSync(packageJsonPath, JSON.stringify(pkgJson, null, 2), \"utf-8\");\n\t}\n}\n\nexport function ensureGitIgnore(dir: string): void {\n\tif (!existsSync(dir)) {\n\t\tmkdirSync(dir, { recursive: true });\n\t}\n\tconst ignorePath = join(dir, \".gitignore\");\n\tif (!existsSync(ignorePath)) {\n\t\twriteFileSync(ignorePath, \"*\\n!.gitignore\\n\", \"utf-8\");\n\t}\n}\n\nexport function getInstalledNpmVersion(installedPath: string): string | undefined {\n\tconst packageJsonPath = join(installedPath, \"package.json\");\n\tif (!existsSync(packageJsonPath)) return undefined;\n\ttry {\n\t\tconst content = readFileSync(packageJsonPath, \"utf-8\");\n\t\tconst pkg = JSON.parse(stripBom(content)) as { version?: string };\n\t\treturn pkg.version;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport function installedNpmMatchesConfiguredVersion(source: NpmSource, installedPath: string): boolean {\n\tconst installedVersion = getInstalledNpmVersion(installedPath);\n\tif (!installedVersion) {\n\t\treturn false;\n\t}\n\treturn source.range ? satisfies(installedVersion, source.range) : true;\n}\n\nexport function hasMissingGitDependencies(targetDir: string): boolean {\n\tconst packageJsonPath = join(targetDir, \"package.json\");\n\tif (!existsSync(packageJsonPath)) return false;\n\n\ttry {\n\t\tconst manifest = JSON.parse(stripBom(readFileSync(packageJsonPath, \"utf-8\"))) as { dependencies?: unknown };\n\t\tif (!manifest.dependencies || typeof manifest.dependencies !== \"object\" || Array.isArray(manifest.dependencies)) {\n\t\t\treturn false;\n\t\t}\n\n\t\tconst nodeModulesDir = resolve(targetDir, \"node_modules\");\n\t\treturn Object.keys(manifest.dependencies).some((name) => {\n\t\t\tconst dependencyPath = resolve(nodeModulesDir, name);\n\t\t\tif (!dependencyPath.startsWith(`${nodeModulesDir}${sep}`)) return false;\n\t\t\treturn !existsSync(dependencyPath);\n\t\t});\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nexport function getGitUpdateMarkerPath(targetDir: string): string {\n\treturn join(dirname(targetDir), `.${basename(targetDir)}.agent-forge-update-incomplete`);\n}\n\nexport function pruneEmptyGitParents(targetDir: string, installRoot: string | undefined): void {\n\tif (!installRoot) return;\n\tconst resolvedRoot = resolve(installRoot);\n\tlet current = dirname(targetDir);\n\twhile (current.startsWith(resolvedRoot) && current !== resolvedRoot) {\n\t\tif (!existsSync(current)) {\n\t\t\tcurrent = dirname(current);\n\t\t\tcontinue;\n\t\t}\n\t\tconst entries = readdirSync(current);\n\t\tif (entries.length > 0) {\n\t\t\tbreak;\n\t\t}\n\t\ttry {\n\t\t\trmSync(current, { recursive: true, force: true });\n\t\t} catch {\n\t\t\tbreak;\n\t\t}\n\t\tcurrent = dirname(current);\n\t}\n}\n"]}

package/dist/core/package-manager.d.ts

@@ -0,0 +1,93 @@
+import { type ConfiguredPackage, type MissingSourceAction, type PackageManager, type PackageManagerOptions, type PackageUpdate, type ProgressCallback, type ResolvedPaths } from "./package-source.ts";
+export { getPackageTempFolder } from "./package-install-host.ts";
+export type { ConfiguredPackage, MissingSourceAction, PackageManager, PackageUpdate, PathMetadata, ProgressCallback, ProgressEvent, ResolvedPaths, ResolvedResource, } from "./package-source.ts";
+export declare class DefaultPackageManager implements PackageManager {
+    private cwd;
+    private agentDir;
+    private settingsManager;
+    private globalNpmRoot;
+    private globalNpmRootCommandKey;
+    private progressCallback;
+    constructor(options: PackageManagerOptions);
+    private get context();
+    setProgressCallback(callback: ProgressCallback | undefined): void;
+    addSourceToSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    removeSourceFromSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    getInstalledPath(source: string, scope: "user" | "project"): string | undefined;
+    private emitProgress;
+    private withProgress;
+    resolve(onMissing?: (source: string) => Promise<MissingSourceAction>): Promise<ResolvedPaths>;
+    resolveSourceResources(sources: string[], options?: {
+        local?: boolean;
+        temporary?: boolean;
+    }): Promise<ResolvedPaths>;
+    listConfiguredPackages(): ConfiguredPackage[];
+    install(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    installAndPersist(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    remove(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    removeAndPersist(source: string, options?: {
+        local?: boolean;
+    }): Promise<boolean>;
+    update(source?: string): Promise<void>;
+    private updateConfiguredSources;
+    private shouldUpdateNpmSource;
+    private updateNpmBatch;
+    private installNpmBatch;
+    checkForAvailableUpdates(): Promise<PackageUpdate[]>;
+    private resolvePackageSources;
+    private findAutoloadDeltaBase;
+    private installParsedSource;
+    private parseSource;
+    private getBaseDirForScope;
+    private resolvePath;
+    private resolvePathFromBase;
+    private getPackageSourceString;
+    private getSourceMatchKeyForInput;
+    private getSourceMatchKeyForSettings;
+    private packageSourcesMatch;
+    private normalizePackageSourceForSettings;
+    private getPackageIdentity;
+    private dedupePackages;
+    private buildNoMatchingPackageMessage;
+    private getNpmCommand;
+    private getInstalledNpmVersion;
+    private getGitInstallPath;
+    private npmHasAvailableUpdate;
+    private getLatestNpmVersion;
+    private gitHasAvailableUpdate;
+    private getRemoteGitHead;
+    private getLocalGitUpdateTarget;
+    private getGitUpstreamRef;
+    private runGitRemoteCommand;
+    private getGlobalNpmRoot;
+    private getPnpmGlobalPackagePath;
+    private getLegacyGlobalNpmInstallPath;
+    private getNpmInstallPath;
+    private installNpm;
+    private uninstallNpm;
+    private installGit;
+    private updateGit;
+    private repairMissingGitDependencies;
+    private cleanAndInstallGitDependencies;
+    private ensureGitRef;
+    private refreshTemporaryGitSource;
+    private removeGit;
+    private runNpmCommand;
+    private runNpmCommandSync;
+    private spawnCommand;
+    private spawnCaptureCommand;
+    private runCommandCapture;
+    private runCommand;
+    private runCommandSync;
+}
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/core/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/core/package-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChildProcess, ChildProcessByStdio } from \"node:child_process\";\nimport { existsSync, mkdirSync, rmSync, statSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport type { Readable } from \"node:stream\";\nimport { gt, maxSatisfying, rcompare } from \"semver\";\nimport { CONFIG_DIR_NAME } from \"../config.ts\";\nimport { spawnProcess, spawnProcessSync } from \"../utils/child-process.ts\";\nimport type { GitSource } from \"../utils/git.ts\";\nimport { resolvePath as resolvePathWithBase } from \"../utils/paths.ts\";\nimport { isStdoutTakenOver } from \"./output-guard.ts\";\nimport {\n\tensureGitIgnore,\n\tensureNpmProject,\n\tgetGitDependencyInstallArgs,\n\tgetGitInstallPath,\n\tgetGitInstallRoot,\n\tgetGitUpdateMarkerPath,\n\tgetInstalledNpmVersion,\n\tgetManagedNpmInstallPath,\n\tgetNpmCommand,\n\tgetNpmInstallArgs,\n\tgetNpmInstallRoot,\n\tgetPackageManagerName,\n\thasMissingGitDependencies,\n\tinstalledNpmMatchesConfiguredVersion,\n\tpruneEmptyGitParents,\n} from \"./package-install-host.ts\";\nimport { getEnv, isOfflineModeEnabled, runWithConcurrency } from \"./package-process-runner.ts\";\nimport {\n\taddAutoDiscoveredResources,\n\tcollectPackageResources,\n\tcreateAccumulator,\n\tgetTargetMap,\n\tresolveLocalEntries,\n\ttoResolvedPaths,\n} from \"./package-resource-collection.ts\";\nimport { RESOURCE_TYPES } from \"./package-resource-discovery.ts\";\nimport {\n\tbuildNoMatchingPackageMessage,\n\ttype ConfiguredPackage,\n\ttype ConfiguredUpdateSource,\n\tdedupePackages,\n\ttype GitUpdateTarget,\n\tgetBaseDirForScope,\n\tgetPackageIdentity,\n\tgetPackageSourceString,\n\tgetSourceMatchKeyForInput,\n\tgetSourceMatchKeyForSettings,\n\ttype InstalledSourceScope,\n\ttype MissingSourceAction,\n\ttype NpmSource,\n\ttype NpmUpdateTarget,\n\tnormalizePackageSourceForSettings,\n\ttype PackageManager,\n\ttype PackageManagerContext,\n\ttype PackageManagerOptions,\n\ttype PackageUpdate,\n\ttype ParsedSource,\n\ttype PathMetadata,\n\ttype ProgressCallback,\n\ttype ProgressEvent,\n\tparseSource,\n\ttype ResolvedPaths,\n\ttype ResourceAccumulator,\n\tresolvePath,\n\tresolvePathFromBase,\n\ttype SourceScope,\n} from \"./package-source.ts\";\nimport type { PackageSource, SettingsManager } from \"./settings-manager.ts\";\n\nexport { getPackageTempFolder } from \"./package-install-host.ts\";\nexport type {\n\tConfiguredPackage,\n\tMissingSourceAction,\n\tPackageManager,\n\tPackageUpdate,\n\tPathMetadata,\n\tProgressCallback,\n\tProgressEvent,\n\tResolvedPaths,\n\tResolvedResource,\n} from \"./package-source.ts\";\n\nconst NETWORK_TIMEOUT_MS = 10000;\nconst UPDATE_CHECK_CONCURRENCY = 4;\nconst GIT_UPDATE_CONCURRENCY = 4;\n\nexport class DefaultPackageManager implements PackageManager {\n\tprivate cwd: string;\n\tprivate agentDir: string;\n\tprivate settingsManager: SettingsManager;\n\tprivate globalNpmRoot: string | undefined;\n\tprivate globalNpmRootCommandKey: string | undefined;\n\tprivate progressCallback: ProgressCallback | undefined;\n\n\tconstructor(options: PackageManagerOptions) {\n\t\tthis.cwd = resolvePathWithBase(options.cwd);\n\t\tthis.agentDir = resolvePathWithBase(options.agentDir);\n\t\tthis.settingsManager = options.settingsManager;\n\t}\n\n\tprivate get context(): PackageManagerContext {\n\t\treturn { cwd: this.cwd, agentDir: this.agentDir, settingsManager: this.settingsManager };\n\t}\n\n\tsetProgressCallback(callback: ProgressCallback | undefined): void {\n\t\tthis.progressCallback = callback;\n\t}\n\n\taddSourceToSettings(source: string, options?: { local?: boolean }): boolean {\n\t\tconst scope: SourceScope = options?.local ? \"project\" : \"user\";\n\t\tconst currentSettings =\n\t\t\tscope === \"project\" ? this.settingsManager.getProjectSettings() : this.settingsManager.getGlobalSettings();\n\t\tconst currentPackages = currentSettings.packages ?? [];\n\t\tconst normalizedSource = this.normalizePackageSourceForSettings(source, scope);\n\t\tconst matchIndex = currentPackages.findIndex((existing) => this.packageSourcesMatch(existing, source, scope));\n\t\tif (matchIndex !== -1) {\n\t\t\tconst existing = currentPackages[matchIndex];\n\t\t\tif (this.getPackageSourceString(existing) === normalizedSource) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tconst nextPackages = [...currentPackages];\n\t\t\tnextPackages[matchIndex] =\n\t\t\t\ttypeof existing === \"string\" ? normalizedSource : { ...existing, source: normalizedSource };\n\t\t\tif (scope === \"project\") {\n\t\t\t\tthis.settingsManager.setProjectPackages(nextPackages);\n\t\t\t} else {\n\t\t\t\tthis.settingsManager.setPackages(nextPackages);\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\t\tconst nextPackages = [...currentPackages, normalizedSource];\n\t\tif (scope === \"project\") {\n\t\t\tthis.settingsManager.setProjectPackages(nextPackages);\n\t\t} else {\n\t\t\tthis.settingsManager.setPackages(nextPackages);\n\t\t}\n\t\treturn true;\n\t}\n\n\tremoveSourceFromSettings(source: string, options?: { local?: boolean }): boolean {\n\t\tconst scope: SourceScope = options?.local ? \"project\" : \"user\";\n\t\tconst currentSettings =\n\t\t\tscope === \"project\" ? this.settingsManager.getProjectSettings() : this.settingsManager.getGlobalSettings();\n\t\tconst currentPackages = currentSettings.packages ?? [];\n\t\tconst nextPackages = currentPackages.filter((existing) => !this.packageSourcesMatch(existing, source, scope));\n\t\tconst changed = nextPackages.length !== currentPackages.length;\n\t\tif (!changed) {\n\t\t\treturn false;\n\t\t}\n\t\tif (scope === \"project\") {\n\t\t\tthis.settingsManager.setProjectPackages(nextPackages);\n\t\t} else {\n\t\t\tthis.settingsManager.setPackages(nextPackages);\n\t\t}\n\t\treturn true;\n\t}\n\n\tgetInstalledPath(source: string, scope: \"user\" | \"project\"): string | undefined {\n\t\tconst parsed = this.parseSource(source);\n\t\tif (parsed.type === \"npm\") {\n\t\t\tconst path = this.getNpmInstallPath(parsed, scope);\n\t\t\treturn existsSync(path) ? path : undefined;\n\t\t}\n\t\tif (parsed.type === \"git\") {\n\t\t\tconst path = this.getGitInstallPath(parsed, scope);\n\t\t\treturn existsSync(path) ? path : undefined;\n\t\t}\n\t\tif (parsed.type === \"local\") {\n\t\t\tconst baseDir = this.getBaseDirForScope(scope);\n\t\t\tconst path = this.resolvePathFromBase(parsed.path, baseDir);\n\t\t\treturn existsSync(path) ? path : undefined;\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate emitProgress(event: ProgressEvent): void {\n\t\tthis.progressCallback?.(event);\n\t}\n\n\tprivate async withProgress(\n\t\taction: ProgressEvent[\"action\"],\n\t\tsource: string,\n\t\tmessage: string,\n\t\toperation: () => Promise<void>,\n\t): Promise<void> {\n\t\tthis.emitProgress({ type: \"start\", action, source, message });\n\t\ttry {\n\t\t\tawait operation();\n\t\t\tthis.emitProgress({ type: \"complete\", action, source });\n\t\t} catch (error) {\n\t\t\tconst errorMessage = error instanceof Error ? error.message : String(error);\n\t\t\tthis.emitProgress({ type: \"error\", action, source, message: errorMessage });\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync resolve(onMissing?: (source: string) => Promise<MissingSourceAction>): Promise<ResolvedPaths> {\n\t\tconst accumulator = createAccumulator();\n\t\tconst globalSettings = this.settingsManager.getGlobalSettings();\n\t\tconst projectSettings = this.settingsManager.getProjectSettings();\n\n\t\t// Collect all packages with scope (project first so cwd resources win collisions)\n\t\tconst allPackages: Array<{ pkg: PackageSource; scope: SourceScope }> = [];\n\t\tfor (const pkg of projectSettings.packages ?? []) {\n\t\t\tallPackages.push({ pkg, scope: \"project\" });\n\t\t}\n\t\tfor (const pkg of globalSettings.packages ?? []) {\n\t\t\tallPackages.push({ pkg, scope: \"user\" });\n\t\t}\n\n\t\t// Dedupe: project scope wins over global for same package identity\n\t\tconst packageSources = this.dedupePackages(allPackages);\n\t\tawait this.resolvePackageSources(packageSources, accumulator, onMissing);\n\n\t\tconst globalBaseDir = this.agentDir;\n\t\tconst projectBaseDir = join(this.cwd, CONFIG_DIR_NAME);\n\n\t\tfor (const resourceType of RESOURCE_TYPES) {\n\t\t\tconst target = getTargetMap(accumulator, resourceType);\n\t\t\tconst globalEntries = (globalSettings[resourceType] ?? []) as string[];\n\t\t\tconst projectEntries = (projectSettings[resourceType] ?? []) as string[];\n\t\t\tresolveLocalEntries(\n\t\t\t\tprojectEntries,\n\t\t\t\tresourceType,\n\t\t\t\ttarget,\n\t\t\t\t{\n\t\t\t\t\tsource: \"local\",\n\t\t\t\t\tscope: \"project\",\n\t\t\t\t\torigin: \"top-level\",\n\t\t\t\t},\n\t\t\t\tprojectBaseDir,\n\t\t\t);\n\t\t\tresolveLocalEntries(\n\t\t\t\tglobalEntries,\n\t\t\t\tresourceType,\n\t\t\t\ttarget,\n\t\t\t\t{\n\t\t\t\t\tsource: \"local\",\n\t\t\t\t\tscope: \"user\",\n\t\t\t\t\torigin: \"top-level\",\n\t\t\t\t},\n\t\t\t\tglobalBaseDir,\n\t\t\t);\n\t\t}\n\n\t\taddAutoDiscoveredResources(this.cwd, accumulator, globalSettings, projectSettings, globalBaseDir, projectBaseDir);\n\n\t\treturn toResolvedPaths(accumulator);\n\t}\n\n\tasync resolveSourceResources(\n\t\tsources: string[],\n\t\toptions?: { local?: boolean; temporary?: boolean },\n\t): Promise<ResolvedPaths> {\n\t\tconst accumulator = createAccumulator();\n\t\tconst scope: SourceScope = options?.temporary ? \"temporary\" : options?.local ? \"project\" : \"user\";\n\t\tconst packageSources = sources.map((source) => ({ pkg: source as PackageSource, scope }));\n\t\tawait this.resolvePackageSources(packageSources, accumulator);\n\t\treturn toResolvedPaths(accumulator);\n\t}\n\n\tlistConfiguredPackages(): ConfiguredPackage[] {\n\t\tconst globalSettings = this.settingsManager.getGlobalSettings();\n\t\tconst projectSettings = this.settingsManager.getProjectSettings();\n\t\tconst configuredPackages: ConfiguredPackage[] = [];\n\n\t\tfor (const pkg of globalSettings.packages ?? []) {\n\t\t\tconst source = typeof pkg === \"string\" ? pkg : pkg.source;\n\t\t\tconfiguredPackages.push({\n\t\t\t\tsource,\n\t\t\t\tscope: \"user\",\n\t\t\t\tfiltered: typeof pkg === \"object\",\n\t\t\t\tinstalledPath: this.getInstalledPath(source, \"user\"),\n\t\t\t});\n\t\t}\n\n\t\tfor (const pkg of projectSettings.packages ?? []) {\n\t\t\tconst source = typeof pkg === \"string\" ? pkg : pkg.source;\n\t\t\tconfiguredPackages.push({\n\t\t\t\tsource,\n\t\t\t\tscope: \"project\",\n\t\t\t\tfiltered: typeof pkg === \"object\",\n\t\t\t\tinstalledPath: this.getInstalledPath(source, \"project\"),\n\t\t\t});\n\t\t}\n\n\t\treturn configuredPackages;\n\t}\n\n\tasync install(source: string, options?: { local?: boolean }): Promise<void> {\n\t\tconst parsed = this.parseSource(source);\n\t\tconst scope: SourceScope = options?.local ? \"project\" : \"user\";\n\t\tawait this.withProgress(\"install\", source, `Installing ${source}...`, async () => {\n\t\t\tif (parsed.type === \"npm\") {\n\t\t\t\tawait this.installNpm(parsed, scope, false);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.type === \"git\") {\n\t\t\t\tawait this.installGit(parsed, scope);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.type === \"local\") {\n\t\t\t\tconst resolved = this.resolvePath(parsed.path);\n\t\t\t\tif (!existsSync(resolved)) {\n\t\t\t\t\tthrow new Error(`Path does not exist: ${resolved}`);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow new Error(`Unsupported install source: ${source}`);\n\t\t});\n\t}\n\n\tasync installAndPersist(source: string, options?: { local?: boolean }): Promise<void> {\n\t\tawait this.install(source, options);\n\t\tthis.addSourceToSettings(source, options);\n\t}\n\n\tasync remove(source: string, options?: { local?: boolean }): Promise<void> {\n\t\tconst parsed = this.parseSource(source);\n\t\tconst scope: SourceScope = options?.local ? \"project\" : \"user\";\n\t\tawait this.withProgress(\"remove\", source, `Removing ${source}...`, async () => {\n\t\t\tif (parsed.type === \"npm\") {\n\t\t\t\tawait this.uninstallNpm(parsed, scope);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.type === \"git\") {\n\t\t\t\tawait this.removeGit(parsed, scope);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (parsed.type === \"local\") {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow new Error(`Unsupported remove source: ${source}`);\n\t\t});\n\t}\n\n\tasync removeAndPersist(source: string, options?: { local?: boolean }): Promise<boolean> {\n\t\tawait this.remove(source, options);\n\t\treturn this.removeSourceFromSettings(source, options);\n\t}\n\n\tasync update(source?: string): Promise<void> {\n\t\tconst globalSettings = this.settingsManager.getGlobalSettings();\n\t\tconst projectSettings = this.settingsManager.getProjectSettings();\n\t\tconst identity = source ? this.getPackageIdentity(source) : undefined;\n\t\tlet matched = false;\n\t\tconst updateSources: ConfiguredUpdateSource[] = [];\n\n\t\tfor (const pkg of globalSettings.packages ?? []) {\n\t\t\tconst sourceStr = typeof pkg === \"string\" ? pkg : pkg.source;\n\t\t\tif (identity && this.getPackageIdentity(sourceStr, \"user\") !== identity) continue;\n\t\t\tmatched = true;\n\t\t\tupdateSources.push({ source: sourceStr, scope: \"user\" });\n\t\t}\n\t\tfor (const pkg of projectSettings.packages ?? []) {\n\t\t\tconst sourceStr = typeof pkg === \"string\" ? pkg : pkg.source;\n\t\t\tif (identity && this.getPackageIdentity(sourceStr, \"project\") !== identity) continue;\n\t\t\tmatched = true;\n\t\t\tupdateSources.push({ source: sourceStr, scope: \"project\" });\n\t\t}\n\n\t\tif (source && !matched) {\n\t\t\tthrow new Error(\n\t\t\t\tthis.buildNoMatchingPackageMessage(source, [\n\t\t\t\t\t...(globalSettings.packages ?? []),\n\t\t\t\t\t...(projectSettings.packages ?? []),\n\t\t\t\t]),\n\t\t\t);\n\t\t}\n\n\t\tawait this.updateConfiguredSources(updateSources);\n\t}\n\n\tprivate async updateConfiguredSources(sources: ConfiguredUpdateSource[]): Promise<void> {\n\t\tif (isOfflineModeEnabled() || sources.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst npmCandidates: NpmUpdateTarget[] = [];\n\t\tconst gitCandidates: GitUpdateTarget[] = [];\n\n\t\tfor (const entry of sources) {\n\t\t\tconst parsed = this.parseSource(entry.source);\n\t\t\t// Pinned npm versions are fixed. Pinned git refs are configured checkout targets,\n\t\t\t// so include them to reconcile an existing clone when the configured ref changes.\n\t\t\tif (parsed.type === \"npm\") {\n\t\t\t\tif (!parsed.pinned) {\n\t\t\t\t\tnpmCandidates.push({ ...entry, parsed });\n\t\t\t\t}\n\t\t\t} else if (parsed.type === \"git\") {\n\t\t\t\tgitCandidates.push({ ...entry, parsed });\n\t\t\t}\n\t\t}\n\n\t\tconst npmCheckTasks = npmCandidates.map((entry) => async () => ({\n\t\t\tentry,\n\t\t\tshouldUpdate: await this.shouldUpdateNpmSource(entry.parsed, entry.scope),\n\t\t}));\n\t\tconst npmCheckResults = await runWithConcurrency(npmCheckTasks, UPDATE_CHECK_CONCURRENCY);\n\t\tconst userNpmUpdates: NpmUpdateTarget[] = [];\n\t\tconst projectNpmUpdates: NpmUpdateTarget[] = [];\n\t\tfor (const result of npmCheckResults) {\n\t\t\tif (!result.shouldUpdate) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (result.entry.scope === \"user\") {\n\t\t\t\tuserNpmUpdates.push(result.entry);\n\t\t\t} else {\n\t\t\t\tprojectNpmUpdates.push(result.entry);\n\t\t\t}\n\t\t}\n\n\t\tconst tasks: Promise<void>[] = [];\n\t\tif (userNpmUpdates.length > 0) {\n\t\t\ttasks.push(this.updateNpmBatch(userNpmUpdates, \"user\"));\n\t\t}\n\t\tif (projectNpmUpdates.length > 0) {\n\t\t\ttasks.push(this.updateNpmBatch(projectNpmUpdates, \"project\"));\n\t\t}\n\t\tif (gitCandidates.length > 0) {\n\t\t\tconst gitTasks = gitCandidates.map(\n\t\t\t\t(entry) => async () =>\n\t\t\t\t\tthis.withProgress(\"update\", entry.source, `Updating ${entry.source}...`, async () => {\n\t\t\t\t\t\tawait this.updateGit(entry.parsed, entry.scope);\n\t\t\t\t\t}),\n\t\t\t);\n\t\t\ttasks.push(runWithConcurrency(gitTasks, GIT_UPDATE_CONCURRENCY).then(() => {}));\n\t\t}\n\n\t\tawait Promise.all(tasks);\n\t}\n\n\tprivate async shouldUpdateNpmSource(source: NpmSource, scope: InstalledSourceScope): Promise<boolean> {\n\t\tconst installedPath = getManagedNpmInstallPath(this.context, source, scope);\n\t\tconst installedVersion = existsSync(installedPath) ? this.getInstalledNpmVersion(installedPath) : undefined;\n\t\tif (!installedVersion) {\n\t\t\treturn true;\n\t\t}\n\n\t\tconst targetVersion = await this.getLatestNpmVersion(source.version ? source.spec : source.name, source.range);\n\t\treturn gt(targetVersion, installedVersion);\n\t}\n\n\tprivate async updateNpmBatch(sources: NpmUpdateTarget[], scope: InstalledSourceScope): Promise<void> {\n\t\tif (sources.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst sourceLabel = sources.length === 1 ? sources[0].source : `${scope} npm packages`;\n\t\tconst message = sources.length === 1 ? `Updating ${sources[0].source}...` : `Updating ${scope} npm packages...`;\n\t\tconst specs = sources.map((entry) => (entry.parsed.version ? entry.parsed.spec : `${entry.parsed.name}@latest`));\n\n\t\tawait this.withProgress(\"update\", sourceLabel, message, async () => {\n\t\t\tawait this.installNpmBatch(specs, scope);\n\t\t});\n\t}\n\n\tprivate async installNpmBatch(specs: string[], scope: InstalledSourceScope): Promise<void> {\n\t\tconst installRoot = getNpmInstallRoot(this.context, scope, false);\n\t\tensureNpmProject(installRoot);\n\t\tawait this.runNpmCommand(getNpmInstallArgs(this.context, specs, installRoot));\n\t}\n\n\tasync checkForAvailableUpdates(): Promise<PackageUpdate[]> {\n\t\tif (isOfflineModeEnabled()) {\n\t\t\treturn [];\n\t\t}\n\n\t\tconst globalSettings = this.settingsManager.getGlobalSettings();\n\t\tconst projectSettings = this.settingsManager.getProjectSettings();\n\t\tconst allPackages: Array<{ pkg: PackageSource; scope: SourceScope }> = [];\n\t\tfor (const pkg of projectSettings.packages ?? []) {\n\t\t\tallPackages.push({ pkg, scope: \"project\" });\n\t\t}\n\t\tfor (const pkg of globalSettings.packages ?? []) {\n\t\t\tallPackages.push({ pkg, scope: \"user\" });\n\t\t}\n\n\t\tconst packageSources = this.dedupePackages(allPackages);\n\t\tconst checks = packageSources\n\t\t\t.filter(\n\t\t\t\t(entry): entry is { pkg: PackageSource; scope: Exclude<SourceScope, \"temporary\"> } =>\n\t\t\t\t\tentry.scope !== \"temporary\",\n\t\t\t)\n\t\t\t.map((entry) => async (): Promise<PackageUpdate | undefined> => {\n\t\t\t\tconst source = typeof entry.pkg === \"string\" ? entry.pkg : entry.pkg.source;\n\t\t\t\tconst parsed = this.parseSource(source);\n\t\t\t\tif (parsed.type === \"local\" || parsed.pinned) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\tif (parsed.type === \"npm\") {\n\t\t\t\t\tconst installedPath = this.getNpmInstallPath(parsed, entry.scope);\n\t\t\t\t\tif (!existsSync(installedPath)) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\tconst hasUpdate = await this.npmHasAvailableUpdate(parsed, installedPath);\n\t\t\t\t\tif (!hasUpdate) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\tsource,\n\t\t\t\t\t\tdisplayName: parsed.name,\n\t\t\t\t\t\ttype: \"npm\",\n\t\t\t\t\t\tscope: entry.scope,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst installedPath = this.getGitInstallPath(parsed, entry.scope);\n\t\t\t\tif (!existsSync(installedPath)) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\tconst hasUpdate = await this.gitHasAvailableUpdate(installedPath);\n\t\t\t\tif (!hasUpdate) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tsource,\n\t\t\t\t\tdisplayName: `${parsed.host}/${parsed.path}`,\n\t\t\t\t\ttype: \"git\",\n\t\t\t\t\tscope: entry.scope,\n\t\t\t\t};\n\t\t\t});\n\n\t\tconst results = await runWithConcurrency(checks, UPDATE_CHECK_CONCURRENCY);\n\t\treturn results.filter((result): result is PackageUpdate => result !== undefined);\n\t}\n\n\tprivate async resolvePackageSources(\n\t\tsources: Array<{ pkg: PackageSource; scope: SourceScope }>,\n\t\taccumulator: ResourceAccumulator,\n\t\tonMissing?: (source: string) => Promise<MissingSourceAction>,\n\t): Promise<void> {\n\t\tfor (const { pkg, scope } of sources) {\n\t\t\tconst sourceStr = typeof pkg === \"string\" ? pkg : pkg.source;\n\t\t\tconst filter = typeof pkg === \"object\" ? pkg : undefined;\n\t\t\tconst deltaBase = this.findAutoloadDeltaBase(pkg, scope, sources);\n\t\t\tconst resolvedSource = deltaBase?.source ?? sourceStr;\n\t\t\tconst resolvedScope = deltaBase?.scope ?? scope;\n\t\t\tconst parsed = this.parseSource(resolvedSource);\n\t\t\tconst metadata: PathMetadata = { source: sourceStr, scope, origin: \"package\" };\n\n\t\t\tif (parsed.type === \"local\") {\n\t\t\t\tconst baseDir = this.getBaseDirForScope(resolvedScope);\n\t\t\t\tconst resolvedLocal = this.resolvePathFromBase(parsed.path, baseDir);\n\t\t\t\tif (existsSync(resolvedLocal)) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tif (statSync(resolvedLocal).isDirectory()) {\n\t\t\t\t\t\t\tmetadata.baseDir = resolvedLocal;\n\t\t\t\t\t\t\tcollectPackageResources(resolvedLocal, accumulator, filter, metadata);\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Unreadable local path: skip the source.\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst installMissing = async (): Promise<boolean> => {\n\t\t\t\tif (isOfflineModeEnabled()) return false;\n\t\t\t\tif (!onMissing) {\n\t\t\t\t\tawait this.installParsedSource(parsed, resolvedScope);\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\tconst action = await onMissing(resolvedSource);\n\t\t\t\tif (action === \"skip\") return false;\n\t\t\t\tif (action === \"error\") throw new Error(`Missing source: ${resolvedSource}`);\n\t\t\t\tawait this.installParsedSource(parsed, resolvedScope);\n\t\t\t\treturn true;\n\t\t\t};\n\n\t\t\tif (parsed.type === \"npm\") {\n\t\t\t\tlet installedPath = this.getNpmInstallPath(parsed, resolvedScope);\n\t\t\t\tconst needsInstall =\n\t\t\t\t\t!existsSync(installedPath) || !(await installedNpmMatchesConfiguredVersion(parsed, installedPath));\n\t\t\t\tif (needsInstall) {\n\t\t\t\t\tconst installed = await installMissing();\n\t\t\t\t\tif (!installed) continue;\n\t\t\t\t\tinstalledPath = this.getNpmInstallPath(parsed, resolvedScope);\n\t\t\t\t}\n\t\t\t\tmetadata.baseDir = installedPath;\n\t\t\t\tcollectPackageResources(installedPath, accumulator, filter, metadata);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (parsed.type === \"git\") {\n\t\t\t\tconst installedPath = this.getGitInstallPath(parsed, resolvedScope);\n\t\t\t\tif (!existsSync(installedPath)) {\n\t\t\t\t\tconst installed = await installMissing();\n\t\t\t\t\tif (!installed) continue;\n\t\t\t\t} else if (resolvedScope === \"temporary\" && !parsed.pinned && !isOfflineModeEnabled()) {\n\t\t\t\t\tawait this.refreshTemporaryGitSource(parsed, resolvedSource);\n\t\t\t\t}\n\t\t\t\tmetadata.baseDir = installedPath;\n\t\t\t\tcollectPackageResources(installedPath, accumulator, filter, metadata);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate findAutoloadDeltaBase(\n\t\tpkg: PackageSource,\n\t\tscope: SourceScope,\n\t\tsources: Array<{ pkg: PackageSource; scope: SourceScope }>,\n\t): { source: string; scope: SourceScope } | undefined {\n\t\tif (scope !== \"project\" || typeof pkg !== \"object\" || pkg.autoload !== false) return undefined;\n\t\tconst identity = this.getPackageIdentity(pkg.source, scope);\n\t\tconst userEntry = sources.find(\n\t\t\t(entry) =>\n\t\t\t\tentry.scope === \"user\" &&\n\t\t\t\tthis.getPackageIdentity(this.getPackageSourceString(entry.pkg), \"user\") === identity,\n\t\t);\n\t\treturn userEntry ? { source: this.getPackageSourceString(userEntry.pkg), scope: \"user\" } : undefined;\n\t}\n\n\tprivate async installParsedSource(parsed: ParsedSource, scope: SourceScope): Promise<void> {\n\t\tif (parsed.type === \"npm\") {\n\t\t\tawait this.installNpm(parsed, scope, scope === \"temporary\");\n\t\t\treturn;\n\t\t}\n\t\tif (parsed.type === \"git\") {\n\t\t\tawait this.installGit(parsed, scope);\n\t\t\treturn;\n\t\t}\n\t}\n\n\tprivate parseSource(source: string): ParsedSource {\n\t\treturn parseSource(source);\n\t}\n\n\tprivate getBaseDirForScope(scope: SourceScope): string {\n\t\treturn getBaseDirForScope(this.context, scope);\n\t}\n\n\tprivate resolvePath(input: string): string {\n\t\treturn resolvePath(this.context, input);\n\t}\n\n\tprivate resolvePathFromBase(input: string, baseDir: string): string {\n\t\treturn resolvePathFromBase(input, baseDir);\n\t}\n\n\tprivate getPackageSourceString(pkg: PackageSource): string {\n\t\treturn getPackageSourceString(pkg);\n\t}\n\n\tprivate getSourceMatchKeyForInput(source: string): string {\n\t\treturn getSourceMatchKeyForInput(this.context, source);\n\t}\n\n\tprivate getSourceMatchKeyForSettings(source: string, scope: SourceScope): string {\n\t\treturn getSourceMatchKeyForSettings(this.context, source, scope);\n\t}\n\n\tprivate packageSourcesMatch(existing: PackageSource, inputSource: string, scope: SourceScope): boolean {\n\t\tconst left = this.getSourceMatchKeyForSettings(this.getPackageSourceString(existing), scope);\n\t\tconst right = this.getSourceMatchKeyForInput(inputSource);\n\t\treturn left === right;\n\t}\n\n\tprivate normalizePackageSourceForSettings(source: string, scope: SourceScope): string {\n\t\treturn normalizePackageSourceForSettings(this.context, source, scope);\n\t}\n\n\tprivate getPackageIdentity(source: string, scope?: SourceScope): string {\n\t\treturn getPackageIdentity(this.context, source, scope);\n\t}\n\n\tprivate dedupePackages(\n\t\tpackages: Array<{ pkg: PackageSource; scope: SourceScope }>,\n\t): Array<{ pkg: PackageSource; scope: SourceScope }> {\n\t\treturn dedupePackages(this.context, packages);\n\t}\n\n\tprivate buildNoMatchingPackageMessage(source: string, configuredPackages: PackageSource[]): string {\n\t\treturn buildNoMatchingPackageMessage(source, configuredPackages);\n\t}\n\n\tprivate getNpmCommand(): { command: string; args: string[] } {\n\t\treturn getNpmCommand(this.context);\n\t}\n\n\tprivate getInstalledNpmVersion(installedPath: string): string | undefined {\n\t\treturn getInstalledNpmVersion(installedPath);\n\t}\n\n\tprivate getGitInstallPath(source: GitSource, scope: SourceScope): string {\n\t\treturn getGitInstallPath(this.context, source, scope);\n\t}\n\n\tprivate async npmHasAvailableUpdate(source: NpmSource, installedPath: string): Promise<boolean> {\n\t\tif (isOfflineModeEnabled()) {\n\t\t\treturn false;\n\t\t}\n\n\t\tconst installedVersion = this.getInstalledNpmVersion(installedPath);\n\t\tif (!installedVersion) {\n\t\t\treturn false;\n\t\t}\n\n\t\ttry {\n\t\t\tconst targetVersion = await this.getLatestNpmVersion(source.version ? source.spec : source.name, source.range);\n\t\t\treturn gt(targetVersion, installedVersion);\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tprivate async getLatestNpmVersion(packageSpec: string, range?: string): Promise<string> {\n\t\tconst npmCommand = this.getNpmCommand();\n\t\tconst stdout = await this.runCommandCapture(\n\t\t\tnpmCommand.command,\n\t\t\t[...npmCommand.args, \"view\", packageSpec, \"version\", \"--json\"],\n\t\t\t{ cwd: this.cwd, timeoutMs: NETWORK_TIMEOUT_MS },\n\t\t);\n\t\tconst raw = stdout.trim();\n\t\tif (!raw) throw new Error(\"Empty response from npm view\");\n\t\tconst parsed = JSON.parse(raw) as unknown;\n\t\tif (typeof parsed === \"string\") {\n\t\t\treturn parsed;\n\t\t}\n\t\tif (Array.isArray(parsed)) {\n\t\t\tconst versions = parsed.filter((value): value is string => typeof value === \"string\" && value.length > 0);\n\t\t\tconst latest = range ? maxSatisfying(versions, range) : [...versions].sort(rcompare)[0];\n\t\t\tif (latest) return latest;\n\t\t}\n\t\tthrow new Error(\"Unexpected response from npm view\");\n\t}\n\n\tprivate async gitHasAvailableUpdate(installedPath: string): Promise<boolean> {\n\t\tif (isOfflineModeEnabled()) {\n\t\t\treturn false;\n\t\t}\n\n\t\ttry {\n\t\t\tconst localHead = await this.runCommandCapture(\"git\", [\"rev-parse\", \"HEAD\"], {\n\t\t\t\tcwd: installedPath,\n\t\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t\t});\n\t\t\tconst remoteHead = await this.getRemoteGitHead(installedPath);\n\t\t\treturn localHead.trim() !== remoteHead.trim();\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tprivate async getRemoteGitHead(installedPath: string): Promise<string> {\n\t\tconst upstreamRef = await this.getGitUpstreamRef(installedPath);\n\t\tif (upstreamRef) {\n\t\t\tconst remoteHead = await this.runGitRemoteCommand(installedPath, [\"ls-remote\", \"origin\", upstreamRef]);\n\t\t\tconst match = remoteHead.match(/^([0-9a-f]{40})\\s+/m);\n\t\t\tif (match?.[1]) {\n\t\t\t\treturn match[1];\n\t\t\t}\n\t\t}\n\n\t\tconst remoteHead = await this.runGitRemoteCommand(installedPath, [\"ls-remote\", \"origin\", \"HEAD\"]);\n\t\tconst match = remoteHead.match(/^([0-9a-f]{40})\\s+HEAD$/m);\n\t\tif (!match?.[1]) {\n\t\t\tthrow new Error(\"Failed to determine remote HEAD\");\n\t\t}\n\t\treturn match[1];\n\t}\n\n\tprivate async getLocalGitUpdateTarget(\n\t\tinstalledPath: string,\n\t): Promise<{ ref: string; head: string; fetchArgs: string[] }> {\n\t\ttry {\n\t\t\tconst upstream = await this.runCommandCapture(\"git\", [\"rev-parse\", \"--abbrev-ref\", \"@{upstream}\"], {\n\t\t\t\tcwd: installedPath,\n\t\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t\t});\n\t\t\tconst trimmedUpstream = upstream.trim();\n\t\t\tif (!trimmedUpstream.startsWith(\"origin/\")) {\n\t\t\t\tthrow new Error(`Unsupported upstream remote: ${trimmedUpstream}`);\n\t\t\t}\n\t\t\tconst branch = trimmedUpstream.slice(\"origin/\".length);\n\t\t\tif (!branch) {\n\t\t\t\tthrow new Error(\"Missing upstream branch name\");\n\t\t\t}\n\t\t\tconst head = await this.runCommandCapture(\"git\", [\"rev-parse\", \"@{upstream}\"], {\n\t\t\t\tcwd: installedPath,\n\t\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tref: \"@{upstream}\",\n\t\t\t\thead,\n\t\t\t\tfetchArgs: [\n\t\t\t\t\t\"fetch\",\n\t\t\t\t\t\"--prune\",\n\t\t\t\t\t\"--no-tags\",\n\t\t\t\t\t\"origin\",\n\t\t\t\t\t`+refs/heads/${branch}:refs/remotes/origin/${branch}`,\n\t\t\t\t],\n\t\t\t};\n\t\t} catch {\n\t\t\tawait this.runCommand(\"git\", [\"remote\", \"set-head\", \"origin\", \"-a\"], { cwd: installedPath }).catch(() => {});\n\t\t\tconst head = await this.runCommandCapture(\"git\", [\"rev-parse\", \"origin/HEAD\"], {\n\t\t\t\tcwd: installedPath,\n\t\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t\t});\n\t\t\tconst originHeadRef = await this.runCommandCapture(\"git\", [\"symbolic-ref\", \"refs/remotes/origin/HEAD\"], {\n\t\t\t\tcwd: installedPath,\n\t\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t\t}).catch(() => \"\");\n\t\t\tconst branch = originHeadRef.trim().replace(/^refs\\/remotes\\/origin\\//, \"\");\n\t\t\tif (branch) {\n\t\t\t\treturn {\n\t\t\t\t\tref: \"origin/HEAD\",\n\t\t\t\t\thead,\n\t\t\t\t\tfetchArgs: [\n\t\t\t\t\t\t\"fetch\",\n\t\t\t\t\t\t\"--prune\",\n\t\t\t\t\t\t\"--no-tags\",\n\t\t\t\t\t\t\"origin\",\n\t\t\t\t\t\t`+refs/heads/${branch}:refs/remotes/origin/${branch}`,\n\t\t\t\t\t],\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tref: \"origin/HEAD\",\n\t\t\t\thead,\n\t\t\t\tfetchArgs: [\"fetch\", \"--prune\", \"--no-tags\", \"origin\", \"+HEAD:refs/remotes/origin/HEAD\"],\n\t\t\t};\n\t\t}\n\t}\n\n\tprivate async getGitUpstreamRef(installedPath: string): Promise<string | undefined> {\n\t\ttry {\n\t\t\tconst upstream = await this.runCommandCapture(\"git\", [\"rev-parse\", \"--abbrev-ref\", \"@{upstream}\"], {\n\t\t\t\tcwd: installedPath,\n\t\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t\t});\n\t\t\tconst trimmed = upstream.trim();\n\t\t\tif (!trimmed.startsWith(\"origin/\")) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tconst branch = trimmed.slice(\"origin/\".length);\n\t\t\treturn branch ? `refs/heads/${branch}` : undefined;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tprivate runGitRemoteCommand(installedPath: string, args: string[]): Promise<string> {\n\t\treturn this.runCommandCapture(\"git\", args, {\n\t\t\tcwd: installedPath,\n\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t\tenv: {\n\t\t\t\tGIT_TERMINAL_PROMPT: \"0\",\n\t\t\t},\n\t\t});\n\t}\n\n\tprivate getGlobalNpmRoot(): string {\n\t\tconst npmCommand = this.getNpmCommand();\n\t\tconst commandKey = [npmCommand.command, ...npmCommand.args].join(\"\\0\");\n\t\tif (this.globalNpmRoot && this.globalNpmRootCommandKey === commandKey) {\n\t\t\treturn this.globalNpmRoot;\n\t\t}\n\t\tif (getPackageManagerName(this.context) === \"bun\") {\n\t\t\tconst binDir = this.runNpmCommandSync([\"pm\", \"bin\", \"-g\"]).trim();\n\t\t\tthis.globalNpmRoot = join(dirname(binDir), \"install\", \"global\", \"node_modules\");\n\t\t} else {\n\t\t\tthis.globalNpmRoot = this.runNpmCommandSync([\"root\", \"-g\"]).trim();\n\t\t}\n\t\tthis.globalNpmRootCommandKey = commandKey;\n\t\treturn this.globalNpmRoot;\n\t}\n\n\tprivate getPnpmGlobalPackagePath(packageName: string): string | undefined {\n\t\tif (getPackageManagerName(this.context) !== \"pnpm\") {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst output = this.runNpmCommandSync([\"list\", \"-g\", \"--depth\", \"0\", \"--json\"]);\n\t\tconst entries = JSON.parse(output) as Array<{ dependencies?: Record<string, { path?: string }> }>;\n\t\tfor (const entry of entries) {\n\t\t\tconst path = entry.dependencies?.[packageName]?.path;\n\t\t\tif (path) return path;\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tprivate getLegacyGlobalNpmInstallPath(source: NpmSource): string | undefined {\n\t\t// Read-only migration compatibility for pre-managed global installs. New installs\n\t\t// always target the Agent Forge-managed root; this lookup never substitutes a package.\n\t\ttry {\n\t\t\treturn this.getPnpmGlobalPackagePath(source.name) ?? join(this.getGlobalNpmRoot(), source.name);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tprivate getNpmInstallPath(source: NpmSource, scope: SourceScope): string {\n\t\tconst managedPath = getManagedNpmInstallPath(this.context, source, scope);\n\t\tif (scope !== \"user\" || existsSync(managedPath)) {\n\t\t\treturn managedPath;\n\t\t}\n\t\tconst legacyPath = this.getLegacyGlobalNpmInstallPath(source);\n\t\treturn legacyPath && existsSync(legacyPath) ? legacyPath : managedPath;\n\t}\n\n\tprivate async installNpm(source: NpmSource, scope: SourceScope, temporary: boolean): Promise<void> {\n\t\tconst installRoot = getNpmInstallRoot(this.context, scope, temporary);\n\t\tensureNpmProject(installRoot);\n\t\tawait this.runNpmCommand(getNpmInstallArgs(this.context, [source.spec], installRoot));\n\t}\n\n\tprivate async uninstallNpm(source: NpmSource, scope: SourceScope): Promise<void> {\n\t\tconst installRoot = getNpmInstallRoot(this.context, scope, false);\n\t\tif (!existsSync(installRoot)) {\n\t\t\treturn;\n\t\t}\n\t\tconst packageManagerName = getPackageManagerName(this.context);\n\t\tif (packageManagerName === \"bun\") {\n\t\t\tawait this.runNpmCommand([\"uninstall\", source.name, \"--cwd\", installRoot]);\n\t\t\treturn;\n\t\t}\n\t\tconst args = [\"uninstall\", source.name, \"--prefix\", installRoot];\n\t\tif (packageManagerName !== \"pnpm\") {\n\t\t\targs.push(\"--legacy-peer-deps\");\n\t\t}\n\t\tawait this.runNpmCommand(args);\n\t}\n\n\tprivate async installGit(source: GitSource, scope: SourceScope): Promise<void> {\n\t\tconst targetDir = this.getGitInstallPath(source, scope);\n\t\tif (existsSync(targetDir)) {\n\t\t\tif (source.ref) {\n\t\t\t\tawait this.ensureGitRef(targetDir, [\"fetch\", \"origin\", source.ref], \"FETCH_HEAD\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst target = await this.getLocalGitUpdateTarget(targetDir);\n\t\t\tawait this.ensureGitRef(targetDir, target.fetchArgs, target.ref);\n\t\t\treturn;\n\t\t}\n\t\tconst gitRoot = getGitInstallRoot(this.context, scope);\n\t\tif (gitRoot) {\n\t\t\tensureGitIgnore(gitRoot);\n\t\t}\n\t\tmkdirSync(dirname(targetDir), { recursive: true });\n\t\trmSync(getGitUpdateMarkerPath(targetDir), { force: true });\n\n\t\ttry {\n\t\t\tawait this.runCommand(\"git\", [\"clone\", source.repo, targetDir]);\n\t\t\tif (source.ref) {\n\t\t\t\tawait this.runCommand(\"git\", [\"checkout\", source.ref], { cwd: targetDir });\n\t\t\t}\n\t\t\tconst packageJsonPath = join(targetDir, \"package.json\");\n\t\t\tif (existsSync(packageJsonPath)) {\n\t\t\t\tawait this.runNpmCommand(getGitDependencyInstallArgs(this.context), { cwd: targetDir });\n\t\t\t}\n\t\t} catch (error) {\n\t\t\trmSync(targetDir, { recursive: true, force: true });\n\t\t\tpruneEmptyGitParents(targetDir, gitRoot);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprivate async updateGit(source: GitSource, scope: SourceScope): Promise<void> {\n\t\tconst targetDir = this.getGitInstallPath(source, scope);\n\t\tif (!existsSync(targetDir)) {\n\t\t\tawait this.installGit(source, scope);\n\t\t\treturn;\n\t\t}\n\n\t\tif (source.ref) {\n\t\t\tawait this.ensureGitRef(targetDir, [\"fetch\", \"origin\", source.ref], \"FETCH_HEAD\");\n\t\t\treturn;\n\t\t}\n\n\t\tconst target = await this.getLocalGitUpdateTarget(targetDir);\n\t\tawait this.ensureGitRef(targetDir, target.fetchArgs, target.ref);\n\t}\n\n\tprivate async repairMissingGitDependencies(targetDir: string): Promise<void> {\n\t\tif (!hasMissingGitDependencies(targetDir)) return;\n\t\tawait this.runNpmCommand(getGitDependencyInstallArgs(this.context), { cwd: targetDir });\n\t}\n\n\tprivate async cleanAndInstallGitDependencies(targetDir: string, markerPath: string): Promise<void> {\n\t\t// Clean untracked files (extensions should be pristine). If this fails after\n\t\t// deleting dependencies, repair them so the existing extension still loads.\n\t\ttry {\n\t\t\tawait this.runCommand(\"git\", [\"clean\", \"-fdx\"], { cwd: targetDir });\n\t\t} catch (error) {\n\t\t\tawait this.repairMissingGitDependencies(targetDir).catch(() => {});\n\t\t\tthrow error;\n\t\t}\n\n\t\tconst packageJsonPath = join(targetDir, \"package.json\");\n\t\tif (existsSync(packageJsonPath)) {\n\t\t\tawait this.runNpmCommand(getGitDependencyInstallArgs(this.context), { cwd: targetDir });\n\t\t}\n\t\trmSync(markerPath, { force: true });\n\t}\n\n\tprivate async ensureGitRef(targetDir: string, fetchArgs: string[], ref: string): Promise<void> {\n\t\t// Fetch only the ref we will reset to, avoiding unrelated branch/tag noise.\n\t\tawait this.runCommand(\"git\", fetchArgs, { cwd: targetDir });\n\n\t\tconst localHead = await this.runCommandCapture(\"git\", [\"rev-parse\", \"HEAD\"], {\n\t\t\tcwd: targetDir,\n\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t});\n\t\tconst commitRef = `${ref}^{commit}`;\n\t\tconst targetHead = await this.runCommandCapture(\"git\", [\"rev-parse\", commitRef], {\n\t\t\tcwd: targetDir,\n\t\t\ttimeoutMs: NETWORK_TIMEOUT_MS,\n\t\t});\n\t\tconst markerPath = getGitUpdateMarkerPath(targetDir);\n\t\tif (localHead.trim() === targetHead.trim()) {\n\t\t\tif (existsSync(markerPath)) {\n\t\t\t\tawait this.cleanAndInstallGitDependencies(targetDir, markerPath);\n\t\t\t} else {\n\t\t\t\tawait this.repairMissingGitDependencies(targetDir);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\twriteFileSync(markerPath, \"\", \"utf-8\");\n\t\tawait this.runCommand(\"git\", [\"reset\", \"--hard\", commitRef], { cwd: targetDir });\n\t\tawait this.cleanAndInstallGitDependencies(targetDir, markerPath);\n\t}\n\n\tprivate async refreshTemporaryGitSource(source: GitSource, sourceStr: string): Promise<void> {\n\t\tif (isOfflineModeEnabled()) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tawait this.withProgress(\"pull\", sourceStr, `Refreshing ${sourceStr}...`, async () => {\n\t\t\t\tawait this.updateGit(source, \"temporary\");\n\t\t\t});\n\t\t} catch {\n\t\t\t// Keep cached temporary checkout if refresh fails.\n\t\t}\n\t}\n\n\tprivate async removeGit(source: GitSource, scope: SourceScope): Promise<void> {\n\t\tconst targetDir = this.getGitInstallPath(source, scope);\n\t\trmSync(targetDir, { recursive: true, force: true });\n\t\trmSync(getGitUpdateMarkerPath(targetDir), { force: true });\n\t\tpruneEmptyGitParents(targetDir, getGitInstallRoot(this.context, scope));\n\t}\n\n\tprivate async runNpmCommand(args: string[], options?: { cwd?: string }): Promise<void> {\n\t\tconst npmCommand = this.getNpmCommand();\n\t\tawait this.runCommand(npmCommand.command, [...npmCommand.args, ...args], options);\n\t}\n\n\tprivate runNpmCommandSync(args: string[]): string {\n\t\tconst npmCommand = this.getNpmCommand();\n\t\treturn this.runCommandSync(npmCommand.command, [...npmCommand.args, ...args]);\n\t}\n\n\tprivate spawnCommand(command: string, args: string[], options?: { cwd?: string }): ChildProcess {\n\t\tconst env = getEnv();\n\t\treturn spawnProcess(command, args, {\n\t\t\tcwd: options?.cwd,\n\t\t\tstdio: isStdoutTakenOver() ? [\"ignore\", 2, 2] : \"inherit\",\n\t\t\tenv,\n\t\t});\n\t}\n\n\tprivate spawnCaptureCommand(\n\t\tcommand: string,\n\t\targs: string[],\n\t\toptions?: { cwd?: string; env?: Record<string, string> },\n\t): ChildProcessByStdio<null, Readable, Readable> {\n\t\tconst baseEnv = getEnv();\n\t\tconst env = options?.env ? { ...baseEnv, ...options.env } : baseEnv;\n\t\treturn spawnProcess(command, args, {\n\t\t\tcwd: options?.cwd,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\tenv,\n\t\t});\n\t}\n\n\tprivate runCommandCapture(\n\t\tcommand: string,\n\t\targs: string[],\n\t\toptions?: { cwd?: string; timeoutMs?: number; env?: Record<string, string> },\n\t): Promise<string> {\n\t\treturn new Promise((resolvePromise, reject) => {\n\t\t\tconst child = this.spawnCaptureCommand(command, args, options);\n\t\t\tlet stdout = \"\";\n\t\t\tlet stderr = \"\";\n\t\t\tlet timedOut = false;\n\t\t\tconst timeout =\n\t\t\t\ttypeof options?.timeoutMs === \"number\"\n\t\t\t\t\t? setTimeout(() => {\n\t\t\t\t\t\t\ttimedOut = true;\n\t\t\t\t\t\t\tchild.kill();\n\t\t\t\t\t\t}, options.timeoutMs)\n\t\t\t\t\t: undefined;\n\n\t\t\tchild.stdout?.on(\"data\", (data) => {\n\t\t\t\tstdout += data.toString();\n\t\t\t});\n\t\t\tchild.stderr?.on(\"data\", (data) => {\n\t\t\t\tstderr += data.toString();\n\t\t\t});\n\t\t\tchild.once(\"error\", (error) => {\n\t\t\t\tif (timeout) clearTimeout(timeout);\n\t\t\t\treject(error);\n\t\t\t});\n\t\t\tchild.once(\"close\", (code, signal) => {\n\t\t\t\tif (timeout) clearTimeout(timeout);\n\t\t\t\tif (timedOut) {\n\t\t\t\t\treject(new Error(`${command} ${args.join(\" \")} timed out after ${options?.timeoutMs}ms`));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (code === 0) {\n\t\t\t\t\tresolvePromise(stdout.trim());\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst exitStatus = code === null ? `signal ${signal ?? \"unknown\"}` : `code ${code}`;\n\t\t\t\treject(new Error(`${command} ${args.join(\" \")} failed with ${exitStatus}: ${stderr || stdout}`));\n\t\t\t});\n\t\t});\n\t}\n\n\tprivate runCommand(command: string, args: string[], options?: { cwd?: string }): Promise<void> {\n\t\treturn new Promise((resolvePromise, reject) => {\n\t\t\tconst child = this.spawnCommand(command, args, options);\n\t\t\tchild.on(\"error\", reject);\n\t\t\tchild.on(\"exit\", (code) => {\n\t\t\t\tif (code === 0) {\n\t\t\t\t\tresolvePromise();\n\t\t\t\t} else {\n\t\t\t\t\treject(new Error(`${command} ${args.join(\" \")} failed with code ${code}`));\n\t\t\t\t}\n\t\t\t});\n\t\t});\n\t}\n\n\tprivate runCommandSync(command: string, args: string[]): string {\n\t\tconst env = getEnv();\n\t\tconst result = spawnProcessSync(command, args, {\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\tencoding: \"utf-8\",\n\t\t\tenv,\n\t\t});\n\t\tif (result.error || result.status !== 0) {\n\t\t\tthrow new Error(\n\t\t\t\t`Failed to run ${command} ${args.join(\" \")}: ${result.error?.message || result.stderr || result.stdout}`,\n\t\t\t);\n\t\t}\n\t\treturn (result.stdout || result.stderr || \"\").trim();\n\t}\n}\n"]}