From 25a7052a3d75c24b54189774a32eb8b73e95cbf0 Mon Sep 17 00:00:00 2001
From: Eric Rakestraw <eric@rakestraw.us>
Date: Thu, 30 Jul 2026 22:10:33 +0000
Subject: [PATCH] Clarify prompt input requirement documentation

---
 types.go | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/types.go b/types.go
index 9e90188..d74f61a 100644
--- a/types.go
+++ b/types.go
@@ -344,7 +344,9 @@ type ProfileInspection struct {
 type PromptInputDefinition struct {
 	// Name is the normalized prompt input name.
 	Name string
-	// Required reports whether preparation requires the input.
+	// Required is the prompt definition's declared required flag. When true,
+	// preparation fails if the input is omitted. A false value does not account
+	// for input references in message or session-ID templates.
 	Required bool
 	// ContentType is the declared input media-type metadata.
 	ContentType string