Struct ScriptPlugin 

pub struct ScriptPlugin {
    runtime: ScriptRuntime,
}

Executes a scripted plugin as a graph node.

The script receives the full Context (request, response, message) and returns a possibly modified copy; anything it writes into ctx.message is visible to downstream nodes. Currently only the Lua (Luau) runtime is supported.

Fields

runtime: ScriptRuntime

Implementations

impl ScriptPlugin

pub fn from_config(config: &HashMap<String, Value>) -> Result<Self, String>

Builds the plugin from node config, loading and validating the script immediately so bad scripts fail at policy-compile time.

Accepted keys:

• runtime (string, default "lua"): scripting runtime; any other value is an error.
• source (string): path to a script file, read at compile time.
• inline (string): script text embedded in the config. One of source or inline is required (source wins if both are set); omitting both is an error, as is an unreadable source file.
• timeout_ms (integer, default 5000): script execution timeout; currently stored by the Lua runtime but not yet enforced.
• modules_path (string, default: the source script’s parent directory; none for inline): directory the sandboxed require resolves modules from.

type: script
config:
  runtime: lua
  source: scripts/enrich.lua
  timeout_ms: 2000

The script must define a global execute(ctx) function that returns the (possibly modified) context table:

function execute(ctx)
    ctx.request.headers["x-enriched"] = {"true"}
    ctx.message.user_tier = "gold"
    return ctx
end

Trait Implementations

impl Plugin for ScriptPlugin

fn plugin_type(&self) -> &str

Unique identifier for the plugin type (e.g., “proxy-rewrite”, “upstream”).

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, ctx: Context, _named_inputs: &'life1 HashMap<String, Value>, ) -> Pin<Box<dyn Future<Output = Result<PluginOutput, PluginExecutionError>> + Send + 'async_trait>>

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

Executes the plugin logic against the request/response context.