nvflare.tool.agent.skill_manager module

Native install/list support for NVFLARE-owned agent skills.

class SkillSource(source_type: str, root: pathlib.Path, manifest: dict)[source]

Bases: object

manifest: dict

root: Path

source_type: str

find_skill_source() → SkillSource[source]: Find skills from an editable/source checkout first, then from the installed package bundle.

install_skills(*, agent: str, skill_name: str | None = None, dry_run: bool = False, target_dir: Path | str | None = None, source: SkillSource | None = None) → dict[source]: Plan or apply a native NVFLARE skill installation.

list_skills(*, agent: str, target_dir: Path | str | None = None, source: SkillSource | None = None) → dict[source]: List available packaged skills and installed managed skills for an agent target.

resolve_agent_target_dir(agent: str, *, target_dir: Path | str | None = None, env: dict | None = None) → Path[source]

Resolve a named agent target to its skill installation directory.

Explicit write targets, including CODEX_HOME-derived targets, use the same no-traversal/no-symlink policy as –target. The only symlink exception is the platform temp-directory alias handled in _resolve_target_override.