workflow

type ChatTurn struct {
	Role string `json:"role"`
	Text string `json:"text"`
}

type Compiled struct {
	Workflow *adkworkflow.Workflow
	// AgentInfo maps an emitted event's Author (an ADK agent
	// name) to its metadata. Inner loop agents map to their
	// containing loop step index.
	AgentInfo map[string]StepAgentInfo
	// Models are the per-step models built at compile time. Close releases
	// them after the run — a subprocess-backed provider (Claude Code) forks
	// a child per step that must be terminated.
	Models []model.LLM
}

type Def struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Steps       []Step `json:"steps"`
	Scope       Scope  `json:"-"`
	// Plugin is the "name@marketplace" that ships this workflow when
	// Scope == ScopePlugin.
	Plugin string `json:"-"`
}

type FinishData struct {
	Description string   `json:"description"`
	Artifacts   []string `json:"artifacts"`
}

type LoopPromptCtx struct {
	Name          string
	MaxIterations int
	ExitCondition string
	IsTail        bool
}

type NoopRunnerListener struct{}

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

type RunState struct {
	Workflow     Def
	Source       Source
	StartedAt    time.Time
	StepIdx      int
	Done         bool
	Failed       bool
	FailedReason string
	FinishData   *FinishData
}

type RunnerListener interface {
	OnWorkflowStarted(tabID int, def Def, src Source)
	OnWorkflowStepStarted(tabID int, stepIdx int, stepName, provider, model string)
	OnWorkflowStepDone(tabID int, stepIdx int, summary string)
	OnWorkflowDone(tabID int, description string, artifacts []string)
	OnWorkflowFailed(tabID int, reason string)
	OnNote(tabID int, text string)
}

type Scope string

type Source struct {
	Kind           SourceKind `json:"kind"`
	IssueDisplay   string     `json:"issue_display,omitempty"`
	IssueKey       string     `json:"issue_key,omitempty"`
	ChatLabel      string     `json:"chat_label,omitempty"`
	ChatKey        string     `json:"chat_key,omitempty"`
	ChatTranscript []ChatTurn `json:"chat_transcript,omitempty"`
	TextLabel      string     `json:"text_label,omitempty"`
	TextKey        string     `json:"text_key,omitempty"`
	TextAppend     string     `json:"text_append,omitempty"`
}

type SourceKind int

type StatusListener func(key string, status string)

type Step struct {
	Name          string `json:"name"`
	Kind          string `json:"kind,omitempty"` // "loop" or empty/omitted for standard step
	Provider      string `json:"provider,omitempty"`
	Model         string `json:"model,omitempty"`
	Prompt        string `json:"prompt,omitempty"`
	Steps         []Step `json:"steps,omitempty"`
	MaxIterations int    `json:"maxIterations,omitempty"`
	ExitCondition string `json:"exitCondition,omitempty"`
}

type StepAgentInfo struct {
	StepIndex int
	StepName  string
	Provider  string
	Model     string
	InLoop    bool
	LoopName  string
	InnerIdx  int
}

type StepPromptCtx struct {
	Loop                *LoopPromptCtx
	IsStartStep         bool
	IsWorkflowFinalStep bool
}

type StepRole struct {
	// InLoop is true when the step runs inside a loop container.
	InLoop bool
	// IsTail is true when the step is the last inner step of its loop —
	// the only step allowed to break the loop early via exit_loop.
	IsTail bool
	// IsFinal is true when the step is the last thing the whole workflow
	// runs (the last top-level step, or the tail of a final loop). Only
	// this step gets finish_workflow.
	IsFinal bool
}

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

type TrackerEntry struct {
	Status    string    `json:"status"`
	TabID     int       `json:"tab_id,omitempty"`
	Workflow  string    `json:"workflow"`
	StepIndex int       `json:"step_index"`
	StartedAt time.Time `json:"started_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type WorkflowAgentConfig struct {
	Def    Def
	Source Source
	Cwd    string
	TabID  int

	// ModelBuilder resolves the LLM for one step. Required.
	ModelBuilder func(ctx context.Context, step Step) (model.LLM, error)
	// ToolsBuilder and ToolsetsBuilder supply the step's tool surface.
	// StepRole tells them where the step sits, so the builder can attach
	// finish_workflow to the final step only, and so on.
	ToolsBuilder    func(ctx context.Context, step Step, role StepRole) ([]tool.Tool, error)
	ToolsetsBuilder func(ctx context.Context, step Step, role StepRole) ([]tool.Toolset, error)
	// InstructionBuilder renders the step's system instruction. Defaults
	// to BuildStepInstruction.
	InstructionBuilder func(step Step, src Source, pc *StepPromptCtx) string
	// MaxRetries bounds per-node retries on failure. Zero means
	// workflowDefaultMaxRetries; negative disables retries.
	MaxRetries int
	// BeforeModelCallbacks run before every LLM invocation.
	BeforeModelCallbacks []llmagent.BeforeModelCallback
}