command

type Definition struct {
	Name        string
	Description string
	Usage       string
	Handler     func(ctx context.Context, req Request, rt Runtime) error
}

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

type Request struct {
	Text      string
	ChatID    string
	UserID    string
	Connector string
	Reply     func(text string) error
}

type Runtime interface {
	ClearHistory() error
	IsAdmin() bool
	FactoryReset() error // admin only: wipes soul + role + memories + history
	Info() UserInfo
	// Allow-list management (admin only), scoped to the request's connector.
	AllowAdd(number string) error
	AllowRemove(number string) error
	AllowList() ([]string, error)
	// ResolveApproval approves (true) or denies (false) a parked tool call by id.
	// It sends its own replies and continues the agent's tool loop.
	ResolveApproval(approve bool, id string)
	// GenerateLinkCode mints a one-time code so another chat can link to this
	// account (see RedeemLinkCode). Returns ErrUnsupported with no store.
	GenerateLinkCode() (string, error)
	// RedeemLinkCode links this identity to the account that generated code,
	// returning a label for the now-shared account.
	RedeemLinkCode(code string) (string, error)
	// Unlink detaches this identity from its linked account.
	Unlink() error
	// LinkStatus reports whether this identity is linked, with a short detail.
	LinkStatus() (linked bool, detail string)
}

type UserInfo struct {
	Connector string
	UserID    string
	Soul      string
	Role      string
	LLMModel  string
	Provider  string
}