Implement a library profile API and built-in profile docs

types.go

@@ -154,6 +154,36 @@ type ExecutionTargetOverride struct {
 	ExtraParams     map[string]any
 }
 
+// Profile is an in-memory execution profile for library consumers.
+type Profile struct {
+	ID              string
+	Endpoint        string
+	Model           string
+	Temperature     float64
+	MaxTokens       int
+	TopP            float64
+	TimeoutSeconds  int
+	ServiceTier     string
+	ReasoningEffort string
+	APIKeyRequired  bool
+	ExtraParams     map[string]any
+}
+
+// OpenAICompatibleProfileConfig configures an OpenAI-compatible in-memory profile.
+type OpenAICompatibleProfileConfig struct {
+	ID              string
+	Endpoint        string
+	Model           string
+	APIKeyRequired  bool
+	Temperature     float64
+	MaxTokens       int
+	TopP            float64
+	TimeoutSeconds  int
+	ServiceTier     string
+	ReasoningEffort string
+	ExtraParams     map[string]any
+}
+
 // ExecutionTargetPresence tracks which numeric runtime settings were explicit
 // request overrides.
 type ExecutionTargetPresence struct {