local

type AgentConfig struct {
	// Name is the unique identifier for the agent.
	Name string `yaml:"name" json:"name"`

	// Description explains when to use this agent.
	Description string `yaml:"description" json:"description"`

	// Instructions is the system prompt or path to a markdown file.
	Instructions string `yaml:"instructions" json:"instructions"`

	// Tools lists the tools available to this agent.
	// Available: read, write, glob, grep, shell
	Tools []string `yaml:"tools" json:"tools"`

	// Model overrides the default LLM model for this agent.
	Model string `yaml:"model,omitempty" json:"model,omitempty"`

	// MaxTokens limits the response length.
	MaxTokens int `yaml:"max_tokens,omitempty" json:"max_tokens,omitempty"`
}

type AgentInfo struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type AgentResult struct {
	Agent   string `json:"agent"`
	Input   string `json:"input"`
	Output  string `json:"output"`
	Success bool   `json:"success"`
	Error   string `json:"error,omitempty"`
}

type AgentResultReport struct {
	// Schema is the JSON Schema reference for validation.
	Schema string `json:"$schema,omitempty"`

	// AgentID is the agent identifier.
	AgentID string `json:"agent_id"`

	// StepID is the workflow step identifier.
	StepID string `json:"step_id"`

	// Inputs contains values received from upstream agents.
	Inputs map[string]any `json:"inputs,omitempty"`

	// Outputs contains values produced for downstream agents.
	Outputs map[string]any `json:"outputs,omitempty"`

	// Checks contains individual validation checks.
	Checks []CheckResult `json:"checks"`

	// Status is the overall status for this agent.
	Status ReportStatus `json:"status"`

	// ExecutedAt is when the agent completed execution.
	ExecutedAt time.Time `json:"executed_at"`

	// AgentModel is the LLM model used.
	AgentModel string `json:"agent_model,omitempty"`

	// Duration is the execution duration.
	Duration string `json:"duration,omitempty"`

	// Error is the error message if the agent failed.
	Error string `json:"error,omitempty"`
}

type AgentSpec struct {
	// Name is the unique identifier for the agent.
	Name string `json:"name"`

	// Description explains the agent's purpose and capabilities.
	Description string `json:"description"`

	// Model is the model capability tier: "haiku", "sonnet", "opus".
	Model string `json:"model,omitempty"`

	// Tools lists the canonical tools the agent can use.
	Tools []string `json:"tools,omitempty"`

	// Skills lists the skills the agent can invoke.
	Skills []string `json:"skills,omitempty"`

	// Dependencies lists other agents this agent depends on.
	Dependencies []string `json:"dependencies,omitempty"`

	// Requires lists external tools or binaries required.
	Requires []string `json:"requires,omitempty"`

	// Credentials defines secrets/credentials the agent needs.
	// Values can be omnivault URIs (env://VAR, op://vault/item, aws-sm://secret).
	Credentials map[string]CredentialSpec `json:"credentials,omitempty"`

	// Instructions is the system prompt for the agent.
	Instructions string `json:"instructions,omitempty"`

	// Tasks defines tasks this agent can perform.
	Tasks []TaskSpec `json:"tasks,omitempty"`
}

type AgentTask struct {
	Agent string `json:"agent"`
	Input string `json:"input"`
}

type CheckResult struct {
	// ID is the check identifier.
	ID string `json:"id"`

	// Status is the check status.
	Status ReportStatus `json:"status"`

	// Detail contains additional information.
	Detail string `json:"detail,omitempty"`

	// Metadata contains structured data about the check.
	Metadata map[string]any `json:"metadata,omitempty"`
}

type CommandResult struct {
	Command  string   `json:"command"`
	Args     []string `json:"args,omitempty"`
	Stdout   string   `json:"stdout"`
	Stderr   string   `json:"stderr"`
	ExitCode int      `json:"exit_code"`
}

type CompletionResponse struct {
	Content   string     `json:"content"`
	ToolCalls []ToolCall `json:"tool_calls,omitempty"`
	Done      bool       `json:"done"`
}

type Config struct {
	// Mode should be "local" for embedded mode.
	Mode string `yaml:"mode" json:"mode"`

	// Workspace is the root directory for filesystem access.
	// Defaults to current working directory.
	Workspace string `yaml:"workspace" json:"workspace"`

	// Agents defines the available agents.
	Agents []AgentConfig `yaml:"agents" json:"agents"`

	// MCP configures the MCP server interface.
	MCP MCPConfig `yaml:"mcp" json:"mcp"`

	// LLM configures the language model.
	LLM LLMConfig `yaml:"llm" json:"llm"`

	// Timeouts for various operations.
	Timeouts TimeoutConfig `yaml:"timeouts" json:"timeouts"`
}

type ConfigFormat string

type CredentialSpec struct {
	// Description explains what this credential is for.
	Description string `json:"description,omitempty"`

	// Required indicates if this credential must be present.
	Required bool `json:"required,omitempty"`

	// Source is the omnivault URI (env://VAR, op://vault/item, aws-sm://secret).
	Source string `json:"source"`
}

type DAGExecutor struct {
	// contains filtered or unexported fields
}

type Duration time.Duration

type EmbeddedAgent struct {
	// contains filtered or unexported fields
}

type ExecutionState struct {
	// RunID is the unique identifier for this execution run.
	RunID string `json:"run_id"`

	// WorkflowID identifies the workflow being executed.
	WorkflowID string `json:"workflow_id"`

	// Status is the overall execution status.
	Status ExecutionStatus `json:"status"`

	// Steps contains the state of each step in the workflow.
	Steps map[string]*StepState `json:"steps"`

	// Context holds shared data across steps (e.g., accumulated results).
	Context map[string]any `json:"context,omitempty"`

	// StartedAt is when execution began.
	StartedAt time.Time `json:"started_at"`

	// UpdatedAt is when the state was last updated.
	UpdatedAt time.Time `json:"updated_at"`

	// CompletedAt is when execution finished (success or failure).
	CompletedAt *time.Time `json:"completed_at,omitempty"`

	// Error contains error details if the execution failed.
	Error string `json:"error,omitempty"`
}

type ExecutionStatus string

type FileInfo struct {
	Name  string `json:"name"`
	IsDir bool   `json:"is_dir"`
	Size  int64  `json:"size"`
}

type FileStateBackend struct {
	// contains filtered or unexported fields
}

type GlobTool struct {
	// contains filtered or unexported fields
}

type GrepMatch struct {
	File    string `json:"file"`
	Line    int    `json:"line"`
	Content string `json:"content"`
}

type GrepTool struct {
	// contains filtered or unexported fields
}

type HITLError struct {
	Request *HITLRequest
}

type HITLHandler func(runID, stepName string, request *HITLRequest) (*HITLResponse, error)

type HITLRequest struct {
	// RequestType is the kind of input needed: "approval", "input", "choice", "review".
	RequestType string `json:"request_type"`

	// Question is what the agent is asking.
	Question string `json:"question"`

	// Context provides background information for the human.
	Context string `json:"context,omitempty"`

	// Options are available choices (for "choice" type).
	Options []string `json:"options,omitempty"`

	// DefaultValue is the suggested default response.
	DefaultValue string `json:"default_value,omitempty"`

	// CreatedAt is when the request was created.
	CreatedAt time.Time `json:"created_at"`
}

type HITLResponse struct {
	// Response is the human's input.
	Response string `json:"response"`

	// Approved is true for approval-type requests.
	Approved *bool `json:"approved,omitempty"`

	// SelectedOption is the chosen option index (for choice-type).
	SelectedOption *int `json:"selected_option,omitempty"`

	// RespondedAt is when the response was provided.
	RespondedAt time.Time `json:"responded_at"`
}

type LLMClient interface {
	// Complete generates a completion for the given messages.
	Complete(ctx context.Context, messages []Message, tools []ToolDefinition) (*CompletionResponse, error)
}

type LLMConfig struct {
	// Provider is the LLM provider: "openai", "anthropic", "gemini", "ollama".
	Provider string `yaml:"provider" json:"provider"`

	// Model is the default model to use.
	Model string `yaml:"model" json:"model"`

	// APIKey is the API key (can use env var reference like ${OPENAI_API_KEY}).
	APIKey string `yaml:"api_key,omitempty" json:"api_key,omitempty"` //nolint:gosec // G117: Config needs API key field

	// BaseURL overrides the API base URL.
	BaseURL string `yaml:"base_url,omitempty" json:"base_url,omitempty"`

	// Temperature controls randomness (0.0-1.0).
	Temperature float64 `yaml:"temperature,omitempty" json:"temperature,omitempty"`
}

type MCPConfig struct {
	// Enabled determines if the MCP server is active.
	Enabled bool `yaml:"enabled" json:"enabled"`

	// Transport is the MCP transport type: "stdio" or "http".
	Transport string `yaml:"transport" json:"transport"`

	// Port is used when transport is "http".
	Port int `yaml:"port,omitempty" json:"port,omitempty"`

	// ServerName is the name reported in MCP server info.
	ServerName string `yaml:"server_name,omitempty" json:"server_name,omitempty"`

	// ServerVersion is the version reported in MCP server info.
	ServerVersion string `yaml:"server_version,omitempty" json:"server_version,omitempty"`
}

type Message struct {
	Role    string `json:"role"` // "system", "user", "assistant", "tool"
	Content string `json:"content"`
	Name    string `json:"name,omitempty"`    // For tool messages
	ToolID  string `json:"tool_id,omitempty"` // For tool messages
}

type OmniLLMClient struct {
	// contains filtered or unexported fields
}

type OmniLLMConfig struct {
	// Provider is the LLM provider name (anthropic, openai, gemini, xai, ollama).
	Provider string
	// APIKey is the API key for the provider (not needed for ollama).
	APIKey string //nolint:gosec // G117: Config needs API key field
	// Model is the model ID or canonical name (haiku, sonnet, opus).
	Model string
	// BaseURL is an optional custom base URL for the provider.
	BaseURL string
}

type OrchestratedResult struct {
	Task    string         `json:"task"`
	Mode    string         `json:"mode"`
	Results []*AgentResult `json:"results"`
}

type OrchestratedTask struct {
	// Name is a descriptive name for the task.
	Name string `json:"name"`

	// Agents lists the agents to involve, in order of execution for sequential,
	// or all at once for parallel.
	Agents []string `json:"agents"`

	// Input is the task description/prompt.
	Input string `json:"input"`

	// Mode is "parallel" or "sequential".
	Mode string `json:"mode"`
}

type PortSpec struct {
	// Name is the port identifier.
	Name string `json:"name"`

	// Type is the data type: "string", "number", "boolean", "object", "array", "file".
	Type string `json:"type,omitempty"`

	// Description is a human-readable description.
	Description string `json:"description,omitempty"`

	// Required indicates if this input is required (inputs only).
	Required *bool `json:"required,omitempty"`

	// From is the source reference as "step_name.output_name" (inputs only).
	From string `json:"from,omitempty"`

	// Default is the default value if not provided (inputs only).
	Default any `json:"default,omitempty"`
}

type PrereqCheck struct {
	// Name is the CLI tool name.
	Name string `json:"name"`

	// Found indicates if the tool was found in PATH.
	Found bool `json:"found"`

	// Path is the full path to the tool (if found).
	Path string `json:"path,omitempty"`

	// Version is the tool version (if detectable).
	Version string `json:"version,omitempty"`

	// Error is the error message if the tool was not found.
	Error string `json:"error,omitempty"`
}

type PrereqResult struct {
	// Checks contains results for each prerequisite.
	Checks []PrereqCheck `json:"checks"`

	// AllFound is true if all prerequisites were found.
	AllFound bool `json:"all_found"`

	// Missing lists the names of missing prerequisites.
	Missing []string `json:"missing,omitempty"`
}

type ReadTool struct {
	// contains filtered or unexported fields
}

type ReportBuilder struct {
	// contains filtered or unexported fields
}

type ReportStatus string

type Runner struct {
	// contains filtered or unexported fields
}

type ShellTool struct {
	// contains filtered or unexported fields
}

type SpecLoader struct {
	// BaseDir is the directory containing spec files.
	BaseDir string

	// AgentsDir is the directory containing agent definitions.
	// Defaults to "agents" relative to BaseDir.
	AgentsDir string

	// TeamsDir is the directory containing team definitions.
	// Defaults to same as BaseDir.
	TeamsDir string
}

type StateBackend interface {
	// SaveState persists the execution state for a given run ID.
	SaveState(ctx context.Context, runID string, state *ExecutionState) error

	// LoadState retrieves the execution state for a given run ID.
	// Returns nil, nil if no state exists for the run ID.
	LoadState(ctx context.Context, runID string) (*ExecutionState, error)

	// DeleteState removes the execution state for a given run ID.
	DeleteState(ctx context.Context, runID string) error

	// ListRuns returns all run IDs, optionally filtered by workflow ID.
	ListRuns(ctx context.Context, workflowID string) ([]string, error)
}

type StepResult struct {
	// StepID is the step identifier.
	StepID string `json:"step_id"`

	// AgentName is the agent that executed this step.
	AgentName string `json:"agent_name"`

	// Output is the step's output.
	Output string `json:"output"`

	// Error is the error message if the step failed.
	Error string `json:"error,omitempty"`

	// Duration is how long the step took to execute.
	Duration time.Duration `json:"duration"`
}

type StepSpec struct {
	// Name is the step identifier (e.g., "pm-validation").
	Name string `json:"name"`

	// Agent is the agent to execute this step.
	Agent string `json:"agent"`

	// DependsOn lists steps that must complete before this step.
	DependsOn []string `json:"depends_on,omitempty"`

	// Inputs are data inputs consumed by this step.
	Inputs []PortSpec `json:"inputs,omitempty"`

	// Outputs are data outputs produced by this step.
	Outputs []PortSpec `json:"outputs,omitempty"`
}

type StepState struct {
	// StepID is the unique identifier for this step.
	StepID string `json:"step_id"`

	// AgentName is the name of the agent executing this step.
	AgentName string `json:"agent_name"`

	// Status is the step's execution status.
	Status StepStatus `json:"status"`

	// Input is the input provided to the agent.
	Input string `json:"input,omitempty"`

	// Output is the result returned by the agent.
	Output string `json:"output,omitempty"`

	// Error contains error details if the step failed.
	Error string `json:"error,omitempty"`

	// StartedAt is when the step began execution.
	StartedAt *time.Time `json:"started_at,omitempty"`

	// CompletedAt is when the step finished execution.
	CompletedAt *time.Time `json:"completed_at,omitempty"`

	// Retries is the number of retry attempts made.
	Retries int `json:"retries,omitempty"`

	// Dependencies lists step IDs this step depends on.
	Dependencies []string `json:"dependencies,omitempty"`

	// HITLRequest contains the human-in-the-loop request if waiting for input.
	HITLRequest *HITLRequest `json:"hitl_request,omitempty"`

	// HITLResponse contains the human response when provided.
	HITLResponse *HITLResponse `json:"hitl_response,omitempty"`
}

type StepStatus string

type TaskResult struct {
	// ID is the task identifier.
	ID string `json:"id"`

	// Status is the task status.
	Status ReportStatus `json:"status"`

	// Detail contains additional information.
	Detail string `json:"detail,omitempty"`

	// DurationMS is the execution time in milliseconds.
	DurationMS int64 `json:"duration_ms,omitempty"`

	// Metadata contains structured data about the task execution.
	Metadata map[string]any `json:"metadata,omitempty"`
}

type TaskSpec struct {
	// ID is the unique task identifier.
	ID string `json:"id"`

	// Description explains what this task validates or accomplishes.
	Description string `json:"description"`

	// Type is how the task is executed: "command", "pattern", "file", "manual".
	Type string `json:"type,omitempty"`

	// Command is the shell command to execute (for type: command).
	Command string `json:"command,omitempty"`

	// Pattern is the regex pattern to search for (for type: pattern).
	Pattern string `json:"pattern,omitempty"`

	// File is the file path to check (for type: file).
	File string `json:"file,omitempty"`

	// Files is the glob pattern for files to check (for type: pattern).
	Files string `json:"files,omitempty"`

	// Required indicates if task failure causes agent to report NO-GO.
	Required *bool `json:"required,omitempty"`

	// ExpectedOutput describes what constitutes success.
	ExpectedOutput string `json:"expected_output,omitempty"`

	// HumanInLoop describes when to prompt for human intervention.
	HumanInLoop string `json:"human_in_loop,omitempty"`
}

type TeamPrereqResult struct {
	// AgentResults maps agent name to its prerequisite results.
	AgentResults map[string]*PrereqResult `json:"agent_results"`

	// AllFound is true if all prerequisites for all agents were found.
	AllFound bool `json:"all_found"`

	// Missing maps agent name to list of missing CLIs.
	Missing map[string][]string `json:"missing,omitempty"`
}

type TeamReport struct {
	// Schema is the JSON Schema reference for validation.
	Schema string `json:"$schema,omitempty"`

	// Project is the project identifier (e.g., "github.com/org/repo").
	Project string `json:"project"`

	// Version is the target release version.
	Version string `json:"version"`

	// Target is a human-readable target description.
	Target string `json:"target,omitempty"`

	// Phase is the current workflow phase.
	Phase string `json:"phase"`

	// Teams contains validation results from each agent/team.
	Teams []TeamResult `json:"teams"`

	// Status is the overall status computed from all teams.
	Status ReportStatus `json:"status"`

	// GeneratedAt is when the report was generated.
	GeneratedAt time.Time `json:"generated_at"`

	// GeneratedBy is the identifier of the coordinator.
	GeneratedBy string `json:"generated_by,omitempty"`
}

type TeamResult struct {
	// ID is the workflow step identifier.
	ID string `json:"id"`

	// Name is the agent name.
	Name string `json:"name"`

	// AgentID is the agent identifier matching team.json agents list.
	AgentID string `json:"agent_id,omitempty"`

	// Model is the LLM model used by this agent.
	Model string `json:"model,omitempty"`

	// DependsOn lists IDs of upstream teams this team depends on.
	DependsOn []string `json:"depends_on,omitempty"`

	// Tasks contains individual task results.
	Tasks []TaskResult `json:"tasks"`

	// Status is the overall status for this team.
	Status ReportStatus `json:"status"`
}

type TeamSpec struct {
	// Name is the team identifier (e.g., "stats-agent-team").
	Name string `json:"name"`

	// Version is the semantic version of the team definition.
	Version string `json:"version"`

	// Description is a brief description of the team's purpose.
	Description string `json:"description,omitempty"`

	// Agents lists agent names in the team (references agent definitions).
	Agents []string `json:"agents"`

	// Orchestrator is the name of the orchestrator agent (must be in agents list).
	Orchestrator string `json:"orchestrator,omitempty"`

	// Workflow defines agent coordination patterns.
	Workflow *WorkflowSpec `json:"workflow,omitempty"`

	// Context is shared context for all agents.
	Context string `json:"context,omitempty"`
}

type TimeoutConfig struct {
	// AgentInvoke is the timeout for a single agent invocation.
	AgentInvoke Duration `yaml:"agent_invoke" json:"agent_invoke"`

	// ShellCommand is the timeout for shell command execution.
	ShellCommand Duration `yaml:"shell_command" json:"shell_command"`

	// FileRead is the timeout for file read operations.
	FileRead Duration `yaml:"file_read" json:"file_read"`

	// ParallelTotal is the total timeout for parallel agent execution.
	ParallelTotal Duration `yaml:"parallel_total" json:"parallel_total"`
}

type Tool interface {
	Name() string
	Description() string
	Execute(ctx context.Context, args map[string]any) (any, error)
}

type ToolCall struct {
	ID        string         `json:"id"`
	Name      string         `json:"name"`
	Arguments map[string]any `json:"arguments"`
}

type ToolDefinition struct {
	Name        string                 `json:"name"`
	Description string                 `json:"description"`
	Parameters  map[string]interface{} `json:"parameters"`
}

type ToolSet struct {
	// contains filtered or unexported fields
}

type WorkflowResult struct {
	// RunID is the unique identifier for this execution.
	RunID string `json:"run_id"`

	// WorkflowID is the team/workflow name.
	WorkflowID string `json:"workflow_id"`

	// StepResults contains results for each step.
	StepResults map[string]*StepResult `json:"step_results"`

	// FinalOutput is the final output from the workflow.
	FinalOutput string `json:"final_output"`

	// State is the execution state.
	State *ExecutionState `json:"state,omitempty"`
}

type WorkflowSpec struct {
	// Type is the execution pattern: "sequential", "parallel", "dag", "orchestrated".
	Type string `json:"type"`

	// Steps are the ordered steps in the workflow.
	Steps []StepSpec `json:"steps,omitempty"`
}

type WorkflowType string

type WriteTool struct {
	// contains filtered or unexported fields
}