Struct LazyExtensionHandler 

pub struct LazyExtensionHandler { /* private fields */ }

Lazy ExtensionHandler for deferred hook/provider/user capabilities (Task 20 Commit C). Registered/subscribed at load WITHOUT a process; the first AUTHORIZED use (a matching hook event delivered by the permission-checked HookBus subscription, a selected provider complete/stream, or an explicit user sidecar/command/settings action) single-flights through the SAME per-plugin lease manager — starting and exact-validating the child once. Discovery, load, search, and diagnostics never acquire.

Implementations

impl LazyExtensionHandler

pub fn new( plugin: &str, manager: Arc<ExtensionRuntimeManager>, ) -> LazyExtensionHandler

Trait Implementations

impl Debug for LazyExtensionHandler

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl ExtensionHandler for LazyExtensionHandler

fn id(&self) -> &str

Unique identifier for this extension.

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, event: &'life1 HookEvent, ) -> Pin<Box<dyn Future<Output = HookResult> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, LazyExtensionHandler: 'async_trait,

Handle a hook event. Returns the handler’s decision.

fn call_tool<'life0, 'life1, 'async_trait>( &'life0 self, _name: &'life1 str, _input: Value, ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, LazyExtensionHandler: 'async_trait,

Call an extension-provided tool.

fn provider_complete<'life0, 'async_trait>( &'life0 self, params: ProviderCompleteParams, ) -> Pin<Box<dyn Future<Output = Result<ProviderCompleteResult, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, LazyExtensionHandler: 'async_trait,

Complete a chat request through an extension-provided model provider.

fn provider_stream<'life0, 'async_trait>( &'life0 self, params: ProviderCompleteParams, sink: Sender<ProviderStreamEvent>, ) -> Pin<Box<dyn Future<Output = Result<ProviderCompleteResult, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, LazyExtensionHandler: 'async_trait,

Stream a chat request through an extension-provided model provider.

fn invoke_command<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, command: &'life1 str, args: Vec<String>, request_id: &'life2 str, sink: InvokeEventSink, ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, LazyExtensionHandler: 'async_trait,

Invoke a plugin-registered interactive slash command. The handler must forward command.output notifications matching request_id and any task.* notifications to sink. Returns the final response value.

fn get_info<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<PluginInfo, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, LazyExtensionHandler: 'async_trait,

Fetch optional plugin capability/build/model information.

fn sidecar_spawn_args<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<SidecarSpawnArgs, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, LazyExtensionHandler: 'async_trait,

Ask the plugin to supply sidecar spawn arguments. Used by the modality-neutral sidecar bootstrap path (see crate::sidecar::spawn); plugins that don’t host a sidecar should leave the default Err in place. Core treats the returned [SidecarSpawnArgs::args] as opaque.

fn settings_editor_open<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, category: &'life1 str, field: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, LazyExtensionHandler: 'async_trait,

Open a plugin-owned custom settings editor and return its initial render payload.

fn settings_editor_key<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, category: &'life1 str, field: &'life2 str, key: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, LazyExtensionHandler: 'async_trait,

Forward a keypress to the active plugin-owned custom settings editor.

fn settings_editor_commit<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, category: &'life1 str, field: &'life2 str, value: Value, ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, LazyExtensionHandler: 'async_trait,

Ask the plugin to commit a custom editor value selected by the UI.

fn shutdown<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where 'life0: 'async_trait, LazyExtensionHandler: 'async_trait,

Gracefully shut down the extension.

fn health<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ExtensionHealth> + Send + 'async_trait>>

where 'life0: 'async_trait, LazyExtensionHandler: 'async_trait,

Current health state of this handler.

fn lifecycle_snapshot(&self) -> Option<ExtensionLifecycle>

Observe the actual serving runtime without waiting for locks or RPC I/O.

fn subscribe_notifications<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = (usize, Receiver<NotificationFrame>)> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Subscribe to raw JSON-RPC notifications from this extension. Returns a monotonic subscription id (for unsubscribing) and a receiver that yields every notification frame. The default implementation returns a channel whose sender is immediately dropped, so the receiver yields None right away — effectively a no-op for handler impls that don’t support notifications.

fn restart_count<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = usize> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Number of transport restarts observed by this handler.