Versions in this module Expand all Collapse all v0 v0.2.22 Sep 12, 2026 v0.2.21 Sep 9, 2026 Changes in this version + func RequireRequestBody[T any](request *T, bodyPresent bool, requireBody bool, subject string) error + type AdoptWorkspaceOccurrenceInput struct + ArtifactID artifact.ArtifactID + Enabled bool + ExpectedCatalogRevision uint64 + Name string + Occurrence WorkspaceOccurrenceRef + Settings WorkspaceArtifactSettings + type AttachWorkspaceSourceInput struct + Enabled bool + ExpectedCollectionRevision uint64 + Role collection.AttachmentRole + Settings WorkspaceAttachmentSettings + SourceID source.SourceID + type ComposeWorkspaceContextRequest struct + Body *ComposeWorkspaceContextRequestBody + Workspace workspaceDomain.WorkspaceRef + type ComposeWorkspaceContextRequestBody struct + Artifacts []artifact.ArtifactRef + type ComposeWorkspaceContextResponse struct + Body *WorkspaceContextLoadPlan + type CompositionDecision struct + Artifact artifact.ArtifactRef + Code string + IncludedBytes int + OriginalBytes int + Status workspaceRuntime.CompositionStatus + type Config struct + ContextComposition workspaceRuntime.CompositionPolicy + SourceUsePolicy artifactadapter.SourceUsePolicy + WorkspaceRootID root.RootID + func DefaultConfig() Config + type ContextContribution struct + Artifact artifact.ArtifactRef + ArtifactRevision uint64 + Content string + ConventionOrder int + DefinitionDigest cryptoutil.Digest + IncludedBytes int + Locator basespec.Locator + MediaType artifactbuiltin.WorkspaceContextMediaType + Name string + OriginalBytes int + Role artifactbuiltin.WorkspaceContextRole + SourceID source.SourceID + Truncated bool + type ContextDocument struct + Artifact artifact.ArtifactRef + ArtifactRevision uint64 + CatalogCurrent bool + DefinitionDigest cryptoutil.Digest + Diagnostics []diagnostic.Diagnostic + Enabled bool + Locator basespec.Locator + MediaType artifactbuiltin.WorkspaceContextMediaType + Name string + ProjectionValid bool + Role artifactbuiltin.WorkspaceContextRole + RuntimeDisabled bool + SourceID source.SourceID + State artifact.State + type ContextInspection struct + CatalogRevision uint64 + Contributions []ContextContribution + Diagnostics []diagnostic.Diagnostic + Workspace collection.CollectionRef + type ContextLoadPlan struct + CatalogRevision uint64 + Contributions []ContextContribution + Decisions []CompositionDecision + Diagnostics []diagnostic.Diagnostic + Prompt string + PromptBytes int + Workspace collection.CollectionRef + type ContextService interface + Compose func(ctx context.Context, workspace collection.CollectionRef, ...) (ContextLoadPlan, error) + List func(ctx context.Context, workspace collection.CollectionRef) ([]ContextDocument, error) + Load func(ctx context.Context, workspace collection.CollectionRef, ...) (ContextInspection, error) + type CreateEmptyWorkspaceInput struct + Description string + Discovery WorkspaceDiscovery + DisplayName string + type CreateFilesystemWorkspaceInput struct + Description string + Discovery WorkspaceDiscovery + DisplayName string + RootPath string + type DetachWorkspaceSourceInput struct + ExpectedAttachmentRevision uint64 + ExpectedCollectionRevision uint64 + SourceID source.SourceID + type GetWorkspaceArtifactRequest struct + Artifact artifact.ArtifactRef + Workspace workspaceDomain.WorkspaceRef + type GetWorkspaceArtifactResponse struct + Body *WorkspaceArtifactView + type GetWorkspaceCatalogRequest struct + Workspace workspaceDomain.WorkspaceRef + type GetWorkspaceCatalogResponse struct + Body *WorkspaceCatalogView + type GetWorkspaceRequest struct + Workspace workspaceDomain.WorkspaceRef + type GetWorkspaceResponse struct + Body *WorkspaceView + type ListWorkspaceArtifactsRequest struct + Workspace workspaceDomain.WorkspaceRef + type ListWorkspaceArtifactsResponse struct + Body *ListWorkspaceArtifactsResponseBody + type ListWorkspaceArtifactsResponseBody struct + Artifacts []WorkspaceArtifactView + type ListWorkspaceContextsRequest struct + Workspace workspaceDomain.WorkspaceRef + type ListWorkspaceContextsResponse struct + Body *ListWorkspaceContextsResponseBody + type ListWorkspaceContextsResponseBody struct + Contexts []WorkspaceContextView + type ListWorkspaceSkillsRequest struct + Workspace workspaceDomain.WorkspaceRef + type ListWorkspaceSkillsResponse struct + Body *ListWorkspaceSkillsResponseBody + type ListWorkspaceSkillsResponseBody struct + Skills []WorkspaceSkillView + type ListWorkspacesRequest struct + type ListWorkspacesResponse struct + Body *ListWorkspacesResponseBody + type ListWorkspacesResponseBody struct + Workspaces []WorkspaceView + type LoadWorkspaceContextsRequest struct + Body *LoadWorkspaceContextsRequestBody + Workspace workspaceDomain.WorkspaceRef + type LoadWorkspaceContextsRequestBody struct + Artifacts []artifact.ArtifactRef + type LoadWorkspaceContextsResponse struct + Body *WorkspaceContextInspectionView + type LoadWorkspaceSkillsRequest struct + Body *LoadWorkspaceSkillsRequestBody + Workspace workspaceDomain.WorkspaceRef + type LoadWorkspaceSkillsRequestBody struct + Artifacts []artifact.ArtifactRef + type LoadWorkspaceSkillsResponse struct + Body *WorkspaceSkillLoadView + type PinWorkspaceArtifactInput struct + ArtifactID artifact.ArtifactID + Binding artifact.SourceBinding + Enabled bool + ExpectedCollectionRevision uint64 + Name string + Settings WorkspaceArtifactSettings + type QueryService struct + func NewQueryService(workspaces *Service, resources compositionapi.ResourceAPI) (*QueryService, error) + func (q *QueryService) Catalog(ctx context.Context, workspace collection.CollectionRef) (workspaceDomain.CatalogView, error) + func (q *QueryService) ComposeLoadPlan(ctx context.Context, workspace collection.CollectionRef, ...) (workspaceDomain.LoadPlan, error) + func (q *QueryService) ComposeLoadPlanFromCatalog(view workspaceDomain.CatalogView, artifactRefs []artifact.ArtifactRef) (workspaceDomain.LoadPlan, error) + func (q *QueryService) GetWorkspace(ctx context.Context, workspace collection.CollectionRef) (workspaceDomain.Workspace, error) + func (q *QueryService) ResolveArtifact(ctx context.Context, ref artifact.ArtifactRef) (workspaceDomain.Workspace, workspaceDomain.Resource, error) + type RegisterWorkspaceDirectoryInput struct + DisplayName string + ExpectedCollectionRevision uint64 + Role collection.AttachmentRole + RootPath string + Settings WorkspaceAttachmentSettings + type RetireWorkspaceResult struct + Revision uint64 + Workspace WorkspaceRef + type Service struct + func NewService(collections compositionapi.CollectionAPI, sources compositionapi.SourceAPI, ...) (*Service, error) + func (s *Service) Get(ctx context.Context, ref collection.CollectionRef) (workspaceDomain.Workspace, error) + func (s *Service) List(ctx context.Context, rootID root.RootID) ([]workspaceDomain.Workspace, error) + type SetWorkspaceArtifactRuntimeDisabledRequest struct + Artifact artifact.ArtifactRef + Body *SetWorkspaceArtifactRuntimeDisabledRequestBody + Workspace workspaceDomain.WorkspaceRef + type SetWorkspaceArtifactRuntimeDisabledRequestBody struct + ExpectedRevision uint64 + RuntimeDisabled bool + type SetWorkspaceArtifactRuntimeDisabledResponse struct + Body *WorkspaceArtifactView + type SetWorkspacePrimarySourceInput struct + Clear bool + ExpectedCollectionRevision uint64 + SourceID source.SourceID + type StoreAPI struct + func NewStoreAPI(sources compositionapi.SourceAPI, collections compositionapi.CollectionAPI, ...) (*StoreAPI, error) + func (a *StoreAPI) AdoptWorkspaceOccurrence(ctx context.Context, ref WorkspaceRef, input AdoptWorkspaceOccurrenceInput) (WorkspaceArtifactView, error) + func (a *StoreAPI) AttachWorkspaceSource(ctx context.Context, ref WorkspaceRef, input AttachWorkspaceSourceInput) (WorkspaceView, error) + func (a *StoreAPI) ContextService() ContextService + func (a *StoreAPI) CreateEmptyWorkspace(ctx context.Context, input CreateEmptyWorkspaceInput) (WorkspaceView, error) + func (a *StoreAPI) CreateFilesystemWorkspace(ctx context.Context, input CreateFilesystemWorkspaceInput) (WorkspaceView, error) + func (a *StoreAPI) DetachWorkspaceSource(ctx context.Context, ref WorkspaceRef, input DetachWorkspaceSourceInput) (WorkspaceView, error) + func (a *StoreAPI) GetWorkspace(ctx context.Context, request *GetWorkspaceRequest) (*GetWorkspaceResponse, error) + func (a *StoreAPI) GetWorkspaceArtifact(ctx context.Context, request *GetWorkspaceArtifactRequest) (*GetWorkspaceArtifactResponse, error) + func (a *StoreAPI) GetWorkspaceCatalog(ctx context.Context, request *GetWorkspaceCatalogRequest) (*GetWorkspaceCatalogResponse, error) + func (a *StoreAPI) ListWorkspaceArtifacts(ctx context.Context, request *ListWorkspaceArtifactsRequest) (*ListWorkspaceArtifactsResponse, error) + func (a *StoreAPI) ListWorkspaceSourcesForManagement(ctx context.Context) ([]WorkspaceSourceSummary, error) + func (a *StoreAPI) ListWorkspaceSuppressions(ctx context.Context, ref WorkspaceRef) ([]WorkspaceSuppressionView, error) + func (a *StoreAPI) ListWorkspaces(ctx context.Context, request *ListWorkspacesRequest) (*ListWorkspacesResponse, error) + func (a *StoreAPI) PinWorkspaceArtifact(ctx context.Context, ref WorkspaceRef, input PinWorkspaceArtifactInput) (WorkspaceArtifactView, error) + func (a *StoreAPI) PurgeWorkspace(ctx context.Context, ref WorkspaceRef, expectedRevision uint64) (WorkspaceRef, error) + func (a *StoreAPI) PurgeWorkspaceArtifact(ctx context.Context, workspace WorkspaceRef, ref artifact.ArtifactRef, ...) (artifact.ArtifactRef, error) + func (a *StoreAPI) RefreshWorkspace(ctx context.Context, ref WorkspaceRef) (WorkspaceRefreshResult, error) + func (a *StoreAPI) RegisterWorkspaceDirectory(ctx context.Context, ref WorkspaceRef, input RegisterWorkspaceDirectoryInput) (WorkspaceDirectoryRegistrationResult, error) + func (a *StoreAPI) RetireWorkspace(ctx context.Context, ref WorkspaceRef, expectedRevision uint64) (RetireWorkspaceResult, error) + func (a *StoreAPI) SetArtifactRuntimeDisabled(ctx context.Context, workspace workspaceDomain.WorkspaceRef, ...) (WorkspaceArtifactView, error) + func (a *StoreAPI) SetWorkspaceArtifactEnabled(ctx context.Context, workspace WorkspaceRef, ref artifact.ArtifactRef, ...) (WorkspaceArtifactView, error) + func (a *StoreAPI) SetWorkspacePrimarySource(ctx context.Context, ref WorkspaceRef, input SetWorkspacePrimarySourceInput) (WorkspaceView, error) + func (a *StoreAPI) SetWorkspaceSourceEnabled(ctx context.Context, sourceID source.SourceID, expectedRevision uint64, ...) (WorkspaceSourceSummary, error) + func (a *StoreAPI) SkillAdapter() *workspaceadapter.Adapter + func (a *StoreAPI) SuppressWorkspaceBinding(ctx context.Context, ref WorkspaceRef, input SuppressWorkspaceBindingInput) (WorkspaceSuppressionView, error) + func (a *StoreAPI) UnadoptWorkspaceArtifact(ctx context.Context, workspace WorkspaceRef, ref artifact.ArtifactRef, ...) (UnadoptWorkspaceArtifactResult, error) + func (a *StoreAPI) UnsuppressWorkspaceBinding(ctx context.Context, ref WorkspaceRef, binding artifact.SourceBinding, ...) (UnsuppressWorkspaceBindingResult, error) + func (a *StoreAPI) UpdateWorkspace(ctx context.Context, ref WorkspaceRef, input UpdateWorkspaceInput) (WorkspaceView, error) + func (a *StoreAPI) UpdateWorkspaceAttachment(ctx context.Context, ref WorkspaceRef, input UpdateWorkspaceAttachmentInput) (WorkspaceView, error) + type SuppressWorkspaceBindingInput struct + Binding artifact.SourceBinding + ExpectedCollectionRevision uint64 + type UnadoptWorkspaceArtifactInput struct + ExpectedRevision uint64 + Suppress bool + type UnadoptWorkspaceArtifactResult struct + Artifact artifact.ArtifactRef + type UnsuppressWorkspaceBindingResult struct + Binding artifact.SourceBinding + Workspace WorkspaceRef + type UpdateWorkspaceAttachmentInput struct + Enabled bool + ExpectedAttachmentRevision uint64 + ExpectedCollectionRevision uint64 + Role collection.AttachmentRole + Settings WorkspaceAttachmentSettings + SourceID source.SourceID + type UpdateWorkspaceInput struct + Description string + Discovery WorkspaceDiscovery + DisplayName string + Enabled bool + ExpectedRevision uint64 + type WorkspaceArtifactSettings struct + RuntimeDisabled bool + type WorkspaceArtifactView struct + Adoption artifact.AdoptionMode + Artifact artifact.ArtifactRef + Diagnostics []diagnostic.Diagnostic + Enabled bool + Kind artifact.ArtifactKind + Locator basespec.Locator + Name string + ResolvedDefinition *cryptoutil.Digest + Revision uint64 + RuntimeDisabled bool + SourceID source.SourceID + State artifact.State + SubresourceLocator basespec.SubresourceLocator + type WorkspaceAttachmentSettings struct + Authoritative *bool + Recursive *bool + type WorkspaceAttachmentView struct + Diagnostics []diagnostic.Diagnostic + Enabled bool + Path string + Revision uint64 + Role collection.AttachmentRole + Settings WorkspaceAttachmentSettings + SourceDisplayName string + SourceID source.SourceID + SourceKind string + type WorkspaceCatalogView struct + CatalogCurrent bool + CatalogRevision uint64 + Diagnostics []diagnostic.Diagnostic + Groups []WorkspaceResourceGroupView + InvalidOccurrences []WorkspaceOccurrenceView + MissingOccurrences []WorkspaceOccurrenceView + Occurrences []WorkspaceOccurrenceView + Resources []WorkspaceResourceView + UnrecordedCount int + UnrecordedOccurrences []WorkspaceOccurrenceView + UnresolvedArtifactCount int + UnresolvedArtifacts []WorkspaceArtifactView + ValidOccurrences []WorkspaceOccurrenceView + Workspace WorkspaceView + type WorkspaceContextContribution struct + Artifact artifact.ArtifactRef + Content string + ConventionOrder int + DefinitionDigest cryptoutil.Digest + IncludedBytes int + Locator basespec.Locator + MediaType artifactbuiltin.WorkspaceContextMediaType + Name string + OriginalBytes int + RecordRevision uint64 + Role artifactbuiltin.WorkspaceContextRole + SourceID source.SourceID + Truncated bool + func ContextContributionViewOf(value ContextContribution) WorkspaceContextContribution + type WorkspaceContextDecision struct + Artifact artifact.ArtifactRef + Code string + IncludedBytes int + OriginalBytes int + Status workspaceRuntime.CompositionStatus + type WorkspaceContextInspectionView struct + CatalogRevision uint64 + Contributions []WorkspaceContextContribution + Diagnostics []diagnostic.Diagnostic + Workspace workspaceDomain.WorkspaceRef + type WorkspaceContextLoadPlan struct + CatalogRevision uint64 + Contributions []WorkspaceContextContribution + Decisions []WorkspaceContextDecision + Diagnostics []diagnostic.Diagnostic + Prompt string + PromptBytes int + Workspace workspaceDomain.WorkspaceRef + func ContextLoadPlanViewOf(value ContextLoadPlan) WorkspaceContextLoadPlan + type WorkspaceContextView struct + Artifact artifact.ArtifactRef + CatalogCurrent bool + DefinitionDigest cryptoutil.Digest + Diagnostics []diagnostic.Diagnostic + Enabled bool + Locator basespec.Locator + MediaType artifactbuiltin.WorkspaceContextMediaType + Name string + ProjectionValid bool + RecordRevision uint64 + Role artifactbuiltin.WorkspaceContextRole + RuntimeDisabled bool + SourceID source.SourceID + State artifact.State + func ContextViewOf(value ContextDocument) WorkspaceContextView + type WorkspaceDirectoryRegistrationResult struct + Source WorkspaceSourceSummary + Workspace WorkspaceView + type WorkspaceDiscovery struct + AdditionalLocators []basespec.Locator + AdditionalRoots []WorkspaceDiscoveryRoot + IncludeReadme bool + type WorkspaceDiscoveryRoot struct + IncludePatterns []string + Recursive bool + Root basespec.Locator + type WorkspaceOccurrenceRef struct + Locator basespec.Locator + SourceID source.SourceID + SubresourceLocator basespec.SubresourceLocator + type WorkspaceOccurrenceView struct + Artifact *artifact.ArtifactRef + DefinitionDigest *cryptoutil.Digest + Diagnostics []diagnostic.Diagnostic + Kind artifact.ArtifactKind + Locator basespec.Locator + LogicalName basespec.LogicalName + LogicalVersion basespec.LogicalVersion + Recorded bool + SourceContentDigest *cryptoutil.Digest + SourceID source.SourceID + State string + SubresourceLocator basespec.SubresourceLocator + type WorkspaceRef = collection.CollectionRef + type WorkspaceRefreshResult struct + Candidates int + CatalogRevision uint64 + CreatedArtifacts []artifact.ArtifactRef + Diagnostics []diagnostic.Diagnostic + UpdatedArtifacts []artifact.ArtifactRef + Workspace WorkspaceRef + type WorkspaceResourceGroupView struct + Kind artifact.ArtifactKind + Resources []WorkspaceResourceView + Unrecorded []WorkspaceOccurrenceView + type WorkspaceResourceView struct + Artifact WorkspaceArtifactView + CatalogCurrent bool + DefinitionDigest cryptoutil.Digest + Diagnostics []diagnostic.Diagnostic + Locator basespec.Locator + ProjectionValid bool + SourceID source.SourceID + type WorkspaceSkillArgument struct + Default string + Description string + Name string + type WorkspaceSkillLoadView struct + CatalogRevision uint64 + Diagnostics []diagnostic.Diagnostic + Skills []WorkspaceSkillView + Workspace workspaceDomain.WorkspaceRef + func WorkspaceSkillLoadViewOf(value workspaceadapter.SkillLoadPlan) WorkspaceSkillLoadView + type WorkspaceSkillSummary struct + Arguments []WorkspaceSkillArgument + CreatedAt time.Time + Description string + DisplayName string + ID artifact.ArtifactID + Insert document.SkillInsert + IsEnabled bool + ModifiedAt time.Time + Name string + SchemaVersion string + Slug string + Tags []string + type WorkspaceSkillView struct + Artifact artifact.ArtifactRef + CatalogCurrent bool + DefinitionDigest cryptoutil.Digest + Diagnostics []diagnostic.Diagnostic + Locator basespec.Locator + MarkdownBody string + ProjectionValid bool + RecordRevision uint64 + RuntimeDisabled bool + Skill WorkspaceSkillSummary + SourceID source.SourceID + State artifact.State + Workspace workspaceDomain.WorkspaceRef + func WorkspaceSkillViewOf(value workspaceadapter.WorkspaceSkill) WorkspaceSkillView + type WorkspaceSourceSummary = source.Summary + type WorkspaceSuppressionView struct + Binding artifact.SourceBinding + CreatedAt time.Time + ModifiedAt time.Time + Revision uint64 + Workspace WorkspaceRef + type WorkspaceView struct + Attachments []WorkspaceAttachmentView + Description string + Discovery WorkspaceDiscovery + DisplayName string + Enabled bool + Mode workspaceDomain.Mode + PrimaryPath string + PrimarySourceID source.SourceID + Revision uint64 + Workspace workspaceDomain.WorkspaceRef