Struct PackageManager 

pub struct PackageManager { /* private fields */ }

Implementations

impl PackageManager

pub const fn new(cwd: PathBuf) -> Self

pub fn resolve_install_source_alias(&self, source: &str) -> String

Resolve a shorthand source (id/name) via the local extension index when possible.

Returns the original source when no unique alias mapping exists.

pub fn package_identity(&self, source: &str) -> String

Get a stable identity for a package source, ignoring version/ref.

Mirrors pi-mono’s getPackageIdentity():

• npm: npm:<name>
• git: git:<repo> (normalized host/path, no ref)
• local: local:<resolved-absolute-path>

pub async fn install(&self, source: &str, scope: PackageScope) -> Result<()>

pub async fn remove(&self, source: &str, scope: PackageScope) -> Result<()>

pub async fn update_source( &self, source: &str, scope: PackageScope, ) -> Result<()>

pub async fn installed_path( &self, source: &str, scope: PackageScope, ) -> Result<Option<PathBuf>>

pub fn installed_path_blocking( &self, source: &str, scope: PackageScope, ) -> Result<Option<PathBuf>>

Synchronous variant of Self::installed_path for startup fast paths.

pub async fn list_packages(&self) -> Result<Vec<PackageEntry>>

pub fn list_packages_blocking(&self) -> Result<Vec<PackageEntry>>

Synchronous variant of Self::list_packages for startup fast paths.

pub fn resolve_package_resources_blocking( &self, ) -> Result<Option<ResolvedPaths>>

Best-effort synchronous package resource resolution for startup/config fast paths.

Returns Ok(Some(...)) when all package resources can be resolved from local state without any install/update work. Returns Ok(None) when a package source would require install/update behavior (for example, missing npm/git package files), allowing callers to fall back to the canonical async resolve() path.

pub async fn ensure_packages_installed(&self) -> Result<Vec<PackageEntry>>

Ensure all packages in settings are installed. Returns the list of packages that were newly installed.

pub async fn resolve(&self) -> Result<ResolvedPaths>

Resolve all resources (extensions/skills/prompts/themes) from:

• packages in global + project settings (deduped by identity; project wins)
• local resource entries from settings (with pattern filtering)
• auto-discovered resources from standard directories (with override patterns)

This matches pi-mono’s DefaultPackageManager.resolve() semantics.

pub async fn resolve_with_roots( &self, roots: &ResolveRoots, ) -> Result<ResolvedPaths>

pub async fn resolve_extension_sources( &self, sources: &[String], options: ResolveExtensionSourcesOptions, ) -> Result<ResolvedPaths>

Resolve resources for extension sources specified via CLI -e/--extension.

Mirrors pi-mono’s resolveExtensionSources(..., { temporary: true }).

pub async fn add_package_source( &self, source: &str, scope: PackageScope, ) -> Result<()>

pub async fn remove_package_source( &self, source: &str, scope: PackageScope, ) -> Result<()>

Trait Implementations

impl Clone for PackageManager

fn clone(&self) -> PackageManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PackageManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.