domain

type ActionRequest struct {
	Type    string // e.g., "CLI_PRINT", "HTTP_GET"
	Payload any    // The data needed to perform the action
}

type ActionResponse struct {
	Success bool
	Data    any
	Error   error
}

type ExecutionStatus string

type InputRequest struct {
	Type    InputType `json:"type"`
	Options []string  `json:"options,omitempty"`
	Default string    `json:"default,omitempty"`
}

type InputType string

type Node struct {
	ID   string `json:"id"`
	Type string `json:"type"` // e.g., "text", "question", "logic", "tool"

	// Content holds the raw data for this node.
	// For a text node, it might be the markdown content.
	// For a logic node, it might be the script or parameters.
	Content []byte `json:"content"`

	// Metadata allows for extensible key-value pairs.
	Metadata map[string]string `json:"metadata,omitempty"`

	// Transitions defines the possible paths from this node.
	Transitions []Transition `json:"transitions"`

	// Input Configuration (Optional)
	InputType    string   `json:"input_type,omitempty"`
	InputOptions []string `json:"input_options,omitempty"`
	InputDefault string   `json:"input_default,omitempty"`

	// Tool Configuration (Optional, used if Type == "tool")
	ToolCall *ToolCall `json:"tool_call,omitempty"`
}

type State struct {
	// CurrentNodeID is the identifier of the active node.
	CurrentNodeID string

	// Status indicates if the engine is running, waiting, or done.
	Status ExecutionStatus

	// PendingToolCall holds the ID of the tool call we are waiting for (if Status == WaitingForTool).
	PendingToolCall string

	// Memory holds variable state for the session.
	Memory map[string]any

	// History could track the path taken (optional for now, but good for debugging)
	History []string

	// Terminated indicates if the execution has reached a sink state (no transitions).
	// Deprecated: Use Status == StatusTerminated instead. Kept for backward compat.
	Terminated bool
}

type Tool struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type ToolCall struct {
	ID   string         `json:"id"`             // Unique ID for this specific call (e.g. from LLM or generated)
	Name string         `json:"name"`           // Function name to call
	Args map[string]any `json:"args,omitempty"` // Arguments for the function
}

type ToolResult struct {
	ID      string `json:"id"` // Must match the ToolCall.ID
	Result  any    `json:"result,omitempty"`
	IsError bool   `json:"is_error,omitempty"`
	Error   string `json:"error,omitempty"`
}

type Transition struct {
	FromNodeID string `json:"from_node_id,omitempty"`
	ToNodeID   string `json:"to_node_id"`

	// Condition is a simple expression string that must evaluate to true
	// for this transition to be valid. e.g., "user_age >= 18"
	// If empty, it's considered an "always" transition (default).
	Condition string `json:"condition,omitempty"`
}