scenario

type CaseSeed struct {
	Title       string         `toml:"title"`
	Description string         `toml:"description"`
	BoardStatus string         `toml:"board_status"`
	Fields      map[string]any `toml:"fields"`
}

type Check struct {
	ID       string `toml:"id"`
	Question string `toml:"question"`
}

type Expect struct {
	Checks []Check `toml:"checks"`
}

type GitHubRepoRef struct {
	Owner string `toml:"owner"`
	Repo  string `toml:"repo"`
}

type GitHubSource struct {
	Repositories []GitHubRepoRef `toml:"repositories"`
}

type Input struct {
	Text string `toml:"text"`
	// Reporter optionally pins the posting user id. Empty means the harness
	// synthesizes one (the reporter identity does not affect the evaluation).
	Reporter string `toml:"reporter"`
}

type JobSpec struct {
	ID         string `toml:"id"`
	TargetCase string `toml:"target_case"`
}

type Meta struct {
	ID          string `toml:"id"`
	Description string `toml:"description"`
	Workflow    string `toml:"workflow"`
	// Language is the i18n language the system-under-test agent responds in
	// (the simulated end-user's locale). Distinct from the eval output language.
	Language string `toml:"language"`
}

type NotionDBSource struct {
	DatabaseID    string `toml:"database_id"`
	DatabaseTitle string `toml:"database_title"`
	DatabaseURL   string `toml:"database_url"`
}

type NotionPageSource struct {
	PageID    string `toml:"page_id"`
	PageTitle string `toml:"page_title"`
	PageURL   string `toml:"page_url"`
	Recursive bool   `toml:"recursive"`
	MaxDepth  int    `toml:"max_depth"`
}

type Persona struct {
	Description string `toml:"description"`
	Knowledge   string `toml:"knowledge"`
	// MaxAnswerTurns bounds the question/answer loop. Zero means no follow-up
	// answers are produced.
	MaxAnswerTurns int `toml:"max_answer_turns"`
}

type Scenario struct {
	Meta    Meta            `toml:"meta"`
	Input   Input           `toml:"input"`
	Cases   []CaseSeed      `toml:"cases"`
	Sources []Source        `toml:"sources"`
	Tools   map[string]Tool `toml:"tools"`
	Persona Persona         `toml:"persona"`
	// Job (table key `run_job`) selects which workspace Job to run for the
	// job workflow. The key is `run_job`, not `job`, to avoid
	// colliding with the workspace config's `[[job]]` array in the same file.
	Job    *JobSpec `toml:"run_job"`
	Expect Expect   `toml:"expect"`

	// Workspace is loaded from the same file via config.LoadWorkspaceConfigs.
	// Not a TOML field of this struct.
	Workspace *config.WorkspaceConfig `toml:"-"`
	// Path is the source file path, retained for diagnostics.
	Path string `toml:"-"`
}

type SlackChannelRef struct {
	ID   string `toml:"id"`
	Name string `toml:"name"`
}

type SlackSource struct {
	Channels []SlackChannelRef `toml:"channels"`
}

type Source struct {
	Name        string            `toml:"name"`
	Type        string            `toml:"type"` // notion_db | notion_page | slack | github
	Description string            `toml:"description"`
	Enabled     *bool             `toml:"enabled"` // default true
	NotionDB    *NotionDBSource   `toml:"notion_db"`
	NotionPage  *NotionPageSource `toml:"notion_page"`
	Slack       *SlackSource      `toml:"slack"`
	GitHub      *GitHubSource     `toml:"github"`
}

type Tool struct {
	Background string `toml:"background"`
	Live       bool   `toml:"live"`
}

type ValidateOptions struct {
	// KnownWorkflows is the set of registered workflow driver kinds.
	KnownWorkflows []string
	// KnownTools is the catalog of valid tool names. When empty, tool names are
	// not checked (e.g. during partial validation).
	KnownTools []string
}