hubclient

Nov 13, 2026

Changes in this version

+ const DecisionWait

type Client

+ func (c *Client) Await(ctx context.Context, ticketID string, wait time.Duration) bool

Nov 8, 2026

Changes in this version

+ var ErrWithdrawn = errors.New("hubclient: ticket withdrawn by the human")

type Client

+ func (c *Client) EndDenied(st *plans.Store) error

Nov 7, 2026

Changes in this version

+ const LimitPending

+ const LimitRate

+ const LimitTotal

+ const RateTotal

type Client

+ func (c *Client) Limits() Limits

+ func (c *Client) SetLimits(l Limits)

type Config

+ RateTotal int

+ type Limits struct

+ MaxPending int

+ RateN int

+ RateTotal int

+ RateWindow time.Duration

+ func DefaultLimits() Limits

+ func (l Limits) Effective() Limits

+ type RateLimitError struct

+ Count int

+ Limit string

+ Max int

+ RetryAfter time.Duration

+ Window time.Duration

+ func (e *RateLimitError) Error() string

+ func (e *RateLimitError) Is(target error) bool

Nov 6, 2026

Changes in this version

type Client

+ func (c *Client) Ask(ctx context.Context, t *ticket.Ticket, screen render.MaskedScreen) (*ticket.Decision, error)

+ func (c *Client) Consumed(ctx context.Context, id string) error

Oct 31, 2026

Changes in this version

+ func CanonicalURL(raw string) (string, error)

type Client

+ func (c *Client) URL() string

Oct 30, 2026

Changes in this version

+ const CodeFacadeRefused

+ const CodeFailed

+ const CodeLimited

+ const CodeNoClear

+ const CodeNotPending

+ const CodeNotRenewable

+ const CodePolicyChanged

+ const CodeRecheckFailed

+ const MaxRequests

+ var ErrBadRequest = errors.New("hubclient: hub request refused")

+ var ErrNotRenewable = errors.New("hubclient: ticket cannot be renewed")

+ func AnswerCode(err error) string

+ func ReadFacades(path string) ([]ticket.PinnedFacade, error)

type Client

+ func (c *Client) HandleRequests(ctx context.Context, st *plans.Store) error

+ func (c *Client) OnRequest(f func(q *ticket.HubRequest, renewal string, err error))

+ func (c *Client) Renew(ctx context.Context, st *plans.Store, ticketID string, caller plans.Caller) (string, error)

+ func (c *Client) SetRecompute(r Recompute)

type Config

+ Facades []ticket.PinnedFacade

+ type Recompute func(p *plans.Plan) (policyFP, planHash string, inputs map[string]string, err error)

Oct 30, 2026

Changes in this version

+ func ParseRisks(s string) ([]ticket.Risk, error)

+ func ReadDevices(path string) ([]ticket.Device, error)

type Client

+ func (c *Client) SubmitClear(ctx context.Context, st *plans.Store, planID string, caller plans.Caller, ...) (string, error)

type Config

+ Devices []ticket.Device

+ RequireDevice []ticket.Risk

+ SealClear bool

Oct 30, 2026

Changes in this version

type Config

+ PlainHTTP bool

Oct 29, 2026

Changes in this version

+ const MaxInbox

+ const MaxPending

+ const MaxWait

+ const RateN

+ const RateWindow

+ var ErrBadDecision = errors.New("hubclient: decision refused")

+ var ErrDenied = errors.New("hubclient: denied")

+ var ErrPending = errors.New("hubclient: no decision yet")

+ var ErrRateLimited = errors.New("hubclient: too many tickets")

+ var ErrUnreachable = errors.New("hubclient: hub unreachable")

+ func HubKeyCommand(w io.Writer, home string, args []string) error

+ func InstanceKey(home, instance string) (ed25519.PrivateKey, error)

+ func KeyDir(home string) string

+ func ReadHubKey(path string) (ed25519.PublicKey, error)

+ func ValidInstance(name string) bool

+ type Client struct

+ func New(cfg Config) (*Client, error)

+ func (c *Client) Begin(st *plans.Store, ticketID string, caller plans.Caller, recheck Recheck) (*plans.Plan, *ticket.Decision, error)

+ func (c *Client) Finish(ctx context.Context, st *plans.Store, planID string, caller plans.Caller, ...) error

+ func (c *Client) Hello(ctx context.Context) (Hello, error)

+ func (c *Client) Poll(ctx context.Context, wait time.Duration) (int, error)

+ func (c *Client) Submit(ctx context.Context, st *plans.Store, planID string, caller plans.Caller, ...) (string, error)

+ func (c *Client) Sync(ctx context.Context, st *plans.Store) error

+ func (c *Client) Watch(ctx context.Context, st *plans.Store, report func(error))

+ func (c *Client) Withdraw(ctx context.Context, st *plans.Store, planID string, caller plans.Caller, ...) error

+ type Config struct

+ ApprovalTTL time.Duration

+ HTTP *http.Client

+ HubKey ed25519.PublicKey

+ Instance string

+ Key ed25519.PrivateKey

+ MaxPending int

+ Now func() time.Time

+ RateN int

+ RateWindow time.Duration

+ StateFile string

+ URL string

+ type Hello struct

+ API int

+ Name string

+ Version string

+ type HubError struct

+ Code string

+ Message string

+ Status int

+ func (e *HubError) Error() string

+ func (e *HubError) Is(target error) bool

+ type Recheck func(p *plans.Plan) (policyFP, planHash string, err error)