pack

type AgentDef struct {
	Description string   `json:"description,omitempty"`
	Tags        []string `json:"tags,omitempty"`
	InputModes  []string `json:"input_modes,omitempty"`
	OutputModes []string `json:"output_modes,omitempty"`
}

type AgentsConfig struct {
	Entry   string               `json:"entry"`
	Members map[string]*AgentDef `json:"members"`
}

type AgentsValidationError struct {
	Errors []string
}

type LoadOptions struct {
	// SkipSchemaValidation disables JSON schema validation during load.
	// Default is false (validation enabled).
	SkipSchemaValidation bool
}

type MediaConfig struct {
	AllowedTypes []string `json:"allowed_types,omitempty"`
	MaxSize      int      `json:"max_size,omitempty"`
}

type Pack struct {
	// Identity
	ID          string `json:"id"`
	Name        string `json:"name"`
	Version     string `json:"version"`
	Description string `json:"description"`

	// Prompts - Map of prompt name -> Prompt
	Prompts map[string]*Prompt `json:"prompts"`

	// Tools - Map of tool name -> Tool
	Tools map[string]*Tool `json:"tools,omitempty"`

	// Fragments - Map of fragment name -> content
	Fragments map[string]string `json:"fragments,omitempty"`

	// Evals - Pack-level eval definitions (applied to all prompts unless overridden)
	Evals []evals.EvalDef `json:"evals,omitempty"`

	// Workflow - State-machine workflow config
	Workflow *WorkflowSpec `json:"workflow,omitempty"`

	// Agents - Agent configuration mapping prompts to A2A-compatible agent definitions
	Agents *AgentsConfig `json:"agents,omitempty"`

	// Skills - Skill sources for dynamic capability loading
	Skills []SkillSourceConfig `json:"skills,omitempty"`

	// FilePath is the path from which this pack was loaded.
	FilePath string `json:"-"`
}

type Parameters struct {
	Temperature *float64 `json:"temperature,omitempty"`
	MaxTokens   *int     `json:"max_tokens,omitempty"`
	TopP        *float64 `json:"top_p,omitempty"`
	TopK        *int     `json:"top_k,omitempty"`
}

type Prompt struct {
	ID             string          `json:"id"`
	Name           string          `json:"name"`
	Description    string          `json:"description"`
	Version        string          `json:"version"`
	SystemTemplate string          `json:"system_template"`
	Variables      []Variable      `json:"variables,omitempty"`
	Tools          []string        `json:"tools,omitempty"`
	ToolPolicy     *ToolPolicy     `json:"tool_policy,omitempty"`
	MediaConfig    *MediaConfig    `json:"media,omitempty"`
	Parameters     *Parameters     `json:"parameters,omitempty"`
	Validators     []Validator     `json:"validators,omitempty"`
	Evals          []evals.EvalDef `json:"evals,omitempty"`
	ModelOverrides map[string]any  `json:"model_overrides,omitempty"`
}

type SchemaValidationError struct {
	Errors []string
}

type SkillSourceConfig struct {
	Dir          string `json:"dir,omitempty"`
	Path         string `json:"path,omitempty"` // schema alias for dir
	Name         string `json:"name,omitempty"`
	Description  string `json:"description,omitempty"`
	Instructions string `json:"instructions,omitempty"`
	Preload      bool   `json:"preload,omitempty"`
}

type Tool struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Parameters  any    `json:"parameters"`
}

type ToolPolicy struct {
	ToolChoice          string   `json:"tool_choice,omitempty"`
	MaxRounds           int      `json:"max_rounds,omitempty"`
	MaxToolCallsPerTurn int      `json:"max_tool_calls_per_turn,omitempty"`
	Blocklist           []string `json:"blocklist,omitempty"`
}

type Validator struct {
	Type   string         `json:"type"`
	Config map[string]any `json:"config,omitempty"`
}

type Variable struct {
	Name        string `json:"name"`
	Type        string `json:"type"`
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
	Default     string `json:"default,omitempty"`
	// Binding enables automatic population from system resources and type-safe UI selection.
	Binding *VariableBinding `json:"binding,omitempty"`
}

type VariableBinding struct {
	// Kind specifies the type of resource to bind to.
	Kind VariableBindingKind `json:"kind"`
	// Field specifies which field of the resource to bind (e.g., "name", "model").
	Field string `json:"field,omitempty"`
	// AutoPopulate enables automatic population of this variable from the bound resource.
	AutoPopulate bool `json:"autoPopulate,omitempty"`
	// Filter specifies criteria for filtering bound resources.
	Filter *VariableBindingFilter `json:"filter,omitempty"`
}

type VariableBindingFilter struct {
	// Capability filters resources by capability (e.g., "chat", "embeddings").
	Capability string `json:"capability,omitempty"`
	// Labels filters resources by label selectors.
	Labels map[string]string `json:"labels,omitempty"`
}

type VariableBindingKind string

type WorkflowSpec struct {
	Version int                       `json:"version"`
	Entry   string                    `json:"entry"`
	States  map[string]*WorkflowState `json:"states"`
	Engine  map[string]any            `json:"engine,omitempty"`
}

type WorkflowState struct {
	PromptTask    string            `json:"prompt_task"`
	Description   string            `json:"description,omitempty"`
	OnEvent       map[string]string `json:"on_event,omitempty"`
	Persistence   string            `json:"persistence,omitempty"`
	Orchestration string            `json:"orchestration,omitempty"`
	Skills        string            `json:"skills,omitempty"`
}

type WorkflowValidationError struct {
	Errors   []string
	Warnings []string
}