Function limitEnvelope

internal/httpapi/agents_write.go:258–270

limitEnvelope translates a limits.LimitExceededError into a 402 envelope (code "limit_exceeded") carrying the structured cap details, replacing the legacy bespoke LimitErrorBody with the standardized envelope.

(err error)

// (code "limit_exceeded") carrying the structured cap details, replacing the
// legacy bespoke LimitErrorBody with the standardized envelope.
func limitEnvelope(err error) (*ErrorEnvelope, bool) {
	le, ok := limits.IsLimitExceeded(err)
	if !ok {
		return nil, false
	}
	return NewError(http.StatusPaymentRequired, "limit_exceeded", le.Error()).WithDetails(map[string]any{
		"resource":    le.Resource,
		"limit":       le.Limit,
		"current":     le.Current,
		"plan_code":   le.Limits.PlanCode,
		"upgrade_url": le.Limits.UpgradeURL,
	}), true
}