registry

type AgentSkill struct {
	// --- Frontmatter fields (from YAML between --- delimiters) ---
	Name          string            `yaml:"name" json:"name"`
	Description   string            `yaml:"description" json:"description"`
	License       string            `yaml:"license,omitempty" json:"license,omitempty"`
	Compatibility string            `yaml:"compatibility,omitempty" json:"compatibility,omitempty"`
	Metadata      map[string]string `yaml:"metadata,omitempty" json:"metadata,omitempty"`
	AllowedTools  string            `yaml:"allowed-tools,omitempty" json:"allowedTools,omitempty"`

	// --- Gridctl extensions (not in agentskills.io spec) ---
	State ItemState `yaml:"state,omitempty" json:"state"`

	// Workflow definition (gridctl extension).
	// When present, the skill becomes executable and is exposed as an MCP tool.
	Inputs   map[string]SkillInput `yaml:"inputs,omitempty" json:"inputs,omitempty"`
	Workflow []WorkflowStep        `yaml:"workflow,omitempty" json:"workflow,omitempty"`
	Output   *WorkflowOutput       `yaml:"output,omitempty" json:"output,omitempty"`

	// --- Parsed from file content (not in frontmatter YAML) ---
	Body string `yaml:"-" json:"body"` // Markdown content after frontmatter

	// --- Computed fields (not serialized to YAML) ---
	FileCount int    `yaml:"-" json:"fileCount"` // Number of supporting files (scripts/, references/, assets/)
	Dir       string `yaml:"-" json:"-"`         // Relative path from skills/ root (e.g., "git-workflow/branch-fork")
}

type ExecutionResult struct {
	Skill      string                `json:"skill"`
	Status     string                `json:"status"` // "completed", "failed", "partial"
	StartedAt  time.Time             `json:"startedAt"`
	FinishedAt time.Time             `json:"finishedAt"`
	DurationMs int64                 `json:"durationMs"`
	Steps      []StepExecutionResult `json:"steps"`
	Output     *mcp.ToolCallResult   `json:"output,omitempty"`
	Error      string                `json:"error,omitempty"`
}

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

type ExecutorOption func(*Executor)

type ItemState string

type RegistryStatus struct {
	TotalSkills  int `json:"totalSkills"`
	ActiveSkills int `json:"activeSkills"`
}

type RetryPolicy struct {
	MaxAttempts int    `yaml:"max_attempts" json:"maxAttempts"`
	Backoff     string `yaml:"backoff,omitempty" json:"backoff,omitempty"`
}

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

type ServerOption func(*Server)

type SkillFile struct {
	Path  string `json:"path"`  // Relative path within the skill dir (e.g., "scripts/lint.sh")
	Size  int64  `json:"size"`  // File size in bytes
	IsDir bool   `json:"isDir"` // True for directories
}

type SkillInput struct {
	Type        string   `yaml:"type" json:"type"`
	Description string   `yaml:"description,omitempty" json:"description,omitempty"`
	Required    bool     `yaml:"required,omitempty" json:"required,omitempty"`
	Default     any      `yaml:"default,omitempty" json:"default,omitempty"`
	Enum        []string `yaml:"enum,omitempty" json:"enum,omitempty"`
}

type StepExecutionResult struct {
	ID         string    `json:"id"`
	Tool       string    `json:"tool"`
	Status     string    `json:"status"` // "success", "failed", "skipped"
	StartedAt  time.Time `json:"startedAt"`
	DurationMs int64     `json:"durationMs"`
	Error      string    `json:"error,omitempty"`
	Attempts   int       `json:"attempts,omitempty"`   // retry count (1 = no retry)
	SkipReason string    `json:"skipReason,omitempty"` // why step was skipped
	Level      int       `json:"level"`                // DAG level (0-indexed)
}

type StepResult struct {
	Result  string // Text content from ToolCallResult
	IsError bool   // Whether the step returned isError: true
	Raw     any    // Parsed JSON if result is valid JSON, otherwise nil
}

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

type StringOrSlice []string

type TemplateContext struct {
	Inputs map[string]any         // User-provided arguments
	Steps  map[string]*StepResult // Completed step results
}

type ToolCaller = mcp.ToolCaller

type ValidationResult struct {
	Errors   []string // Fatal validation failures
	Warnings []string // Non-fatal advisories (e.g., body too long)
}

type WorkflowOutput struct {
	Format   string   `yaml:"format,omitempty" json:"format,omitempty"` // merged|last|custom
	Include  []string `yaml:"include,omitempty" json:"include,omitempty"`
	Template string   `yaml:"template,omitempty" json:"template,omitempty"`
}

type WorkflowStep struct {
	ID        string         `yaml:"id" json:"id"`
	Tool      string         `yaml:"tool" json:"tool"`
	Args      map[string]any `yaml:"args,omitempty" json:"args,omitempty"`
	DependsOn StringOrSlice  `yaml:"depends_on,omitempty" json:"dependsOn,omitempty"`
	Condition string         `yaml:"condition,omitempty" json:"condition,omitempty"`
	OnError   string         `yaml:"on_error,omitempty" json:"onError,omitempty"`
	Timeout   string         `yaml:"timeout,omitempty" json:"timeout,omitempty"`
	Retry     *RetryPolicy   `yaml:"retry,omitempty" json:"retry,omitempty"`
}