recipe

type ConstraintsConfig struct {
	MaxSteps    int           // 0 = not set (unlimited)
	Timeout     time.Duration // 0 = not set (use runner default)
	BashTimeout time.Duration // 0 = not set (use tools default 2m)
}

type ContextConfig struct {
	MaxHistoryTurns  int     // 0 = not set
	Strategy         string  // "" | "auto_compact" | "manual" | "off"
	CompactThreshold float64 // 0 = not set
	TaskMode         string  // "" | "independent" | "sequential"
}

type HookConfig struct {
	Name         string // unique name for this hook
	Event        string // "session_start", "pre_tool_use", "post_tool_use", etc.
	Matcher      string // tool name or glob; "" = all events of type
	Action       string // "command" (Phase 1 only)
	Command      string // shell command to execute
	Timeout      string // duration string, e.g. "30s"
	InjectOutput bool   // feed command stdout back as model context
}

type MCPServerEntry struct {
	Name    string // display name
	Command string // full command string including arguments
}

type MetadataConfig struct {
	Name        string
	Description string
	Tags        []string
	Author      string
	Version     string
	Extends     string
	Contribute  bool
	ProjectRoot string
}

type ModelParamsConfig struct {
	Temperature *float64
	MaxTokens   *int
	Seed        *int64
}

type ModelProfileConfig struct {
	ContextBudget  int    // override context budget (0 = not set)
	ToolFormat     string // "native", "function_calling", "text_in_prompt" ("" = not set)
	SystemRole     *bool  // nil = not set
	MidConvoSystem *bool  // nil = not set
}

type OutputRuleConfig struct {
	MaxLines          int    // truncate at this many lines (0 = unlimited)
	MaxTokens         int    // truncate at this many tokens (0 = unlimited)
	Truncation        string // "head", "tail", "head_tail"
	TruncationMessage string // template with {line_count}, {token_count}
}

type Recipe struct {
	Version int // recipe schema version (required; currently only 1)

	Name            string
	Models          []string     // nil = not set
	SystemPrompt    string       // "" = not set
	Tools           *ToolsConfig // nil = all tools enabled
	MCPServers      []MCPServerEntry
	ModelParams     ModelParamsConfig
	Constraints     ConstraintsConfig
	Context         ContextConfig
	SubAgent        SubAgentConfig
	Sandbox         SandboxConfig
	Tasks           []string
	SuccessCriteria []string
	Metadata        MetadataConfig

	// Uniform per-tool description overrides (applied to all models).
	ToolDescriptions map[string]string // tool_name → description

	// Sub-agent mode prompts (applied to all models).
	SubAgentModes map[string]string // mode_name → prompt

	// Gap 4: conditional mid-conversation injections
	SystemReminders []SystemReminderConfig

	// Gap 5: lifecycle event hooks
	Hooks []HookConfig

	// Context summarization prompt (applied to all models).
	SummarizationPrompt string

	// Deterministic output processing rules (applied to all models).
	OutputProcessing map[string]OutputRuleConfig // tool → rule

	// Model profiles for capability overrides
	ModelProfiles map[string]ModelProfileConfig // model_id → profile

	// SectionsPresent tracks which ## sections were declared in the parsed recipe.
	// nil for programmatic recipes; populated by parseV1(). Used by ApplyRecipe
	// to decide between atomic (section-replaces-defaults) and legacy (field-by-field)
	// merge behavior.
	SectionsPresent map[string]bool
}

type Runner interface {
	// Version returns the recipe format version this runner implements.
	Version() int
	// Recipe returns the underlying recipe configuration.
	Recipe() *Recipe
}

type SandboxConfig struct {
	Filesystem      string // "" | "unrestricted" | "project_only" | "read_only"
	Network         string // "" | "full" | "none"
	AllowLocalFetch bool   // allow web_fetch to target localhost URLs
}

type SubAgentConfig struct {
	Model    string // "" = not set (inherit parent)
	MaxDepth int    // -1 = not set; 0 = disable; ≥1 = limit
	Tools    string // "inherit" or comma-separated tool names
}

type SystemReminderConfig struct {
	Name    string // unique name for this reminder
	Trigger string // trigger expression, e.g. "context_usage > 0.75"
	Content string // prompt text to inject when trigger fires
}

type ToolsConfig struct {
	// Allowlist is the explicit set of tool names available to models.
	// nil means all tools; non-nil means only these tools.
	Allowlist []string
	// BashPrefixes, if non-nil, restricts bash execution to commands whose
	// trimmed text starts with one of the listed prefix patterns.
	// nil (with bash in Allowlist) means all bash commands are allowed.
	BashPrefixes []string
	// Guidance maps tool names to per-tool guidance text from "- name: guidance" format.
	// nil means no per-tool guidance overrides (use code defaults).
	Guidance map[string]string
}