type AssistantMessage = types.AssistantMessage

type Callback = event.Callback

type ClaudeCodeProvider = provider.ClaudeCodeProvider

type Config = types.Config

type ContentBlock = types.ContentBlock

type Engine = engine.Engine

type EngineOptions = engine.EngineOptions

type EventMeta = event.EventMeta

type EventWithMeta = event.EventWithMeta

type Executor interface {
	// Execute runs a command or prompt and streams normalized events.
	Execute(ctx context.Context, cfg *types.Config, prompt string, callback event.Callback) error

	// ValidateConfig checks if the session configuration is secure and valid.
	ValidateConfig(cfg *types.Config) error
}

type HotPlexClient interface {
	Executor
	SessionController
	SafetyManager

	// Close gracefully terminates all managed sessions and releases resources.
	Close() error
}

type OpenCodeConfig = provider.OpenCodeConfig

type Provider = provider.Provider

type ProviderConfig = provider.ProviderConfig

type ProviderEvent = provider.ProviderEvent

type ProviderFeatures = provider.ProviderFeatures

type ProviderMeta = provider.ProviderMeta

type ProviderSessionOptions = provider.ProviderSessionOptions

type ProviderType = provider.ProviderType

type SafetyManager interface {
	// SetDangerAllowPaths configures the whitelist of safe directories for file I/O.
	SetDangerAllowPaths(paths []string)

	// SetDangerBypassEnabled toggles the regex WAF (requires valid admin token).
	SetDangerBypassEnabled(token string, enabled bool) error
}

type SessionController interface {
	// GetSessionStats returns telemetry and token usage for the given sessionID.
	// Note: Use the business-side sessionID provided during execution, not the internal
	// CLI-level session identifier. This sessionID maps to a specific background process.
	GetSessionStats(sessionID string) *SessionStats

	// StopSession forcibly terminates a persistent session and its underlying OS process group.
	// Note: Use the business-side sessionID (provided by the user) to identify which
	// specific agent instance to terminate.
	StopSession(sessionID string, reason string) error

	// GetCLIVersion returns the version string of the underlying AI CLI tool.
	GetCLIVersion() (string, error)
}

type SessionStats = engine.SessionStats

type SessionStatsData = event.SessionStatsData

type StreamMessage = types.StreamMessage

type UsageStats = types.UsageStats