Plugins

Plugin System Text

Understand what plugin.system(context) is for and when it is injected into runtime prompt assembly

Plugin System Text

A plugin can implement:

system(context) {
  return "plugin-level system text";
}

What it means

plugin.system() expresses:

this plugin wants to contribute one system-level text block into runtime prompt assembly

Typical uses:

provider-specific operating guidance
capability-specific usage constraints
telling the agent which installed capability surface is currently available

In the full runtime prompt collection path, plugin system text is part of the formal runtime system assembly.

The runtime currently:

iterates over built-in plugins
only reads system() from enabled plugins
fail-opens if one plugin system loader throws

When plugin.system is a good fit

Use it when the text belongs to:

one plugin's operating guidance
one provider's rules of engagement
one capability package's runtime instructions

Built-in plugins that use it clearly

skill
web
asr
tts

These are all good examples of capability-description system text.

Common Bad vs Good Designs

Use short bad-vs-good comparisons to show when to choose pipeline, guard, effect, resolve, or lifecycle runtime

Plugin Availability

Understand the difference between enabled and available, and the gap between static catalog state and runtime usability

Table of Contents

Plugin System Text What it means When plugin.system is a good fit Built-in plugins that use it clearly Related docs