Expand description
Shared external-plugin discovery and dispatch for Guth.
Structs§
- Discovered
Action Contribution - Plugin
Action Context - Plugin
Action Contribution - Plugin
Action Invoke Request - Plugin
Action Manifest - A schema-2 plugin manifest that opts into Guth’s external GUI-action protocol.
- Plugin
Action Matcher - Plugin
Action Metadata - Plugin
Action Probe Request - Plugin
Action Probe Response - Plugin
Action Result - Plugin
Action Target - Plugin
Contributions - Plugin
Diagnostic - Plugin
Discovery Report - Plugin
Manifest - Plugin
Output - Plugin
Process - Plugin
Protocol Path - Lossless, bounded representation of a Linux path on the JSON protocol wire.
displayis presentation-only;unix_bytes_hexis the authoritative path.
Enums§
- Plugin
Action Category - Plugin
Action Icon - Plugin
Action Operation - Plugin
Action Outcome - Plugin
Action Placement - Plugin
Action Target Kind
Constants§
- ACTION_
CONTRIBUTION_ CAPABILITY - ACTION_
MANIFEST_ SCHEMA - ACTION_
PROTOCOL_ ARGUMENT - ACTION_
PROTOCOL_ VERSION - ENABLED_
PLUGIN_ BYTES_ LIMIT - MANIFEST_
BYTES_ LIMIT - MANIFEST_
SCHEMA - PLUGIN_
ACTION_ INVOKE_ TIMEOUT - PLUGIN_
ACTION_ IO_ BYTES_ LIMIT - PLUGIN_
ACTION_ LIMIT - PLUGIN_
ACTION_ SELECTION_ LIMIT - PLUGIN_
DIAGNOSTIC_ LIMIT - PLUGIN_
LIMIT
Functions§
- discover_
plugins - discover_
plugins_ in - discover_
plugins_ in_ with_ diagnostics - discover_
plugins_ with_ diagnostics - enabled_
plugins_ path - install_
action_ manifest - install_
action_ manifest_ in - install_
manifest - install_
manifest_ in - invoke_
plugin_ action - Runs a validated action to completion for worker-thread and headless use.
The process is cancelled after five minutes and is always reaped by the
bounded
PluginProcessshutdown path. - load_
enabled_ plugins - Loads the persisted enabled IDs without discovering plugins or pruning stale entries.
- parse_
plugin_ action_ invoke_ request - Parses the bounded JSON request received by a plugin in
invokemode. - parse_
plugin_ action_ probe - Parses and validates a completed action probe without trusting plugin IDs, action identifiers, menu placement, or selection matchers from stdout.
- parse_
plugin_ action_ probe_ request - Parses the bounded JSON request received by a plugin in
probemode. - parse_
plugin_ action_ result - plugin_
data_ dir - probe_
plugin_ actions - Blocking probe convenience for worker threads and headless callers. GUI code should run this away from the render thread or use the spawn/parse pair.
- prune_
uninstalled_ enabled_ plugins - run_
plugin - set_
plugin_ enabled - spawn_
plugin - spawn_
plugin_ action - Starts an action previously returned by a validated probe. Invocation is rejected when the action no longer matches the supplied context.
- spawn_
plugin_ action_ probe - Starts a bounded schema-2 action probe. The executable receives exactly
--guth-action-protocol 1 probe; its request is a single JSON object on stdin and its response must be a single versioned JSON object on stdout.