Validate and import agent skills into versioned server storage

Adds a SKILL.md bundle validator, immutable per-skill versions with
content digests and deduplication, protocol requests to import, list and
show skills, and the pipelines skills import/list/show commands. Imports
are serialised so concurrent imports never share a version number.
This commit is contained in:
2026-11-12 11:15:28 +00:00
parent 24618964ce
commit bd4f1437bc
13 changed files with 811 additions and 0 deletions
+12
View File
@@ -23,6 +23,12 @@ const (
PipelineArchived = "pipeline_archived"
UnarchivePipeline = "unarchive_pipeline"
PipelineUnarchived = "pipeline_unarchived"
ImportSkill = "import_skill"
SkillImported = "skill_imported"
ListSkills = "list_skills"
Skills = "skills"
ShowSkill = "show_skill"
Skill = "skill"
)
type Stage struct {
@@ -127,6 +133,9 @@ type PipelineSummary struct {
// are optional so older peers ignore them. See search.go for the per-type payloads
// and the ranking/kind/bound vocabulary.
type Message struct {
SkillFiles []SkillFile `json:"skill_files,omitempty"`
SkillSummaries []SkillSummary `json:"skill_summaries,omitempty"`
SkillVersion *SkillVersion `json:"skill_version,omitempty"`
Storage *StorageOverview `json:"storage,omitempty"`
StoragePolicy *StoragePolicy `json:"storage_policy,omitempty"`
StorageCleanup *StorageCleanupResult `json:"storage_cleanup,omitempty"`
@@ -154,6 +163,9 @@ type Message struct {
Error string `json:"error,omitempty"`
Warnings []string `json:"warnings,omitempty"` // non-blocking authoring lint for validate/submit
Name string `json:"name,omitempty"`
Description string `json:"description,omitempty"`
Digest string `json:"digest,omitempty"`
SourcePath string `json:"source_path,omitempty"`
Source string `json:"source,omitempty"`
Title string `json:"title,omitempty"`
Version int `json:"version,omitempty"`
+24
View File
@@ -0,0 +1,24 @@
package protocol
type SkillFile struct {
Path string `json:"path"`
Bytes []byte `json:"bytes"`
}
type SkillSummary struct {
Name string `json:"name"`
Description string `json:"description"`
LatestVersion int `json:"latest_version"`
Digest string `json:"digest"`
ImportedAt string `json:"imported_at"`
}
type SkillVersion struct {
SkillSummary
Version int `json:"version"`
SourcePath string `json:"source_path"`
Manifest []SkillFileMeta `json:"manifest"`
SkillMD string `json:"skill_md"`
}
type SkillFileMeta struct {
Path string `json:"path"`
Size int64 `json:"size"`
}