SYNAPSE-13: one worked call of a method — the params it sends and a note
saying what it does (#[plexus_macros::method(example(note = "…", params = r#"{…}"#))]).
Re-exported so macro-generated code (R-1: #[plexus::method(scope = "...")])
can construct RequiredCredential scope values through plexus-core’s
path alone — consumers don’t need a direct plexus-auth-core dependency
(the umbrella path ::plexus_rpc::core::plexus::schema::Scope also
resolves, per Z2H-2).
Atomic capability identifier, e.g. cone.send_message. Canonical
Scope newtype pinned by AUTHZ-S01-output §1. The grammar-validated
constructor (Scope::try_new), wildcard predicate (is_wildcard),
and segment-bounded matching (Scope::matches) live in
crate::scope_registry (AUTHZ-CORE-4). The macro-generated
Scope::new below stays unvalidated for wire-decoded values;
registry construction goes through try_new.
SYNAPSE-CC-9: the JSON type — what a serde_json::Value is, the JSON sum
type — as plexus spells it in a schema: {"type": [these six]}, in this
order, inline (never a $ref), annotations beside it. schemars writes a
Value as true (or annotations alone); spell_json_values rewrites
each such position to this, and every MethodSchema schema setter applies
it, so the schema says “any JSON value” one way, which a client reads as a
type (SYNAPSE-CC-8’s RefJson). The owner, 2026-10-29: nothing is opaque.
SYNAPSE-13: the JSON Schema extension key on a param’s property that lists
the values it is meant to take — a hint for help and completion, never
enforced (the server may accept synonyms, e.g. active for Coding).
SYNAPSE-CC-9: is this schema node “any JSON value” — true, {},
annotations alone, or the spelled JSON type? An injected parameter
(x-plexus-source) is not a value a client sends, so never.
SYNAPSE-CC-9: rewrite every “any JSON value” position in schema —
true, {}, annotations alone — to the JSON type
({"type": JSON_TYPES}, annotations kept), through properties,
items, prefixItems, additionalProperties, the unions and $defs.
Idempotent; a typed node and an injected parameter are left as they are.
In place: a schemars Schema is a JSON value, so nothing is copied.
Every untyped site in this plugin’s schema (its RPC methods’
params, returns, request/response types and input, and its request
struct), sorted. Empty is the contract.