registry

Sep 10, 2026

Changes in this version

+ const PluginCatalogAPIVersion

+ var ErrInvalidCatalog = errors.New("invalid plugin catalog")

+ func ValidatePluginCatalog(catalog *PluginCatalog) error

+ type CatalogSearchWarning struct

+ Err error

+ Repository string

type GitHubClient

+ func (c *GitHubClient) ExpandCatalogs(ctx context.Context, results []SearchResult) ([]SearchResult, []CatalogSearchWarning)

+ func (c *GitHubClient) FetchCatalog(ctx context.Context, repo Repo) ([]byte, error)

+ func (c *GitHubClient) FetchRepositoryFile(ctx context.Context, repo Repo, path string) ([]byte, error)

+ func (c *GitHubClient) GetLatestPrefixedRelease(ctx context.Context, repo Repo, tagPrefix, manifestVersion string) (*Release, error)

+ func (c *GitHubClient) ListReleases(ctx context.Context, repo Repo) ([]Release, error)

type InstallOptions

+ AllowSourceChange bool

+ Plugin string

type LockedPlugin

+ PluginPath string

+ Tag string

type ManifestSource

+ Catalog *PluginCatalog

+ Entry *PluginCatalogEntry

+ Repo Repo

+ func ResolveManifestSource(ctx context.Context, client *GitHubClient, source, selector, pluginsDir string) (*ManifestSource, error)

+ type PluginCatalog struct

+ APIVersion string

+ Kind string

+ Plugins []PluginCatalogEntry

+ func LoadPluginCatalog(path string) (*PluginCatalog, error)

+ func ParsePluginCatalog(data []byte) (*PluginCatalog, error)

+ func (c *PluginCatalog) ActiveEntries() []PluginCatalogEntry

+ func (c *PluginCatalog) FindActive(selector string) (*PluginCatalogEntry, error)

+ type PluginCatalogEntry struct

+ Archived bool

+ Asset string

+ ID string

+ Kind string

+ Path string

+ Slug string

+ TagPrefix string

+ func (e PluginCatalogEntry) TagForVersion(version string) string

+ type RegistryBindingContext struct

+ PluginPath string

+ Tag string

type RegistryEntry

+ PluginPath string

+ Tag string

type Release

+ Draft bool

+ Prerelease bool

type SearchResult

+ Asset string

+ Catalog bool

+ PluginID string

+ PluginPath string

+ Slug string

+ TagPrefix string

Sep 9, 2026

Changes in this version

type UISection

+ I18n map[string]string

Sep 9, 2026

Changes in this version

type UIPage

+ Description string

type UISection

+ Description string

+ EmptyText string

+ Title string

Sep 9, 2026

Changes in this version

+ func HasCustomUI(m *Manifest) bool

type ApplicationContribution

+ I18n map[string]string

+ UI *PluginUI

type ConnectorContribution

+ I18n map[string]string

type DriverContribution

+ I18n map[string]string

+ UI *PluginUI

type Manifest

+ func (m *Manifest) PublicContributions() api.PluginContributionsData

+ type PluginUI struct

+ APIVersion int

+ Device *UIDevice

+ Navigation *UINavigation

+ Pages []UIPage

+ type UIDevice struct

+ Sections []UISection

+ type UINavigation struct

+ I18n map[string]string

+ Icon string

+ Order int

+ Route string

+ Title string

+ Visibility string

+ type UIPage struct

+ I18n map[string]string

+ ID string

+ Sections []UISection

+ Title string

+ type UISection struct

+ Entry string

+ Fields []map[string]any

+ Presentation string

+ RecordType string

+ Scopes []string

+ Source string

+ Text string

+ Type string

Sep 4, 2026

Changes in this version

+ func LoadManifestSchema(path string) (data []byte, source string, err error)

type InstallResult

+ SchemaSource string

Sep 3, 2026

Changes in this version

+ const LockFormatVersion

+ var ErrAttestationFailed = errors.New("attestation verification failed")

+ var ErrCoreIncompatible = errors.New("core version incompatible")

+ var ErrDigestMismatch = errors.New("release asset digest mismatch")

+ var ErrDigestUnavailable = errors.New("release asset digest unavailable")

+ var ErrHostRuntimeUnavailable = errors.New("plugin host runtime unavailable")

+ var ErrInvalidDigest = errors.New("invalid digest")

+ var ErrInvalidManifest = errors.New("invalid plugin manifest")

+ var ErrNotFound = errors.New("plugin not found")

+ var ErrPermissionConfirmationRequired = errors.New("permission confirmation required")

+ var ErrProtocolIncompatible = errors.New("plugin protocol incompatible")

+ var ErrRateLimited = errors.New("github api rate limit exceeded")

+ var ErrRegistryBindingMismatch = errors.New("registry binding mismatch")

+ var ErrTrustConfirmationRequired = errors.New("trust confirmation required")

+ var ErrTrustDowngrade = errors.New("trust downgrade rejected")

+ var ErrUnsafeArtifact = errors.New("unsafe plugin artifact")

+ var ErrUnsupportedSource = errors.New("unsupported plugin source")

+ func CheckCoreCompatibility(manifest *Manifest, current string) error

+ func EncodeRegistryEntry(entry RegistryEntry) ([]byte, error)

+ func NormalizeDigest(value string) (string, error)

+ func ParseChecksumBlob(data []byte, filename string) (string, bool)

+ func ParseChecksumLine(line string) (filename, digest string, ok bool)

+ func PermissionExpansion(existing, incoming *Permissions) []string

+ func SHA256Bytes(data []byte) string

+ func SHA256File(path string) (string, error)

+ func SafePluginID(id string) string

+ func ValidateContributions(m *Manifest) error

+ func ValidateManifestContract(manifest *Manifest, coreVersion string, supportedProtocol int) error

+ func ValidateRegistryBinding(entry *RegistryEntry, manifest *Manifest, source string) error

+ func ValidateRegistryEntry(entry RegistryEntry) error

+ func VerifyDigest(path, expected string) error

+ func WriteLockFile(path string, lock *LockFile) error

+ type ApplicationContribution struct

+ ID string

+ Requirements []map[string]any

+ Title string

+ type Attestation struct

+ Digest string

+ Evidence string

+ Predicate string

+ type AttestationSubject struct

+ Digest string

+ Name string

+ Owner string

+ type AttestationVerifier interface

+ Verify func(ctx context.Context, subject AttestationSubject) (*Attestation, error)

+ type Compatibility struct

+ Core string

+ type ConnectorContribution struct

+ Direction string

+ Host string

+ ID string

+ Title string

+ type Contributes struct

+ Applications []ApplicationContribution

+ Connectors []ConnectorContribution

+ Drivers []DriverContribution

+ type DriverContribution struct

+ CapabilityCatalog string

+ ConfigSchema string

+ Descriptor string

+ Discovery string

+ ID string

+ Title string

+ type GitHubClient struct

+ BaseURL string

+ HTTPClient *http.Client

+ MaxJSONBytes int64

+ MaxRetries int

+ Token string

+ func NewGitHubClient() *GitHubClient

+ func (c *GitHubClient) Download(ctx context.Context, rawURL string, limit int64) ([]byte, error)

+ func (c *GitHubClient) DownloadToFile(ctx context.Context, rawURL, dest string, limit int64) (string, error)

+ func (c *GitHubClient) FetchManifest(ctx context.Context, repo Repo) ([]byte, error)

+ func (c *GitHubClient) GetLatestRelease(ctx context.Context, repo Repo) (*Release, error)

+ func (c *GitHubClient) Search(ctx context.Context, query string) ([]SearchResult, error)

+ type InstallOptions struct

+ AllowUnreviewed bool

+ Asset string

+ ConfirmPerms bool

+ Digest string

+ Existing *LockedPlugin

+ Source string

+ type InstallResult struct

+ AssetPath string

+ Digest string

+ Evidence string

+ LockEntry LockedPlugin

+ Manifest *Manifest

+ Mode TrustMode

+ PluginDir string

+ RegistryEntry RegistryEntry

+ Verified bool

+ type Installer struct

+ Attestation AttestationVerifier

+ Client *GitHubClient

+ CoreVersion string

+ LockPath string

+ MaxDownloadBytes int64

+ PluginsDir string

+ RegistryIndex *RegistryIndex

+ SchemaPath string

+ SupportedProtocol int

+ func NewInstaller(pluginsDir, lockPath, schemaPath, coreVersion string) *Installer

+ func (i *Installer) Install(ctx context.Context, opts InstallOptions) (*InstallResult, error)

+ type LockFile struct

+ FormatVersion int

+ Plugins []LockedPlugin

+ func LoadLockFile(path string) (*LockFile, error)

+ func NewLockFile() *LockFile

+ func (l *LockFile) Find(id string) (*LockedPlugin, bool)

+ func (l *LockFile) Remove(id string) bool

+ func (l *LockFile) Upsert(entry LockedPlugin)

+ type LockedPlugin struct

+ Compatibility string

+ Digest string

+ Evidence string

+ ID string

+ Mode TrustMode

+ Protocol int

+ Source string

+ Verified bool

+ VerifiedPublisher string

+ Version string

+ type Manifest struct

+ APIVersion string

+ Capabilities []string

+ Compatibility Compatibility

+ Contributes *Contributes

+ Entrypoint string

+ ID string

+ Kind string

+ Permissions Permissions

+ Protocol int

+ Requirements []map[string]any

+ Version string

+ func LoadManifest(path string) (*Manifest, error)

+ func ParseManifest(data []byte) (*Manifest, error)

+ func ReadManifest(path string) (*Manifest, error)

+ func ValidateManifest(data []byte, schema []byte) (*Manifest, error)

+ func ValidateManifestFile(path, schemaPath string) (*Manifest, error)

+ func (m *Manifest) PermissionSummary() string

+ type ManifestSource struct

+ Data []byte

+ Path string

+ func ReadManifestSource(ctx context.Context, client *GitHubClient, source, pluginsDir string) (*ManifestSource, error)

+ type Permissions struct

+ Filesystem []string

+ Hardware []string

+ Network []string

+ Secrets []string

+ type RegistryEntry struct

+ Compatibility string

+ Digest string

+ ID string

+ Kind string

+ Protocol int

+ Source string

+ VerifiedPublisher string

+ Version string

+ type RegistryIndex struct

+ Plugins []RegistryEntry

+ Version int

+ func LoadRegistryIndex(path string) (*RegistryIndex, error)

+ func (idx *RegistryIndex) Find(id string) (*RegistryEntry, bool)

+ type Release struct

+ Assets []ReleaseAsset

+ Name string

+ TagName string

+ URL string

+ type ReleaseAsset struct

+ Name string

+ Size int64

+ URL string

+ type Repo struct

+ Name string

+ Owner string

+ URL string

+ func ResolveRepository(input string) (Repo, error)

+ type SchemaValidator struct

+ func NewSchemaValidator(data []byte) (*SchemaValidator, error)

+ func (v *SchemaValidator) Validate(value any) error

+ type SearchResult struct

+ Description string

+ FullName string

+ Name string

+ Stars int

+ URL string

+ type TrustMode string

+ const TrustModeAttestation

+ const TrustModeExplicitDigest

+ const TrustModeUnreviewedTOFU

+ const TrustModeVerifiedRegistry