Skip to main content

Module plugin

Module plugin 

Source
Expand description

Passive portable plugin package discovery and validation.

A plugin package is inert inventory. Discovery never executes provider overlays or reserved active component descriptors.

Structs§

AppliedPluginPolicy
One applied local policy decision with its audit provenance.
ComponentReference
Parsed portable component reference.
HookRecord
One inert plugin-local hook contract with its exact approval identity.
InlineFallback
Authored inline fallback for an agent member.
PluginCandidate
Safe read-only candidate summary used by plugin list/show.
PluginDependency
One plugin dependency.
PluginDiagnostic
Machine-readable plugin resolution diagnostic.
PluginInventory
Passive plugin inventory for one source.
PluginInventoryWarning
One non-fatal plugin inventory warning.
PluginListReport
Read-only plugin list report including unselected offers and selected state.
PluginMember
One passive plugin member.
PluginRecord
One validated passive plugin package.
PluginResolution
Deterministic target-independent passive plugin resolution.
PluginShowReport
Read-only detail for one exact candidate.
ResolvedPlugin
One canonical selected or shadowed plugin.
ResolvedPluginDependency
Canonical dependency outcome retained for planning and display.
ResolvedPluginMember
Evaluated passive member in canonical structured output.
SelectionOrigin
Provenance for one selected plugin identity.
ToolFileRecord
One regular file participating in the tool contract closure.
ToolInput
One named input admitted by the tool-owned argv template.
ToolRecord
One validated plugin-local executable contract. Inventory never executes it.

Enums§

ComponentKind
Passive component namespaces accepted by schema version 1.
DependencyRequirement
Plugin dependency requirement.
MemberRequirement
Membership requirement.
PluginComponentState
Passive component availability state.
PluginDependencyState
Canonical plugin dependency state.
PluginDiagnosticCode
Plugin resolution diagnostic codes.
PluginInventoryWarningCode
Plugin inventory warning codes.
PluginState
Canonical plugin state before target adapters run.
SelectionOriginKind
Source of selected plugin intent.
SelectionStrength
Strength retained on one selection origin.
ToolAvailability
Required versus optional tool availability.
ToolCapability
Portable active-code capability claims.
ToolCwd
Working directory used for execution.
ToolInputType
Primitive named-input types supported by descriptor v1.
ToolPlatform
Portable operating-system requirements.
ToolRuntime
Supported local-tool runtime kinds.

Constants§

PLUGIN_FILE
Canonical plugin manifest filename.

Functions§

apply_component_resolution
Project existing component activation facts onto the canonical plugin graph. This operation never grants approval or enables an instruction pack.
list_report
Build a deterministic safe candidate list without exposing provider overlay values that may contain source-authored secrets.
normalize_plugin_reference
Normalize a source-qualified slot or stable-ID selector to canonical plugin identity without changing selection state.
resolve_plugins
Resolve authored stack and direct-user plugin intent without target input.
scan_source_plugins
Scan only exact plugins/<name>/PLUGIN.toml packages in one source.
show_report
Build read-only detail for a normalized candidate identity.