artifactbuiltin

package
v0.2.16 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 9, 2026 License: MPL-2.0 Imports: 24 Imported by: 0

Documentation

Index

Constants

View Source
const (
	RegistrySchemaVersion = "v1"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type Artifact

type Artifact struct {
	ID      basespec.ArtifactID `json:"id"`
	Member  basespec.Locator    `json:"member"`
	Enabled bool                `json:"enabled"`
}

type Collection

type Collection struct {
	ID        basespec.CollectionID `json:"id"`
	Payload   basespec.Locator      `json:"payload"`
	Enabled   bool                  `json:"enabled"`
	Artifacts []Artifact            `json:"artifacts"`
}

type HydratedArtifact

type HydratedArtifact struct {
	Registration      Artifact
	Member            builtinSchema.ContentRef
	SkillDefinition   definition.Definition
	EmbeddedDirectory basespec.Locator
	SourceDirectory   basespec.Locator
}

type HydratedCollection

type HydratedCollection struct {
	Registration          Collection
	Definition            builtinSchema.SkillCollectionV1
	SourceScope           basespec.Locator
	ExpectedMemberDigests map[basespec.Locator]cryptoutil.Digest
	Artifacts             []HydratedArtifact
}

type HydratedRegistry

type HydratedRegistry struct {
	Registry    Registry
	Collections []HydratedCollection
}

func (HydratedRegistry) OrderedCollections

func (r HydratedRegistry) OrderedCollections() []HydratedCollection

type Installer

type Installer struct {
	// contains filtered or unexported fields
}

func NewInstaller

func NewInstaller(
	dependencies InstallerDependencies,
) (*Installer, error)

func (*Installer) BuiltInIDs

func (i *Installer) BuiltInIDs() []string

func (*Installer) BuiltInName

func (*Installer) BuiltInName() string

func (*Installer) BuiltInPackageScopes

func (i *Installer) BuiltInPackageScopes() []basespec.Locator

func (*Installer) DesiredHydration added in v0.2.16

func (i *Installer) DesiredHydration(
	ctx context.Context,
) (topology.Hydration, error)

func (*Installer) Ensure

func (i *Installer) Ensure(
	ctx context.Context,
) error

func (*Installer) EnsureBuiltInArtifacts

func (i *Installer) EnsureBuiltInArtifacts(
	ctx context.Context,
) error

func (*Installer) EnsureBuiltInBundles

func (i *Installer) EnsureBuiltInBundles(
	ctx context.Context,
) ([]skillBundle.Bundle, error)

func (*Installer) EnsureHydration added in v0.2.16

func (i *Installer) EnsureHydration(
	ctx context.Context,
	current bool,
) error

type InstallerDependencies

type InstallerDependencies struct {
	Skills                 skillInstaller
	BuiltInTopology        builtin.Registry
	SkillRegistry          Registry
	Packages               fs.FS
	ShareableCanonicalizer shareable.Canonicalizer
}

type Registry

type Registry struct {
	SchemaVersion string       `json:"schemaVersion"`
	Collections   []Collection `json:"collections"`
}

Registry is the non-portable registration manifest for embedded Agent Skills. It is not a portable Skill Bundle definition and is never exported.

func LoadRegistry

func LoadRegistry() (Registry, error)

func (Registry) Hydrate

func (r Registry) Hydrate(
	ctx context.Context,
	canonicalizer shareable.Canonicalizer,
	packages fs.FS,
) (HydratedRegistry, error)

Hydrate converts embedded portable collection descriptors into canonical, integrity-pinned Skill collection documents. The checked-in descriptor may omit digest fields. Member digests are enriched from embedded package bytes and the final document is canonicalized through Artifact Store's registered shareable codec before local installation begins.

func (Registry) OrderedCollections

func (r Registry) OrderedCollections() []Collection

func (Registry) Validate

func (r Registry) Validate() error

type SkillReference

type SkillReference struct {
	Collection basespec.LogicalName `json:"collection"`
	Skill      basespec.LogicalName `json:"skill"`
}

SkillReference is a portable semantic built-in reference. It deliberately contains no Artifact Store IDs, package location, enablement, revision, or installation-specific metadata.

func (SkillReference) Validate

func (r SkillReference) Validate() error

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL