multiagentspec

type ADKGoConfig struct {
	Model        string `json:"model,omitempty"`
	ServerPort   int    `json:"serverPort,omitempty"`
	SessionStore string `json:"sessionStore,omitempty"`
	ToolRegistry string `json:"toolRegistry,omitempty"`
}

type AWSAgentCoreConfig struct {
	Region          string `json:"region"`
	FoundationModel string `json:"foundationModel"`
	IAC             string `json:"iac"`
	LambdaRuntime   string `json:"lambdaRuntime"`
}

type Agent struct {
	// Name is the unique identifier for the agent (lowercase, hyphenated).
	Name string `json:"name" yaml:"name"`

	// Namespace is the optional namespace for organizing agents.
	// Derived from subdirectory path if not explicitly set in frontmatter.
	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`

	// Description is a brief summary of what the agent does.
	Description string `json:"description,omitempty" yaml:"description,omitempty"`

	// Icon is the icon identifier for visual representation.
	// Formats: 'brandkit:name' (from brandkit repo), 'lucide:name' (Lucide icon),
	// or plain name for inference.
	Icon string `json:"icon,omitempty" yaml:"icon,omitempty"`

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

	// Tools are the tools available to this agent.
	Tools []string `json:"tools,omitempty" yaml:"tools,omitempty"`

	// AllowedTools are tools that can execute without user confirmation.
	AllowedTools []string `json:"allowedTools,omitempty" yaml:"allowedTools,omitempty"`

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

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

	// Requires lists external tools or binaries required (e.g., go, git).
	Requires []string `json:"requires,omitempty" yaml:"requires,omitempty"`

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

	// Tasks are the tasks this agent can perform.
	Tasks []Task `json:"tasks,omitempty" yaml:"tasks,omitempty"`

	// Role is the agent's role title (e.g., "Security Analyst").
	Role string `json:"role,omitempty" yaml:"role,omitempty"`

	// Goal describes what the agent aims to achieve.
	Goal string `json:"goal,omitempty" yaml:"goal,omitempty"`

	// Backstory provides context and background for the agent's role.
	Backstory string `json:"backstory,omitempty" yaml:"backstory,omitempty"`

	// Delegation defines delegation permissions for self-directed workflows.
	Delegation *DelegationConfig `json:"delegation,omitempty" yaml:"delegation,omitempty"`
}

type AgentKitLocalConfig struct {
	Transport string `json:"transport"`
	Port      int    `json:"port,omitempty"`
}

type AgentResult struct {
	// Schema is the JSON schema URL for validation
	Schema string `json:"$schema,omitempty"`

	// AgentID identifies the agent (e.g., "pm", "qa", "documentation")
	AgentID string `json:"agent_id"`

	// StepID is the workflow step name (e.g., "pm-validation", "qa-validation")
	StepID string `json:"step_id"`

	// Inputs are values received from upstream agents in the DAG
	Inputs map[string]interface{} `json:"inputs,omitempty"`

	// Outputs are values produced by this agent for downstream agents
	Outputs map[string]interface{} `json:"outputs,omitempty"`

	// Tasks are the individual task results (one per line in reports)
	Tasks []TaskResult `json:"tasks"`

	// ContentBlocks holds rich content produced by this agent.
	// Allows agents to include findings, action items, etc.
	ContentBlocks []ContentBlock `json:"content_blocks,omitempty"`

	// Status is the overall status for this agent (computed from tasks)
	Status Status `json:"status"`

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

	// AgentModel is the LLM model used (e.g., "sonnet", "haiku", "opus")
	AgentModel string `json:"agent_model,omitempty"`

	// Duration is how long the agent took to execute
	Duration string `json:"duration,omitempty"`

	// Error is set if the agent failed to execute
	Error string `json:"error,omitempty"`
}

type Attachment struct {
	// Name is the attachment identifier.
	Name string `json:"name"`

	// Type is the attachment type: file, data, or reference.
	Type AttachmentType `json:"type"`

	// Data is the attachment content (type-dependent).
	Data interface{} `json:"data,omitempty"`
}

type AttachmentType string

type AutoGenConfig struct {
	Model                   string               `json:"model,omitempty"`
	HumanInputMode          string               `json:"humanInputMode,omitempty"`
	MaxConsecutiveAutoReply int                  `json:"maxConsecutiveAutoReply,omitempty"`
	CodeExecutionConfig     *CodeExecutionConfig `json:"codeExecutionConfig,omitempty"`
}

type Channel struct {
	// Name is the channel identifier.
	Name string `json:"name"`

	// Type is the channel type: direct, broadcast, or pub-sub.
	Type ChannelType `json:"type"`

	// Participants are agent names. Use "*" for all agents.
	Participants []string `json:"participants,omitempty"`
}

type ChannelType string

type Check = TaskResult

type ClaudeCodeConfig struct {
	AgentDir string `json:"agentDir"`
	Format   string `json:"format"`

	// TeamMode specifies whether to use subagents or agent teams.
	// Values: "subagent" (default), "team"
	TeamMode string `json:"team_mode,omitempty"`

	// TeammateMode specifies the display mode for agent teams.
	// Values: "in-process", "tmux", "auto" (default)
	TeammateMode string `json:"teammate_mode,omitempty"`

	// EnableTeams sets CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.
	EnableTeams bool `json:"enable_teams,omitempty"`
}

type CodeExecutionConfig struct {
	WorkDir   string `json:"workDir,omitempty"`
	UseDocker bool   `json:"useDocker,omitempty"`
}

type CollaborationConfig struct {
	// Lead is the lead agent name (required for crew workflow).
	Lead string `json:"lead,omitempty"`

	// Specialists are non-delegating specialist agent names.
	Specialists []string `json:"specialists,omitempty"`

	// TaskQueue enables shared task queue for self-claiming (swarm workflow).
	TaskQueue bool `json:"task_queue,omitempty"`

	// Consensus defines consensus rules (council workflow).
	Consensus *ConsensusRules `json:"consensus,omitempty"`

	// Channels define communication pathways between agents.
	Channels []Channel `json:"channels,omitempty"`
}

type CombinedWeights struct {
	// Rule is the weight for rule-based score (0-1).
	Rule float64 `json:"rule"`

	// LLM is the weight for LLM score (0-1).
	LLM float64 `json:"llm"`
}

type ConsensusRules struct {
	// RequiredAgreement is the fraction of agents that must agree (0.0-1.0).
	// Default is 0.5 (simple majority).
	RequiredAgreement float64 `json:"required_agreement,omitempty"`

	// MaxRounds is the maximum debate rounds before forcing decision.
	// Default is 3.
	MaxRounds int `json:"max_rounds,omitempty"`

	// TieBreaker is the agent name to break ties, or "lead" for lead agent.
	TieBreaker string `json:"tie_breaker,omitempty"`
}

type ContentBlock struct {
	// Type discriminates the block variant.
	Type ContentBlockType `json:"type"`

	// Title is an optional section heading.
	Title string `json:"title,omitempty"`

	// Pairs holds key-value data (for kv_pairs type).
	Pairs []KVPair `json:"pairs,omitempty"`

	// Items holds list entries (for list type).
	Items []ListItem `json:"items,omitempty"`

	// Headers holds table column headers (for table type).
	Headers []string `json:"headers,omitempty"`

	// Rows holds table data rows (for table type).
	Rows [][]string `json:"rows,omitempty"`

	// Content holds multi-line text (for text type).
	Content string `json:"content,omitempty"`

	// Label is the metric name (for metric type).
	Label string `json:"label,omitempty"`

	// Value is the metric value (for metric type).
	Value string `json:"value,omitempty"`

	// Status is used for metric blocks to indicate health.
	Status Status `json:"status,omitempty"`

	// Target is the target value for metric blocks (e.g., "80%").
	Target string `json:"target,omitempty"`
}

type ContentBlockType string

type CrewAIConfig struct {
	Model         string `json:"model,omitempty"`
	Verbose       bool   `json:"verbose,omitempty"`
	Memory        bool   `json:"memory,omitempty"`
	ProcessType   string `json:"processType,omitempty"`
	MaxIterations int    `json:"maxIterations,omitempty"`

	// AllowDelegation enables agent delegation in CrewAI.
	AllowDelegation bool `json:"allowDelegation,omitempty"`

	// ManagerLLM specifies the model for the manager agent in hierarchical process.
	ManagerLLM string `json:"managerLlm,omitempty"`
}

type DelegationConfig struct {
	// AllowDelegation enables this agent to delegate work to others.
	AllowDelegation bool `json:"allow_delegation,omitempty" yaml:"allow_delegation,omitempty"`

	// CanDelegateTo lists agent names this agent can delegate to.
	// Empty means no restrictions (can delegate to any agent).
	CanDelegateTo []string `json:"can_delegate_to,omitempty" yaml:"can_delegate_to,omitempty"`

	// CanReceiveFrom lists agent names this agent can receive delegations from.
	// Empty means no restrictions (can receive from any agent).
	CanReceiveFrom []string `json:"can_receive_from,omitempty" yaml:"can_receive_from,omitempty"`
}

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

	// Team is the reference to the team definition (team name).
	Team string `json:"team"`

	// Targets is the list of deployment targets.
	Targets []Target `json:"targets"`
}

type DeploymentMode string

type DockerComposeConfig struct {
	NetworkMode string `json:"networkMode,omitempty"`
}

type Effort string

type EvaluationType string

type GeminiCLIConfig struct {
	Model     string `json:"model,omitempty"`
	ConfigDir string `json:"configDir,omitempty"`
}

type Issue struct {
	// ID is the issue identifier (e.g., "ISS-001").
	ID string `json:"id"`

	// Category is the evaluation category this issue belongs to.
	Category string `json:"category"`

	// Severity indicates how serious the issue is.
	Severity Severity `json:"severity"`

	// Problem describes what the issue is.
	Problem string `json:"problem"`

	// Location indicates where in the document the issue occurs
	// (e.g., "requirements.functional[2]", "executiveSummary.problemStatement").
	Location string `json:"location,omitempty"`

	// Analysis explains why this is a problem.
	Analysis string `json:"analysis,omitempty"`

	// Recommendation describes how to fix the issue.
	Recommendation string `json:"recommendation,omitempty"`

	// Example provides sample improved text or structure.
	Example string `json:"example,omitempty"`

	// Effort estimates the work required to fix this issue.
	Effort Effort `json:"effort,omitempty"`

	// RelatedIssues lists IDs of related issues.
	RelatedIssues []string `json:"relatedIssues,omitempty"`
}

type KVPair struct {
	// Key is the label/identifier.
	Key string `json:"key"`

	// Value is the associated value.
	Value string `json:"value"`

	// Icon is an optional prefix icon (e.g., "🔴", "🟡").
	Icon string `json:"icon,omitempty"`
}

type KiroCLIConfig struct {
	PluginDir string `json:"pluginDir,omitempty"`
	Format    string `json:"format,omitempty"`
	// Prefix is applied to agent names, filenames, and steering files for namespace isolation.
	Prefix string `json:"prefix,omitempty"`
}

type KubernetesConfig struct {
	Namespace      string          `json:"namespace"`
	HelmChart      bool            `json:"helmChart"`
	ImageRegistry  string          `json:"imageRegistry,omitempty"`
	ResourceLimits *ResourceLimits `json:"resourceLimits,omitempty"`
}

type LLMEvaluation struct {
	// Score is the numeric score from LLM evaluation (typically 0-10).
	Score float64 `json:"score"`

	// MaxScore is the maximum possible score (default: 10).
	MaxScore float64 `json:"maxScore,omitempty"`

	// Confidence is the LLM's confidence in the evaluation (0-1 scale).
	Confidence float64 `json:"confidence,omitempty"`

	// Reasoning is the LLM's explanation of the score.
	Reasoning string `json:"reasoning,omitempty"`

	// Strengths are positive aspects identified by the LLM.
	Strengths []string `json:"strengths,omitempty"`

	// Concerns are issues or problems identified by the LLM.
	Concerns []string `json:"concerns,omitempty"`

	// Suggestions are actionable recommendations for improvement.
	Suggestions []string `json:"suggestions,omitempty"`

	// Model is the LLM model used (e.g., "claude-sonnet-4", "gpt-4").
	Model string `json:"model"`

	// Provider is the LLM provider (e.g., "anthropic", "openai", "bedrock").
	Provider string `json:"provider,omitempty"`

	// TokensUsed is the total tokens consumed for this evaluation.
	TokensUsed int `json:"tokensUsed,omitempty"`

	// LatencyMs is the LLM API response time in milliseconds.
	LatencyMs int `json:"latencyMs,omitempty"`

	// PromptVersion is a version identifier for the evaluation prompt.
	// Used for reproducibility and prompt iteration tracking.
	PromptVersion string `json:"promptVersion,omitempty"`
}

type ListItem struct {
	// Text is the item content.
	Text string `json:"text"`

	// Icon is an optional prefix icon.
	Icon string `json:"icon,omitempty"`

	// Status allows automatic icon selection if Icon is empty.
	Status Status `json:"status,omitempty"`
}

type Loader struct{}

type LoaderOption func(*Loader)

type LoggingConfig struct {
	Level  string `json:"level,omitempty"`
	Format string `json:"format,omitempty"`
}

type Message struct {
	// ID is a unique message identifier.
	ID string `json:"id"`

	// Type is the message type.
	Type MessageType `json:"type"`

	// From is the sender agent name.
	From string `json:"from"`

	// To is the recipient agent name, or "*" for broadcast.
	To string `json:"to,omitempty"`

	// Subject is an optional message subject line.
	Subject string `json:"subject,omitempty"`

	// Content is the message body.
	Content string `json:"content"`

	// Attachments are optional file or data attachments.
	Attachments []Attachment `json:"attachments,omitempty"`

	// Metadata holds additional key-value data.
	Metadata map[string]interface{} `json:"metadata,omitempty"`

	// Timestamp is when the message was created.
	Timestamp time.Time `json:"timestamp"`
}

type MessageType string

type MetricsConfig struct {
	Enabled  bool   `json:"enabled,omitempty"`
	Exporter string `json:"exporter,omitempty"`
	Endpoint string `json:"endpoint,omitempty"`
}

type Model string

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

type NarrativeSection struct {
	// Problem describes the issue or context being addressed.
	Problem string `json:"problem,omitempty"`

	// Analysis contains the detailed findings.
	Analysis string `json:"analysis,omitempty"`

	// Recommendation describes the suggested action.
	Recommendation string `json:"recommendation,omitempty"`
}

type ObservabilityConfig struct {
	// Tracing contains distributed tracing settings.
	Tracing *TracingConfig `json:"tracing,omitempty"`

	// Metrics contains metrics collection settings.
	Metrics *MetricsConfig `json:"metrics,omitempty"`

	// Logging contains logging configuration.
	Logging *LoggingConfig `json:"logging,omitempty"`
}

type Platform string

type Port struct {
	// Name is the port identifier (e.g., version_recommendation, test_results).
	Name string `json:"name"`

	// Type is the data type of this port.
	Type PortType `json:"type,omitempty"`

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

	// Required indicates whether 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"`

	// Schema is a JSON Schema for validating this port's data.
	Schema json.RawMessage `json:"schema,omitempty"`

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

type PortType string

type Priority string

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

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

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

type ResourceLimits struct {
	CPU    string `json:"cpu,omitempty"`
	Memory string `json:"memory,omitempty"`
	GPU    int    `json:"gpu,omitempty"`
}

type RetryPolicy struct {
	// MaxAttempts is the maximum number of retry attempts.
	MaxAttempts int `json:"max_attempts,omitempty"`

	// Backoff is the backoff strategy (fixed, exponential, linear).
	Backoff string `json:"backoff,omitempty"`

	// InitialDelay is the initial delay before first retry.
	InitialDelay string `json:"initial_delay,omitempty"`

	// MaxDelay is the maximum delay between retries.
	MaxDelay string `json:"max_delay,omitempty"`

	// RetryableErrors are error types that should trigger retry.
	RetryableErrors []string `json:"retryable_errors,omitempty"`
}

type RuntimeConfig struct {
	// Defaults are the default runtime settings for all steps.
	Defaults *StepRuntime `json:"defaults,omitempty"`

	// Steps contains per-step runtime overrides keyed by step name.
	Steps map[string]*StepRuntime `json:"steps,omitempty"`

	// Observability contains monitoring and tracing settings.
	Observability *ObservabilityConfig `json:"observability,omitempty"`
}

type Severity string

type Status string

type Step struct {
	// Name is the step identifier.
	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 typed data inputs consumed by this step.
	Inputs []Port `json:"inputs,omitempty"`

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

type StepRuntime struct {
	// Timeout is the step timeout (e.g., 30s, 5m, 1h).
	Timeout string `json:"timeout,omitempty"`

	// Retry is the retry policy for step failures.
	Retry *RetryPolicy `json:"retry,omitempty"`

	// Condition is a condition expression for conditional execution.
	Condition string `json:"condition,omitempty"`

	// Concurrency is the max concurrent executions of this step.
	Concurrency int `json:"concurrency,omitempty"`

	// Resources are resource limits for this step.
	Resources *ResourceLimits `json:"resources,omitempty"`
}

type Target struct {
	// Name is the unique name for this deployment target.
	Name string `json:"name"`

	// Platform is the target platform for deployment.
	Platform Platform `json:"platform"`

	// Mode is the deployment mode affecting runtime behavior.
	Mode DeploymentMode `json:"mode,omitempty"`

	// Priority is the deployment priority.
	Priority Priority `json:"priority,omitempty"`

	// Output is the directory for generated deployment artifacts.
	Output string `json:"output,omitempty"`

	// Runtime is the runtime configuration for workflow execution.
	Runtime *RuntimeConfig `json:"runtime,omitempty"`

	// Platform-specific configurations (use the one matching Platform field)
	ClaudeCode    *ClaudeCodeConfig    `json:"claudeCode,omitempty"`
	GeminiCLI     *GeminiCLIConfig     `json:"geminiCli,omitempty"`
	KiroCLI       *KiroCLIConfig       `json:"kiroCli,omitempty"`
	ADKGo         *ADKGoConfig         `json:"adkGo,omitempty"`
	CrewAI        *CrewAIConfig        `json:"crewai,omitempty"`
	AutoGen       *AutoGenConfig       `json:"autogen,omitempty"`
	AWSAgentCore  *AWSAgentCoreConfig  `json:"awsAgentCore,omitempty"`
	Kubernetes    *KubernetesConfig    `json:"kubernetes,omitempty"`
	DockerCompose *DockerComposeConfig `json:"dockerCompose,omitempty"`
	AgentKitLocal *AgentKitLocalConfig `json:"agentKitLocal,omitempty"`
}

type Task struct {
	// ID is the unique task identifier within this agent.
	ID string `json:"id"`

	// Description describes what this task validates or accomplishes.
	Description string `json:"description,omitempty"`

	// Type is how the task is executed (command, pattern, file, manual).
	Type TaskType `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 a 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 TaskResult struct {
	// ID is the task identifier (matches task id in agent definition)
	ID string `json:"id"`

	// Status is GO, WARN, NO-GO, or SKIP
	Status Status `json:"status"`

	// Severity is the impact level (critical, high, medium, low, info).
	// Orthogonal to Status: Status answers "did it pass?", Severity answers "how bad is it?"
	Severity string `json:"severity,omitempty"`

	// Detail is optional additional information about the result
	Detail string `json:"detail,omitempty"`

	// DurationMs is the task execution time in milliseconds
	DurationMs int64 `json:"duration_ms,omitempty"`

	// Metadata allows tasks to include structured data
	Metadata map[string]interface{} `json:"metadata,omitempty"`
}

type TaskType string

type Team 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 summary of the team's purpose.
	Description string `json:"description,omitempty"`

	// Agents is the list of agent names in the team.
	Agents []string `json:"agents"`

	// Orchestrator is the name of the orchestrator agent.
	Orchestrator string `json:"orchestrator,omitempty"`

	// Workflow is the workflow definition for agent coordination.
	Workflow *Workflow `json:"workflow,omitempty"`

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

	// Collaboration defines how agents interact in self-directed workflows.
	Collaboration *CollaborationConfig `json:"collaboration,omitempty"`

	// SelfClaim allows agents to self-claim tasks from a shared queue (swarm).
	SelfClaim bool `json:"self_claim,omitempty"`

	// PlanApproval requires plan approval before implementation (crew).
	PlanApproval bool `json:"plan_approval,omitempty"`
}

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

	// Title is the report title (e.g., "CUSTOM EXTENSION ANALYSIS REPORT").
	// If empty, defaults to "TEAM STATUS REPORT" in rendering.
	Title string `json:"title,omitempty"`

	// Project is the repository identifier
	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 workflow phase (e.g., "PHASE 1: REVIEW")
	Phase string `json:"phase"`

	// Tags are key-value pairs for filtering and aggregation across reports.
	// Examples: customer, environment, use_case, target_system
	Tags map[string]string `json:"tags,omitempty"`

	// SummaryBlocks appear after the header, before the phase.
	// For metadata, disposition, use-case descriptions.
	SummaryBlocks []ContentBlock `json:"summary_blocks,omitempty"`

	// Teams are the validation teams/agents
	Teams []TeamSection `json:"teams"`

	// FooterBlocks appear after all teams, before the final message.
	// For action items, recommendations, required follow-ups.
	FooterBlocks []ContentBlock `json:"footer_blocks,omitempty"`

	// Summary is the executive summary for narrative reports.
	Summary string `json:"summary,omitempty"`

	// Conclusion is the closing section for narrative reports.
	Conclusion string `json:"conclusion,omitempty"`

	// Status is the overall status (computed from teams)
	Status Status `json:"status"`

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

	// GeneratedBy identifies the coordinator
	GeneratedBy string `json:"generated_by,omitempty"`
}

type TeamSection struct {
	// ID is the workflow step ID (e.g., "pm-validation")
	ID string `json:"id"`

	// Name is the agent name (e.g., "pm")
	Name string `json:"name"`

	// AgentID matches the agent definition in team.json
	AgentID string `json:"agent_id,omitempty"`

	// Model is the LLM model used
	Model string `json:"model,omitempty"`

	// DependsOn lists the IDs of upstream teams in the DAG
	DependsOn []string `json:"depends_on,omitempty"`

	// Tasks are the task results for this team (one per line in reports).
	// Optional: teams can use ContentBlocks instead of or in addition to Tasks.
	Tasks []TaskResult `json:"tasks,omitempty"`

	// Status is the overall status (computed from tasks)
	Status Status `json:"status"`

	// Verdict is a domain-specific verdict label, richer than the 4-value Status.
	// Status is machine-readable GO/NO-GO; Verdict is the human-readable domain assessment.
	// Examples: "BLOCKED_PENDING_ENHANCEMENT", "COMPLIANT", "NEEDS_WORK"
	Verdict string `json:"verdict,omitempty"`

	// ContentBlocks holds rich content for this team section.
	// Supports lists, kv_pairs, tables, text, metrics.
	ContentBlocks []ContentBlock `json:"content_blocks,omitempty"`

	// Narrative holds prose content for narrative reports.
	Narrative *NarrativeSection `json:"narrative,omitempty"`
}

type Tool string

type TracingConfig struct {
	Enabled    bool    `json:"enabled,omitempty"`
	Exporter   string  `json:"exporter,omitempty"`
	Endpoint   string  `json:"endpoint,omitempty"`
	SampleRate float64 `json:"sample_rate,omitempty"`
}

type Workflow struct {
	// Type is the workflow execution pattern.
	Type WorkflowType `json:"type,omitempty"`

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

type WorkflowCategory string

type WorkflowType string