remote • AI Agent SDK

Declarative remote skill sources with a versioned local cache.

remote

AI Agent

Declarative remote skill sources with a versioned local cache.

A remote skill source is fetched at discovery time, cached under `~/.praisonai/cache/remote-skills/<source-id>/ in a versioned directory, and atomically swapped in when the remote changes. Sync is opt-in, offline-safe (falls back to the last-good cache), and adds zero import-time cost — the module is only imported when a caller passes sources= to discover_skills`.

Remote content is untrusted: callers re-run the existing skill validator on the returned directories before injecting anything into a prompt.

Import

python

from praisonaiagents.skills import remote

Classes

GitRemoteSkillSource

Default remote skill source backed by a shallow git clone.

Functions

get_remote_cache_root()

Return the root cache directory for remote skill sources.

fetch_remote_skill_dirs()

Fetch all remote skill sources and return validated cache directories.

Constants

Name	Value
`CACHE_SUBDIR`	`'remote-skills'`
`_CURRENT_LINK`	`'current'`
`_GIT_TIMEOUT`	`120`