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§
- Applied
Plugin Policy - One applied local policy decision with its audit provenance.
- Component
Reference - Parsed portable component reference.
- Hook
Record - One inert plugin-local hook contract with its exact approval identity.
- Inline
Fallback - Authored inline fallback for an agent member.
- Plugin
Candidate - Safe read-only candidate summary used by plugin list/show.
- Plugin
Dependency - One plugin dependency.
- Plugin
Diagnostic - Machine-readable plugin resolution diagnostic.
- Plugin
Inventory - Passive plugin inventory for one source.
- Plugin
Inventory Warning - One non-fatal plugin inventory warning.
- Plugin
List Report - Read-only plugin list report including unselected offers and selected state.
- Plugin
Member - One passive plugin member.
- Plugin
Record - One validated passive plugin package.
- Plugin
Resolution - Deterministic target-independent passive plugin resolution.
- Plugin
Show Report - Read-only detail for one exact candidate.
- Resolved
Plugin - One canonical selected or shadowed plugin.
- Resolved
Plugin Dependency - Canonical dependency outcome retained for planning and display.
- Resolved
Plugin Member - Evaluated passive member in canonical structured output.
- Selection
Origin - Provenance for one selected plugin identity.
- Tool
File Record - One regular file participating in the tool contract closure.
- Tool
Input - One named input admitted by the tool-owned argv template.
- Tool
Record - One validated plugin-local executable contract. Inventory never executes it.
Enums§
- Component
Kind - Passive component namespaces accepted by schema version 1.
- Dependency
Requirement - Plugin dependency requirement.
- Member
Requirement - Membership requirement.
- Plugin
Component State - Passive component availability state.
- Plugin
Dependency State - Canonical plugin dependency state.
- Plugin
Diagnostic Code - Plugin resolution diagnostic codes.
- Plugin
Inventory Warning Code - Plugin inventory warning codes.
- Plugin
State - Canonical plugin state before target adapters run.
- Selection
Origin Kind - Source of selected plugin intent.
- Selection
Strength - Strength retained on one selection origin.
- Tool
Availability - Required versus optional tool availability.
- Tool
Capability - Portable active-code capability claims.
- ToolCwd
- Working directory used for execution.
- Tool
Input Type - Primitive named-input types supported by descriptor v1.
- Tool
Platform - Portable operating-system requirements.
- Tool
Runtime - 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.tomlpackages in one source. - show_
report - Build read-only detail for a normalized candidate identity.