extensionpkg

package
v0.3.0-beta.39 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 23, 2026 License: MIT Imports: 83 Imported by: 0

Documentation

Index

Constants

View Source
const (
	CmdPaletteSourceHealthy   = "healthy"
	CmdPaletteSourceUnhealthy = "unhealthy"
	CmdPaletteSourceDisabled  = "disabled"
)
View Source
const (
	// IssueSeverityError blocks extension use.
	IssueSeverityError = extensioncontract.IssueSeverityError
	// IssueSeverityWarning reports non-blocking authoring guidance.
	IssueSeverityWarning = extensioncontract.IssueSeverityWarning
	// IssueSeverityWarn reports one non-blocking portable component skip.
	IssueSeverityWarn = extensioncontract.IssueSeverityWarn
)
View Source
const (
	// HostAPIRateLimitedCode is the protocol code for per-extension backpressure.
	HostAPIRateLimitedCode = -32002
	// HostAPIUnavailableCode reports a temporarily unavailable Host API resource.
	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
)
View Source
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"
)
View Source
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"
)
View Source
const (
	// CapabilityDeniedCode is the protocol-equivalent code for denied extension
	// capabilities and Host API actions.
	CapabilityDeniedCode = -32001
)
View Source
const (

	// DefaultRestartFailureThreshold is the production crash-loop cutoff shared by status and doctor projections.
	DefaultRestartFailureThreshold = 5
)
View Source
const ExtensionEnvBindingKind = extensionenv.BindingKind

ExtensionEnvBindingKind identifies persisted extension environment bindings.

View Source
const MarketplaceCatalogRegistryName = "compozy-catalog"

MarketplaceCatalogRegistryName identifies feed-owned extension artifacts in installed provenance.

Variables

View Source
var (
	// ErrAgentPluginNotManifest reports a root plugin.json owned by another ecosystem.
	ErrAgentPluginNotManifest = errors.New("extension: plugin.json is not an Agent Plugins manifest")
	// ErrAgentPluginManifestInvalid reports fatal portable root-manifest issues.
	ErrAgentPluginManifestInvalid = errors.New("extension: agent plugin manifest invalid")
)
View Source
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")
)
View Source
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")
)
View Source
var (
	// ErrContextRequired reports that a manager operation requires a non-nil context.
	ErrContextRequired = errors.New("extension: context is required")
	// ErrManagerRequired reports that a manager-backed operation was invoked on a nil manager.
	ErrManagerRequired = errors.New("extension: manager is required")
	// ErrRegistryRequired reports that a manager operation requires a configured registry.
	ErrRegistryRequired = errors.New("extension: registry is required")
	// ErrPathEscapesExtensionRoot reports that a requested resource path resolves outside the
	// extension root.
	ErrPathEscapesExtensionRoot = errors.New("extension: path escapes extension root")
)
View Source
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")
)
View Source
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")
)
View Source
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")
)
View Source
var ErrExtensionAgentConflict = errors.New("extension: shipped agent conflicts with a visible agent")

ErrExtensionAgentConflict reports that a shipped agent would shadow a visible agent.

View Source
var ErrExtensionChecksumUnverified = errors.New("extension: checksum is unverified")
View Source
var ErrExtensionGatewayConfirmationRequired = errors.New("extension: gateway permissions confirmation required")

ErrExtensionGatewayConfirmationRequired reports stale consent; GatewayConfirmationRequiredError carries its digest.

View Source
var ErrExtensionInputInvalid = errors.New("extension: invalid input")
View Source
var ErrExtensionInputsRequired = errors.New("extension: inputs required")
View Source
var ErrExtensionNameConflict = errors.New("extension: instance name belongs to another origin")

ErrExtensionNameConflict means an installed name belongs to another acquisition origin.

View Source
var ErrExtensionPublishCredentialUnavailable = errors.New("extension: publish credential unavailable")
View Source
var ErrExtensionSearchInvalid = errors.New("extension: invalid search request")

ErrExtensionSearchInvalid reports a malformed source or cursor selection.

View Source
var ErrExtensionSourceChanged = errors.New("extension: source changed since it was listed")
View Source
var ErrMarketplaceSourceUnavailable = errors.New("extension: marketplace source unavailable")

ErrMarketplaceSourceUnavailable reports that a marketplace source cannot be resolved or used.

Functions

func AgentPluginDiagnostics

func AgentPluginDiagnostics(name string, values []agentplugin.Diagnostic) []diagnosticcontract.DiagnosticItem

AgentPluginDiagnostics converts portable component skips into canonical recorded diagnostics.

func BindHostAPIWorkspaceParams

func BindHostAPIWorkspaceParams(
	ctx context.Context,
	raw json.RawMessage,
	binding HostAPIWorkspaceBinding,
	workspaceID string,
	workspaceRoot string,
	workspaces workspacepkg.RuntimeResolver,
) (json.RawMessage, error)

BindHostAPIWorkspaceParams canonicalizes Host API workspace fields against a bound workspace.

func CheckExpectedDigest

func CheckExpectedDigest(expected, actual string) error

CheckExpectedDigest compares the approved digest before any managed state mutation.

func ComputeDirectoryChecksum

func ComputeDirectoryChecksum(path string) (string, error)

ComputeDirectoryChecksum returns a deterministic SHA-256 checksum for an installed extension directory payload.

func ContentsFor

func ContentsFor(manifest *Manifest, kit []KitItem) contract.ExtensionContentsPayload

ContentsFor counts loaded resources, not the directories that contain them.

func DescribeExtension

func DescribeExtension(ext *Extension, daemonRunning bool, now time.Time) contract.ExtensionPayload

DescribeExtension projects one extension snapshot into the shared CLI/API payload.

func DescribeExtensionForProfile

func DescribeExtensionForProfile(
	ext *Extension, daemonRunning bool, now time.Time, profileName string,
) contract.ExtensionPayload

DescribeExtensionForProfile projects package metadata through the selected profile placement.

func DescribeInputState

func DescribeInputState(
	manifest *Manifest,
	state InputState,
	getenv func(string) string,
) []contract.ExtensionInputStatePayload

DescribeInputState exposes configuration presence and activity without values or secret references.

func ForgeProviderErrorCause

func ForgeProviderErrorCause(err error) string

func GatewayRequirementDigest

func GatewayRequirementDigest(req *GatewayRequirement) (string, error)

GatewayRequirementDigest binds operator consent to the exact declared gateway permissions.

func InspectMarketplacePackage

func InspectMarketplacePackage(
	ctx context.Context,
	homePaths compozyconfig.HomePaths,
	req MarketplaceInstallRequest,
	profileName string,
) (_ contract.MarketplaceExtensionDetailPayload, resultErr error)

InspectMarketplacePackage reads pinned artifact bytes without install consent, execution, or registry writes. It shares download, digest verification, extraction and manifest loading with installation, but cannot commit.

func InspectPackageContents

func InspectPackageContents(
	ctx context.Context, ext *Extension, profileName string,
) (contract.ExtensionContentsPayload, error)

InspectPackageContents reads declared files without starting the extension runtime.

func InspectPluginPackage

func InspectPluginPackage(ctx context.Context, root string) (marketplace.PluginInspection, error)

InspectPluginPackage uses the install manifest and resource loaders without publishing or starting resources.

func InstallBundledExtension

func InstallBundledExtension(
	homePaths compozyconfig.HomePaths,
	registry *Registry,
	spec BundledInstallSpec,
) (err error)

InstallBundledExtension enrolls or refreshes a first-party managed extension without replacing an operator-owned extension with the same name.

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 MCPServerLaunchSummary

func MCPServerLaunchSummary(command, remoteURL string) string

MCPServerLaunchSummary excludes arguments, userinfo, paths and query values that may contain secrets.

func ManagedInstallPath

func ManagedInstallPath(homePaths compozyconfig.HomePaths, name string) string

ManagedInstallPath returns the Compozy-managed directory for one installed extension.

func ManagedInstallPathChecked

func ManagedInstallPathChecked(homePaths compozyconfig.HomePaths, name string) (string, error)

ManagedInstallPathChecked returns the contained managed directory for one installed extension.

func ManagedInstallRoot

func ManagedInstallRoot(homePaths compozyconfig.HomePaths) string

ManagedInstallRoot returns the Compozy-managed root directory for installed extensions.

func MarketplaceEntryTrustReport

func MarketplaceEntryTrustReport(
	evidence MarketplaceTrustEvidence,
	policyAllowsUnverified bool,
) (contract.ExtensionTrustReportPayload, error)

MarketplaceEntryTrustReport projects feed evidence and live policy before acquisition.

func MaterializeBundledExtension

func MaterializeBundledExtension(
	homePaths compozyconfig.HomePaths,
	name string,
	embedded fs.FS,
) (string, error)

MaterializeBundledExtension copies one embedded extension into a managed staging directory.

func NewExtensionModelSources

func NewExtensionModelSources(registry *Registry, resolver ModelSourceRuntimeResolver) ([]modelcatalog.Source, error)

NewExtensionModelSources creates sources for installed extensions that provide model.source.

func NewManagedInstallStagingDir

func NewManagedInstallStagingDir(homePaths compozyconfig.HomePaths) (string, error)

NewManagedInstallStagingDir creates an empty staging directory under the managed extension root.

func NormalizeInputJSON

func NormalizeInputJSON(inputType string, raw json.RawMessage) (json.RawMessage, error)

NormalizeInputJSON validates a supplied value and keeps booleans as JSON booleans.

func PackageRootFromManifest

func PackageRootFromManifest(path string) string

PackageRootFromManifest returns the artifact root for native and client manifests.

func ReconcileManagedExtensionArtifacts

func ReconcileManagedExtensionArtifacts(
	homePaths compozyconfig.HomePaths,
	registry managedInstallReconcileRegistry,
) error

ReconcileManagedExtensionArtifacts restores the managed install tree to the state committed in the registry before extension traffic starts.

func ReconcileManifestToolRuntime

func ReconcileManifestToolRuntime(
	manifest *ManifestToolDescriptor,
	runtime *toolspkg.ExtensionToolRuntimeDescriptor,
	state ExtensionToolRuntimeState,
) toolspkg.Availability

ReconcileManifestToolRuntime reports whether a manifest-authoritative extension tool is executable.

func RemoveManagedInstall

func RemoveManagedInstall(homePaths compozyconfig.HomePaths, name string) error

RemoveManagedInstall removes one extension directory after proving its resolved path stays beneath the managed install root.

func ResolveManifestToolResources

func ResolveManifestToolResources(manifest *Manifest) ([]toolspkg.Tool, error)

ResolveManifestToolResources converts manifest tool declarations into tool specs.

func ResourcePaths

func ResourcePaths(resources []ManifestResourcePath) []string

ResourcePaths projects typed manifest resource declarations for loaders that only consume package-relative paths.

func ValidateBundle

func ValidateBundle(dir string) (*Manifest, []ValidationIssue, error)

ValidateBundle validates a built or resource-only extension archive without executing extension code.

func ValidateExpectedDigest

func ValidateExpectedDigest(digest string) error

ValidateExpectedDigest accepts an omitted pin, otherwise requires a full SHA-256 digest.

func ValidateManifestForCompozyVersion

func ValidateManifestForCompozyVersion(manifest *Manifest, currentVersion string) error

ValidateManifestForCompozyVersion checks a manifest against an explicitly stamped daemon version.

func ValidateManifestInputs

func ValidateManifestInputs(manifest *Manifest) error

ValidateManifestInputs checks grammar and resolves every binding to declared servers.

func ValidateUnverifiedSideLoad

func ValidateUnverifiedSideLoad(
	slug string,
	source string,
	policyAllowsUnverified bool,
	allowUnverified bool,
) error

ValidateUnverifiedSideLoad enforces daemon policy plus per-request consent.

Types

type ActiveExtension

type ActiveExtension struct {
	Published          *ExtensionInfo
	DevLink            *DevLink
	OverridesPublished bool
}

ActiveExtension is the registry resolution result for one instance key.

type AgentConflictError

type AgentConflictError struct {
	Agents []string
}

AgentConflictError names every colliding agent in stable order.

func (*AgentConflictError) Error

func (e *AgentConflictError) Error() string

func (*AgentConflictError) Unwrap

func (e *AgentConflictError) Unwrap() error

type AgentPluginManifestValidationError

type AgentPluginManifestValidationError struct {
	Path   string
	Issues []agentplugin.Issue
}

AgentPluginManifestValidationError preserves every fatal portable manifest issue.

func (*AgentPluginManifestValidationError) Error

func (*AgentPluginManifestValidationError) Unwrap

type AgentPluginNotManifestError

type AgentPluginNotManifestError struct {
	Checked []string
	Root    string
}

AgentPluginNotManifestError identifies an unrelated root plugin.json.

func (*AgentPluginNotManifestError) Error

func (*AgentPluginNotManifestError) Unwrap

func (e *AgentPluginNotManifestError) Unwrap() error

type AgentSidecar

type AgentSidecar struct {
	SourcePath string
	Body       string
}

AgentSidecar is one validated authored-context file shipped beside an agent.

type BuildRequest

type BuildRequest struct {
	SourceDir string
	OutputDir string
	BuildCmd  []string
	Timeout   time.Duration
}

BuildRequest configures one daemon-free extension package build.

type BuildResult

type BuildResult struct {
	GenerationDir  string    `json:"generation_dir"`
	GenerationHash string    `json:"generation_hash"`
	ManifestPath   string    `json:"manifest_path"`
	Manifest       *Manifest `json:"manifest"`
}

BuildResult identifies one immutable, fully validated extension package generation.

func BuildBundle

func BuildBundle(ctx context.Context, req BuildRequest) (*BuildResult, error)

BuildBundle builds source, runs SDK describe mode, and publishes an immutable generation.

func PrepareDevelopmentGeneration

func PrepareDevelopmentGeneration(ctx context.Context, sourceDir string) (*BuildResult, error)

PrepareDevelopmentGeneration validates portable source or builds a native bundle.

type BundledInstallSpec

type BundledInstallSpec struct {
	Name string
	FS   fs.FS
}

BundledInstallSpec identifies one first-party extension embedded in the Compozy binary.

type CapabilitiesConfig

type CapabilitiesConfig struct {
	Provides []string `toml:"provides,omitempty" json:"provides,omitempty"`
}

CapabilitiesConfig declares the runtime interfaces the extension provides.

type CapabilityChecker

type CapabilityChecker struct {
	// contains filtered or unexported fields
}

CapabilityChecker tracks effective grants per extension and evaluates capability checks for hook dispatch and Host API calls.

func (*CapabilityChecker) Check

func (c *CapabilityChecker) Check(extName, capability string) error

Check reports whether extName has the requested security capability.

func (*CapabilityChecker) CheckHostAPI

func (c *CapabilityChecker) CheckHostAPI(extName, method string) error

CheckHostAPI reports whether extName may call the Host API method.

func (*CapabilityChecker) Grant

func (c *CapabilityChecker) Grant(extName string) EffectiveGrant

Grant returns the stored effective grant snapshot for one extension.

func (*CapabilityChecker) Register

func (c *CapabilityChecker) Register(extName string, source ExtensionSource, manifest *Manifest)

Register records one extension's effective grants by applying the source-tier ceiling before intersecting it with the manifest requests.

func (*CapabilityChecker) RegisterForSession

func (c *CapabilityChecker) RegisterForSession(
	extName string,
	source ExtensionSource,
	manifest *Manifest,
	sessionMaxScope resources.ResourceScopeKind,
) (EffectiveGrant, error)

RegisterForSession records one extension's effective grants for the supplied session scope ceiling.

func (*CapabilityChecker) Resolve

func (c *CapabilityChecker) Resolve(
	source ExtensionSource,
	manifest *Manifest,
	sessionMaxScope resources.ResourceScopeKind,
) (EffectiveGrant, error)

Resolve computes one daemon-derived grant snapshot without storing it.

func (*CapabilityChecker) SetResourcePolicy

func (c *CapabilityChecker) SetResourcePolicy(policy compozyconfig.ExtensionsResourcesConfig)

SetResourcePolicy installs the operator-configured extension resource policy.

func (*CapabilityChecker) Unregister

func (c *CapabilityChecker) Unregister(extName string)

Unregister removes any effective grants tracked for one extension.

type CapabilityDeniedData

type CapabilityDeniedData struct {
	Method   string   `json:"method"`
	Required []string `json:"required"`
	Granted  []string `json:"granted"`
}

CapabilityDeniedData is the structured data for capability-denied failures.

type CmdPaletteAction

type CmdPaletteAction = extensioncontract.CmdPaletteAction

type CmdPaletteConfig

type CmdPaletteConfig = extensioncontract.CmdPaletteConfig

type CmdPaletteDefaultShortcut

type CmdPaletteDefaultShortcut struct {
	CommandID string
	Chord     string
	Extension string
	Active    bool
}

CmdPaletteDefaultShortcut is one extension default in deterministic enable order.

type CmdPaletteProjectedCommand

type CmdPaletteProjectedCommand struct {
	ID                string
	Title             string
	Section           string
	Icon              string
	Keywords          []string
	Arguments         []CmdPaletteArgument
	Action            CmdPaletteAction
	Destructive       bool
	Confirmation      *CmdPaletteConfirmation
	Execution         CmdPaletteResolvedExecutionPolicy
	Extension         string
	UnavailableReason string
}

CmdPaletteProjectedCommand is a validated, namespaced extension command.

type CmdPaletteProjectedView

type CmdPaletteProjectedView struct {
	ID                string
	Title             string
	Kind              string
	SourceTool        string
	Program           bool
	Extension         string
	UnavailableReason string
}

CmdPaletteProjectedView is a validated, namespaced extension view.

type CmdPaletteProjection

type CmdPaletteProjection struct {
	Commands []CmdPaletteProjectedCommand
	Views    []CmdPaletteProjectedView
	Defaults []CmdPaletteDefaultShortcut
	Sources  []CmdPaletteSourceStatus
}

CmdPaletteProjection is the complete storage-free palette snapshot for one workspace.

type CmdPaletteResolvedExecutionPolicy

type CmdPaletteResolvedExecutionPolicy struct {
	SingleFlight bool
	RetrySafe    bool
}

CmdPaletteResolvedExecutionPolicy is the effective policy after action defaults.

type CmdPaletteSourceStatus

type CmdPaletteSourceStatus struct {
	Source string
	Status string
	Reason string
}

CmdPaletteSourceStatus keeps source membership separate from runtime health.

type CmdPaletteView

type CmdPaletteView = extensioncontract.CmdPaletteView

type CommandDescriptor

type CommandDescriptor struct {
	Extension        string                          `json:"extension"`
	Verb             string                          `json:"verb"`
	ToolID           string                          `json:"tool_id"`
	Summary          string                          `json:"summary"`
	Example          string                          `json:"example,omitempty"`
	Flags            []extensioncontract.CommandFlag `json:"flags"`
	RiskClass        toolspkg.RiskClass              `json:"risk_class"`
	ApprovalRequired bool                            `json:"approval_required"`
}

CommandDescriptor is one executable command leaf projected from an active extension tool.

type CommandGroupDescriptor

type CommandGroupDescriptor struct {
	Extension string `json:"extension"`
	Path      string `json:"path"`
	Summary   string `json:"summary"`
}

CommandGroupDescriptor associates one presentation-only group with its extension.

type ConnectivityProviderTrustResolver

type ConnectivityProviderTrustResolver struct {
	// contains filtered or unexported fields
}

ConnectivityProviderTrustResolver derives provider authority from the live global registry.

func NewConnectivityProviderTrustResolver

func NewConnectivityProviderTrustResolver(registry *Registry) (*ConnectivityProviderTrustResolver, error)

NewConnectivityProviderTrustResolver constructs the gateway-facing live trust adapter.

func (*ConnectivityProviderTrustResolver) ResolveProviderTrust

func (r *ConnectivityProviderTrustResolver) ResolveProviderTrust(
	ctx context.Context,
	name string,
) (gateway.ProviderTrust, error)

ResolveProviderTrust reloads the installed artifact digest on every call.

type ConsentArea

type ConsentArea = extensioncontract.ConsentArea

ConsentArea is one operator-facing permission summary derived from Host API methods.

func DeriveConsentAreas

func DeriveConsentAreas(methods []string) ([]ConsentArea, error)

DeriveConsentAreas derives a deterministic consent summary from the closed permission set.

type DeclaredProfileApplyResult

type DeclaredProfileApplyResult struct {
	Profile profilepkg.Profile `json:"profile"`
	Created bool               `json:"created"`
	Bound   bool               `json:"bound"`
}

DeclaredProfileApplyResult records the mutation outcome without implying that a previously bound or marker-gated profile was created again.

func ApplyDeclaredProfiles

func ApplyDeclaredProfiles(
	ctx context.Context,
	manager declaredProfileManager,
	manifest *Manifest,
) ([]DeclaredProfileApplyResult, error)

type DeclaredProfilePlan

type DeclaredProfilePlan struct {
	Extension string                     `json:"extension"`
	Profiles  []DeclaredProfilePlanEntry `json:"profiles"`
}

DeclaredProfilePlan is the install/update summary presented before mutation.

func BuildDeclaredProfilePlan

func BuildDeclaredProfilePlan(
	ctx context.Context,
	manager declaredProfileManager,
	manifest *Manifest,
) (DeclaredProfilePlan, error)

type DeclaredProfilePlanEntry

type DeclaredProfilePlanEntry struct {
	Name       string                      `json:"name"`
	Create     bool                        `json:"create"`
	NeedsSetup []ManifestProfileCredential `json:"needs_setup,omitempty"`
}

DeclaredProfilePlanEntry describes one declaration's bind/create outcome.

type DevLink struct {
	ExtensionName            string
	WorkspaceID              string
	OriginPath               string
	BundleGeneration         string
	LinkedAt                 time.Time
	GatewayRequirementDigest string
	Format                   ExtensionFormat
	IngestDiagnostics        []diagnosticcontract.DiagnosticItem
	GatewayConfirmedBy       string
	GatewayConfirmedAt       time.Time
}

DevLink is one workspace-local overlay row.

type DevLinkRequest

type DevLinkRequest struct {
	Name                     string
	WorkspaceID              string
	OriginPath               string
	GenerationHash           string
	GatewayRequirementDigest string
	Format                   ExtensionFormat
	IngestDiagnostics        []diagnosticcontract.DiagnosticItem
}

DevLinkRequest identifies one immutable workspace-local extension generation.

type DevelopmentGeneration

type DevelopmentGeneration struct {
	Name                     string
	OriginPath               string
	GenerationHash           string
	GatewayRequirementDigest string
	Format                   ExtensionFormat
	IngestDiagnostics        []diagnosticcontract.DiagnosticItem
}

DevelopmentGeneration is the verified, mutation-free identity of one dev artifact.

type Duration

type Duration time.Duration

Duration stores time.Duration values while decoding TOML strings and JSON strings consistently.

func (Duration) IsZero

func (d Duration) IsZero() bool

IsZero reports whether the duration is unset.

func (Duration) MarshalJSON

func (d Duration) MarshalJSON() ([]byte, error)

MarshalJSON emits the duration as a quoted duration string.

func (Duration) MarshalText

func (d Duration) MarshalText() ([]byte, error)

MarshalText emits the duration as text.

func (Duration) String

func (d Duration) String() string

String returns the canonical duration string.

func (*Duration) UnmarshalJSON

func (d *Duration) UnmarshalJSON(data []byte) error

UnmarshalJSON accepts duration strings and integer nanoseconds.

func (*Duration) UnmarshalText

func (d *Duration) UnmarshalText(text []byte) error

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

type EnvBindingValidationError struct {
	EnvName  string
	Declared []string
	Cause    error
}

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 (*ExtensionArchiveDigestMismatchError) Error

func (*ExtensionArchiveDigestMismatchError) Is

func (*ExtensionArchiveDigestMismatchError) Unwrap

type ExtensionChecksumMismatchError

type ExtensionChecksumMismatchError struct {
	ExpectedChecksum string
	ActualChecksum   string
}

ExtensionChecksumMismatchError describes a checksum verification failure.

func (*ExtensionChecksumMismatchError) Error

Error returns the typed checksum mismatch message.

func (*ExtensionChecksumMismatchError) Is

Is matches sentinel errors for errors.Is.

type ExtensionExistsError

type ExtensionExistsError struct {
	Name string
}

ExtensionExistsError describes a duplicate extension install attempt.

func (*ExtensionExistsError) Error

func (e *ExtensionExistsError) Error() string

Error returns the typed duplicate-extension message.

func (*ExtensionExistsError) Is

func (e *ExtensionExistsError) Is(target error) bool

Is matches sentinel errors for errors.Is.

type ExtensionFormat

type ExtensionFormat string

ExtensionFormat identifies the manifest format that owns an extension instance.

const (
	FormatCompozy     ExtensionFormat = "compozy"
	FormatAgentPlugin ExtensionFormat = "agent-plugin"
)

type ExtensionInfo

type ExtensionInfo struct {
	Name    string
	Version string
	Source  ExtensionSource
	// Enabled is true when at least one active profile has no disabled exception
	// for this extension; it is an effective runtime projection, not a global flag.
	Enabled           bool
	ManifestPath      string
	Format            ExtensionFormat
	IngestDiagnostics []diagnosticcontract.DiagnosticItem
	InstalledAt       time.Time
	Capabilities      CapabilitiesConfig
	Permissions       PermissionsConfig
	Checksum          string

	RegistrySlug             *string
	RegistryName             *string
	RemoteVersion            *string
	Provenance               ExtensionProvenance
	GatewayRequirementDigest string
	GatewayConfirmedBy       string
	GatewayConfirmedAt       time.Time
	// contains filtered or unexported fields
}

ExtensionInfo is one persisted extension registry row.

func InstallMarketplaceManaged

func InstallMarketplaceManaged(
	ctx context.Context,
	homePaths compozyconfig.HomePaths,
	registry LifecycleRegistry,
	loader MarketplaceSourceLoader,
	req MarketplaceInstallRequest,
) (_ *ExtensionInfo, err error)

InstallMarketplaceManaged installs one extension through the configured marketplace registry into the managed extension root and records marketplace provenance in the installed-extension registry.

func SelectMarketplaceUpdateTargets

func SelectMarketplaceUpdateTargets(
	registry LifecycleRegistry,
	names []string,
	updateAll bool,
) ([]ExtensionInfo, error)

SelectMarketplaceUpdateTargets resolves the complete managed update selection before acquisition.

type ExtensionJob

type ExtensionJob struct {
	Name      string                        `toml:"name"`
	Agent     string                        `toml:"agent"`
	Prompt    string                        `toml:"prompt"`
	Schedule  automationpkg.ScheduleSpec    `toml:"schedule"`
	Task      *automationpkg.JobTaskConfig  `toml:"task,omitempty"`
	Enabled   *bool                         `toml:"enabled,omitempty"`
	Retry     automationpkg.RetryConfig     `toml:"retry,omitempty"`
	FireLimit automationpkg.FireLimitConfig `toml:"fire_limit,omitempty"`
}

ExtensionJob is one package-authored scheduled automation definition.

type ExtensionLogCursor

type ExtensionLogCursor struct {
	Sequence    int64
	StreamEpoch string
}

ExtensionLogCursor identifies one position within one in-memory log ring.

type ExtensionLogEntry

type ExtensionLogEntry struct {
	Sequence       int64     `json:"sequence"`
	Timestamp      time.Time `json:"timestamp"`
	Message        string    `json:"message"`
	GenerationHash string    `json:"generation_hash,omitempty"`
	StreamEpoch    string    `json:"stream_epoch"`
}

ExtensionLogEntry is one redacted stderr record retained for an instance.

type ExtensionLogRing

type ExtensionLogRing struct {
	// contains filtered or unexported fields
}

ExtensionLogRing is a bounded, concurrency-safe, drop-oldest byte ring.

type ExtensionLogSnapshot

type ExtensionLogSnapshot struct {
	Entries     []ExtensionLogEntry
	StreamEpoch string
}

ExtensionLogSnapshot is one complete or cursor-filtered view of a log ring.

type ExtensionNameConflictError

type ExtensionNameConflictError struct {
	Name            string
	InstalledOrigin marketplacepkg.Origin
	SourceName      string
}

ExtensionNameConflictError identifies the installed acquisition without exposing credentials.

func (*ExtensionNameConflictError) Error

func (*ExtensionNameConflictError) Unwrap

func (e *ExtensionNameConflictError) Unwrap() error

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 (*ExtensionPolicyBlockedError) Error

func (*ExtensionPolicyBlockedError) Unwrap

func (e *ExtensionPolicyBlockedError) Unwrap() error

type ExtensionProvenance

type ExtensionProvenance struct {
	SourceName          string                    `json:"source_name,omitempty"`
	SourceRef           string                    `json:"source_ref,omitempty"`
	EntryID             string                    `json:"entry_id,omitempty"`
	ResolvedRef         string                    `json:"resolved_ref,omitempty"`
	Layout              string                    `json:"layout,omitempty"`
	Slug                string                    `json:"slug,omitempty"`
	CatalogEntryID      string                    `json:"catalog_entry_id,omitempty"`
	InstalledFrom       string                    `json:"installed_from"`
	SourceURL           string                    `json:"source_url,omitempty"`
	ChecksumSHA256      string                    `json:"checksum_sha256"`
	ArchiveDigestSHA256 string                    `json:"archive_digest_sha256,omitempty"`
	DigestMatched       bool                      `json:"digest_matched"`
	ChecksumVerified    bool                      `json:"checksum_verified"`
	RegistryTier        string                    `json:"registry_tier"`
	Permissions         []string                  `json:"permissions,omitempty"`
	InstalledAt         time.Time                 `json:"installed_at"`
	InstalledBy         string                    `json:"installed_by"`
	AllowUnverified     bool                      `json:"allow_unverified"`
	Warnings            []contract.DiagnosticItem `json:"warnings,omitempty"`
}

ExtensionProvenance records one installed extension's source and trust state.

func LocalPathProvenance

func LocalPathProvenance(
	manifest *Manifest,
	sourcePath string,
	checksum string,
	installedAt time.Time,
	allowUnverified bool,
) ExtensionProvenance

LocalPathProvenance records an explicit trust decision for a local install.

type ExtensionSource

type ExtensionSource int

ExtensionSource identifies where an extension was installed from.

const (
	// SourceBundled identifies built-in extensions shipped with the daemon.
	SourceBundled ExtensionSource = iota
	// SourceUser identifies user-installed extensions trusted by the operator.
	SourceUser
	// SourceWorkspace identifies workspace-scoped extensions trusted by the project.
	SourceWorkspace
	// SourceMarketplace identifies marketplace-installed extensions subject to
	// restricted default grants until an explicit allowlist exists.
	SourceMarketplace
)

func (ExtensionSource) String

func (s ExtensionSource) String() string

String returns the persisted text form for one extension source tier.

type ExtensionStatus

type ExtensionStatus struct {
	Name                string
	WorkspaceID         string
	Version             string
	Source              ExtensionSource
	Enabled             bool
	MissingEnv          []string
	MissingEnvChecked   bool
	Registered          bool
	Active              bool
	Phase               ExtensionPhase
	PID                 int
	Healthy             bool
	HealthMessage       string
	HealthLastCheckedAt time.Time
	ConsecutiveFailures int
	RestartBackoff      time.Duration
	LastError           string
	FailureCode         string
	GenerationHash      string
	LastGoodGeneration  string
	LastStartedAt       time.Time
	LastExitedAt        time.Time
}

ExtensionStatus captures the runtime state exposed to health/observer code.

type ExtensionToolCallTracker

type ExtensionToolCallTracker interface {
	BeginExtensionToolCall(
		ctx context.Context,
		extensionName string,
		sessionID string,
	) (string, func(), error)
}

ExtensionToolCallTracker binds reverse Host API calls to one active tool invocation.

type ExtensionToolProvider

type ExtensionToolProvider struct {
	// contains filtered or unexported fields
}

ExtensionToolProvider lists manifest-authored extension tools and resolves executable handles through the live subprocess runtime.

func NewExtensionToolProvider

func NewExtensionToolProvider(
	registry *Registry,
	runtime ExtensionToolRuntimeResolver,
	opts ...ExtensionToolProviderOption,
) (*ExtensionToolProvider, error)

NewExtensionToolProvider creates the extension_host provider for the central tool registry.

func (*ExtensionToolProvider) ID

ID returns the aggregate extension-provider provenance.

func (*ExtensionToolProvider) List

List returns manifest-authoritative extension-host tool descriptors.

func (*ExtensionToolProvider) ProjectionAvailability

func (p *ExtensionToolProvider) ProjectionAvailability(
	ctx context.Context,
	scope toolspkg.Scope,
	ids []toolspkg.ToolID,
) map[toolspkg.ToolID]toolspkg.Availability

ProjectionAvailability shares live observations only within one projection request.

func (*ExtensionToolProvider) ProjectionGeneration

func (p *ExtensionToolProvider) ProjectionGeneration(
	ctx context.Context,
	scope toolspkg.Scope,
) (string, bool)

ProjectionGeneration reports manifest and live runtime state used by tool projection.

func (*ExtensionToolProvider) Resolve

Resolve returns a handle that reconciles one manifest descriptor against the live extension runtime before allowing execution.

type ExtensionToolProviderOption

type ExtensionToolProviderOption func(*ExtensionToolProvider)

ExtensionToolProviderOption configures an extension-host tool provider.

func WithToolProviderLogger

func WithToolProviderLogger(logger *slog.Logger) ExtensionToolProviderOption

WithToolProviderLogger injects the logger used when one invalid extension is isolated from the aggregate tool catalog.

func WithToolProviderProfileNameResolver

func WithToolProviderProfileNameResolver(resolver ProfileNameResolver) ExtensionToolProviderOption

WithToolProviderProfileNameResolver binds profile-named manifest placements to the stable profile identity carried by tool scopes.

type ExtensionToolRuntime

type ExtensionToolRuntime interface {
	Get(name string) (*Extension, error)
	toolspkg.ExtensionToolInvoker
}

ExtensionToolRuntime is the live runtime surface needed by extension-host tool handles.

type ExtensionToolRuntimeResolver

type ExtensionToolRuntimeResolver func() ExtensionToolRuntime

ExtensionToolRuntimeResolver returns the current live extension runtime.

type ExtensionToolRuntimeState

type ExtensionToolRuntimeState struct {
	Enabled              bool
	Active               bool
	Healthy              bool
	ProvidedCapabilities []string
}

ExtensionToolRuntimeState captures extension lifecycle state needed for manifest/runtime reconciliation.

type ExtensionTrigger

type ExtensionTrigger struct {
	Name         string                        `toml:"name"`
	Agent        string                        `toml:"agent"`
	Prompt       string                        `toml:"prompt"`
	Event        string                        `toml:"event"`
	Filter       map[string]string             `toml:"filter,omitempty"`
	Enabled      *bool                         `toml:"enabled,omitempty"`
	Retry        automationpkg.RetryConfig     `toml:"retry,omitempty"`
	FireLimit    automationpkg.FireLimitConfig `toml:"fire_limit,omitempty"`
	EndpointSlug string                        `toml:"endpoint_slug,omitempty"`
}

ExtensionTrigger is one package-authored event automation definition.

type ExtensionTrustError

type ExtensionTrustError struct {
	Slug   string
	Source string
	Item   contract.DiagnosticItem
}

ExtensionTrustError carries the canonical diagnostic for a denied extension trust decision.

func NewExtensionChecksumUnverifiedError

func NewExtensionChecksumUnverifiedError(slug string, source string) *ExtensionTrustError

NewExtensionChecksumUnverifiedError returns the canonical trust-gate error.

func (*ExtensionTrustError) DiagnosticItem

func (e *ExtensionTrustError) DiagnosticItem() contract.DiagnosticItem

func (*ExtensionTrustError) Error

func (e *ExtensionTrustError) Error() string

func (*ExtensionTrustError) Unwrap

func (e *ExtensionTrustError) Unwrap() error

type ForgeProviderError

type ForgeProviderError struct {
	// contains filtered or unexported fields
}

func (*ForgeProviderError) Error

func (e *ForgeProviderError) Error() string

func (*ForgeProviderError) Unwrap

func (e *ForgeProviderError) Unwrap() error

type GatewayConfirmation

type GatewayConfirmation struct {
	Digest      string
	ConfirmedBy string
	ConfirmedAt time.Time
}

GatewayConfirmation is the confirmation tuple for one exact extension instance.

type GatewayConfirmationRequiredError

type GatewayConfirmationRequiredError struct {
	CurrentDigest string
}

GatewayConfirmationRequiredError carries the current digest the caller must confirm.

func (*GatewayConfirmationRequiredError) Error

func (*GatewayConfirmationRequiredError) Unwrap

type GatewayRequirement

type GatewayRequirement struct {
	Permissions []string `toml:"permissions" json:"permissions"`
}

GatewayRequirement declares the gateway tiers an extension may expose.

func (*GatewayRequirement) Normalize

func (r *GatewayRequirement) Normalize() *GatewayRequirement

func (*GatewayRequirement) Validate

func (r *GatewayRequirement) Validate(field string) error

type HookConfig

type HookConfig struct {
	Profile   string             `toml:"profile,omitempty"    json:"profile,omitempty"`
	Name      string             `toml:"name"                 json:"name"`
	Event     string             `toml:"event"                json:"event"`
	Mode      string             `toml:"mode,omitempty"       json:"mode,omitempty"`
	Required  bool               `toml:"required,omitempty"   json:"required,omitzero"`
	Priority  *int               `toml:"priority,omitempty"   json:"priority,omitzero"`
	Timeout   Duration           `toml:"timeout,omitempty"    json:"timeout,omitempty"`
	Matcher   HookMatcherConfig  `toml:"matcher,omitempty"    json:"matcher"`
	Command   string             `toml:"command,omitempty"    json:"command,omitempty"`
	Args      []string           `toml:"args,omitempty"       json:"args,omitempty"`
	Env       map[string]string  `toml:"env,omitempty"        json:"env,omitempty"`
	SecretEnv map[string]string  `toml:"secret_env,omitempty" json:"secret_env,omitempty"`
	Executor  HookExecutorConfig `toml:"executor,omitempty"   json:"executor"`
}

HookConfig mirrors the hook declaration shape accepted from extension manifests.

type HookExecutorConfig

type HookExecutorConfig struct {
	Kind      string            `toml:"kind,omitempty"       json:"kind,omitempty"`
	Command   string            `toml:"command,omitempty"    json:"command,omitempty"`
	Args      []string          `toml:"args,omitempty"       json:"args,omitempty"`
	Env       map[string]string `toml:"env,omitempty"        json:"env,omitempty"`
	SecretEnv map[string]string `toml:"secret_env,omitempty" json:"secret_env,omitempty"`
}

HookExecutorConfig selects the hook execution boundary and command.

type HookMatcherConfig

type HookMatcherConfig struct {
	AgentName          string `toml:"agent_name,omitempty"          json:"agent_name,omitempty"`
	AgentType          string `toml:"agent_type,omitempty"          json:"agent_type,omitempty"`
	WorkspaceID        string `toml:"workspace_id,omitempty"        json:"workspace_id,omitempty"`
	WorkspaceRoot      string `toml:"workspace_root,omitempty"      json:"workspace_root,omitempty"`
	SessionType        string `toml:"session_type,omitempty"        json:"session_type,omitempty"`
	InputClass         string `toml:"input_class,omitempty"         json:"input_class,omitempty"`
	ACPEventType       string `toml:"acp_event_type,omitempty"      json:"acp_event_type,omitempty"`
	TurnID             string `toml:"turn_id,omitempty"             json:"turn_id,omitempty"`
	ToolID             string `toml:"tool_id,omitempty"             json:"tool_id,omitempty"`
	ToolName           string `toml:"tool_name,omitempty"           json:"tool_name,omitempty"`
	ToolReadOnly       *bool  `toml:"tool_read_only,omitempty"      json:"tool_read_only,omitzero"`
	DecisionClass      string `toml:"decision_class,omitempty"      json:"decision_class,omitempty"`
	MessageRole        string `toml:"message_role,omitempty"        json:"message_role,omitempty"`
	MessageDeltaType   string `toml:"message_delta_type,omitempty"  json:"message_delta_type,omitempty"`
	CompactionTrigger  string `toml:"compaction_trigger,omitempty"  json:"compaction_trigger,omitempty"`
	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,
	observer hostAPIObserver,
	skillsRegistry hostAPISkillsRegistry,
	opts ...HostAPIOption,
) *HostAPIHandler

NewHostAPIHandler constructs a Host API handler with sensible defaults.

func (*HostAPIHandler) BeginExtensionToolCall

func (h *HostAPIHandler) BeginExtensionToolCall(
	ctx context.Context,
	extensionName string,
	sessionID string,
) (string, func(), error)

BeginExtensionToolCall binds one opaque invocation ID to the active extension session.

func (*HostAPIHandler) Handle

func (h *HostAPIHandler) Handle(
	ctx context.Context,
	extName string,
	method string,
	params json.RawMessage,
) (any, error)

Handle dispatches one Host API request for the named extension.

func (*HostAPIHandler) HandleMethod

func (h *HostAPIHandler) HandleMethod(method string) subprocess.HandlerFunc

HandleMethod returns a subprocess-compatible handler for one Host API method.

func (*HostAPIHandler) HandleWithResourceActor

func (h *HostAPIHandler) HandleWithResourceActor(
	ctx context.Context,
	principal string,
	method string,
	params json.RawMessage,
	actor resources.MutationActor,
) (any, error)

HandleWithResourceActor dispatches a Host API call with an authenticated resource-session actor. Capability checks and rate limiting still run through Handle.

func (*HostAPIHandler) MethodHandlers

func (h *HostAPIHandler) MethodHandlers() map[string]subprocess.HandlerFunc

MethodHandlers returns the subprocess-compatible handler set for every Host API method.

type HostAPIOption

type HostAPIOption func(*HostAPIHandler)

HostAPIOption customizes a HostAPIHandler.

func WithHostAPIAutomationGetter

func WithHostAPIAutomationGetter(getter func() HostAPIAutomationManager) HostAPIOption

WithHostAPIAutomationGetter injects a lazy automation lookup used when the runtime boots after extensions.

func WithHostAPIAutomationManager

func WithHostAPIAutomationManager(manager HostAPIAutomationManager) HostAPIOption

WithHostAPIAutomationManager injects the automation manager used for automation Host API methods.

func WithHostAPICapabilityChecker

func WithHostAPICapabilityChecker(checker *CapabilityChecker) HostAPIOption

WithHostAPICapabilityChecker injects the capability checker used for Host API authorization.

func WithHostAPIClarify

func WithHostAPIClarify(broker toolspkg.ClarifyBroker) HostAPIOption

WithHostAPIClarify injects the shared broker and active-call correlation runtime.

func WithHostAPIHeartbeatAuthoring

func WithHostAPIHeartbeatAuthoring(service hostAPIHeartbeatAuthoringService) HostAPIOption

WithHostAPIHeartbeatAuthoring injects managed HEARTBEAT.md mutation support.

func WithHostAPIHeartbeatStatus

func WithHostAPIHeartbeatStatus(service hostAPIHeartbeatStatusService) HostAPIOption

WithHostAPIHeartbeatStatus injects managed Heartbeat status support.

func WithHostAPIHeartbeatWake

func WithHostAPIHeartbeatWake(service hostAPIHeartbeatWakeService) HostAPIOption

WithHostAPIHeartbeatWake injects managed Heartbeat wake support.

func WithHostAPIHeartbeatWakeEvents

func WithHostAPIHeartbeatWakeEvents(reader hostAPIHeartbeatWakeEventReader) HostAPIOption

WithHostAPIHeartbeatWakeEvents injects retained wake audit reads.

func WithHostAPIModelCatalogService

func WithHostAPIModelCatalogService(service modelcatalog.Service) HostAPIOption

WithHostAPIModelCatalogService injects daemon-owned model catalog projections.

func WithHostAPINow

func WithHostAPINow(now func() time.Time) HostAPIOption

WithHostAPINow overrides the handler clock, mainly for tests.

func WithHostAPIProfileReader

func WithHostAPIProfileReader(reader hostAPIProfileReader) HostAPIOption

WithHostAPIProfileReader injects profile identity lookup for owner-aware Host API payloads.

func WithHostAPIRateLimit

func WithHostAPIRateLimit(limit int, burst int) HostAPIOption

WithHostAPIRateLimit overrides the per-extension Host API token bucket settings.

func WithHostAPIResourceCodecRegistry

func WithHostAPIResourceCodecRegistry(registry *resources.CodecRegistry) HostAPIOption

WithHostAPIResourceCodecRegistry injects resource codecs used to validate and canonicalize snapshot specs before persistence.

func WithHostAPIResourceStore

func WithHostAPIResourceStore(store resources.RawStore) HostAPIOption

WithHostAPIResourceStore injects the canonical raw resource store used by the extension resource Host API methods.

func WithHostAPIResourceTrigger

func WithHostAPIResourceTrigger(
	trigger func(context.Context, resources.ResourceKind, resources.ReconcileReason) error,
) HostAPIOption

WithHostAPIResourceTrigger injects the reconcile trigger used after successful snapshot writes.

func WithHostAPISessionHealth

func WithHostAPISessionHealth(reader hostAPISessionHealthReader) HostAPIOption

WithHostAPISessionHealth injects metadata-only session health reads.

func WithHostAPISoulAuthoring

func WithHostAPISoulAuthoring(service hostAPISoulAuthoringService) HostAPIOption

WithHostAPISoulAuthoring injects managed SOUL.md read and mutation support.

func WithHostAPISoulRefresher

func WithHostAPISoulRefresher(refresher hostAPISoulRefresher) HostAPIOption

WithHostAPISoulRefresher injects managed session Soul refresh support.

func WithHostAPITaskCatalogFilterMapper

func WithHostAPITaskCatalogFilterMapper(mapper HostAPITaskCatalogFilterMapper) HostAPIOption

WithHostAPITaskCatalogFilterMapper injects the API-owned task catalog filter semantics.

func WithHostAPITaskManager

func WithHostAPITaskManager(manager hostAPITaskManager) HostAPIOption

WithHostAPITaskManager injects the task manager used for task Host API methods.

func WithHostAPIViewPatchPublisher

func WithHostAPIViewPatchPublisher(publisher ViewPatchPublisher) HostAPIOption

WithHostAPIViewPatchPublisher injects the daemon-owned declarative patch hub.

func WithHostAPIViewService

func WithHostAPIViewService(service cmdpalette.ViewService) HostAPIOption

WithHostAPIViewService injects the daemon-owned programmable-view authority.

func WithHostAPIWorkspaceResolver

func WithHostAPIWorkspaceResolver(resolver workspacepkg.RuntimeResolver) HostAPIOption

WithHostAPIWorkspaceResolver injects workspace resolution for workspace-scoped Host API methods.

type HostAPITaskCatalogFilterMapper

type HostAPITaskCatalogFilterMapper func(
	query *taskpkg.CatalogQuery,
	includeLoop bool,
	loopRunID string,
)

HostAPITaskCatalogFilterMapper applies API-owned task catalog filter semantics.

type HostAPIWorkspaceBinding

type HostAPIWorkspaceBinding uint8

HostAPIWorkspaceBinding identifies how a workspace-bound Host API call is constrained.

const (
	HostAPIWorkspaceBindingNone HostAPIWorkspaceBinding = iota
	HostAPIWorkspaceBindingActor
	HostAPIWorkspaceBindingPath
	HostAPIWorkspaceBindingID
	HostAPIWorkspaceBindingTask
	HostAPIWorkspaceBindingAutomation
	HostAPIWorkspaceBindingResource
)

func HostAPIWorkspaceBindingFor

func HostAPIWorkspaceBindingFor(method extensionprotocol.HostAPIMethod) (HostAPIWorkspaceBinding, bool)

HostAPIWorkspaceBindingFor returns the canonical workspace-binding decision for one Host API method.

type InputState

type InputState struct{ Values map[string]InputValueRecord }

InputState is the effective input snapshot for one extension instance.

type InputValidationError

type InputValidationError struct {
	InputID string
	Reason  string
}

InputValidationError identifies invalid input without including its value.

func (*InputValidationError) Error

func (e *InputValidationError) Error() string

func (*InputValidationError) Unwrap

func (e *InputValidationError) Unwrap() error

type InputValueRecord

type InputValueRecord struct {
	Type      string
	Value     json.RawMessage
	SecretRef string
	Active    bool
	UpdatedAt time.Time
}

InputValueRecord holds a typed persisted value or a secret reference, never secret plaintext.

type InputsRequiredError

type InputsRequiredError struct {
	InputDefinitions []ManifestInput
	MissingInputs    []string
	MissingEnv       []string
}

InputsRequiredError reports the information required before an extension can run.

func (*InputsRequiredError) Error

func (e *InputsRequiredError) Error() string

func (*InputsRequiredError) Unwrap

func (e *InputsRequiredError) Unwrap() error

type InstallOption

type InstallOption func(*installConfig)

InstallOption customizes one extension registry install operation.

func WithInstallEnabled

func WithInstallEnabled(enabled bool) InstallOption

WithInstallEnabled controls the initial enabled state for a new registry row. Replace installs preserve the existing row's state.

func WithInstallProvenance

func WithInstallProvenance(provenance ExtensionProvenance) InstallOption

WithInstallProvenance records the explicit source and trust evidence for one install.

func WithInstallRegistryMetadata

func WithInstallRegistryMetadata(slug string, registryName string, remoteVersion string) InstallOption

WithInstallRegistryMetadata records remote registry provenance for one install.

func WithInstallReplaceExisting

func WithInstallReplaceExisting() InstallOption

WithInstallReplaceExisting allows an install to overwrite an existing row.

func WithInstallScope

func WithInstallScope(scope InstallationScope) InstallOption

WithInstallScope limits a new installation; replacements preserve attachments and enablement.

func WithInstallSource

func WithInstallSource(source ExtensionSource) InstallOption

WithInstallSource overrides the persisted source tier for one install.

type Installation

type Installation struct {
	Scope     InstallationScope
	CreatedAt time.Time
}

Installation preserves one package attachment and its original creation time.

type InstallationScope

type InstallationScope struct {
	ProfileID   string
	WorkspaceID string
}

InstallationScope selects an attachment; empty profile means all profiles, empty workspace means global.

type InstanceKey

type InstanceKey struct {
	Name        string `json:"name"`
	ProfileID   string `json:"profile_id,omitempty"`
	WorkspaceID string `json:"workspace_id,omitempty"`
}

InstanceKey is the stable identity for one runtime extension instance. An empty WorkspaceID identifies the globally installed instance.

func GlobalInstanceKey

func GlobalInstanceKey(name string) InstanceKey

GlobalInstanceKey returns the published instance identity for name.

func ProfileInstanceKey

func ProfileInstanceKey(name, profileID, workspaceID string) InstanceKey

ProfileInstanceKey returns the runtime identity for one acting profile and optional workspace. The permanent default profile reuses the base process.

func (InstanceKey) IsGlobal

func (k InstanceKey) IsGlobal() bool

IsGlobal reports whether the key identifies the published global instance.

func (InstanceKey) IsProfileScoped

func (k InstanceKey) IsProfileScoped() bool

IsProfileScoped reports whether the runtime is isolated to one profile.

func (InstanceKey) Normalize

func (k InstanceKey) Normalize() InstanceKey

Normalize trims one instance key without changing its scope.

func (InstanceKey) Validate

func (k InstanceKey) Validate() error

Validate reports whether the instance identity is usable.

type IssueSeverity

type IssueSeverity = extensioncontract.IssueSeverity

IssueSeverity classifies one extension validation issue.

type KitItem

type KitItem struct {
	Kind     resources.ResourceKind `json:"kind"`
	ID       string                 `json:"id"`
	Name     string                 `json:"name"`
	Live     bool                   `json:"live"`
	SpecJSON []byte                 `json:"-"`
}

KitItem is one shipped or live extension resource, keyed by kind and name.

type LifecycleEvent

type LifecycleEvent struct {
	Type                string
	ExtensionName       string
	SourceKind          string
	DigestMatched       bool
	WorkspaceID         string
	ExtensionGeneration string
	Digest              string
	ConfirmedBy         string
	BoundCount          *int
	AutomationCount     *int
	ProfileID           string
	ProfileName         string
}

LifecycleEvent carries only the correlation values allowed by the public event matrix.

func (LifecycleEvent) RequiredFields

func (e LifecycleEvent) RequiredFields() (map[string]any, error)

RequiredFields returns the exact payload shape for the event type.

type LifecycleEventSink

type LifecycleEventSink interface {
	RecordExtensionLifecycleEvent(context.Context, LifecycleEvent) error
}

LifecycleEventSink records one closed-shape extension lifecycle event.

type LifecycleRegistry

type LifecycleRegistry interface {
	Get(name string) (*ExtensionInfo, error)
	List() ([]ExtensionInfo, error)
	Install(manifest *Manifest, path string, checksum string, opts ...InstallOption) error
	Disable(name string) error
	Uninstall(name string) error
	RestoreGatewayConfirmation(InstanceKey, GatewayConfirmation) error
}

LifecycleRegistry is the installed-extension persistence surface required by managed lifecycle helpers.

type MCPServerAuthConfig

type MCPServerAuthConfig struct {
	Method       string   `toml:"method"                 json:"method"`
	Registration string   `toml:"registration,omitempty" json:"registration,omitempty"`
	IssuerURL    string   `toml:"issuer_url,omitempty"   json:"issuer_url,omitempty"`
	ClientID     string   `toml:"client_id,omitempty"    json:"client_id,omitempty"`
	Scopes       []string `toml:"scopes,omitempty"       json:"scopes,omitempty"`
}

MCPServerAuthConfig declares authentication policy without embedding credentials.

type MCPServerConfig

type MCPServerConfig struct {
	Auth         *MCPServerAuthConfig `toml:"auth,omitempty"          json:"auth,omitzero"`
	DefaultScope string               `toml:"default_scope,omitempty" json:"default_scope,omitempty"`
	Profile      string               `toml:"profile,omitempty"       json:"profile,omitempty"`
	Command      string               `toml:"command,omitempty"       json:"command,omitempty"`
	CWD          string               `toml:"-"                       json:"-"`
	Args         []string             `toml:"args,omitempty"          json:"args,omitempty"`
	Env          map[string]string    `toml:"env,omitempty"           json:"env,omitempty"`
	SecretEnv    map[string]string    `toml:"secret_env,omitempty"    json:"secret_env,omitempty"`
	Transport    string               `toml:"transport,omitempty"     json:"transport,omitempty"`
	URL          string               `toml:"url,omitempty"           json:"url,omitempty"`
	Headers      map[string]string    `toml:"headers,omitempty"       json:"headers,omitempty"`
}

MCPServerConfig declares one MCP server packaged with the extension.

type ManagedRemovalCommit

type ManagedRemovalCommit func(context.Context) error

ManagedRemovalCommit preserves state on failure; post-commit cleanup failures only warn.

type ManagedRemoveResult

type ManagedRemoveResult struct {
	Name           string                              `json:"name"`
	Path           string                              `json:"path"`
	DataPath       string                              `json:"data_path,omitempty"`
	QuarantinePath string                              `json:"quarantine_path,omitempty"`
	Status         string                              `json:"status"`
	Warnings       []diagnosticcontract.DiagnosticItem `json:"warnings,omitempty"`
}

ManagedRemoveResult describes one removed managed extension.

func RemoveManagedExtension

func RemoveManagedExtension(
	ctx context.Context,
	homePaths compozyconfig.HomePaths,
	registry RemovalRegistry,
	name string,
	reload MutationReload,
	commit ManagedRemovalCommit,
) (_ ManagedRemoveResult, err error)

RemoveManagedExtension rolls back registry and filesystem state when reloading after removal fails.

type Manager

type Manager struct {
	// contains filtered or unexported fields
}

Manager orchestrates extension loading, subprocess lifecycle, and resource registration.

func NewManager

func NewManager(registry *Registry, opts ...Option) *Manager

NewManager constructs an extension manager with sensible defaults.

func (m *Manager) ActivateDevelopmentLink(ctx context.Context, key InstanceKey) (*Extension, error)

ActivateDevelopmentLink starts only a staged generation whose gateway requirement is already confirmed.

func (*Manager) AgentDefinitions

func (m *Manager) AgentDefinitions() []compozyconfig.AgentDef

AgentDefinitions returns the currently registered extension agent definitions.

func (*Manager) CallTool

func (m *Manager) CallTool(
	ctx context.Context,
	extensionName string,
	req toolspkg.ExtensionToolCallRequest,
) (toolspkg.ToolResult, error)

CallTool invokes one reconciled extension-host tool through the existing subprocess JSON-RPC transport.

func (*Manager) CallToolForInstance

func (m *Manager) CallToolForInstance(
	ctx context.Context,
	key InstanceKey,
	req toolspkg.ExtensionToolCallRequest,
) (toolspkg.ToolResult, error)

CallToolForInstance invokes the effective runtime bound to one trusted workspace.

func (*Manager) CloseProgram

func (m *Manager) CloseProgram(
	ctx context.Context,
	profile cmdpalette.ProfileLens,
	workspaceID cmdpalette.WorkspaceID,
	extensionName string,
	request cmdpalette.ViewCloseRequest,
) error

CloseProgram calls view/close through the same gate as open and event.

func (*Manager) CmdPalette

func (m *Manager) CmdPalette(workspaceID string, profile ProfileLens) (CmdPaletteProjection, error)

CmdPalette returns one atomic projection for an explicit profile lens.

func (*Manager) CmdPaletteSettings

func (m *Manager) CmdPaletteSettings(workspaceID string, profile ProfileLens) (CmdPaletteProjection, error)

CmdPaletteSettings returns installed contributions for operator inspection, including disabled extensions that do not belong to the live catalog.

func (*Manager) Commands

func (m *Manager) Commands(workspaceID string) ([]CommandDescriptor, []CommandGroupDescriptor, error)

Commands returns the storage-free command projection for the effective workspace extension set.

func (*Manager) ForgeCapabilities

func (m *Manager) ForgeCapabilities(
	ctx context.Context,
	remoteURLs []string,
) (extensioncontract.ForgeCapabilitiesResponse, error)

func (*Manager) Get

func (m *Manager) Get(name string) (*Extension, error)

Get returns the current snapshot for one installed extension.

func (*Manager) GetForInstance

func (m *Manager) GetForInstance(key InstanceKey) (*Extension, error)

GetForInstance resolves a workspace dev overlay before a visible published installation.

func (*Manager) HandleProgramEvent

func (m *Manager) HandleProgramEvent(
	ctx context.Context,
	profile cmdpalette.ProfileLens,
	workspaceID cmdpalette.WorkspaceID,
	extensionName string,
	event cmdpalette.ViewEvent,
) (*cmdpalette.ViewFrame, error)

HandleProgramEvent calls view/event and permits an acknowledgement-only response.

func (*Manager) HookDeclarationsForProfiles

func (m *Manager) HookDeclarationsForProfiles(
	ctx context.Context,
	profiles []ProfileLens,
) ([]hookspkg.HookDecl, error)

HookDeclarationsForProfiles resolves placement, enablement and workspace overrides before publication.

func (*Manager) InspectDevelopmentGeneration

func (m *Manager) InspectDevelopmentGeneration(
	ctx context.Context,
	workspaceID string,
	originPath string,
	generationHash string,
) (DevelopmentGeneration, error)

InspectDevelopmentGeneration verifies a dev artifact without linking or starting it.

func (*Manager) InspectPackageResources

func (m *Manager) InspectPackageResources(ctx context.Context, name string) (*Extension, error)

InspectPackageResources loads one installed package's declarative resources without registering it, starting a subprocess, or mutating runtime state.

func (*Manager) InvalidateProfileRuntime

func (m *Manager) InvalidateProfileRuntime(ctx context.Context, key InstanceKey) error

InvalidateProfileRuntime stops one profile subprocess after its launch bindings change. The next scoped call starts it with the new resolved values.

func (*Manager) LinkDevelopment

func (m *Manager) LinkDevelopment(
	ctx context.Context,
	key InstanceKey,
	originPath string,
	generationHash string,
) (*Extension, error)

LinkDevelopment verifies, activates, and persists one workspace-local generation.

func (*Manager) LinkDevelopmentFromOrigin

func (m *Manager) LinkDevelopmentFromOrigin(
	ctx context.Context,
	workspaceID string,
	originPath string,
	generationHash string,
) (*Extension, error)

LinkDevelopmentFromOrigin derives the authored name from a verified generation.

func (*Manager) List

func (m *Manager) List() []ExtensionInfo

List returns every currently known registry row in name order.

func (*Manager) ListForWorkspace

func (m *Manager) ListForWorkspace(workspaceID string) []ExtensionInfo

ListForWorkspace returns the effective extension registry for one trusted workspace.

func (*Manager) ListModelSourceRows

func (m *Manager) ListModelSourceRows(
	ctx context.Context,
	extensionName string,
	params extensioncontract.ModelSourceListParams,
) ([]extensioncontract.ModelSourceRow, error)

ListModelSourceRows calls one extension's negotiated models/list service.

func (*Manager) Logs

Logs returns retained redacted stderr entries after a cursor within the current ring identity.

func (*Manager) OpenProgram

func (m *Manager) OpenProgram(
	ctx context.Context,
	extensionName string,
	request cmdpalette.ViewOpenRequest,
) (cmdpalette.ViewFrame, uint64, error)

OpenProgram calls view/open through the standard capability and method gate.

func (*Manager) Poll

Poll resolves the watch-source kind to an active extension and calls watch/poll.

func (*Manager) ProjectForProfile

func (m *Manager) ProjectForProfile(
	ctx context.Context,
	key InstanceKey,
	profile ProfileLens,
) (*Extension, bool, error)

ProjectForProfile returns the extension resources visible through one real profile. The boolean is false when the extension is disabled for that profile.

func (*Manager) ProvideTools

func (m *Manager) ProvideTools(
	ctx context.Context,
	extensionName string,
) ([]toolspkg.ExtensionToolRuntimeDescriptor, error)

ProvideTools calls the negotiated runtime descriptor endpoint for one tool-provider extension.

func (*Manager) ProvideToolsForInstance

func (m *Manager) ProvideToolsForInstance(
	ctx context.Context,
	key InstanceKey,
) ([]toolspkg.ExtensionToolRuntimeDescriptor, error)

ProvideToolsForInstance resolves the runtime bound to one trusted workspace instance.

func (*Manager) Reload

func (m *Manager) Reload(ctx context.Context) error

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 (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) Start

func (m *Manager) Start(ctx context.Context) error

Start loads every enabled extension through the six-phase pipeline.

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) Stop

func (m *Manager) Stop(ctx context.Context) error

Stop gracefully drains all active extension subprocesses.

func (*Manager) UnlinkDevelopment

func (m *Manager) UnlinkDevelopment(ctx context.Context, key InstanceKey) error

UnlinkDevelopment removes and stops only one workspace-local instance.

func (*Manager) WatchPoll

func (m *Manager) WatchPoll(
	ctx context.Context,
	extensionName string,
	req watchpkg.PollRequest,
) (watchpkg.PollResponse, error)

WatchPoll calls the negotiated watch/poll service method on one extension.

type Manifest

type Manifest struct {
	Layout            string                              `toml:"-" json:"-"`
	Format            ExtensionFormat                     `toml:"-" json:"-"`
	IngestDiagnostics []diagnosticcontract.DiagnosticItem `toml:"-" json:"-"`

	Name        string `toml:"name"                  json:"name"`
	Version     string `toml:"version"               json:"version"`
	Description string `toml:"description,omitempty" json:"description,omitempty"`

	MinCompozyVersion string `toml:"min_compozy_version" json:"min_compozy_version"`

	Inputs       []ManifestInput     `toml:"inputs,omitempty"       json:"inputs,omitempty"`
	RequiresEnv  []string            `toml:"requires_env,omitempty" json:"requires_env,omitempty"`
	Gateway      *GatewayRequirement `toml:"gateway,omitempty"      json:"gateway,omitzero"`
	Resources    ResourcesConfig     `toml:"resources"              json:"resources"`
	Capabilities CapabilitiesConfig  `toml:"capabilities"           json:"capabilities"`
	Permissions  PermissionsConfig   `toml:"permissions"            json:"permissions"`
	Subprocess   SubprocessConfig    `toml:"subprocess"             json:"subprocess"`
	Profiles     []ManifestProfile   `toml:"profiles,omitempty"     json:"profiles,omitempty"`
}

Manifest describes one extension without executing any extension code.

func LoadManifest

func LoadManifest(dir string) (*Manifest, error)

LoadManifest reads one extension manifest from dir, preferring native manifests over a supported Agent Plugins root.

func LoadManifestWithAgentPluginDataDir

func LoadManifestWithAgentPluginDataDir(dir string, dataDir string) (*Manifest, error)

LoadManifestWithAgentPluginDataDir loads a manifest with an explicit instance-owned PLUGIN_DATA path for portable stdio server synthesis.

func SynthesizeAgentPluginManifest

func SynthesizeAgentPluginManifest(pkg *agentplugin.Package, rootDir string) (*Manifest, error)

SynthesizeAgentPluginManifest converts a validated portable package into a resource-only Compozy manifest without writing a second manifest to disk.

func (*Manifest) DormantPlacements

func (m *Manifest) DormantPlacements(profileNames []string) []ManifestPlacement

DormantPlacements returns name-bound declarations whose profile is absent.

func (*Manifest) MissingEnv

func (m *Manifest) MissingEnv(getenv func(string) string) []string

MissingEnv returns manifest-required environment variable names that are unset or empty.

func (*Manifest) PlacementMatrix

func (m *Manifest) PlacementMatrix() []ManifestPlacement

PlacementMatrix returns every profile-aware resource declaration in stable order.

func (*Manifest) Validate

func (m *Manifest) Validate() error

Validate checks the manifest schema and daemon compatibility.

type ManifestCompatibilityError

type ManifestCompatibilityError struct {
	CurrentVersion string
	MinVersion     string
}

ManifestCompatibilityError describes a daemon-version compatibility failure.

func (*ManifestCompatibilityError) Error

Error returns the daemon-version compatibility message.

func (*ManifestCompatibilityError) Is

func (e *ManifestCompatibilityError) Is(target error) bool

Is matches sentinel errors for errors.Is.

type ManifestInput

type ManifestInput = marketplace.EntryInput

ManifestInput uses the same grammar as its published catalog entry.

type ManifestNotFoundError

type ManifestNotFoundError struct {
	Dir   string
	Paths []string
}

ManifestNotFoundError describes a missing manifest directory.

func (*ManifestNotFoundError) Error

func (e *ManifestNotFoundError) Error() string

Error returns the typed missing-manifest message.

func (*ManifestNotFoundError) Is

func (e *ManifestNotFoundError) Is(target error) bool

Is matches sentinel errors for errors.Is.

type ManifestPlacement

type ManifestPlacement struct {
	Kind     string `json:"kind"`
	Resource string `json:"resource"`
	Profile  string `json:"profile,omitempty"`
}

ManifestPlacement is one resource declaration and the profile name that owns it. An empty profile means the resource is available to every profile.

type ManifestProfile

type ManifestProfile struct {
	Name        string                      `toml:"name"                  json:"name"`
	Color       string                      `toml:"color,omitempty"       json:"color,omitempty"`
	Icon        string                      `toml:"icon,omitempty"        json:"icon,omitempty"`
	Emoji       string                      `toml:"emoji,omitempty"       json:"emoji,omitempty"`
	Defaults    ManifestProfileDefaults     `toml:"defaults,omitempty"    json:"defaults,omitzero"`
	Credentials []ManifestProfileCredential `toml:"credentials,omitempty" json:"credentials,omitempty"`
}

ManifestProfile declares one profile an extension creates at install time.

type ManifestProfileCredential

type ManifestProfileCredential struct {
	Provider string `toml:"provider" json:"provider"`
	Slot     string `toml:"slot"     json:"slot"`
}

ManifestProfileCredential is one vault-backed setup requirement.

type ManifestProfileDefaults

type ManifestProfileDefaults struct {
	Agent    string `toml:"agent,omitempty"    json:"agent,omitempty"`
	Provider string `toml:"provider,omitempty" json:"provider,omitempty"`
}

ManifestProfileDefaults are seeded once when a declaration creates a profile.

type ManifestResourcePath

type ManifestResourcePath struct {
	Path    string `toml:"path"              json:"path"`
	Profile string `toml:"profile,omitempty" json:"profile,omitempty"`
}

ManifestResourcePath binds one static resource path to every profile or to exactly one profile name when Profile is set.

func (*ManifestResourcePath) UnmarshalJSON

func (r *ManifestResourcePath) UnmarshalJSON(data []byte) error

UnmarshalJSON translates string paths until their removal in v0.3.0-beta.31.

func (*ManifestResourcePath) UnmarshalTOML

func (r *ManifestResourcePath) UnmarshalTOML(value any) error

UnmarshalTOML shares the JSON boundary's path and placement validation.

type ManifestToolDescriptor

type ManifestToolDescriptor struct {
	Name              string
	Profile           string
	Tool              toolspkg.Tool
	RuntimeDescriptor toolspkg.ExtensionToolRuntimeDescriptor
}

ManifestToolDescriptor is a manifest-authoritative cold descriptor plus runtime proof metadata.

func ResolveManifestToolDescriptors

func ResolveManifestToolDescriptors(manifest *Manifest) ([]ManifestToolDescriptor, error)

ResolveManifestToolDescriptors converts manifest tool declarations into cold specs and digest proofs.

type ManifestValidationError

type ManifestValidationError struct {
	Field   string
	Value   string
	Message string
}

ManifestValidationError describes an invalid manifest field.

func (*ManifestValidationError) Error

func (e *ManifestValidationError) Error() string

Error returns the field-specific validation message.

func (*ManifestValidationError) Is

func (e *ManifestValidationError) Is(target error) bool

Is matches sentinel errors for errors.Is.

type MarketplaceDigestVerificationObserver

type MarketplaceDigestVerificationObserver func(*MarketplaceTrustEvidence, error)

MarketplaceDigestVerificationObserver receives a pre-extraction verification outcome.

type MarketplaceInstallRequest

type MarketplaceInstallRequest struct {
	Plugin                    *MarketplacePluginAcquisition
	Scope                     InstallationScope
	ExpectedDigest            string
	Slug                      string
	SourceFilter              string
	Version                   string
	Asset                     string
	PolicyAllowsUnverified    bool
	AllowUnverified           bool
	InstalledBy               string
	Trust                     *MarketplaceTrustEvidence
	ArtifactHTTPClient        *http.Client
	ObserveDigestVerification MarketplaceDigestVerificationObserver
}

MarketplaceInstallRequest describes one marketplace-backed extension install.

type MarketplacePackageAcquirer

type MarketplacePackageAcquirer interface {
	Acquire(context.Context, pluginsource.AcquisitionRecord, string) (io.ReadCloser, error)
}

type MarketplacePluginAcquisition

type MarketplacePluginAcquisition struct {
	SourceName string
	Record     pluginsource.AcquisitionRecord
	Acquirer   MarketplacePackageAcquirer
}

MarketplacePluginAcquisition is server-owned projection evidence, separate from curated trust.

type MarketplaceSourceLoader

type MarketplaceSourceLoader func(context.Context) ([]registrypkg.Source, error)

MarketplaceSourceLoader resolves configured marketplace sources. The optional source filter is an already-normalized operator/tool input.

type MarketplaceTrustEvidence

type MarketplaceTrustEvidence struct {
	CatalogEntryID      string
	Version             string
	ArchiveDigestSHA256 string
	RegistryTier        string
	ArtifactURL         string
	Repository          string
}

MarketplaceTrustEvidence contains feed-authoritative install metadata.

type MarketplaceTrustResolver

type MarketplaceTrustResolver func(
	context.Context,
	string,
	string,
) (*MarketplaceTrustEvidence, error)

MarketplaceTrustResolver resolves curated evidence; nil marks a non-curated side-load.

type MarketplaceUpdateBatchError

type MarketplaceUpdateBatchError struct {
	FailedName string
	Completed  []MarketplaceUpdateResult
	Cause      error
}

MarketplaceUpdateBatchError retains every target outcome and the causes of a partially failed batch.

func (*MarketplaceUpdateBatchError) Error

func (*MarketplaceUpdateBatchError) Unwrap

func (e *MarketplaceUpdateBatchError) Unwrap() error

type MarketplaceUpdateCommit

type MarketplaceUpdateCommit func(ExtensionInfo, *Manifest) error

MarketplaceUpdateCommit runs after registry persistence; failure restores the prior installation.

type MarketplaceUpdatePreflight

type MarketplaceUpdatePreflight func(ExtensionInfo, *Manifest) error

MarketplaceUpdatePreflight validates a candidate before it replaces the installed files.

type MarketplaceUpdateRequest

type MarketplaceUpdateRequest struct {
	Names                     []string
	All                       bool
	CheckOnly                 bool
	Version                   string
	PolicyAllowsUnverified    bool
	AllowUnverified           bool
	InstalledBy               string
	ResolveTrust              MarketplaceTrustResolver
	ResolvePlugin             MarketplacePluginResolver
	ArtifactHTTPClient        *http.Client
	ObserveDigestVerification MarketplaceDigestVerificationObserver
	PreflightCandidate        MarketplaceUpdatePreflight
	CommitCandidate           MarketplaceUpdateCommit
	RollbackCandidate         MarketplaceUpdateRollback
	// contains filtered or unexported fields
}

MarketplaceUpdateRequest describes one marketplace update batch.

type MarketplaceUpdateResult

type MarketplaceUpdateResult struct {
	Name           string                              `json:"name"`
	Slug           string                              `json:"slug"`
	Registry       string                              `json:"registry"`
	CurrentVersion string                              `json:"current_version,omitempty"`
	LatestVersion  string                              `json:"latest_version,omitempty"`
	Path           string                              `json:"path"`
	Status         string                              `json:"status"`
	Warnings       []diagnosticcontract.DiagnosticItem `json:"warnings,omitempty"`
	Error          *diagnosticcontract.DiagnosticItem  `json:"error,omitzero"`
}

MarketplaceUpdateResult describes one marketplace update outcome.

func UpdateMarketplaceManaged

func UpdateMarketplaceManaged(
	ctx context.Context,
	homePaths compozyconfig.HomePaths,
	registry LifecycleRegistry,
	loader MarketplaceSourceLoader,
	req MarketplaceUpdateRequest,
	reload MutationReload,
) ([]MarketplaceUpdateResult, error)

UpdateMarketplaceManaged updates marketplace extensions with rollback on reload failure.

type MarketplaceUpdateRollback

type MarketplaceUpdateRollback func(context.Context, ExtensionInfo) error

MarketplaceUpdateRollback restores candidate-owned state after the previous package and registry record have been restored successfully, and before that installation is reloaded.

type ModelSource

type ModelSource struct {
	// contains filtered or unexported fields
}

ModelSource adapts one extension into a daemon-owned model catalog source.

func NewExtensionModelSource

func NewExtensionModelSource(info *ExtensionInfo, resolver ModelSourceRuntimeResolver) (*ModelSource, error)

NewExtensionModelSource creates a daemon model catalog source for one extension.

func (*ModelSource) CatalogExecutionFingerprint

func (s *ModelSource) CatalogExecutionFingerprint() (string, error)

CatalogExecutionFingerprint isolates rows produced by one installed extension generation.

func (*ModelSource) ID

func (s *ModelSource) ID() string

ID returns the stable extension source id.

func (*ModelSource) Kind

Kind returns extension.

func (*ModelSource) ListModels

ListModels calls the extension models/list service and validates rows before persistence.

func (*ModelSource) Priority

func (s *ModelSource) Priority() int

Priority returns the extension merge priority.

func (*ModelSource) TTL

func (s *ModelSource) TTL() time.Duration

TTL keeps extension-provided releases on the same automatic refresh cadence as live providers.

type ModelSourceRuntime

type ModelSourceRuntime interface {
	ListModelSourceRows(
		ctx context.Context,
		extensionName string,
		params extensioncontract.ModelSourceListParams,
	) ([]extensioncontract.ModelSourceRow, error)
}

ModelSourceRuntime calls Compozy-to-extension model source services.

type ModelSourceRuntimeResolver

type ModelSourceRuntimeResolver func() ModelSourceRuntime

ModelSourceRuntimeResolver returns the current extension runtime.

type MutationReload

type MutationReload func(context.Context) error

MutationReload is called after a registry/on-disk mutation and before the lifecycle helper commits any staged filesystem backup.

type Option

type Option func(*Manager)

Option customizes an extension manager.

func WithCapabilityChecker

func WithCapabilityChecker(checker *CapabilityChecker) Option

WithCapabilityChecker injects the grant evaluator used for Host API authorization.

func WithCompozyExecutableResolver

func WithCompozyExecutableResolver(resolver func() (string, error)) Option

WithCompozyExecutableResolver overrides the binary used by {{compozy_executable}} manifest templates.

func WithDefaultHookTimeout

func WithDefaultHookTimeout(timeout time.Duration) Option

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

func WithGetenv(getenv func(string) string) Option

WithGetenv overrides environment lookup used for manifest template expansion.

func WithHealthCheckTimeout

func WithHealthCheckTimeout(timeout time.Duration) Option

WithHealthCheckTimeout overrides the negotiated health probe timeout.

func WithHomePaths

func WithHomePaths(paths compozyconfig.HomePaths) Option

WithHomePaths binds extension-owned runtime data to the daemon's canonical home layout.

func WithHostMethodHandler

func WithHostMethodHandler(method string, handler subprocess.HandlerFunc) Option

WithHostMethodHandler registers one Host API method handler for launched extensions.

func WithInitializeTimeout

func WithInitializeTimeout(timeout time.Duration) Option

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

func WithLogger(logger *slog.Logger) Option

WithLogger injects the logger used for extension diagnostics.

func WithNow

func WithNow(now func() time.Time) Option

WithNow overrides the manager clock, mainly for tests.

func WithProcessRegistry

func WithProcessRegistry(registry *toolruntime.Registry) Option

WithProcessRegistry injects shared tool process ownership tracking.

func WithProfileNameResolver

func WithProfileNameResolver(resolver ProfileNameResolver) Option

WithProfileNameResolver binds profile-scoped subprocesses to canonical profile names.

func WithSecretResolver

func WithSecretResolver(resolver SecretRefResolver) Option

WithSecretResolver injects the daemon vault resolver used for extension secret env bindings.

func WithSourceSessionManager

func WithSourceSessionManager(manager resources.SourceSessionManager) Option

WithSourceSessionManager injects the resource source-session manager used to activate extension nonces for snapshot publication.

func WithSubprocessSignalGrace

func WithSubprocessSignalGrace(timeout time.Duration) Option

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 PreparedMarketplaceManagedInstall

type PreparedMarketplaceManagedInstall struct {
	// contains filtered or unexported fields
}

PreparedMarketplaceManagedInstall owns a validated staged artifact until it is committed to one extension instance or closed.

func PrepareMarketplaceManagedInstall

func PrepareMarketplaceManagedInstall(
	ctx context.Context,
	homePaths compozyconfig.HomePaths,
	registry LifecycleRegistry,
	loader MarketplaceSourceLoader,
	req MarketplaceInstallRequest,
) (*PreparedMarketplaceManagedInstall, error)

PrepareMarketplaceManagedInstall downloads and validates an artifact without exposing it through the managed install or registry read surfaces.

func (*PreparedMarketplaceManagedInstall) Close

Close releases any staging directory retained by preparation.

func (*PreparedMarketplaceManagedInstall) Commit

Commit moves the staged artifact into place and attaches it to the resolved scope.

func (*PreparedMarketplaceManagedInstall) Digest

Digest returns the digest of the acquired archive, including unpinned direct-source previews.

func (*PreparedMarketplaceManagedInstall) Manifest

Manifest returns an isolated copy of the validated staged manifest.

func (*PreparedMarketplaceManagedInstall) MatchesInstalled

func (p *PreparedMarketplaceManagedInstall) MatchesInstalled(info *ExtensionInfo) bool

MatchesInstalled identifies a retry of the same acquisition; callers still validate input readiness.

func (*PreparedMarketplaceManagedInstall) Name

Name returns the validated extension instance name discovered from the staged artifact.

func (*PreparedMarketplaceManagedInstall) Origin

Origin returns acquisition identity independently of the source display name.

func (*PreparedMarketplaceManagedInstall) Reinstall

Reinstall reuses the staged acquisition and update transaction, preserving existing attachments. The caller holds the package lifecycle lock and authorizes unclassified-origin association.

func (*PreparedMarketplaceManagedInstall) ValidateReinstall

func (p *PreparedMarketplaceManagedInstall) ValidateReinstall(info *ExtensionInfo) error

ValidateReinstall refuses another classified origin and packages outside the managed root. Associating an unclassified package with a listing requires operator authorization at the caller.

type ProfileLens

type ProfileLens struct {
	ID   string
	Name string
}

ProfileLens identifies the profile whose extension contributions are being projected.

type ProfileNameResolver

type ProfileNameResolver interface {
	ProfileName(context.Context, string) (string, error)
}

ProfileNameResolver resolves an active profile identity for runtime scope binding.

type PublishRequest

type PublishRequest struct {
	GenerationDir string
	Repository    string
	TagName       string
	Draft         bool
}

PublishRequest identifies one immutable generation and its GitHub release. The uploader owns authentication; credentials never enter this value.

type PublishResult

type PublishResult struct {
	ReleaseURL   string `json:"release_url"`
	AssetURL     string `json:"asset_url"`
	DigestSHA256 string `json:"digest_sha256"`
}

PublishResult reports the release locations and archive integrity digest.

func PublishRelease

func PublishRelease(
	ctx context.Context,
	uploader registrygithub.ReleaseUploader,
	request PublishRequest,
) (*PublishResult, error)

PublishRelease archives a validated generation and uploads it with a digest sidecar.

type Readiness

type Readiness struct {
	MissingInputs []string
	MissingEnv    []string
}

Readiness separates missing typed inputs from requires_env requirements.

func InputReadiness

func InputReadiness(manifest *Manifest, state InputState, getenv func(string) string) Readiness

InputReadiness uses stored values/defaults for URL inputs and permits environment fallback only for env inputs.

func (Readiness) RequiredError

func (r Readiness) RequiredError(manifest *Manifest) error

RequiredError names manifest input IDs while retaining the separate missing environment list.

type Registry

type Registry struct {
	// contains filtered or unexported fields
}

Registry persists installed extension metadata in the global SQLite database.

func NewRegistry

func NewRegistry(db *sql.DB) *Registry

NewRegistry constructs a registry over an existing SQLite connection.

func (*Registry) AttachInstallation

func (r *Registry) AttachInstallation(ctx context.Context, name string, scope InstallationScope) error

AttachInstallation adds one exact scope without changing the package or another attachment. Retrying the same attachment preserves its original timestamp.

func (*Registry) ConfirmDevelopmentGatewayCandidate

func (r *Registry) ConfirmDevelopmentGatewayCandidate(
	key InstanceKey,
	digest string,
	actor string,
	at time.Time,
) error

ConfirmDevelopmentGatewayCandidate records consent for one inspected dev generation before its process is allowed to start. The caller must hold the extension lifecycle lock and must have derived digest from that immutable generation.

func (*Registry) ConfirmGatewayRequirement

func (r *Registry) ConfirmGatewayRequirement(
	key InstanceKey,
	expectedDigest string,
	actor string,
	at time.Time,
) error

ConfirmGatewayRequirement records actor attribution only for the digest currently on disk.

func (*Registry) DB

func (r *Registry) DB() *sql.DB

DB exposes the backing SQLite handle for composition-root integrations that need to build additional stores over the same registry database.

func (*Registry) DetachInstallation

func (r *Registry) DetachInstallation(ctx context.Context, name string, scope InstallationScope) error

DetachInstallation removes only the exact attachment. Package deletion belongs to the lifecycle coordinator after it retires the final installed instance.

func (*Registry) DevLinkNamesForWorkspace

func (r *Registry) DevLinkNamesForWorkspace(workspaceID string) (names []string, resultErr error)

DevLinkNamesForWorkspace returns the development source owners trusted by one workspace.

func (*Registry) Disable

func (r *Registry) Disable(name string) error

Disable records a disabled exception for the default profile.

func (*Registry) DisableIfLifecycleToken

func (r *Registry) DisableIfLifecycleToken(
	name string,
	expectedToken string,
) (bool, error)

DisableIfLifecycleToken disables the default-profile runtime only when the persisted lifecycle owner still matches the instance requesting cleanup.

func (*Registry) Enable

func (r *Registry) Enable(name string) error

Enable removes the disabled exception for the default profile.

func (*Registry) EnabledBundledNames

func (r *Registry) EnabledBundledNames() ([]string, error)

EnabledBundledNames returns a cached snapshot of enabled bundled extension names.

func (*Registry) GatewayConfirmation

func (r *Registry) GatewayConfirmation(key InstanceKey) (GatewayConfirmation, error)

GatewayConfirmation returns valid state only while the persisted tuple matches the current artifact.

func (*Registry) Get

func (r *Registry) Get(name string) (*ExtensionInfo, error)

Get returns one installed extension by name.

func (r *Registry) GetDevLink(name, workspaceID string) (*DevLink, error)

GetDevLink returns one workspace-local overlay row.

func (*Registry) Install

func (r *Registry) Install(manifest *Manifest, path string, checksum string, opts ...InstallOption) error

Install verifies the extension artifact checksum and persists the install as a user-sourced extension.

func (*Registry) Installations

func (r *Registry) Installations(ctx context.Context, name string) ([]Installation, error)

Installations lists persisted attachments, including disabled installations.

func (*Registry) IsEnabledForProfile

func (r *Registry) IsEnabledForProfile(name string, profileID string) (bool, error)

IsEnabledForProfile returns the effective state for one installed or dev-linked extension. Enablement rows are exceptions: an absent row means enabled.

func (*Registry) LinkDev

func (r *Registry) LinkDev(req DevLinkRequest) (*DevLink, error)

LinkDev upserts one workspace-local overlay without modifying a published row.

func (*Registry) List

func (r *Registry) List() (extensions []ExtensionInfo, err error)

List returns every installed extension ordered by name.

func (r *Registry) ListDevLinks() (links []DevLink, resultErr error)

ListDevLinks returns every dev overlay in stable instance-key order.

func (*Registry) PlacementsForProfile

func (r *Registry) PlacementsForProfile(
	ctx context.Context,
	profileName string,
) ([]profilepkg.PlacementRef, error)

PlacementsForProfile returns installed manifest resources bound to one profile name.

func (*Registry) ReconcileBundledProvenance

func (r *Registry) ReconcileBundledProvenance(manifest *Manifest) error

ReconcileBundledProvenance persists the canonical first-party trust evidence for an already installed bundled extension without changing its lifecycle state.

func (*Registry) ResolveActive

func (r *Registry) ResolveActive(name, workspaceID string) (*ActiveExtension, error)

ResolveActive prefers a workspace dev overlay and falls back to the published row.

func (*Registry) ResolveInstallation

func (r *Registry) ResolveInstallation(
	ctx context.Context,
	name string,
	scope InstallationScope,
) (Installation, error)

ResolveInstallation selects a workspace attachment before an inherited global attachment, then the exact profile before an all-profiles attachment.

func (*Registry) RestoreGatewayConfirmation

func (r *Registry) RestoreGatewayConfirmation(key InstanceKey, confirmation GatewayConfirmation) error

RestoreGatewayConfirmation restores a previously snapshotted confirmation tuple during lifecycle rollback. The caller must hold the lifecycle authority for the extension name.

func (*Registry) RestoreRemovalState

func (r *Registry) RestoreRemovalState(ctx context.Context, name string, snapshot RemovalState) error

RestoreRemovalState restores profile records atomically before runtime publication resumes.

func (*Registry) SetEnabledForProfile

func (r *Registry) SetEnabledForProfile(name string, profileID string, enabled bool) error

SetEnabledForProfile persists only disabled exceptions; enabling removes the row.

func (*Registry) SnapshotRemovalState

func (r *Registry) SnapshotRemovalState(ctx context.Context, name string) (RemovalState, error)

SnapshotRemovalState captures dependent profile records before uninstall.

func (*Registry) Uninstall

func (r *Registry) Uninstall(name string) error

Uninstall removes one extension from the registry.

func (*Registry) UnlinkDev

func (r *Registry) UnlinkDev(name, workspaceID string) error

UnlinkDev removes only the workspace overlay row.

type RemovalRegistry

type RemovalRegistry interface {
	LifecycleRegistry
	SnapshotRemovalState(context.Context, string) (RemovalState, error)
	RestoreRemovalState(context.Context, string, RemovalState) error
}

RemovalRegistry includes profile records needed to compensate an uninstall.

type RemovalState

type RemovalState struct {
	// contains filtered or unexported fields
}

RemovalState retains profile-owned records deleted by extension removal cascades.

type ResolvedManifestMCPServer

type ResolvedManifestMCPServer struct {
	compozyconfig.MCPServer
	DefaultScope string
}

ResolvedManifestMCPServer keeps the install default separate from runtime transport configuration.

func ResolveManifestMCPServerResources

func ResolveManifestMCPServerResources(
	rootDir string,
	manifest *Manifest,
	state InputState,
	getenv func(string) string,
) ([]ResolvedManifestMCPServer, error)

ResolveManifestMCPServerResources converts manifest MCP declarations into MCP server specs.

type ResourceGrantRequest

type ResourceGrantRequest struct {
	Families []string                    `toml:"families,omitempty"  json:"families,omitempty"`
	MaxScope resources.ResourceScopeKind `toml:"max_scope,omitempty" json:"max_scope,omitempty"`
}

ResourceGrantRequest declares the resource families and scope ceiling an extension requests.

type ResourcesConfig

type ResourcesConfig struct {
	Skills        []ManifestResourcePath     `toml:"skills,omitempty"         json:"skills,omitempty"`
	Loops         []ManifestResourcePath     `toml:"loops,omitempty"          json:"loops,omitempty"`
	Agents        []ManifestResourcePath     `toml:"agents,omitempty"         json:"agents,omitempty"`
	Automation    []ManifestResourcePath     `toml:"automation,omitempty"     json:"automation,omitempty"`
	Layouts       []ManifestResourcePath     `toml:"layouts,omitempty"        json:"layouts,omitempty"`
	Hooks         []HookConfig               `toml:"hooks,omitempty"          json:"hooks,omitempty"`
	Tools         map[string]ToolConfig      `toml:"tools,omitempty"          json:"tools,omitempty"`
	CommandGroups []manifestCommandGroupSpec `toml:"command_groups,omitempty" json:"command_groups,omitempty"`
	CmdPalette    CmdPaletteConfig           `toml:"cmd_palette,omitempty"    json:"cmd_palette,omitzero"`
	MCPServers    map[string]MCPServerConfig `toml:"mcp_servers,omitempty"    json:"mcp_servers,omitempty"`
	Publish       ResourceGrantRequest       `toml:"publish,omitempty"        json:"publish"`
}

ResourcesConfig declares static assets packaged with an extension.

type ScaffoldRequest

type ScaffoldRequest struct {
	Name      string
	Template  ScaffoldTemplate
	Directory string
}

ScaffoldRequest configures one extension project created from embedded assets.

type ScaffoldResult

type ScaffoldResult struct {
	Name      string           `json:"name"`
	Template  ScaffoldTemplate `json:"template"`
	Directory string           `json:"directory"`
	Files     []string         `json:"files"`
}

ScaffoldResult describes the created project.

func ScaffoldExtension

func ScaffoldExtension(req ScaffoldRequest) (result *ScaffoldResult, resultErr error)

ScaffoldExtension creates a project atomically from the binary's embedded templates.

type ScaffoldTemplate

type ScaffoldTemplate string

ScaffoldTemplate identifies one embedded extension authoring template.

const (
	ScaffoldTemplateToolProviderTS ScaffoldTemplate = "tool-provider-ts"
	ScaffoldTemplateToolProviderGo ScaffoldTemplate = "tool-provider-go"
	ScaffoldTemplateViewProviderTS ScaffoldTemplate = "view-provider-ts"
	// #nosec G101 -- this public scaffold identifier is not a credential.
	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

type SecretRefResolver interface {
	ResolveRef(context.Context, string) (string, error)
}

SecretRefResolver resolves env: and vault: refs for extension launch bindings.

type SourceChangedError

type SourceChangedError struct {
	ListedDigest  string
	FetchedDigest string
	Cause         error
}

SourceChangedError identifies an approved acquisition that no longer matches its source or bytes.

func (*SourceChangedError) Error

func (e *SourceChangedError) Error() string

func (*SourceChangedError) Is

func (e *SourceChangedError) Is(target error) bool

func (*SourceChangedError) Unwrap

func (e *SourceChangedError) Unwrap() error

type StaticAgent

type StaticAgent struct {
	Agent     compozyconfig.AgentDef
	Soul      *AgentSidecar
	Heartbeat *AgentSidecar
}

StaticAgent is one complete agent directory shipped by an extension.

func LoadAgentResources

func LoadAgentResources(rootDir string, paths []string) ([]StaticAgent, error)

LoadAgentResources loads the strict <entry>/<agent>/AGENT.md resource contract.

type SubprocessConfig

type SubprocessConfig struct {
	Command             string            `toml:"command,omitempty"               json:"command,omitempty"`
	Args                []string          `toml:"args,omitempty"                  json:"args,omitempty"`
	Env                 map[string]string `toml:"env,omitempty"                   json:"env,omitempty"`
	SecretEnv           map[string]string `toml:"secret_env,omitempty"            json:"secret_env,omitempty"`
	HealthCheckInterval Duration          `toml:"health_check_interval,omitempty" json:"health_check_interval,omitempty"`
	ShutdownTimeout     Duration          `toml:"shutdown_timeout,omitempty"      json:"shutdown_timeout,omitempty"`
}

SubprocessConfig describes how to launch and monitor the extension process.

type ToolBackendConfig

type ToolBackendConfig struct {
	Kind    string `toml:"kind,omitempty"    json:"kind,omitempty"`
	Handler string `toml:"handler,omitempty" json:"handler,omitempty"`
	Server  string `toml:"server,omitempty"  json:"server,omitempty"`
	Tool    string `toml:"tool,omitempty"    json:"tool,omitempty"`
}

ToolBackendConfig binds a manifest tool to its backend metadata.

type ToolConfig

type ToolConfig struct {
	Profile              string            `toml:"profile,omitempty"               json:"profile,omitempty"`
	ID                   string            `toml:"id,omitempty"                    json:"id,omitempty"`
	DisplayTitle         string            `toml:"display_title,omitempty"         json:"display_title,omitempty"`
	FriendlyVerb         string            `toml:"friendly_verb,omitempty"         json:"friendly_verb,omitempty"`
	Preview              string            `toml:"preview,omitempty"               json:"preview,omitempty"`
	Description          string            `toml:"description,omitempty"           json:"description,omitempty"`
	Handler              string            `toml:"handler,omitempty"               json:"handler,omitempty"`
	Backend              ToolBackendConfig `toml:"backend,omitempty"               json:"backend"`
	InputSchema          json.RawMessage   `toml:"input_schema,omitempty"          json:"input_schema,omitempty"`
	OutputSchema         json.RawMessage   `toml:"output_schema,omitempty"         json:"output_schema,omitempty"`
	Risk                 string            `toml:"risk,omitempty"                  json:"risk,omitempty"`
	ReadOnly             bool              `toml:"read_only,omitempty"             json:"read_only,omitzero"`
	Destructive          bool              `toml:"destructive,omitempty"           json:"destructive,omitzero"`
	OpenWorld            bool              `toml:"open_world,omitempty"            json:"open_world,omitzero"`
	RequiresInteraction  bool              `toml:"requires_interaction,omitempty"  json:"requires_interaction,omitzero"`
	ConcurrencySafe      bool              `toml:"concurrency_safe,omitempty"      json:"concurrency_safe,omitzero"`
	MaxResultBytes       int64             `toml:"max_result_bytes,omitempty"      json:"max_result_bytes,omitzero"`
	Toolsets             []string          `toml:"toolsets,omitempty"              json:"toolsets,omitempty"`
	Tags                 []string          `toml:"tags,omitempty"                  json:"tags,omitempty"`
	SearchHints          []string          `toml:"search_hints,omitempty"          json:"search_hints,omitempty"`
	RequiresEnv          []string          `toml:"requires_env,omitempty"          json:"requires_env,omitempty"`
	RequiredCapabilities []string          `toml:"required_capabilities,omitempty" json:"required_capabilities,omitempty"`
	Visibility           string            `toml:"visibility,omitempty"            json:"visibility,omitempty"`

	Command *manifestCommandSpec `toml:"command,omitempty" json:"command,omitzero"`
}

ToolConfig declares one static tool packaged with the extension.

func (*ToolConfig) UnmarshalTOML

func (c *ToolConfig) UnmarshalTOML(value any) error

UnmarshalTOML preserves JSON Schema objects inside a TOML tool table.

type ValidationIssue

type ValidationIssue = extensioncontract.ValidationIssue

ValidationIssue is one positioned extension validation diagnostic.

type ValidationReport

type ValidationReport = apicontract.ExtensionValidatePayload

ValidationReport is the structured daemon-free result shared by CLI and native authoring surfaces.

func ValidateBundleReport

func ValidateBundleReport(dir string) (*ValidationReport, error)

ValidateBundleReport adds the permission-derived consent summary to ValidateBundle.

type ViewPatchPublisher

type ViewPatchPublisher interface {
	PublishViewPatch(
		context.Context,
		cmdpalette.ProfileLens,
		cmdpalette.WorkspaceID,
		string,
		cmdpalette.ViewPatch,
	) error
}

ViewPatchPublisher fans out one declarative command-palette view patch.

Source Files

Directories

Path Synopsis
Package agentplugin reads and validates portable Agent Plugins packages.
Package agentplugin reads and validates portable Agent Plugins packages.
scaffold_templates
Package surfaces defines the static extension resource surface policy.
Package surfaces defines the static extension resource surface policy.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL