runtime

type Adapter interface {
	// Start launches the runtime process and establishes connection.
	Start(ctx context.Context) error

	// Stop gracefully shuts down the runtime.
	Stop(ctx context.Context) error

	// SendMessage delivers text to the agent.
	SendMessage(ctx context.Context, text string) error

	// Events returns a channel that receives agent output events.
	// Channel is closed when the adapter stops or the context is cancelled.
	Events() <-chan Event

	// CreateSession starts a new conversation. Returns session ID.
	CreateSession(ctx context.Context) (string, error)

	// ResumeSession resumes an existing conversation by ID.
	ResumeSession(ctx context.Context, sessionID string) error

	// IsHealthy returns true if the runtime is responsive.
	IsHealthy(ctx context.Context) bool

	// Runtime returns the runtime type.
	Runtime() Runtime
}

type AdapterConfig struct {
	AgentName  string
	WorkDir    string   // Agent workspace directory
	Port       int      // API server port (0 = not applicable for CC)
	Model      string   // Model override
	Yolo       bool     // Skip permission prompts
	Env        []string // Additional env vars (TTAL_AGENT_NAME, TTAL_TEAM, etc.)
	GatewayURL string   // OpenClaw Gateway URL (for openclaw runtime)
	HooksToken string   // OpenClaw hooks auth token (for openclaw runtime)
}

type Event struct {
	Type  EventType
	Agent string
	Text  string // assistant output text (for EventText/EventError)

	// Status fields (for EventStatus).
	ContextUsedPct      float64
	ContextRemainingPct float64
	ModelID             string
	SessionID           string

	// Question fields (for EventQuestion).
	CorrelationID string     // tool_use_id / requestID / call_id
	Questions     []Question // 1-4 questions per event
}

type EventType string

type Question struct {
	ID          string           // Per-question ID (empty for CC, Codex uses for answer mapping)
	Header      string           // Short label (e.g. "Database", "Approach")
	Text        string           // Full question text
	Options     []QuestionOption // Available choices
	MultiSelect bool             // Allow multiple selections
	AllowCustom bool             // Allow free-form text input
	IsSecret    bool             // Mask input (Codex only)
}

type QuestionAnswer struct {
	QuestionID string
	Answer     string
}

type QuestionOption struct {
	Label       string
	Description string
}

type Runtime string