Documentation
¶
Index ¶
- Constants
- Variables
- func AgentPluginDiagnostics(name string, values []agentplugin.Diagnostic) []diagnosticcontract.DiagnosticItem
- func BindHostAPIWorkspaceParams(ctx context.Context, raw json.RawMessage, binding HostAPIWorkspaceBinding, ...) (json.RawMessage, error)
- func CheckExpectedDigest(expected, actual string) error
- func ComputeDirectoryChecksum(path string) (string, error)
- func ContentsFor(manifest *Manifest, kit []KitItem) contract.ExtensionContentsPayload
- func DescribeExtension(ext *Extension, daemonRunning bool, now time.Time) contract.ExtensionPayload
- func DescribeExtensionForProfile(ext *Extension, daemonRunning bool, now time.Time, profileName string) contract.ExtensionPayload
- func DescribeInputState(manifest *Manifest, state InputState, getenv func(string) string) []contract.ExtensionInputStatePayload
- func ForgeProviderErrorCause(err error) string
- func GatewayRequirementDigest(req *GatewayRequirement) (string, error)
- func InspectMarketplacePackage(ctx context.Context, homePaths compozyconfig.HomePaths, ...) (_ contract.MarketplaceExtensionDetailPayload, resultErr error)
- func InspectPackageContents(ctx context.Context, ext *Extension, profileName string) (contract.ExtensionContentsPayload, error)
- func InspectPluginPackage(ctx context.Context, root string, name string) (marketplace.PluginInspection, error)
- func InstallBundledExtension(homePaths compozyconfig.HomePaths, registry *Registry, spec BundledInstallSpec) (err error)
- func InstallLocalManaged(homePaths compozyconfig.HomePaths, registry LifecycleRegistry, ...) (err error)
- func InstalledExtensionDir(info *ExtensionInfo) (string, error)
- func LoadAutomationResources(rootDir string, extensionName string, paths []string) ([]automationpkg.Job, []automationpkg.Trigger, error)
- func LoadLayoutResources(ctx context.Context, rootDir string, paths []string) ([]windowmanager.LayoutResource, error)
- func LoadMarketplaceSources(ctx context.Context, loader MarketplaceSourceLoader, sourceFilter string) ([]registrypkg.Source, error)
- func MCPServerLaunchSummary(command, remoteURL string) string
- func ManagedInstallPath(homePaths compozyconfig.HomePaths, name string) string
- func ManagedInstallPathChecked(homePaths compozyconfig.HomePaths, name string) (string, error)
- func ManagedInstallRoot(homePaths compozyconfig.HomePaths) string
- func MarketplaceEntryTrustReport(evidence MarketplaceTrustEvidence, policyAllowsUnverified bool) (contract.ExtensionTrustReportPayload, error)
- func MaterializeBundledExtension(homePaths compozyconfig.HomePaths, name string, embedded fs.FS) (string, error)
- func NewExtensionModelSources(registry *Registry, resolver ModelSourceRuntimeResolver) ([]modelcatalog.Source, error)
- func NewManagedInstallStagingDir(homePaths compozyconfig.HomePaths) (string, error)
- func NormalizeInputJSON(inputType string, raw json.RawMessage) (json.RawMessage, error)
- func PackageRootFromManifest(path string) string
- func ReconcileManagedExtensionArtifacts(homePaths compozyconfig.HomePaths, registry managedInstallReconcileRegistry) error
- func ReconcileManifestToolRuntime(manifest *ManifestToolDescriptor, ...) toolspkg.Availability
- func RemoveManagedInstall(homePaths compozyconfig.HomePaths, name string) error
- func RequireBuiltinForPermanentRemoval(info *ExtensionInfo) error
- func ResolveManifestToolResources(manifest *Manifest) ([]toolspkg.Tool, error)
- func ResourcePaths(resources []ManifestResourcePath) []string
- func SupersededBundledSuccessor(name string) string
- func ValidateBundle(dir string) (*Manifest, []ValidationIssue, error)
- func ValidateDaemonCompatibility(minVersion string) error
- func ValidateExpectedDigest(digest string) error
- func ValidateManifestForCompozyVersion(manifest *Manifest, currentVersion string) error
- func ValidateManifestInputs(manifest *Manifest) error
- func ValidateUnverifiedSideLoad(slug string, source string, policyAllowsUnverified bool, allowUnverified bool) error
- type ActiveExtension
- type AgentConflictError
- type AgentPluginManifestValidationError
- type AgentPluginNotManifestError
- type AgentSidecar
- type BuildRequest
- type BuildResult
- type BuiltinTombstone
- type BuiltinTombstones
- type BundledInstallSpec
- type CapabilitiesConfig
- type CapabilityChecker
- func (c *CapabilityChecker) Check(extName, capability string) error
- func (c *CapabilityChecker) CheckHostAPI(extName, method string) error
- func (c *CapabilityChecker) Grant(extName string) EffectiveGrant
- func (c *CapabilityChecker) Register(extName string, source ExtensionSource, manifest *Manifest)
- func (c *CapabilityChecker) RegisterForSession(extName string, source ExtensionSource, manifest *Manifest, ...) (EffectiveGrant, error)
- func (c *CapabilityChecker) Resolve(source ExtensionSource, manifest *Manifest, ...) (EffectiveGrant, error)
- func (c *CapabilityChecker) SetResourcePolicy(policy compozyconfig.ExtensionsResourcesConfig)
- func (c *CapabilityChecker) Unregister(extName string)
- type CapabilityDeniedData
- type CmdPaletteAction
- type CmdPaletteArgument
- type CmdPaletteCommand
- type CmdPaletteConfig
- type CmdPaletteConfirmation
- type CmdPaletteDefaultShortcut
- type CmdPaletteExecutionPolicy
- type CmdPaletteProjectedCommand
- type CmdPaletteProjectedView
- type CmdPaletteProjection
- type CmdPaletteResolvedExecutionPolicy
- type CmdPaletteSourceStatus
- type CmdPaletteView
- type CmdPaletteViewSource
- type CommandDescriptor
- type CommandGroupDescriptor
- type ConnectivityProviderTrustResolver
- type ConsentArea
- type DeclaredProfileApplyResult
- type DeclaredProfilePlan
- type DeclaredProfilePlanEntry
- type DevLink
- type DevLinkRequest
- type DevelopmentGeneration
- type Duration
- type EffectiveGrant
- type EnvBinding
- type EnvBindingLifecycleStore
- type EnvBindingStore
- type EnvBindingValidationError
- type ErrCapabilityDenied
- type Extension
- type ExtensionArchiveDigestMismatchError
- type ExtensionChecksumMismatchError
- type ExtensionExistsError
- type ExtensionFormat
- type ExtensionInfo
- type ExtensionJob
- type ExtensionLogCursor
- type ExtensionLogEntry
- type ExtensionLogRing
- type ExtensionLogSnapshot
- type ExtensionNameConflictError
- type ExtensionNotBuiltinError
- type ExtensionNotFoundError
- type ExtensionPhase
- type ExtensionPolicyBlockedError
- type ExtensionProvenance
- type ExtensionSource
- type ExtensionStatus
- type ExtensionToolCallTracker
- type ExtensionToolProvider
- func (p *ExtensionToolProvider) ID() toolspkg.SourceRef
- func (p *ExtensionToolProvider) List(ctx context.Context, scope toolspkg.Scope) ([]toolspkg.Descriptor, error)
- func (p *ExtensionToolProvider) ProjectionAvailability(ctx context.Context, scope toolspkg.Scope, ids []toolspkg.ToolID) map[toolspkg.ToolID]toolspkg.Availability
- func (p *ExtensionToolProvider) ProjectionGeneration(ctx context.Context, scope toolspkg.Scope) (string, bool)
- func (p *ExtensionToolProvider) ProjectionScope(scope toolspkg.Scope) toolspkg.Scope
- func (p *ExtensionToolProvider) Resolve(ctx context.Context, scope toolspkg.Scope, id toolspkg.ToolID) (toolspkg.Handle, bool, error)
- type ExtensionToolProviderOption
- type ExtensionToolRuntime
- type ExtensionToolRuntimeResolver
- type ExtensionToolRuntimeState
- type ExtensionTrigger
- type ExtensionTrustError
- type ForgeProviderError
- type ForgeRuntime
- type GatewayConfirmation
- type GatewayConfirmationRequiredError
- type GatewayRequirement
- type HookConfig
- type HookExecutorConfig
- type HookMatcherConfig
- type HostAPIAutomationManager
- type HostAPIHandler
- func (h *HostAPIHandler) BeginExtensionToolCall(ctx context.Context, extensionName string, sessionID string) (string, func(), error)
- func (h *HostAPIHandler) Handle(ctx context.Context, extName string, method string, params json.RawMessage) (any, error)
- func (h *HostAPIHandler) HandleMethod(method string) subprocess.HandlerFunc
- func (h *HostAPIHandler) HandleWithResourceActor(ctx context.Context, principal string, method string, params json.RawMessage, ...) (any, error)
- func (h *HostAPIHandler) MethodHandlers() map[string]subprocess.HandlerFunc
- type HostAPIOption
- func WithHostAPIAutomationGetter(getter func() HostAPIAutomationManager) HostAPIOption
- func WithHostAPIAutomationManager(manager HostAPIAutomationManager) HostAPIOption
- func WithHostAPICapabilityChecker(checker *CapabilityChecker) HostAPIOption
- func WithHostAPIClarify(broker toolspkg.ClarifyBroker) HostAPIOption
- func WithHostAPIHeartbeatAuthoring(service hostAPIHeartbeatAuthoringService) HostAPIOption
- func WithHostAPIHeartbeatStatus(service hostAPIHeartbeatStatusService) HostAPIOption
- func WithHostAPIHeartbeatWake(service hostAPIHeartbeatWakeService) HostAPIOption
- func WithHostAPIHeartbeatWakeEvents(reader hostAPIHeartbeatWakeEventReader) HostAPIOption
- func WithHostAPIModelCatalogService(service modelcatalog.Service) HostAPIOption
- func WithHostAPINow(now func() time.Time) HostAPIOption
- func WithHostAPIProfileReader(reader hostAPIProfileReader) HostAPIOption
- func WithHostAPIRateLimit(limit int, burst int) HostAPIOption
- func WithHostAPIResourceCodecRegistry(registry *resources.CodecRegistry) HostAPIOption
- func WithHostAPIResourceStore(store resources.RawStore) HostAPIOption
- func WithHostAPIResourceTrigger(...) HostAPIOption
- func WithHostAPISessionHealth(reader hostAPISessionHealthReader) HostAPIOption
- func WithHostAPISoulAuthoring(service hostAPISoulAuthoringService) HostAPIOption
- func WithHostAPISoulRefresher(refresher hostAPISoulRefresher) HostAPIOption
- func WithHostAPITaskCatalogFilterMapper(mapper HostAPITaskCatalogFilterMapper) HostAPIOption
- func WithHostAPITaskManager(manager hostAPITaskManager) HostAPIOption
- func WithHostAPIViewPatchPublisher(publisher ViewPatchPublisher) HostAPIOption
- func WithHostAPIViewService(service cmdpalette.ViewService) HostAPIOption
- func WithHostAPIWorkspaceResolver(resolver workspacepkg.RuntimeResolver) HostAPIOption
- type HostAPITaskCatalogFilterMapper
- type HostAPIWorkspaceBinding
- type InputState
- type InputValidationError
- type InputValueRecord
- type InputsRequiredError
- type InstallOption
- func WithInstallEnabled(enabled bool) InstallOption
- func WithInstallProvenance(provenance ExtensionProvenance) InstallOption
- func WithInstallRegistryMetadata(slug string, registryName string, remoteVersion string) InstallOption
- func WithInstallReplaceExisting() InstallOption
- func WithInstallScope(scope InstallationScope) InstallOption
- func WithInstallSource(source ExtensionSource) InstallOption
- type Installation
- type InstallationScope
- type InstanceKey
- type IssueSeverity
- type KitItem
- type LifecycleEvent
- type LifecycleEventSink
- type LifecycleRegistry
- type MCPServerAuthConfig
- type MCPServerConfig
- type ManagedRemovalCommit
- type ManagedRemoveResult
- type Manager
- func (m *Manager) ActivateDevelopmentLink(ctx context.Context, key InstanceKey) (*Extension, error)
- func (m *Manager) AgentDefinitions() []compozyconfig.AgentDef
- func (m *Manager) CallTool(ctx context.Context, extensionName string, ...) (toolspkg.ToolResult, error)
- func (m *Manager) CallToolForInstance(ctx context.Context, key InstanceKey, req toolspkg.ExtensionToolCallRequest) (toolspkg.ToolResult, error)
- func (m *Manager) CloseProgram(ctx context.Context, profile cmdpalette.ProfileLens, ...) error
- func (m *Manager) CmdPalette(workspaceID string, profile ProfileLens) (CmdPaletteProjection, error)
- func (m *Manager) CmdPaletteSettings(workspaceID string, profile ProfileLens) (CmdPaletteProjection, error)
- func (m *Manager) Commands(workspaceID string) ([]CommandDescriptor, []CommandGroupDescriptor, error)
- func (m *Manager) ForgeCapabilities(ctx context.Context, remoteURLs []string) (extensioncontract.ForgeCapabilitiesResponse, error)
- func (m *Manager) ForgeCreatePR(ctx context.Context, request extensioncontract.ForgePRCreateRequest) (extensioncontract.ForgePRCreateResponse, error)
- func (m *Manager) ForgeReadPR(ctx context.Context, request c.ForgePRReadRequest) (c.ForgePRCandidate, error)
- func (m *Manager) ForgeSearchPRs(ctx context.Context, request c.ForgePRSearchRequest) (c.ForgePRSearchResponse, error)
- func (m *Manager) ForgeStatus(ctx context.Context, request extensioncontract.ForgeStatusRequest) (extensioncontract.ForgeStatusResponse, error)
- func (m *Manager) Get(name string) (*Extension, error)
- func (m *Manager) GetForInstance(key InstanceKey) (*Extension, error)
- func (m *Manager) HandleProgramEvent(ctx context.Context, profile cmdpalette.ProfileLens, ...) (*cmdpalette.ViewFrame, error)
- func (m *Manager) HookDeclarationsForProfiles(ctx context.Context, profiles []ProfileLens) ([]hookspkg.HookDecl, error)
- func (m *Manager) InspectDevelopmentGeneration(ctx context.Context, workspaceID string, originPath string, ...) (DevelopmentGeneration, error)
- func (m *Manager) InspectPackageResources(ctx context.Context, name string) (*Extension, error)
- func (m *Manager) InvalidateProfileRuntime(ctx context.Context, key InstanceKey) error
- func (m *Manager) LinkDevelopment(ctx context.Context, key InstanceKey, originPath string, generationHash string) (*Extension, error)
- func (m *Manager) LinkDevelopmentFromOrigin(ctx context.Context, workspaceID string, originPath string, ...) (*Extension, error)
- func (m *Manager) List() []ExtensionInfo
- func (m *Manager) ListForWorkspace(workspaceID string) []ExtensionInfo
- func (m *Manager) ListModelSourceRows(ctx context.Context, extensionName string, ...) ([]extensioncontract.ModelSourceRow, error)
- func (m *Manager) Logs(key InstanceKey, cursor ExtensionLogCursor) (ExtensionLogSnapshot, error)
- func (m *Manager) OpenProgram(ctx context.Context, extensionName string, request cmdpalette.ViewOpenRequest) (cmdpalette.ViewFrame, uint64, error)
- func (m *Manager) Poll(ctx context.Context, req watchpkg.PollRequest) (watchpkg.PollResponse, error)
- func (m *Manager) PollSource(ctx context.Context, scope source.CatalogScope, ref string, req source.Request) (source.Result, error)
- func (m *Manager) ProjectForProfile(ctx context.Context, key InstanceKey, profile ProfileLens) (*Extension, bool, error)
- func (m *Manager) ProvideTools(ctx context.Context, extensionName string) ([]toolspkg.ExtensionToolRuntimeDescriptor, error)
- func (m *Manager) ProvideToolsForInstance(ctx context.Context, key InstanceKey) ([]toolspkg.ExtensionToolRuntimeDescriptor, error)
- func (m *Manager) Reload(ctx context.Context) error
- func (m *Manager) ReloadExtension(ctx context.Context, key InstanceKey, generationHash string) (*Extension, error)
- func (m *Manager) ReloadForExtensions(ctx context.Context, names []string) error
- func (m *Manager) ResolveConnectivitySource(ctx context.Context, name string) (gateway.ConnectivitySource, error)
- func (m *Manager) SourceKinds(ctx context.Context, scope source.CatalogScope) ([]source.KindDescriptor, error)
- func (m *Manager) StageDevelopmentLink(ctx context.Context, key InstanceKey, originPath string, generationHash string) (*DevLink, error)
- func (m *Manager) Start(ctx context.Context) error
- func (m *Manager) Statuses() []ExtensionStatus
- func (m *Manager) StatusesForWorkspace(workspaceID string) []ExtensionStatus
- func (m *Manager) Stop(ctx context.Context) error
- func (m *Manager) UnlinkDevelopment(ctx context.Context, key InstanceKey) error
- func (m *Manager) WatchPoll(ctx context.Context, extensionName string, req watchpkg.PollRequest) (watchpkg.PollResponse, error)
- type Manifest
- func (m *Manifest) AgentPluginHeaderSecretInputs() map[string]string
- func (m *Manifest) DormantPlacements(profileNames []string) []ManifestPlacement
- func (m *Manifest) MissingEnv(getenv func(string) string) []string
- func (m *Manifest) PlacementMatrix() []ManifestPlacement
- func (m *Manifest) Validate() error
- type ManifestCompatibilityError
- type ManifestInput
- type ManifestNotFoundError
- type ManifestPlacement
- type ManifestProfile
- type ManifestProfileCredential
- type ManifestProfileDefaults
- type ManifestResourcePath
- type ManifestToolDescriptor
- type ManifestValidationError
- type MarketplaceDigestVerificationObserver
- type MarketplaceInstallRequest
- type MarketplacePackageAcquirer
- type MarketplacePluginAcquisition
- type MarketplacePluginResolver
- type MarketplaceSourceLoader
- type MarketplaceTrustEvidence
- type MarketplaceTrustResolver
- type MarketplaceUpdateBatchError
- type MarketplaceUpdateCommit
- type MarketplaceUpdatePreflight
- type MarketplaceUpdateRequest
- type MarketplaceUpdateResult
- type MarketplaceUpdateRollback
- type ModelSource
- func (s *ModelSource) CatalogExecutionFingerprint() (string, error)
- func (s *ModelSource) ID() string
- func (s *ModelSource) Kind() modelcatalog.SourceKind
- func (s *ModelSource) ListModels(ctx context.Context, opts modelcatalog.ListOptions) ([]modelcatalog.ModelRow, error)
- func (s *ModelSource) Priority() int
- func (s *ModelSource) TTL() time.Duration
- type ModelSourceRuntime
- type ModelSourceRuntimeResolver
- type MutationReload
- type Option
- func WithCapabilityChecker(checker *CapabilityChecker) Option
- func WithCompozyExecutableResolver(resolver func() (string, error)) Option
- func WithDefaultHookTimeout(timeout time.Duration) Option
- func WithEnvBindingStore(store EnvBindingStore) Option
- func WithExtensionToolCallTracker(tracker ExtensionToolCallTracker) Option
- func WithGetenv(getenv func(string) string) Option
- func WithHealthCheckTimeout(timeout time.Duration) Option
- func WithHomePaths(paths compozyconfig.HomePaths) Option
- func WithHostMethodHandler(method string, handler subprocess.HandlerFunc) Option
- func WithInitializeTimeout(timeout time.Duration) Option
- func WithLifecycleEventSink(sink LifecycleEventSink) Option
- func WithLogger(logger *slog.Logger) Option
- func WithNow(now func() time.Time) Option
- func WithProcessRegistry(registry *toolruntime.Registry) Option
- func WithProfileNameResolver(resolver ProfileNameResolver) Option
- func WithSecretResolver(resolver SecretRefResolver) Option
- func WithSourceSessionManager(manager resources.SourceSessionManager) Option
- func WithSubprocessSignalGrace(timeout time.Duration) Option
- func WithWorkspaceResolver(resolver workspacepkg.RuntimeResolver) Option
- type PermissionsConfig
- type PreparedLocalManagedInstall
- func (p *PreparedLocalManagedInstall) Close() error
- func (p *PreparedLocalManagedInstall) Commit() error
- func (p *PreparedLocalManagedInstall) MatchesInstalled(info *ExtensionInfo) bool
- func (p *PreparedLocalManagedInstall) Origin() marketplacepkg.Origin
- func (p *PreparedLocalManagedInstall) Reinstall(ctx context.Context, info *ExtensionInfo, preflight MarketplaceUpdatePreflight, ...) ([]diagnosticcontract.DiagnosticItem, error)
- func (p *PreparedLocalManagedInstall) ValidateReinstall(info *ExtensionInfo) error
- type PreparedMarketplaceManagedInstall
- func (p *PreparedMarketplaceManagedInstall) Close() error
- func (p *PreparedMarketplaceManagedInstall) Commit(scope InstallationScope) (*ExtensionInfo, error)
- func (p *PreparedMarketplaceManagedInstall) Digest() string
- func (p *PreparedMarketplaceManagedInstall) Manifest() *Manifest
- func (p *PreparedMarketplaceManagedInstall) MatchesInstalled(info *ExtensionInfo) bool
- func (p *PreparedMarketplaceManagedInstall) Name() string
- func (p *PreparedMarketplaceManagedInstall) Origin() marketplacepkg.Origin
- func (p *PreparedMarketplaceManagedInstall) Reinstall(ctx context.Context, info *ExtensionInfo, preflight MarketplaceUpdatePreflight, ...) ([]diagnosticcontract.DiagnosticItem, error)
- func (p *PreparedMarketplaceManagedInstall) ValidateReinstall(info *ExtensionInfo) error
- type ProfileLens
- type ProfileNameResolver
- type PublishRequest
- type PublishResult
- type Readiness
- type Registry
- func (r *Registry) AttachInstallation(ctx context.Context, name string, scope InstallationScope) error
- func (r *Registry) BuiltinTombstoneFor(ctx context.Context, name string) (BuiltinTombstone, bool, error)
- func (r *Registry) Clear(ctx context.Context, name string) (bool, error)
- func (r *Registry) ConfirmDevelopmentGatewayCandidate(key InstanceKey, digest string, actor string, at time.Time) error
- func (r *Registry) ConfirmGatewayRequirement(key InstanceKey, expectedDigest string, actor string, at time.Time) error
- func (r *Registry) DB() *sql.DB
- func (r *Registry) DetachInstallation(ctx context.Context, name string, scope InstallationScope) error
- func (r *Registry) DevLinkNamesForWorkspace(workspaceID string) (names []string, resultErr error)
- func (r *Registry) Disable(name string) error
- func (r *Registry) DisableIfLifecycleToken(name string, expectedToken string) (bool, error)
- func (r *Registry) Enable(name string) error
- func (r *Registry) EnabledBundledNames() ([]string, error)
- func (r *Registry) EnvBindingScopes(ctx context.Context, name string) ([]InstallationScope, error)
- func (r *Registry) GatewayConfirmation(key InstanceKey) (GatewayConfirmation, error)
- func (r *Registry) Get(name string) (*ExtensionInfo, error)
- func (r *Registry) GetContext(ctx context.Context, name string) (*ExtensionInfo, error)
- func (r *Registry) GetDevLink(name, workspaceID string) (*DevLink, error)
- func (r *Registry) Install(manifest *Manifest, path string, checksum string, opts ...InstallOption) error
- func (r *Registry) Installations(ctx context.Context, name string) ([]Installation, error)
- func (r *Registry) IsEnabledForProfile(name string, profileID string) (bool, error)
- func (r *Registry) LinkDev(req DevLinkRequest) (*DevLink, error)
- func (r *Registry) List() (extensions []ExtensionInfo, err error)
- func (r *Registry) ListDevLinks() (links []DevLink, resultErr error)
- func (r *Registry) ListTombstones(ctx context.Context) (tombstones []BuiltinTombstone, err error)
- func (r *Registry) PlacementsForProfile(ctx context.Context, profileName string) ([]profilepkg.PlacementRef, error)
- func (r *Registry) ReconcileBundledProvenance(manifest *Manifest) error
- func (r *Registry) ResolveActive(name, workspaceID string) (*ActiveExtension, error)
- func (r *Registry) ResolveInstallation(ctx context.Context, name string, scope InstallationScope) (Installation, error)
- func (r *Registry) RestoreBuiltinTombstone(ctx context.Context, tombstone BuiltinTombstone) error
- func (r *Registry) RestoreGatewayConfirmation(key InstanceKey, confirmation GatewayConfirmation) error
- func (r *Registry) RestoreRemovalState(ctx context.Context, name string, snapshot RemovalState) error
- func (r *Registry) SetEnabledForProfile(name string, profileID string, enabled bool) error
- func (r *Registry) SnapshotRemovalState(ctx context.Context, name string) (RemovalState, error)
- func (r *Registry) Tombstone(ctx context.Context, name string, removedBy string) (BuiltinTombstone, error)
- func (r *Registry) Tombstoned(ctx context.Context, name string) (bool, error)
- func (r *Registry) Uninstall(name string) error
- func (r *Registry) UnlinkDev(name, workspaceID string) error
- type RegistryOption
- type RemovalRegistry
- type RemovalState
- type ResolvedManifestMCPServer
- type ResourceGrantRequest
- type ResourcesConfig
- type ScaffoldRequest
- type ScaffoldResult
- type ScaffoldTemplate
- type SecretRefResolver
- type SourceChangedError
- type StaticAgent
- type SubprocessConfig
- type ToolBackendConfig
- type ToolConfig
- type ValidationIssue
- type ValidationReport
- type ViewPatchPublisher
Constants ¶
const ( CmdPaletteSourceHealthy = "healthy" CmdPaletteSourceUnhealthy = "unhealthy" CmdPaletteSourceDisabled = "disabled" )
const ( // IssueSeverityError blocks extension use. IssueSeverityError = extensioncontract.IssueSeverityError // IssueSeverityWarning reports non-blocking authoring guidance. IssueSeverityWarning = extensioncontract.IssueSeverityWarning // IssueSeverityWarn reports one non-blocking portable component skip. IssueSeverityWarn = extensioncontract.IssueSeverityWarn )
const ( // HostAPIRateLimitedCode is the protocol code for per-extension backpressure. HostAPIRateLimitedCode = -32002 HostAPIUnavailableCode = -32005 // HostAPINotFoundCode reports a missing Host API resource. HostAPINotFoundCode = -32006 // HostAPIInvalidParamsCode is the JSON-RPC invalid params code used for bad request payloads. HostAPIInvalidParamsCode = -32602 // HostAPIMethodNotFoundCode is the JSON-RPC method-not-found code for unknown Host API methods. HostAPIMethodNotFoundCode = -32601 )
const ( // MarketplaceUpdateStatusCurrent reports that no remote update is available. MarketplaceUpdateStatusCurrent = "current" // MarketplaceUpdateStatusAvailable reports that a remote update exists but was not applied. MarketplaceUpdateStatusAvailable = "available" // MarketplaceUpdateStatusUpdated reports that a remote update was applied. MarketplaceUpdateStatusUpdated = "updated" // MarketplaceUpdateStatusFailed reports one failed item in a batch. MarketplaceUpdateStatusFailed = "failed" )
const ( ExtensionInstalledFromMarketplace = "marketplace_registry" ExtensionInstalledFromBundled = "bundled" ExtensionInstalledFromGitHub = "github" ExtensionInstalledFromLocalPath = "local_path" ExtensionInstalledFromGitURL = "git_url" ExtensionRegistryTierOfficial = "official" ExtensionRegistryTierCommunity = "community" ExtensionRegistryTierUnverified = "unverified" ExtensionTrustDecisionVerified = "verified" ExtensionTrustDecisionAllowedUnverified = "allowed_unverified" ExtensionTrustDecisionBlocked = "blocked" )
const ( // CapabilityDeniedCode is the protocol-equivalent code for denied extension // capabilities and Host API actions. CapabilityDeniedCode = -32001 )
const (
// DefaultRestartFailureThreshold is the production crash-loop cutoff shared by status and doctor projections.
DefaultRestartFailureThreshold = 5
)
const ExtensionEnvBindingKind = extensionenv.BindingKind
ExtensionEnvBindingKind identifies persisted extension environment bindings.
const MarketplaceCatalogRegistryName = "compozy-catalog"
MarketplaceCatalogRegistryName identifies feed-owned extension artifacts in installed provenance.
Variables ¶
var ( // ErrAgentPluginNotManifest reports a root plugin.json owned by another ecosystem. ErrAgentPluginNotManifest = errors.New("extension: plugin.json is not an Agent Plugins manifest") // ErrAgentPluginManifestInvalid reports fatal portable root-manifest issues. ErrAgentPluginManifestInvalid = agentplugin.ErrManifestInvalid )
var ( // ErrExtensionEnvBindingInvalid reports malformed extension secret binding input. ErrExtensionEnvBindingInvalid = errors.New("extension: invalid environment binding") // ErrExtensionEnvBindingUndeclared reports a binding outside the current requires_env contract. ErrExtensionEnvBindingUndeclared = errors.New("extension: undeclared environment binding") // ErrExtensionEnvBindingDangling reports a binding to absent Vault material. ErrExtensionEnvBindingDangling = errors.New("extension: environment binding secret is not present") )
var ( // ErrExtensionNotDevLinked reports that no workspace dev overlay exists. ErrExtensionNotDevLinked = errors.New("extension: extension is not dev linked") // ErrExtensionGenerationInvalid reports that an immutable generation handle failed validation. ErrExtensionGenerationInvalid = errors.New("extension: generation is invalid") // ErrExtensionWorkspaceDenied reports an attempted cross-workspace instance access. ErrExtensionWorkspaceDenied = errors.New("extension: workspace access denied") // ErrExtensionDevOriginMissing reports a persisted dev origin that is no longer present. ErrExtensionDevOriginMissing = errors.New("extension: development origin is missing") )
var ( // ErrContextRequired reports that a manager operation requires a non-nil context. ErrContextRequired = errors.New("extension: context is required") // ErrManagerRequired reports that a manager-backed operation was invoked on a nil manager. ErrManagerRequired = errors.New("extension: manager is required") // ErrRegistryRequired reports that a manager operation requires a configured registry. ErrRegistryRequired = errors.New("extension: registry is required") // ErrPathEscapesExtensionRoot reports that a requested resource path resolves outside the // extension root. ErrPathEscapesExtensionRoot = errors.New("extension: path escapes extension root") )
var ( // ErrManifestNotFound reports that an extension directory does not contain // either supported manifest file. ErrManifestNotFound = errors.New("extension: manifest not found") // ErrManifestInvalid reports that the manifest schema or content is invalid. ErrManifestInvalid = errors.New("extension: invalid manifest") // ErrManifestIncompatible reports that the manifest requires a newer daemon // version than the current build provides. ErrManifestIncompatible = errors.New("extension: incompatible manifest") )
var ( // ErrExtensionUnverifiedPolicyBlocked reports a side-load denied by daemon policy. ErrExtensionUnverifiedPolicyBlocked = errors.New("extension: unverified install blocked by policy") // ErrExtensionArchiveDigestMismatch reports an archive that differs from its declared digest. ErrExtensionArchiveDigestMismatch = errors.New("extension: archive digest mismatch") )
var ( // ErrExtensionNotFound reports that no installed extension matched the lookup. ErrExtensionNotFound = errors.New("extension: extension not found") // ErrExtensionExists reports that an extension name is already installed. ErrExtensionExists = errors.New("extension: extension already exists") // ErrExtensionChecksumMismatch reports that the provided checksum does not // match the on-disk extension artifact. ErrExtensionChecksumMismatch = errors.New("extension: checksum mismatch") )
var ErrExtensionAgentConflict = errors.New("extension: shipped agent conflicts with a visible agent")
ErrExtensionAgentConflict reports that a shipped agent would shadow a visible agent.
var ErrExtensionBuiltinAttached = errors.New("extension: built-in extension has other installations")
ErrExtensionBuiltinAttached reports that a built-in still has other installations, so a removal would only detach one scope and could not record a tombstone for the built-in.
var ErrExtensionBuiltinNotRemoved = errors.New("extension: built-in extension is not permanently removed")
ErrExtensionBuiltinNotRemoved reports that restore targeted a built-in with no tombstone.
var ErrExtensionBuiltinRemovalCompensationFailed = errors.New(
"extension: built-in removal was committed and could not be fully compensated",
)
ErrExtensionBuiltinRemovalCompensationFailed reports that a permanent removal committed its tombstone and its compensation failed. The built-in stays removed, and restore brings it back.
var ErrExtensionChecksumUnverified = errors.New("extension: checksum is unverified")
var ErrExtensionGatewayConfirmationRequired = errors.New("extension: gateway permissions confirmation required")
ErrExtensionGatewayConfirmationRequired reports stale consent; GatewayConfirmationRequiredError carries its digest.
var ErrExtensionInputInvalid = errors.New("extension: invalid input")
var ErrExtensionInputsRequired = errors.New("extension: inputs required")
var ErrExtensionNameConflict = errors.New("extension: instance name belongs to another origin")
ErrExtensionNameConflict means an installed name belongs to another acquisition origin.
var ErrExtensionNotBuiltin = errors.New("extension: extension is not a built-in extension")
ErrExtensionNotBuiltin reports that permanent removal targeted a row that is not bundled.
var ErrExtensionRemovalCompensationFailed = errors.New("extension: removal could not be fully compensated")
ErrExtensionRemovalCompensationFailed reports that a removal failed after its row delete and the compensation that should restore the row also failed. The registry may differ from its pre-removal state.
var ErrExtensionRestoreFailed = errors.New("extension: restore built-in extension failed")
ErrExtensionRestoreFailed reports that restoring a built-in failed. Unless a partially enrolled row cannot be removed, the tombstone is written back before this error is returned, so the built-in stays removed.
var ErrExtensionSearchInvalid = errors.New("extension: invalid search request")
ErrExtensionSearchInvalid reports a malformed source or cursor selection.
var ErrExtensionSourceChanged = errors.New("extension: source changed since it was listed")
ErrMarketplaceSourceUnavailable reports that a marketplace source cannot be resolved or used.
Functions ¶
func AgentPluginDiagnostics ¶
func AgentPluginDiagnostics(name string, values []agentplugin.Diagnostic) []diagnosticcontract.DiagnosticItem
AgentPluginDiagnostics converts portable component skips into canonical recorded diagnostics.
func BindHostAPIWorkspaceParams ¶
func BindHostAPIWorkspaceParams( ctx context.Context, raw json.RawMessage, binding HostAPIWorkspaceBinding, workspaceID string, workspaceRoot string, workspaces workspacepkg.RuntimeResolver, ) (json.RawMessage, error)
BindHostAPIWorkspaceParams canonicalizes Host API workspace fields against a bound workspace.
func CheckExpectedDigest ¶
CheckExpectedDigest compares the approved digest before any managed state mutation.
func ComputeDirectoryChecksum ¶
ComputeDirectoryChecksum returns a deterministic SHA-256 checksum for an installed extension directory payload.
func ContentsFor ¶
func ContentsFor(manifest *Manifest, kit []KitItem) contract.ExtensionContentsPayload
ContentsFor counts loaded resources, not the directories that contain them.
func DescribeExtension ¶
DescribeExtension projects one extension snapshot into the shared CLI/API payload.
func DescribeExtensionForProfile ¶
func DescribeExtensionForProfile( ext *Extension, daemonRunning bool, now time.Time, profileName string, ) contract.ExtensionPayload
DescribeExtensionForProfile projects package metadata through the selected profile placement.
func DescribeInputState ¶
func DescribeInputState( manifest *Manifest, state InputState, getenv func(string) string, ) []contract.ExtensionInputStatePayload
DescribeInputState exposes configuration presence and activity without values or secret references.
func ForgeProviderErrorCause ¶
func GatewayRequirementDigest ¶
func GatewayRequirementDigest(req *GatewayRequirement) (string, error)
GatewayRequirementDigest binds operator consent to the exact declared gateway permissions.
func InspectMarketplacePackage ¶
func InspectMarketplacePackage( ctx context.Context, homePaths compozyconfig.HomePaths, req MarketplaceInstallRequest, profileName string, ) (_ contract.MarketplaceExtensionDetailPayload, resultErr error)
InspectMarketplacePackage reads pinned artifact bytes without install consent, execution, or registry writes. It shares download, digest verification, extraction and manifest loading with installation, but cannot commit.
func InspectPackageContents ¶
func InspectPackageContents( ctx context.Context, ext *Extension, profileName string, ) (contract.ExtensionContentsPayload, error)
InspectPackageContents reads declared files without starting the extension runtime.
func InspectPluginPackage ¶
func InspectPluginPackage(ctx context.Context, root string, name string) (marketplace.PluginInspection, error)
InspectPluginPackage uses the install manifest and resource loaders without publishing or starting resources.
func InstallBundledExtension ¶
func InstallBundledExtension( homePaths compozyconfig.HomePaths, registry *Registry, spec BundledInstallSpec, ) (err error)
InstallBundledExtension enrolls or refreshes a first-party managed extension without replacing an operator-owned extension with the same name. A permanently removed (tombstoned) name is skipped before anything is staged, and the tombstone is left in place.
func InstallLocalManaged ¶
func InstallLocalManaged( homePaths compozyconfig.HomePaths, registry LifecycleRegistry, manifest *Manifest, sourceDir string, checksum string, opts ...InstallOption, ) (err error)
InstallLocalManaged copies one local extension into the managed install root and persists the registry record there. With WithInstallReplaceExisting an installed extension is replaced through the same transaction published sources use: the previous directory and registry record survive until every post-commit step succeeds.
func InstalledExtensionDir ¶
func InstalledExtensionDir(info *ExtensionInfo) (string, error)
InstalledExtensionDir returns the root directory for a persisted extension registry row after validating the manifest path shape.
func LoadAutomationResources ¶
func LoadAutomationResources( rootDir string, extensionName string, paths []string, ) ([]automationpkg.Job, []automationpkg.Trigger, error)
LoadAutomationResources loads and validates extension automation TOML resources.
func LoadLayoutResources ¶
func LoadLayoutResources( ctx context.Context, rootDir string, paths []string, ) ([]windowmanager.LayoutResource, error)
LoadLayoutResources loads globally-scoped extension window layouts.
func LoadMarketplaceSources ¶
func LoadMarketplaceSources( ctx context.Context, loader MarketplaceSourceLoader, sourceFilter string, ) ([]registrypkg.Source, error)
LoadMarketplaceSources resolves marketplace sources and closes rejected sources.
func MCPServerLaunchSummary ¶
MCPServerLaunchSummary excludes arguments, userinfo, paths and query values that may contain secrets.
func ManagedInstallPath ¶
func ManagedInstallPath(homePaths compozyconfig.HomePaths, name string) string
ManagedInstallPath returns the Compozy-managed directory for one installed extension.
func ManagedInstallPathChecked ¶
func ManagedInstallPathChecked(homePaths compozyconfig.HomePaths, name string) (string, error)
ManagedInstallPathChecked returns the contained managed directory for one installed extension.
func ManagedInstallRoot ¶
func ManagedInstallRoot(homePaths compozyconfig.HomePaths) string
ManagedInstallRoot returns the Compozy-managed root directory for installed extensions.
func MarketplaceEntryTrustReport ¶
func MarketplaceEntryTrustReport( evidence MarketplaceTrustEvidence, policyAllowsUnverified bool, ) (contract.ExtensionTrustReportPayload, error)
MarketplaceEntryTrustReport projects feed evidence and live policy before acquisition.
func MaterializeBundledExtension ¶
func MaterializeBundledExtension( homePaths compozyconfig.HomePaths, name string, embedded fs.FS, ) (string, error)
MaterializeBundledExtension copies one embedded extension into a managed staging directory.
func NewExtensionModelSources ¶
func NewExtensionModelSources(registry *Registry, resolver ModelSourceRuntimeResolver) ([]modelcatalog.Source, error)
NewExtensionModelSources creates sources for installed extensions that provide model.source.
func NewManagedInstallStagingDir ¶
func NewManagedInstallStagingDir(homePaths compozyconfig.HomePaths) (string, error)
NewManagedInstallStagingDir creates an empty staging directory under the managed extension root.
func NormalizeInputJSON ¶
func NormalizeInputJSON(inputType string, raw json.RawMessage) (json.RawMessage, error)
NormalizeInputJSON validates a supplied value and keeps booleans as JSON booleans.
func PackageRootFromManifest ¶
PackageRootFromManifest returns the artifact root for native and client manifests.
func ReconcileManagedExtensionArtifacts ¶
func ReconcileManagedExtensionArtifacts( homePaths compozyconfig.HomePaths, registry managedInstallReconcileRegistry, ) error
ReconcileManagedExtensionArtifacts restores the managed install tree to the state committed in the registry before extension traffic starts.
func ReconcileManifestToolRuntime ¶
func ReconcileManifestToolRuntime( manifest *ManifestToolDescriptor, runtime *toolspkg.ExtensionToolRuntimeDescriptor, state ExtensionToolRuntimeState, ) toolspkg.Availability
ReconcileManifestToolRuntime reports whether a manifest-authoritative extension tool is executable.
func RemoveManagedInstall ¶
func RemoveManagedInstall(homePaths compozyconfig.HomePaths, name string) error
RemoveManagedInstall removes one extension directory after proving its resolved path stays beneath the managed install root.
func RequireBuiltinForPermanentRemoval ¶
func RequireBuiltinForPermanentRemoval(info *ExtensionInfo) error
RequireBuiltinForPermanentRemoval refuses any row whose source is not bundled.
func ResolveManifestToolResources ¶
ResolveManifestToolResources converts manifest tool declarations into tool specs.
func ResourcePaths ¶
func ResourcePaths(resources []ManifestResourcePath) []string
ResourcePaths projects typed manifest resource declarations for loaders that only consume package-relative paths.
func SupersededBundledSuccessor ¶
SupersededBundledSuccessor names retired packages for retained-state diagnostics only.
func ValidateBundle ¶
func ValidateBundle(dir string) (*Manifest, []ValidationIssue, error)
ValidateBundle validates a built or resource-only extension archive without executing extension code.
func ValidateDaemonCompatibility ¶
ValidateDaemonCompatibility checks the minimum version against the running build.
func ValidateExpectedDigest ¶
ValidateExpectedDigest accepts an omitted pin, otherwise requires a full SHA-256 digest.
func ValidateManifestForCompozyVersion ¶
ValidateManifestForCompozyVersion checks a manifest against an explicitly stamped daemon version.
func ValidateManifestInputs ¶
ValidateManifestInputs checks grammar and resolves every binding to declared servers.
Types ¶
type ActiveExtension ¶
type ActiveExtension struct {
Published *ExtensionInfo
DevLink *DevLink
OverridesPublished bool
}
ActiveExtension is the registry resolution result for one instance key.
type AgentConflictError ¶
type AgentConflictError struct {
Agents []string
}
AgentConflictError names every colliding agent in stable order.
func (*AgentConflictError) Error ¶
func (e *AgentConflictError) Error() string
func (*AgentConflictError) Unwrap ¶
func (e *AgentConflictError) Unwrap() error
type AgentPluginManifestValidationError ¶
type AgentPluginManifestValidationError struct {
Path string
Issues []agentplugin.Issue
}
AgentPluginManifestValidationError preserves every fatal portable manifest issue.
func (*AgentPluginManifestValidationError) Error ¶
func (e *AgentPluginManifestValidationError) Error() string
func (*AgentPluginManifestValidationError) Unwrap ¶
func (e *AgentPluginManifestValidationError) Unwrap() error
type AgentPluginNotManifestError ¶
AgentPluginNotManifestError identifies an unrelated root plugin.json.
func (*AgentPluginNotManifestError) Error ¶
func (e *AgentPluginNotManifestError) Error() string
func (*AgentPluginNotManifestError) Unwrap ¶
func (e *AgentPluginNotManifestError) Unwrap() error
type AgentSidecar ¶
AgentSidecar is one validated authored-context file shipped beside an agent.
type BuildRequest ¶
type BuildRequest struct {
SourceDir string
OutputDir string
BuildCmd []string
Timeout time.Duration
}
BuildRequest configures one daemon-free extension package build.
type BuildResult ¶
type BuildResult struct {
GenerationDir string `json:"generation_dir"`
GenerationHash string `json:"generation_hash"`
ManifestPath string `json:"manifest_path"`
Manifest *Manifest `json:"manifest"`
}
BuildResult identifies one immutable, fully validated extension package generation.
func BuildBundle ¶
func BuildBundle(ctx context.Context, req BuildRequest) (*BuildResult, error)
BuildBundle builds source, runs SDK describe mode, and publishes an immutable generation.
func PrepareDevelopmentGeneration ¶
func PrepareDevelopmentGeneration(ctx context.Context, sourceDir string) (*BuildResult, error)
PrepareDevelopmentGeneration validates portable source or builds a native bundle.
type BuiltinTombstone ¶
BuiltinTombstone records one permanently removed bundled extension name.
type BuiltinTombstones ¶
type BuiltinTombstones interface {
// Tombstone records name as permanently removed and returns the stored record.
Tombstone(ctx context.Context, name string, removedBy string) (BuiltinTombstone, error)
// Clear removes the tombstone and reports whether one existed.
Clear(ctx context.Context, name string) (bool, error)
// Tombstoned reports whether bundled enrollment must be skipped for the name.
Tombstoned(ctx context.Context, name string) (bool, error)
// ListTombstones returns all tombstones in name order.
ListTombstones(ctx context.Context) ([]BuiltinTombstone, error)
}
BuiltinTombstones is the durable store of permanently removed bundled names. The Registry implements it. A tombstone gates only bundled enrollment: it never changes a non-bundled row that happens to share the name. The interface is the package contract from the spec's Core Interfaces. Production removal and restore use the transactional and restore writers directly, so Tombstone and Tombstoned are consumed by contract tests and by future callers; they stay on the interface on purpose.
type BundledInstallSpec ¶
BundledInstallSpec identifies one first-party extension embedded in the Compozy binary.
type CapabilitiesConfig ¶
type CapabilitiesConfig struct {
Provides []string `toml:"provides,omitempty" json:"provides,omitempty"`
}
CapabilitiesConfig declares the runtime interfaces the extension provides.
type CapabilityChecker ¶
type CapabilityChecker struct {
// contains filtered or unexported fields
}
CapabilityChecker tracks effective grants per extension and evaluates capability checks for hook dispatch and Host API calls.
func (*CapabilityChecker) Check ¶
func (c *CapabilityChecker) Check(extName, capability string) error
Check reports whether extName has the requested security capability.
func (*CapabilityChecker) CheckHostAPI ¶
func (c *CapabilityChecker) CheckHostAPI(extName, method string) error
CheckHostAPI reports whether extName may call the Host API method.
func (*CapabilityChecker) Grant ¶
func (c *CapabilityChecker) Grant(extName string) EffectiveGrant
Grant returns the stored effective grant snapshot for one extension.
func (*CapabilityChecker) Register ¶
func (c *CapabilityChecker) Register(extName string, source ExtensionSource, manifest *Manifest)
Register records one extension's effective grants by applying the source-tier ceiling before intersecting it with the manifest requests.
func (*CapabilityChecker) RegisterForSession ¶
func (c *CapabilityChecker) RegisterForSession( extName string, source ExtensionSource, manifest *Manifest, sessionMaxScope resources.ResourceScopeKind, ) (EffectiveGrant, error)
RegisterForSession records one extension's effective grants for the supplied session scope ceiling.
func (*CapabilityChecker) Resolve ¶
func (c *CapabilityChecker) Resolve( source ExtensionSource, manifest *Manifest, sessionMaxScope resources.ResourceScopeKind, ) (EffectiveGrant, error)
Resolve computes one daemon-derived grant snapshot without storing it.
func (*CapabilityChecker) SetResourcePolicy ¶
func (c *CapabilityChecker) SetResourcePolicy(policy compozyconfig.ExtensionsResourcesConfig)
SetResourcePolicy installs the operator-configured extension resource policy.
func (*CapabilityChecker) Unregister ¶
func (c *CapabilityChecker) Unregister(extName string)
Unregister removes any effective grants tracked for one extension.
type CapabilityDeniedData ¶
type CapabilityDeniedData struct {
Method string `json:"method"`
Required []string `json:"required"`
Granted []string `json:"granted"`
}
CapabilityDeniedData is the structured data for capability-denied failures.
type CmdPaletteAction ¶
type CmdPaletteAction = extensioncontract.CmdPaletteAction
type CmdPaletteArgument ¶
type CmdPaletteArgument = extensioncontract.CmdPaletteArgument
type CmdPaletteCommand ¶
type CmdPaletteCommand = extensioncontract.CmdPaletteCommand
type CmdPaletteConfig ¶
type CmdPaletteConfig = extensioncontract.CmdPaletteConfig
type CmdPaletteConfirmation ¶
type CmdPaletteConfirmation = extensioncontract.CmdPaletteConfirmation
type CmdPaletteDefaultShortcut ¶
type CmdPaletteDefaultShortcut struct {
CommandID string
Chord string
Extension string
Active bool
}
CmdPaletteDefaultShortcut is one extension default in deterministic enable order.
type CmdPaletteExecutionPolicy ¶
type CmdPaletteExecutionPolicy = extensioncontract.CmdPaletteExecutionPolicy
type CmdPaletteProjectedCommand ¶
type CmdPaletteProjectedCommand struct {
ID string
Title string
Section string
Icon string
Keywords []string
Arguments []CmdPaletteArgument
Action CmdPaletteAction
Destructive bool
Confirmation *CmdPaletteConfirmation
Execution CmdPaletteResolvedExecutionPolicy
Extension string
}
CmdPaletteProjectedCommand is a validated, namespaced extension command.
type CmdPaletteProjectedView ¶
type CmdPaletteProjectedView struct {
ID string
Title string
Kind string
SourceTool string
Program bool
Extension string
}
CmdPaletteProjectedView is a validated, namespaced extension view.
type CmdPaletteProjection ¶
type CmdPaletteProjection struct {
Commands []CmdPaletteProjectedCommand
Views []CmdPaletteProjectedView
Defaults []CmdPaletteDefaultShortcut
Sources []CmdPaletteSourceStatus
}
CmdPaletteProjection is the complete storage-free palette snapshot for one workspace.
type CmdPaletteResolvedExecutionPolicy ¶
CmdPaletteResolvedExecutionPolicy is the effective policy after action defaults.
type CmdPaletteSourceStatus ¶
CmdPaletteSourceStatus keeps source membership separate from runtime health.
type CmdPaletteView ¶
type CmdPaletteView = extensioncontract.CmdPaletteView
type CmdPaletteViewSource ¶
type CmdPaletteViewSource = extensioncontract.CmdPaletteViewSource
type CommandDescriptor ¶
type CommandDescriptor struct {
Extension string `json:"extension"`
Verb string `json:"verb"`
ToolID string `json:"tool_id"`
Summary string `json:"summary"`
Example string `json:"example,omitempty"`
Flags []extensioncontract.CommandFlag `json:"flags"`
RiskClass toolspkg.RiskClass `json:"risk_class"`
ApprovalRequired bool `json:"approval_required"`
}
CommandDescriptor is one executable command leaf projected from an active extension tool.
type CommandGroupDescriptor ¶
type CommandGroupDescriptor struct {
Extension string `json:"extension"`
Path string `json:"path"`
Summary string `json:"summary"`
}
CommandGroupDescriptor associates one presentation-only group with its extension.
type ConnectivityProviderTrustResolver ¶
type ConnectivityProviderTrustResolver struct {
// contains filtered or unexported fields
}
ConnectivityProviderTrustResolver derives provider authority from the live global registry.
func NewConnectivityProviderTrustResolver ¶
func NewConnectivityProviderTrustResolver(registry *Registry) (*ConnectivityProviderTrustResolver, error)
NewConnectivityProviderTrustResolver constructs the gateway-facing live trust adapter.
func (*ConnectivityProviderTrustResolver) ResolveProviderTrust ¶
func (r *ConnectivityProviderTrustResolver) ResolveProviderTrust( ctx context.Context, name string, ) (gateway.ProviderTrust, error)
ResolveProviderTrust reloads the installed artifact digest on every call.
type ConsentArea ¶
type ConsentArea = extensioncontract.ConsentArea
ConsentArea is one operator-facing permission summary derived from Host API methods.
func DeriveConsentAreas ¶
func DeriveConsentAreas(methods []string) ([]ConsentArea, error)
DeriveConsentAreas derives a deterministic consent summary from the closed permission set.
type DeclaredProfileApplyResult ¶
type DeclaredProfileApplyResult struct {
Profile profilepkg.Profile `json:"profile"`
Created bool `json:"created"`
Bound bool `json:"bound"`
}
DeclaredProfileApplyResult records the mutation outcome without implying that a previously bound or marker-gated profile was created again.
func ApplyDeclaredProfiles ¶
func ApplyDeclaredProfiles( ctx context.Context, manager declaredProfileManager, manifest *Manifest, ) ([]DeclaredProfileApplyResult, error)
type DeclaredProfilePlan ¶
type DeclaredProfilePlan struct {
Extension string `json:"extension"`
Profiles []DeclaredProfilePlanEntry `json:"profiles"`
}
DeclaredProfilePlan is the install/update summary presented before mutation.
func BuildDeclaredProfilePlan ¶
func BuildDeclaredProfilePlan( ctx context.Context, manager declaredProfileManager, manifest *Manifest, ) (DeclaredProfilePlan, error)
type DeclaredProfilePlanEntry ¶
type DeclaredProfilePlanEntry struct {
Name string `json:"name"`
Create bool `json:"create"`
NeedsSetup []ManifestProfileCredential `json:"needs_setup,omitempty"`
}
DeclaredProfilePlanEntry describes one declaration's bind/create outcome.
type DevLink ¶
type DevLink struct {
ExtensionName string
WorkspaceID string
OriginPath string
BundleGeneration string
LinkedAt time.Time
GatewayRequirementDigest string
Format ExtensionFormat
IngestDiagnostics []diagnosticcontract.DiagnosticItem
GatewayConfirmedBy string
GatewayConfirmedAt time.Time
}
DevLink is one workspace-local overlay row.
type DevLinkRequest ¶
type DevLinkRequest struct {
Name string
WorkspaceID string
OriginPath string
GenerationHash string
GatewayRequirementDigest string
Format ExtensionFormat
IngestDiagnostics []diagnosticcontract.DiagnosticItem
}
DevLinkRequest identifies one immutable workspace-local extension generation.
type DevelopmentGeneration ¶
type DevelopmentGeneration struct {
Name string
OriginPath string
GenerationHash string
GatewayRequirementDigest string
Format ExtensionFormat
IngestDiagnostics []diagnosticcontract.DiagnosticItem
}
DevelopmentGeneration is the verified, mutation-free identity of one dev artifact.
type Duration ¶
Duration stores time.Duration values while decoding TOML strings and JSON strings consistently.
func (Duration) MarshalJSON ¶
MarshalJSON emits the duration as a quoted duration string.
func (Duration) MarshalText ¶
MarshalText emits the duration as text.
func (*Duration) UnmarshalJSON ¶
UnmarshalJSON accepts duration strings and integer nanoseconds.
func (*Duration) UnmarshalText ¶
UnmarshalText parses duration strings like "30s".
type EffectiveGrant ¶
type EffectiveGrant struct {
Permissions []string
Security []string
ResourceKinds []resources.ResourceKind
ResourceScopes []resources.ResourceScopeKind
}
EffectiveGrant is the daemon-derived grant snapshot for one extension session.
type EnvBinding ¶
type EnvBinding = extensionenv.Binding
EnvBinding is one instance-scoped extension environment binding.
type EnvBindingLifecycleStore ¶
type EnvBindingLifecycleStore = extensionenv.LifecycleStore
EnvBindingLifecycleStore supports cleanup and safe owned-ref garbage collection.
type EnvBindingStore ¶
type EnvBindingStore = extensionenv.Store
EnvBindingStore persists instance-scoped extension environment bindings.
type EnvBindingValidationError ¶
EnvBindingValidationError carries safe, deterministic binding diagnostics.
func (*EnvBindingValidationError) Error ¶
func (e *EnvBindingValidationError) Error() string
func (*EnvBindingValidationError) Unwrap ¶
func (e *EnvBindingValidationError) Unwrap() error
Unwrap exposes the stable validation class.
type ErrCapabilityDenied ¶
type ErrCapabilityDenied struct {
Data CapabilityDeniedData
}
ErrCapabilityDenied reports that an extension attempted a method or capability outside its effective grants.
func (*ErrCapabilityDenied) Code ¶
func (e *ErrCapabilityDenied) Code() int
Code returns the protocol-equivalent error code for capability denials.
func (*ErrCapabilityDenied) Error ¶
func (e *ErrCapabilityDenied) Error() string
Error returns the protocol-aligned capability denied message.
type Extension ¶
type Extension struct {
Info ExtensionInfo
Manifest *Manifest
RootDir string
Hooks []hookspkg.HookDecl
Agents []compozyconfig.AgentDef
StaticAgents []StaticAgent
Skills []*skillspkg.Skill
Loops []looppkg.ResourceSpec
AutomationJobs []automationpkg.Job
AutomationTriggers []automationpkg.Trigger
Layouts []windowmanager.LayoutResource
GrantedPermissions []string
GrantedSecurity []string
GrantedResourceKinds []resources.ResourceKind
GrantedResourceScopes []resources.ResourceScopeKind
InitializeResult *subprocess.InitializeResponse
Status ExtensionStatus
DevLink *DevLink
OverridesPublished bool
}
Extension is the manager-visible snapshot for one installed extension.
type ExtensionArchiveDigestMismatchError ¶
type ExtensionArchiveDigestMismatchError struct {
EntryID string
Version string
Cause error
Item diagnosticcontract.DiagnosticItem
}
func (*ExtensionArchiveDigestMismatchError) DiagnosticItem ¶
func (e *ExtensionArchiveDigestMismatchError) DiagnosticItem() diagnosticcontract.DiagnosticItem
func (*ExtensionArchiveDigestMismatchError) Error ¶
func (e *ExtensionArchiveDigestMismatchError) Error() string
func (*ExtensionArchiveDigestMismatchError) Is ¶
func (e *ExtensionArchiveDigestMismatchError) Is(target error) bool
func (*ExtensionArchiveDigestMismatchError) Unwrap ¶
func (e *ExtensionArchiveDigestMismatchError) Unwrap() error
type ExtensionChecksumMismatchError ¶
ExtensionChecksumMismatchError describes a checksum verification failure.
func (*ExtensionChecksumMismatchError) Error ¶
func (e *ExtensionChecksumMismatchError) Error() string
Error returns the typed checksum mismatch message.
func (*ExtensionChecksumMismatchError) Is ¶
func (e *ExtensionChecksumMismatchError) Is(target error) bool
Is matches sentinel errors for errors.Is.
type ExtensionExistsError ¶
type ExtensionExistsError struct {
Name string
}
ExtensionExistsError describes a duplicate extension install attempt.
func (*ExtensionExistsError) Error ¶
func (e *ExtensionExistsError) Error() string
Error returns the typed duplicate-extension message.
func (*ExtensionExistsError) Is ¶
func (e *ExtensionExistsError) Is(target error) bool
Is matches sentinel errors for errors.Is.
type ExtensionFormat ¶
type ExtensionFormat string
ExtensionFormat identifies the manifest format that owns an extension instance.
const ( FormatCompozy ExtensionFormat = "compozy" FormatAgentPlugin ExtensionFormat = "agent-plugin" )
type ExtensionInfo ¶
type ExtensionInfo struct {
Name string
Version string
Source ExtensionSource
// Enabled is true when at least one active profile has no disabled exception
// for this extension; it is an effective runtime projection, not a global flag.
Enabled bool
ManifestPath string
Format ExtensionFormat
IngestDiagnostics []diagnosticcontract.DiagnosticItem
InstalledAt time.Time
Capabilities CapabilitiesConfig
Permissions PermissionsConfig
Checksum string
RegistrySlug *string
RegistryName *string
RemoteVersion *string
Provenance ExtensionProvenance
GatewayRequirementDigest string
GatewayConfirmedBy string
GatewayConfirmedAt time.Time
// contains filtered or unexported fields
}
ExtensionInfo is one persisted extension registry row.
func InstallMarketplaceManaged ¶
func InstallMarketplaceManaged( ctx context.Context, homePaths compozyconfig.HomePaths, registry LifecycleRegistry, loader MarketplaceSourceLoader, req MarketplaceInstallRequest, ) (_ *ExtensionInfo, err error)
InstallMarketplaceManaged installs one extension through the configured marketplace registry into the managed extension root and records marketplace provenance in the installed-extension registry.
func SelectMarketplaceUpdateTargets ¶
func SelectMarketplaceUpdateTargets( registry LifecycleRegistry, names []string, updateAll bool, ) ([]ExtensionInfo, error)
SelectMarketplaceUpdateTargets resolves the complete managed update selection before acquisition.
type ExtensionJob ¶
type ExtensionJob struct {
Name string `toml:"name"`
Agent string `toml:"agent"`
Prompt string `toml:"prompt"`
Schedule automationpkg.ScheduleSpec `toml:"schedule"`
Task *automationpkg.JobTaskConfig `toml:"task,omitempty"`
Enabled *bool `toml:"enabled,omitempty"`
Retry automationpkg.RetryConfig `toml:"retry,omitempty"`
FireLimit automationpkg.FireLimitConfig `toml:"fire_limit,omitempty"`
}
ExtensionJob is one package-authored scheduled automation definition.
type ExtensionLogCursor ¶
ExtensionLogCursor identifies one position within one in-memory log ring.
type ExtensionLogEntry ¶
type ExtensionLogEntry struct {
Sequence int64 `json:"sequence"`
Timestamp time.Time `json:"timestamp"`
Message string `json:"message"`
GenerationHash string `json:"generation_hash,omitempty"`
StreamEpoch string `json:"stream_epoch"`
}
ExtensionLogEntry is one redacted stderr record retained for an instance.
type ExtensionLogRing ¶
type ExtensionLogRing struct {
// contains filtered or unexported fields
}
ExtensionLogRing is a bounded, concurrency-safe, drop-oldest byte ring.
type ExtensionLogSnapshot ¶
type ExtensionLogSnapshot struct {
Entries []ExtensionLogEntry
StreamEpoch string
}
ExtensionLogSnapshot is one complete or cursor-filtered view of a log ring.
type ExtensionNameConflictError ¶
type ExtensionNameConflictError struct {
Name string
InstalledOrigin marketplacepkg.Origin
SourceName string
}
ExtensionNameConflictError identifies the installed acquisition without exposing credentials.
func (*ExtensionNameConflictError) Error ¶
func (e *ExtensionNameConflictError) Error() string
func (*ExtensionNameConflictError) Unwrap ¶
func (e *ExtensionNameConflictError) Unwrap() error
type ExtensionNotBuiltinError ¶
ExtensionNotBuiltinError names the source of a row that permanent removal refused.
func (*ExtensionNotBuiltinError) Error ¶
func (e *ExtensionNotBuiltinError) Error() string
Error describes the refused source without changing any state.
func (*ExtensionNotBuiltinError) Is ¶
func (e *ExtensionNotBuiltinError) Is(target error) bool
Is matches ErrExtensionNotBuiltin.
type ExtensionNotFoundError ¶
type ExtensionNotFoundError struct {
Name string
}
ExtensionNotFoundError describes a missing extension registry row.
func (*ExtensionNotFoundError) Error ¶
func (e *ExtensionNotFoundError) Error() string
Error returns the typed missing-extension message.
func (*ExtensionNotFoundError) Is ¶
func (e *ExtensionNotFoundError) Is(target error) bool
Is matches sentinel errors for errors.Is.
type ExtensionPhase ¶
type ExtensionPhase string
ExtensionPhase names one lifecycle phase or supervisor state for an extension.
const ( ExtensionPhaseDiscover ExtensionPhase = "discover" ExtensionPhaseParse ExtensionPhase = "parse" ExtensionPhaseValidate ExtensionPhase = "validate" ExtensionPhaseRegister ExtensionPhase = "register" ExtensionPhaseInitialize ExtensionPhase = "initialize" ExtensionPhaseActivate ExtensionPhase = "activate" ExtensionPhaseRecover ExtensionPhase = "recover" ExtensionPhaseStop ExtensionPhase = "stop" )
type ExtensionPolicyBlockedError ¶
type ExtensionPolicyBlockedError struct {
Slug string
Item diagnosticcontract.DiagnosticItem
}
func (*ExtensionPolicyBlockedError) DiagnosticItem ¶
func (e *ExtensionPolicyBlockedError) DiagnosticItem() diagnosticcontract.DiagnosticItem
func (*ExtensionPolicyBlockedError) Error ¶
func (e *ExtensionPolicyBlockedError) Error() string
func (*ExtensionPolicyBlockedError) Unwrap ¶
func (e *ExtensionPolicyBlockedError) Unwrap() error
type ExtensionProvenance ¶
type ExtensionProvenance struct {
SourceName string `json:"source_name,omitempty"`
SourceRef string `json:"source_ref,omitempty"`
EntryID string `json:"entry_id,omitempty"`
ResolvedRef string `json:"resolved_ref,omitempty"`
Layout string `json:"layout,omitempty"`
Slug string `json:"slug,omitempty"`
CatalogEntryID string `json:"catalog_entry_id,omitempty"`
InstalledFrom string `json:"installed_from"`
SourceURL string `json:"source_url,omitempty"`
ChecksumSHA256 string `json:"checksum_sha256"`
ArchiveDigestSHA256 string `json:"archive_digest_sha256,omitempty"`
DigestMatched bool `json:"digest_matched"`
ChecksumVerified bool `json:"checksum_verified"`
RegistryTier string `json:"registry_tier"`
Permissions []string `json:"permissions,omitempty"`
InstalledAt time.Time `json:"installed_at"`
InstalledBy string `json:"installed_by"`
AllowUnverified bool `json:"allow_unverified"`
Warnings []contract.DiagnosticItem `json:"warnings,omitempty"`
}
ExtensionProvenance records one installed extension's source and trust state.
func LocalPathProvenance ¶
func LocalPathProvenance( manifest *Manifest, sourcePath string, checksum string, installedAt time.Time, allowUnverified bool, ) ExtensionProvenance
LocalPathProvenance records an explicit trust decision for a local install.
type ExtensionSource ¶
type ExtensionSource int
ExtensionSource identifies where an extension was installed from.
const ( // SourceBundled identifies built-in extensions shipped with the daemon. SourceBundled ExtensionSource = iota // SourceUser identifies user-installed extensions trusted by the operator. SourceUser // SourceWorkspace identifies workspace-scoped extensions trusted by the project. SourceWorkspace // SourceMarketplace identifies marketplace-installed extensions subject to // restricted default grants until an explicit allowlist exists. SourceMarketplace )
func (ExtensionSource) String ¶
func (s ExtensionSource) String() string
String returns the persisted text form for one extension source tier.
type ExtensionStatus ¶
type ExtensionStatus struct {
Name string
WorkspaceID string
Version string
Source ExtensionSource
Enabled bool
MissingEnv []string
MissingEnvChecked bool
Registered bool
Active bool
Phase ExtensionPhase
PID int
Healthy bool
HealthMessage string
HealthLastCheckedAt time.Time
ConsecutiveFailures int
RestartBackoff time.Duration
LastError string
FailureCode string
GenerationHash string
LastGoodGeneration string
LastStartedAt time.Time
LastExitedAt time.Time
}
ExtensionStatus captures the runtime state exposed to health/observer code.
type ExtensionToolCallTracker ¶
type ExtensionToolCallTracker interface {
BeginExtensionToolCall(
ctx context.Context,
extensionName string,
sessionID string,
) (string, func(), error)
}
ExtensionToolCallTracker binds reverse Host API calls to one active tool invocation.
type ExtensionToolProvider ¶
type ExtensionToolProvider struct {
// contains filtered or unexported fields
}
ExtensionToolProvider lists manifest-authored extension tools and resolves executable handles through the live subprocess runtime.
func NewExtensionToolProvider ¶
func NewExtensionToolProvider( registry *Registry, runtime ExtensionToolRuntimeResolver, opts ...ExtensionToolProviderOption, ) (*ExtensionToolProvider, error)
NewExtensionToolProvider creates the extension_host provider for the central tool registry.
func (*ExtensionToolProvider) ID ¶
func (p *ExtensionToolProvider) ID() toolspkg.SourceRef
ID returns the aggregate extension-provider provenance.
func (*ExtensionToolProvider) List ¶
func (p *ExtensionToolProvider) List(ctx context.Context, scope toolspkg.Scope) ([]toolspkg.Descriptor, error)
List returns manifest-authoritative extension-host tool descriptors.
func (*ExtensionToolProvider) ProjectionAvailability ¶
func (p *ExtensionToolProvider) ProjectionAvailability( ctx context.Context, scope toolspkg.Scope, ids []toolspkg.ToolID, ) map[toolspkg.ToolID]toolspkg.Availability
ProjectionAvailability shares live observations only within one projection request.
func (*ExtensionToolProvider) ProjectionGeneration ¶
func (p *ExtensionToolProvider) ProjectionGeneration( ctx context.Context, scope toolspkg.Scope, ) (string, bool)
ProjectionGeneration reports manifest and live runtime state used by tool projection.
func (*ExtensionToolProvider) ProjectionScope ¶
func (p *ExtensionToolProvider) ProjectionScope(scope toolspkg.Scope) toolspkg.Scope
ProjectionScope retains the installation boundaries used by listing and runtime availability.
func (*ExtensionToolProvider) Resolve ¶
func (p *ExtensionToolProvider) Resolve( ctx context.Context, scope toolspkg.Scope, id toolspkg.ToolID, ) (toolspkg.Handle, bool, error)
Resolve returns a handle that reconciles one manifest descriptor against the live extension runtime before allowing execution.
type ExtensionToolProviderOption ¶
type ExtensionToolProviderOption func(*ExtensionToolProvider)
ExtensionToolProviderOption configures an extension-host tool provider.
func WithToolProviderLogger ¶
func WithToolProviderLogger(logger *slog.Logger) ExtensionToolProviderOption
WithToolProviderLogger injects the logger used when one invalid extension is isolated from the aggregate tool catalog.
func WithToolProviderProfileNameResolver ¶
func WithToolProviderProfileNameResolver(resolver ProfileNameResolver) ExtensionToolProviderOption
WithToolProviderProfileNameResolver binds profile-named manifest placements to the stable profile identity carried by tool scopes.
type ExtensionToolRuntime ¶
type ExtensionToolRuntime interface {
Get(name string) (*Extension, error)
toolspkg.ExtensionToolInvoker
}
ExtensionToolRuntime is the live runtime surface needed by extension-host tool handles.
type ExtensionToolRuntimeResolver ¶
type ExtensionToolRuntimeResolver func() ExtensionToolRuntime
ExtensionToolRuntimeResolver returns the current live extension runtime.
type ExtensionToolRuntimeState ¶
type ExtensionToolRuntimeState struct {
Enabled bool
Active bool
Healthy bool
ProvidedCapabilities []string
}
ExtensionToolRuntimeState captures extension lifecycle state needed for manifest/runtime reconciliation.
type ExtensionTrigger ¶
type ExtensionTrigger struct {
Name string `toml:"name"`
Agent string `toml:"agent"`
Prompt string `toml:"prompt"`
Event string `toml:"event"`
Filter map[string]string `toml:"filter,omitempty"`
Enabled *bool `toml:"enabled,omitempty"`
Retry automationpkg.RetryConfig `toml:"retry,omitempty"`
FireLimit automationpkg.FireLimitConfig `toml:"fire_limit,omitempty"`
EndpointSlug string `toml:"endpoint_slug,omitempty"`
}
ExtensionTrigger is one package-authored event automation definition.
type ExtensionTrustError ¶
type ExtensionTrustError struct {
Slug string
Source string
Item contract.DiagnosticItem
}
ExtensionTrustError carries the canonical diagnostic for a denied extension trust decision.
func NewExtensionChecksumUnverifiedError ¶
func NewExtensionChecksumUnverifiedError(slug string, source string) *ExtensionTrustError
NewExtensionChecksumUnverifiedError returns the canonical trust-gate error.
func (*ExtensionTrustError) DiagnosticItem ¶
func (e *ExtensionTrustError) DiagnosticItem() contract.DiagnosticItem
func (*ExtensionTrustError) Error ¶
func (e *ExtensionTrustError) Error() string
func (*ExtensionTrustError) Unwrap ¶
func (e *ExtensionTrustError) Unwrap() error
type ForgeProviderError ¶
func (*ForgeProviderError) Error ¶
func (e *ForgeProviderError) Error() string
func (*ForgeProviderError) Unwrap ¶
func (e *ForgeProviderError) Unwrap() error
type ForgeRuntime ¶
type ForgeRuntime interface {
ForgeCapabilities(context.Context, []string) (extensioncontract.ForgeCapabilitiesResponse, error)
ForgeStatus(context.Context, extensioncontract.ForgeStatusRequest) (extensioncontract.ForgeStatusResponse, error)
ForgeCreatePR(
context.Context,
extensioncontract.ForgePRCreateRequest,
) (extensioncontract.ForgePRCreateResponse, error)
}
type GatewayConfirmation ¶
GatewayConfirmation is the confirmation tuple for one exact extension instance.
type GatewayConfirmationRequiredError ¶
type GatewayConfirmationRequiredError struct {
CurrentDigest string
}
GatewayConfirmationRequiredError carries the current digest the caller must confirm.
func (*GatewayConfirmationRequiredError) Error ¶
func (e *GatewayConfirmationRequiredError) Error() string
func (*GatewayConfirmationRequiredError) Unwrap ¶
func (e *GatewayConfirmationRequiredError) Unwrap() error
type GatewayRequirement ¶
type GatewayRequirement struct {
Permissions []string `toml:"permissions" json:"permissions"`
}
GatewayRequirement declares the gateway tiers an extension may expose.
func (*GatewayRequirement) Normalize ¶
func (r *GatewayRequirement) Normalize() *GatewayRequirement
func (*GatewayRequirement) Validate ¶
func (r *GatewayRequirement) Validate(field string) error
type HookConfig ¶
type HookConfig struct {
Profile string `toml:"profile,omitempty" json:"profile,omitempty"`
Name string `toml:"name" json:"name"`
Event string `toml:"event" json:"event"`
Mode string `toml:"mode,omitempty" json:"mode,omitempty"`
Required bool `toml:"required,omitempty" json:"required,omitzero"`
Priority *int `toml:"priority,omitempty" json:"priority,omitzero"`
Timeout Duration `toml:"timeout,omitempty" json:"timeout,omitempty"`
Matcher HookMatcherConfig `toml:"matcher,omitempty" json:"matcher"`
Command string `toml:"command,omitempty" json:"command,omitempty"`
Args []string `toml:"args,omitempty" json:"args,omitempty"`
Env map[string]string `toml:"env,omitempty" json:"env,omitempty"`
SecretEnv map[string]string `toml:"secret_env,omitempty" json:"secret_env,omitempty"`
Executor HookExecutorConfig `toml:"executor,omitempty" json:"executor"`
}
HookConfig mirrors the hook declaration shape accepted from extension manifests.
type HookExecutorConfig ¶
type HookExecutorConfig struct {
Kind string `toml:"kind,omitempty" json:"kind,omitempty"`
Command string `toml:"command,omitempty" json:"command,omitempty"`
Args []string `toml:"args,omitempty" json:"args,omitempty"`
Env map[string]string `toml:"env,omitempty" json:"env,omitempty"`
SecretEnv map[string]string `toml:"secret_env,omitempty" json:"secret_env,omitempty"`
}
HookExecutorConfig selects the hook execution boundary and command.
type HookMatcherConfig ¶
type HookMatcherConfig struct {
AgentName string `toml:"agent_name,omitempty" json:"agent_name,omitempty"`
AgentType string `toml:"agent_type,omitempty" json:"agent_type,omitempty"`
WorkspaceID string `toml:"workspace_id,omitempty" json:"workspace_id,omitempty"`
WorkspaceRoot string `toml:"workspace_root,omitempty" json:"workspace_root,omitempty"`
SessionType string `toml:"session_type,omitempty" json:"session_type,omitempty"`
InputClass string `toml:"input_class,omitempty" json:"input_class,omitempty"`
ACPEventType string `toml:"acp_event_type,omitempty" json:"acp_event_type,omitempty"`
TurnID string `toml:"turn_id,omitempty" json:"turn_id,omitempty"`
ToolID string `toml:"tool_id,omitempty" json:"tool_id,omitempty"`
ToolName string `toml:"tool_name,omitempty" json:"tool_name,omitempty"`
ToolReadOnly *bool `toml:"tool_read_only,omitempty" json:"tool_read_only,omitzero"`
DecisionClass string `toml:"decision_class,omitempty" json:"decision_class,omitempty"`
MessageRole string `toml:"message_role,omitempty" json:"message_role,omitempty"`
MessageDeltaType string `toml:"message_delta_type,omitempty" json:"message_delta_type,omitempty"`
CompactionTrigger string `toml:"compaction_trigger,omitempty" json:"compaction_trigger,omitempty"`
}
HookMatcherConfig narrows when a hook is eligible to run.
type HostAPIAutomationManager ¶
type HostAPIAutomationManager interface {
ListJobs(ctx context.Context, query automationpkg.JobListQuery) (automationpkg.JobListPage, error)
GetJob(ctx context.Context, id string) (automationpkg.Job, error)
CreateJob(ctx context.Context, job automationpkg.Job) (automationpkg.Job, error)
UpdateJob(ctx context.Context, job automationpkg.Job) (automationpkg.Job, error)
DeleteJob(ctx context.Context, id string) error
TriggerJob(ctx context.Context, id string) (automationpkg.Run, error)
TriggerJobWithPayload(ctx context.Context, id string, payload map[string]any) (automationpkg.Run, error)
ListTriggers(ctx context.Context, query automationpkg.TriggerListQuery) (automationpkg.TriggerListPage, error)
GetTrigger(ctx context.Context, id string) (automationpkg.Trigger, error)
CreateTrigger(
ctx context.Context,
trigger automationpkg.Trigger,
webhookSecret automationpkg.WebhookSecretWrite,
) (automationpkg.Trigger, error)
UpdateTrigger(
ctx context.Context,
trigger automationpkg.Trigger,
webhookSecret *automationpkg.WebhookSecretWrite,
) (automationpkg.Trigger, error)
DeleteTrigger(ctx context.Context, id string) error
ListRuns(ctx context.Context, query automationpkg.RunQuery) ([]automationpkg.Run, error)
SetJobEnabled(ctx context.Context, id string, enabled bool) (automationpkg.Job, error)
SetTriggerEnabled(ctx context.Context, id string, enabled bool) (automationpkg.Trigger, error)
FireExtensionTrigger(
ctx context.Context,
request automationpkg.ExtensionTriggerRequest,
) (automationpkg.TriggerResult, error)
}
HostAPIAutomationManager is the automation surface exposed to the extension Host API.
type HostAPIHandler ¶
type HostAPIHandler struct {
// contains filtered or unexported fields
}
HostAPIHandler handles extension -> Compozy Host API JSON-RPC requests.
func NewHostAPIHandler ¶
func NewHostAPIHandler( sessions hostAPISessionManager, observer hostAPIObserver, skillsRegistry hostAPISkillsRegistry, opts ...HostAPIOption, ) *HostAPIHandler
NewHostAPIHandler constructs a Host API handler with sensible defaults.
func (*HostAPIHandler) BeginExtensionToolCall ¶
func (h *HostAPIHandler) BeginExtensionToolCall( ctx context.Context, extensionName string, sessionID string, ) (string, func(), error)
BeginExtensionToolCall binds one opaque invocation ID to the active extension session.
func (*HostAPIHandler) Handle ¶
func (h *HostAPIHandler) Handle( ctx context.Context, extName string, method string, params json.RawMessage, ) (any, error)
Handle dispatches one Host API request for the named extension.
func (*HostAPIHandler) HandleMethod ¶
func (h *HostAPIHandler) HandleMethod(method string) subprocess.HandlerFunc
HandleMethod returns a subprocess-compatible handler for one Host API method.
func (*HostAPIHandler) HandleWithResourceActor ¶
func (h *HostAPIHandler) HandleWithResourceActor( ctx context.Context, principal string, method string, params json.RawMessage, actor resources.MutationActor, ) (any, error)
HandleWithResourceActor dispatches a Host API call with an authenticated resource-session actor. Capability checks and rate limiting still run through Handle.
func (*HostAPIHandler) MethodHandlers ¶
func (h *HostAPIHandler) MethodHandlers() map[string]subprocess.HandlerFunc
MethodHandlers returns the subprocess-compatible handler set for every Host API method.
type HostAPIOption ¶
type HostAPIOption func(*HostAPIHandler)
HostAPIOption customizes a HostAPIHandler.
func WithHostAPIAutomationGetter ¶
func WithHostAPIAutomationGetter(getter func() HostAPIAutomationManager) HostAPIOption
WithHostAPIAutomationGetter injects a lazy automation lookup used when the runtime boots after extensions.
func WithHostAPIAutomationManager ¶
func WithHostAPIAutomationManager(manager HostAPIAutomationManager) HostAPIOption
WithHostAPIAutomationManager injects the automation manager used for automation Host API methods.
func WithHostAPICapabilityChecker ¶
func WithHostAPICapabilityChecker(checker *CapabilityChecker) HostAPIOption
WithHostAPICapabilityChecker injects the capability checker used for Host API authorization.
func WithHostAPIClarify ¶
func WithHostAPIClarify(broker toolspkg.ClarifyBroker) HostAPIOption
WithHostAPIClarify injects the shared broker and active-call correlation runtime.
func WithHostAPIHeartbeatAuthoring ¶
func WithHostAPIHeartbeatAuthoring(service hostAPIHeartbeatAuthoringService) HostAPIOption
WithHostAPIHeartbeatAuthoring injects managed HEARTBEAT.md mutation support.
func WithHostAPIHeartbeatStatus ¶
func WithHostAPIHeartbeatStatus(service hostAPIHeartbeatStatusService) HostAPIOption
WithHostAPIHeartbeatStatus injects managed Heartbeat status support.
func WithHostAPIHeartbeatWake ¶
func WithHostAPIHeartbeatWake(service hostAPIHeartbeatWakeService) HostAPIOption
WithHostAPIHeartbeatWake injects managed Heartbeat wake support.
func WithHostAPIHeartbeatWakeEvents ¶
func WithHostAPIHeartbeatWakeEvents(reader hostAPIHeartbeatWakeEventReader) HostAPIOption
WithHostAPIHeartbeatWakeEvents injects retained wake audit reads.
func WithHostAPIModelCatalogService ¶
func WithHostAPIModelCatalogService(service modelcatalog.Service) HostAPIOption
WithHostAPIModelCatalogService injects daemon-owned model catalog projections.
func WithHostAPINow ¶
func WithHostAPINow(now func() time.Time) HostAPIOption
WithHostAPINow overrides the handler clock, mainly for tests.
func WithHostAPIProfileReader ¶
func WithHostAPIProfileReader(reader hostAPIProfileReader) HostAPIOption
WithHostAPIProfileReader injects profile identity lookup for owner-aware Host API payloads.
func WithHostAPIRateLimit ¶
func WithHostAPIRateLimit(limit int, burst int) HostAPIOption
WithHostAPIRateLimit overrides the per-extension Host API token bucket settings.
func WithHostAPIResourceCodecRegistry ¶
func WithHostAPIResourceCodecRegistry(registry *resources.CodecRegistry) HostAPIOption
WithHostAPIResourceCodecRegistry injects resource codecs used to validate and canonicalize snapshot specs before persistence.
func WithHostAPIResourceStore ¶
func WithHostAPIResourceStore(store resources.RawStore) HostAPIOption
WithHostAPIResourceStore injects the canonical raw resource store used by the extension resource Host API methods.
func WithHostAPIResourceTrigger ¶
func WithHostAPIResourceTrigger( trigger func(context.Context, resources.ResourceKind, resources.ReconcileReason) error, ) HostAPIOption
WithHostAPIResourceTrigger injects the reconcile trigger used after successful snapshot writes.
func WithHostAPISessionHealth ¶
func WithHostAPISessionHealth(reader hostAPISessionHealthReader) HostAPIOption
WithHostAPISessionHealth injects metadata-only session health reads.
func WithHostAPISoulAuthoring ¶
func WithHostAPISoulAuthoring(service hostAPISoulAuthoringService) HostAPIOption
WithHostAPISoulAuthoring injects managed SOUL.md read and mutation support.
func WithHostAPISoulRefresher ¶
func WithHostAPISoulRefresher(refresher hostAPISoulRefresher) HostAPIOption
WithHostAPISoulRefresher injects managed session Soul refresh support.
func WithHostAPITaskCatalogFilterMapper ¶
func WithHostAPITaskCatalogFilterMapper(mapper HostAPITaskCatalogFilterMapper) HostAPIOption
WithHostAPITaskCatalogFilterMapper injects the API-owned task catalog filter semantics.
func WithHostAPITaskManager ¶
func WithHostAPITaskManager(manager hostAPITaskManager) HostAPIOption
WithHostAPITaskManager injects the task manager used for task Host API methods.
func WithHostAPIViewPatchPublisher ¶
func WithHostAPIViewPatchPublisher(publisher ViewPatchPublisher) HostAPIOption
WithHostAPIViewPatchPublisher injects the daemon-owned declarative patch hub.
func WithHostAPIViewService ¶
func WithHostAPIViewService(service cmdpalette.ViewService) HostAPIOption
WithHostAPIViewService injects the daemon-owned programmable-view authority.
func WithHostAPIWorkspaceResolver ¶
func WithHostAPIWorkspaceResolver(resolver workspacepkg.RuntimeResolver) HostAPIOption
WithHostAPIWorkspaceResolver injects workspace resolution for workspace-scoped Host API methods.
type HostAPITaskCatalogFilterMapper ¶
type HostAPITaskCatalogFilterMapper func( query *taskpkg.CatalogQuery, includeLoop bool, loopRunID string, )
HostAPITaskCatalogFilterMapper applies API-owned task catalog filter semantics.
type HostAPIWorkspaceBinding ¶
type HostAPIWorkspaceBinding uint8
HostAPIWorkspaceBinding identifies how a workspace-bound Host API call is constrained.
const ( HostAPIWorkspaceBindingNone HostAPIWorkspaceBinding = iota HostAPIWorkspaceBindingActor HostAPIWorkspaceBindingPath HostAPIWorkspaceBindingID HostAPIWorkspaceBindingTask HostAPIWorkspaceBindingAutomation HostAPIWorkspaceBindingResource )
func HostAPIWorkspaceBindingFor ¶
func HostAPIWorkspaceBindingFor(method extensionprotocol.HostAPIMethod) (HostAPIWorkspaceBinding, bool)
HostAPIWorkspaceBindingFor returns the canonical workspace-binding decision for one Host API method.
type InputState ¶
type InputState struct{ Values map[string]InputValueRecord }
InputState is the effective input snapshot for one extension instance.
type InputValidationError ¶
InputValidationError identifies invalid input without including its value.
func (*InputValidationError) Error ¶
func (e *InputValidationError) Error() string
func (*InputValidationError) Unwrap ¶
func (e *InputValidationError) Unwrap() error
type InputValueRecord ¶
type InputValueRecord struct {
Type string
Value json.RawMessage
SecretRef string
Active bool
UpdatedAt time.Time
}
InputValueRecord holds a typed persisted value or a secret reference, never secret plaintext.
type InputsRequiredError ¶
type InputsRequiredError struct {
InputDefinitions []ManifestInput
MissingInputs []string
MissingEnv []string
}
InputsRequiredError reports the information required before an extension can run.
func (*InputsRequiredError) Error ¶
func (e *InputsRequiredError) Error() string
func (*InputsRequiredError) Unwrap ¶
func (e *InputsRequiredError) Unwrap() error
type InstallOption ¶
type InstallOption func(*installConfig)
InstallOption customizes one extension registry install operation.
func WithInstallEnabled ¶
func WithInstallEnabled(enabled bool) InstallOption
WithInstallEnabled controls the initial enabled state for a new registry row. Replace installs preserve the existing row's state.
func WithInstallProvenance ¶
func WithInstallProvenance(provenance ExtensionProvenance) InstallOption
WithInstallProvenance records the explicit source and trust evidence for one install.
func WithInstallRegistryMetadata ¶
func WithInstallRegistryMetadata(slug string, registryName string, remoteVersion string) InstallOption
WithInstallRegistryMetadata records remote registry provenance for one install.
func WithInstallReplaceExisting ¶
func WithInstallReplaceExisting() InstallOption
WithInstallReplaceExisting allows an install to overwrite an existing row.
func WithInstallScope ¶
func WithInstallScope(scope InstallationScope) InstallOption
WithInstallScope limits a new installation; replacements preserve attachments and enablement.
func WithInstallSource ¶
func WithInstallSource(source ExtensionSource) InstallOption
WithInstallSource overrides the persisted source tier for one install.
type Installation ¶
type Installation struct {
Scope InstallationScope
CreatedAt time.Time
}
Installation preserves one package attachment and its original creation time.
type InstallationScope ¶
InstallationScope selects an attachment; empty profile means all profiles, empty workspace means global.
type InstanceKey ¶
type InstanceKey struct {
Name string `json:"name"`
ProfileID string `json:"profile_id,omitempty"`
WorkspaceID string `json:"workspace_id,omitempty"`
}
InstanceKey is the stable identity for one runtime extension instance. An empty WorkspaceID identifies the globally installed instance.
func GlobalInstanceKey ¶
func GlobalInstanceKey(name string) InstanceKey
GlobalInstanceKey returns the published instance identity for name.
func ProfileInstanceKey ¶
func ProfileInstanceKey(name, profileID, workspaceID string) InstanceKey
ProfileInstanceKey returns the runtime identity for one acting profile and optional workspace. The permanent default profile reuses the base process.
func (InstanceKey) IsGlobal ¶
func (k InstanceKey) IsGlobal() bool
IsGlobal reports whether the key identifies the published global instance.
func (InstanceKey) IsProfileScoped ¶
func (k InstanceKey) IsProfileScoped() bool
IsProfileScoped reports whether the runtime is isolated to one profile.
func (InstanceKey) Normalize ¶
func (k InstanceKey) Normalize() InstanceKey
Normalize trims one instance key without changing its scope.
func (InstanceKey) Validate ¶
func (k InstanceKey) Validate() error
Validate reports whether the instance identity is usable.
type IssueSeverity ¶
type IssueSeverity = extensioncontract.IssueSeverity
IssueSeverity classifies one extension validation issue.
type KitItem ¶
type KitItem struct {
Kind resources.ResourceKind `json:"kind"`
ID string `json:"id"`
Name string `json:"name"`
Live bool `json:"live"`
SpecJSON []byte `json:"-"`
}
KitItem is one shipped or live extension resource, keyed by kind and name.
type LifecycleEvent ¶
type LifecycleEvent struct {
Enabled bool
EnableErrorClass string
Type string
ExtensionName string
SourceKind string
DigestMatched bool
WorkspaceID string
ExtensionGeneration string
Digest string
ConfirmedBy string
BoundCount *int
AutomationCount *int
ProfileID string
ProfileName string
}
LifecycleEvent carries only the correlation values allowed by the public event matrix.
func (LifecycleEvent) RequiredFields ¶
func (e LifecycleEvent) RequiredFields() (map[string]any, error)
RequiredFields returns the exact payload shape for the event type.
type LifecycleEventSink ¶
type LifecycleEventSink interface {
RecordExtensionLifecycleEvent(context.Context, LifecycleEvent) error
}
LifecycleEventSink records one closed-shape extension lifecycle event.
type LifecycleRegistry ¶
type LifecycleRegistry interface {
Get(name string) (*ExtensionInfo, error)
List() ([]ExtensionInfo, error)
Install(manifest *Manifest, path string, checksum string, opts ...InstallOption) error
Disable(name string) error
Uninstall(name string) error
RestoreGatewayConfirmation(InstanceKey, GatewayConfirmation) error
}
LifecycleRegistry is the installed-extension persistence surface required by managed lifecycle helpers.
type MCPServerAuthConfig ¶
type MCPServerAuthConfig struct {
ClientSecretInput string `toml:"-" json:"-"`
Method string `toml:"method" json:"method"`
Registration string `toml:"registration,omitempty" json:"registration,omitempty"`
IssuerURL string `toml:"issuer_url,omitempty" json:"issuer_url,omitempty"`
ClientID string `toml:"client_id,omitempty" json:"client_id,omitempty"`
Scopes []string `toml:"scopes,omitempty" json:"scopes,omitempty"`
}
MCPServerAuthConfig declares authentication policy without embedding credentials.
type MCPServerConfig ¶
type MCPServerConfig struct {
Auth *MCPServerAuthConfig `toml:"auth,omitempty" json:"auth,omitzero"`
DefaultScope string `toml:"default_scope,omitempty" json:"default_scope,omitempty"`
Profile string `toml:"profile,omitempty" json:"profile,omitempty"`
Command string `toml:"command,omitempty" json:"command,omitempty"`
CWD string `toml:"-" json:"-"`
Args []string `toml:"args,omitempty" json:"args,omitempty"`
Env map[string]string `toml:"env,omitempty" json:"env,omitempty"`
SecretEnv map[string]string `toml:"secret_env,omitempty" json:"secret_env,omitempty"`
Transport string `toml:"transport,omitempty" json:"transport,omitempty"`
URL string `toml:"url,omitempty" json:"url,omitempty"`
Headers map[string]string `toml:"headers,omitempty" json:"headers,omitempty"`
}
MCPServerConfig declares one MCP server packaged with the extension.
type ManagedRemovalCommit ¶
ManagedRemovalCommit preserves state on failure; post-commit cleanup failures only warn.
type ManagedRemoveResult ¶
type ManagedRemoveResult struct {
Name string `json:"name"`
Path string `json:"path"`
DataPath string `json:"data_path,omitempty"`
QuarantinePath string `json:"quarantine_path,omitempty"`
Status string `json:"status"`
Warnings []diagnosticcontract.DiagnosticItem `json:"warnings,omitempty"`
Tombstone *BuiltinTombstone `json:"-"`
}
ManagedRemoveResult describes one removed managed extension. Tombstone is set only when a permanent removal of a built-in committed its tombstone; it is nil for every other removal.
func RemoveBuiltinPermanently ¶
func RemoveBuiltinPermanently( ctx context.Context, homePaths compozyconfig.HomePaths, registry *Registry, name string, removedBy string, reload MutationReload, commit ManagedRemovalCommit, ) (ManagedRemoveResult, error)
RemoveBuiltinPermanently removes one bundled extension exactly as RemoveManagedExtension does, and records its tombstone in the same registry transaction as the row delete (Safety Invariant 1). A later failure restores the row and directory, then clears the tombstone once the row is back. If that compensation fails, the built-in returns to its removed state (no row, no install directory, tombstone recorded), and the error wraps ErrExtensionBuiltinRemovalCompensationFailed so the caller can name the restore path.
func RemoveManagedExtension ¶
func RemoveManagedExtension( ctx context.Context, homePaths compozyconfig.HomePaths, registry RemovalRegistry, name string, reload MutationReload, commit ManagedRemovalCommit, ) (_ ManagedRemoveResult, err error)
RemoveManagedExtension rolls back registry and filesystem state when reloading after removal fails.
type Manager ¶
type Manager struct {
// contains filtered or unexported fields
}
Manager orchestrates extension loading, subprocess lifecycle, and resource registration.
func NewManager ¶
NewManager constructs an extension manager with sensible defaults.
func (*Manager) ActivateDevelopmentLink ¶
ActivateDevelopmentLink starts only a staged generation whose gateway requirement is already confirmed.
func (*Manager) AgentDefinitions ¶
func (m *Manager) AgentDefinitions() []compozyconfig.AgentDef
AgentDefinitions returns the currently registered extension agent definitions.
func (*Manager) CallTool ¶
func (m *Manager) CallTool( ctx context.Context, extensionName string, req toolspkg.ExtensionToolCallRequest, ) (toolspkg.ToolResult, error)
CallTool invokes one reconciled extension-host tool through the existing subprocess JSON-RPC transport.
func (*Manager) CallToolForInstance ¶
func (m *Manager) CallToolForInstance( ctx context.Context, key InstanceKey, req toolspkg.ExtensionToolCallRequest, ) (toolspkg.ToolResult, error)
CallToolForInstance invokes the effective runtime bound to one trusted workspace.
func (*Manager) CloseProgram ¶
func (m *Manager) CloseProgram( ctx context.Context, profile cmdpalette.ProfileLens, workspaceID cmdpalette.WorkspaceID, extensionName string, request cmdpalette.ViewCloseRequest, ) error
CloseProgram calls view/close through the same gate as open and event.
func (*Manager) CmdPalette ¶
func (m *Manager) CmdPalette(workspaceID string, profile ProfileLens) (CmdPaletteProjection, error)
CmdPalette returns one atomic projection for an explicit profile lens.
func (*Manager) CmdPaletteSettings ¶
func (m *Manager) CmdPaletteSettings(workspaceID string, profile ProfileLens) (CmdPaletteProjection, error)
CmdPaletteSettings returns installed contributions for operator inspection, including disabled extensions that do not belong to the live catalog.
func (*Manager) Commands ¶
func (m *Manager) Commands(workspaceID string) ([]CommandDescriptor, []CommandGroupDescriptor, error)
Commands returns the storage-free command projection for the effective workspace extension set.
func (*Manager) ForgeCapabilities ¶
func (m *Manager) ForgeCapabilities( ctx context.Context, remoteURLs []string, ) (extensioncontract.ForgeCapabilitiesResponse, error)
func (*Manager) ForgeCreatePR ¶
func (m *Manager) ForgeCreatePR( ctx context.Context, request extensioncontract.ForgePRCreateRequest, ) (extensioncontract.ForgePRCreateResponse, error)
func (*Manager) ForgeReadPR ¶
func (m *Manager) ForgeReadPR(ctx context.Context, request c.ForgePRReadRequest) (c.ForgePRCandidate, error)
func (*Manager) ForgeSearchPRs ¶
func (m *Manager) ForgeSearchPRs(ctx context.Context, request c.ForgePRSearchRequest) (c.ForgePRSearchResponse, error)
func (*Manager) ForgeStatus ¶
func (m *Manager) ForgeStatus( ctx context.Context, request extensioncontract.ForgeStatusRequest, ) (extensioncontract.ForgeStatusResponse, error)
func (*Manager) GetForInstance ¶
func (m *Manager) GetForInstance(key InstanceKey) (*Extension, error)
GetForInstance resolves a workspace dev overlay before a visible published installation.
func (*Manager) HandleProgramEvent ¶
func (m *Manager) HandleProgramEvent( ctx context.Context, profile cmdpalette.ProfileLens, workspaceID cmdpalette.WorkspaceID, extensionName string, event cmdpalette.ViewEvent, ) (*cmdpalette.ViewFrame, error)
HandleProgramEvent calls view/event and permits an acknowledgement-only response.
func (*Manager) HookDeclarationsForProfiles ¶
func (m *Manager) HookDeclarationsForProfiles( ctx context.Context, profiles []ProfileLens, ) ([]hookspkg.HookDecl, error)
HookDeclarationsForProfiles resolves placement, enablement and workspace overrides before publication.
func (*Manager) InspectDevelopmentGeneration ¶
func (m *Manager) InspectDevelopmentGeneration( ctx context.Context, workspaceID string, originPath string, generationHash string, ) (DevelopmentGeneration, error)
InspectDevelopmentGeneration verifies a dev artifact without linking or starting it.
func (*Manager) InspectPackageResources ¶
InspectPackageResources loads one installed package's declarative resources without registering it, starting a subprocess, or mutating runtime state.
func (*Manager) InvalidateProfileRuntime ¶
func (m *Manager) InvalidateProfileRuntime(ctx context.Context, key InstanceKey) error
InvalidateProfileRuntime stops one profile subprocess after its launch bindings change. The next scoped call starts it with the new resolved values.
func (*Manager) LinkDevelopment ¶
func (m *Manager) LinkDevelopment( ctx context.Context, key InstanceKey, originPath string, generationHash string, ) (*Extension, error)
LinkDevelopment verifies, activates, and persists one workspace-local generation.
func (*Manager) LinkDevelopmentFromOrigin ¶
func (m *Manager) LinkDevelopmentFromOrigin( ctx context.Context, workspaceID string, originPath string, generationHash string, ) (*Extension, error)
LinkDevelopmentFromOrigin derives the authored name from a verified generation.
func (*Manager) List ¶
func (m *Manager) List() []ExtensionInfo
List returns every currently known registry row in name order.
func (*Manager) ListForWorkspace ¶
func (m *Manager) ListForWorkspace(workspaceID string) []ExtensionInfo
ListForWorkspace returns the effective extension registry for one trusted workspace.
func (*Manager) ListModelSourceRows ¶
func (m *Manager) ListModelSourceRows( ctx context.Context, extensionName string, params extensioncontract.ModelSourceListParams, ) ([]extensioncontract.ModelSourceRow, error)
ListModelSourceRows calls one extension's negotiated models/list service.
func (*Manager) Logs ¶
func (m *Manager) Logs(key InstanceKey, cursor ExtensionLogCursor) (ExtensionLogSnapshot, error)
Logs returns retained redacted stderr entries after a cursor within the current ring identity.
func (*Manager) OpenProgram ¶
func (m *Manager) OpenProgram( ctx context.Context, extensionName string, request cmdpalette.ViewOpenRequest, ) (cmdpalette.ViewFrame, uint64, error)
OpenProgram calls view/open through the standard capability and method gate.
func (*Manager) Poll ¶
func (m *Manager) Poll(ctx context.Context, req watchpkg.PollRequest) (watchpkg.PollResponse, error)
Poll resolves the watch-source kind to an active extension and calls watch/poll.
func (*Manager) PollSource ¶
func (*Manager) ProjectForProfile ¶
func (m *Manager) ProjectForProfile( ctx context.Context, key InstanceKey, profile ProfileLens, ) (*Extension, bool, error)
ProjectForProfile returns the extension resources visible through one real profile. The boolean is false when the extension is disabled for that profile, or when its packaged declarative resources cannot be loaded: that package then projects no resources and carries the failure in Status.LastError, so one broken package never fails the publication of the others.
func (*Manager) ProvideTools ¶
func (m *Manager) ProvideTools( ctx context.Context, extensionName string, ) ([]toolspkg.ExtensionToolRuntimeDescriptor, error)
ProvideTools calls the negotiated runtime descriptor endpoint for one tool-provider extension.
func (*Manager) ProvideToolsForInstance ¶
func (m *Manager) ProvideToolsForInstance( ctx context.Context, key InstanceKey, ) ([]toolspkg.ExtensionToolRuntimeDescriptor, error)
ProvideToolsForInstance resolves the runtime bound to one trusted workspace instance.
func (*Manager) Reload ¶
Reload restarts the manager from the current registry state as one lifecycle operation.
func (*Manager) ReloadExtension ¶
func (m *Manager) ReloadExtension( ctx context.Context, key InstanceKey, generationHash string, ) (*Extension, error)
ReloadExtension atomically replaces one active dev generation.
func (*Manager) ReloadForExtensions ¶
ReloadForExtensions retains unrelated activation failures in status without aborting the selected mutation.
func (*Manager) ResolveConnectivitySource ¶
func (m *Manager) ResolveConnectivitySource( ctx context.Context, name string, ) (gateway.ConnectivitySource, error)
ResolveConnectivitySource returns the global extension provider selected by durable gateway policy.
func (*Manager) SourceKinds ¶
func (m *Manager) SourceKinds(ctx context.Context, scope source.CatalogScope) ([]source.KindDescriptor, error)
func (*Manager) StageDevelopmentLink ¶
func (m *Manager) StageDevelopmentLink( ctx context.Context, key InstanceKey, originPath string, generationHash string, ) (*DevLink, error)
StageDevelopmentLink verifies and persists one immutable generation without starting it.
func (*Manager) Statuses ¶
func (m *Manager) Statuses() []ExtensionStatus
Statuses returns the current runtime health snapshot for every known extension.
func (*Manager) StatusesForWorkspace ¶
func (m *Manager) StatusesForWorkspace(workspaceID string) []ExtensionStatus
StatusesForWorkspace returns effective status without leaking another workspace's dev instances.
func (*Manager) UnlinkDevelopment ¶
func (m *Manager) UnlinkDevelopment(ctx context.Context, key InstanceKey) error
UnlinkDevelopment removes and stops only one workspace-local instance.
type Manifest ¶
type Manifest struct {
Layout string `toml:"-" json:"-"`
Format ExtensionFormat `toml:"-" json:"-"`
IngestDiagnostics []diagnosticcontract.DiagnosticItem `toml:"-" json:"-"`
Name string `toml:"name" json:"name"`
Version string `toml:"version" json:"version"`
Description string `toml:"description,omitempty" json:"description,omitempty"`
MinCompozyVersion string `toml:"min_compozy_version" json:"min_compozy_version"`
Inputs []ManifestInput `toml:"inputs,omitempty" json:"inputs,omitempty"`
RequiresEnv []string `toml:"requires_env,omitempty" json:"requires_env,omitempty"`
Gateway *GatewayRequirement `toml:"gateway,omitempty" json:"gateway,omitzero"`
Resources ResourcesConfig `toml:"resources" json:"resources"`
Capabilities CapabilitiesConfig `toml:"capabilities" json:"capabilities"`
Permissions PermissionsConfig `toml:"permissions" json:"permissions"`
Subprocess SubprocessConfig `toml:"subprocess" json:"subprocess"`
Profiles []ManifestProfile `toml:"profiles,omitempty" json:"profiles,omitempty"`
}
Manifest describes one extension without executing any extension code.
func LoadInstalledManifest ¶
func LoadInstalledManifest(info *ExtensionInfo) (*Manifest, error)
LoadInstalledManifest retains the approved identity when reloading client plugin bytes.
func LoadManifest ¶
LoadManifest reads one extension manifest from dir, preferring native manifests over a supported Agent Plugins root.
func LoadManifestWithAgentPluginDataDir ¶
LoadManifestWithAgentPluginDataDir loads a manifest with an explicit instance-owned PLUGIN_DATA path for portable stdio server synthesis.
func SynthesizeAgentPluginManifest ¶
func SynthesizeAgentPluginManifest(pkg *agentplugin.Package, rootDir string) (*Manifest, error)
SynthesizeAgentPluginManifest converts a validated portable package into a resource-only Compozy manifest without writing a second manifest to disk.
func (*Manifest) AgentPluginHeaderSecretInputs ¶
AgentPluginHeaderSecretInputs maps optional header credential names to their typed input IDs.
func (*Manifest) DormantPlacements ¶
func (m *Manifest) DormantPlacements(profileNames []string) []ManifestPlacement
DormantPlacements returns name-bound declarations whose profile is absent.
func (*Manifest) MissingEnv ¶
MissingEnv returns manifest-required environment variable names that are unset or empty.
func (*Manifest) PlacementMatrix ¶
func (m *Manifest) PlacementMatrix() []ManifestPlacement
PlacementMatrix returns every profile-aware resource declaration in stable order.
type ManifestCompatibilityError ¶
ManifestCompatibilityError describes a daemon-version compatibility failure.
func (*ManifestCompatibilityError) Error ¶
func (e *ManifestCompatibilityError) Error() string
Error returns the daemon-version compatibility message.
func (*ManifestCompatibilityError) Is ¶
func (e *ManifestCompatibilityError) Is(target error) bool
Is matches sentinel errors for errors.Is.
type ManifestInput ¶
type ManifestInput = marketplace.EntryInput
ManifestInput uses the same grammar as its published catalog entry.
type ManifestNotFoundError ¶
ManifestNotFoundError describes a missing manifest directory.
func (*ManifestNotFoundError) Error ¶
func (e *ManifestNotFoundError) Error() string
Error returns the typed missing-manifest message.
func (*ManifestNotFoundError) Is ¶
func (e *ManifestNotFoundError) Is(target error) bool
Is matches sentinel errors for errors.Is.
type ManifestPlacement ¶
type ManifestPlacement struct {
Kind string `json:"kind"`
Resource string `json:"resource"`
Profile string `json:"profile,omitempty"`
}
ManifestPlacement is one resource declaration and the profile name that owns it. An empty profile means the resource is available to every profile.
type ManifestProfile ¶
type ManifestProfile struct {
Name string `toml:"name" json:"name"`
Color string `toml:"color,omitempty" json:"color,omitempty"`
Icon string `toml:"icon,omitempty" json:"icon,omitempty"`
Emoji string `toml:"emoji,omitempty" json:"emoji,omitempty"`
Defaults ManifestProfileDefaults `toml:"defaults,omitempty" json:"defaults,omitzero"`
Credentials []ManifestProfileCredential `toml:"credentials,omitempty" json:"credentials,omitempty"`
}
ManifestProfile declares one profile an extension creates at install time.
type ManifestProfileCredential ¶
type ManifestProfileCredential struct {
Provider string `toml:"provider" json:"provider"`
Slot string `toml:"slot" json:"slot"`
}
ManifestProfileCredential is one vault-backed setup requirement.
type ManifestProfileDefaults ¶
type ManifestProfileDefaults struct {
Agent string `toml:"agent,omitempty" json:"agent,omitempty"`
Provider string `toml:"provider,omitempty" json:"provider,omitempty"`
}
ManifestProfileDefaults are seeded once when a declaration creates a profile.
type ManifestResourcePath ¶
type ManifestResourcePath struct {
Path string `toml:"path" json:"path"`
Profile string `toml:"profile,omitempty" json:"profile,omitempty"`
}
ManifestResourcePath binds one static resource path to every profile or to exactly one profile name when Profile is set.
func (*ManifestResourcePath) UnmarshalJSON ¶
func (r *ManifestResourcePath) UnmarshalJSON(data []byte) error
UnmarshalJSON translates string paths until their removal in v0.3.0-beta.31.
func (*ManifestResourcePath) UnmarshalTOML ¶
func (r *ManifestResourcePath) UnmarshalTOML(value any) error
UnmarshalTOML shares the JSON boundary's path and placement validation.
type ManifestToolDescriptor ¶
type ManifestToolDescriptor struct {
Name string
Profile string
Tool toolspkg.Tool
RuntimeDescriptor toolspkg.ExtensionToolRuntimeDescriptor
}
ManifestToolDescriptor is a manifest-authoritative cold descriptor plus runtime proof metadata.
func ResolveManifestToolDescriptors ¶
func ResolveManifestToolDescriptors(manifest *Manifest) ([]ManifestToolDescriptor, error)
ResolveManifestToolDescriptors converts manifest tool declarations into cold specs and digest proofs.
type ManifestValidationError ¶
ManifestValidationError describes an invalid manifest field.
func (*ManifestValidationError) Error ¶
func (e *ManifestValidationError) Error() string
Error returns the field-specific validation message.
func (*ManifestValidationError) Is ¶
func (e *ManifestValidationError) Is(target error) bool
Is matches sentinel errors for errors.Is.
type MarketplaceDigestVerificationObserver ¶
type MarketplaceDigestVerificationObserver func(*MarketplaceTrustEvidence, error)
MarketplaceDigestVerificationObserver receives a pre-extraction verification outcome.
type MarketplaceInstallRequest ¶
type MarketplaceInstallRequest struct {
Plugin *MarketplacePluginAcquisition
Scope InstallationScope
ExpectedDigest string
Slug string
SourceFilter string
Version string
Asset string
PolicyAllowsUnverified bool
AllowUnverified bool
InstalledBy string
Trust *MarketplaceTrustEvidence
ArtifactHTTPClient *http.Client
ObserveDigestVerification MarketplaceDigestVerificationObserver
}
MarketplaceInstallRequest describes one marketplace-backed extension install.
type MarketplacePackageAcquirer ¶
type MarketplacePackageAcquirer interface {
Acquire(context.Context, pluginsource.AcquisitionRecord, string) (io.ReadCloser, error)
}
type MarketplacePluginAcquisition ¶
type MarketplacePluginAcquisition struct {
SourceName string
Record pluginsource.AcquisitionRecord
Acquirer MarketplacePackageAcquirer
}
MarketplacePluginAcquisition is server-owned projection evidence, separate from curated trust.
type MarketplaceSourceLoader ¶
type MarketplaceSourceLoader func(context.Context) ([]registrypkg.Source, error)
MarketplaceSourceLoader resolves configured marketplace sources. The optional source filter is an already-normalized operator/tool input.
type MarketplaceTrustEvidence ¶
type MarketplaceTrustEvidence struct {
CatalogEntryID string
Version string
ArchiveDigestSHA256 string
RegistryTier string
ArtifactURL string
Repository string
}
MarketplaceTrustEvidence contains feed-authoritative install metadata.
type MarketplaceTrustResolver ¶
type MarketplaceTrustResolver func( context.Context, string, string, ) (*MarketplaceTrustEvidence, error)
MarketplaceTrustResolver resolves curated evidence; nil marks a non-curated side-load.
type MarketplaceUpdateBatchError ¶
type MarketplaceUpdateBatchError struct {
FailedName string
Completed []MarketplaceUpdateResult
Cause error
}
MarketplaceUpdateBatchError retains every target outcome and the causes of a partially failed batch.
func (*MarketplaceUpdateBatchError) Error ¶
func (e *MarketplaceUpdateBatchError) Error() string
func (*MarketplaceUpdateBatchError) Unwrap ¶
func (e *MarketplaceUpdateBatchError) Unwrap() error
type MarketplaceUpdateCommit ¶
type MarketplaceUpdateCommit func(ExtensionInfo, *Manifest) error
MarketplaceUpdateCommit runs after registry persistence; failure restores the prior installation.
type MarketplaceUpdatePreflight ¶
type MarketplaceUpdatePreflight func(ExtensionInfo, *Manifest) error
MarketplaceUpdatePreflight validates a candidate before it replaces the installed files.
type MarketplaceUpdateRequest ¶
type MarketplaceUpdateRequest struct {
Names []string
All bool
CheckOnly bool
Version string
PolicyAllowsUnverified bool
AllowUnverified bool
InstalledBy string
ResolveTrust MarketplaceTrustResolver
ResolvePlugin MarketplacePluginResolver
ArtifactHTTPClient *http.Client
ObserveDigestVerification MarketplaceDigestVerificationObserver
PreflightCandidate MarketplaceUpdatePreflight
CommitCandidate MarketplaceUpdateCommit
RollbackCandidate MarketplaceUpdateRollback
ReloadCandidate func(context.Context, string) error
// contains filtered or unexported fields
}
MarketplaceUpdateRequest describes one marketplace update batch.
type MarketplaceUpdateResult ¶
type MarketplaceUpdateResult struct {
Name string `json:"name"`
Slug string `json:"slug"`
Registry string `json:"registry"`
CurrentVersion string `json:"current_version,omitempty"`
LatestVersion string `json:"latest_version,omitempty"`
Path string `json:"path"`
Status string `json:"status"`
Warnings []diagnosticcontract.DiagnosticItem `json:"warnings,omitempty"`
Error *diagnosticcontract.DiagnosticItem `json:"error,omitzero"`
}
MarketplaceUpdateResult describes one marketplace update outcome.
func UpdateMarketplaceManaged ¶
func UpdateMarketplaceManaged( ctx context.Context, homePaths compozyconfig.HomePaths, registry LifecycleRegistry, loader MarketplaceSourceLoader, req MarketplaceUpdateRequest, reload MutationReload, ) ([]MarketplaceUpdateResult, error)
UpdateMarketplaceManaged updates marketplace extensions with rollback on reload failure.
type MarketplaceUpdateRollback ¶
type MarketplaceUpdateRollback func(context.Context, ExtensionInfo) error
MarketplaceUpdateRollback restores candidate-owned state after the previous package and registry record have been restored successfully, and before that installation is reloaded.
type ModelSource ¶
type ModelSource struct {
// contains filtered or unexported fields
}
ModelSource adapts one extension into a daemon-owned model catalog source.
func NewExtensionModelSource ¶
func NewExtensionModelSource(info *ExtensionInfo, resolver ModelSourceRuntimeResolver) (*ModelSource, error)
NewExtensionModelSource creates a daemon model catalog source for one extension.
func (*ModelSource) CatalogExecutionFingerprint ¶
func (s *ModelSource) CatalogExecutionFingerprint() (string, error)
CatalogExecutionFingerprint isolates rows produced by one installed extension generation.
func (*ModelSource) ID ¶
func (s *ModelSource) ID() string
ID returns the stable extension source id.
func (*ModelSource) Kind ¶
func (s *ModelSource) Kind() modelcatalog.SourceKind
Kind returns extension.
func (*ModelSource) ListModels ¶
func (s *ModelSource) ListModels(ctx context.Context, opts modelcatalog.ListOptions) ([]modelcatalog.ModelRow, error)
ListModels calls the extension models/list service and validates rows before persistence.
func (*ModelSource) Priority ¶
func (s *ModelSource) Priority() int
Priority returns the extension merge priority.
func (*ModelSource) TTL ¶
func (s *ModelSource) TTL() time.Duration
TTL keeps extension-provided releases on the same automatic refresh cadence as live providers.
type ModelSourceRuntime ¶
type ModelSourceRuntime interface {
ListModelSourceRows(
ctx context.Context,
extensionName string,
params extensioncontract.ModelSourceListParams,
) ([]extensioncontract.ModelSourceRow, error)
}
ModelSourceRuntime calls Compozy-to-extension model source services.
type ModelSourceRuntimeResolver ¶
type ModelSourceRuntimeResolver func() ModelSourceRuntime
ModelSourceRuntimeResolver returns the current extension runtime.
type MutationReload ¶
MutationReload is called after a registry/on-disk mutation and before the lifecycle helper commits any staged filesystem backup.
type Option ¶
type Option func(*Manager)
Option customizes an extension manager.
func WithCapabilityChecker ¶
func WithCapabilityChecker(checker *CapabilityChecker) Option
WithCapabilityChecker injects the grant evaluator used for Host API authorization.
func WithCompozyExecutableResolver ¶
WithCompozyExecutableResolver overrides the binary used by {{compozy_executable}} manifest templates.
func WithDefaultHookTimeout ¶
WithDefaultHookTimeout overrides the negotiated default hook timeout.
func WithEnvBindingStore ¶
func WithEnvBindingStore(store EnvBindingStore) Option
WithEnvBindingStore injects instance-scoped operator bindings used at process launch.
func WithExtensionToolCallTracker ¶
func WithExtensionToolCallTracker(tracker ExtensionToolCallTracker) Option
WithExtensionToolCallTracker installs active-call correlation for extension-host tools.
func WithGetenv ¶
WithGetenv overrides environment lookup used for manifest template expansion.
func WithHealthCheckTimeout ¶
WithHealthCheckTimeout overrides the negotiated health probe timeout.
func WithHomePaths ¶
func WithHomePaths(paths compozyconfig.HomePaths) Option
WithHomePaths binds extension-owned runtime data to the daemon's canonical home layout.
func WithHostMethodHandler ¶
func WithHostMethodHandler(method string, handler subprocess.HandlerFunc) Option
WithHostMethodHandler registers one Host API method handler for launched extensions.
func WithInitializeTimeout ¶
WithInitializeTimeout overrides the initialize handshake timeout.
func WithLifecycleEventSink ¶
func WithLifecycleEventSink(sink LifecycleEventSink) Option
WithLifecycleEventSink injects the append-only lifecycle observer used by manager-owned call sites.
func WithLogger ¶
WithLogger injects the logger used for extension diagnostics.
func WithProcessRegistry ¶
func WithProcessRegistry(registry *toolruntime.Registry) Option
WithProcessRegistry injects shared tool process ownership tracking.
func WithProfileNameResolver ¶
func WithProfileNameResolver(resolver ProfileNameResolver) Option
WithProfileNameResolver binds profile-scoped subprocesses to canonical profile names.
func WithSecretResolver ¶
func WithSecretResolver(resolver SecretRefResolver) Option
WithSecretResolver injects the daemon vault resolver used for extension secret env bindings.
func WithSourceSessionManager ¶
func WithSourceSessionManager(manager resources.SourceSessionManager) Option
WithSourceSessionManager injects the resource source-session manager used to activate extension nonces for snapshot publication.
func WithSubprocessSignalGrace ¶
WithSubprocessSignalGrace overrides the SIGTERM -> SIGKILL grace interval.
func WithWorkspaceResolver ¶
func WithWorkspaceResolver(resolver workspacepkg.RuntimeResolver) Option
WithWorkspaceResolver binds workspace-scoped extension sessions to the registered workspace that owns their manifest path.
type PermissionsConfig ¶
type PermissionsConfig struct {
Requires []string `toml:"requires,omitempty" json:"requires,omitempty"`
}
PermissionsConfig declares Host API methods the extension wants to call.
type PreparedLocalManagedInstall ¶
type PreparedLocalManagedInstall struct {
// contains filtered or unexported fields
}
PreparedLocalManagedInstall owns one validated local bundle until it is published as a new installation or replaces one in place.
func PrepareLocalManagedInstall ¶
func PrepareLocalManagedInstall( homePaths compozyconfig.HomePaths, registry LifecycleRegistry, manifest *Manifest, sourceDir string, checksum string, opts ...InstallOption, ) (*PreparedLocalManagedInstall, error)
PrepareLocalManagedInstall verifies a local bundle without copying it or exposing it through the installed-extension registry, so a preview leaves no managed state.
func (*PreparedLocalManagedInstall) Close ¶
func (p *PreparedLocalManagedInstall) Close() error
Close releases the staging directory retained by preparation.
func (*PreparedLocalManagedInstall) Commit ¶
func (p *PreparedLocalManagedInstall) Commit() error
Commit publishes the prepared bundle as a new installation. A row that appeared after preparation is refused so this path never overwrites an installation in place.
func (*PreparedLocalManagedInstall) MatchesInstalled ¶
func (p *PreparedLocalManagedInstall) MatchesInstalled(info *ExtensionInfo) bool
MatchesInstalled identifies a repeat of the same local bundle so callers can reuse the installed package and only reconcile inputs.
func (*PreparedLocalManagedInstall) Origin ¶
func (p *PreparedLocalManagedInstall) Origin() marketplacepkg.Origin
Origin reports no marketplace acquisition: a local bundle owns no catalog identity.
func (*PreparedLocalManagedInstall) Reinstall ¶
func (p *PreparedLocalManagedInstall) Reinstall( ctx context.Context, info *ExtensionInfo, preflight MarketplaceUpdatePreflight, commit MarketplaceUpdateCommit, rollback MarketplaceUpdateRollback, reload, complete MutationReload, ) ([]diagnosticcontract.DiagnosticItem, error)
Reinstall publishes the prepared bundle through the replacement transaction shared with published sources: the installed directory is staged as a backup and restored, together with its registry record, unless reload and the caller's completion step both succeed.
func (*PreparedLocalManagedInstall) ValidateReinstall ¶
func (p *PreparedLocalManagedInstall) ValidateReinstall(info *ExtensionInfo) error
ValidateReinstall refuses a target this local bundle cannot replace: another name or managed directory, a bundled package, a marketplace-owned name whose provenance would be dropped, and any installed package the caller did not ask to replace.
type PreparedMarketplaceManagedInstall ¶
type PreparedMarketplaceManagedInstall struct {
// contains filtered or unexported fields
}
PreparedMarketplaceManagedInstall owns a validated staged artifact until it is committed to one extension instance or closed.
func PrepareMarketplaceManagedInstall ¶
func PrepareMarketplaceManagedInstall( ctx context.Context, homePaths compozyconfig.HomePaths, registry LifecycleRegistry, loader MarketplaceSourceLoader, req MarketplaceInstallRequest, ) (*PreparedMarketplaceManagedInstall, error)
PrepareMarketplaceManagedInstall downloads and validates an artifact without exposing it through the managed install or registry read surfaces.
func (*PreparedMarketplaceManagedInstall) Close ¶
func (p *PreparedMarketplaceManagedInstall) Close() error
Close releases any staging directory retained by preparation.
func (*PreparedMarketplaceManagedInstall) Commit ¶
func (p *PreparedMarketplaceManagedInstall) Commit(scope InstallationScope) (*ExtensionInfo, error)
Commit moves the staged artifact into place and attaches it to the resolved scope.
func (*PreparedMarketplaceManagedInstall) Digest ¶
func (p *PreparedMarketplaceManagedInstall) Digest() string
Digest returns the digest of the acquired archive, including unpinned direct-source previews.
func (*PreparedMarketplaceManagedInstall) Manifest ¶
func (p *PreparedMarketplaceManagedInstall) Manifest() *Manifest
Manifest returns an isolated copy of the validated staged manifest.
func (*PreparedMarketplaceManagedInstall) MatchesInstalled ¶
func (p *PreparedMarketplaceManagedInstall) MatchesInstalled(info *ExtensionInfo) bool
MatchesInstalled identifies a retry of the same acquisition; callers still validate input readiness.
func (*PreparedMarketplaceManagedInstall) Name ¶
func (p *PreparedMarketplaceManagedInstall) Name() string
Name returns the validated extension instance name discovered from the staged artifact.
func (*PreparedMarketplaceManagedInstall) Origin ¶
func (p *PreparedMarketplaceManagedInstall) Origin() marketplacepkg.Origin
Origin returns acquisition identity independently of the source display name.
func (*PreparedMarketplaceManagedInstall) Reinstall ¶
func (p *PreparedMarketplaceManagedInstall) Reinstall( ctx context.Context, info *ExtensionInfo, preflight MarketplaceUpdatePreflight, commit MarketplaceUpdateCommit, rollback MarketplaceUpdateRollback, reload, complete MutationReload, ) ([]diagnosticcontract.DiagnosticItem, error)
Reinstall reuses the staged acquisition and update transaction, preserving existing attachments. The caller holds the package lifecycle lock and authorizes unclassified-origin association.
func (*PreparedMarketplaceManagedInstall) ValidateReinstall ¶
func (p *PreparedMarketplaceManagedInstall) ValidateReinstall(info *ExtensionInfo) error
ValidateReinstall refuses another classified origin and packages outside the managed root. Associating an unclassified package with a listing requires operator authorization at the caller.
type ProfileLens ¶
ProfileLens identifies the profile whose extension contributions are being projected.
type ProfileNameResolver ¶
ProfileNameResolver resolves an active profile identity for runtime scope binding.
type PublishRequest ¶
PublishRequest identifies one immutable generation and its GitHub release. The uploader owns authentication; credentials never enter this value.
type PublishResult ¶
type PublishResult struct {
ReleaseURL string `json:"release_url"`
AssetURL string `json:"asset_url"`
DigestSHA256 string `json:"digest_sha256"`
}
PublishResult reports the release locations and archive integrity digest.
func PublishRelease ¶
func PublishRelease( ctx context.Context, uploader registrygithub.ReleaseUploader, request PublishRequest, ) (*PublishResult, error)
PublishRelease archives a validated generation and uploads it with a digest sidecar.
type Readiness ¶
Readiness separates missing typed inputs from requires_env requirements.
func InputReadiness ¶
func InputReadiness(manifest *Manifest, state InputState, getenv func(string) string) Readiness
InputReadiness uses stored values/defaults for URL inputs and permits environment fallback only for env inputs.
func (Readiness) RequiredError ¶
RequiredError names manifest input IDs while retaining the separate missing environment list.
type Registry ¶
type Registry struct {
// contains filtered or unexported fields
}
Registry persists installed extension metadata in the global SQLite database.
func NewRegistry ¶
func NewRegistry(db *sql.DB, options ...RegistryOption) *Registry
NewRegistry constructs a registry over an existing SQLite connection.
func (*Registry) AttachInstallation ¶
func (r *Registry) AttachInstallation(ctx context.Context, name string, scope InstallationScope) error
AttachInstallation adds one exact scope without changing the package or another attachment. Retrying the same attachment preserves its original timestamp.
func (*Registry) BuiltinTombstoneFor ¶
func (r *Registry) BuiltinTombstoneFor(ctx context.Context, name string) (BuiltinTombstone, bool, error)
BuiltinTombstoneFor returns the tombstone recorded for name. The boolean is false when none exists.
func (*Registry) ConfirmDevelopmentGatewayCandidate ¶
func (r *Registry) ConfirmDevelopmentGatewayCandidate( key InstanceKey, digest string, actor string, at time.Time, ) error
ConfirmDevelopmentGatewayCandidate records consent for one inspected dev generation before its process is allowed to start. The caller must hold the extension lifecycle lock and must have derived digest from that immutable generation.
func (*Registry) ConfirmGatewayRequirement ¶
func (r *Registry) ConfirmGatewayRequirement( key InstanceKey, expectedDigest string, actor string, at time.Time, ) error
ConfirmGatewayRequirement records actor attribution only for the digest currently on disk.
func (*Registry) DB ¶
DB exposes the backing SQLite handle for composition-root integrations that need to build additional stores over the same registry database.
func (*Registry) DetachInstallation ¶
func (r *Registry) DetachInstallation(ctx context.Context, name string, scope InstallationScope) error
DetachInstallation removes only the exact attachment. Package deletion belongs to the lifecycle coordinator after it retires the final installed instance.
func (*Registry) DevLinkNamesForWorkspace ¶
DevLinkNamesForWorkspace returns the development source owners trusted by one workspace.
func (*Registry) DisableIfLifecycleToken ¶
DisableIfLifecycleToken disables the default-profile runtime only when the persisted lifecycle owner still matches the instance requesting cleanup.
func (*Registry) EnabledBundledNames ¶
EnabledBundledNames returns a cached snapshot of enabled bundled extension names. A tombstoned name is excluded even when a bundled row still exists, so a permanently removed built-in grants no tool trust.
func (*Registry) EnvBindingScopes ¶
EnvBindingScopes returns every persisted credential cell, including orphaned and inactive bindings.
func (*Registry) GatewayConfirmation ¶
func (r *Registry) GatewayConfirmation(key InstanceKey) (GatewayConfirmation, error)
GatewayConfirmation returns valid state only while the persisted tuple matches the current artifact.
func (*Registry) Get ¶
func (r *Registry) Get(name string) (*ExtensionInfo, error)
Get returns one installed extension by name.
func (*Registry) GetContext ¶
GetContext returns one installed extension by name under the caller's context. Callers that run on a bounded budget, such as rollback read-backs, use it so a slow read cannot outlive their deadline.
func (*Registry) GetDevLink ¶
GetDevLink returns one workspace-local overlay row.
func (*Registry) Install ¶
func (r *Registry) Install(manifest *Manifest, path string, checksum string, opts ...InstallOption) error
Install verifies the extension artifact checksum and persists the install as a user-sourced extension.
func (*Registry) Installations ¶
Installations lists persisted attachments, including disabled installations.
func (*Registry) IsEnabledForProfile ¶
IsEnabledForProfile returns the effective state for one installed or dev-linked extension. Enablement rows are exceptions: an absent row means enabled.
func (*Registry) LinkDev ¶
func (r *Registry) LinkDev(req DevLinkRequest) (*DevLink, error)
LinkDev upserts one workspace-local overlay without modifying a published row.
func (*Registry) List ¶
func (r *Registry) List() (extensions []ExtensionInfo, err error)
List returns every installed extension ordered by name.
func (*Registry) ListDevLinks ¶
ListDevLinks returns every dev overlay in stable instance-key order.
func (*Registry) ListTombstones ¶
func (r *Registry) ListTombstones(ctx context.Context) (tombstones []BuiltinTombstone, err error)
ListTombstones returns every tombstone ordered by name.
func (*Registry) PlacementsForProfile ¶
func (r *Registry) PlacementsForProfile( ctx context.Context, profileName string, ) ([]profilepkg.PlacementRef, error)
PlacementsForProfile returns installed manifest resources bound to one profile name.
func (*Registry) ReconcileBundledProvenance ¶
ReconcileBundledProvenance persists the canonical first-party trust evidence for an already installed bundled extension without changing its lifecycle state.
func (*Registry) ResolveActive ¶
func (r *Registry) ResolveActive(name, workspaceID string) (*ActiveExtension, error)
ResolveActive prefers a workspace dev overlay and falls back to the published row.
func (*Registry) ResolveInstallation ¶
func (r *Registry) ResolveInstallation( ctx context.Context, name string, scope InstallationScope, ) (Installation, error)
ResolveInstallation selects a workspace attachment before an inherited global attachment, then the exact profile before an all-profiles attachment.
func (*Registry) RestoreBuiltinTombstone ¶
func (r *Registry) RestoreBuiltinTombstone(ctx context.Context, tombstone BuiltinTombstone) error
RestoreBuiltinTombstone writes a tombstone back exactly as it was read, including its original removal time and actor. Restore uses it when enrollment fails after the tombstone was cleared.
func (*Registry) RestoreGatewayConfirmation ¶
func (r *Registry) RestoreGatewayConfirmation(key InstanceKey, confirmation GatewayConfirmation) error
RestoreGatewayConfirmation restores a previously snapshotted confirmation tuple during lifecycle rollback. The caller must hold the lifecycle authority for the extension name.
func (*Registry) RestoreRemovalState ¶
func (r *Registry) RestoreRemovalState(ctx context.Context, name string, snapshot RemovalState) error
RestoreRemovalState restores profile records atomically before runtime publication resumes.
func (*Registry) SetEnabledForProfile ¶
SetEnabledForProfile persists only disabled exceptions; enabling removes the row.
func (*Registry) SnapshotRemovalState ¶
SnapshotRemovalState captures dependent profile records before uninstall.
func (*Registry) Tombstone ¶
func (r *Registry) Tombstone(ctx context.Context, name string, removedBy string) (BuiltinTombstone, error)
Tombstone records name as permanently removed. The name is stored trimmed. Permanent removal does not use this method: it writes the tombstone inside the row-delete transaction.
func (*Registry) Tombstoned ¶
Tombstoned reports whether a tombstone exists for name.
type RegistryOption ¶
type RegistryOption func(*Registry)
RegistryOption configures the database pools owned by the composition root.
func WithRegistryReadDB ¶
func WithRegistryReadDB(db *sql.DB) RegistryOption
WithRegistryReadDB keeps catalog reads independent of the write connection.
type RemovalRegistry ¶
type RemovalRegistry interface {
LifecycleRegistry
SnapshotRemovalState(context.Context, string) (RemovalState, error)
RestoreRemovalState(context.Context, string, RemovalState) error
}
RemovalRegistry includes profile records needed to compensate an uninstall.
type RemovalState ¶
type RemovalState struct {
// contains filtered or unexported fields
}
RemovalState retains profile-owned records deleted by extension removal cascades.
type ResolvedManifestMCPServer ¶
type ResolvedManifestMCPServer struct {
compozyconfig.MCPServer
DefaultScope string
}
ResolvedManifestMCPServer keeps the install default separate from runtime transport configuration.
func ResolveManifestMCPServerResources ¶
func ResolveManifestMCPServerResources( rootDir string, manifest *Manifest, state InputState, getenv func(string) string, ) ([]ResolvedManifestMCPServer, error)
ResolveManifestMCPServerResources converts manifest MCP declarations into MCP server specs.
type ResourceGrantRequest ¶
type ResourceGrantRequest struct {
Families []string `toml:"families,omitempty" json:"families,omitempty"`
MaxScope resources.ResourceScopeKind `toml:"max_scope,omitempty" json:"max_scope,omitempty"`
}
ResourceGrantRequest declares the resource families and scope ceiling an extension requests.
type ResourcesConfig ¶
type ResourcesConfig struct {
Skills []ManifestResourcePath `toml:"skills,omitempty" json:"skills,omitempty"`
Loops []ManifestResourcePath `toml:"loops,omitempty" json:"loops,omitempty"`
Agents []ManifestResourcePath `toml:"agents,omitempty" json:"agents,omitempty"`
Automation []ManifestResourcePath `toml:"automation,omitempty" json:"automation,omitempty"`
Layouts []ManifestResourcePath `toml:"layouts,omitempty" json:"layouts,omitempty"`
Hooks []HookConfig `toml:"hooks,omitempty" json:"hooks,omitempty"`
Tools map[string]ToolConfig `toml:"tools,omitempty" json:"tools,omitempty"`
CommandGroups []manifestCommandGroupSpec `toml:"command_groups,omitempty" json:"command_groups,omitempty"`
CmdPalette CmdPaletteConfig `toml:"cmd_palette,omitempty" json:"cmd_palette,omitzero"`
MCPServers map[string]MCPServerConfig `toml:"mcp_servers,omitempty" json:"mcp_servers,omitempty"`
Publish ResourceGrantRequest `toml:"publish,omitempty" json:"publish"`
}
ResourcesConfig declares static assets packaged with an extension.
type ScaffoldRequest ¶
type ScaffoldRequest struct {
Name string
Template ScaffoldTemplate
Directory string
}
ScaffoldRequest configures one extension project created from embedded assets.
type ScaffoldResult ¶
type ScaffoldResult struct {
Name string `json:"name"`
Template ScaffoldTemplate `json:"template"`
Directory string `json:"directory"`
Files []string `json:"files"`
}
ScaffoldResult describes the created project.
func ScaffoldExtension ¶
func ScaffoldExtension(req ScaffoldRequest) (result *ScaffoldResult, resultErr error)
ScaffoldExtension creates a project atomically from the binary's embedded templates.
type ScaffoldTemplate ¶
type ScaffoldTemplate string
ScaffoldTemplate identifies one embedded extension authoring template.
const ( ScaffoldTemplateToolProviderTS ScaffoldTemplate = "tool-provider-ts" ScaffoldTemplateToolProviderGo ScaffoldTemplate = "tool-provider-go" ScaffoldTemplateViewProviderTS ScaffoldTemplate = "view-provider-ts" // #nosec G101 -- this public scaffold identifier is not a credential. ScaffoldTemplateHeartbeatSourceGo ScaffoldTemplate = "heartbeat-source-go" // #nosec G101 -- this public scaffold identifier is not a credential. ScaffoldTemplateLoopWatchSourceGo ScaffoldTemplate = "loop-watch-source-go" ScaffoldTemplateConnectivityProviderGo ScaffoldTemplate = "connectivity-provider-go" ScaffoldTemplateConnectivityProviderTS ScaffoldTemplate = "connectivity-provider-ts" )
func ScaffoldTemplates ¶
func ScaffoldTemplates() []ScaffoldTemplate
ScaffoldTemplates returns every supported template in stable order.
type SecretRefResolver ¶
SecretRefResolver resolves env: and vault: refs for extension launch bindings.
type SourceChangedError ¶
SourceChangedError identifies an approved acquisition that no longer matches its source or bytes.
func (*SourceChangedError) Error ¶
func (e *SourceChangedError) Error() string
func (*SourceChangedError) Is ¶
func (e *SourceChangedError) Is(target error) bool
func (*SourceChangedError) Unwrap ¶
func (e *SourceChangedError) Unwrap() error
type StaticAgent ¶
type StaticAgent struct {
Agent compozyconfig.AgentDef
Soul *AgentSidecar
Heartbeat *AgentSidecar
}
StaticAgent is one complete agent directory shipped by an extension.
func LoadAgentResources ¶
func LoadAgentResources(rootDir string, paths []string) ([]StaticAgent, error)
LoadAgentResources loads the strict <entry>/<agent>/AGENT.md resource contract.
type SubprocessConfig ¶
type SubprocessConfig struct {
Command string `toml:"command,omitempty" json:"command,omitempty"`
Args []string `toml:"args,omitempty" json:"args,omitempty"`
Env map[string]string `toml:"env,omitempty" json:"env,omitempty"`
SecretEnv map[string]string `toml:"secret_env,omitempty" json:"secret_env,omitempty"`
HealthCheckInterval Duration `toml:"health_check_interval,omitempty" json:"health_check_interval,omitempty"`
ShutdownTimeout Duration `toml:"shutdown_timeout,omitempty" json:"shutdown_timeout,omitempty"`
}
SubprocessConfig describes how to launch and monitor the extension process.
type ToolBackendConfig ¶
type ToolBackendConfig struct {
Kind string `toml:"kind,omitempty" json:"kind,omitempty"`
Handler string `toml:"handler,omitempty" json:"handler,omitempty"`
Server string `toml:"server,omitempty" json:"server,omitempty"`
Tool string `toml:"tool,omitempty" json:"tool,omitempty"`
}
ToolBackendConfig binds a manifest tool to its backend metadata.
type ToolConfig ¶
type ToolConfig struct {
Profile string `toml:"profile,omitempty" json:"profile,omitempty"`
ID string `toml:"id,omitempty" json:"id,omitempty"`
DisplayTitle string `toml:"display_title,omitempty" json:"display_title,omitempty"`
FriendlyVerb string `toml:"friendly_verb,omitempty" json:"friendly_verb,omitempty"`
Preview string `toml:"preview,omitempty" json:"preview,omitempty"`
Description string `toml:"description,omitempty" json:"description,omitempty"`
Handler string `toml:"handler,omitempty" json:"handler,omitempty"`
Backend ToolBackendConfig `toml:"backend,omitempty" json:"backend"`
InputSchema json.RawMessage `toml:"input_schema,omitempty" json:"input_schema,omitempty"`
OutputSchema json.RawMessage `toml:"output_schema,omitempty" json:"output_schema,omitempty"`
Risk string `toml:"risk,omitempty" json:"risk,omitempty"`
ReadOnly bool `toml:"read_only,omitempty" json:"read_only,omitzero"`
Destructive bool `toml:"destructive,omitempty" json:"destructive,omitzero"`
OpenWorld bool `toml:"open_world,omitempty" json:"open_world,omitzero"`
RequiresInteraction bool `toml:"requires_interaction,omitempty" json:"requires_interaction,omitzero"`
ConcurrencySafe bool `toml:"concurrency_safe,omitempty" json:"concurrency_safe,omitzero"`
MaxResultBytes int64 `toml:"max_result_bytes,omitempty" json:"max_result_bytes,omitzero"`
Toolsets []string `toml:"toolsets,omitempty" json:"toolsets,omitempty"`
Tags []string `toml:"tags,omitempty" json:"tags,omitempty"`
SearchHints []string `toml:"search_hints,omitempty" json:"search_hints,omitempty"`
RequiresEnv []string `toml:"requires_env,omitempty" json:"requires_env,omitempty"`
RequiredCapabilities []string `toml:"required_capabilities,omitempty" json:"required_capabilities,omitempty"`
Visibility string `toml:"visibility,omitempty" json:"visibility,omitempty"`
Command *manifestCommandSpec `toml:"command,omitempty" json:"command,omitzero"`
}
ToolConfig declares one static tool packaged with the extension.
func (*ToolConfig) UnmarshalTOML ¶
func (c *ToolConfig) UnmarshalTOML(value any) error
UnmarshalTOML preserves JSON Schema objects inside a TOML tool table.
type ValidationIssue ¶
type ValidationIssue = extensioncontract.ValidationIssue
ValidationIssue is one positioned extension validation diagnostic.
type ValidationReport ¶
type ValidationReport = apicontract.ExtensionValidatePayload
ValidationReport is the structured daemon-free result shared by CLI and native authoring surfaces.
func ValidateBundleReport ¶
func ValidateBundleReport(dir string, pluginName ...string) (*ValidationReport, error)
ValidateBundleReport adds the permission-derived consent summary to ValidateBundle.
func ValidateBundleReportWithAgentPluginDataDir ¶
func ValidateBundleReportWithAgentPluginDataDir(dir, dataDir string, pluginName ...string) (*ValidationReport, error)
ValidateBundleReportWithAgentPluginDataDir validates against instance-owned plugin data.
type ViewPatchPublisher ¶
type ViewPatchPublisher interface {
PublishViewPatch(
context.Context,
cmdpalette.ProfileLens,
cmdpalette.WorkspaceID,
string,
cmdpalette.ViewPatch,
) error
}
ViewPatchPublisher fans out one declarative command-palette view patch.
Source Files
¶
- agent_plugin_errors.go
- agent_resources.go
- automation_resources.go
- automation_task_clone.go
- build.go
- build_describe.go
- build_generation.go
- build_resource_only.go
- build_resources.go
- build_runner.go
- build_runner_unix.go
- build_toolchain.go
- builtin_permanent_removal.go
- builtin_restore.go
- builtin_tombstone.go
- capability.go
- capability_grants.go
- capability_resource_policy.go
- cmd_palette_manifest_normalize.go
- cmd_palette_manifest_validate.go
- cmd_palette_projection.go
- cmd_palette_visibility.go
- command.go
- command_manifest.go
- command_schema.go
- consent.go
- contents.go
- declared_profiles.go
- describe.go
- describe_inputs.go
- describe_servers.go
- dev.go
- dev_boot_failure.go
- dev_generation.go
- env_bindings.go
- extension_data.go
- extension_validation.go
- forge_discovery.go
- forge_provider.go
- forge_quota.go
- forge_status_validation.go
- gateway_source.go
- gateway_trust.go
- heartbeat_source.go
- host_api.go
- host_api_authored_context.go
- host_api_authored_context_errors.go
- host_api_authored_context_health.go
- host_api_authored_context_heartbeat.go
- host_api_authored_context_payload.go
- host_api_authored_context_session.go
- host_api_automation.go
- host_api_automation_binding.go
- host_api_automation_clone.go
- host_api_automation_lists.go
- host_api_clarify.go
- host_api_contract_types.go
- host_api_decode.go
- host_api_dispatch.go
- host_api_errors.go
- host_api_methods.go
- host_api_models.go
- host_api_observe.go
- host_api_options.go
- host_api_profile_scope.go
- host_api_prompt_projection.go
- host_api_rate_limit.go
- host_api_resources.go
- host_api_scoped.go
- host_api_session_archive_filter.go
- host_api_session_runtime.go
- host_api_session_runtime_projection.go
- host_api_sessions.go
- host_api_skills.go
- host_api_task_dashboard_payload.go
- host_api_task_inbox_payload.go
- host_api_task_payload.go
- host_api_task_payloads.go
- host_api_task_profile_owners.go
- host_api_task_query.go
- host_api_task_request.go
- host_api_task_run_detail.go
- host_api_task_runs.go
- host_api_task_summary.go
- host_api_tasks.go
- host_api_view.go
- host_api_workspace_automation_mapping.go
- host_api_workspace_binding.go
- host_api_workspace_identity.go
- input_state.go
- install_bundled.go
- install_local_preparation.go
- install_managed.go
- install_managed_boundary.go
- install_managed_package.go
- install_managed_path.go
- install_managed_source.go
- install_managed_tree.go
- instance.go
- inventory.go
- layout_resources.go
- lifecycle_events.go
- logs.go
- managed_change.go
- managed_reconcile.go
- manager.go
- manager_clone.go
- manager_connectivity_abort.go
- manager_dev_activation.go
- manager_dev_admission.go
- manager_dev_lifecycle.go
- manager_dev_link_activation.go
- manager_env_resolution.go
- manager_failure_state.go
- manager_hook_declarations.go
- manager_installed_runtime.go
- manager_instance_state.go
- manager_lifecycle.go
- manager_options.go
- manager_package_inspection.go
- manager_pending_cleanup.go
- manager_process_lifecycle.go
- manager_profile_hooks.go
- manager_profile_projection.go
- manager_profile_runtime.go
- manager_resource_helpers.go
- manager_resource_loading.go
- manager_runtime_launch.go
- manager_skill_cache.go
- manager_snapshot_automation.go
- manager_snapshots.go
- manager_startup_transaction.go
- manager_stderr.go
- manager_supervision.go
- manager_views.go
- manager_workspace_profiles.go
- manifest.go
- manifest_agent_plugin.go
- manifest_client_inputs.go
- manifest_compatibility.go
- manifest_encode.go
- manifest_errors.go
- manifest_gateway.go
- manifest_inputs.go
- manifest_load.go
- manifest_load_agent_plugin.go
- manifest_mcp_auth.go
- manifest_normalize.go
- manifest_permissions.go
- manifest_placement_projection.go
- manifest_profiles.go
- manifest_profiles_validate.go
- manifest_resolution.go
- manifest_tool_config.go
- manifest_tool_toml.go
- manifest_tools.go
- manifest_validate.go
- marketplace_artifact.go
- marketplace_helpers.go
- marketplace_inspection.go
- marketplace_install_cleanup.go
- marketplace_install_preparation.go
- marketplace_lifecycle.go
- marketplace_plugin_acquisition.go
- marketplace_reinstall.go
- marketplace_remove.go
- marketplace_remove_cleanup.go
- marketplace_sources.go
- marketplace_trust.go
- marketplace_update.go
- marketplace_update_apply.go
- marketplace_update_batch_error.go
- marketplace_update_cleanup.go
- marketplace_update_commit.go
- marketplace_update_resolution.go
- model_source.go
- model_source_options.go
- name_conflict.go
- profile_visibility.go
- provenance.go
- publish.go
- registry.go
- registry_artifact.go
- registry_bundled.go
- registry_bundled_cache.go
- registry_checksum.go
- registry_errors.go
- registry_gateway.go
- registry_install.go
- registry_installations.go
- registry_lifecycle.go
- registry_profile_placements.go
- registry_removal.go
- registry_scan.go
- registry_superseded.go
- registry_types.go
- resource_grant_strings.go
- resource_inputs.go
- resource_path_security.go
- resource_publication.go
- resource_publication_mcp.go
- resource_validation_error.go
- scaffold.go
- search_errors.go
- semantic_version.go
- source_changed.go
- source_names.go
- static_resources_validation.go
- tool_call_tracking.go
- tool_projection_generation.go
- tool_provider.go
- tool_provider_availability.go
- tool_provider_manifest_cache.go
- tool_provider_manifest_content.go
- tool_provider_manifest_metadata.go
- tool_provider_manifest_metadata_linux.go
- tool_reconciliation.go
- tool_runtime.go
- view_call_gate.go
- view_source.go
- watch_source.go
Directories
¶
| Path | Synopsis |
|---|---|
|
Package agentplugin reads and validates portable Agent Plugins packages.
|
Package agentplugin reads and validates portable Agent Plugins packages. |
|
scaffold_templates
|
|
|
connectivity-provider-go
command
|
|
|
heartbeat-source-go
command
|
|
|
loop-watch-source-go
command
|
|
|
tool-provider-go
command
|
|
|
Package surfaces defines the static extension resource surface policy.
|
Package surfaces defines the static extension resource surface policy. |