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"`
}

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 AutoGenConfig struct {
	Model                   string               `json:"model,omitempty"`
	HumanInputMode          string               `json:"humanInputMode,omitempty"`
	MaxConsecutiveAutoReply int                  `json:"maxConsecutiveAutoReply,omitempty"`
	CodeExecutionConfig     *CodeExecutionConfig `json:"codeExecutionConfig,omitempty"`
}

type Check = TaskResult

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

type CodeExecutionConfig struct {
	WorkDir   string `json:"workDir,omitempty"`
	UseDocker bool   `json:"useDocker,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 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"`
}

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"`
	Format    string `json:"format"`
}

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 LoggingConfig struct {
	Level  string `json:"level,omitempty"`
	Format string `json:"format,omitempty"`
}

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 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"`

	// 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"`
}

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"`

	// 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"`

	// 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 WorkflowType string