Documentation
¶
Index ¶
- Constants
- Variables
- func BindHostAPIWorkspaceParams(ctx context.Context, raw json.RawMessage, binding HostAPIWorkspaceBinding, ...) (json.RawMessage, error)
- func ComputeDirectoryChecksum(path string) (string, error)
- func DescribeExtension(ext *Extension, daemonRunning bool, now time.Time) contract.ExtensionPayload
- func InstallBundledExtension(homePaths compozyconfig.HomePaths, registry *Registry, spec BundledInstallSpec) (err error)
- func InstallLocalManaged(homePaths compozyconfig.HomePaths, registry managedInstallRegistry, ...) (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 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 NetworkParticipationRequirementDigest(req *NetworkParticipationRequirement) (string, error)
- func NewExtensionModelSources(registry *Registry, resolver ModelSourceRuntimeResolver) ([]modelcatalog.Source, error)
- func NewManagedInstallStagingDir(homePaths compozyconfig.HomePaths) (string, error)
- func ReconcileManifestToolRuntime(manifest *ManifestToolDescriptor, ...) toolspkg.Availability
- func RemoveManagedInstall(homePaths compozyconfig.HomePaths, name string) error
- func ResolveManifestMCPServerResources(rootDir string, manifest *Manifest, getenv func(string) string) ([]compozyconfig.MCPServer, error)
- func ResolveManifestToolResources(manifest *Manifest) ([]toolspkg.Tool, error)
- func ValidateBundle(dir string) (*Manifest, []ValidationIssue, error)
- func ValidateManifestForCompozyVersion(manifest *Manifest, currentVersion string) error
- func ValidateUnverifiedSideLoad(slug string, source string, policyAllowsUnverified bool, allowUnverified bool) error
- type ActiveExtension
- type AgentConflictError
- type AgentSidecar
- type BridgeConfig
- type BridgeControlRuntimeResolver
- type BridgeDeliveryNotifier
- func (n *BridgeDeliveryNotifier) OnAgentEvent(ctx context.Context, sessionID string, payload any)
- func (n *BridgeDeliveryNotifier) OnAgentEventForSession(ctx context.Context, sess *session.Session, payload any)
- func (n *BridgeDeliveryNotifier) OnSessionCreated(ctx context.Context, sess *session.Session)
- func (n *BridgeDeliveryNotifier) OnSessionStopped(ctx context.Context, sess *session.Session)
- type BridgeRuntimeResolver
- type BridgeTelemetrySink
- type BuildRequest
- type BuildResult
- 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 CommandDescriptor
- type CommandGroupDescriptor
- type ConnectivityProviderTrustResolver
- type ConsentArea
- 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 ExtensionInfo
- type ExtensionJob
- type ExtensionLogCursor
- type ExtensionLogEntry
- type ExtensionLogRing
- type ExtensionLogSnapshot
- 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) ProjectionGeneration(ctx context.Context, scope toolspkg.Scope) (string, bool)
- 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 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 WithHostAPIBridgeDedupStore(store hostAPIBridgeDedupStore) HostAPIOption
- func WithHostAPIBridgeIngressConfig(dedupTTL time.Duration, cleanupInterval time.Duration) HostAPIOption
- func WithHostAPIBridgeRegistry(registry hostAPIBridgeRegistry) HostAPIOption
- func WithHostAPICapabilityChecker(checker *CapabilityChecker) HostAPIOption
- func WithHostAPIClarify(broker toolspkg.ClarifyBroker) HostAPIOption
- func WithHostAPIDeliveryBroker(broker hostAPIDeliveryBroker) HostAPIOption
- func WithHostAPIHeartbeatAuthoring(service hostAPIHeartbeatAuthoringService) HostAPIOption
- func WithHostAPIHeartbeatStatus(service hostAPIHeartbeatStatusService) HostAPIOption
- func WithHostAPIHeartbeatWake(service hostAPIHeartbeatWakeService) HostAPIOption
- func WithHostAPIHeartbeatWakeEvents(reader hostAPIHeartbeatWakeEventReader) HostAPIOption
- func WithHostAPIMemoryProviderRegistry(registry *MemoryProviderRegistry) HostAPIOption
- func WithHostAPIModelCatalogService(service modelcatalog.Service) HostAPIOption
- func WithHostAPINetworkService(service hostAPINetworkService) HostAPIOption
- func WithHostAPINetworkStore(networkStore store.NetworkConversationStore) HostAPIOption
- func WithHostAPINetworkUsageStore(networkUsage store.NetworkUsageStore) HostAPIOption
- func WithHostAPINow(now func() time.Time) 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 WithHostAPITaskManager(manager hostAPITaskManager) HostAPIOption
- func WithHostAPIWorkspaceResolver(resolver workspacepkg.RuntimeResolver) HostAPIOption
- type HostAPIWorkspaceBinding
- 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 WithInstallSource(source ExtensionSource) InstallOption
- type InstanceKey
- type IssueSeverity
- type KitItem
- type LifecycleEvent
- type LifecycleEventSink
- type LifecycleRegistry
- type MCPServerConfig
- type ManagedRemoveResult
- type Manager
- func (m *Manager) ActivateDevelopmentLink(ctx context.Context, key InstanceKey) (*Extension, error)
- func (m *Manager) AgentDefinitions() []compozyconfig.AgentDef
- func (m *Manager) BridgeTargetSnapshots(ctx context.Context, extensionName string, ...) ([]bridgepkg.BridgeTargetSnapshot, error)
- 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) CheckBridge(ctx context.Context, extensionName string, req bridgepkg.BridgeCheckRequest) (bridgepkg.BridgeCheckResponse, error)
- func (m *Manager) Commands(workspaceID string) ([]CommandDescriptor, []CommandGroupDescriptor, error)
- func (m *Manager) DeliverBridge(ctx context.Context, extensionName string, req bridgepkg.DeliveryRequest) (bridgepkg.DeliveryAck, error)
- func (m *Manager) Get(name string) (*Extension, error)
- func (m *Manager) GetForInstance(key InstanceKey) (*Extension, error)
- func (m *Manager) HookDeclarations(ctx context.Context) ([]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) 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) Poll(ctx context.Context, req watchpkg.PollRequest) (watchpkg.PollResponse, 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) RegisterBridgeWebhook(ctx context.Context, extensionName string, ...) (bridgepkg.BridgeWebhookRegistrationResponse, 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) ResolveConnectivitySource(ctx context.Context, name string) (gateway.ConnectivitySource, 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
- type ManifestCompatibilityError
- type ManifestNotFoundError
- type ManifestToolDescriptor
- type ManifestValidationError
- type MarketplaceDigestVerificationObserver
- type MarketplaceInstallRequest
- type MarketplaceSourceLoader
- type MarketplaceTrustEvidence
- type MarketplaceTrustResolver
- type MarketplaceUpdateBatchError
- type MarketplaceUpdateCommit
- type MarketplaceUpdatePreflight
- type MarketplaceUpdateRequest
- type MarketplaceUpdateResult
- type MemoryProviderCollisionError
- type MemoryProviderNotFoundError
- type MemoryProviderRegistration
- type MemoryProviderRegistry
- func (r *MemoryProviderRegistry) List() []MemoryProviderRegistration
- func (r *MemoryProviderRegistry) Register(ctx context.Context, registration MemoryProviderRegistration) error
- func (r *MemoryProviderRegistry) Select(ctx context.Context, workspaceID string, name string) (MemoryProviderRegistration, error)
- func (r *MemoryProviderRegistry) SetActive(ctx context.Context, workspaceID string, name string) error
- type MemoryProviderRegistryOption
- type ModelSource
- type ModelSourceRuntime
- type ModelSourceRuntimeResolver
- type MutationReload
- type NetworkConfirmation
- type NetworkConfirmationRequiredError
- type NetworkParticipationRequirement
- type Option
- func WithBridgeRuntimeResolver(resolver BridgeRuntimeResolver) Option
- func WithBridgeTelemetrySink(sink BridgeTelemetrySink) 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 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 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 PublishRequest
- type PublishResult
- type Registry
- func (r *Registry) ConfirmDevelopmentNetworkCandidate(key InstanceKey, digest string, actor string, at time.Time) error
- func (r *Registry) ConfirmNetworkRequirement(key InstanceKey, expectedDigest string, actor string, at time.Time) error
- func (r *Registry) DB() *sql.DB
- func (r *Registry) DevLinkNamesForWorkspace(workspaceID string) (names []string, resultErr error)
- func (r *Registry) Disable(name string) error
- func (r *Registry) Enable(name string) error
- func (r *Registry) EnabledBundledNames() ([]string, error)
- func (r *Registry) Get(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) LinkDev(req DevLinkRequest) (*DevLink, error)
- func (r *Registry) List() (extensions []ExtensionInfo, err error)
- func (r *Registry) ListDevLinks() (links []DevLink, resultErr error)
- func (r *Registry) NetworkConfirmation(key InstanceKey) (NetworkConfirmation, error)
- func (r *Registry) ReconcileBundledProvenance(manifest *Manifest) error
- func (r *Registry) ResolveActive(name, workspaceID string) (*ActiveExtension, error)
- func (r *Registry) RestoreNetworkConfirmation(key InstanceKey, confirmation NetworkConfirmation) error
- func (r *Registry) Uninstall(name string) error
- func (r *Registry) UnlinkDev(name, workspaceID string) error
- type ResourceGrantRequest
- type ResourcesConfig
- type ScaffoldRequest
- type ScaffoldResult
- type ScaffoldTemplate
- type SecretRefResolver
- type StaticAgent
- type SubprocessConfig
- type ToolBackendConfig
- type ToolConfig
- type ValidationIssue
- type ValidationReport
Constants ¶
const ( // IssueSeverityError blocks extension use. IssueSeverityError = extensioncontract.IssueSeverityError // IssueSeverityWarning reports non-blocking authoring guidance. IssueSeverityWarning = extensioncontract.IssueSeverityWarning )
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 ( // 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") // ErrBridgeRuntimeResolverRequired reports that a bridge-capable extension cannot start // without a bridge runtime resolver. ErrBridgeRuntimeResolverRequired = errors.New("extension: bridge runtime resolver is required") // ErrPathEscapesExtensionRoot reports that a requested resource path resolves outside the // extension root. ErrPathEscapesExtensionRoot = errors.New("extension: path escapes extension root") // ErrBridgeRuntimeDeferred reports that a bridge-capable extension is // installed and registered, but no enabled bridge instance exists yet for // the runtime launch handshake. ErrBridgeRuntimeDeferred = errors.New("extension: bridge runtime deferred") )
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 ( // ErrMemoryProviderNotFound reports that no registered memory provider matched a lookup. ErrMemoryProviderNotFound = errors.New("extension: memory provider not found") // ErrMemoryProviderCollision reports a deterministic memory provider registration collision. ErrMemoryProviderCollision = errors.New("extension: memory provider collision") )
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 ErrExtensionChecksumUnverified = errors.New("extension: checksum is unverified")
var ErrExtensionNetworkConfirmationRequired = errors.New("extension: network participation confirmation required")
ErrExtensionNetworkConfirmationRequired reports stale consent; NetworkConfirmationRequiredError carries its digest.
var ErrExtensionSearchInvalid = errors.New("extension: invalid search request")
ErrExtensionSearchInvalid reports a malformed source or cursor selection.
ErrMarketplaceSourceUnavailable reports that a marketplace source cannot be resolved or used.
Functions ¶
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 ComputeDirectoryChecksum ¶
ComputeDirectoryChecksum returns a deterministic SHA-256 checksum for an installed extension directory payload.
func DescribeExtension ¶
DescribeExtension projects one extension snapshot into the shared CLI/API payload.
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.
func InstallLocalManaged ¶
func InstallLocalManaged( homePaths compozyconfig.HomePaths, registry managedInstallRegistry, 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.
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 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 NetworkParticipationRequirementDigest ¶
func NetworkParticipationRequirementDigest(req *NetworkParticipationRequirement) (string, error)
NetworkParticipationRequirementDigest returns the canonical digest for one requirement block.
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 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 ResolveManifestMCPServerResources ¶
func ResolveManifestMCPServerResources( rootDir string, manifest *Manifest, getenv func(string) string, ) ([]compozyconfig.MCPServer, error)
ResolveManifestMCPServerResources converts manifest MCP declarations into MCP server specs.
func ResolveManifestToolResources ¶
ResolveManifestToolResources converts manifest tool declarations into tool specs.
func ValidateBundle ¶
func ValidateBundle(dir string) (*Manifest, []ValidationIssue, error)
ValidateBundle validates a built or resource-only extension archive without executing extension code.
func ValidateManifestForCompozyVersion ¶
ValidateManifestForCompozyVersion checks a manifest against an explicitly stamped daemon version.
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 AgentSidecar ¶
AgentSidecar is one validated authored-context file shipped beside an agent.
type BridgeConfig ¶
type BridgeConfig struct {
Platform string `toml:"platform,omitempty" json:"platform,omitempty"`
DisplayName string `toml:"display_name,omitempty" json:"display_name,omitempty"`
SecretSlots []bridgepkg.BridgeSecretSlot `toml:"secret_slots,omitempty" json:"secret_slots,omitempty"`
ConfigSchema *bridgepkg.BridgeProviderConfigSchema `toml:"config_schema,omitempty" json:"config_schema,omitempty"`
}
BridgeConfig declares provider metadata for bridge-capable extensions.
type BridgeControlRuntimeResolver ¶
type BridgeControlRuntimeResolver interface {
ResolveBridgeControlRuntime(
ctx context.Context,
extensionName string,
bridgeInstanceID string,
method bridgepkg.ControlMethod,
) (*subprocess.InitializeBridgeRuntime, error)
}
BridgeControlRuntimeResolver resolves one fresh, single-instance control grant.
type BridgeDeliveryNotifier ¶
type BridgeDeliveryNotifier struct {
// contains filtered or unexported fields
}
BridgeDeliveryNotifier projects prompt-time ACP events into the bridge delivery broker while preserving an optional downstream notifier chain.
func NewBridgeDeliveryNotifier ¶
func NewBridgeDeliveryNotifier(broker *bridgepkg.Broker, downstream session.Notifier) *BridgeDeliveryNotifier
NewBridgeDeliveryNotifier wraps the provided downstream notifier with session-to-bridge delivery projection.
func (*BridgeDeliveryNotifier) OnAgentEvent ¶
func (n *BridgeDeliveryNotifier) OnAgentEvent(ctx context.Context, sessionID string, payload any)
OnAgentEvent projects ACP runtime output into the delivery broker before forwarding.
func (*BridgeDeliveryNotifier) OnAgentEventForSession ¶
func (n *BridgeDeliveryNotifier) OnAgentEventForSession( ctx context.Context, sess *session.Session, payload any, )
OnAgentEventForSession preserves the richer session-aware notifier path when the downstream chain supports it.
func (*BridgeDeliveryNotifier) OnSessionCreated ¶
func (n *BridgeDeliveryNotifier) OnSessionCreated(ctx context.Context, sess *session.Session)
OnSessionCreated forwards the lifecycle callback unchanged.
func (*BridgeDeliveryNotifier) OnSessionStopped ¶
func (n *BridgeDeliveryNotifier) OnSessionStopped(ctx context.Context, sess *session.Session)
OnSessionStopped fails unfinished bridge deliveries before forwarding the lifecycle callback.
type BridgeRuntimeResolver ¶
type BridgeRuntimeResolver interface {
ResolveBridgeRuntime(ctx context.Context, extensionName string) (*subprocess.InitializeBridgeRuntime, error)
}
BridgeRuntimeResolver resolves one provider-scoped bridge launch payload for a bridge-capable extension session.
type BridgeTelemetrySink ¶
type BridgeTelemetrySink interface {
RecordBridgeAuthFailure(bridgeInstanceID string)
RecordBridgeRuntimeIssue(bridgeInstanceID string, status bridgepkg.BridgeStatus, message string)
ClearBridgeRuntimeIssue(bridgeInstanceID string)
}
BridgeTelemetrySink records live bridge runtime/auth telemetry for per-instance observability surfaces.
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.
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 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 DevLink ¶
type DevLink struct {
ExtensionName string
WorkspaceID string
OriginPath string
BundleGeneration string
LinkedAt time.Time
NetworkRequirementDigest string
NetworkConfirmedBy string
NetworkConfirmedAt time.Time
}
DevLink is one workspace-local overlay row.
type DevLinkRequest ¶
type DevLinkRequest struct {
Name string
WorkspaceID string
OriginPath string
GenerationHash string
NetworkRequirementDigest string
}
DevLinkRequest identifies one immutable workspace-local extension generation.
type DevelopmentGeneration ¶
type DevelopmentGeneration struct {
Name string
OriginPath string
GenerationHash string
NetworkRequirementDigest string
}
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 ExtensionInfo ¶
type ExtensionInfo struct {
Name string
Version string
Source ExtensionSource
Enabled bool
ManifestPath string
InstalledAt time.Time
Capabilities CapabilitiesConfig
Permissions PermissionsConfig
Checksum string
RegistrySlug *string
RegistryName *string
RemoteVersion *string
Provenance ExtensionProvenance
NetworkRequirementDigest string
NetworkConfirmedBy string
NetworkConfirmedAt time.Time
}
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.
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 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 {
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) 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) 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.
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 HookConfig ¶
type HookConfig struct {
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,omitempty"`
Priority *int `toml:"priority,omitempty" json:"priority,omitempty"`
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,omitempty"`
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"`
Channel string `toml:"channel,omitempty" json:"channel,omitempty"`
Surface string `toml:"surface,omitempty" json:"surface,omitempty"`
Kind string `toml:"kind,omitempty" json:"kind,omitempty"`
Direction string `toml:"direction,omitempty" json:"direction,omitempty"`
WorkState string `toml:"work_state,omitempty" json:"work_state,omitempty"`
CompactionReason string `toml:"compaction_reason,omitempty" json:"compaction_reason,omitempty"`
CompactionStrategy string `toml:"compaction_strategy,omitempty" json:"compaction_strategy,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, memoryStore *memory.Store, 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 WithHostAPIBridgeDedupStore ¶
func WithHostAPIBridgeDedupStore(store hostAPIBridgeDedupStore) HostAPIOption
WithHostAPIBridgeDedupStore injects the dedup persistence used by inbound bridge ingest.
func WithHostAPIBridgeIngressConfig ¶
func WithHostAPIBridgeIngressConfig(dedupTTL time.Duration, cleanupInterval time.Duration) HostAPIOption
WithHostAPIBridgeIngressConfig overrides dedup TTL and cleanup cadence for bridge ingest.
func WithHostAPIBridgeRegistry ¶
func WithHostAPIBridgeRegistry(registry hostAPIBridgeRegistry) HostAPIOption
WithHostAPIBridgeRegistry injects the bridge registry used by bridge 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 WithHostAPIDeliveryBroker ¶
func WithHostAPIDeliveryBroker(broker hostAPIDeliveryBroker) HostAPIOption
WithHostAPIDeliveryBroker injects the session-to-bridge delivery projection broker.
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 WithHostAPIMemoryProviderRegistry ¶
func WithHostAPIMemoryProviderRegistry(registry *MemoryProviderRegistry) HostAPIOption
WithHostAPIMemoryProviderRegistry injects MemoryProvider registration state.
func WithHostAPIModelCatalogService ¶
func WithHostAPIModelCatalogService(service modelcatalog.Service) HostAPIOption
WithHostAPIModelCatalogService injects daemon-owned model catalog projections.
func WithHostAPINetworkService ¶
func WithHostAPINetworkService(service hostAPINetworkService) HostAPIOption
WithHostAPINetworkService injects the network runtime used by network Host API methods.
func WithHostAPINetworkStore ¶
func WithHostAPINetworkStore(networkStore store.NetworkConversationStore) HostAPIOption
WithHostAPINetworkStore injects the durable conversation store used by network Host API methods.
func WithHostAPINetworkUsageStore ¶
func WithHostAPINetworkUsageStore(networkUsage store.NetworkUsageStore) HostAPIOption
WithHostAPINetworkUsageStore injects the bounded Network usage reader.
func WithHostAPINow ¶
func WithHostAPINow(now func() time.Time) HostAPIOption
WithHostAPINow overrides the handler clock, mainly for tests.
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 WithHostAPITaskManager ¶
func WithHostAPITaskManager(manager hostAPITaskManager) HostAPIOption
WithHostAPITaskManager injects the task manager used for task Host API methods.
func WithHostAPIWorkspaceResolver ¶
func WithHostAPIWorkspaceResolver(resolver workspacepkg.RuntimeResolver) HostAPIOption
WithHostAPIWorkspaceResolver injects workspace resolution for workspace-scoped Host API methods.
type HostAPIWorkspaceBinding ¶
type HostAPIWorkspaceBinding uint8
HostAPIWorkspaceBinding identifies how a workspace-bound Host API call is constrained.
const ( HostAPIWorkspaceBindingNone HostAPIWorkspaceBinding = iota HostAPIWorkspaceBindingActor HostAPIWorkspaceBindingPath HostAPIWorkspaceBindingID HostAPIWorkspaceBindingTask HostAPIWorkspaceBindingMemory HostAPIWorkspaceBindingAutomation HostAPIWorkspaceBindingResource )
func HostAPIWorkspaceBindingFor ¶
func HostAPIWorkspaceBindingFor(method extensionprotocol.HostAPIMethod) (HostAPIWorkspaceBinding, bool)
HostAPIWorkspaceBindingFor returns the canonical workspace-binding decision for one Host API method.
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 WithInstallSource ¶
func WithInstallSource(source ExtensionSource) InstallOption
WithInstallSource overrides the persisted source tier for one install.
type InstanceKey ¶
type InstanceKey struct {
Name string `json:"name"`
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 (InstanceKey) IsGlobal ¶
func (k InstanceKey) IsGlobal() bool
IsGlobal reports whether the key identifies the published global instance.
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 {
Type string
ExtensionName string
SourceKind string
DigestMatched bool
WorkspaceID string
ExtensionGeneration string
Digest string
ConfirmedBy string
BoundCount *int
AutomationCount *int
}
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
RestoreNetworkConfirmation(InstanceKey, NetworkConfirmation) error
}
LifecycleRegistry is the installed-extension persistence surface required by managed lifecycle helpers.
type MCPServerConfig ¶
type MCPServerConfig struct {
Command string `toml:"command" json:"command"`
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"`
}
MCPServerConfig declares one MCP server packaged with the extension.
type ManagedRemoveResult ¶
type ManagedRemoveResult struct {
Name string `json:"name"`
Path string `json:"path"`
Status string `json:"status"`
Warnings []diagnosticcontract.DiagnosticItem `json:"warnings,omitempty"`
}
ManagedRemoveResult describes one removed managed extension.
func RemoveManagedExtension ¶
func RemoveManagedExtension( ctx context.Context, registry LifecycleRegistry, name string, reload MutationReload, ) (_ ManagedRemoveResult, err error)
RemoveManagedExtension removes one installed extension and rolls back the registry and on-disk state if the caller's reload hook 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 network requirement is already confirmed.
func (*Manager) AgentDefinitions ¶
func (m *Manager) AgentDefinitions() []compozyconfig.AgentDef
AgentDefinitions returns the currently registered extension agent definitions.
func (*Manager) BridgeTargetSnapshots ¶
func (m *Manager) BridgeTargetSnapshots( ctx context.Context, extensionName string, req bridgepkg.BridgeTargetSnapshotRequest, ) ([]bridgepkg.BridgeTargetSnapshot, error)
BridgeTargetSnapshots calls the negotiated bridge target snapshot service on the named bridge-capable extension runtime.
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) CheckBridge ¶
func (m *Manager) CheckBridge( ctx context.Context, extensionName string, req bridgepkg.BridgeCheckRequest, ) (bridgepkg.BridgeCheckResponse, error)
CheckBridge runs provider checks in one isolated, short-lived extension process.
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) DeliverBridge ¶
func (m *Manager) DeliverBridge( ctx context.Context, extensionName string, req bridgepkg.DeliveryRequest, ) (bridgepkg.DeliveryAck, error)
DeliverBridge calls the negotiated `bridges/deliver` service on the named bridge-capable extension runtime.
func (*Manager) GetForInstance ¶
func (m *Manager) GetForInstance(key InstanceKey) (*Extension, error)
GetForInstance resolves a workspace dev overlay before the global published instance.
func (*Manager) HookDeclarations ¶
HookDeclarations returns the manifest-declared hook resources from loaded extensions.
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) 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) 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) 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) RegisterBridgeWebhook ¶
func (m *Manager) RegisterBridgeWebhook( ctx context.Context, extensionName string, req bridgepkg.BridgeWebhookRegistrationRequest, ) (bridgepkg.BridgeWebhookRegistrationResponse, error)
RegisterBridgeWebhook asks the adapter to register its configured webhook in an isolated process.
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) 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) 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 {
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"`
RequiresEnv []string `toml:"requires_env,omitempty" json:"requires_env,omitempty"`
NetworkParticipation *manifestNetworkRequirement `toml:"network_participation,omitempty" json:"network_participation,omitempty"`
Resources ResourcesConfig `toml:"resources" json:"resources"`
Capabilities CapabilitiesConfig `toml:"capabilities" json:"capabilities"`
Permissions PermissionsConfig `toml:"permissions" json:"permissions"`
Subprocess SubprocessConfig `toml:"subprocess" json:"subprocess"`
Bridge BridgeConfig `toml:"bridge" json:"bridge"`
}
Manifest describes one extension without executing any extension code.
func LoadManifest ¶
LoadManifest reads one extension manifest from dir, preferring TOML over JSON.
func (*Manifest) MissingEnv ¶
MissingEnv returns manifest-required environment variable names that are unset or empty.
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 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 ManifestToolDescriptor ¶
type ManifestToolDescriptor struct {
Name 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 {
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 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 reports a failed target after earlier batch results became externally visible. Completed is a stable snapshot of those results so callers can emit lifecycle events and report partial progress.
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
ArtifactHTTPClient *http.Client
ObserveDigestVerification MarketplaceDigestVerificationObserver
PreflightCandidate MarketplaceUpdatePreflight
CommitCandidate MarketplaceUpdateCommit
// 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,omitempty"`
}
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 MemoryProviderCollisionError ¶
type MemoryProviderCollisionError struct {
Name string
ExistingExtension string
IncomingExtension string
Reason string
ToolName string
}
MemoryProviderCollisionError describes a rejected provider registration.
func (*MemoryProviderCollisionError) Error ¶
func (e *MemoryProviderCollisionError) Error() string
Error returns the provider collision message.
func (*MemoryProviderCollisionError) Is ¶
func (e *MemoryProviderCollisionError) Is(target error) bool
Is matches sentinel errors for provider collisions.
type MemoryProviderNotFoundError ¶
type MemoryProviderNotFoundError struct {
Name string
}
MemoryProviderNotFoundError describes a missing provider lookup.
func (*MemoryProviderNotFoundError) Error ¶
func (e *MemoryProviderNotFoundError) Error() string
Error returns the provider lookup message.
func (*MemoryProviderNotFoundError) Is ¶
func (e *MemoryProviderNotFoundError) Is(target error) bool
Is matches sentinel errors for missing providers.
type MemoryProviderRegistration ¶
type MemoryProviderRegistration struct {
Name string
Version string
ExtensionName string
Provider memcontract.MemoryProvider
ToolNames []string
Bundled bool
}
MemoryProviderRegistration describes one registered memory provider implementation.
type MemoryProviderRegistry ¶
type MemoryProviderRegistry struct {
// contains filtered or unexported fields
}
MemoryProviderRegistry owns MemoryProvider registration and workspace selection.
func NewMemoryProviderRegistry ¶
func NewMemoryProviderRegistry(opts ...MemoryProviderRegistryOption) *MemoryProviderRegistry
NewMemoryProviderRegistry constructs an in-memory provider registry.
func (*MemoryProviderRegistry) List ¶
func (r *MemoryProviderRegistry) List() []MemoryProviderRegistration
List returns registered providers ordered by canonical name.
func (*MemoryProviderRegistry) Register ¶
func (r *MemoryProviderRegistry) Register(ctx context.Context, registration MemoryProviderRegistration) error
Register adds one provider unless its name or tool names collide.
func (*MemoryProviderRegistry) Select ¶
func (r *MemoryProviderRegistry) Select( ctx context.Context, workspaceID string, name string, ) (MemoryProviderRegistration, error)
Select returns the requested provider, or the active/default provider for a workspace.
type MemoryProviderRegistryOption ¶
type MemoryProviderRegistryOption func(*MemoryProviderRegistry)
MemoryProviderRegistryOption customizes MemoryProviderRegistry.
func WithMemoryProviderEventSummaryStore ¶
func WithMemoryProviderEventSummaryStore(writer memoryProviderEventWriter) MemoryProviderRegistryOption
WithMemoryProviderEventSummaryStore records provider collisions into observability.
func WithMemoryProviderRegistryClock ¶
func WithMemoryProviderRegistryClock(now func() time.Time) MemoryProviderRegistryOption
WithMemoryProviderRegistryClock injects a deterministic event timestamp.
func WithMemoryProviderReservedTools ¶
func WithMemoryProviderReservedTools(names ...string) MemoryProviderRegistryOption
WithMemoryProviderReservedTools reserves built-in tool names against provider claims.
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) 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.
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 NetworkConfirmation ¶
NetworkConfirmation is the confirmation tuple for one exact extension instance.
type NetworkConfirmationRequiredError ¶
type NetworkConfirmationRequiredError struct {
CurrentDigest string
}
NetworkConfirmationRequiredError carries the current digest the caller must confirm.
func (*NetworkConfirmationRequiredError) Error ¶
func (e *NetworkConfirmationRequiredError) Error() string
func (*NetworkConfirmationRequiredError) Unwrap ¶
func (e *NetworkConfirmationRequiredError) Unwrap() error
type NetworkParticipationRequirement ¶
type NetworkParticipationRequirement struct {
Required bool `toml:"required" json:"required"`
Mode string `toml:"mode" json:"mode"`
ChannelScopes []string `toml:"channel_scopes,omitempty" json:"channel_scopes,omitempty"`
}
NetworkParticipationRequirement is the typed Live requirement declared on an extension manifest.
func (*NetworkParticipationRequirement) Normalize ¶
func (r *NetworkParticipationRequirement) Normalize() *NetworkParticipationRequirement
func (*NetworkParticipationRequirement) Validate ¶
func (r *NetworkParticipationRequirement) Validate(field string) error
type Option ¶
type Option func(*Manager)
Option customizes an extension manager.
func WithBridgeRuntimeResolver ¶
func WithBridgeRuntimeResolver(resolver BridgeRuntimeResolver) Option
WithBridgeRuntimeResolver injects the bridge launch material resolver used for bridge-capable extension sessions.
func WithBridgeTelemetrySink ¶
func WithBridgeTelemetrySink(sink BridgeTelemetrySink) Option
WithBridgeTelemetrySink injects the sink used to publish per-instance runtime degradation/error signals into observability surfaces.
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 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 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 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 Registry ¶
type Registry struct {
// contains filtered or unexported fields
}
Registry persists installed extension metadata in the global SQLite database.
func NewRegistry ¶
NewRegistry constructs a registry over an existing SQLite connection.
func (*Registry) ConfirmDevelopmentNetworkCandidate ¶
func (r *Registry) ConfirmDevelopmentNetworkCandidate( key InstanceKey, digest string, actor string, at time.Time, ) error
ConfirmDevelopmentNetworkCandidate 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) ConfirmNetworkRequirement ¶
func (r *Registry) ConfirmNetworkRequirement( key InstanceKey, expectedDigest string, actor string, at time.Time, ) error
ConfirmNetworkRequirement 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) DevLinkNamesForWorkspace ¶
DevLinkNamesForWorkspace returns the development source owners trusted by one workspace.
func (*Registry) EnabledBundledNames ¶
EnabledBundledNames returns a cached snapshot of enabled bundled extension names.
func (*Registry) Get ¶
func (r *Registry) Get(name string) (*ExtensionInfo, error)
Get returns one installed extension by name.
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) 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) NetworkConfirmation ¶
func (r *Registry) NetworkConfirmation(key InstanceKey) (NetworkConfirmation, error)
NetworkConfirmation returns valid state only while the persisted tuple matches the current artifact.
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) RestoreNetworkConfirmation ¶
func (r *Registry) RestoreNetworkConfirmation(key InstanceKey, confirmation NetworkConfirmation) error
RestoreNetworkConfirmation restores a previously snapshotted confirmation tuple during lifecycle rollback. The caller must hold the lifecycle authority for the extension name.
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 []string `toml:"skills,omitempty" json:"skills,omitempty"`
Loops []string `toml:"loops,omitempty" json:"loops,omitempty"`
Agents []string `toml:"agents,omitempty" json:"agents,omitempty"`
Automation []string `toml:"automation,omitempty" json:"automation,omitempty"`
Layouts []string `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"`
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" ScaffoldTemplateHookTS ScaffoldTemplate = "hook-ts" ScaffoldTemplateMemoryBackendTS ScaffoldTemplate = "memory-backend-ts" // #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 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 {
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,omitempty"`
Destructive bool `toml:"destructive,omitempty" json:"destructive,omitempty"`
OpenWorld bool `toml:"open_world,omitempty" json:"open_world,omitempty"`
RequiresInteraction bool `toml:"requires_interaction,omitempty" json:"requires_interaction,omitempty"`
ConcurrencySafe bool `toml:"concurrency_safe,omitempty" json:"concurrency_safe,omitempty"`
MaxResultBytes int64 `toml:"max_result_bytes,omitempty" json:"max_result_bytes,omitempty"`
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,omitempty"`
}
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) (*ValidationReport, error)
ValidateBundleReport adds the permission-derived consent summary to ValidateBundle.
Source Files
¶
- agent_resources.go
- automation_resources.go
- automation_task_clone.go
- bridge_contract.go
- bridge_control.go
- bridge_control_gate.go
- bridge_control_launch.go
- bridge_control_lifecycle.go
- bridge_delivery_notifier.go
- bridge_delivery_projection.go
- bridge_ingress_context.go
- build.go
- build_describe.go
- build_generation.go
- build_resources.go
- build_runner.go
- build_runner_unix.go
- build_toolchain.go
- capability.go
- capability_grants.go
- capability_resource_policy.go
- command.go
- command_manifest.go
- command_schema.go
- consent.go
- describe.go
- dev.go
- dev_boot_failure.go
- dev_generation.go
- env_bindings.go
- extension_validation.go
- gateway_source.go
- gateway_trust.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_bridges.go
- host_api_bridges_authorization.go
- host_api_bridges_delivery_contract.go
- host_api_bridges_errors.go
- host_api_bridges_lock.go
- host_api_bridges_prompt.go
- host_api_bridges_prompt_delivery.go
- host_api_bridges_prompt_session.go
- host_api_bridges_routing.go
- host_api_bridges_session.go
- host_api_clarify.go
- host_api_contract_types.go
- host_api_decode.go
- host_api_dispatch.go
- host_api_errors.go
- host_api_memory.go
- host_api_memory_document.go
- host_api_memory_recall.go
- host_api_methods.go
- host_api_models.go
- host_api_network.go
- host_api_network_clone.go
- host_api_network_conversation_payload.go
- host_api_network_pagination.go
- host_api_network_participation.go
- host_api_network_resolution.go
- host_api_network_send.go
- host_api_network_status_payload.go
- host_api_network_usage.go
- host_api_options.go
- host_api_prompt_projection.go
- host_api_rate_limit.go
- host_api_resources.go
- host_api_sandbox.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_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_workspace_automation_mapping.go
- host_api_workspace_binding.go
- host_api_workspace_identity.go
- install_bundled.go
- install_managed.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
- manager.go
- manager_bridge_delivery.go
- manager_bridge_resources.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_instance_state.go
- manager_lifecycle.go
- manager_options.go
- manager_package_inspection.go
- manager_pending_cleanup.go
- manager_process_lifecycle.go
- manager_resource_loading.go
- manager_runtime_launch.go
- manager_snapshot_automation.go
- manager_snapshots.go
- manager_startup_transaction.go
- manager_stderr.go
- manager_supervision.go
- manager_views.go
- manifest.go
- manifest_compatibility.go
- manifest_encode.go
- manifest_errors.go
- manifest_load.go
- manifest_network_participation.go
- manifest_normalize.go
- manifest_permissions.go
- manifest_resolution.go
- manifest_tool_config.go
- manifest_tool_toml.go
- manifest_tools.go
- marketplace_artifact.go
- marketplace_helpers.go
- marketplace_install_cleanup.go
- marketplace_lifecycle.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
- memory_provider_registry.go
- model_source.go
- provenance.go
- publish.go
- registry.go
- registry_artifact.go
- registry_bundled.go
- registry_bundled_cache.go
- registry_checksum.go
- registry_errors.go
- registry_install.go
- registry_lifecycle.go
- registry_network.go
- registry_scan.go
- registry_types.go
- resource_grant_strings.go
- resource_path_security.go
- resource_publication.go
- resource_validation_error.go
- scaffold.go
- search_errors.go
- semantic_version.go
- source_names.go
- static_resources_validation.go
- tool_call_tracking.go
- tool_projection_generation.go
- tool_provider.go
- tool_reconciliation.go
- tool_runtime.go
- watch_source.go
Directories
¶
| Path | Synopsis |
|---|---|
|
scaffold_templates
|
|
|
connectivity-provider-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. |