Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

plugin

package

Go to main page

Versions in this module

v0

v0.2.0

Aug 17, 2026

v0.1.11

Jul 23, 2026

v0.1.10

Jul 23, 2026

v0.1.9

Jul 23, 2026

v0.1.8

Jul 18, 2026

v0.1.7

Jul 18, 2026

v0.1.6

Jul 18, 2026

v0.1.5

Jul 6, 2026

v0.1.4

Jul 6, 2026

v0.1.3

Jul 2, 2026

Changes in this version

+ const AuditSchemaVersion

+ const LockSchemaVersion

+ const ManifestSchemaVersion

+ const PluginCallSchema

+ const PluginResultSchema

+ const RegistrySchemaVersion

+ var ErrRunnerUnavailable = errors.New("plugin runner unavailable")

+ func EnabledCount(registry Registry) int

+ func FormatBool(value bool) string

+ func HasAnyPermission(plugin RegistryPlugin, permission string) bool

+ func HasPermission(plugin RegistryPlugin, permission, capability string) bool

+ func RegistryAssetPaths() []string

+ func RunnerErrorCode(err error) string

+ func ScopeOrDefault(scope string) string

+ func StoreError(code, message string) error

+ func ValidateActionPlanBoundary(plugin RegistryPlugin, result ResultEnvelope) error

+ func ValidateApproval(yes bool) error

+ func ValidateInstalled(ok bool) error

+ func ValidatePermissionName(permission string) error

+ func ValidateRunPermission(plugin RegistryPlugin, capability string) error

+ type AuditEvent struct

+ At string

+ Capability string

+ ErrorCode string

+ ManifestSHA256 string

+ PluginID string

+ Runtime RuntimeKind

+ SchemaVersion string

+ Status string

+ Type string

+ Version string

+ type Budgets struct

+ MaxInputBytes int

+ MaxMemoryMB int

+ MaxOutputBytes int

+ TimeoutMS int

+ type CallEnvelope struct

+ Budgets RunnerBudgets

+ CallID string

+ Capability string

+ Input json.RawMessage

+ Permissions RuntimePermission

+ PluginID string

+ SchemaVersion string

+ type Capability struct

+ ID string

+ InputSchema string

+ Kind string

+ OutputSchema string

+ type ExternalRunRequest struct

+ Budgets RunnerBudgets

+ Capability string

+ Input any

+ Manifest Manifest

+ PluginRoot string

+ type ExternalRunner struct

+ func (r ExternalRunner) Run(ctx context.Context, req ExternalRunRequest) (ResultEnvelope, error)

+ type Hook struct

+ Capability string

+ Event string

+ type HookRegistration struct

+ CapabilityID string

+ DirectWrite bool

+ Kind string

+ PluginID string

+ Target string

+ type HookRegistry struct

+ func NewHookRegistry() *HookRegistry

+ func (r *HookRegistry) Diagnostics() []HookRegistration

+ func (r *HookRegistry) QuerySources() []HookRegistration

+ func (r *HookRegistry) Register(plugin RegistryPlugin, hook HookRegistration) error

+ func (r *HookRegistry) TemplateFunctions() []HookRegistration

+ type LockEntry struct

+ EntrypointSHA256 string

+ ID string

+ InstalledAt string

+ InstalledByCommand string

+ ManifestSHA256 string

+ Runtime RuntimeKind

+ RuntimeEntrypoint string

+ RuntimeRoot string

+ Version string

+ type LockFile struct

+ Plugins []LockEntry

+ SchemaVersion string

+ UpdatedAt string

+ type Manifest struct

+ Budgets Budgets

+ Capabilities []Capability

+ Checksum string

+ Hooks []Hook

+ ID string

+ Name string

+ Permissions Permissions

+ Runtime Runtime

+ SchemaVersion string

+ Version string

+ type PermissionGrant struct

+ Capability string

+ GrantedAt string

+ Permission string

+ type Permissions struct

+ Filesystem map[string]string

+ Network bool

+ Vault map[string]string

+ type Registry struct

+ Facts map[string]string

+ Plugins []RegistryPlugin

+ SchemaVersion string

+ UpdatedAt string

+ type RegistryPlugin struct

+ Budgets Budgets

+ Capabilities []Capability

+ CapabilityCount int

+ Enabled bool

+ ID string

+ InstalledAt string

+ ManifestSHA256 string

+ Name string

+ PermissionGrants []PermissionGrant

+ PermissionSummary string

+ Runtime RuntimeKind

+ RuntimeEntrypoint string

+ RuntimeRoot string

+ Scope string

+ UpdatedAt string

+ Version string

+ func FindPlugin(registry Registry, id string) (RegistryPlugin, bool)

+ type ResultEnvelope struct

+ ActionPlan any

+ Data any

+ Facts map[string]string

+ SchemaVersion string

+ Status string

+ Warnings []string

+ type RunRequest struct

+ Budgets RunnerBudgets

+ Capability string

+ Input any

+ Plugin RegistryPlugin

+ type RunnerBudgets struct

+ MaxInputBytes int

+ MaxMemoryMB int

+ MaxOutputBytes int

+ TimeoutMS int

+ func RunnerBudgetsFromManifest(b Budgets) RunnerBudgets

+ type RunnerError struct

+ Code string

+ Err error

+ Message string

+ func (e *RunnerError) Error() string

+ func (e *RunnerError) Unwrap() error

+ type Runtime struct

+ Entrypoint string

+ Kind RuntimeKind

+ type RuntimeKind string

+ const RuntimeJavaScript

+ const RuntimeProcess

+ const RuntimePython

+ const RuntimeWASM

+ type RuntimePermission struct

+ Env []string

+ FilesystemRead string

+ FilesystemWrite string

+ Network bool

+ type Store struct

+ Now func() time.Time

+ Root string

+ func (s Store) AppendAudit(event AuditEvent) error

+ func (s Store) GrantPermission(id, permission, capability string) (RegistryPlugin, error)

+ func (s Store) Install(path, scope string) (RegistryPlugin, error)

+ func (s Store) LoadRegistry() (Registry, error)

+ func (s Store) RevokePermission(id, permission, capability string) (RegistryPlugin, error)

+ func (s Store) SetEnabled(id string, enabled bool) (RegistryPlugin, error)

+ func (s Store) Uninstall(id string) (RegistryPlugin, Registry, error)

+ type ValidationError struct

+ Code string

+ Issues []ValidationIssue

+ func (e *ValidationError) Error() string

+ type ValidationIssue struct

+ Code string

+ Field string

+ Message string

+ type ValidationResult struct

+ CapabilityCount int

+ Digest string

+ Manifest Manifest

+ ManifestPath string

+ PermissionSummary string

+ WriteStatus bool

+ func ValidateManifestPath(path string) (ValidationResult, error)

+ type WASMRunner struct

+ Invoke func(context.Context, CallEnvelope) (ResultEnvelope, error)

+ func (r WASMRunner) Run(ctx context.Context, req RunRequest) (ResultEnvelope, error)