llmc

type CompileOptions struct {
	// OutputDir is the directory where the binary will be placed.
	// Defaults to current directory if not specified.
	OutputDir string

	// OutputName overrides the output binary name.
	// If empty, uses the input filename (without extension) for CompileFile,
	// or the workflow name for Compile.
	OutputName string

	// SkipBuild generates the Go source file but skips compilation to binary.
	// The source file will be saved to OutputDir.
	SkipBuild bool

	// KeepSource saves the generated .go file alongside the binary.
	// Useful for debugging or inspecting the generated code.
	// By default, only the binary is output.
	KeepSource bool

	// Verbose enables detailed output during compilation.
	Verbose bool
}

type CompileResult struct {
	// SourcePath is the path to the generated Go source file.
	SourcePath string

	// BinaryPath is the path to the compiled binary.
	// Empty if SkipBuild was true.
	BinaryPath string

	// Workflows contains the compiled workflow definitions.
	Workflows []*Workflow
}

type Option func(*CompileOptions)

type Step struct {
	// Name is the unique identifier for this step within the workflow.
	Name string

	// Type specifies how this step executes (shell, llm, local_llm).
	Type StepType

	// Command is the shell command to execute (for StepTypeShell).
	Command string

	// Prompt is the LLM prompt template (for StepTypeLLM, StepTypeLocalLLM).
	Prompt string

	// Model specifies which LLM model to use.
	Model string

	// MaxTokens limits the LLM response length.
	MaxTokens int

	// Output is the variable name to store this step's result.
	// Can be referenced in subsequent steps via {{output_name}}.
	Output string

	// If is a conditional expression. Step only runs if it evaluates to true.
	// Supports template substitution: "{{mode}} == 'production'"
	If string

	// WaitFor specifies another workflow step to wait for before executing.
	// Format: "workflowName.stepName"
	WaitFor string

	// WaitTimeout is the timeout in seconds when waiting for another step.
	// 0 means wait indefinitely.
	WaitTimeout int
}

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

type StepType string

type Workflow struct {
	// Name is the unique identifier for this workflow.
	Name string

	// Steps contains the ordered list of workflow steps.
	Steps []*Step
}