Versions in this module Expand all Collapse all v0 v0.2.14 Aug 6, 2026 Changes in this version + const AttachmentDataSchemaVersion + const CollectionKind + const CollectionSchemaVersion + const DiscoveryPolicyRevision + const PortableBundleSchemaID + const PortableBundleSchemaVersion + const PortableCollectionFileName + const RoleBuiltIn + const RoleExternal + const RoleImported + const RoleLibrary + const RoleManaged + func CanonicalizePortableBundleDefinition(input definition.CollectionDefinition) (definition.CollectionDefinition, error) + func EncodeAttachmentData(value AttachmentData) (json.RawMessage, error) + func EncodeCollectionData(value CollectionData) (json.RawMessage, error) + func MarshalPortableBundleDefinition(input definition.CollectionDefinition) ([]byte, error) + func NewPortableBundleDefinition(metadata PortableBundleMetadata, members []definition.ContentRef) (definition.CollectionDefinition, error) + func ParsePortableBundleDefinition(raw []byte) (definition.CollectionDefinition, error) + func ValidateCollectionData(value CollectionData) error + func ValidatePortableBundleDefinition(value definition.CollectionDefinition) error + func ValidatePortableBundleMetadata(metadata PortableBundleMetadata) error + type API struct + func New(dependencies Dependencies) (*API, error) + func (a *API) AdoptSkill(ctx context.Context, request AdoptSkillRequest) (artifact.Artifact, error) + func (a *API) AttachSource(ctx context.Context, bundle collection.CollectionRef, ...) (Bundle, error) + func (a *API) BuildLinkedPortableBundleDefinition(ctx context.Context, ref collection.CollectionRef) (definition.CollectionDefinition, error) + func (a *API) BuildLinkedPortableBundleJSON(ctx context.Context, ref collection.CollectionRef) ([]byte, error) + func (a *API) Close() error + func (a *API) CreateBundle(ctx context.Context, request CreateBundleRequest) (Bundle, error) + func (a *API) CreateManagedSkill(ctx context.Context, request CreateManagedSkillRequest) (CreateManagedSkillResponse, error) + func (a *API) EnsureBuiltInBundleCurrent(ctx context.Context, ref collection.CollectionRef) error + func (a *API) EnsureBuiltInBundleTopology(ctx context.Context, request BuiltInBundleTopology) (Bundle, error) + func (a *API) GetBundle(ctx context.Context, ref collection.CollectionRef) (Bundle, error) + func (a *API) GetManagedSkillDocument(ctx context.Context, ref artifact.ArtifactRef) (ManagedSkillDocument, error) + func (a *API) GetSkill(ctx context.Context, ref artifact.ArtifactRef) (artifact.Artifact, error) + func (a *API) InstallBuiltInCollection(ctx context.Context, request BuiltInCollectionInstallRequest) ([]CreateManagedSkillResponse, error) + func (a *API) InstallBuiltInSkill(ctx context.Context, _ CreateManagedSkillRequest) (CreateManagedSkillResponse, error) + func (a *API) ListBundles(ctx context.Context, rootID basespec.RootID) ([]Bundle, error) + func (a *API) ListRuntimeSkills(ctx context.Context, bundle collection.CollectionRef) ([]RuntimeSkill, error) + func (a *API) ListSkills(ctx context.Context, bundle collection.CollectionRef) ([]artifact.Artifact, error) + func (a *API) LoadRuntimeSkill(ctx context.Context, ref artifact.ArtifactRef) (RuntimeSkill, error) + func (a *API) PinSkill(ctx context.Context, request PinSkillRequest) (artifact.Artifact, error) + func (a *API) PurgeBundle(ctx context.Context, ref collection.CollectionRef, expectedRevision uint64) error + func (a *API) PurgeSkill(ctx context.Context, ref artifact.ArtifactRef, expectedRevision uint64) error + func (a *API) Ready() error + func (a *API) RefreshBuiltInBundle(ctx context.Context, ref collection.CollectionRef) (refresh.Result, error) + func (a *API) RefreshBundle(ctx context.Context, ref collection.CollectionRef) (refresh.Result, error) + func (a *API) RetireBundle(ctx context.Context, ref collection.CollectionRef, expectedRevision uint64) (collection.Collection, error) + func (a *API) SetSkillEnabled(ctx context.Context, ref artifact.ArtifactRef, expectedRevision uint64, ...) (artifact.Artifact, error) + func (a *API) SkillBundleRefs(ctx context.Context) ([]collection.CollectionRef, error) + func (a *API) UnadoptSkill(ctx context.Context, ref artifact.ArtifactRef, expectedRevision uint64, ...) error + func (a *API) UpdateBundle(ctx context.Context, request UpdateBundleRequest) (Bundle, error) + type AdoptSkillRequest struct + ArtifactID basespec.ArtifactID + Bundle collection.CollectionRef + Enabled bool + ExpectedCatalogRevision uint64 + Name string + Occurrence catalog.OccurrenceKey + type ArtifactIDProvider interface + NewArtifactID func(ctx context.Context) (basespec.ArtifactID, error) + type ArtifactIDProviderFunc func(context.Context) (basespec.ArtifactID, error) + func (f ArtifactIDProviderFunc) NewArtifactID(ctx context.Context) (basespec.ArtifactID, error) + type AttachmentData struct + DiscoveryRoot basespec.Locator + ExpectedMemberDigests map[basespec.Locator]cryptoutil.Digest + SchemaVersion string + func DecodeAttachmentData(raw json.RawMessage) (AttachmentData, error) + func NewAttachmentData(discoveryRoot basespec.Locator, ...) (AttachmentData, error) + func (d AttachmentData) Clone() AttachmentData + func (d AttachmentData) SourceExpectedContentDigests() (map[basespec.Locator]cryptoutil.Digest, error) + func (d AttachmentData) Validate() error + type AttachmentDraft struct + DiscoveryRoot basespec.Locator + Enabled bool + ExpectedMemberDigests map[basespec.Locator]cryptoutil.Digest + Role basespec.AttachmentRole + SourceID basespec.SourceID + type BuiltInBundleTopology struct + CollectionID basespec.CollectionID + Description string + DiscoveryRoot basespec.Locator + DisplayName string + Enabled bool + ExpectedMemberDigests map[basespec.Locator]cryptoutil.Digest + Labels map[string]string + LogicalName basespec.LogicalName + LogicalVersion basespec.LogicalVersion + PortableDefinitionDigest *cryptoutil.Digest + RootID basespec.RootID + SourceID basespec.SourceID + type BuiltInCollectionInstallRequest struct + Bundle collection.CollectionRef + ExpectedCollectionRevision uint64 + PackageDirectory basespec.Locator + PackageFiles []source.ManagedPackageFile + Skills []BuiltInCollectionSkill + type BuiltInCollectionSkill struct + ArtifactID basespec.ArtifactID + Enabled bool + Member basespec.Locator + type Bundle struct + Attachments []collection.Attachment + Collection collection.Collection + Data CollectionData + Sources []source.Summary + type CollectionData struct + DiscoveryPolicyRevision string + Labels map[string]string + LogicalName basespec.LogicalName + LogicalVersion basespec.LogicalVersion + ManagedSourceID basespec.SourceID + PortableDefinitionDigest *cryptoutil.Digest + SchemaVersion string + func DecodeCollectionData(raw json.RawMessage) (CollectionData, error) + func (d CollectionData) Clone() CollectionData + type CreateBundleRequest struct + Attachments []AttachmentDraft + CollectionID basespec.CollectionID + Description string + DisplayName string + Enabled bool + Labels map[string]string + LogicalName basespec.LogicalName + LogicalVersion basespec.LogicalVersion + ManagedSourceID basespec.SourceID + PortableDefinitionDigest *cryptoutil.Digest + RootID basespec.RootID + type CreateManagedSkillRequest struct + ArtifactID basespec.ArtifactID + Bundle collection.CollectionRef + Document *agentskillsSpec.SkillDocument + Enabled bool + ExpectedArtifactRevision uint64 + ExpectedCollectionRevision uint64 + Files []source.ManagedPackageFile + SKILLMD []byte + SkillName string + type CreateManagedSkillResponse struct + Address artifact.ArtifactAddress + Artifact artifact.Artifact + type Dependencies struct + Artifacts *artifact.Service + AutoAdoptionIDProvider ArtifactIDProvider + Catalogs catalog.Reader + Collections *collection.Service + DecoderFingerprint func() (cryptoutil.Digest, error) + Definitions definition.Reader + GetManagedSourceState ManagedSourceStateFunc + HasDecoder func(basespec.DecoderID) bool + PublishManagedPackage PublishManagedPackageFunc + PublishProtectedManagedPackage PublishManagedPackageFunc + Refresh refresh.Runner + RemoveManagedPackage RemoveManagedPackageFunc + RootMutationPolicy protection.RootPolicy + Roots RootLister + SourceRuntime source.Runtime + Sources *source.Service + func (d Dependencies) Validate() error + type ManagedSkillDocument struct + Artifact artifact.Artifact + Document agentskillsSpec.SkillDocument + type ManagedSourceStateFunc func(ctx context.Context, rootID basespec.RootID, sourceID basespec.SourceID) (source.Summary, string, error) + type PinSkillRequest struct + ArtifactID basespec.ArtifactID + Binding artifact.SourceBinding + Bundle collection.CollectionRef + Enabled bool + ExpectedCollectionRevision uint64 + Name string + type PortableBundleMetadata struct + Description string + DisplayName string + Labels map[string]string + LogicalName basespec.LogicalName + LogicalVersion basespec.LogicalVersion + type PublishManagedPackageFunc func(ctx context.Context, rootID basespec.RootID, sourceID basespec.SourceID, ...) (source.Summary, string, error) + type RemoveManagedPackageFunc func(ctx context.Context, rootID basespec.RootID, sourceID basespec.SourceID, ...) (source.Summary, string, error) + type RootLister interface + List func(ctx context.Context) ([]root.Root, error) + type RuntimeResolver struct + func NewRuntimeResolver(api *API) (*RuntimeResolver, error) + func (r *RuntimeResolver) ListCollectionSkills(ctx context.Context, ref collection.CollectionRef) ([]skillruntime.ResolvedArtifactSkill, error) + func (r *RuntimeResolver) ResolveArtifactSkill(ctx context.Context, ref artifact.ArtifactRef) (skillruntime.ResolvedArtifactSkill, error) + type RuntimeSkill struct + Artifact artifact.ArtifactRef + Collection collection.CollectionRef + Location string + Name string + Version string + type ShareablePackageFile struct + Content []byte + Locator basespec.Locator + type ShareableSkillPackage struct + Bundle basespec.LogicalName + BundleVersion basespec.LogicalVersion + Files []ShareablePackageFile + PackageSHA256 cryptoutil.Digest + Skill basespec.LogicalName + SkillVersion basespec.LogicalVersion + func CanonicalizeShareableSkillPackage(input ShareableSkillPackage) (ShareableSkillPackage, error) + func (p ShareableSkillPackage) Validate() error + type UpdateBundleRequest struct + Bundle collection.CollectionRef + Description string + DisplayName string + Enabled bool + ExpectedRevision uint64