actions

type Assistant interface {
	Enabled(ctx context.Context) bool
	AskStream(ctx context.Context, actor app.Actor, conv, text string, progress assistant.Progress) (assistant.Turn, error)
	Decide(ctx context.Context, actor app.Actor, id string, accept bool) (assistant.Outcome, error)
	Undo(ctx context.Context, actor app.Actor, id string) (assistant.Outcome, error)
}

type Button struct {
	Label string
	Data  string
	URL   string
}

type Channel interface {
	Name() string
	Send(ctx context.Context, chatID string, m Message) (messageID string, err error)
	Edit(ctx context.Context, chatID, messageID string, m Message) error
}

type ChatRef struct {
	Channel   string
	ChatID    string
	MessageID string
}

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

type Event struct {
	Kind           string
	SubscriptionID string
	Subscription   string
	ChargeID       string
	Amount         string // decimal, e.g. "12.99"
	Currency       string // ISO 4217
	DueDate        string // YYYY-MM-DD
	DaysUntil      int    // negative when overdue
	PaymentMethod  string
	Category       string
	// Path is the web page that shows it, e.g. /subscriptions/sub_…
	Path string
}

type FileReader interface {
	ReadImport(ctx context.Context, actor app.Actor, data []byte) (importer.Result, error)
	SaveReview(ctx context.Context, actor app.Actor, r assistant.Review) error
	LoadReview(ctx context.Context, actor app.Actor) (assistant.Review, error)
	DropReview(ctx context.Context, actor app.Actor) error
}

type Message struct {
	Title    string
	Lines    []string
	Sections []Section
	Rows     [][]Button
	// Footer is shown in a muted style (e.g. "Moved by Claude · Undo").
	Footer string
	// Event is the data behind the message, for channels that only notify
	// (email, ntfy, webhooks). Nil for screens that are not about a charge.
	Event *Event
}

type PushResult struct {
	Title   string `json:"title,omitempty" doc:"the charge as it is now, e.g. \"✅ Netflix paid\""`
	Message string `json:"message" doc:"what happened, e.g. \"Marked as paid ✅\""`
}

type Reply struct {
	// Edit replaces the message the button belongs to.
	Edit *Message
	// Toast is a short notification (Telegram callback answer).
	Toast string
	// Send is a new message (e.g. a question that expects a typed answer).
	Send *Message
}

type Section struct {
	Heading string
	Lines   []string
	// Table rows are cells; channels without tables show TableText in a
	// monospace block. Cells should not contain emoji (they break alignment).
	Table [][]string
}