Module plugin 

Trusted plugin lifecycle, hooks and registrar.

Structs

AgentRegistrar

Scoped registrar a plugin contributes through during activation; permissions are checked per call.

ModelFailure

One failed model attempt as seen by Hook::request_error.

ModelRequestPolicy

Mutable per-request model policy. Hooks may narrow or redirect it before the request is frozen into ModelRequestPrepared.

MountedPlugins

Result of an atomic mount: merged contributions plus the leases to release.

PluginCatalog

Registered plugins keyed by id.

PluginDescriptor

Redacted description of a registered plugin.

PluginManifest

Deployment-time declaration of a trusted plugin.

PluginMountContext

Identity a plugin is mounted under for one Session.

PluginReferenceIssue

One problem found by PluginCatalog::validate_references.

StepContext

Position of the loop when a step-level hook runs.

Enums

HookDecision

Result of a pre-tool hook.

PluginError

Plugin registration, validation or mount failure.

PluginPermission

Contribution kinds a plugin may register.

PreStepDecision

Whether the loop may open the proposed step. A rejection closes the Run without a model request and is recorded as a step_rejected extension event.

RequestErrorAction

Recovery ownership for a failed model attempt. Default keeps the runtime’s retry policy; Retry forces one more attempt while attempts remain; Terminal stops retrying even for a retryable failure.

TurnStopDecision

Whether a turn that owes no tool result may close. Steer appends the content as a logged user message and runs another step instead.

Traits

AgentPlugin

Trusted deployment-time extension compiled into the host.

Hook

Interception points around the loop; every method has a no-op default.

PluginLease

Per-Session resource a plugin holds; released on unmount.

Functions

mount_plugins

Mount a complete Session plugin set atomically. Any validation or activation failure tears down current and already-mounted plugins in reverse order.

resolve_plugin_order

Topologically order the referenced plugins by their dependencies.

validate_plugin_references

Side-effect-free validation shared by profile inspection and runtime mount.

Type Aliases

ToolExecutionFuture

Boxed tool execution passed through around_tool.