OptionalglobalAuthor-supplied stable alias for this prompt, globally unique across providers. Survives file moves/renames and is registered in the prompt registry so runtime traces can resolve back to this prompt.
Conversation messages.
Whether messages can be edited in the UI.
OptionalmodelThe model reference (e.g. a provider call or gateway string).
Whether model can be edited in the UI.
Model parameters currently set on the prompt (everything other than
model, system, and messages).
OptionalproviderOptionalsystemTop-level system prompt, if the SDK supports one.
Whether system can be edited in the UI.
OptionaltreeControls where this prompt appears in the sidebar tree.
Each element is a path segment. The last segment is treated as the leaf group label (analogous to a file name) and all preceding segments are rendered as collapsible directory nodes.
Prompts that share the same treePath are grouped under the same leaf
node. When omitted, the prompt is placed at the root level.
A NormalizedPrompt whose
metadatafield is guaranteed to carry FilePromptMetadata. This is the public-facing prompt type returned by FilePromptProvider.