plugin-examplerunverb

Placement	compiled-in (in-process)
Source	github.com/opencharly/charly/candy/plugin-examplerunverb
Version	2026.176.2000
Candy	plugin-examplerunverb

This plugin is listed in charly/charly.yml’s compiled_plugins:, so its providers are compiled into the charly binary and register in-process.

Providers

The reserved words this plugin serves:

• examplerunverb — verb class

What it does

Reference HOST-COUPLED check verb on the kit contract: examplerunverb echoes plugin_input.marker AND the live run mode (read off kit.CheckContext), proving a verb that reaches live engine state relocates into a candy and still dispatches in-process. The *Runner-keeping analogue of the stateless candy/plugin-example exampleprobe; COMPILED-IN-ONLY.

Parameter schema

The CUE schema below is the authoritative grammar for this plugin’s input. It is the same single source that generates the plugin’s Go parameter types and answers the runtime Describe RPC, so this page cannot disagree with either.

schema/examplerunverb.cue

// The reference EXECUTION-NEEDING built-in plugin's OWN CUE schema — the typed
// plugin_input for the `examplerunverb` verb. It is the SINGLE SOURCE for this
// plugin's params, used two ways (the same contract an external plugin and core
// `spec` use):
//
//  1. GENERATE the Go param struct — `cue exp gengotypes` (driven by task cue:gen,
//     which wraps this with `package params` + `@go(params)`) emits
//     ../params/cue_types_gen.go, so the provider decodes plugin_input into a TYPED
//     struct, never a hand-parsed map.
//  2. VALIDATE authored input AT RUNTIME — the builtin serves this source over the
//     Describe channel (InProcTransport) exactly like an external serves it over
//     gRPC; the host splices it onto the base (base ++ plugin) and validates every
//     authored `examplerunverb` step's plugin_input against #ExamplerunverbInput.
//
// SELF-CONTAINED: it references NO base def, so it compiles standalone (gengotypes +
// the load-gate compile) AND splices onto the base — the base ++ plugin splice
// exists to detect a def-name collision with the base, not to resolve base refs.
//
// Unlike #ExampleprobeInput (whose provider serves out-of-process via Invoke), the
// examplerunverb provider is a CheckVerbProvider — it dispatches IN-PROCESS via
// RunVerb and so keeps the live *Runner, the property this plugin exists to prove.
#ExamplerunverbInput: {
  // marker — a NON-EMPTY string the provider echoes back as the result message,
  // proving the value round-trips author -> provider -> result. The host enforces
  // `& !=""` at validate time, so an authored empty / missing marker is a hard error.
  marker: string & !="" @go(Marker)
}

---

See also the candy reference for this candy’s install surface.