channel

type Channel interface {
	// ID returns the channel identifier (e.g. "wechat").
	ID() string
	// State returns the current lifecycle state.
	State() State
	// Login initiates the authentication flow (e.g. QR scan).
	// Returns a login session that can be waited on.
	Login() (*LoginSession, error)
	// Logout clears credentials and stops the channel.
	Logout() error
	// Enable starts push notifications and inbound message polling.
	Enable() error
	// Disable stops push notifications and polling but keeps credentials.
	Disable() error
	// SendText sends a text message to the connected user.
	SendText(text string) error
}

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

type EventType int

type LoginSession struct {
	// QRCodeURL is a URL that renders a QR code image for scanning.
	QRCodeURL string
	// QRCodeContent is the raw content to encode as a QR code in terminal.
	QRCodeContent string
	// SessionKey identifies this login attempt.
	SessionKey string
	// WaitFunc blocks until login completes or times out. Returns nil on success.
	WaitFunc func() error
}

type Notifier interface {
	// Name returns a human-readable identifier (e.g. "ble", "wechat").
	Name() string
	// Available reports whether the notifier is ready to send.
	Available() bool
	// Notify pushes a lifecycle event. Implementations format the event
	// for their own display (short text for BLE, rich text for WeChat, etc.).
	// Must be best-effort and never block the caller for long.
	Notify(event NotifyEvent)
	// Close releases resources. Safe to call multiple times.
	Close()
}

type NotifyEvent struct {
	Type EventType
	Tool string // tool name (for EventApproval)
	Err  error  // non-nil on failure (for EventDone)
}

type State int